From 17d44ce8a55b4ac16a26f12d2ece0a31435c5a82 Mon Sep 17 00:00:00 2001
From: Paul <108695806+pxrl@users.noreply.github.com>
Date: Tue, 3 Jun 2025 20:30:15 +0000
Subject: [PATCH 1/6] chore: Update & deploy new WorldChain implementation
Updated for CCTP.
---
contracts/WorldChain_SpokePool.sol | 31 +-
.../chain-adapters/WorldChain_Adapter.sol | 98 ++++++
contracts/libraries/CircleCCTPAdapter.sol | 1 +
deploy/050_deploy_worldchain_adapter.ts | 28 +-
deploy/051_deploy_worldchain_spokepool.ts | 12 +-
deploy/consts.ts | 5 +-
deployments/deployments.json | 2 +-
deployments/mainnet/WorldChain_Adapter.json | 60 ++--
.../dc324d2c58d7b0ed46f2033874127662.json | 316 ++++++++++++++++++
.../worldchain/WorldChain_SpokePool.json | 85 ++---
.../f6db5bcc09d996b0e542155af45c1220.json | 168 ++++++++++
package.json | 2 +-
yarn.lock | 8 +-
13 files changed, 673 insertions(+), 143 deletions(-)
create mode 100644 contracts/chain-adapters/WorldChain_Adapter.sol
create mode 100644 deployments/mainnet/solcInputs/dc324d2c58d7b0ed46f2033874127662.json
create mode 100644 deployments/worldchain/solcInputs/f6db5bcc09d996b0e542155af45c1220.json
diff --git a/contracts/WorldChain_SpokePool.sol b/contracts/WorldChain_SpokePool.sol
index 12a30b35a..60a093512 100644
--- a/contracts/WorldChain_SpokePool.sol
+++ b/contracts/WorldChain_SpokePool.sol
@@ -4,7 +4,6 @@ import "@eth-optimism/contracts/libraries/constants/Lib_PredeployAddresses.sol";
import "./Ovm_SpokePool.sol";
import "./external/interfaces/CCTPInterfaces.sol";
-import { IOpUSDCBridgeAdapter } from "./external/interfaces/IOpUSDCBridgeAdapter.sol";
/**
* @notice World Chain Spoke pool.
@@ -13,9 +12,6 @@ import { IOpUSDCBridgeAdapter } from "./external/interfaces/IOpUSDCBridgeAdapter
contract WorldChain_SpokePool is Ovm_SpokePool {
using SafeERC20 for IERC20;
- // Address of the custom L2 USDC bridge.
- address private constant USDC_BRIDGE = 0xbD80b06d3dbD0801132c6689429aC09Ca6D27f82;
-
/// @custom:oz-upgrades-unsafe-allow constructor
constructor(
address _wrappedNativeTokenAddress,
@@ -34,11 +30,12 @@ contract WorldChain_SpokePool is Ovm_SpokePool {
{} // solhint-disable-line no-empty-blocks
/**
- * @notice Construct the OVM World Chain SpokePool.
+ * @notice Construct the OVM SpokePool.
* @param _initialDepositId Starting deposit ID. Set to 0 unless this is a re-deployment in order to mitigate
* relay hash collisions.
* @param _crossDomainAdmin Cross domain admin to set. Can be changed by admin.
- * @param _withdrawalRecipient Address which receives token withdrawals. Can be changed by admin. For Spoke Pools on L2, this will
+ * @param _withdrawalRecipient Address which receives token withdrawals. Can be changed by admin. For Spoke Pools on L2,
+ * this will likely be the hub pool.
*/
function initialize(
uint32 _initialDepositId,
@@ -47,26 +44,4 @@ contract WorldChain_SpokePool is Ovm_SpokePool {
) public initializer {
__OvmSpokePool_init(_initialDepositId, _crossDomainAdmin, _withdrawalRecipient, Lib_PredeployAddresses.OVM_ETH);
}
-
- /**
- * @notice World Chain-specific logic to bridge tokens back to the hub pool contract on L1.
- * @param amountToReturn Amount of the token to bridge back.
- * @param l2TokenAddress Address of the l2 Token to bridge back. This token will either be bridged back to the token defined in the mapping `remoteL1Tokens`,
- * or via the canonical mapping defined in the bridge contract retrieved from `tokenBridges`.
- * @dev This implementation deviates slightly from `_bridgeTokensToHubPool` in the `Ovm_SpokePool` contract since World Chain has a USDC bridge which uses
- * a custom interface. This is because the USDC token on World Chain is meant to be upgraded to a native, CCTP supported version in the future.
- */
- function _bridgeTokensToHubPool(uint256 amountToReturn, address l2TokenAddress) internal virtual override {
- // Handle custom USDC bridge which doesn't conform to the standard bridge interface. In the future, CCTP may be used to bridge USDC to mainnet, in which
- // case bridging logic is handled by the Ovm_SpokePool code. In the meantime, if CCTP is not enabled, then use the USDC bridge. Once CCTP is activated on
- // WorldChain, this block of code will be unused.
- if (l2TokenAddress == address(usdcToken) && !_isCCTPEnabled()) {
- usdcToken.safeIncreaseAllowance(USDC_BRIDGE, amountToReturn);
- IOpUSDCBridgeAdapter(USDC_BRIDGE).sendMessage(
- withdrawalRecipient, // _to. Withdraw, over the bridge, to the l1 hub pool contract.
- amountToReturn, // _amount.
- l1Gas // _minGasLimit. Same value used in other OpStack bridges.
- );
- } else super._bridgeTokensToHubPool(amountToReturn, l2TokenAddress);
- }
}
diff --git a/contracts/chain-adapters/WorldChain_Adapter.sol b/contracts/chain-adapters/WorldChain_Adapter.sol
new file mode 100644
index 000000000..db481c523
--- /dev/null
+++ b/contracts/chain-adapters/WorldChain_Adapter.sol
@@ -0,0 +1,98 @@
+// SPDX-License-Identifier: BUSL-1.1
+pragma solidity ^0.8.0;
+
+import "./interfaces/AdapterInterface.sol";
+import "../external/interfaces/WETH9Interface.sol";
+
+// @dev Use local modified CrossDomainEnabled contract instead of one exported by eth-optimism because we need
+// this contract's state variables to be `immutable` because of the delegateCall call.
+import "./CrossDomainEnabled.sol";
+import "@eth-optimism/contracts/L1/messaging/IL1StandardBridge.sol";
+
+import "@openzeppelin/contracts/token/ERC20/IERC20.sol";
+import "@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol";
+
+import "../libraries/CircleCCTPAdapter.sol";
+import "../external/interfaces/CCTPInterfaces.sol";
+
+/**
+ * @notice Contract containing logic to send messages from L1 to Doctor Who. This is a modified version of the Optimism adapter
+ * that excludes the custom bridging logic.
+ * @custom:security-contact bugs@across.to
+ * @dev Public functions calling external contracts do not guard against reentrancy because they are expected to be
+ * called via delegatecall, which will execute this contract's logic within the context of the originating contract.
+ * For example, the HubPool will delegatecall these functions, therefore its only necessary that the HubPool's methods
+ * that call this contract's logic guard against reentrancy.
+ */
+
+// solhint-disable-next-line contract-name-camelcase
+contract WorldChain_Adapter is CrossDomainEnabled, AdapterInterface, CircleCCTPAdapter {
+ using SafeERC20 for IERC20;
+ uint32 public constant L2_GAS_LIMIT = 200_000;
+
+ WETH9Interface public immutable L1_WETH;
+
+ IL1StandardBridge public immutable L1_STANDARD_BRIDGE;
+
+ /**
+ * @notice Constructs new Adapter.
+ * @param _l1Weth WETH address on L1.
+ * @param _crossDomainMessenger XDomainMessenger Doctor Who system contract.
+ * @param _l1StandardBridge Standard bridge contract.
+ * @param _l1Usdc USDC address on L1.
+ * @param _cctpTokenMessenger TokenMessenger contract to bridge via CCTP.
+ */
+ constructor(
+ WETH9Interface _l1Weth,
+ address _crossDomainMessenger,
+ IL1StandardBridge _l1StandardBridge,
+ IERC20 _l1Usdc,
+ ITokenMessenger _cctpTokenMessenger
+ )
+ CrossDomainEnabled(_crossDomainMessenger)
+ CircleCCTPAdapter(_l1Usdc, _cctpTokenMessenger, CircleDomainIds.WorldChain)
+ {
+ L1_WETH = _l1Weth;
+ L1_STANDARD_BRIDGE = _l1StandardBridge;
+ }
+
+ /**
+ * @notice Send cross-chain message to target on Doctor Who.
+ * @param target Contract on Doctor Who that will receive message.
+ * @param message Data to send to target.
+ */
+ function relayMessage(address target, bytes calldata message) external payable override {
+ sendCrossDomainMessage(target, L2_GAS_LIMIT, message);
+ emit MessageRelayed(target, message);
+ }
+
+ /**
+ * @notice Bridge tokens to Doctor Who.
+ * @param l1Token L1 token to deposit.
+ * @param l2Token L2 token to receive.
+ * @param amount Amount of L1 tokens to deposit and L2 tokens to receive.
+ * @param to Bridge recipient.
+ */
+ function relayTokens(
+ address l1Token,
+ address l2Token,
+ uint256 amount,
+ address to
+ ) external payable override {
+ // If the l1Token is weth then unwrap it to ETH then send the ETH to the standard bridge.
+ if (l1Token == address(L1_WETH)) {
+ L1_WETH.withdraw(amount);
+ L1_STANDARD_BRIDGE.depositETHTo{ value: amount }(to, L2_GAS_LIMIT, "");
+ }
+ // Check if this token is USDC, which requires a custom bridge via CCTP.
+ else if (_isCCTPEnabled() && l1Token == address(usdcToken)) {
+ _transferUsdc(to, amount);
+ } else {
+ IL1StandardBridge _l1StandardBridge = L1_STANDARD_BRIDGE;
+
+ IERC20(l1Token).safeIncreaseAllowance(address(_l1StandardBridge), amount);
+ _l1StandardBridge.depositERC20To(l1Token, l2Token, to, amount, L2_GAS_LIMIT, "");
+ }
+ emit TokensRelayed(l1Token, l2Token, amount, to);
+ }
+}
diff --git a/contracts/libraries/CircleCCTPAdapter.sol b/contracts/libraries/CircleCCTPAdapter.sol
index a54ad9ae3..cf5761179 100644
--- a/contracts/libraries/CircleCCTPAdapter.sol
+++ b/contracts/libraries/CircleCCTPAdapter.sol
@@ -15,6 +15,7 @@ library CircleDomainIds {
uint32 public constant Polygon = 7;
uint32 public constant DoctorWho = 10;
uint32 public constant Linea = 11;
+ uint32 public constant WorldChain = 14;
uint32 public constant UNINITIALIZED = type(uint32).max;
}
diff --git a/deploy/050_deploy_worldchain_adapter.ts b/deploy/050_deploy_worldchain_adapter.ts
index 46ed0c541..11bf5b145 100644
--- a/deploy/050_deploy_worldchain_adapter.ts
+++ b/deploy/050_deploy_worldchain_adapter.ts
@@ -1,27 +1,29 @@
import { HardhatRuntimeEnvironment } from "hardhat/types";
import { DeployFunction } from "hardhat-deploy/types";
import { CHAIN_IDs } from "../utils";
-import { OP_STACK_ADDRESS_MAP, USDC, WETH } from "./consts";
-
-const SPOKE_CHAIN_ID = CHAIN_IDs.WORLD_CHAIN;
+import { L1_ADDRESS_MAP, OP_STACK_ADDRESS_MAP, USDC, WETH } from "./consts";
const func: DeployFunction = async function (hre: HardhatRuntimeEnvironment) {
+ const spokeChainId = Number(process.env.SPOKE_CHAIN_ID ?? CHAIN_IDs.WORLD_CHAIN);
const { deployer } = await hre.getNamedAccounts();
const chainId = parseInt(await hre.getChainId());
- const opStack = OP_STACK_ADDRESS_MAP[chainId][SPOKE_CHAIN_ID];
+ const opStack = OP_STACK_ADDRESS_MAP[chainId][spokeChainId];
+
+ const args = [
+ WETH[chainId],
+ opStack.L1CrossDomainMessenger,
+ opStack.L1StandardBridge,
+ USDC[chainId],
+ L1_ADDRESS_MAP[chainId].cctpV2TokenMessenger,
+ ];
- await hre.deployments.deploy("OP_Adapter", {
+ const instance = await hre.deployments.deploy("WorldChain_Adapter", {
from: deployer,
log: true,
- skipIfAlreadyDeployed: true,
- args: [
- WETH[chainId],
- USDC[chainId],
- opStack.L1CrossDomainMessenger,
- opStack.L1StandardBridge,
- opStack.L1OpUSDCBridge,
- ],
+ skipIfAlreadyDeployed: false,
+ args,
});
+ await hre.run("verify:verify", { address: instance.address, constructorArguments: args });
};
module.exports = func;
diff --git a/deploy/051_deploy_worldchain_spokepool.ts b/deploy/051_deploy_worldchain_spokepool.ts
index 6ea5bdcc0..7f0552048 100644
--- a/deploy/051_deploy_worldchain_spokepool.ts
+++ b/deploy/051_deploy_worldchain_spokepool.ts
@@ -1,7 +1,7 @@
import { DeployFunction } from "hardhat-deploy/types";
import { HardhatRuntimeEnvironment } from "hardhat/types";
import { deployNewProxy, getSpokePoolDeploymentInfo } from "../utils/utils.hre";
-import { FILL_DEADLINE_BUFFER, WETH, QUOTE_TIME_BUFFER, ZERO_ADDRESS, USDCe } from "./consts";
+import { FILL_DEADLINE_BUFFER, L2_ADDRESS_MAP, QUOTE_TIME_BUFFER, USDC, WETH } from "./consts";
const func: DeployFunction = async function (hre: HardhatRuntimeEnvironment) {
const { hubPool, spokeChainId } = await getSpokePoolDeploymentInfo(hre);
@@ -16,14 +16,8 @@ const func: DeployFunction = async function (hre: HardhatRuntimeEnvironment) {
WETH[spokeChainId],
QUOTE_TIME_BUFFER,
FILL_DEADLINE_BUFFER,
- // World Chain's bridged USDC is upgradeable to native. There are not two different
- // addresses for bridges/native USDC. This address is also used in the spoke pool
- // to determine whether to use CCTP (in the future) or the custom USDC bridge.
- USDCe[spokeChainId],
- // L2_ADDRESS_MAP[spokeChainId].cctpTokenMessenger,
- // For now, we are not using the CCTP bridge and can disable by setting
- // the cctpTokenMessenger to the zero address.
- ZERO_ADDRESS,
+ USDC[spokeChainId],
+ L2_ADDRESS_MAP[spokeChainId].cctpTokenMessenger,
];
await deployNewProxy("WorldChain_SpokePool", constructorArgs, initArgs);
};
diff --git a/deploy/consts.ts b/deploy/consts.ts
index 42f2b2344..ea9a0a342 100644
--- a/deploy/consts.ts
+++ b/deploy/consts.ts
@@ -127,7 +127,6 @@ export const OP_STACK_ADDRESS_MAP: {
[CHAIN_IDs.WORLD_CHAIN]: {
L1CrossDomainMessenger: "0xf931a81D18B1766d15695ffc7c1920a62b7e710a",
L1StandardBridge: "0x470458C91978D2d929704489Ad730DC3E3001113",
- L1OpUSDCBridgeAdapter: "0x153A69e4bb6fEDBbAaF463CB982416316c84B2dB",
},
[CHAIN_IDs.ZORA]: {
L1CrossDomainMessenger: "0xdC40a14d9abd6F410226f1E6de71aE03441ca506",
@@ -257,6 +256,10 @@ export const L2_ADDRESS_MAP: { [key: number]: { [contractName: string]: string }
cctpTokenMessenger: "0x8ed94B8dAd2Dc5453862ea5e316A8e71AAed9782",
cctpMessageTransmitter: "0xbc498c326533d675cf571B90A2Ced265ACb7d086",
},
+ [CHAIN_IDs.WORLD_CHAIN]: {
+ cctpTokenMessenger: "0x28b5a0e9C621a5BadaA536219b3a228C8168cf5d",
+ cctpMessageTransmitter: "0x81D40F21F12A8F0E3252Bccb954D722d4c464B64",
+ },
};
export const POLYGON_CHAIN_IDS: { [l1ChainId: number]: number } = {
diff --git a/deployments/deployments.json b/deployments/deployments.json
index e3dd2ac62..afc036d5b 100644
--- a/deployments/deployments.json
+++ b/deployments/deployments.json
@@ -29,7 +29,7 @@
"Blast_RescueAdapter": { "address": "0xE5Dea263511F5caC27b15cBd58Ff103F4Ce90957", "blockNumber": 20378872 },
"Redstone_Adapter": { "address": "0x188F8C95B7cfB7993B53a4F643efa687916f73fA", "blockNumber": 20432774 },
"Zora_Adapter": { "address": "0x024f2fc31cbdd8de17194b1892c834f98ef5169b", "blockNumber": 20512287 },
- "WorldChain_Adapter": { "address": "0xA8399e221a583A57F54Abb5bA22f31b5D6C09f32", "blockNumber": 20963234 },
+ "WorldChain_Adapter": { "address": "0x8bbdD67102D743b8533c1277a4ffdA04Dea158D1", "blockNumber": 22626594 },
"AlephZero_Adapter": { "address": "0x6F4083304C2cA99B077ACE06a5DcF670615915Af", "blockNumber": 21131132 },
"Ink_Adapter": { "address": "0x7e90a40c7519b041a7df6498fbf5662e8cfc61d2", "blockNumber": 21438590 },
"Cher_Adapter": { "address": "0x0c9d064523177dBB55CFE52b9D0c485FBFc35FD2", "blockNumber": 21597341 },
diff --git a/deployments/mainnet/WorldChain_Adapter.json b/deployments/mainnet/WorldChain_Adapter.json
index cd20d3bf4..68bc16915 100644
--- a/deployments/mainnet/WorldChain_Adapter.json
+++ b/deployments/mainnet/WorldChain_Adapter.json
@@ -1,5 +1,5 @@
{
- "address": "0x8eBebfc894047bEE213A561b8792fCa71241731f",
+ "address": "0xf64819Ef8b755341B2A759268A21AF64bc9Fe616",
"abi": [
{
"inputs": [
@@ -22,6 +22,11 @@
"internalType": "contract IERC20",
"name": "_l1Usdc",
"type": "address"
+ },
+ {
+ "internalType": "contract ITokenMessenger",
+ "name": "_cctpTokenMessenger",
+ "type": "address"
}
],
"stateMutability": "nonpayable",
@@ -142,6 +147,19 @@
"stateMutability": "view",
"type": "function"
},
+ {
+ "inputs": [],
+ "name": "cctpV2",
+ "outputs": [
+ {
+ "internalType": "bool",
+ "name": "",
+ "type": "bool"
+ }
+ ],
+ "stateMutability": "view",
+ "type": "function"
+ },
{
"inputs": [],
"name": "recipientCircleDomainId",
@@ -215,19 +233,19 @@
"type": "function"
}
],
- "transactionHash": "0x4b2782119d99b4f0d6b5dc0c3c77a405aa9edf61117ff002697d6507077adb41",
+ "transactionHash": "0x303cb020c0e7a8eabc479f54af6bb1e00cd003ed5d1de09a9aba46ef93bfb516",
"receipt": {
"to": null,
"from": "0x9A8f92a830A5cB89a3816e3D267CB7791c16b04D",
- "contractAddress": "0x8eBebfc894047bEE213A561b8792fCa71241731f",
- "transactionIndex": 87,
- "gasUsed": "977772",
+ "contractAddress": "0xf64819Ef8b755341B2A759268A21AF64bc9Fe616",
+ "transactionIndex": 162,
+ "gasUsed": "974428",
"logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
- "blockHash": "0xb6ba820b1b4225350949fc8342034f5574bfc98680e9a4c11f2263136dda779e",
- "transactionHash": "0x4b2782119d99b4f0d6b5dc0c3c77a405aa9edf61117ff002697d6507077adb41",
+ "blockHash": "0x5752e3e45f554c17b4b6948450943663add8cca558d748a7cee78b79da719c3d",
+ "transactionHash": "0x303cb020c0e7a8eabc479f54af6bb1e00cd003ed5d1de09a9aba46ef93bfb516",
"logs": [],
- "blockNumber": 20921874,
- "cumulativeGasUsed": "8766064",
+ "blockNumber": 22625859,
+ "cumulativeGasUsed": "15734174",
"status": 1,
"byzantium": true
},
@@ -235,13 +253,14 @@
"0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
"0xf931a81D18B1766d15695ffc7c1920a62b7e710a",
"0x470458C91978D2d929704489Ad730DC3E3001113",
- "0x0000000000000000000000000000000000000000"
+ "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
+ "0x28b5a0e9C621a5BadaA536219b3a228C8168cf5d"
],
- "numDeployments": 1,
- "solcInputHash": "99d1a1f8a9ec609c6ba2c28b0402f384",
- "metadata": "{\"compiler\":{\"version\":\"0.8.23+commit.f704f362\"},\"language\":\"Solidity\",\"output\":{\"abi\":[{\"inputs\":[{\"internalType\":\"contract WETH9Interface\",\"name\":\"_l1Weth\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"_crossDomainMessenger\",\"type\":\"address\"},{\"internalType\":\"contract IL1StandardBridge\",\"name\":\"_l1StandardBridge\",\"type\":\"address\"},{\"internalType\":\"contract IERC20\",\"name\":\"_l1Usdc\",\"type\":\"address\"}],\"stateMutability\":\"nonpayable\",\"type\":\"constructor\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address\",\"name\":\"target\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"}],\"name\":\"MessageRelayed\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address\",\"name\":\"l1Token\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"l2Token\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"amount\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"to\",\"type\":\"address\"}],\"name\":\"TokensRelayed\",\"type\":\"event\"},{\"inputs\":[],\"name\":\"L1_STANDARD_BRIDGE\",\"outputs\":[{\"internalType\":\"contract IL1StandardBridge\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"L1_WETH\",\"outputs\":[{\"internalType\":\"contract WETH9Interface\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"L2_GAS_LIMIT\",\"outputs\":[{\"internalType\":\"uint32\",\"name\":\"\",\"type\":\"uint32\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"MESSENGER\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"cctpTokenMessenger\",\"outputs\":[{\"internalType\":\"contract ITokenMessenger\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"recipientCircleDomainId\",\"outputs\":[{\"internalType\":\"uint32\",\"name\":\"\",\"type\":\"uint32\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"target\",\"type\":\"address\"},{\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"}],\"name\":\"relayMessage\",\"outputs\":[],\"stateMutability\":\"payable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"l1Token\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"l2Token\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"amount\",\"type\":\"uint256\"},{\"internalType\":\"address\",\"name\":\"to\",\"type\":\"address\"}],\"name\":\"relayTokens\",\"outputs\":[],\"stateMutability\":\"payable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"usdcToken\",\"outputs\":[{\"internalType\":\"contract IERC20\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"}],\"devdoc\":{\"custom:security-contact\":\"bugs@across.to\",\"details\":\"Public functions calling external contracts do not guard against reentrancy because they are expected to be called via delegatecall, which will execute this contract's logic within the context of the originating contract. For example, the HubPool will delegatecall these functions, therefore its only necessary that the HubPool's methods that call this contract's logic guard against reentrancy.\",\"kind\":\"dev\",\"methods\":{\"constructor\":{\"params\":{\"_crossDomainMessenger\":\"XDomainMessenger World Chain system contract.\",\"_l1StandardBridge\":\"Standard bridge contract.\",\"_l1Usdc\":\"USDC address on L1.\",\"_l1Weth\":\"WETH address on L1.\"}},\"relayMessage(address,bytes)\":{\"params\":{\"message\":\"Data to send to target.\",\"target\":\"Contract on World Chain that will receive message.\"}},\"relayTokens(address,address,uint256,address)\":{\"params\":{\"amount\":\"Amount of L1 tokens to deposit and L2 tokens to receive.\",\"l1Token\":\"L1 token to deposit.\",\"l2Token\":\"L2 token to receive.\",\"to\":\"Bridge recipient.\"}}},\"version\":1},\"userdoc\":{\"kind\":\"user\",\"methods\":{\"constructor\":{\"notice\":\"Constructs new Adapter.\"},\"relayMessage(address,bytes)\":{\"notice\":\"Send cross-chain message to target on World Chain.\"},\"relayTokens(address,address,uint256,address)\":{\"notice\":\"Bridge tokens to World Chain.\"}},\"notice\":\"Contract containing logic to send messages from L1 to World Chain. This is a clone of the Base/Mode adapter\",\"version\":1}},\"settings\":{\"compilationTarget\":{\"contracts/chain-adapters/WorldChain_Adapter.sol\":\"WorldChain_Adapter\"},\"debug\":{\"revertStrings\":\"strip\"},\"evmVersion\":\"shanghai\",\"libraries\":{},\"metadata\":{\"bytecodeHash\":\"ipfs\",\"useLiteralContent\":true},\"optimizer\":{\"enabled\":true,\"runs\":1000000},\"remappings\":[],\"viaIR\":true},\"sources\":{\"@eth-optimism/contracts/L1/messaging/IL1ERC20Bridge.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity >0.5.0 <0.9.0;\\n\\n/**\\n * @title IL1ERC20Bridge\\n */\\ninterface IL1ERC20Bridge {\\n /**********\\n * Events *\\n **********/\\n\\n event ERC20DepositInitiated(\\n address indexed _l1Token,\\n address indexed _l2Token,\\n address indexed _from,\\n address _to,\\n uint256 _amount,\\n bytes _data\\n );\\n\\n event ERC20WithdrawalFinalized(\\n address indexed _l1Token,\\n address indexed _l2Token,\\n address indexed _from,\\n address _to,\\n uint256 _amount,\\n bytes _data\\n );\\n\\n /********************\\n * Public Functions *\\n ********************/\\n\\n /**\\n * @dev get the address of the corresponding L2 bridge contract.\\n * @return Address of the corresponding L2 bridge contract.\\n */\\n function l2TokenBridge() external returns (address);\\n\\n /**\\n * @dev deposit an amount of the ERC20 to the caller's balance on L2.\\n * @param _l1Token Address of the L1 ERC20 we are depositing\\n * @param _l2Token Address of the L1 respective L2 ERC20\\n * @param _amount Amount of the ERC20 to deposit\\n * @param _l2Gas Gas limit required to complete the deposit on L2.\\n * @param _data Optional data to forward to L2. This data is provided\\n * solely as a convenience for external contracts. Aside from enforcing a maximum\\n * length, these contracts provide no guarantees about its content.\\n */\\n function depositERC20(\\n address _l1Token,\\n address _l2Token,\\n uint256 _amount,\\n uint32 _l2Gas,\\n bytes calldata _data\\n ) external;\\n\\n /**\\n * @dev deposit an amount of ERC20 to a recipient's balance on L2.\\n * @param _l1Token Address of the L1 ERC20 we are depositing\\n * @param _l2Token Address of the L1 respective L2 ERC20\\n * @param _to L2 address to credit the withdrawal to.\\n * @param _amount Amount of the ERC20 to deposit.\\n * @param _l2Gas Gas limit required to complete the deposit on L2.\\n * @param _data Optional data to forward to L2. This data is provided\\n * solely as a convenience for external contracts. Aside from enforcing a maximum\\n * length, these contracts provide no guarantees about its content.\\n */\\n function depositERC20To(\\n address _l1Token,\\n address _l2Token,\\n address _to,\\n uint256 _amount,\\n uint32 _l2Gas,\\n bytes calldata _data\\n ) external;\\n\\n /*************************\\n * Cross-chain Functions *\\n *************************/\\n\\n /**\\n * @dev Complete a withdrawal from L2 to L1, and credit funds to the recipient's balance of the\\n * L1 ERC20 token.\\n * This call will fail if the initialized withdrawal from L2 has not been finalized.\\n *\\n * @param _l1Token Address of L1 token to finalizeWithdrawal for.\\n * @param _l2Token Address of L2 token where withdrawal was initiated.\\n * @param _from L2 address initiating the transfer.\\n * @param _to L1 address to credit the withdrawal to.\\n * @param _amount Amount of the ERC20 to deposit.\\n * @param _data Data provided by the sender on L2. This data is provided\\n * solely as a convenience for external contracts. Aside from enforcing a maximum\\n * length, these contracts provide no guarantees about its content.\\n */\\n function finalizeERC20Withdrawal(\\n address _l1Token,\\n address _l2Token,\\n address _from,\\n address _to,\\n uint256 _amount,\\n bytes calldata _data\\n ) external;\\n}\\n\",\"keccak256\":\"0x69f831896dcbb6bef4f2d6c8be6cd1bf352f5910074d3ce973b9f8e0a4f4c1dd\",\"license\":\"MIT\"},\"@eth-optimism/contracts/L1/messaging/IL1StandardBridge.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity >0.5.0 <0.9.0;\\n\\nimport \\\"./IL1ERC20Bridge.sol\\\";\\n\\n/**\\n * @title IL1StandardBridge\\n */\\ninterface IL1StandardBridge is IL1ERC20Bridge {\\n /**********\\n * Events *\\n **********/\\n event ETHDepositInitiated(\\n address indexed _from,\\n address indexed _to,\\n uint256 _amount,\\n bytes _data\\n );\\n\\n event ETHWithdrawalFinalized(\\n address indexed _from,\\n address indexed _to,\\n uint256 _amount,\\n bytes _data\\n );\\n\\n /********************\\n * Public Functions *\\n ********************/\\n\\n /**\\n * @dev Deposit an amount of the ETH to the caller's balance on L2.\\n * @param _l2Gas Gas limit required to complete the deposit on L2.\\n * @param _data Optional data to forward to L2. This data is provided\\n * solely as a convenience for external contracts. Aside from enforcing a maximum\\n * length, these contracts provide no guarantees about its content.\\n */\\n function depositETH(uint32 _l2Gas, bytes calldata _data) external payable;\\n\\n /**\\n * @dev Deposit an amount of ETH to a recipient's balance on L2.\\n * @param _to L2 address to credit the withdrawal to.\\n * @param _l2Gas Gas limit required to complete the deposit on L2.\\n * @param _data Optional data to forward to L2. This data is provided\\n * solely as a convenience for external contracts. Aside from enforcing a maximum\\n * length, these contracts provide no guarantees about its content.\\n */\\n function depositETHTo(\\n address _to,\\n uint32 _l2Gas,\\n bytes calldata _data\\n ) external payable;\\n\\n /*************************\\n * Cross-chain Functions *\\n *************************/\\n\\n /**\\n * @dev Complete a withdrawal from L2 to L1, and credit funds to the recipient's balance of the\\n * L1 ETH token. Since only the xDomainMessenger can call this function, it will never be called\\n * before the withdrawal is finalized.\\n * @param _from L2 address initiating the transfer.\\n * @param _to L1 address to credit the withdrawal to.\\n * @param _amount Amount of the ERC20 to deposit.\\n * @param _data Optional data to forward to L2. This data is provided\\n * solely as a convenience for external contracts. Aside from enforcing a maximum\\n * length, these contracts provide no guarantees about its content.\\n */\\n function finalizeETHWithdrawal(\\n address _from,\\n address _to,\\n uint256 _amount,\\n bytes calldata _data\\n ) external;\\n}\\n\",\"keccak256\":\"0x3d511f1bcea86aa88a9c41798926ea75b5b3f455c0377e63223a123a9e714ddc\",\"license\":\"MIT\"},\"@eth-optimism/contracts/libraries/bridge/ICrossDomainMessenger.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity >0.5.0 <0.9.0;\\n\\n/**\\n * @title ICrossDomainMessenger\\n */\\ninterface ICrossDomainMessenger {\\n /**********\\n * Events *\\n **********/\\n\\n event SentMessage(\\n address indexed target,\\n address sender,\\n bytes message,\\n uint256 messageNonce,\\n uint256 gasLimit\\n );\\n event RelayedMessage(bytes32 indexed msgHash);\\n event FailedRelayedMessage(bytes32 indexed msgHash);\\n\\n /*************\\n * Variables *\\n *************/\\n\\n function xDomainMessageSender() external view returns (address);\\n\\n /********************\\n * Public Functions *\\n ********************/\\n\\n /**\\n * Sends a cross domain message to the target messenger.\\n * @param _target Target contract address.\\n * @param _message Message to send to the target.\\n * @param _gasLimit Gas limit for the provided message.\\n */\\n function sendMessage(\\n address _target,\\n bytes calldata _message,\\n uint32 _gasLimit\\n ) external;\\n}\\n\",\"keccak256\":\"0x8f29ae23021345a20ccac7b5edb3fc38268aef943b65adc8a32e74b80bf1833a\",\"license\":\"MIT\"},\"@openzeppelin/contracts/token/ERC20/IERC20.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v4.9.0) (token/ERC20/IERC20.sol)\\n\\npragma solidity ^0.8.0;\\n\\n/**\\n * @dev Interface of the ERC20 standard as defined in the EIP.\\n */\\ninterface IERC20 {\\n /**\\n * @dev Emitted when `value` tokens are moved from one account (`from`) to\\n * another (`to`).\\n *\\n * Note that `value` may be zero.\\n */\\n event Transfer(address indexed from, address indexed to, uint256 value);\\n\\n /**\\n * @dev Emitted when the allowance of a `spender` for an `owner` is set by\\n * a call to {approve}. `value` is the new allowance.\\n */\\n event Approval(address indexed owner, address indexed spender, uint256 value);\\n\\n /**\\n * @dev Returns the amount of tokens in existence.\\n */\\n function totalSupply() external view returns (uint256);\\n\\n /**\\n * @dev Returns the amount of tokens owned by `account`.\\n */\\n function balanceOf(address account) external view returns (uint256);\\n\\n /**\\n * @dev Moves `amount` tokens from the caller's account to `to`.\\n *\\n * Returns a boolean value indicating whether the operation succeeded.\\n *\\n * Emits a {Transfer} event.\\n */\\n function transfer(address to, uint256 amount) external returns (bool);\\n\\n /**\\n * @dev Returns the remaining number of tokens that `spender` will be\\n * allowed to spend on behalf of `owner` through {transferFrom}. This is\\n * zero by default.\\n *\\n * This value changes when {approve} or {transferFrom} are called.\\n */\\n function allowance(address owner, address spender) external view returns (uint256);\\n\\n /**\\n * @dev Sets `amount` as the allowance of `spender` over the caller's tokens.\\n *\\n * Returns a boolean value indicating whether the operation succeeded.\\n *\\n * IMPORTANT: Beware that changing an allowance with this method brings the risk\\n * that someone may use both the old and the new allowance by unfortunate\\n * transaction ordering. One possible solution to mitigate this race\\n * condition is to first reduce the spender's allowance to 0 and set the\\n * desired value afterwards:\\n * https://github.com/ethereum/EIPs/issues/20#issuecomment-263524729\\n *\\n * Emits an {Approval} event.\\n */\\n function approve(address spender, uint256 amount) external returns (bool);\\n\\n /**\\n * @dev Moves `amount` tokens from `from` to `to` using the\\n * allowance mechanism. `amount` is then deducted from the caller's\\n * allowance.\\n *\\n * Returns a boolean value indicating whether the operation succeeded.\\n *\\n * Emits a {Transfer} event.\\n */\\n function transferFrom(address from, address to, uint256 amount) external returns (bool);\\n}\\n\",\"keccak256\":\"0x287b55befed2961a7eabd7d7b1b2839cbca8a5b80ef8dcbb25ed3d4c2002c305\",\"license\":\"MIT\"},\"@openzeppelin/contracts/token/ERC20/extensions/IERC20Permit.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v4.9.4) (token/ERC20/extensions/IERC20Permit.sol)\\n\\npragma solidity ^0.8.0;\\n\\n/**\\n * @dev Interface of the ERC20 Permit extension allowing approvals to be made via signatures, as defined in\\n * https://eips.ethereum.org/EIPS/eip-2612[EIP-2612].\\n *\\n * Adds the {permit} method, which can be used to change an account's ERC20 allowance (see {IERC20-allowance}) by\\n * presenting a message signed by the account. By not relying on {IERC20-approve}, the token holder account doesn't\\n * need to send a transaction, and thus is not required to hold Ether at all.\\n *\\n * ==== Security Considerations\\n *\\n * There are two important considerations concerning the use of `permit`. The first is that a valid permit signature\\n * expresses an allowance, and it should not be assumed to convey additional meaning. In particular, it should not be\\n * considered as an intention to spend the allowance in any specific way. The second is that because permits have\\n * built-in replay protection and can be submitted by anyone, they can be frontrun. A protocol that uses permits should\\n * take this into consideration and allow a `permit` call to fail. Combining these two aspects, a pattern that may be\\n * generally recommended is:\\n *\\n * ```solidity\\n * function doThingWithPermit(..., uint256 value, uint256 deadline, uint8 v, bytes32 r, bytes32 s) public {\\n * try token.permit(msg.sender, address(this), value, deadline, v, r, s) {} catch {}\\n * doThing(..., value);\\n * }\\n *\\n * function doThing(..., uint256 value) public {\\n * token.safeTransferFrom(msg.sender, address(this), value);\\n * ...\\n * }\\n * ```\\n *\\n * Observe that: 1) `msg.sender` is used as the owner, leaving no ambiguity as to the signer intent, and 2) the use of\\n * `try/catch` allows the permit to fail and makes the code tolerant to frontrunning. (See also\\n * {SafeERC20-safeTransferFrom}).\\n *\\n * Additionally, note that smart contract wallets (such as Argent or Safe) are not able to produce permit signatures, so\\n * contracts should have entry points that don't rely on permit.\\n */\\ninterface IERC20Permit {\\n /**\\n * @dev Sets `value` as the allowance of `spender` over ``owner``'s tokens,\\n * given ``owner``'s signed approval.\\n *\\n * IMPORTANT: The same issues {IERC20-approve} has related to transaction\\n * ordering also apply here.\\n *\\n * Emits an {Approval} event.\\n *\\n * Requirements:\\n *\\n * - `spender` cannot be the zero address.\\n * - `deadline` must be a timestamp in the future.\\n * - `v`, `r` and `s` must be a valid `secp256k1` signature from `owner`\\n * over the EIP712-formatted function arguments.\\n * - the signature must use ``owner``'s current nonce (see {nonces}).\\n *\\n * For more information on the signature format, see the\\n * https://eips.ethereum.org/EIPS/eip-2612#specification[relevant EIP\\n * section].\\n *\\n * CAUTION: See Security Considerations above.\\n */\\n function permit(\\n address owner,\\n address spender,\\n uint256 value,\\n uint256 deadline,\\n uint8 v,\\n bytes32 r,\\n bytes32 s\\n ) external;\\n\\n /**\\n * @dev Returns the current nonce for `owner`. This value must be\\n * included whenever a signature is generated for {permit}.\\n *\\n * Every successful call to {permit} increases ``owner``'s nonce by one. This\\n * prevents a signature from being used multiple times.\\n */\\n function nonces(address owner) external view returns (uint256);\\n\\n /**\\n * @dev Returns the domain separator used in the encoding of the signature for {permit}, as defined by {EIP712}.\\n */\\n // solhint-disable-next-line func-name-mixedcase\\n function DOMAIN_SEPARATOR() external view returns (bytes32);\\n}\\n\",\"keccak256\":\"0xb264c03a3442eb37a68ad620cefd1182766b58bee6cec40343480392d6b14d69\",\"license\":\"MIT\"},\"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v4.9.3) (token/ERC20/utils/SafeERC20.sol)\\n\\npragma solidity ^0.8.0;\\n\\nimport \\\"../IERC20.sol\\\";\\nimport \\\"../extensions/IERC20Permit.sol\\\";\\nimport \\\"../../../utils/Address.sol\\\";\\n\\n/**\\n * @title SafeERC20\\n * @dev Wrappers around ERC20 operations that throw on failure (when the token\\n * contract returns false). Tokens that return no value (and instead revert or\\n * throw on failure) are also supported, non-reverting calls are assumed to be\\n * successful.\\n * To use this library you can add a `using SafeERC20 for IERC20;` statement to your contract,\\n * which allows you to call the safe operations as `token.safeTransfer(...)`, etc.\\n */\\nlibrary SafeERC20 {\\n using Address for address;\\n\\n /**\\n * @dev Transfer `value` amount of `token` from the calling contract to `to`. If `token` returns no value,\\n * non-reverting calls are assumed to be successful.\\n */\\n function safeTransfer(IERC20 token, address to, uint256 value) internal {\\n _callOptionalReturn(token, abi.encodeWithSelector(token.transfer.selector, to, value));\\n }\\n\\n /**\\n * @dev Transfer `value` amount of `token` from `from` to `to`, spending the approval given by `from` to the\\n * calling contract. If `token` returns no value, non-reverting calls are assumed to be successful.\\n */\\n function safeTransferFrom(IERC20 token, address from, address to, uint256 value) internal {\\n _callOptionalReturn(token, abi.encodeWithSelector(token.transferFrom.selector, from, to, value));\\n }\\n\\n /**\\n * @dev Deprecated. This function has issues similar to the ones found in\\n * {IERC20-approve}, and its usage is discouraged.\\n *\\n * Whenever possible, use {safeIncreaseAllowance} and\\n * {safeDecreaseAllowance} instead.\\n */\\n function safeApprove(IERC20 token, address spender, uint256 value) internal {\\n // safeApprove should only be called when setting an initial allowance,\\n // or when resetting it to zero. To increase and decrease it, use\\n // 'safeIncreaseAllowance' and 'safeDecreaseAllowance'\\n require(\\n (value == 0) || (token.allowance(address(this), spender) == 0),\\n \\\"SafeERC20: approve from non-zero to non-zero allowance\\\"\\n );\\n _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, value));\\n }\\n\\n /**\\n * @dev Increase the calling contract's allowance toward `spender` by `value`. If `token` returns no value,\\n * non-reverting calls are assumed to be successful.\\n */\\n function safeIncreaseAllowance(IERC20 token, address spender, uint256 value) internal {\\n uint256 oldAllowance = token.allowance(address(this), spender);\\n _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, oldAllowance + value));\\n }\\n\\n /**\\n * @dev Decrease the calling contract's allowance toward `spender` by `value`. If `token` returns no value,\\n * non-reverting calls are assumed to be successful.\\n */\\n function safeDecreaseAllowance(IERC20 token, address spender, uint256 value) internal {\\n unchecked {\\n uint256 oldAllowance = token.allowance(address(this), spender);\\n require(oldAllowance >= value, \\\"SafeERC20: decreased allowance below zero\\\");\\n _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, oldAllowance - value));\\n }\\n }\\n\\n /**\\n * @dev Set the calling contract's allowance toward `spender` to `value`. If `token` returns no value,\\n * non-reverting calls are assumed to be successful. Meant to be used with tokens that require the approval\\n * to be set to zero before setting it to a non-zero value, such as USDT.\\n */\\n function forceApprove(IERC20 token, address spender, uint256 value) internal {\\n bytes memory approvalCall = abi.encodeWithSelector(token.approve.selector, spender, value);\\n\\n if (!_callOptionalReturnBool(token, approvalCall)) {\\n _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, 0));\\n _callOptionalReturn(token, approvalCall);\\n }\\n }\\n\\n /**\\n * @dev Use a ERC-2612 signature to set the `owner` approval toward `spender` on `token`.\\n * Revert on invalid signature.\\n */\\n function safePermit(\\n IERC20Permit token,\\n address owner,\\n address spender,\\n uint256 value,\\n uint256 deadline,\\n uint8 v,\\n bytes32 r,\\n bytes32 s\\n ) internal {\\n uint256 nonceBefore = token.nonces(owner);\\n token.permit(owner, spender, value, deadline, v, r, s);\\n uint256 nonceAfter = token.nonces(owner);\\n require(nonceAfter == nonceBefore + 1, \\\"SafeERC20: permit did not succeed\\\");\\n }\\n\\n /**\\n * @dev Imitates a Solidity high-level call (i.e. a regular function call to a contract), relaxing the requirement\\n * on the return value: the return value is optional (but if data is returned, it must not be false).\\n * @param token The token targeted by the call.\\n * @param data The call data (encoded using abi.encode or one of its variants).\\n */\\n function _callOptionalReturn(IERC20 token, bytes memory data) private {\\n // We need to perform a low level call here, to bypass Solidity's return data size checking mechanism, since\\n // we're implementing it ourselves. We use {Address-functionCall} to perform this call, which verifies that\\n // the target address contains contract code and also asserts for success in the low-level call.\\n\\n bytes memory returndata = address(token).functionCall(data, \\\"SafeERC20: low-level call failed\\\");\\n require(returndata.length == 0 || abi.decode(returndata, (bool)), \\\"SafeERC20: ERC20 operation did not succeed\\\");\\n }\\n\\n /**\\n * @dev Imitates a Solidity high-level call (i.e. a regular function call to a contract), relaxing the requirement\\n * on the return value: the return value is optional (but if data is returned, it must not be false).\\n * @param token The token targeted by the call.\\n * @param data The call data (encoded using abi.encode or one of its variants).\\n *\\n * This is a variant of {_callOptionalReturn} that silents catches all reverts and returns a bool instead.\\n */\\n function _callOptionalReturnBool(IERC20 token, bytes memory data) private returns (bool) {\\n // We need to perform a low level call here, to bypass Solidity's return data size checking mechanism, since\\n // we're implementing it ourselves. We cannot use {Address-functionCall} here since this should return false\\n // and not revert is the subcall reverts.\\n\\n (bool success, bytes memory returndata) = address(token).call(data);\\n return\\n success && (returndata.length == 0 || abi.decode(returndata, (bool))) && Address.isContract(address(token));\\n }\\n}\\n\",\"keccak256\":\"0xabefac93435967b4d36a4fabcbdbb918d1f0b7ae3c3d85bc30923b326c927ed1\",\"license\":\"MIT\"},\"@openzeppelin/contracts/utils/Address.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v4.9.0) (utils/Address.sol)\\n\\npragma solidity ^0.8.1;\\n\\n/**\\n * @dev Collection of functions related to the address type\\n */\\nlibrary Address {\\n /**\\n * @dev Returns true if `account` is a contract.\\n *\\n * [IMPORTANT]\\n * ====\\n * It is unsafe to assume that an address for which this function returns\\n * false is an externally-owned account (EOA) and not a contract.\\n *\\n * Among others, `isContract` will return false for the following\\n * types of addresses:\\n *\\n * - an externally-owned account\\n * - a contract in construction\\n * - an address where a contract will be created\\n * - an address where a contract lived, but was destroyed\\n *\\n * Furthermore, `isContract` will also return true if the target contract within\\n * the same transaction is already scheduled for destruction by `SELFDESTRUCT`,\\n * which only has an effect at the end of a transaction.\\n * ====\\n *\\n * [IMPORTANT]\\n * ====\\n * You shouldn't rely on `isContract` to protect against flash loan attacks!\\n *\\n * Preventing calls from contracts is highly discouraged. It breaks composability, breaks support for smart wallets\\n * like Gnosis Safe, and does not provide security since it can be circumvented by calling from a contract\\n * constructor.\\n * ====\\n */\\n function isContract(address account) internal view returns (bool) {\\n // This method relies on extcodesize/address.code.length, which returns 0\\n // for contracts in construction, since the code is only stored at the end\\n // of the constructor execution.\\n\\n return account.code.length > 0;\\n }\\n\\n /**\\n * @dev Replacement for Solidity's `transfer`: sends `amount` wei to\\n * `recipient`, forwarding all available gas and reverting on errors.\\n *\\n * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost\\n * of certain opcodes, possibly making contracts go over the 2300 gas limit\\n * imposed by `transfer`, making them unable to receive funds via\\n * `transfer`. {sendValue} removes this limitation.\\n *\\n * https://consensys.net/diligence/blog/2019/09/stop-using-soliditys-transfer-now/[Learn more].\\n *\\n * IMPORTANT: because control is transferred to `recipient`, care must be\\n * taken to not create reentrancy vulnerabilities. Consider using\\n * {ReentrancyGuard} or the\\n * https://solidity.readthedocs.io/en/v0.8.0/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].\\n */\\n function sendValue(address payable recipient, uint256 amount) internal {\\n require(address(this).balance >= amount, \\\"Address: insufficient balance\\\");\\n\\n (bool success, ) = recipient.call{value: amount}(\\\"\\\");\\n require(success, \\\"Address: unable to send value, recipient may have reverted\\\");\\n }\\n\\n /**\\n * @dev Performs a Solidity function call using a low level `call`. A\\n * plain `call` is an unsafe replacement for a function call: use this\\n * function instead.\\n *\\n * If `target` reverts with a revert reason, it is bubbled up by this\\n * function (like regular Solidity function calls).\\n *\\n * Returns the raw returned data. To convert to the expected return value,\\n * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].\\n *\\n * Requirements:\\n *\\n * - `target` must be a contract.\\n * - calling `target` with `data` must not revert.\\n *\\n * _Available since v3.1._\\n */\\n function functionCall(address target, bytes memory data) internal returns (bytes memory) {\\n return functionCallWithValue(target, data, 0, \\\"Address: low-level call failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with\\n * `errorMessage` as a fallback revert reason when `target` reverts.\\n *\\n * _Available since v3.1._\\n */\\n function functionCall(\\n address target,\\n bytes memory data,\\n string memory errorMessage\\n ) internal returns (bytes memory) {\\n return functionCallWithValue(target, data, 0, errorMessage);\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\\n * but also transferring `value` wei to `target`.\\n *\\n * Requirements:\\n *\\n * - the calling contract must have an ETH balance of at least `value`.\\n * - the called Solidity function must be `payable`.\\n *\\n * _Available since v3.1._\\n */\\n function functionCallWithValue(address target, bytes memory data, uint256 value) internal returns (bytes memory) {\\n return functionCallWithValue(target, data, value, \\\"Address: low-level call with value failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but\\n * with `errorMessage` as a fallback revert reason when `target` reverts.\\n *\\n * _Available since v3.1._\\n */\\n function functionCallWithValue(\\n address target,\\n bytes memory data,\\n uint256 value,\\n string memory errorMessage\\n ) internal returns (bytes memory) {\\n require(address(this).balance >= value, \\\"Address: insufficient balance for call\\\");\\n (bool success, bytes memory returndata) = target.call{value: value}(data);\\n return verifyCallResultFromTarget(target, success, returndata, errorMessage);\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\\n * but performing a static call.\\n *\\n * _Available since v3.3._\\n */\\n function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {\\n return functionStaticCall(target, data, \\\"Address: low-level static call failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],\\n * but performing a static call.\\n *\\n * _Available since v3.3._\\n */\\n function functionStaticCall(\\n address target,\\n bytes memory data,\\n string memory errorMessage\\n ) internal view returns (bytes memory) {\\n (bool success, bytes memory returndata) = target.staticcall(data);\\n return verifyCallResultFromTarget(target, success, returndata, errorMessage);\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\\n * but performing a delegate call.\\n *\\n * _Available since v3.4._\\n */\\n function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) {\\n return functionDelegateCall(target, data, \\\"Address: low-level delegate call failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],\\n * but performing a delegate call.\\n *\\n * _Available since v3.4._\\n */\\n function functionDelegateCall(\\n address target,\\n bytes memory data,\\n string memory errorMessage\\n ) internal returns (bytes memory) {\\n (bool success, bytes memory returndata) = target.delegatecall(data);\\n return verifyCallResultFromTarget(target, success, returndata, errorMessage);\\n }\\n\\n /**\\n * @dev Tool to verify that a low level call to smart-contract was successful, and revert (either by bubbling\\n * the revert reason or using the provided one) in case of unsuccessful call or if target was not a contract.\\n *\\n * _Available since v4.8._\\n */\\n function verifyCallResultFromTarget(\\n address target,\\n bool success,\\n bytes memory returndata,\\n string memory errorMessage\\n ) internal view returns (bytes memory) {\\n if (success) {\\n if (returndata.length == 0) {\\n // only check isContract if the call was successful and the return data is empty\\n // otherwise we already know that it was a contract\\n require(isContract(target), \\\"Address: call to non-contract\\\");\\n }\\n return returndata;\\n } else {\\n _revert(returndata, errorMessage);\\n }\\n }\\n\\n /**\\n * @dev Tool to verify that a low level call was successful, and revert if it wasn't, either by bubbling the\\n * revert reason or using the provided one.\\n *\\n * _Available since v4.3._\\n */\\n function verifyCallResult(\\n bool success,\\n bytes memory returndata,\\n string memory errorMessage\\n ) internal pure returns (bytes memory) {\\n if (success) {\\n return returndata;\\n } else {\\n _revert(returndata, errorMessage);\\n }\\n }\\n\\n function _revert(bytes memory returndata, string memory errorMessage) private pure {\\n // Look for revert reason and bubble it up if present\\n if (returndata.length > 0) {\\n // The easiest way to bubble the revert reason is using memory via assembly\\n /// @solidity memory-safe-assembly\\n assembly {\\n let returndata_size := mload(returndata)\\n revert(add(32, returndata), returndata_size)\\n }\\n } else {\\n revert(errorMessage);\\n }\\n }\\n}\\n\",\"keccak256\":\"0x006dd67219697fe68d7fbfdea512e7c4cb64a43565ed86171d67e844982da6fa\",\"license\":\"MIT\"},\"contracts/chain-adapters/CrossDomainEnabled.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity ^0.8.0;\\n\\n/* Interface Imports */\\nimport { ICrossDomainMessenger } from \\\"@eth-optimism/contracts/libraries/bridge/ICrossDomainMessenger.sol\\\";\\n\\n/**\\n * @title CrossDomainEnabled\\n * @custom:security-contact bugs@across.to\\n * @dev Helper contract for contracts performing cross-domain communications between L1 and Optimism.\\n * @dev This modifies the eth-optimism/CrossDomainEnabled contract only by changing state variables to be\\n * immutable for use in contracts like the Optimism_Adapter which use delegateCall().\\n */\\ncontract CrossDomainEnabled {\\n // Messenger contract used to send and recieve messages from the other domain.\\n address public immutable MESSENGER;\\n\\n /**\\n * @param _messenger Address of the CrossDomainMessenger on the current layer.\\n */\\n constructor(address _messenger) {\\n MESSENGER = _messenger;\\n }\\n\\n /**\\n * Gets the messenger, usually from storage. This function is exposed in case a child contract\\n * needs to override.\\n * @return The address of the cross-domain messenger contract which should be used.\\n */\\n function getCrossDomainMessenger() internal virtual returns (ICrossDomainMessenger) {\\n return ICrossDomainMessenger(MESSENGER);\\n }\\n\\n /**\\n * Sends a message to an account on another domain\\n * @param _crossDomainTarget The intended recipient on the destination domain\\n * @param _gasLimit The gasLimit for the receipt of the message on the target domain.\\n * @param _message The data to send to the target (usually calldata to a function with\\n * onlyFromCrossDomainAccount())\\n */\\n function sendCrossDomainMessage(\\n address _crossDomainTarget,\\n uint32 _gasLimit,\\n bytes calldata _message\\n ) internal {\\n // slither-disable-next-line reentrancy-events, reentrancy-benign\\n getCrossDomainMessenger().sendMessage(_crossDomainTarget, _message, _gasLimit);\\n }\\n}\\n\",\"keccak256\":\"0xb4705bab7468a6a7a6f3c635df73ca18215d5c78986dd336ab500fd75c63789f\",\"license\":\"MIT\"},\"contracts/chain-adapters/WorldChain_Adapter.sol\":{\"content\":\"// SPDX-License-Identifier: BUSL-1.1\\npragma solidity ^0.8.0;\\n\\nimport \\\"./interfaces/AdapterInterface.sol\\\";\\nimport \\\"../external/interfaces/WETH9Interface.sol\\\";\\n\\n// @dev Use local modified CrossDomainEnabled contract instead of one exported by eth-optimism because we need\\n// this contract's state variables to be `immutable` because of the delegateCall call.\\nimport \\\"./CrossDomainEnabled.sol\\\";\\nimport \\\"@eth-optimism/contracts/L1/messaging/IL1StandardBridge.sol\\\";\\n\\nimport \\\"@openzeppelin/contracts/token/ERC20/IERC20.sol\\\";\\nimport \\\"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\\\";\\n\\nimport \\\"../libraries/CircleCCTPAdapter.sol\\\";\\nimport \\\"../external/interfaces/CCTPInterfaces.sol\\\";\\n\\n/**\\n * @notice Contract containing logic to send messages from L1 to World Chain. This is a clone of the Base/Mode adapter\\n * @dev Public functions calling external contracts do not guard against reentrancy because they are expected to be\\n * called via delegatecall, which will execute this contract's logic within the context of the originating contract.\\n * For example, the HubPool will delegatecall these functions, therefore its only necessary that the HubPool's methods\\n * that call this contract's logic guard against reentrancy.\\n * @custom:security-contact bugs@across.to\\n */\\n\\n// solhint-disable-next-line contract-name-camelcase\\ncontract WorldChain_Adapter is CrossDomainEnabled, AdapterInterface, CircleCCTPAdapter {\\n using SafeERC20 for IERC20;\\n uint32 public constant L2_GAS_LIMIT = 200_000;\\n\\n WETH9Interface public immutable L1_WETH;\\n\\n IL1StandardBridge public immutable L1_STANDARD_BRIDGE;\\n\\n /**\\n * @notice Constructs new Adapter.\\n * @param _l1Weth WETH address on L1.\\n * @param _crossDomainMessenger XDomainMessenger World Chain system contract.\\n * @param _l1StandardBridge Standard bridge contract.\\n * @param _l1Usdc USDC address on L1.\\n */\\n constructor(\\n WETH9Interface _l1Weth,\\n address _crossDomainMessenger,\\n IL1StandardBridge _l1StandardBridge,\\n IERC20 _l1Usdc\\n )\\n CrossDomainEnabled(_crossDomainMessenger)\\n CircleCCTPAdapter(\\n _l1Usdc,\\n // Hardcode cctp messenger to 0x0 to disable CCTP bridging.\\n ITokenMessenger(address(0)),\\n CircleDomainIds.UNINTIALIZED\\n )\\n {\\n L1_WETH = _l1Weth;\\n L1_STANDARD_BRIDGE = _l1StandardBridge;\\n }\\n\\n /**\\n * @notice Send cross-chain message to target on World Chain.\\n * @param target Contract on World Chain that will receive message.\\n * @param message Data to send to target.\\n */\\n function relayMessage(address target, bytes calldata message) external payable override {\\n sendCrossDomainMessage(target, L2_GAS_LIMIT, message);\\n emit MessageRelayed(target, message);\\n }\\n\\n /**\\n * @notice Bridge tokens to World Chain.\\n * @param l1Token L1 token to deposit.\\n * @param l2Token L2 token to receive.\\n * @param amount Amount of L1 tokens to deposit and L2 tokens to receive.\\n * @param to Bridge recipient.\\n */\\n function relayTokens(\\n address l1Token,\\n address l2Token,\\n uint256 amount,\\n address to\\n ) external payable override {\\n // If the l1Token is weth then unwrap it to ETH then send the ETH to the standard bridge.\\n if (l1Token == address(L1_WETH)) {\\n L1_WETH.withdraw(amount);\\n L1_STANDARD_BRIDGE.depositETHTo{ value: amount }(to, L2_GAS_LIMIT, \\\"\\\");\\n }\\n // Check if this token is USDC, which requires a custom bridge via CCTP.\\n else if (_isCCTPEnabled() && l1Token == address(usdcToken)) {\\n _transferUsdc(to, amount);\\n } else {\\n IL1StandardBridge _l1StandardBridge = L1_STANDARD_BRIDGE;\\n\\n IERC20(l1Token).safeIncreaseAllowance(address(_l1StandardBridge), amount);\\n _l1StandardBridge.depositERC20To(l1Token, l2Token, to, amount, L2_GAS_LIMIT, \\\"\\\");\\n }\\n emit TokensRelayed(l1Token, l2Token, amount, to);\\n }\\n}\\n\",\"keccak256\":\"0x567edccdee74b7e8e273a2d66e1f0121c777df349f79adc88483163242b59f77\",\"license\":\"BUSL-1.1\"},\"contracts/chain-adapters/interfaces/AdapterInterface.sol\":{\"content\":\"// SPDX-License-Identifier: BUSL-1.1\\npragma solidity ^0.8.0;\\n\\n/**\\n * @notice Sends cross chain messages and tokens to contracts on a specific L2 network.\\n * This interface is implemented by an adapter contract that is deployed on L1.\\n */\\n\\ninterface AdapterInterface {\\n event MessageRelayed(address target, bytes message);\\n\\n event TokensRelayed(address l1Token, address l2Token, uint256 amount, address to);\\n\\n /**\\n * @notice Send message to `target` on L2.\\n * @dev This method is marked payable because relaying the message might require a fee\\n * to be paid by the sender to forward the message to L2. However, it will not send msg.value\\n * to the target contract on L2.\\n * @param target L2 address to send message to.\\n * @param message Message to send to `target`.\\n */\\n function relayMessage(address target, bytes calldata message) external payable;\\n\\n /**\\n * @notice Send `amount` of `l1Token` to `to` on L2. `l2Token` is the L2 address equivalent of `l1Token`.\\n * @dev This method is marked payable because relaying the message might require a fee\\n * to be paid by the sender to forward the message to L2. However, it will not send msg.value\\n * to the target contract on L2.\\n * @param l1Token L1 token to bridge.\\n * @param l2Token L2 token to receive.\\n * @param amount Amount of `l1Token` to bridge.\\n * @param to Bridge recipient.\\n */\\n function relayTokens(\\n address l1Token,\\n address l2Token,\\n uint256 amount,\\n address to\\n ) external payable;\\n}\\n\",\"keccak256\":\"0x1d52fcb8b10dc7f260345918c1a90d496a4c9f774402cbd5ebde881b8fed6d50\",\"license\":\"BUSL-1.1\"},\"contracts/external/interfaces/CCTPInterfaces.sol\":{\"content\":\"/**\\n * Copyright (C) 2015, 2016, 2017 Dapphub\\n *\\n * This program is free software: you can redistribute it and/or modify\\n * it under the terms of the GNU General Public License as published by\\n * the Free Software Foundation, either version 3 of the License, or\\n * (at your option) any later version.\\n *\\n * This program is distributed in the hope that it will be useful,\\n * but WITHOUT ANY WARRANTY; without even the implied warranty of\\n * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the\\n * GNU General Public License for more details.\\n *\\n * You should have received a copy of the GNU General Public License\\n * along with this program. If not, see .\\n */\\n\\n// SPDX-License-Identifier: GPL-3.0-or-later\\npragma solidity ^0.8.0;\\n\\n/**\\n * Imported as-is from commit 139d8d0ce3b5531d3c7ec284f89d946dfb720016 of:\\n * * https://github.com/walkerq/evm-cctp-contracts/blob/139d8d0ce3b5531d3c7ec284f89d946dfb720016/src/TokenMessenger.sol\\n * Changes applied post-import:\\n * * Removed a majority of code from this contract and converted the needed function signatures in this interface.\\n */\\ninterface ITokenMessenger {\\n /**\\n * @notice Deposits and burns tokens from sender to be minted on destination domain.\\n * Emits a `DepositForBurn` event.\\n * @dev reverts if:\\n * - given burnToken is not supported\\n * - given destinationDomain has no TokenMessenger registered\\n * - transferFrom() reverts. For example, if sender's burnToken balance or approved allowance\\n * to this contract is less than `amount`.\\n * - burn() reverts. For example, if `amount` is 0.\\n * - MessageTransmitter returns false or reverts.\\n * @param amount amount of tokens to burn\\n * @param destinationDomain destination domain\\n * @param mintRecipient address of mint recipient on destination domain\\n * @param burnToken address of contract to burn deposited tokens, on local domain\\n * @return _nonce unique nonce reserved by message\\n */\\n function depositForBurn(\\n uint256 amount,\\n uint32 destinationDomain,\\n bytes32 mintRecipient,\\n address burnToken\\n ) external returns (uint64 _nonce);\\n\\n /**\\n * @notice Minter responsible for minting and burning tokens on the local domain\\n * @dev A TokenMessenger stores a TokenMinter contract which extends the TokenController contract.\\n * https://github.com/circlefin/evm-cctp-contracts/blob/817397db0a12963accc08ff86065491577bbc0e5/src/TokenMessenger.sol#L110\\n * @return minter Token Minter contract.\\n */\\n function localMinter() external view returns (ITokenMinter minter);\\n}\\n\\n/**\\n * A TokenMessenger stores a TokenMinter contract which extends the TokenController contract. The TokenController\\n * contract has a burnLimitsPerMessage public mapping which can be queried to find the per-message burn limit\\n * for a given token:\\n * https://github.com/circlefin/evm-cctp-contracts/blob/817397db0a12963accc08ff86065491577bbc0e5/src/TokenMinter.sol#L33\\n * https://github.com/circlefin/evm-cctp-contracts/blob/817397db0a12963accc08ff86065491577bbc0e5/src/roles/TokenController.sol#L69C40-L69C60\\n *\\n */\\ninterface ITokenMinter {\\n /**\\n * @notice Supported burnable tokens on the local domain\\n * local token (address) => maximum burn amounts per message\\n * @param token address of token contract\\n * @return burnLimit maximum burn amount per message for token\\n */\\n function burnLimitsPerMessage(address token) external view returns (uint256);\\n}\\n\",\"keccak256\":\"0x9d6606bb3b0c52bcdbe834d4bc2cb97db6bfd2a906178598f5891d662d0450bd\",\"license\":\"GPL-3.0-or-later\"},\"contracts/external/interfaces/WETH9Interface.sol\":{\"content\":\"// SPDX-License-Identifier: BUSL-1.1\\npragma solidity ^0.8.0;\\n\\n/**\\n * @notice Interface for the WETH9 contract.\\n */\\ninterface WETH9Interface {\\n /**\\n * @notice Burn Wrapped Ether and receive native Ether.\\n * @param wad Amount of WETH to unwrap and send to caller.\\n */\\n function withdraw(uint256 wad) external;\\n\\n /**\\n * @notice Lock native Ether and mint Wrapped Ether ERC20\\n * @dev msg.value is amount of Wrapped Ether to mint/Ether to lock.\\n */\\n function deposit() external payable;\\n\\n /**\\n * @notice Get balance of WETH held by `guy`.\\n * @param guy Address to get balance of.\\n * @return wad Amount of WETH held by `guy`.\\n */\\n function balanceOf(address guy) external view returns (uint256 wad);\\n\\n /**\\n * @notice Transfer `wad` of WETH from caller to `guy`.\\n * @param guy Address to send WETH to.\\n * @param wad Amount of WETH to send.\\n * @return ok True if transfer succeeded.\\n */\\n function transfer(address guy, uint256 wad) external returns (bool);\\n}\\n\",\"keccak256\":\"0x3f7892554ec7f54681fdd3cc18a41346c246c9c1afba016c52990ef77741f718\",\"license\":\"BUSL-1.1\"},\"contracts/libraries/CircleCCTPAdapter.sol\":{\"content\":\"// SPDX-License-Identifier: BUSL-1.1\\npragma solidity ^0.8.0;\\n\\nimport \\\"@openzeppelin/contracts/token/ERC20/IERC20.sol\\\";\\nimport \\\"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\\\";\\nimport \\\"../external/interfaces/CCTPInterfaces.sol\\\";\\n\\nlibrary CircleDomainIds {\\n uint32 public constant Ethereum = 0;\\n uint32 public constant Optimism = 2;\\n uint32 public constant Arbitrum = 3;\\n uint32 public constant Base = 6;\\n uint32 public constant Polygon = 7;\\n // Use this value for placeholder purposes only for adapters that extend this adapter but haven't yet been\\n // assigned a domain ID by Circle.\\n uint32 public constant UNINTIALIZED = type(uint32).max;\\n}\\n\\n/**\\n * @notice Facilitate bridging USDC via Circle's CCTP.\\n * @dev This contract is intended to be inherited by other chain-specific adapters and spoke pools.\\n * @custom:security-contact bugs@across.to\\n */\\nabstract contract CircleCCTPAdapter {\\n using SafeERC20 for IERC20;\\n\\n /**\\n * @notice The domain ID that CCTP will transfer funds to.\\n * @dev This identifier is assigned by Circle and is not related to a chain ID.\\n * @dev Official domain list can be found here: https://developers.circle.com/stablecoins/docs/supported-domains\\n */\\n /// @custom:oz-upgrades-unsafe-allow state-variable-immutable\\n uint32 public immutable recipientCircleDomainId;\\n\\n /**\\n * @notice The official USDC contract address on this chain.\\n * @dev Posted officially here: https://developers.circle.com/stablecoins/docs/usdc-on-main-networks\\n */\\n /// @custom:oz-upgrades-unsafe-allow state-variable-immutable\\n IERC20 public immutable usdcToken;\\n\\n /**\\n * @notice The official Circle CCTP token bridge contract endpoint.\\n * @dev Posted officially here: https://developers.circle.com/stablecoins/docs/evm-smart-contracts\\n */\\n /// @custom:oz-upgrades-unsafe-allow state-variable-immutable\\n ITokenMessenger public immutable cctpTokenMessenger;\\n\\n /**\\n * @notice intiailizes the CircleCCTPAdapter contract.\\n * @param _usdcToken USDC address on the current chain.\\n * @param _cctpTokenMessenger TokenMessenger contract to bridge via CCTP. If the zero address is passed, CCTP bridging will be disabled.\\n * @param _recipientCircleDomainId The domain ID that CCTP will transfer funds to.\\n */\\n /// @custom:oz-upgrades-unsafe-allow constructor\\n constructor(\\n IERC20 _usdcToken,\\n ITokenMessenger _cctpTokenMessenger,\\n uint32 _recipientCircleDomainId\\n ) {\\n usdcToken = _usdcToken;\\n cctpTokenMessenger = _cctpTokenMessenger;\\n recipientCircleDomainId = _recipientCircleDomainId;\\n }\\n\\n /**\\n * @notice converts address to bytes32 (alignment preserving cast.)\\n * @param addr the address to convert to bytes32\\n * @dev Sourced from the official CCTP repo: https://github.com/walkerq/evm-cctp-contracts/blob/139d8d0ce3b5531d3c7ec284f89d946dfb720016/src/messages/Message.sol#L142C1-L148C6\\n */\\n function _addressToBytes32(address addr) internal pure returns (bytes32) {\\n return bytes32(uint256(uint160(addr)));\\n }\\n\\n /**\\n * @notice Returns whether or not the CCTP bridge is enabled.\\n * @dev If the CCTPTokenMessenger is the zero address, CCTP bridging is disabled.\\n */\\n function _isCCTPEnabled() internal view returns (bool) {\\n return address(cctpTokenMessenger) != address(0);\\n }\\n\\n /**\\n * @notice Transfers USDC from the current domain to the given address on the new domain.\\n * @dev This function will revert if the CCTP bridge is disabled. I.e. if the zero address is passed to the constructor for the cctpTokenMessenger.\\n * @param to Address to receive USDC on the new domain.\\n * @param amount Amount of USDC to transfer.\\n */\\n function _transferUsdc(address to, uint256 amount) internal {\\n // Only approve the exact amount to be transferred\\n usdcToken.safeIncreaseAllowance(address(cctpTokenMessenger), amount);\\n // Submit the amount to be transferred to bridged via the TokenMessenger.\\n // If the amount to send exceeds the burn limit per message, then split the message into smaller parts.\\n ITokenMinter cctpMinter = cctpTokenMessenger.localMinter();\\n uint256 burnLimit = cctpMinter.burnLimitsPerMessage(address(usdcToken));\\n uint256 remainingAmount = amount;\\n bytes32 recipient = _addressToBytes32(to);\\n while (remainingAmount > 0) {\\n uint256 partAmount = remainingAmount > burnLimit ? burnLimit : remainingAmount;\\n cctpTokenMessenger.depositForBurn(partAmount, recipientCircleDomainId, recipient, address(usdcToken));\\n remainingAmount -= partAmount;\\n }\\n }\\n}\\n\",\"keccak256\":\"0x04481a0fe0c4a39c047d485a1f7563b737417fadb6cb42ceb4d0b286493d8124\",\"license\":\"BUSL-1.1\"}},\"version\":1}",
- "bytecode": "0x6101403461012a57601f61120c38819003918201601f19168301916001600160401b0383118484101761012e5780849260809460405283398101031261012a578051906001600160a01b03808316830361012a576020820151818116810361012a57604083015192828416840361012a5760600151918216820361012a5760805260c0525f60e05263ffffffff60a052610100918252610120908152604051906110c99283610143843960805183818161010901526102be015260a05183818161031d0152610751015260c05183818161061a01528181610b750152610cd6015260e05183818161024f015281816105eb01528181610656015281816106bf01526108570152518281816104090152610c6a0152518181816104ab015281816109c60152610bfc0152f35b5f80fd5b634e487b7160e01b5f52604160045260245ffdfe6080806040526004361015610012575f80fd5b5f905f3560e01c90816311eac85514610c8e575080631efd482a14610c2057806335a2db6a14610bb257806352c8c75c1461037d5780635e743ef7146103415780636e400983146102e2578063927ede2d146102735780639748cf7c146102045763e6eb8ade14610081575f80fd5b60407ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffc360112610201576100b3610cfa565b6024359067ffffffffffffffff908183116101ee57366023840112156101ee5782600401359182116101ee57602483019260248336920101116101ee578373ffffffffffffffffffffffffffffffffffffffff807f00000000000000000000000000000000000000000000000000000000000000001692833b156101fd5782906040519283917f3dbb202b00000000000000000000000000000000000000000000000000000000835216948560048301526060602483015281838161017c606482018b8d610d9f565b62030d40604483015203925af180156101f2576101da575b50506101d47f9e6c52944e331ba6270e7fe4cea2a4086bae8f7a27e1cdba07f416806f5d0ac4936040519384938452604060208501526040840191610d9f565b0390a180f35b6101e390610d1d565b6101ee57835f610194565b8380fd5b6040513d84823e3d90fd5b8280fd5b80fd5b503461020157807ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffc36011261020157602060405173ffffffffffffffffffffffffffffffffffffffff7f0000000000000000000000000000000000000000000000000000000000000000168152f35b503461020157807ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffc36011261020157602060405173ffffffffffffffffffffffffffffffffffffffff7f0000000000000000000000000000000000000000000000000000000000000000168152f35b503461020157807ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffc36011261020157602060405163ffffffff7f0000000000000000000000000000000000000000000000000000000000000000168152f35b503461020157807ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffc36011261020157602060405162030d408152f35b5060807ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffc360112610944576103b0610cfa565b60243573ffffffffffffffffffffffffffffffffffffffff81168103610944576064359073ffffffffffffffffffffffffffffffffffffffff82168203610944578373ffffffffffffffffffffffffffffffffffffffff7f0000000000000000000000000000000000000000000000000000000000000000168073ffffffffffffffffffffffffffffffffffffffff8616145f146105d257803b156105ba578180916024604051809481937f2e1a7d4d00000000000000000000000000000000000000000000000000000000835260443560048401525af180156101f2576105be575b5073ffffffffffffffffffffffffffffffffffffffff7f000000000000000000000000000000000000000000000000000000000000000016803b156105ba5781608491604051928380927f9a2ac6d500000000000000000000000000000000000000000000000000000000825273ffffffffffffffffffffffffffffffffffffffff8916600483015262030d40602483015260606044830152846064830152604435905af180156101f2576105a2575b50509173ffffffffffffffffffffffffffffffffffffffff608092817fd7e09655439c3932e55857df3220186e5a7f0980825f20691c2b35d941dee75b955b81604051951685521660208401526044356040840152166060820152a180f35b6105ae90949294610d1d565b6101ee5791835f610543565b5080fd5b6105c790610d1d565b6101ee57835f610493565b505073ffffffffffffffffffffffffffffffffffffffff7f000000000000000000000000000000000000000000000000000000000000000016151580610b5d575b156109af577f000000000000000000000000000000000000000000000000000000000000000061067c60443573ffffffffffffffffffffffffffffffffffffffff7f00000000000000000000000000000000000000000000000000000000000000001683610ddd565b6040517fcb75c11c00000000000000000000000000000000000000000000000000000000815260208160048173ffffffffffffffffffffffffffffffffffffffff7f0000000000000000000000000000000000000000000000000000000000000000165afa90811561095057869161095b575b50602073ffffffffffffffffffffffffffffffffffffffff916024604051809481937fa56ec6320000000000000000000000000000000000000000000000000000000083528188166004840152165afa90811561095057869161091a575b50907f000000000000000000000000000000000000000000000000000000000000000063ffffffff1690604435805b6107c557505050509173ffffffffffffffffffffffffffffffffffffffff608092817fd7e09655439c3932e55857df3220186e5a7f0980825f20691c2b35d941dee75b95610582565b8381111561091457835b6040517f6fd3504e00000000000000000000000000000000000000000000000000000000815281600482015284602482015273ffffffffffffffffffffffffffffffffffffffff8816604482015273ffffffffffffffffffffffffffffffffffffffff841660648201526020816084818d73ffffffffffffffffffffffffffffffffffffffff7f0000000000000000000000000000000000000000000000000000000000000000165af18015610909576108c1575b508103908111610894578061077c565b6024887f4e487b710000000000000000000000000000000000000000000000000000000081526011600452fd5b6020813d602011610901575b816108da60209383610d5e565b810103126108fd575167ffffffffffffffff8116036108f9575f610884565b8880fd5b8980fd5b3d91506108cd565b6040513d8c823e3d90fd5b806107cf565b90506020813d602011610948575b8161093560209383610d5e565b8101031261094457515f61074d565b5f80fd5b3d9150610928565b6040513d88823e3d90fd5b90506020813d6020116109a7575b8161097660209383610d5e565b810103126109a3575173ffffffffffffffffffffffffffffffffffffffff811681036109a35760206106ef565b8580fd5b3d9150610969565b73ffffffffffffffffffffffffffffffffffffffff7f000000000000000000000000000000000000000000000000000000000000000016610a096044358273ffffffffffffffffffffffffffffffffffffffff8716610ddd565b803b15610944575f809160e4604051809481937f838b252000000000000000000000000000000000000000000000000000000000835273ffffffffffffffffffffffffffffffffffffffff8a16600484015273ffffffffffffffffffffffffffffffffffffffff8816602484015273ffffffffffffffffffffffffffffffffffffffff89166044840152604435606484015262030d40608484015260c060a48401528160c48401525af18015610b5257610b00575b509173ffffffffffffffffffffffffffffffffffffffff608092817fd7e09655439c3932e55857df3220186e5a7f0980825f20691c2b35d941dee75b95610582565b7fd7e09655439c3932e55857df3220186e5a7f0980825f20691c2b35d941dee75b93919450608092610b4673ffffffffffffffffffffffffffffffffffffffff92610d1d565b5f959294509250610abe565b6040513d5f823e3d90fd5b5073ffffffffffffffffffffffffffffffffffffffff7f00000000000000000000000000000000000000000000000000000000000000001673ffffffffffffffffffffffffffffffffffffffff841614610613565b34610944575f7ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffc36011261094457602060405173ffffffffffffffffffffffffffffffffffffffff7f0000000000000000000000000000000000000000000000000000000000000000168152f35b34610944575f7ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffc36011261094457602060405173ffffffffffffffffffffffffffffffffffffffff7f0000000000000000000000000000000000000000000000000000000000000000168152f35b34610944575f7ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffc3601126109445760209073ffffffffffffffffffffffffffffffffffffffff7f0000000000000000000000000000000000000000000000000000000000000000168152f35b6004359073ffffffffffffffffffffffffffffffffffffffff8216820361094457565b67ffffffffffffffff8111610d3157604052565b7f4e487b71000000000000000000000000000000000000000000000000000000005f52604160045260245ffd5b90601f7fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe0910116810190811067ffffffffffffffff821117610d3157604052565b601f82602094937fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe093818652868601375f8582860101520116010190565b9291909273ffffffffffffffffffffffffffffffffffffffff809116604051917fdd62ed3e000000000000000000000000000000000000000000000000000000008352306004840152602495169182868201526020938482604481865afa918215610b52575f9261103b575b50810180911161100f5760405190848201937f095ea7b3000000000000000000000000000000000000000000000000000000008552878301526044820152604481526080810167ffffffffffffffff9382821085831117610fe35760c083019282841086851117610fb757865f94938594604052527f5361666545524332303a206c6f772d6c6576656c2063616c6c206661696c656460a0820152519082855af1903d15610fa6573d928311610f7a57610f429394955060405192610f35867fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe0601f8401160185610d5e565b83523d5f8685013e61106a565b8051918215918215610f5a575b505090501561094457565b809250819381010312610944570151801515810361094457805f80610f4f565b857f4e487b71000000000000000000000000000000000000000000000000000000005f5260416004525ffd5b9150610f429293945060609161106a565b887f4e487b71000000000000000000000000000000000000000000000000000000005f5260416004525ffd5b877f4e487b71000000000000000000000000000000000000000000000000000000005f5260416004525ffd5b857f4e487b71000000000000000000000000000000000000000000000000000000005f5260116004525ffd5b9091508481813d8311611063575b6110538183610d5e565b810103126109445751905f610e49565b503d611049565b90156110845781511561107b575090565b3b156109445790565b50805190811561094457602001fdfea264697066735822122042611080eed14bdd9ceb7063618bca3deb8c206010dc935a7de83e2b1e5eb8f164736f6c63430008170033",
- "deployedBytecode": "0x6080806040526004361015610012575f80fd5b5f905f3560e01c90816311eac85514610c8e575080631efd482a14610c2057806335a2db6a14610bb257806352c8c75c1461037d5780635e743ef7146103415780636e400983146102e2578063927ede2d146102735780639748cf7c146102045763e6eb8ade14610081575f80fd5b60407ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffc360112610201576100b3610cfa565b6024359067ffffffffffffffff908183116101ee57366023840112156101ee5782600401359182116101ee57602483019260248336920101116101ee578373ffffffffffffffffffffffffffffffffffffffff807f00000000000000000000000000000000000000000000000000000000000000001692833b156101fd5782906040519283917f3dbb202b00000000000000000000000000000000000000000000000000000000835216948560048301526060602483015281838161017c606482018b8d610d9f565b62030d40604483015203925af180156101f2576101da575b50506101d47f9e6c52944e331ba6270e7fe4cea2a4086bae8f7a27e1cdba07f416806f5d0ac4936040519384938452604060208501526040840191610d9f565b0390a180f35b6101e390610d1d565b6101ee57835f610194565b8380fd5b6040513d84823e3d90fd5b8280fd5b80fd5b503461020157807ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffc36011261020157602060405173ffffffffffffffffffffffffffffffffffffffff7f0000000000000000000000000000000000000000000000000000000000000000168152f35b503461020157807ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffc36011261020157602060405173ffffffffffffffffffffffffffffffffffffffff7f0000000000000000000000000000000000000000000000000000000000000000168152f35b503461020157807ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffc36011261020157602060405163ffffffff7f0000000000000000000000000000000000000000000000000000000000000000168152f35b503461020157807ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffc36011261020157602060405162030d408152f35b5060807ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffc360112610944576103b0610cfa565b60243573ffffffffffffffffffffffffffffffffffffffff81168103610944576064359073ffffffffffffffffffffffffffffffffffffffff82168203610944578373ffffffffffffffffffffffffffffffffffffffff7f0000000000000000000000000000000000000000000000000000000000000000168073ffffffffffffffffffffffffffffffffffffffff8616145f146105d257803b156105ba578180916024604051809481937f2e1a7d4d00000000000000000000000000000000000000000000000000000000835260443560048401525af180156101f2576105be575b5073ffffffffffffffffffffffffffffffffffffffff7f000000000000000000000000000000000000000000000000000000000000000016803b156105ba5781608491604051928380927f9a2ac6d500000000000000000000000000000000000000000000000000000000825273ffffffffffffffffffffffffffffffffffffffff8916600483015262030d40602483015260606044830152846064830152604435905af180156101f2576105a2575b50509173ffffffffffffffffffffffffffffffffffffffff608092817fd7e09655439c3932e55857df3220186e5a7f0980825f20691c2b35d941dee75b955b81604051951685521660208401526044356040840152166060820152a180f35b6105ae90949294610d1d565b6101ee5791835f610543565b5080fd5b6105c790610d1d565b6101ee57835f610493565b505073ffffffffffffffffffffffffffffffffffffffff7f000000000000000000000000000000000000000000000000000000000000000016151580610b5d575b156109af577f000000000000000000000000000000000000000000000000000000000000000061067c60443573ffffffffffffffffffffffffffffffffffffffff7f00000000000000000000000000000000000000000000000000000000000000001683610ddd565b6040517fcb75c11c00000000000000000000000000000000000000000000000000000000815260208160048173ffffffffffffffffffffffffffffffffffffffff7f0000000000000000000000000000000000000000000000000000000000000000165afa90811561095057869161095b575b50602073ffffffffffffffffffffffffffffffffffffffff916024604051809481937fa56ec6320000000000000000000000000000000000000000000000000000000083528188166004840152165afa90811561095057869161091a575b50907f000000000000000000000000000000000000000000000000000000000000000063ffffffff1690604435805b6107c557505050509173ffffffffffffffffffffffffffffffffffffffff608092817fd7e09655439c3932e55857df3220186e5a7f0980825f20691c2b35d941dee75b95610582565b8381111561091457835b6040517f6fd3504e00000000000000000000000000000000000000000000000000000000815281600482015284602482015273ffffffffffffffffffffffffffffffffffffffff8816604482015273ffffffffffffffffffffffffffffffffffffffff841660648201526020816084818d73ffffffffffffffffffffffffffffffffffffffff7f0000000000000000000000000000000000000000000000000000000000000000165af18015610909576108c1575b508103908111610894578061077c565b6024887f4e487b710000000000000000000000000000000000000000000000000000000081526011600452fd5b6020813d602011610901575b816108da60209383610d5e565b810103126108fd575167ffffffffffffffff8116036108f9575f610884565b8880fd5b8980fd5b3d91506108cd565b6040513d8c823e3d90fd5b806107cf565b90506020813d602011610948575b8161093560209383610d5e565b8101031261094457515f61074d565b5f80fd5b3d9150610928565b6040513d88823e3d90fd5b90506020813d6020116109a7575b8161097660209383610d5e565b810103126109a3575173ffffffffffffffffffffffffffffffffffffffff811681036109a35760206106ef565b8580fd5b3d9150610969565b73ffffffffffffffffffffffffffffffffffffffff7f000000000000000000000000000000000000000000000000000000000000000016610a096044358273ffffffffffffffffffffffffffffffffffffffff8716610ddd565b803b15610944575f809160e4604051809481937f838b252000000000000000000000000000000000000000000000000000000000835273ffffffffffffffffffffffffffffffffffffffff8a16600484015273ffffffffffffffffffffffffffffffffffffffff8816602484015273ffffffffffffffffffffffffffffffffffffffff89166044840152604435606484015262030d40608484015260c060a48401528160c48401525af18015610b5257610b00575b509173ffffffffffffffffffffffffffffffffffffffff608092817fd7e09655439c3932e55857df3220186e5a7f0980825f20691c2b35d941dee75b95610582565b7fd7e09655439c3932e55857df3220186e5a7f0980825f20691c2b35d941dee75b93919450608092610b4673ffffffffffffffffffffffffffffffffffffffff92610d1d565b5f959294509250610abe565b6040513d5f823e3d90fd5b5073ffffffffffffffffffffffffffffffffffffffff7f00000000000000000000000000000000000000000000000000000000000000001673ffffffffffffffffffffffffffffffffffffffff841614610613565b34610944575f7ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffc36011261094457602060405173ffffffffffffffffffffffffffffffffffffffff7f0000000000000000000000000000000000000000000000000000000000000000168152f35b34610944575f7ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffc36011261094457602060405173ffffffffffffffffffffffffffffffffffffffff7f0000000000000000000000000000000000000000000000000000000000000000168152f35b34610944575f7ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffc3601126109445760209073ffffffffffffffffffffffffffffffffffffffff7f0000000000000000000000000000000000000000000000000000000000000000168152f35b6004359073ffffffffffffffffffffffffffffffffffffffff8216820361094457565b67ffffffffffffffff8111610d3157604052565b7f4e487b71000000000000000000000000000000000000000000000000000000005f52604160045260245ffd5b90601f7fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe0910116810190811067ffffffffffffffff821117610d3157604052565b601f82602094937fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe093818652868601375f8582860101520116010190565b9291909273ffffffffffffffffffffffffffffffffffffffff809116604051917fdd62ed3e000000000000000000000000000000000000000000000000000000008352306004840152602495169182868201526020938482604481865afa918215610b52575f9261103b575b50810180911161100f5760405190848201937f095ea7b3000000000000000000000000000000000000000000000000000000008552878301526044820152604481526080810167ffffffffffffffff9382821085831117610fe35760c083019282841086851117610fb757865f94938594604052527f5361666545524332303a206c6f772d6c6576656c2063616c6c206661696c656460a0820152519082855af1903d15610fa6573d928311610f7a57610f429394955060405192610f35867fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe0601f8401160185610d5e565b83523d5f8685013e61106a565b8051918215918215610f5a575b505090501561094457565b809250819381010312610944570151801515810361094457805f80610f4f565b857f4e487b71000000000000000000000000000000000000000000000000000000005f5260416004525ffd5b9150610f429293945060609161106a565b887f4e487b71000000000000000000000000000000000000000000000000000000005f5260416004525ffd5b877f4e487b71000000000000000000000000000000000000000000000000000000005f5260416004525ffd5b857f4e487b71000000000000000000000000000000000000000000000000000000005f5260116004525ffd5b9091508481813d8311611063575b6110538183610d5e565b810103126109445751905f610e49565b503d611049565b90156110845781511561107b575090565b3b156109445790565b50805190811561094457602001fdfea264697066735822122042611080eed14bdd9ceb7063618bca3deb8c206010dc935a7de83e2b1e5eb8f164736f6c63430008170033",
+ "numDeployments": 3,
+ "solcInputHash": "dc324d2c58d7b0ed46f2033874127662",
+ "metadata": "{\"compiler\":{\"version\":\"0.8.23+commit.f704f362\"},\"language\":\"Solidity\",\"output\":{\"abi\":[{\"inputs\":[{\"internalType\":\"contract WETH9Interface\",\"name\":\"_l1Weth\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"_crossDomainMessenger\",\"type\":\"address\"},{\"internalType\":\"contract IL1StandardBridge\",\"name\":\"_l1StandardBridge\",\"type\":\"address\"},{\"internalType\":\"contract IERC20\",\"name\":\"_l1Usdc\",\"type\":\"address\"},{\"internalType\":\"contract ITokenMessenger\",\"name\":\"_cctpTokenMessenger\",\"type\":\"address\"}],\"stateMutability\":\"nonpayable\",\"type\":\"constructor\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address\",\"name\":\"target\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"}],\"name\":\"MessageRelayed\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address\",\"name\":\"l1Token\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"l2Token\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"amount\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"to\",\"type\":\"address\"}],\"name\":\"TokensRelayed\",\"type\":\"event\"},{\"inputs\":[],\"name\":\"L1_STANDARD_BRIDGE\",\"outputs\":[{\"internalType\":\"contract IL1StandardBridge\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"L1_WETH\",\"outputs\":[{\"internalType\":\"contract WETH9Interface\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"L2_GAS_LIMIT\",\"outputs\":[{\"internalType\":\"uint32\",\"name\":\"\",\"type\":\"uint32\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"MESSENGER\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"cctpTokenMessenger\",\"outputs\":[{\"internalType\":\"contract ITokenMessenger\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"cctpV2\",\"outputs\":[{\"internalType\":\"bool\",\"name\":\"\",\"type\":\"bool\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"recipientCircleDomainId\",\"outputs\":[{\"internalType\":\"uint32\",\"name\":\"\",\"type\":\"uint32\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"target\",\"type\":\"address\"},{\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"}],\"name\":\"relayMessage\",\"outputs\":[],\"stateMutability\":\"payable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"l1Token\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"l2Token\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"amount\",\"type\":\"uint256\"},{\"internalType\":\"address\",\"name\":\"to\",\"type\":\"address\"}],\"name\":\"relayTokens\",\"outputs\":[],\"stateMutability\":\"payable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"usdcToken\",\"outputs\":[{\"internalType\":\"contract IERC20\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"}],\"devdoc\":{\"custom:security-contact\":\"bugs@across.to\",\"details\":\"Public functions calling external contracts do not guard against reentrancy because they are expected to be called via delegatecall, which will execute this contract's logic within the context of the originating contract. For example, the HubPool will delegatecall these functions, therefore its only necessary that the HubPool's methods that call this contract's logic guard against reentrancy.\",\"kind\":\"dev\",\"methods\":{\"constructor\":{\"params\":{\"_cctpTokenMessenger\":\"TokenMessenger contract to bridge via CCTP.\",\"_crossDomainMessenger\":\"XDomainMessenger Doctor Who system contract.\",\"_l1StandardBridge\":\"Standard bridge contract.\",\"_l1Usdc\":\"USDC address on L1.\",\"_l1Weth\":\"WETH address on L1.\"}},\"relayMessage(address,bytes)\":{\"params\":{\"message\":\"Data to send to target.\",\"target\":\"Contract on Doctor Who that will receive message.\"}},\"relayTokens(address,address,uint256,address)\":{\"params\":{\"amount\":\"Amount of L1 tokens to deposit and L2 tokens to receive.\",\"l1Token\":\"L1 token to deposit.\",\"l2Token\":\"L2 token to receive.\",\"to\":\"Bridge recipient.\"}}},\"version\":1},\"userdoc\":{\"kind\":\"user\",\"methods\":{\"constructor\":{\"notice\":\"Constructs new Adapter.\"},\"relayMessage(address,bytes)\":{\"notice\":\"Send cross-chain message to target on Doctor Who.\"},\"relayTokens(address,address,uint256,address)\":{\"notice\":\"Bridge tokens to Doctor Who.\"}},\"notice\":\"Contract containing logic to send messages from L1 to Doctor Who. This is a modified version of the Optimism adapter that excludes the custom bridging logic.\",\"version\":1}},\"settings\":{\"compilationTarget\":{\"contracts/chain-adapters/WorldChain_Adapter.sol\":\"WorldChain_Adapter\"},\"debug\":{\"revertStrings\":\"strip\"},\"evmVersion\":\"shanghai\",\"libraries\":{},\"metadata\":{\"bytecodeHash\":\"ipfs\",\"useLiteralContent\":true},\"optimizer\":{\"enabled\":true,\"runs\":1000000},\"remappings\":[],\"viaIR\":true},\"sources\":{\"@eth-optimism/contracts/L1/messaging/IL1ERC20Bridge.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity >0.5.0 <0.9.0;\\n\\n/**\\n * @title IL1ERC20Bridge\\n */\\ninterface IL1ERC20Bridge {\\n /**********\\n * Events *\\n **********/\\n\\n event ERC20DepositInitiated(\\n address indexed _l1Token,\\n address indexed _l2Token,\\n address indexed _from,\\n address _to,\\n uint256 _amount,\\n bytes _data\\n );\\n\\n event ERC20WithdrawalFinalized(\\n address indexed _l1Token,\\n address indexed _l2Token,\\n address indexed _from,\\n address _to,\\n uint256 _amount,\\n bytes _data\\n );\\n\\n /********************\\n * Public Functions *\\n ********************/\\n\\n /**\\n * @dev get the address of the corresponding L2 bridge contract.\\n * @return Address of the corresponding L2 bridge contract.\\n */\\n function l2TokenBridge() external returns (address);\\n\\n /**\\n * @dev deposit an amount of the ERC20 to the caller's balance on L2.\\n * @param _l1Token Address of the L1 ERC20 we are depositing\\n * @param _l2Token Address of the L1 respective L2 ERC20\\n * @param _amount Amount of the ERC20 to deposit\\n * @param _l2Gas Gas limit required to complete the deposit on L2.\\n * @param _data Optional data to forward to L2. This data is provided\\n * solely as a convenience for external contracts. Aside from enforcing a maximum\\n * length, these contracts provide no guarantees about its content.\\n */\\n function depositERC20(\\n address _l1Token,\\n address _l2Token,\\n uint256 _amount,\\n uint32 _l2Gas,\\n bytes calldata _data\\n ) external;\\n\\n /**\\n * @dev deposit an amount of ERC20 to a recipient's balance on L2.\\n * @param _l1Token Address of the L1 ERC20 we are depositing\\n * @param _l2Token Address of the L1 respective L2 ERC20\\n * @param _to L2 address to credit the withdrawal to.\\n * @param _amount Amount of the ERC20 to deposit.\\n * @param _l2Gas Gas limit required to complete the deposit on L2.\\n * @param _data Optional data to forward to L2. This data is provided\\n * solely as a convenience for external contracts. Aside from enforcing a maximum\\n * length, these contracts provide no guarantees about its content.\\n */\\n function depositERC20To(\\n address _l1Token,\\n address _l2Token,\\n address _to,\\n uint256 _amount,\\n uint32 _l2Gas,\\n bytes calldata _data\\n ) external;\\n\\n /*************************\\n * Cross-chain Functions *\\n *************************/\\n\\n /**\\n * @dev Complete a withdrawal from L2 to L1, and credit funds to the recipient's balance of the\\n * L1 ERC20 token.\\n * This call will fail if the initialized withdrawal from L2 has not been finalized.\\n *\\n * @param _l1Token Address of L1 token to finalizeWithdrawal for.\\n * @param _l2Token Address of L2 token where withdrawal was initiated.\\n * @param _from L2 address initiating the transfer.\\n * @param _to L1 address to credit the withdrawal to.\\n * @param _amount Amount of the ERC20 to deposit.\\n * @param _data Data provided by the sender on L2. This data is provided\\n * solely as a convenience for external contracts. Aside from enforcing a maximum\\n * length, these contracts provide no guarantees about its content.\\n */\\n function finalizeERC20Withdrawal(\\n address _l1Token,\\n address _l2Token,\\n address _from,\\n address _to,\\n uint256 _amount,\\n bytes calldata _data\\n ) external;\\n}\\n\",\"keccak256\":\"0x69f831896dcbb6bef4f2d6c8be6cd1bf352f5910074d3ce973b9f8e0a4f4c1dd\",\"license\":\"MIT\"},\"@eth-optimism/contracts/L1/messaging/IL1StandardBridge.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity >0.5.0 <0.9.0;\\n\\nimport \\\"./IL1ERC20Bridge.sol\\\";\\n\\n/**\\n * @title IL1StandardBridge\\n */\\ninterface IL1StandardBridge is IL1ERC20Bridge {\\n /**********\\n * Events *\\n **********/\\n event ETHDepositInitiated(\\n address indexed _from,\\n address indexed _to,\\n uint256 _amount,\\n bytes _data\\n );\\n\\n event ETHWithdrawalFinalized(\\n address indexed _from,\\n address indexed _to,\\n uint256 _amount,\\n bytes _data\\n );\\n\\n /********************\\n * Public Functions *\\n ********************/\\n\\n /**\\n * @dev Deposit an amount of the ETH to the caller's balance on L2.\\n * @param _l2Gas Gas limit required to complete the deposit on L2.\\n * @param _data Optional data to forward to L2. This data is provided\\n * solely as a convenience for external contracts. Aside from enforcing a maximum\\n * length, these contracts provide no guarantees about its content.\\n */\\n function depositETH(uint32 _l2Gas, bytes calldata _data) external payable;\\n\\n /**\\n * @dev Deposit an amount of ETH to a recipient's balance on L2.\\n * @param _to L2 address to credit the withdrawal to.\\n * @param _l2Gas Gas limit required to complete the deposit on L2.\\n * @param _data Optional data to forward to L2. This data is provided\\n * solely as a convenience for external contracts. Aside from enforcing a maximum\\n * length, these contracts provide no guarantees about its content.\\n */\\n function depositETHTo(\\n address _to,\\n uint32 _l2Gas,\\n bytes calldata _data\\n ) external payable;\\n\\n /*************************\\n * Cross-chain Functions *\\n *************************/\\n\\n /**\\n * @dev Complete a withdrawal from L2 to L1, and credit funds to the recipient's balance of the\\n * L1 ETH token. Since only the xDomainMessenger can call this function, it will never be called\\n * before the withdrawal is finalized.\\n * @param _from L2 address initiating the transfer.\\n * @param _to L1 address to credit the withdrawal to.\\n * @param _amount Amount of the ERC20 to deposit.\\n * @param _data Optional data to forward to L2. This data is provided\\n * solely as a convenience for external contracts. Aside from enforcing a maximum\\n * length, these contracts provide no guarantees about its content.\\n */\\n function finalizeETHWithdrawal(\\n address _from,\\n address _to,\\n uint256 _amount,\\n bytes calldata _data\\n ) external;\\n}\\n\",\"keccak256\":\"0x3d511f1bcea86aa88a9c41798926ea75b5b3f455c0377e63223a123a9e714ddc\",\"license\":\"MIT\"},\"@eth-optimism/contracts/libraries/bridge/ICrossDomainMessenger.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity >0.5.0 <0.9.0;\\n\\n/**\\n * @title ICrossDomainMessenger\\n */\\ninterface ICrossDomainMessenger {\\n /**********\\n * Events *\\n **********/\\n\\n event SentMessage(\\n address indexed target,\\n address sender,\\n bytes message,\\n uint256 messageNonce,\\n uint256 gasLimit\\n );\\n event RelayedMessage(bytes32 indexed msgHash);\\n event FailedRelayedMessage(bytes32 indexed msgHash);\\n\\n /*************\\n * Variables *\\n *************/\\n\\n function xDomainMessageSender() external view returns (address);\\n\\n /********************\\n * Public Functions *\\n ********************/\\n\\n /**\\n * Sends a cross domain message to the target messenger.\\n * @param _target Target contract address.\\n * @param _message Message to send to the target.\\n * @param _gasLimit Gas limit for the provided message.\\n */\\n function sendMessage(\\n address _target,\\n bytes calldata _message,\\n uint32 _gasLimit\\n ) external;\\n}\\n\",\"keccak256\":\"0x8f29ae23021345a20ccac7b5edb3fc38268aef943b65adc8a32e74b80bf1833a\",\"license\":\"MIT\"},\"@openzeppelin/contracts/token/ERC20/IERC20.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v4.9.0) (token/ERC20/IERC20.sol)\\n\\npragma solidity ^0.8.0;\\n\\n/**\\n * @dev Interface of the ERC20 standard as defined in the EIP.\\n */\\ninterface IERC20 {\\n /**\\n * @dev Emitted when `value` tokens are moved from one account (`from`) to\\n * another (`to`).\\n *\\n * Note that `value` may be zero.\\n */\\n event Transfer(address indexed from, address indexed to, uint256 value);\\n\\n /**\\n * @dev Emitted when the allowance of a `spender` for an `owner` is set by\\n * a call to {approve}. `value` is the new allowance.\\n */\\n event Approval(address indexed owner, address indexed spender, uint256 value);\\n\\n /**\\n * @dev Returns the amount of tokens in existence.\\n */\\n function totalSupply() external view returns (uint256);\\n\\n /**\\n * @dev Returns the amount of tokens owned by `account`.\\n */\\n function balanceOf(address account) external view returns (uint256);\\n\\n /**\\n * @dev Moves `amount` tokens from the caller's account to `to`.\\n *\\n * Returns a boolean value indicating whether the operation succeeded.\\n *\\n * Emits a {Transfer} event.\\n */\\n function transfer(address to, uint256 amount) external returns (bool);\\n\\n /**\\n * @dev Returns the remaining number of tokens that `spender` will be\\n * allowed to spend on behalf of `owner` through {transferFrom}. This is\\n * zero by default.\\n *\\n * This value changes when {approve} or {transferFrom} are called.\\n */\\n function allowance(address owner, address spender) external view returns (uint256);\\n\\n /**\\n * @dev Sets `amount` as the allowance of `spender` over the caller's tokens.\\n *\\n * Returns a boolean value indicating whether the operation succeeded.\\n *\\n * IMPORTANT: Beware that changing an allowance with this method brings the risk\\n * that someone may use both the old and the new allowance by unfortunate\\n * transaction ordering. One possible solution to mitigate this race\\n * condition is to first reduce the spender's allowance to 0 and set the\\n * desired value afterwards:\\n * https://github.com/ethereum/EIPs/issues/20#issuecomment-263524729\\n *\\n * Emits an {Approval} event.\\n */\\n function approve(address spender, uint256 amount) external returns (bool);\\n\\n /**\\n * @dev Moves `amount` tokens from `from` to `to` using the\\n * allowance mechanism. `amount` is then deducted from the caller's\\n * allowance.\\n *\\n * Returns a boolean value indicating whether the operation succeeded.\\n *\\n * Emits a {Transfer} event.\\n */\\n function transferFrom(address from, address to, uint256 amount) external returns (bool);\\n}\\n\",\"keccak256\":\"0x287b55befed2961a7eabd7d7b1b2839cbca8a5b80ef8dcbb25ed3d4c2002c305\",\"license\":\"MIT\"},\"@openzeppelin/contracts/token/ERC20/extensions/IERC20Permit.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v4.9.4) (token/ERC20/extensions/IERC20Permit.sol)\\n\\npragma solidity ^0.8.0;\\n\\n/**\\n * @dev Interface of the ERC20 Permit extension allowing approvals to be made via signatures, as defined in\\n * https://eips.ethereum.org/EIPS/eip-2612[EIP-2612].\\n *\\n * Adds the {permit} method, which can be used to change an account's ERC20 allowance (see {IERC20-allowance}) by\\n * presenting a message signed by the account. By not relying on {IERC20-approve}, the token holder account doesn't\\n * need to send a transaction, and thus is not required to hold Ether at all.\\n *\\n * ==== Security Considerations\\n *\\n * There are two important considerations concerning the use of `permit`. The first is that a valid permit signature\\n * expresses an allowance, and it should not be assumed to convey additional meaning. In particular, it should not be\\n * considered as an intention to spend the allowance in any specific way. The second is that because permits have\\n * built-in replay protection and can be submitted by anyone, they can be frontrun. A protocol that uses permits should\\n * take this into consideration and allow a `permit` call to fail. Combining these two aspects, a pattern that may be\\n * generally recommended is:\\n *\\n * ```solidity\\n * function doThingWithPermit(..., uint256 value, uint256 deadline, uint8 v, bytes32 r, bytes32 s) public {\\n * try token.permit(msg.sender, address(this), value, deadline, v, r, s) {} catch {}\\n * doThing(..., value);\\n * }\\n *\\n * function doThing(..., uint256 value) public {\\n * token.safeTransferFrom(msg.sender, address(this), value);\\n * ...\\n * }\\n * ```\\n *\\n * Observe that: 1) `msg.sender` is used as the owner, leaving no ambiguity as to the signer intent, and 2) the use of\\n * `try/catch` allows the permit to fail and makes the code tolerant to frontrunning. (See also\\n * {SafeERC20-safeTransferFrom}).\\n *\\n * Additionally, note that smart contract wallets (such as Argent or Safe) are not able to produce permit signatures, so\\n * contracts should have entry points that don't rely on permit.\\n */\\ninterface IERC20Permit {\\n /**\\n * @dev Sets `value` as the allowance of `spender` over ``owner``'s tokens,\\n * given ``owner``'s signed approval.\\n *\\n * IMPORTANT: The same issues {IERC20-approve} has related to transaction\\n * ordering also apply here.\\n *\\n * Emits an {Approval} event.\\n *\\n * Requirements:\\n *\\n * - `spender` cannot be the zero address.\\n * - `deadline` must be a timestamp in the future.\\n * - `v`, `r` and `s` must be a valid `secp256k1` signature from `owner`\\n * over the EIP712-formatted function arguments.\\n * - the signature must use ``owner``'s current nonce (see {nonces}).\\n *\\n * For more information on the signature format, see the\\n * https://eips.ethereum.org/EIPS/eip-2612#specification[relevant EIP\\n * section].\\n *\\n * CAUTION: See Security Considerations above.\\n */\\n function permit(\\n address owner,\\n address spender,\\n uint256 value,\\n uint256 deadline,\\n uint8 v,\\n bytes32 r,\\n bytes32 s\\n ) external;\\n\\n /**\\n * @dev Returns the current nonce for `owner`. This value must be\\n * included whenever a signature is generated for {permit}.\\n *\\n * Every successful call to {permit} increases ``owner``'s nonce by one. This\\n * prevents a signature from being used multiple times.\\n */\\n function nonces(address owner) external view returns (uint256);\\n\\n /**\\n * @dev Returns the domain separator used in the encoding of the signature for {permit}, as defined by {EIP712}.\\n */\\n // solhint-disable-next-line func-name-mixedcase\\n function DOMAIN_SEPARATOR() external view returns (bytes32);\\n}\\n\",\"keccak256\":\"0xb264c03a3442eb37a68ad620cefd1182766b58bee6cec40343480392d6b14d69\",\"license\":\"MIT\"},\"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v4.9.3) (token/ERC20/utils/SafeERC20.sol)\\n\\npragma solidity ^0.8.0;\\n\\nimport \\\"../IERC20.sol\\\";\\nimport \\\"../extensions/IERC20Permit.sol\\\";\\nimport \\\"../../../utils/Address.sol\\\";\\n\\n/**\\n * @title SafeERC20\\n * @dev Wrappers around ERC20 operations that throw on failure (when the token\\n * contract returns false). Tokens that return no value (and instead revert or\\n * throw on failure) are also supported, non-reverting calls are assumed to be\\n * successful.\\n * To use this library you can add a `using SafeERC20 for IERC20;` statement to your contract,\\n * which allows you to call the safe operations as `token.safeTransfer(...)`, etc.\\n */\\nlibrary SafeERC20 {\\n using Address for address;\\n\\n /**\\n * @dev Transfer `value` amount of `token` from the calling contract to `to`. If `token` returns no value,\\n * non-reverting calls are assumed to be successful.\\n */\\n function safeTransfer(IERC20 token, address to, uint256 value) internal {\\n _callOptionalReturn(token, abi.encodeWithSelector(token.transfer.selector, to, value));\\n }\\n\\n /**\\n * @dev Transfer `value` amount of `token` from `from` to `to`, spending the approval given by `from` to the\\n * calling contract. If `token` returns no value, non-reverting calls are assumed to be successful.\\n */\\n function safeTransferFrom(IERC20 token, address from, address to, uint256 value) internal {\\n _callOptionalReturn(token, abi.encodeWithSelector(token.transferFrom.selector, from, to, value));\\n }\\n\\n /**\\n * @dev Deprecated. This function has issues similar to the ones found in\\n * {IERC20-approve}, and its usage is discouraged.\\n *\\n * Whenever possible, use {safeIncreaseAllowance} and\\n * {safeDecreaseAllowance} instead.\\n */\\n function safeApprove(IERC20 token, address spender, uint256 value) internal {\\n // safeApprove should only be called when setting an initial allowance,\\n // or when resetting it to zero. To increase and decrease it, use\\n // 'safeIncreaseAllowance' and 'safeDecreaseAllowance'\\n require(\\n (value == 0) || (token.allowance(address(this), spender) == 0),\\n \\\"SafeERC20: approve from non-zero to non-zero allowance\\\"\\n );\\n _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, value));\\n }\\n\\n /**\\n * @dev Increase the calling contract's allowance toward `spender` by `value`. If `token` returns no value,\\n * non-reverting calls are assumed to be successful.\\n */\\n function safeIncreaseAllowance(IERC20 token, address spender, uint256 value) internal {\\n uint256 oldAllowance = token.allowance(address(this), spender);\\n _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, oldAllowance + value));\\n }\\n\\n /**\\n * @dev Decrease the calling contract's allowance toward `spender` by `value`. If `token` returns no value,\\n * non-reverting calls are assumed to be successful.\\n */\\n function safeDecreaseAllowance(IERC20 token, address spender, uint256 value) internal {\\n unchecked {\\n uint256 oldAllowance = token.allowance(address(this), spender);\\n require(oldAllowance >= value, \\\"SafeERC20: decreased allowance below zero\\\");\\n _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, oldAllowance - value));\\n }\\n }\\n\\n /**\\n * @dev Set the calling contract's allowance toward `spender` to `value`. If `token` returns no value,\\n * non-reverting calls are assumed to be successful. Meant to be used with tokens that require the approval\\n * to be set to zero before setting it to a non-zero value, such as USDT.\\n */\\n function forceApprove(IERC20 token, address spender, uint256 value) internal {\\n bytes memory approvalCall = abi.encodeWithSelector(token.approve.selector, spender, value);\\n\\n if (!_callOptionalReturnBool(token, approvalCall)) {\\n _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, 0));\\n _callOptionalReturn(token, approvalCall);\\n }\\n }\\n\\n /**\\n * @dev Use a ERC-2612 signature to set the `owner` approval toward `spender` on `token`.\\n * Revert on invalid signature.\\n */\\n function safePermit(\\n IERC20Permit token,\\n address owner,\\n address spender,\\n uint256 value,\\n uint256 deadline,\\n uint8 v,\\n bytes32 r,\\n bytes32 s\\n ) internal {\\n uint256 nonceBefore = token.nonces(owner);\\n token.permit(owner, spender, value, deadline, v, r, s);\\n uint256 nonceAfter = token.nonces(owner);\\n require(nonceAfter == nonceBefore + 1, \\\"SafeERC20: permit did not succeed\\\");\\n }\\n\\n /**\\n * @dev Imitates a Solidity high-level call (i.e. a regular function call to a contract), relaxing the requirement\\n * on the return value: the return value is optional (but if data is returned, it must not be false).\\n * @param token The token targeted by the call.\\n * @param data The call data (encoded using abi.encode or one of its variants).\\n */\\n function _callOptionalReturn(IERC20 token, bytes memory data) private {\\n // We need to perform a low level call here, to bypass Solidity's return data size checking mechanism, since\\n // we're implementing it ourselves. We use {Address-functionCall} to perform this call, which verifies that\\n // the target address contains contract code and also asserts for success in the low-level call.\\n\\n bytes memory returndata = address(token).functionCall(data, \\\"SafeERC20: low-level call failed\\\");\\n require(returndata.length == 0 || abi.decode(returndata, (bool)), \\\"SafeERC20: ERC20 operation did not succeed\\\");\\n }\\n\\n /**\\n * @dev Imitates a Solidity high-level call (i.e. a regular function call to a contract), relaxing the requirement\\n * on the return value: the return value is optional (but if data is returned, it must not be false).\\n * @param token The token targeted by the call.\\n * @param data The call data (encoded using abi.encode or one of its variants).\\n *\\n * This is a variant of {_callOptionalReturn} that silents catches all reverts and returns a bool instead.\\n */\\n function _callOptionalReturnBool(IERC20 token, bytes memory data) private returns (bool) {\\n // We need to perform a low level call here, to bypass Solidity's return data size checking mechanism, since\\n // we're implementing it ourselves. We cannot use {Address-functionCall} here since this should return false\\n // and not revert is the subcall reverts.\\n\\n (bool success, bytes memory returndata) = address(token).call(data);\\n return\\n success && (returndata.length == 0 || abi.decode(returndata, (bool))) && Address.isContract(address(token));\\n }\\n}\\n\",\"keccak256\":\"0xabefac93435967b4d36a4fabcbdbb918d1f0b7ae3c3d85bc30923b326c927ed1\",\"license\":\"MIT\"},\"@openzeppelin/contracts/utils/Address.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v4.9.0) (utils/Address.sol)\\n\\npragma solidity ^0.8.1;\\n\\n/**\\n * @dev Collection of functions related to the address type\\n */\\nlibrary Address {\\n /**\\n * @dev Returns true if `account` is a contract.\\n *\\n * [IMPORTANT]\\n * ====\\n * It is unsafe to assume that an address for which this function returns\\n * false is an externally-owned account (EOA) and not a contract.\\n *\\n * Among others, `isContract` will return false for the following\\n * types of addresses:\\n *\\n * - an externally-owned account\\n * - a contract in construction\\n * - an address where a contract will be created\\n * - an address where a contract lived, but was destroyed\\n *\\n * Furthermore, `isContract` will also return true if the target contract within\\n * the same transaction is already scheduled for destruction by `SELFDESTRUCT`,\\n * which only has an effect at the end of a transaction.\\n * ====\\n *\\n * [IMPORTANT]\\n * ====\\n * You shouldn't rely on `isContract` to protect against flash loan attacks!\\n *\\n * Preventing calls from contracts is highly discouraged. It breaks composability, breaks support for smart wallets\\n * like Gnosis Safe, and does not provide security since it can be circumvented by calling from a contract\\n * constructor.\\n * ====\\n */\\n function isContract(address account) internal view returns (bool) {\\n // This method relies on extcodesize/address.code.length, which returns 0\\n // for contracts in construction, since the code is only stored at the end\\n // of the constructor execution.\\n\\n return account.code.length > 0;\\n }\\n\\n /**\\n * @dev Replacement for Solidity's `transfer`: sends `amount` wei to\\n * `recipient`, forwarding all available gas and reverting on errors.\\n *\\n * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost\\n * of certain opcodes, possibly making contracts go over the 2300 gas limit\\n * imposed by `transfer`, making them unable to receive funds via\\n * `transfer`. {sendValue} removes this limitation.\\n *\\n * https://consensys.net/diligence/blog/2019/09/stop-using-soliditys-transfer-now/[Learn more].\\n *\\n * IMPORTANT: because control is transferred to `recipient`, care must be\\n * taken to not create reentrancy vulnerabilities. Consider using\\n * {ReentrancyGuard} or the\\n * https://solidity.readthedocs.io/en/v0.8.0/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].\\n */\\n function sendValue(address payable recipient, uint256 amount) internal {\\n require(address(this).balance >= amount, \\\"Address: insufficient balance\\\");\\n\\n (bool success, ) = recipient.call{value: amount}(\\\"\\\");\\n require(success, \\\"Address: unable to send value, recipient may have reverted\\\");\\n }\\n\\n /**\\n * @dev Performs a Solidity function call using a low level `call`. A\\n * plain `call` is an unsafe replacement for a function call: use this\\n * function instead.\\n *\\n * If `target` reverts with a revert reason, it is bubbled up by this\\n * function (like regular Solidity function calls).\\n *\\n * Returns the raw returned data. To convert to the expected return value,\\n * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].\\n *\\n * Requirements:\\n *\\n * - `target` must be a contract.\\n * - calling `target` with `data` must not revert.\\n *\\n * _Available since v3.1._\\n */\\n function functionCall(address target, bytes memory data) internal returns (bytes memory) {\\n return functionCallWithValue(target, data, 0, \\\"Address: low-level call failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with\\n * `errorMessage` as a fallback revert reason when `target` reverts.\\n *\\n * _Available since v3.1._\\n */\\n function functionCall(\\n address target,\\n bytes memory data,\\n string memory errorMessage\\n ) internal returns (bytes memory) {\\n return functionCallWithValue(target, data, 0, errorMessage);\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\\n * but also transferring `value` wei to `target`.\\n *\\n * Requirements:\\n *\\n * - the calling contract must have an ETH balance of at least `value`.\\n * - the called Solidity function must be `payable`.\\n *\\n * _Available since v3.1._\\n */\\n function functionCallWithValue(address target, bytes memory data, uint256 value) internal returns (bytes memory) {\\n return functionCallWithValue(target, data, value, \\\"Address: low-level call with value failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but\\n * with `errorMessage` as a fallback revert reason when `target` reverts.\\n *\\n * _Available since v3.1._\\n */\\n function functionCallWithValue(\\n address target,\\n bytes memory data,\\n uint256 value,\\n string memory errorMessage\\n ) internal returns (bytes memory) {\\n require(address(this).balance >= value, \\\"Address: insufficient balance for call\\\");\\n (bool success, bytes memory returndata) = target.call{value: value}(data);\\n return verifyCallResultFromTarget(target, success, returndata, errorMessage);\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\\n * but performing a static call.\\n *\\n * _Available since v3.3._\\n */\\n function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {\\n return functionStaticCall(target, data, \\\"Address: low-level static call failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],\\n * but performing a static call.\\n *\\n * _Available since v3.3._\\n */\\n function functionStaticCall(\\n address target,\\n bytes memory data,\\n string memory errorMessage\\n ) internal view returns (bytes memory) {\\n (bool success, bytes memory returndata) = target.staticcall(data);\\n return verifyCallResultFromTarget(target, success, returndata, errorMessage);\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\\n * but performing a delegate call.\\n *\\n * _Available since v3.4._\\n */\\n function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) {\\n return functionDelegateCall(target, data, \\\"Address: low-level delegate call failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],\\n * but performing a delegate call.\\n *\\n * _Available since v3.4._\\n */\\n function functionDelegateCall(\\n address target,\\n bytes memory data,\\n string memory errorMessage\\n ) internal returns (bytes memory) {\\n (bool success, bytes memory returndata) = target.delegatecall(data);\\n return verifyCallResultFromTarget(target, success, returndata, errorMessage);\\n }\\n\\n /**\\n * @dev Tool to verify that a low level call to smart-contract was successful, and revert (either by bubbling\\n * the revert reason or using the provided one) in case of unsuccessful call or if target was not a contract.\\n *\\n * _Available since v4.8._\\n */\\n function verifyCallResultFromTarget(\\n address target,\\n bool success,\\n bytes memory returndata,\\n string memory errorMessage\\n ) internal view returns (bytes memory) {\\n if (success) {\\n if (returndata.length == 0) {\\n // only check isContract if the call was successful and the return data is empty\\n // otherwise we already know that it was a contract\\n require(isContract(target), \\\"Address: call to non-contract\\\");\\n }\\n return returndata;\\n } else {\\n _revert(returndata, errorMessage);\\n }\\n }\\n\\n /**\\n * @dev Tool to verify that a low level call was successful, and revert if it wasn't, either by bubbling the\\n * revert reason or using the provided one.\\n *\\n * _Available since v4.3._\\n */\\n function verifyCallResult(\\n bool success,\\n bytes memory returndata,\\n string memory errorMessage\\n ) internal pure returns (bytes memory) {\\n if (success) {\\n return returndata;\\n } else {\\n _revert(returndata, errorMessage);\\n }\\n }\\n\\n function _revert(bytes memory returndata, string memory errorMessage) private pure {\\n // Look for revert reason and bubble it up if present\\n if (returndata.length > 0) {\\n // The easiest way to bubble the revert reason is using memory via assembly\\n /// @solidity memory-safe-assembly\\n assembly {\\n let returndata_size := mload(returndata)\\n revert(add(32, returndata), returndata_size)\\n }\\n } else {\\n revert(errorMessage);\\n }\\n }\\n}\\n\",\"keccak256\":\"0x006dd67219697fe68d7fbfdea512e7c4cb64a43565ed86171d67e844982da6fa\",\"license\":\"MIT\"},\"contracts/chain-adapters/CrossDomainEnabled.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity ^0.8.0;\\n\\n/* Interface Imports */\\nimport { ICrossDomainMessenger } from \\\"@eth-optimism/contracts/libraries/bridge/ICrossDomainMessenger.sol\\\";\\n\\n/**\\n * @title CrossDomainEnabled\\n * @custom:security-contact bugs@across.to\\n * @dev Helper contract for contracts performing cross-domain communications between L1 and Optimism.\\n * @dev This modifies the eth-optimism/CrossDomainEnabled contract only by changing state variables to be\\n * immutable for use in contracts like the Optimism_Adapter which use delegateCall().\\n */\\ncontract CrossDomainEnabled {\\n // Messenger contract used to send and recieve messages from the other domain.\\n address public immutable MESSENGER;\\n\\n /**\\n * @param _messenger Address of the CrossDomainMessenger on the current layer.\\n */\\n constructor(address _messenger) {\\n MESSENGER = _messenger;\\n }\\n\\n /**\\n * Gets the messenger, usually from storage. This function is exposed in case a child contract\\n * needs to override.\\n * @return The address of the cross-domain messenger contract which should be used.\\n */\\n function getCrossDomainMessenger() internal virtual returns (ICrossDomainMessenger) {\\n return ICrossDomainMessenger(MESSENGER);\\n }\\n\\n /**\\n * Sends a message to an account on another domain\\n * @param _crossDomainTarget The intended recipient on the destination domain\\n * @param _gasLimit The gasLimit for the receipt of the message on the target domain.\\n * @param _message The data to send to the target (usually calldata to a function with\\n * onlyFromCrossDomainAccount())\\n */\\n function sendCrossDomainMessage(\\n address _crossDomainTarget,\\n uint32 _gasLimit,\\n bytes calldata _message\\n ) internal {\\n // slither-disable-next-line reentrancy-events, reentrancy-benign\\n getCrossDomainMessenger().sendMessage(_crossDomainTarget, _message, _gasLimit);\\n }\\n}\\n\",\"keccak256\":\"0xb4705bab7468a6a7a6f3c635df73ca18215d5c78986dd336ab500fd75c63789f\",\"license\":\"MIT\"},\"contracts/chain-adapters/WorldChain_Adapter.sol\":{\"content\":\"// SPDX-License-Identifier: BUSL-1.1\\npragma solidity ^0.8.0;\\n\\nimport \\\"./interfaces/AdapterInterface.sol\\\";\\nimport \\\"../external/interfaces/WETH9Interface.sol\\\";\\n\\n// @dev Use local modified CrossDomainEnabled contract instead of one exported by eth-optimism because we need\\n// this contract's state variables to be `immutable` because of the delegateCall call.\\nimport \\\"./CrossDomainEnabled.sol\\\";\\nimport \\\"@eth-optimism/contracts/L1/messaging/IL1StandardBridge.sol\\\";\\n\\nimport \\\"@openzeppelin/contracts/token/ERC20/IERC20.sol\\\";\\nimport \\\"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\\\";\\n\\nimport \\\"../libraries/CircleCCTPAdapter.sol\\\";\\nimport \\\"../external/interfaces/CCTPInterfaces.sol\\\";\\n\\n/**\\n * @notice Contract containing logic to send messages from L1 to Doctor Who. This is a modified version of the Optimism adapter\\n * that excludes the custom bridging logic.\\n * @custom:security-contact bugs@across.to\\n * @dev Public functions calling external contracts do not guard against reentrancy because they are expected to be\\n * called via delegatecall, which will execute this contract's logic within the context of the originating contract.\\n * For example, the HubPool will delegatecall these functions, therefore its only necessary that the HubPool's methods\\n * that call this contract's logic guard against reentrancy.\\n */\\n\\n// solhint-disable-next-line contract-name-camelcase\\ncontract WorldChain_Adapter is CrossDomainEnabled, AdapterInterface, CircleCCTPAdapter {\\n using SafeERC20 for IERC20;\\n uint32 public constant L2_GAS_LIMIT = 200_000;\\n\\n WETH9Interface public immutable L1_WETH;\\n\\n IL1StandardBridge public immutable L1_STANDARD_BRIDGE;\\n\\n /**\\n * @notice Constructs new Adapter.\\n * @param _l1Weth WETH address on L1.\\n * @param _crossDomainMessenger XDomainMessenger Doctor Who system contract.\\n * @param _l1StandardBridge Standard bridge contract.\\n * @param _l1Usdc USDC address on L1.\\n * @param _cctpTokenMessenger TokenMessenger contract to bridge via CCTP.\\n */\\n constructor(\\n WETH9Interface _l1Weth,\\n address _crossDomainMessenger,\\n IL1StandardBridge _l1StandardBridge,\\n IERC20 _l1Usdc,\\n ITokenMessenger _cctpTokenMessenger\\n )\\n CrossDomainEnabled(_crossDomainMessenger)\\n CircleCCTPAdapter(_l1Usdc, _cctpTokenMessenger, CircleDomainIds.WorldChain)\\n {\\n L1_WETH = _l1Weth;\\n L1_STANDARD_BRIDGE = _l1StandardBridge;\\n }\\n\\n /**\\n * @notice Send cross-chain message to target on Doctor Who.\\n * @param target Contract on Doctor Who that will receive message.\\n * @param message Data to send to target.\\n */\\n function relayMessage(address target, bytes calldata message) external payable override {\\n sendCrossDomainMessage(target, L2_GAS_LIMIT, message);\\n emit MessageRelayed(target, message);\\n }\\n\\n /**\\n * @notice Bridge tokens to Doctor Who.\\n * @param l1Token L1 token to deposit.\\n * @param l2Token L2 token to receive.\\n * @param amount Amount of L1 tokens to deposit and L2 tokens to receive.\\n * @param to Bridge recipient.\\n */\\n function relayTokens(\\n address l1Token,\\n address l2Token,\\n uint256 amount,\\n address to\\n ) external payable override {\\n // If the l1Token is weth then unwrap it to ETH then send the ETH to the standard bridge.\\n if (l1Token == address(L1_WETH)) {\\n L1_WETH.withdraw(amount);\\n L1_STANDARD_BRIDGE.depositETHTo{ value: amount }(to, L2_GAS_LIMIT, \\\"\\\");\\n }\\n // Check if this token is USDC, which requires a custom bridge via CCTP.\\n else if (_isCCTPEnabled() && l1Token == address(usdcToken)) {\\n _transferUsdc(to, amount);\\n } else {\\n IL1StandardBridge _l1StandardBridge = L1_STANDARD_BRIDGE;\\n\\n IERC20(l1Token).safeIncreaseAllowance(address(_l1StandardBridge), amount);\\n _l1StandardBridge.depositERC20To(l1Token, l2Token, to, amount, L2_GAS_LIMIT, \\\"\\\");\\n }\\n emit TokensRelayed(l1Token, l2Token, amount, to);\\n }\\n}\\n\",\"keccak256\":\"0xb540e0410bbd00db5eca3e51d5af22cbeaeaca88dfc18da8e1667c2c5ee4e12d\",\"license\":\"BUSL-1.1\"},\"contracts/chain-adapters/interfaces/AdapterInterface.sol\":{\"content\":\"// SPDX-License-Identifier: BUSL-1.1\\npragma solidity ^0.8.0;\\n\\n/**\\n * @notice Sends cross chain messages and tokens to contracts on a specific L2 network.\\n * This interface is implemented by an adapter contract that is deployed on L1.\\n */\\n\\ninterface AdapterInterface {\\n event MessageRelayed(address target, bytes message);\\n\\n event TokensRelayed(address l1Token, address l2Token, uint256 amount, address to);\\n\\n /**\\n * @notice Send message to `target` on L2.\\n * @dev This method is marked payable because relaying the message might require a fee\\n * to be paid by the sender to forward the message to L2. However, it will not send msg.value\\n * to the target contract on L2.\\n * @param target L2 address to send message to.\\n * @param message Message to send to `target`.\\n */\\n function relayMessage(address target, bytes calldata message) external payable;\\n\\n /**\\n * @notice Send `amount` of `l1Token` to `to` on L2. `l2Token` is the L2 address equivalent of `l1Token`.\\n * @dev This method is marked payable because relaying the message might require a fee\\n * to be paid by the sender to forward the message to L2. However, it will not send msg.value\\n * to the target contract on L2.\\n * @param l1Token L1 token to bridge.\\n * @param l2Token L2 token to receive.\\n * @param amount Amount of `l1Token` to bridge.\\n * @param to Bridge recipient.\\n */\\n function relayTokens(\\n address l1Token,\\n address l2Token,\\n uint256 amount,\\n address to\\n ) external payable;\\n}\\n\",\"keccak256\":\"0x1d52fcb8b10dc7f260345918c1a90d496a4c9f774402cbd5ebde881b8fed6d50\",\"license\":\"BUSL-1.1\"},\"contracts/external/interfaces/CCTPInterfaces.sol\":{\"content\":\"/**\\n * Copyright (C) 2015, 2016, 2017 Dapphub\\n *\\n * This program is free software: you can redistribute it and/or modify\\n * it under the terms of the GNU General Public License as published by\\n * the Free Software Foundation, either version 3 of the License, or\\n * (at your option) any later version.\\n *\\n * This program is distributed in the hope that it will be useful,\\n * but WITHOUT ANY WARRANTY; without even the implied warranty of\\n * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the\\n * GNU General Public License for more details.\\n *\\n * You should have received a copy of the GNU General Public License\\n * along with this program. If not, see .\\n */\\n\\n// SPDX-License-Identifier: GPL-3.0-or-later\\npragma solidity ^0.8.0;\\n\\n/**\\n * Imported as-is from commit 139d8d0ce3b5531d3c7ec284f89d946dfb720016 of:\\n * * https://github.com/walkerq/evm-cctp-contracts/blob/139d8d0ce3b5531d3c7ec284f89d946dfb720016/src/TokenMessenger.sol\\n * Changes applied post-import:\\n * * Removed a majority of code from this contract and converted the needed function signatures in this interface.\\n */\\ninterface ITokenMessenger {\\n /**\\n * @notice Deposits and burns tokens from sender to be minted on destination domain.\\n * Emits a `DepositForBurn` event.\\n * @dev reverts if:\\n * - given burnToken is not supported\\n * - given destinationDomain has no TokenMessenger registered\\n * - transferFrom() reverts. For example, if sender's burnToken balance or approved allowance\\n * to this contract is less than `amount`.\\n * - burn() reverts. For example, if `amount` is 0.\\n * - MessageTransmitter returns false or reverts.\\n * @param amount amount of tokens to burn\\n * @param destinationDomain destination domain\\n * @param mintRecipient address of mint recipient on destination domain\\n * @param burnToken address of contract to burn deposited tokens, on local domain\\n * @return _nonce unique nonce reserved by message\\n */\\n function depositForBurn(\\n uint256 amount,\\n uint32 destinationDomain,\\n bytes32 mintRecipient,\\n address burnToken\\n ) external returns (uint64 _nonce);\\n\\n /**\\n * @notice Minter responsible for minting and burning tokens on the local domain\\n * @dev A TokenMessenger stores a TokenMinter contract which extends the TokenController contract.\\n * https://github.com/circlefin/evm-cctp-contracts/blob/817397db0a12963accc08ff86065491577bbc0e5/src/TokenMessenger.sol#L110\\n * @return minter Token Minter contract.\\n */\\n function localMinter() external view returns (ITokenMinter minter);\\n}\\n\\n// Source: https://github.com/circlefin/evm-cctp-contracts/blob/63ab1f0ac06ce0793c0bbfbb8d09816bc211386d/src/v2/TokenMessengerV2.sol#L138C1-L166C15\\ninterface ITokenMessengerV2 {\\n /**\\n * @notice Deposits and burns tokens from sender to be minted on destination domain.\\n * Emits a `DepositForBurn` event.\\n * @dev reverts if:\\n * - given burnToken is not supported\\n * - given destinationDomain has no TokenMessenger registered\\n * - transferFrom() reverts. For example, if sender's burnToken balance or approved allowance\\n * to this contract is less than `amount`.\\n * - burn() reverts. For example, if `amount` is 0.\\n * - maxFee is greater than or equal to `amount`.\\n * - MessageTransmitterV2#sendMessage reverts.\\n * @param amount amount of tokens to burn\\n * @param destinationDomain destination domain to receive message on\\n * @param mintRecipient address of mint recipient on destination domain\\n * @param burnToken token to burn `amount` of, on local domain\\n * @param destinationCaller authorized caller on the destination domain, as bytes32. If equal to bytes32(0),\\n * any address can broadcast the message.\\n * @param maxFee maximum fee to pay on the destination domain, specified in units of burnToken\\n * @param minFinalityThreshold the minimum finality at which a burn message will be attested to.\\n */\\n function depositForBurn(\\n uint256 amount,\\n uint32 destinationDomain,\\n bytes32 mintRecipient,\\n address burnToken,\\n bytes32 destinationCaller,\\n uint256 maxFee,\\n uint32 minFinalityThreshold\\n ) external;\\n}\\n\\n/**\\n * A TokenMessenger stores a TokenMinter contract which extends the TokenController contract. The TokenController\\n * contract has a burnLimitsPerMessage public mapping which can be queried to find the per-message burn limit\\n * for a given token:\\n * https://github.com/circlefin/evm-cctp-contracts/blob/817397db0a12963accc08ff86065491577bbc0e5/src/TokenMinter.sol#L33\\n * https://github.com/circlefin/evm-cctp-contracts/blob/817397db0a12963accc08ff86065491577bbc0e5/src/roles/TokenController.sol#L69C40-L69C60\\n *\\n */\\ninterface ITokenMinter {\\n /**\\n * @notice Supported burnable tokens on the local domain\\n * local token (address) => maximum burn amounts per message\\n * @param token address of token contract\\n * @return burnLimit maximum burn amount per message for token\\n */\\n function burnLimitsPerMessage(address token) external view returns (uint256);\\n}\\n\\n/**\\n * IMessageTransmitter in CCTP inherits IRelayer and IReceiver, but here we only import sendMessage from IRelayer:\\n * https://github.com/circlefin/evm-cctp-contracts/blob/377c9bd813fb86a42d900ae4003599d82aef635a/src/interfaces/IMessageTransmitter.sol#L25\\n * https://github.com/circlefin/evm-cctp-contracts/blob/377c9bd813fb86a42d900ae4003599d82aef635a/src/interfaces/IRelayer.sol#L23-L35\\n */\\ninterface IMessageTransmitter {\\n /**\\n * @notice Sends an outgoing message from the source domain.\\n * @dev Increment nonce, format the message, and emit `MessageSent` event with message information.\\n * @param destinationDomain Domain of destination chain\\n * @param recipient Address of message recipient on destination domain as bytes32\\n * @param messageBody Raw bytes content of message\\n * @return nonce reserved by message\\n */\\n function sendMessage(\\n uint32 destinationDomain,\\n bytes32 recipient,\\n bytes calldata messageBody\\n ) external returns (uint64);\\n}\\n\",\"keccak256\":\"0x69059bd91cdb9bea59242c543a167e38a9f3a7788687d4194f68420a956c7608\",\"license\":\"GPL-3.0-or-later\"},\"contracts/external/interfaces/WETH9Interface.sol\":{\"content\":\"// SPDX-License-Identifier: BUSL-1.1\\npragma solidity ^0.8.0;\\n\\n/**\\n * @notice Interface for the WETH9 contract.\\n */\\ninterface WETH9Interface {\\n /**\\n * @notice Burn Wrapped Ether and receive native Ether.\\n * @param wad Amount of WETH to unwrap and send to caller.\\n */\\n function withdraw(uint256 wad) external;\\n\\n /**\\n * @notice Lock native Ether and mint Wrapped Ether ERC20\\n * @dev msg.value is amount of Wrapped Ether to mint/Ether to lock.\\n */\\n function deposit() external payable;\\n\\n /**\\n * @notice Get balance of WETH held by `guy`.\\n * @param guy Address to get balance of.\\n * @return wad Amount of WETH held by `guy`.\\n */\\n function balanceOf(address guy) external view returns (uint256 wad);\\n\\n /**\\n * @notice Transfer `wad` of WETH from caller to `guy`.\\n * @param guy Address to send WETH to.\\n * @param wad Amount of WETH to send.\\n * @return ok True if transfer succeeded.\\n */\\n function transfer(address guy, uint256 wad) external returns (bool);\\n}\\n\",\"keccak256\":\"0x3f7892554ec7f54681fdd3cc18a41346c246c9c1afba016c52990ef77741f718\",\"license\":\"BUSL-1.1\"},\"contracts/libraries/AddressConverters.sol\":{\"content\":\"// SPDX-License-Identifier: BUSL-1.1\\npragma solidity ^0.8.0;\\n\\nlibrary Bytes32ToAddress {\\n /**************************************\\n * ERRORS *\\n **************************************/\\n error InvalidBytes32();\\n\\n function toAddress(bytes32 _bytes32) internal pure returns (address) {\\n checkAddress(_bytes32);\\n return address(uint160(uint256(_bytes32)));\\n }\\n\\n function toAddressUnchecked(bytes32 _bytes32) internal pure returns (address) {\\n return address(uint160(uint256(_bytes32)));\\n }\\n\\n function checkAddress(bytes32 _bytes32) internal pure {\\n if (uint256(_bytes32) >> 160 != 0) {\\n revert InvalidBytes32();\\n }\\n }\\n}\\n\\nlibrary AddressToBytes32 {\\n function toBytes32(address _address) internal pure returns (bytes32) {\\n return bytes32(uint256(uint160(_address)));\\n }\\n}\\n\",\"keccak256\":\"0x378f28bb4a17a5c47457cb9341086b2140f7faf6c048f702d3528166f0d74453\",\"license\":\"BUSL-1.1\"},\"contracts/libraries/CircleCCTPAdapter.sol\":{\"content\":\"// SPDX-License-Identifier: BUSL-1.1\\npragma solidity ^0.8.0;\\n\\nimport \\\"@openzeppelin/contracts/token/ERC20/IERC20.sol\\\";\\nimport \\\"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\\\";\\nimport \\\"../external/interfaces/CCTPInterfaces.sol\\\";\\nimport { AddressToBytes32 } from \\\"../libraries/AddressConverters.sol\\\";\\n\\nlibrary CircleDomainIds {\\n uint32 public constant Ethereum = 0;\\n uint32 public constant Optimism = 2;\\n uint32 public constant Arbitrum = 3;\\n uint32 public constant Solana = 5;\\n uint32 public constant Base = 6;\\n uint32 public constant Polygon = 7;\\n uint32 public constant DoctorWho = 10;\\n uint32 public constant Linea = 11;\\n uint32 public constant WorldChain = 14;\\n uint32 public constant UNINITIALIZED = type(uint32).max;\\n}\\n\\n/**\\n * @notice Facilitate bridging USDC via Circle's CCTP.\\n * @dev This contract is intended to be inherited by other chain-specific adapters and spoke pools.\\n * @custom:security-contact bugs@across.to\\n */\\nabstract contract CircleCCTPAdapter {\\n using SafeERC20 for IERC20;\\n using AddressToBytes32 for address;\\n /**\\n * @notice The domain ID that CCTP will transfer funds to.\\n * @dev This identifier is assigned by Circle and is not related to a chain ID.\\n * @dev Official domain list can be found here: https://developers.circle.com/stablecoins/docs/supported-domains\\n */\\n /// @custom:oz-upgrades-unsafe-allow state-variable-immutable\\n\\n uint32 public immutable recipientCircleDomainId;\\n\\n /**\\n * @notice The official USDC contract address on this chain.\\n * @dev Posted officially here: https://developers.circle.com/stablecoins/docs/usdc-on-main-networks\\n */\\n /// @custom:oz-upgrades-unsafe-allow state-variable-immutable\\n IERC20 public immutable usdcToken;\\n\\n /**\\n * @notice The official Circle CCTP token bridge contract endpoint.\\n * @dev Posted officially here: https://developers.circle.com/stablecoins/docs/evm-smart-contracts\\n */\\n /// @custom:oz-upgrades-unsafe-allow state-variable-immutable\\n ITokenMessenger public immutable cctpTokenMessenger;\\n\\n /**\\n * @notice Indicates if the CCTP V2 TokenMessenger is being used.\\n * @dev This is determined by checking if the feeRecipient() function exists and returns a non-zero address.\\n */\\n /// @custom:oz-upgrades-unsafe-allow state-variable-immutable\\n bool public immutable cctpV2;\\n\\n /**\\n * @notice intiailizes the CircleCCTPAdapter contract.\\n * @param _usdcToken USDC address on the current chain.\\n * @param _cctpTokenMessenger TokenMessenger contract to bridge via CCTP. If the zero address is passed, CCTP bridging will be disabled.\\n * @param _recipientCircleDomainId The domain ID that CCTP will transfer funds to.\\n */\\n /// @custom:oz-upgrades-unsafe-allow constructor\\n constructor(\\n IERC20 _usdcToken,\\n /// @dev This should ideally be an address but it's kept as an ITokenMessenger to avoid rippling changes to the\\n /// constructors for every SpokePool/Adapter.\\n ITokenMessenger _cctpTokenMessenger,\\n uint32 _recipientCircleDomainId\\n ) {\\n usdcToken = _usdcToken;\\n cctpTokenMessenger = _cctpTokenMessenger;\\n recipientCircleDomainId = _recipientCircleDomainId;\\n\\n // Only the CCTP V2 TokenMessenger has a feeRecipient() function, so we use it to\\n // figure out if we are using CCTP V2 or V1. `success` can be true even if the contract doesn't\\n // implement feeRecipient but it has a fallback function so to be extra safe, we check the return value\\n // of feeRecipient() as well.\\n (bool success, bytes memory feeRecipient) = address(cctpTokenMessenger).staticcall(\\n abi.encodeWithSignature(\\\"feeRecipient()\\\")\\n );\\n // In case of a call to nonexistent contract or a call to a contract with a fallback function which\\n // doesn't return any data, feeRecipient can be empty so check its length.\\n // Even with this check, it's possible that the contract has implemented a fallback function that returns\\n // 32 bytes of data but its not actually the feeRecipient address. This is extremely low risk but worth\\n // mentioning that the following check is not 100% safe.\\n cctpV2 = (success &&\\n feeRecipient.length == 32 &&\\n address(uint160(uint256(bytes32(feeRecipient)))) != address(0));\\n }\\n\\n /**\\n * @notice Returns whether or not the CCTP bridge is enabled.\\n * @dev If the CCTPTokenMessenger is the zero address, CCTP bridging is disabled.\\n */\\n function _isCCTPEnabled() internal view returns (bool) {\\n return address(cctpTokenMessenger) != address(0);\\n }\\n\\n /**\\n * @notice Transfers USDC from the current domain to the given address on the new domain.\\n * @dev This function will revert if the CCTP bridge is disabled. I.e. if the zero address is passed to the constructor for the cctpTokenMessenger.\\n * @param to Address to receive USDC on the new domain.\\n * @param amount Amount of USDC to transfer.\\n */\\n function _transferUsdc(address to, uint256 amount) internal {\\n _transferUsdc(to.toBytes32(), amount);\\n }\\n\\n /**\\n * @notice Transfers USDC from the current domain to the given address on the new domain.\\n * @dev This function will revert if the CCTP bridge is disabled. I.e. if the zero address is passed to the constructor for the cctpTokenMessenger.\\n * @param to Address to receive USDC on the new domain represented as bytes32.\\n * @param amount Amount of USDC to transfer.\\n */\\n function _transferUsdc(bytes32 to, uint256 amount) internal {\\n // Only approve the exact amount to be transferred\\n usdcToken.safeIncreaseAllowance(address(cctpTokenMessenger), amount);\\n // Submit the amount to be transferred to bridge via the TokenMessenger.\\n // If the amount to send exceeds the burn limit per message, then split the message into smaller parts.\\n // @dev We do not care about casting cctpTokenMessenger to ITokenMessengerV2 since both V1 and V2\\n // expose a localMinter() view function that returns either an ITokenMinterV1 or ITokenMinterV2. Regardless,\\n // we only care about the burnLimitsPerMessage function which is available in both versions and performs\\n // the same logic, therefore we purposefully do not re-cast the cctpTokenMessenger and cctpMinter\\n // to the specific version.\\n ITokenMinter cctpMinter = cctpTokenMessenger.localMinter();\\n uint256 burnLimit = cctpMinter.burnLimitsPerMessage(address(usdcToken));\\n uint256 remainingAmount = amount;\\n while (remainingAmount > 0) {\\n uint256 partAmount = remainingAmount > burnLimit ? burnLimit : remainingAmount;\\n if (cctpV2) {\\n // Uses the CCTP V2 \\\"standard transfer\\\" speed and\\n // therefore pays no additional fee for the transfer to be sped up.\\n ITokenMessengerV2(address(cctpTokenMessenger)).depositForBurn(\\n partAmount,\\n recipientCircleDomainId,\\n to,\\n address(usdcToken),\\n // The following parameters are new in this function from V2 to V1, can read more here:\\n // https://developers.circle.com/stablecoins/evm-smart-contracts\\n bytes32(0), // destinationCaller is set to bytes32(0) to indicate that anyone can call\\n // receiveMessage on the destination to finalize the transfer\\n 0, // maxFee can be set to 0 for a \\\"standard transfer\\\"\\n 2000 // minFinalityThreshold can be set to 2000 for a \\\"standard transfer\\\",\\n // https://github.com/circlefin/evm-cctp-contracts/blob/63ab1f0ac06ce0793c0bbfbb8d09816bc211386d/src/v2/FinalityThresholds.sol#L21\\n );\\n } else {\\n cctpTokenMessenger.depositForBurn(partAmount, recipientCircleDomainId, to, address(usdcToken));\\n }\\n remainingAmount -= partAmount;\\n }\\n }\\n}\\n\",\"keccak256\":\"0x1798b17c205de3c414d4f5fc81cded9e52a1f39a936ba43154d48f1b30c84ac9\",\"license\":\"BUSL-1.1\"}},\"version\":1}",
+ "bytecode": "0x61016060409080825234620002345760a081620012d9803803809162000026828562000238565b833981010312620002345780516001600160a01b039290919083831683036200023457602093848301518181168103620002345782840151938285168503620002345760608101519083821682036200023457608001519083821692838303620002345760805260c05260e052600e60a052825163011a412160e61b878201908152600482526001600160401b0392828601918483118484101762000216575f938493885251915afa953d156200022a573d9182116200021657835191620000f8601f8201601f191683018462000238565b82523d5f8284013e5b866200020a575b86620001d5575b505050610100938452610120928352610140918252519161107c93846200025d853960805184818161011401526102c9015260a051848181610383015281816107bc01526108c5015260c0518481816105fd01528181610b3c0152610c89015260e05184818161025a015281816105ce015281816106250152818161067b015281816107620152818161080e0152610904015251838181610323015261073b0152518281816104480152610c1d0152518181816104c101528181610a170152610baf0152f35b909192955080825192015191818110620001f9575b5050161515925f80806200010f565b5f19910360031b1b165f80620001ea565b81518114965062000108565b634e487b7160e01b5f52604160045260245ffd5b6060915062000101565b5f80fd5b601f909101601f19168101906001600160401b03821190821017620002165760405256fe6080806040526004361015610012575f80fd5b5f905f3560e01c90816311eac85514610c41575080631efd482a14610bd357806335a2db6a14610b6557806352c8c75c146103e35780635e743ef7146103a75780636e40098314610348578063775c0d03146102ed578063927ede2d1461027e5780639748cf7c1461020f5763e6eb8ade1461008c575f80fd5b60407ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffc36011261020c576100be610cad565b6024359067ffffffffffffffff908183116101f957366023840112156101f95782600401359182116101f957602483019260248336920101116101f9578373ffffffffffffffffffffffffffffffffffffffff807f00000000000000000000000000000000000000000000000000000000000000001692833b156102085782906040519283917f3dbb202b000000000000000000000000000000000000000000000000000000008352169485600483015260606024830152818381610187606482018b8d610d52565b62030d40604483015203925af180156101fd576101e5575b50506101df7f9e6c52944e331ba6270e7fe4cea2a4086bae8f7a27e1cdba07f416806f5d0ac4936040519384938452604060208501526040840191610d52565b0390a180f35b6101ee90610cd0565b6101f957835f61019f565b8380fd5b6040513d84823e3d90fd5b8280fd5b80fd5b503461020c57807ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffc36011261020c57602060405173ffffffffffffffffffffffffffffffffffffffff7f0000000000000000000000000000000000000000000000000000000000000000168152f35b503461020c57807ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffc36011261020c57602060405173ffffffffffffffffffffffffffffffffffffffff7f0000000000000000000000000000000000000000000000000000000000000000168152f35b503461020c57807ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffc36011261020c5760206040517f000000000000000000000000000000000000000000000000000000000000000015158152f35b503461020c57807ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffc36011261020c57602060405163ffffffff7f0000000000000000000000000000000000000000000000000000000000000000168152f35b503461020c57807ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffc36011261020c57602060405162030d408152f35b5060807ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffc3601126109b857610416610cad565b6024359073ffffffffffffffffffffffffffffffffffffffff80831683036109b8576064359281841684036109b857847f0000000000000000000000000000000000000000000000000000000000000000831684841681036105c657803b156105ae578180916024604051809481937f2e1a7d4d00000000000000000000000000000000000000000000000000000000835260443560048401525af180156101fd576105b2575b50827f000000000000000000000000000000000000000000000000000000000000000016803b156105ae5781608491604051928380927f9a2ac6d5000000000000000000000000000000000000000000000000000000008252888b16600483015262030d40602483015260606044830152846064830152604435905af180156101fd57610590575b5050907fd7e09655439c3932e55857df3220186e5a7f0980825f20691c2b35d941dee75b9381608094935b81604051951685521660208401526044356040840152166060820152a180f35b61059d9094939294610cd0565b6105aa579091845f610545565b8480fd5b5080fd5b6105bb90610cd0565b6105aa57845f6104bd565b5050819293917f000000000000000000000000000000000000000000000000000000000000000016151580610b38575b15610a14577f000000000000000000000000000000000000000000000000000000000000000061064b604435857f00000000000000000000000000000000000000000000000000000000000000001683610d90565b604051907fcb75c11c000000000000000000000000000000000000000000000000000000008252602082600481887f0000000000000000000000000000000000000000000000000000000000000000165afa80156109c457859288916109cf575b506020906024604051809581937fa56ec6320000000000000000000000000000000000000000000000000000000083528187166004840152165afa9182156109c457879261098c575b50604435805b61072f57505050917fd7e09655439c3932e55857df3220186e5a7f0980825f20691c2b35d941dee75b939181608094610570565b8281111561098657825b7f00000000000000000000000000000000000000000000000000000000000000001561089257867f0000000000000000000000000000000000000000000000000000000000000000163b1561088e57886040517f8e0250ee00000000000000000000000000000000000000000000000000000000815282600482015263ffffffff7f0000000000000000000000000000000000000000000000000000000000000000166024820152888816604482015288851660648201528160848201528160a48201526107d060c4820152818160e481838d7f0000000000000000000000000000000000000000000000000000000000000000165af180156101fd5761087a575b50505b810390811161084d57806106fb565b6024887f4e487b710000000000000000000000000000000000000000000000000000000081526011600452fd5b61088390610cd0565b61088e57885f61083b565b8880fd5b6040517f6fd3504e00000000000000000000000000000000000000000000000000000000815281600482015263ffffffff7f0000000000000000000000000000000000000000000000000000000000000000166024820152878716604482015287841660648201526020816084818d8c7f0000000000000000000000000000000000000000000000000000000000000000165af1801561097b57610937575b5061083e565b6020813d602011610973575b8161095060209383610d11565b8101031261096f575167ffffffffffffffff81160361088e575f610931565b8980fd5b3d9150610943565b6040513d8c823e3d90fd5b80610739565b9091506020813d6020116109bc575b816109a860209383610d11565b810103126109b85751905f6106f5565b5f80fd5b3d915061099b565b6040513d89823e3d90fd5b919250506020813d602011610a0c575b816109ec60209383610d11565b81010312610a085751908482168203610a0857849160206106ac565b8680fd5b3d91506109df565b827f000000000000000000000000000000000000000000000000000000000000000016610a4660443582868816610d90565b803b156109b8575f809160e4604051809481937f838b2520000000000000000000000000000000000000000000000000000000008352898b16600484015289881660248401528989166044840152604435606484015262030d40608484015260c060a48401528160c48401525af18015610b2d57610aed575b50917fd7e09655439c3932e55857df3220186e5a7f0980825f20691c2b35d941dee75b939181608094610570565b60809391955091610b1f7fd7e09655439c3932e55857df3220186e5a7f0980825f20691c2b35d941dee75b9593610cd0565b815f96925093509193610abf565b6040513d5f823e3d90fd5b50827f000000000000000000000000000000000000000000000000000000000000000016838516146105f6565b346109b8575f7ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffc3601126109b857602060405173ffffffffffffffffffffffffffffffffffffffff7f0000000000000000000000000000000000000000000000000000000000000000168152f35b346109b8575f7ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffc3601126109b857602060405173ffffffffffffffffffffffffffffffffffffffff7f0000000000000000000000000000000000000000000000000000000000000000168152f35b346109b8575f7ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffc3601126109b85760209073ffffffffffffffffffffffffffffffffffffffff7f0000000000000000000000000000000000000000000000000000000000000000168152f35b6004359073ffffffffffffffffffffffffffffffffffffffff821682036109b857565b67ffffffffffffffff8111610ce457604052565b7f4e487b71000000000000000000000000000000000000000000000000000000005f52604160045260245ffd5b90601f7fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe0910116810190811067ffffffffffffffff821117610ce457604052565b601f82602094937fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe093818652868601375f8582860101520116010190565b9291909273ffffffffffffffffffffffffffffffffffffffff809116604051917fdd62ed3e000000000000000000000000000000000000000000000000000000008352306004840152602495169182868201526020938482604481865afa918215610b2d575f92610fee575b508101809111610fc25760405190848201937f095ea7b3000000000000000000000000000000000000000000000000000000008552878301526044820152604481526080810167ffffffffffffffff9382821085831117610f965760c083019282841086851117610f6a57865f94938594604052527f5361666545524332303a206c6f772d6c6576656c2063616c6c206661696c656460a0820152519082855af1903d15610f59573d928311610f2d57610ef59394955060405192610ee8867fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe0601f8401160185610d11565b83523d5f8685013e61101d565b8051918215918215610f0d575b50509050156109b857565b8092508193810103126109b857015180151581036109b857805f80610f02565b857f4e487b71000000000000000000000000000000000000000000000000000000005f5260416004525ffd5b9150610ef59293945060609161101d565b887f4e487b71000000000000000000000000000000000000000000000000000000005f5260416004525ffd5b877f4e487b71000000000000000000000000000000000000000000000000000000005f5260416004525ffd5b857f4e487b71000000000000000000000000000000000000000000000000000000005f5260116004525ffd5b9091508481813d8311611016575b6110068183610d11565b810103126109b85751905f610dfc565b503d610ffc565b90156110375781511561102e575090565b3b156109b85790565b5080519081156109b857602001fdfea26469706673582212205169ea9c27d7ec34300ba04b9ac84f01797bd0d394c238dc623de9c35d11e57c64736f6c63430008170033",
+ "deployedBytecode": "0x6080806040526004361015610012575f80fd5b5f905f3560e01c90816311eac85514610c41575080631efd482a14610bd357806335a2db6a14610b6557806352c8c75c146103e35780635e743ef7146103a75780636e40098314610348578063775c0d03146102ed578063927ede2d1461027e5780639748cf7c1461020f5763e6eb8ade1461008c575f80fd5b60407ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffc36011261020c576100be610cad565b6024359067ffffffffffffffff908183116101f957366023840112156101f95782600401359182116101f957602483019260248336920101116101f9578373ffffffffffffffffffffffffffffffffffffffff807f00000000000000000000000000000000000000000000000000000000000000001692833b156102085782906040519283917f3dbb202b000000000000000000000000000000000000000000000000000000008352169485600483015260606024830152818381610187606482018b8d610d52565b62030d40604483015203925af180156101fd576101e5575b50506101df7f9e6c52944e331ba6270e7fe4cea2a4086bae8f7a27e1cdba07f416806f5d0ac4936040519384938452604060208501526040840191610d52565b0390a180f35b6101ee90610cd0565b6101f957835f61019f565b8380fd5b6040513d84823e3d90fd5b8280fd5b80fd5b503461020c57807ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffc36011261020c57602060405173ffffffffffffffffffffffffffffffffffffffff7f0000000000000000000000000000000000000000000000000000000000000000168152f35b503461020c57807ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffc36011261020c57602060405173ffffffffffffffffffffffffffffffffffffffff7f0000000000000000000000000000000000000000000000000000000000000000168152f35b503461020c57807ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffc36011261020c5760206040517f000000000000000000000000000000000000000000000000000000000000000015158152f35b503461020c57807ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffc36011261020c57602060405163ffffffff7f0000000000000000000000000000000000000000000000000000000000000000168152f35b503461020c57807ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffc36011261020c57602060405162030d408152f35b5060807ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffc3601126109b857610416610cad565b6024359073ffffffffffffffffffffffffffffffffffffffff80831683036109b8576064359281841684036109b857847f0000000000000000000000000000000000000000000000000000000000000000831684841681036105c657803b156105ae578180916024604051809481937f2e1a7d4d00000000000000000000000000000000000000000000000000000000835260443560048401525af180156101fd576105b2575b50827f000000000000000000000000000000000000000000000000000000000000000016803b156105ae5781608491604051928380927f9a2ac6d5000000000000000000000000000000000000000000000000000000008252888b16600483015262030d40602483015260606044830152846064830152604435905af180156101fd57610590575b5050907fd7e09655439c3932e55857df3220186e5a7f0980825f20691c2b35d941dee75b9381608094935b81604051951685521660208401526044356040840152166060820152a180f35b61059d9094939294610cd0565b6105aa579091845f610545565b8480fd5b5080fd5b6105bb90610cd0565b6105aa57845f6104bd565b5050819293917f000000000000000000000000000000000000000000000000000000000000000016151580610b38575b15610a14577f000000000000000000000000000000000000000000000000000000000000000061064b604435857f00000000000000000000000000000000000000000000000000000000000000001683610d90565b604051907fcb75c11c000000000000000000000000000000000000000000000000000000008252602082600481887f0000000000000000000000000000000000000000000000000000000000000000165afa80156109c457859288916109cf575b506020906024604051809581937fa56ec6320000000000000000000000000000000000000000000000000000000083528187166004840152165afa9182156109c457879261098c575b50604435805b61072f57505050917fd7e09655439c3932e55857df3220186e5a7f0980825f20691c2b35d941dee75b939181608094610570565b8281111561098657825b7f00000000000000000000000000000000000000000000000000000000000000001561089257867f0000000000000000000000000000000000000000000000000000000000000000163b1561088e57886040517f8e0250ee00000000000000000000000000000000000000000000000000000000815282600482015263ffffffff7f0000000000000000000000000000000000000000000000000000000000000000166024820152888816604482015288851660648201528160848201528160a48201526107d060c4820152818160e481838d7f0000000000000000000000000000000000000000000000000000000000000000165af180156101fd5761087a575b50505b810390811161084d57806106fb565b6024887f4e487b710000000000000000000000000000000000000000000000000000000081526011600452fd5b61088390610cd0565b61088e57885f61083b565b8880fd5b6040517f6fd3504e00000000000000000000000000000000000000000000000000000000815281600482015263ffffffff7f0000000000000000000000000000000000000000000000000000000000000000166024820152878716604482015287841660648201526020816084818d8c7f0000000000000000000000000000000000000000000000000000000000000000165af1801561097b57610937575b5061083e565b6020813d602011610973575b8161095060209383610d11565b8101031261096f575167ffffffffffffffff81160361088e575f610931565b8980fd5b3d9150610943565b6040513d8c823e3d90fd5b80610739565b9091506020813d6020116109bc575b816109a860209383610d11565b810103126109b85751905f6106f5565b5f80fd5b3d915061099b565b6040513d89823e3d90fd5b919250506020813d602011610a0c575b816109ec60209383610d11565b81010312610a085751908482168203610a0857849160206106ac565b8680fd5b3d91506109df565b827f000000000000000000000000000000000000000000000000000000000000000016610a4660443582868816610d90565b803b156109b8575f809160e4604051809481937f838b2520000000000000000000000000000000000000000000000000000000008352898b16600484015289881660248401528989166044840152604435606484015262030d40608484015260c060a48401528160c48401525af18015610b2d57610aed575b50917fd7e09655439c3932e55857df3220186e5a7f0980825f20691c2b35d941dee75b939181608094610570565b60809391955091610b1f7fd7e09655439c3932e55857df3220186e5a7f0980825f20691c2b35d941dee75b9593610cd0565b815f96925093509193610abf565b6040513d5f823e3d90fd5b50827f000000000000000000000000000000000000000000000000000000000000000016838516146105f6565b346109b8575f7ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffc3601126109b857602060405173ffffffffffffffffffffffffffffffffffffffff7f0000000000000000000000000000000000000000000000000000000000000000168152f35b346109b8575f7ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffc3601126109b857602060405173ffffffffffffffffffffffffffffffffffffffff7f0000000000000000000000000000000000000000000000000000000000000000168152f35b346109b8575f7ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffc3601126109b85760209073ffffffffffffffffffffffffffffffffffffffff7f0000000000000000000000000000000000000000000000000000000000000000168152f35b6004359073ffffffffffffffffffffffffffffffffffffffff821682036109b857565b67ffffffffffffffff8111610ce457604052565b7f4e487b71000000000000000000000000000000000000000000000000000000005f52604160045260245ffd5b90601f7fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe0910116810190811067ffffffffffffffff821117610ce457604052565b601f82602094937fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe093818652868601375f8582860101520116010190565b9291909273ffffffffffffffffffffffffffffffffffffffff809116604051917fdd62ed3e000000000000000000000000000000000000000000000000000000008352306004840152602495169182868201526020938482604481865afa918215610b2d575f92610fee575b508101809111610fc25760405190848201937f095ea7b3000000000000000000000000000000000000000000000000000000008552878301526044820152604481526080810167ffffffffffffffff9382821085831117610f965760c083019282841086851117610f6a57865f94938594604052527f5361666545524332303a206c6f772d6c6576656c2063616c6c206661696c656460a0820152519082855af1903d15610f59573d928311610f2d57610ef59394955060405192610ee8867fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe0601f8401160185610d11565b83523d5f8685013e61101d565b8051918215918215610f0d575b50509050156109b857565b8092508193810103126109b857015180151581036109b857805f80610f02565b857f4e487b71000000000000000000000000000000000000000000000000000000005f5260416004525ffd5b9150610ef59293945060609161101d565b887f4e487b71000000000000000000000000000000000000000000000000000000005f5260416004525ffd5b877f4e487b71000000000000000000000000000000000000000000000000000000005f5260416004525ffd5b857f4e487b71000000000000000000000000000000000000000000000000000000005f5260116004525ffd5b9091508481813d8311611016575b6110068183610d11565b810103126109b85751905f610dfc565b503d610ffc565b90156110375781511561102e575090565b3b156109b85790565b5080519081156109b857602001fdfea26469706673582212205169ea9c27d7ec34300ba04b9ac84f01797bd0d394c238dc623de9c35d11e57c64736f6c63430008170033",
"devdoc": {
"custom:security-contact": "bugs@across.to",
"details": "Public functions calling external contracts do not guard against reentrancy because they are expected to be called via delegatecall, which will execute this contract's logic within the context of the originating contract. For example, the HubPool will delegatecall these functions, therefore its only necessary that the HubPool's methods that call this contract's logic guard against reentrancy.",
@@ -249,7 +268,8 @@
"methods": {
"constructor": {
"params": {
- "_crossDomainMessenger": "XDomainMessenger World Chain system contract.",
+ "_cctpTokenMessenger": "TokenMessenger contract to bridge via CCTP.",
+ "_crossDomainMessenger": "XDomainMessenger Doctor Who system contract.",
"_l1StandardBridge": "Standard bridge contract.",
"_l1Usdc": "USDC address on L1.",
"_l1Weth": "WETH address on L1."
@@ -258,7 +278,7 @@
"relayMessage(address,bytes)": {
"params": {
"message": "Data to send to target.",
- "target": "Contract on World Chain that will receive message."
+ "target": "Contract on Doctor Who that will receive message."
}
},
"relayTokens(address,address,uint256,address)": {
@@ -279,13 +299,13 @@
"notice": "Constructs new Adapter."
},
"relayMessage(address,bytes)": {
- "notice": "Send cross-chain message to target on World Chain."
+ "notice": "Send cross-chain message to target on Doctor Who."
},
"relayTokens(address,address,uint256,address)": {
- "notice": "Bridge tokens to World Chain."
+ "notice": "Bridge tokens to Doctor Who."
}
},
- "notice": "Contract containing logic to send messages from L1 to World Chain. This is a clone of the Base/Mode adapter",
+ "notice": "Contract containing logic to send messages from L1 to Doctor Who. This is a modified version of the Optimism adapter that excludes the custom bridging logic.",
"version": 1
},
"storageLayout": {
diff --git a/deployments/mainnet/solcInputs/dc324d2c58d7b0ed46f2033874127662.json b/deployments/mainnet/solcInputs/dc324d2c58d7b0ed46f2033874127662.json
new file mode 100644
index 000000000..5b08322f8
--- /dev/null
+++ b/deployments/mainnet/solcInputs/dc324d2c58d7b0ed46f2033874127662.json
@@ -0,0 +1,316 @@
+{
+ "language": "Solidity",
+ "sources": {
+ "@eth-optimism/contracts/L1/messaging/IL1ERC20Bridge.sol": {
+ "content": "// SPDX-License-Identifier: MIT\npragma solidity >0.5.0 <0.9.0;\n\n/**\n * @title IL1ERC20Bridge\n */\ninterface IL1ERC20Bridge {\n /**********\n * Events *\n **********/\n\n event ERC20DepositInitiated(\n address indexed _l1Token,\n address indexed _l2Token,\n address indexed _from,\n address _to,\n uint256 _amount,\n bytes _data\n );\n\n event ERC20WithdrawalFinalized(\n address indexed _l1Token,\n address indexed _l2Token,\n address indexed _from,\n address _to,\n uint256 _amount,\n bytes _data\n );\n\n /********************\n * Public Functions *\n ********************/\n\n /**\n * @dev get the address of the corresponding L2 bridge contract.\n * @return Address of the corresponding L2 bridge contract.\n */\n function l2TokenBridge() external returns (address);\n\n /**\n * @dev deposit an amount of the ERC20 to the caller's balance on L2.\n * @param _l1Token Address of the L1 ERC20 we are depositing\n * @param _l2Token Address of the L1 respective L2 ERC20\n * @param _amount Amount of the ERC20 to deposit\n * @param _l2Gas Gas limit required to complete the deposit on L2.\n * @param _data Optional data to forward to L2. This data is provided\n * solely as a convenience for external contracts. Aside from enforcing a maximum\n * length, these contracts provide no guarantees about its content.\n */\n function depositERC20(\n address _l1Token,\n address _l2Token,\n uint256 _amount,\n uint32 _l2Gas,\n bytes calldata _data\n ) external;\n\n /**\n * @dev deposit an amount of ERC20 to a recipient's balance on L2.\n * @param _l1Token Address of the L1 ERC20 we are depositing\n * @param _l2Token Address of the L1 respective L2 ERC20\n * @param _to L2 address to credit the withdrawal to.\n * @param _amount Amount of the ERC20 to deposit.\n * @param _l2Gas Gas limit required to complete the deposit on L2.\n * @param _data Optional data to forward to L2. This data is provided\n * solely as a convenience for external contracts. Aside from enforcing a maximum\n * length, these contracts provide no guarantees about its content.\n */\n function depositERC20To(\n address _l1Token,\n address _l2Token,\n address _to,\n uint256 _amount,\n uint32 _l2Gas,\n bytes calldata _data\n ) external;\n\n /*************************\n * Cross-chain Functions *\n *************************/\n\n /**\n * @dev Complete a withdrawal from L2 to L1, and credit funds to the recipient's balance of the\n * L1 ERC20 token.\n * This call will fail if the initialized withdrawal from L2 has not been finalized.\n *\n * @param _l1Token Address of L1 token to finalizeWithdrawal for.\n * @param _l2Token Address of L2 token where withdrawal was initiated.\n * @param _from L2 address initiating the transfer.\n * @param _to L1 address to credit the withdrawal to.\n * @param _amount Amount of the ERC20 to deposit.\n * @param _data Data provided by the sender on L2. This data is provided\n * solely as a convenience for external contracts. Aside from enforcing a maximum\n * length, these contracts provide no guarantees about its content.\n */\n function finalizeERC20Withdrawal(\n address _l1Token,\n address _l2Token,\n address _from,\n address _to,\n uint256 _amount,\n bytes calldata _data\n ) external;\n}\n"
+ },
+ "@eth-optimism/contracts/L1/messaging/IL1StandardBridge.sol": {
+ "content": "// SPDX-License-Identifier: MIT\npragma solidity >0.5.0 <0.9.0;\n\nimport \"./IL1ERC20Bridge.sol\";\n\n/**\n * @title IL1StandardBridge\n */\ninterface IL1StandardBridge is IL1ERC20Bridge {\n /**********\n * Events *\n **********/\n event ETHDepositInitiated(\n address indexed _from,\n address indexed _to,\n uint256 _amount,\n bytes _data\n );\n\n event ETHWithdrawalFinalized(\n address indexed _from,\n address indexed _to,\n uint256 _amount,\n bytes _data\n );\n\n /********************\n * Public Functions *\n ********************/\n\n /**\n * @dev Deposit an amount of the ETH to the caller's balance on L2.\n * @param _l2Gas Gas limit required to complete the deposit on L2.\n * @param _data Optional data to forward to L2. This data is provided\n * solely as a convenience for external contracts. Aside from enforcing a maximum\n * length, these contracts provide no guarantees about its content.\n */\n function depositETH(uint32 _l2Gas, bytes calldata _data) external payable;\n\n /**\n * @dev Deposit an amount of ETH to a recipient's balance on L2.\n * @param _to L2 address to credit the withdrawal to.\n * @param _l2Gas Gas limit required to complete the deposit on L2.\n * @param _data Optional data to forward to L2. This data is provided\n * solely as a convenience for external contracts. Aside from enforcing a maximum\n * length, these contracts provide no guarantees about its content.\n */\n function depositETHTo(\n address _to,\n uint32 _l2Gas,\n bytes calldata _data\n ) external payable;\n\n /*************************\n * Cross-chain Functions *\n *************************/\n\n /**\n * @dev Complete a withdrawal from L2 to L1, and credit funds to the recipient's balance of the\n * L1 ETH token. Since only the xDomainMessenger can call this function, it will never be called\n * before the withdrawal is finalized.\n * @param _from L2 address initiating the transfer.\n * @param _to L1 address to credit the withdrawal to.\n * @param _amount Amount of the ERC20 to deposit.\n * @param _data Optional data to forward to L2. This data is provided\n * solely as a convenience for external contracts. Aside from enforcing a maximum\n * length, these contracts provide no guarantees about its content.\n */\n function finalizeETHWithdrawal(\n address _from,\n address _to,\n uint256 _amount,\n bytes calldata _data\n ) external;\n}\n"
+ },
+ "@eth-optimism/contracts/libraries/bridge/ICrossDomainMessenger.sol": {
+ "content": "// SPDX-License-Identifier: MIT\npragma solidity >0.5.0 <0.9.0;\n\n/**\n * @title ICrossDomainMessenger\n */\ninterface ICrossDomainMessenger {\n /**********\n * Events *\n **********/\n\n event SentMessage(\n address indexed target,\n address sender,\n bytes message,\n uint256 messageNonce,\n uint256 gasLimit\n );\n event RelayedMessage(bytes32 indexed msgHash);\n event FailedRelayedMessage(bytes32 indexed msgHash);\n\n /*************\n * Variables *\n *************/\n\n function xDomainMessageSender() external view returns (address);\n\n /********************\n * Public Functions *\n ********************/\n\n /**\n * Sends a cross domain message to the target messenger.\n * @param _target Target contract address.\n * @param _message Message to send to the target.\n * @param _gasLimit Gas limit for the provided message.\n */\n function sendMessage(\n address _target,\n bytes calldata _message,\n uint32 _gasLimit\n ) external;\n}\n"
+ },
+ "@eth-optimism/contracts/libraries/constants/Lib_PredeployAddresses.sol": {
+ "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.9;\n\n/**\n * @title Lib_PredeployAddresses\n */\nlibrary Lib_PredeployAddresses {\n address internal constant L2_TO_L1_MESSAGE_PASSER = 0x4200000000000000000000000000000000000000;\n address internal constant L1_MESSAGE_SENDER = 0x4200000000000000000000000000000000000001;\n address internal constant DEPLOYER_WHITELIST = 0x4200000000000000000000000000000000000002;\n address payable internal constant OVM_ETH = payable(0xDeadDeAddeAddEAddeadDEaDDEAdDeaDDeAD0000);\n address internal constant L2_CROSS_DOMAIN_MESSENGER =\n 0x4200000000000000000000000000000000000007;\n address internal constant LIB_ADDRESS_MANAGER = 0x4200000000000000000000000000000000000008;\n address internal constant PROXY_EOA = 0x4200000000000000000000000000000000000009;\n address internal constant L2_STANDARD_BRIDGE = 0x4200000000000000000000000000000000000010;\n address internal constant SEQUENCER_FEE_WALLET = 0x4200000000000000000000000000000000000011;\n address internal constant L2_STANDARD_TOKEN_FACTORY =\n 0x4200000000000000000000000000000000000012;\n address internal constant L1_BLOCK_NUMBER = 0x4200000000000000000000000000000000000013;\n}\n"
+ },
+ "@openzeppelin/contracts-upgradeable/crosschain/errorsUpgradeable.sol": {
+ "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.6.0) (crosschain/errors.sol)\n\npragma solidity ^0.8.4;\n\nerror NotCrossChainCall();\nerror InvalidCrossChainSender(address actual, address expected);\n"
+ },
+ "@openzeppelin/contracts-upgradeable/crosschain/optimism/LibOptimismUpgradeable.sol": {
+ "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.7.0) (crosschain/optimism/LibOptimism.sol)\n\npragma solidity ^0.8.4;\n\nimport {ICrossDomainMessengerUpgradeable as Optimism_Bridge} from \"../../vendor/optimism/ICrossDomainMessengerUpgradeable.sol\";\nimport \"../errorsUpgradeable.sol\";\n\n/**\n * @dev Primitives for cross-chain aware contracts for https://www.optimism.io/[Optimism].\n * See the https://community.optimism.io/docs/developers/bridge/messaging/#accessing-msg-sender[documentation]\n * for the functionality used here.\n */\nlibrary LibOptimismUpgradeable {\n /**\n * @dev Returns whether the current function call is the result of a\n * cross-chain message relayed by `messenger`.\n */\n function isCrossChain(address messenger) internal view returns (bool) {\n return msg.sender == messenger;\n }\n\n /**\n * @dev Returns the address of the sender that triggered the current\n * cross-chain message through `messenger`.\n *\n * NOTE: {isCrossChain} should be checked before trying to recover the\n * sender, as it will revert with `NotCrossChainCall` if the current\n * function call is not the result of a cross-chain message.\n */\n function crossChainSender(address messenger) internal view returns (address) {\n if (!isCrossChain(messenger)) revert NotCrossChainCall();\n\n return Optimism_Bridge(messenger).xDomainMessageSender();\n }\n}\n"
+ },
+ "@openzeppelin/contracts-upgradeable/interfaces/draft-IERC1822Upgradeable.sol": {
+ "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.5.0) (interfaces/draft-IERC1822.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @dev ERC1822: Universal Upgradeable Proxy Standard (UUPS) documents a method for upgradeability through a simplified\n * proxy whose upgrades are fully controlled by the current implementation.\n */\ninterface IERC1822ProxiableUpgradeable {\n /**\n * @dev Returns the storage slot that the proxiable contract assumes is being used to store the implementation\n * address.\n *\n * IMPORTANT: A proxy pointing at a proxiable contract should not be considered proxiable itself, because this risks\n * bricking a proxy that upgrades to it, by delegating to itself until out of gas. Thus it is critical that this\n * function revert if invoked through a proxy.\n */\n function proxiableUUID() external view returns (bytes32);\n}\n"
+ },
+ "@openzeppelin/contracts-upgradeable/interfaces/IERC1967Upgradeable.sol": {
+ "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (interfaces/IERC1967.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @dev ERC-1967: Proxy Storage Slots. This interface contains the events defined in the ERC.\n *\n * _Available since v4.8.3._\n */\ninterface IERC1967Upgradeable {\n /**\n * @dev Emitted when the implementation is upgraded.\n */\n event Upgraded(address indexed implementation);\n\n /**\n * @dev Emitted when the admin account has changed.\n */\n event AdminChanged(address previousAdmin, address newAdmin);\n\n /**\n * @dev Emitted when the beacon is changed.\n */\n event BeaconUpgraded(address indexed beacon);\n}\n"
+ },
+ "@openzeppelin/contracts-upgradeable/proxy/beacon/IBeaconUpgradeable.sol": {
+ "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts v4.4.1 (proxy/beacon/IBeacon.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @dev This is the interface that {BeaconProxy} expects of its beacon.\n */\ninterface IBeaconUpgradeable {\n /**\n * @dev Must return an address that can be used as a delegate call target.\n *\n * {BeaconProxy} will check that this address is a contract.\n */\n function implementation() external view returns (address);\n}\n"
+ },
+ "@openzeppelin/contracts-upgradeable/proxy/ERC1967/ERC1967UpgradeUpgradeable.sol": {
+ "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (proxy/ERC1967/ERC1967Upgrade.sol)\n\npragma solidity ^0.8.2;\n\nimport \"../beacon/IBeaconUpgradeable.sol\";\nimport \"../../interfaces/IERC1967Upgradeable.sol\";\nimport \"../../interfaces/draft-IERC1822Upgradeable.sol\";\nimport \"../../utils/AddressUpgradeable.sol\";\nimport \"../../utils/StorageSlotUpgradeable.sol\";\nimport {Initializable} from \"../utils/Initializable.sol\";\n\n/**\n * @dev This abstract contract provides getters and event emitting update functions for\n * https://eips.ethereum.org/EIPS/eip-1967[EIP1967] slots.\n *\n * _Available since v4.1._\n */\nabstract contract ERC1967UpgradeUpgradeable is Initializable, IERC1967Upgradeable {\n // This is the keccak-256 hash of \"eip1967.proxy.rollback\" subtracted by 1\n bytes32 private constant _ROLLBACK_SLOT = 0x4910fdfa16fed3260ed0e7147f7cc6da11a60208b5b9406d12a635614ffd9143;\n\n /**\n * @dev Storage slot with the address of the current implementation.\n * This is the keccak-256 hash of \"eip1967.proxy.implementation\" subtracted by 1, and is\n * validated in the constructor.\n */\n bytes32 internal constant _IMPLEMENTATION_SLOT = 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc;\n\n function __ERC1967Upgrade_init() internal onlyInitializing {\n }\n\n function __ERC1967Upgrade_init_unchained() internal onlyInitializing {\n }\n /**\n * @dev Returns the current implementation address.\n */\n function _getImplementation() internal view returns (address) {\n return StorageSlotUpgradeable.getAddressSlot(_IMPLEMENTATION_SLOT).value;\n }\n\n /**\n * @dev Stores a new address in the EIP1967 implementation slot.\n */\n function _setImplementation(address newImplementation) private {\n require(AddressUpgradeable.isContract(newImplementation), \"ERC1967: new implementation is not a contract\");\n StorageSlotUpgradeable.getAddressSlot(_IMPLEMENTATION_SLOT).value = newImplementation;\n }\n\n /**\n * @dev Perform implementation upgrade\n *\n * Emits an {Upgraded} event.\n */\n function _upgradeTo(address newImplementation) internal {\n _setImplementation(newImplementation);\n emit Upgraded(newImplementation);\n }\n\n /**\n * @dev Perform implementation upgrade with additional setup call.\n *\n * Emits an {Upgraded} event.\n */\n function _upgradeToAndCall(address newImplementation, bytes memory data, bool forceCall) internal {\n _upgradeTo(newImplementation);\n if (data.length > 0 || forceCall) {\n AddressUpgradeable.functionDelegateCall(newImplementation, data);\n }\n }\n\n /**\n * @dev Perform implementation upgrade with security checks for UUPS proxies, and additional setup call.\n *\n * Emits an {Upgraded} event.\n */\n function _upgradeToAndCallUUPS(address newImplementation, bytes memory data, bool forceCall) internal {\n // Upgrades from old implementations will perform a rollback test. This test requires the new\n // implementation to upgrade back to the old, non-ERC1822 compliant, implementation. Removing\n // this special case will break upgrade paths from old UUPS implementation to new ones.\n if (StorageSlotUpgradeable.getBooleanSlot(_ROLLBACK_SLOT).value) {\n _setImplementation(newImplementation);\n } else {\n try IERC1822ProxiableUpgradeable(newImplementation).proxiableUUID() returns (bytes32 slot) {\n require(slot == _IMPLEMENTATION_SLOT, \"ERC1967Upgrade: unsupported proxiableUUID\");\n } catch {\n revert(\"ERC1967Upgrade: new implementation is not UUPS\");\n }\n _upgradeToAndCall(newImplementation, data, forceCall);\n }\n }\n\n /**\n * @dev Storage slot with the admin of the contract.\n * This is the keccak-256 hash of \"eip1967.proxy.admin\" subtracted by 1, and is\n * validated in the constructor.\n */\n bytes32 internal constant _ADMIN_SLOT = 0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103;\n\n /**\n * @dev Returns the current admin.\n */\n function _getAdmin() internal view returns (address) {\n return StorageSlotUpgradeable.getAddressSlot(_ADMIN_SLOT).value;\n }\n\n /**\n * @dev Stores a new address in the EIP1967 admin slot.\n */\n function _setAdmin(address newAdmin) private {\n require(newAdmin != address(0), \"ERC1967: new admin is the zero address\");\n StorageSlotUpgradeable.getAddressSlot(_ADMIN_SLOT).value = newAdmin;\n }\n\n /**\n * @dev Changes the admin of the proxy.\n *\n * Emits an {AdminChanged} event.\n */\n function _changeAdmin(address newAdmin) internal {\n emit AdminChanged(_getAdmin(), newAdmin);\n _setAdmin(newAdmin);\n }\n\n /**\n * @dev The storage slot of the UpgradeableBeacon contract which defines the implementation for this proxy.\n * This is bytes32(uint256(keccak256('eip1967.proxy.beacon')) - 1)) and is validated in the constructor.\n */\n bytes32 internal constant _BEACON_SLOT = 0xa3f0ad74e5423aebfd80d3ef4346578335a9a72aeaee59ff6cb3582b35133d50;\n\n /**\n * @dev Returns the current beacon.\n */\n function _getBeacon() internal view returns (address) {\n return StorageSlotUpgradeable.getAddressSlot(_BEACON_SLOT).value;\n }\n\n /**\n * @dev Stores a new beacon in the EIP1967 beacon slot.\n */\n function _setBeacon(address newBeacon) private {\n require(AddressUpgradeable.isContract(newBeacon), \"ERC1967: new beacon is not a contract\");\n require(\n AddressUpgradeable.isContract(IBeaconUpgradeable(newBeacon).implementation()),\n \"ERC1967: beacon implementation is not a contract\"\n );\n StorageSlotUpgradeable.getAddressSlot(_BEACON_SLOT).value = newBeacon;\n }\n\n /**\n * @dev Perform beacon upgrade with additional setup call. Note: This upgrades the address of the beacon, it does\n * not upgrade the implementation contained in the beacon (see {UpgradeableBeacon-_setImplementation} for that).\n *\n * Emits a {BeaconUpgraded} event.\n */\n function _upgradeBeaconToAndCall(address newBeacon, bytes memory data, bool forceCall) internal {\n _setBeacon(newBeacon);\n emit BeaconUpgraded(newBeacon);\n if (data.length > 0 || forceCall) {\n AddressUpgradeable.functionDelegateCall(IBeaconUpgradeable(newBeacon).implementation(), data);\n }\n }\n\n /**\n * @dev This empty reserved space is put in place to allow future versions to add new\n * variables without shifting down storage in the inheritance chain.\n * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps\n */\n uint256[50] private __gap;\n}\n"
+ },
+ "@openzeppelin/contracts-upgradeable/proxy/utils/Initializable.sol": {
+ "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (proxy/utils/Initializable.sol)\n\npragma solidity ^0.8.2;\n\nimport \"../../utils/AddressUpgradeable.sol\";\n\n/**\n * @dev This is a base contract to aid in writing upgradeable contracts, or any kind of contract that will be deployed\n * behind a proxy. Since proxied contracts do not make use of a constructor, it's common to move constructor logic to an\n * external initializer function, usually called `initialize`. It then becomes necessary to protect this initializer\n * function so it can only be called once. The {initializer} modifier provided by this contract will have this effect.\n *\n * The initialization functions use a version number. Once a version number is used, it is consumed and cannot be\n * reused. This mechanism prevents re-execution of each \"step\" but allows the creation of new initialization steps in\n * case an upgrade adds a module that needs to be initialized.\n *\n * For example:\n *\n * [.hljs-theme-light.nopadding]\n * ```solidity\n * contract MyToken is ERC20Upgradeable {\n * function initialize() initializer public {\n * __ERC20_init(\"MyToken\", \"MTK\");\n * }\n * }\n *\n * contract MyTokenV2 is MyToken, ERC20PermitUpgradeable {\n * function initializeV2() reinitializer(2) public {\n * __ERC20Permit_init(\"MyToken\");\n * }\n * }\n * ```\n *\n * TIP: To avoid leaving the proxy in an uninitialized state, the initializer function should be called as early as\n * possible by providing the encoded function call as the `_data` argument to {ERC1967Proxy-constructor}.\n *\n * CAUTION: When used with inheritance, manual care must be taken to not invoke a parent initializer twice, or to ensure\n * that all initializers are idempotent. This is not verified automatically as constructors are by Solidity.\n *\n * [CAUTION]\n * ====\n * Avoid leaving a contract uninitialized.\n *\n * An uninitialized contract can be taken over by an attacker. This applies to both a proxy and its implementation\n * contract, which may impact the proxy. To prevent the implementation contract from being used, you should invoke\n * the {_disableInitializers} function in the constructor to automatically lock it when it is deployed:\n *\n * [.hljs-theme-light.nopadding]\n * ```\n * /// @custom:oz-upgrades-unsafe-allow constructor\n * constructor() {\n * _disableInitializers();\n * }\n * ```\n * ====\n */\nabstract contract Initializable {\n /**\n * @dev Indicates that the contract has been initialized.\n * @custom:oz-retyped-from bool\n */\n uint8 private _initialized;\n\n /**\n * @dev Indicates that the contract is in the process of being initialized.\n */\n bool private _initializing;\n\n /**\n * @dev Triggered when the contract has been initialized or reinitialized.\n */\n event Initialized(uint8 version);\n\n /**\n * @dev A modifier that defines a protected initializer function that can be invoked at most once. In its scope,\n * `onlyInitializing` functions can be used to initialize parent contracts.\n *\n * Similar to `reinitializer(1)`, except that functions marked with `initializer` can be nested in the context of a\n * constructor.\n *\n * Emits an {Initialized} event.\n */\n modifier initializer() {\n bool isTopLevelCall = !_initializing;\n require(\n (isTopLevelCall && _initialized < 1) || (!AddressUpgradeable.isContract(address(this)) && _initialized == 1),\n \"Initializable: contract is already initialized\"\n );\n _initialized = 1;\n if (isTopLevelCall) {\n _initializing = true;\n }\n _;\n if (isTopLevelCall) {\n _initializing = false;\n emit Initialized(1);\n }\n }\n\n /**\n * @dev A modifier that defines a protected reinitializer function that can be invoked at most once, and only if the\n * contract hasn't been initialized to a greater version before. In its scope, `onlyInitializing` functions can be\n * used to initialize parent contracts.\n *\n * A reinitializer may be used after the original initialization step. This is essential to configure modules that\n * are added through upgrades and that require initialization.\n *\n * When `version` is 1, this modifier is similar to `initializer`, except that functions marked with `reinitializer`\n * cannot be nested. If one is invoked in the context of another, execution will revert.\n *\n * Note that versions can jump in increments greater than 1; this implies that if multiple reinitializers coexist in\n * a contract, executing them in the right order is up to the developer or operator.\n *\n * WARNING: setting the version to 255 will prevent any future reinitialization.\n *\n * Emits an {Initialized} event.\n */\n modifier reinitializer(uint8 version) {\n require(!_initializing && _initialized < version, \"Initializable: contract is already initialized\");\n _initialized = version;\n _initializing = true;\n _;\n _initializing = false;\n emit Initialized(version);\n }\n\n /**\n * @dev Modifier to protect an initialization function so that it can only be invoked by functions with the\n * {initializer} and {reinitializer} modifiers, directly or indirectly.\n */\n modifier onlyInitializing() {\n require(_initializing, \"Initializable: contract is not initializing\");\n _;\n }\n\n /**\n * @dev Locks the contract, preventing any future reinitialization. This cannot be part of an initializer call.\n * Calling this in the constructor of a contract will prevent that contract from being initialized or reinitialized\n * to any version. It is recommended to use this to lock implementation contracts that are designed to be called\n * through proxies.\n *\n * Emits an {Initialized} event the first time it is successfully executed.\n */\n function _disableInitializers() internal virtual {\n require(!_initializing, \"Initializable: contract is initializing\");\n if (_initialized != type(uint8).max) {\n _initialized = type(uint8).max;\n emit Initialized(type(uint8).max);\n }\n }\n\n /**\n * @dev Returns the highest version that has been initialized. See {reinitializer}.\n */\n function _getInitializedVersion() internal view returns (uint8) {\n return _initialized;\n }\n\n /**\n * @dev Returns `true` if the contract is currently initializing. See {onlyInitializing}.\n */\n function _isInitializing() internal view returns (bool) {\n return _initializing;\n }\n}\n"
+ },
+ "@openzeppelin/contracts-upgradeable/proxy/utils/UUPSUpgradeable.sol": {
+ "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (proxy/utils/UUPSUpgradeable.sol)\n\npragma solidity ^0.8.0;\n\nimport \"../../interfaces/draft-IERC1822Upgradeable.sol\";\nimport \"../ERC1967/ERC1967UpgradeUpgradeable.sol\";\nimport {Initializable} from \"./Initializable.sol\";\n\n/**\n * @dev An upgradeability mechanism designed for UUPS proxies. The functions included here can perform an upgrade of an\n * {ERC1967Proxy}, when this contract is set as the implementation behind such a proxy.\n *\n * A security mechanism ensures that an upgrade does not turn off upgradeability accidentally, although this risk is\n * reinstated if the upgrade retains upgradeability but removes the security mechanism, e.g. by replacing\n * `UUPSUpgradeable` with a custom implementation of upgrades.\n *\n * The {_authorizeUpgrade} function must be overridden to include access restriction to the upgrade mechanism.\n *\n * _Available since v4.1._\n */\nabstract contract UUPSUpgradeable is Initializable, IERC1822ProxiableUpgradeable, ERC1967UpgradeUpgradeable {\n /// @custom:oz-upgrades-unsafe-allow state-variable-immutable state-variable-assignment\n address private immutable __self = address(this);\n\n /**\n * @dev Check that the execution is being performed through a delegatecall call and that the execution context is\n * a proxy contract with an implementation (as defined in ERC1967) pointing to self. This should only be the case\n * for UUPS and transparent proxies that are using the current contract as their implementation. Execution of a\n * function through ERC1167 minimal proxies (clones) would not normally pass this test, but is not guaranteed to\n * fail.\n */\n modifier onlyProxy() {\n require(address(this) != __self, \"Function must be called through delegatecall\");\n require(_getImplementation() == __self, \"Function must be called through active proxy\");\n _;\n }\n\n /**\n * @dev Check that the execution is not being performed through a delegate call. This allows a function to be\n * callable on the implementing contract but not through proxies.\n */\n modifier notDelegated() {\n require(address(this) == __self, \"UUPSUpgradeable: must not be called through delegatecall\");\n _;\n }\n\n function __UUPSUpgradeable_init() internal onlyInitializing {\n }\n\n function __UUPSUpgradeable_init_unchained() internal onlyInitializing {\n }\n /**\n * @dev Implementation of the ERC1822 {proxiableUUID} function. This returns the storage slot used by the\n * implementation. It is used to validate the implementation's compatibility when performing an upgrade.\n *\n * IMPORTANT: A proxy pointing at a proxiable contract should not be considered proxiable itself, because this risks\n * bricking a proxy that upgrades to it, by delegating to itself until out of gas. Thus it is critical that this\n * function revert if invoked through a proxy. This is guaranteed by the `notDelegated` modifier.\n */\n function proxiableUUID() external view virtual override notDelegated returns (bytes32) {\n return _IMPLEMENTATION_SLOT;\n }\n\n /**\n * @dev Upgrade the implementation of the proxy to `newImplementation`.\n *\n * Calls {_authorizeUpgrade}.\n *\n * Emits an {Upgraded} event.\n *\n * @custom:oz-upgrades-unsafe-allow-reachable delegatecall\n */\n function upgradeTo(address newImplementation) public virtual onlyProxy {\n _authorizeUpgrade(newImplementation);\n _upgradeToAndCallUUPS(newImplementation, new bytes(0), false);\n }\n\n /**\n * @dev Upgrade the implementation of the proxy to `newImplementation`, and subsequently execute the function call\n * encoded in `data`.\n *\n * Calls {_authorizeUpgrade}.\n *\n * Emits an {Upgraded} event.\n *\n * @custom:oz-upgrades-unsafe-allow-reachable delegatecall\n */\n function upgradeToAndCall(address newImplementation, bytes memory data) public payable virtual onlyProxy {\n _authorizeUpgrade(newImplementation);\n _upgradeToAndCallUUPS(newImplementation, data, true);\n }\n\n /**\n * @dev Function that should revert when `msg.sender` is not authorized to upgrade the contract. Called by\n * {upgradeTo} and {upgradeToAndCall}.\n *\n * Normally, this function will use an xref:access.adoc[access control] modifier such as {Ownable-onlyOwner}.\n *\n * ```solidity\n * function _authorizeUpgrade(address) internal override onlyOwner {}\n * ```\n */\n function _authorizeUpgrade(address newImplementation) internal virtual;\n\n /**\n * @dev This empty reserved space is put in place to allow future versions to add new\n * variables without shifting down storage in the inheritance chain.\n * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps\n */\n uint256[50] private __gap;\n}\n"
+ },
+ "@openzeppelin/contracts-upgradeable/security/ReentrancyGuardUpgradeable.sol": {
+ "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (security/ReentrancyGuard.sol)\n\npragma solidity ^0.8.0;\nimport {Initializable} from \"../proxy/utils/Initializable.sol\";\n\n/**\n * @dev Contract module that helps prevent reentrant calls to a function.\n *\n * Inheriting from `ReentrancyGuard` will make the {nonReentrant} modifier\n * available, which can be applied to functions to make sure there are no nested\n * (reentrant) calls to them.\n *\n * Note that because there is a single `nonReentrant` guard, functions marked as\n * `nonReentrant` may not call one another. This can be worked around by making\n * those functions `private`, and then adding `external` `nonReentrant` entry\n * points to them.\n *\n * TIP: If you would like to learn more about reentrancy and alternative ways\n * to protect against it, check out our blog post\n * https://blog.openzeppelin.com/reentrancy-after-istanbul/[Reentrancy After Istanbul].\n */\nabstract contract ReentrancyGuardUpgradeable is Initializable {\n // Booleans are more expensive than uint256 or any type that takes up a full\n // word because each write operation emits an extra SLOAD to first read the\n // slot's contents, replace the bits taken up by the boolean, and then write\n // back. This is the compiler's defense against contract upgrades and\n // pointer aliasing, and it cannot be disabled.\n\n // The values being non-zero value makes deployment a bit more expensive,\n // but in exchange the refund on every call to nonReentrant will be lower in\n // amount. Since refunds are capped to a percentage of the total\n // transaction's gas, it is best to keep them low in cases like this one, to\n // increase the likelihood of the full refund coming into effect.\n uint256 private constant _NOT_ENTERED = 1;\n uint256 private constant _ENTERED = 2;\n\n uint256 private _status;\n\n function __ReentrancyGuard_init() internal onlyInitializing {\n __ReentrancyGuard_init_unchained();\n }\n\n function __ReentrancyGuard_init_unchained() internal onlyInitializing {\n _status = _NOT_ENTERED;\n }\n\n /**\n * @dev Prevents a contract from calling itself, directly or indirectly.\n * Calling a `nonReentrant` function from another `nonReentrant`\n * function is not supported. It is possible to prevent this from happening\n * by making the `nonReentrant` function external, and making it call a\n * `private` function that does the actual work.\n */\n modifier nonReentrant() {\n _nonReentrantBefore();\n _;\n _nonReentrantAfter();\n }\n\n function _nonReentrantBefore() private {\n // On the first call to nonReentrant, _status will be _NOT_ENTERED\n require(_status != _ENTERED, \"ReentrancyGuard: reentrant call\");\n\n // Any calls to nonReentrant after this point will fail\n _status = _ENTERED;\n }\n\n function _nonReentrantAfter() private {\n // By storing the original value once again, a refund is triggered (see\n // https://eips.ethereum.org/EIPS/eip-2200)\n _status = _NOT_ENTERED;\n }\n\n /**\n * @dev Returns true if the reentrancy guard is currently set to \"entered\", which indicates there is a\n * `nonReentrant` function in the call stack.\n */\n function _reentrancyGuardEntered() internal view returns (bool) {\n return _status == _ENTERED;\n }\n\n /**\n * @dev This empty reserved space is put in place to allow future versions to add new\n * variables without shifting down storage in the inheritance chain.\n * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps\n */\n uint256[49] private __gap;\n}\n"
+ },
+ "@openzeppelin/contracts-upgradeable/token/ERC20/extensions/IERC20PermitUpgradeable.sol": {
+ "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.4) (token/ERC20/extensions/IERC20Permit.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @dev Interface of the ERC20 Permit extension allowing approvals to be made via signatures, as defined in\n * https://eips.ethereum.org/EIPS/eip-2612[EIP-2612].\n *\n * Adds the {permit} method, which can be used to change an account's ERC20 allowance (see {IERC20-allowance}) by\n * presenting a message signed by the account. By not relying on {IERC20-approve}, the token holder account doesn't\n * need to send a transaction, and thus is not required to hold Ether at all.\n *\n * ==== Security Considerations\n *\n * There are two important considerations concerning the use of `permit`. The first is that a valid permit signature\n * expresses an allowance, and it should not be assumed to convey additional meaning. In particular, it should not be\n * considered as an intention to spend the allowance in any specific way. The second is that because permits have\n * built-in replay protection and can be submitted by anyone, they can be frontrun. A protocol that uses permits should\n * take this into consideration and allow a `permit` call to fail. Combining these two aspects, a pattern that may be\n * generally recommended is:\n *\n * ```solidity\n * function doThingWithPermit(..., uint256 value, uint256 deadline, uint8 v, bytes32 r, bytes32 s) public {\n * try token.permit(msg.sender, address(this), value, deadline, v, r, s) {} catch {}\n * doThing(..., value);\n * }\n *\n * function doThing(..., uint256 value) public {\n * token.safeTransferFrom(msg.sender, address(this), value);\n * ...\n * }\n * ```\n *\n * Observe that: 1) `msg.sender` is used as the owner, leaving no ambiguity as to the signer intent, and 2) the use of\n * `try/catch` allows the permit to fail and makes the code tolerant to frontrunning. (See also\n * {SafeERC20-safeTransferFrom}).\n *\n * Additionally, note that smart contract wallets (such as Argent or Safe) are not able to produce permit signatures, so\n * contracts should have entry points that don't rely on permit.\n */\ninterface IERC20PermitUpgradeable {\n /**\n * @dev Sets `value` as the allowance of `spender` over ``owner``'s tokens,\n * given ``owner``'s signed approval.\n *\n * IMPORTANT: The same issues {IERC20-approve} has related to transaction\n * ordering also apply here.\n *\n * Emits an {Approval} event.\n *\n * Requirements:\n *\n * - `spender` cannot be the zero address.\n * - `deadline` must be a timestamp in the future.\n * - `v`, `r` and `s` must be a valid `secp256k1` signature from `owner`\n * over the EIP712-formatted function arguments.\n * - the signature must use ``owner``'s current nonce (see {nonces}).\n *\n * For more information on the signature format, see the\n * https://eips.ethereum.org/EIPS/eip-2612#specification[relevant EIP\n * section].\n *\n * CAUTION: See Security Considerations above.\n */\n function permit(\n address owner,\n address spender,\n uint256 value,\n uint256 deadline,\n uint8 v,\n bytes32 r,\n bytes32 s\n ) external;\n\n /**\n * @dev Returns the current nonce for `owner`. This value must be\n * included whenever a signature is generated for {permit}.\n *\n * Every successful call to {permit} increases ``owner``'s nonce by one. This\n * prevents a signature from being used multiple times.\n */\n function nonces(address owner) external view returns (uint256);\n\n /**\n * @dev Returns the domain separator used in the encoding of the signature for {permit}, as defined by {EIP712}.\n */\n // solhint-disable-next-line func-name-mixedcase\n function DOMAIN_SEPARATOR() external view returns (bytes32);\n}\n"
+ },
+ "@openzeppelin/contracts-upgradeable/token/ERC20/IERC20Upgradeable.sol": {
+ "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (token/ERC20/IERC20.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @dev Interface of the ERC20 standard as defined in the EIP.\n */\ninterface IERC20Upgradeable {\n /**\n * @dev Emitted when `value` tokens are moved from one account (`from`) to\n * another (`to`).\n *\n * Note that `value` may be zero.\n */\n event Transfer(address indexed from, address indexed to, uint256 value);\n\n /**\n * @dev Emitted when the allowance of a `spender` for an `owner` is set by\n * a call to {approve}. `value` is the new allowance.\n */\n event Approval(address indexed owner, address indexed spender, uint256 value);\n\n /**\n * @dev Returns the amount of tokens in existence.\n */\n function totalSupply() external view returns (uint256);\n\n /**\n * @dev Returns the amount of tokens owned by `account`.\n */\n function balanceOf(address account) external view returns (uint256);\n\n /**\n * @dev Moves `amount` tokens from the caller's account to `to`.\n *\n * Returns a boolean value indicating whether the operation succeeded.\n *\n * Emits a {Transfer} event.\n */\n function transfer(address to, uint256 amount) external returns (bool);\n\n /**\n * @dev Returns the remaining number of tokens that `spender` will be\n * allowed to spend on behalf of `owner` through {transferFrom}. This is\n * zero by default.\n *\n * This value changes when {approve} or {transferFrom} are called.\n */\n function allowance(address owner, address spender) external view returns (uint256);\n\n /**\n * @dev Sets `amount` as the allowance of `spender` over the caller's tokens.\n *\n * Returns a boolean value indicating whether the operation succeeded.\n *\n * IMPORTANT: Beware that changing an allowance with this method brings the risk\n * that someone may use both the old and the new allowance by unfortunate\n * transaction ordering. One possible solution to mitigate this race\n * condition is to first reduce the spender's allowance to 0 and set the\n * desired value afterwards:\n * https://github.com/ethereum/EIPs/issues/20#issuecomment-263524729\n *\n * Emits an {Approval} event.\n */\n function approve(address spender, uint256 amount) external returns (bool);\n\n /**\n * @dev Moves `amount` tokens from `from` to `to` using the\n * allowance mechanism. `amount` is then deducted from the caller's\n * allowance.\n *\n * Returns a boolean value indicating whether the operation succeeded.\n *\n * Emits a {Transfer} event.\n */\n function transferFrom(address from, address to, uint256 amount) external returns (bool);\n}\n"
+ },
+ "@openzeppelin/contracts-upgradeable/token/ERC20/utils/SafeERC20Upgradeable.sol": {
+ "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.3) (token/ERC20/utils/SafeERC20.sol)\n\npragma solidity ^0.8.0;\n\nimport \"../IERC20Upgradeable.sol\";\nimport \"../extensions/IERC20PermitUpgradeable.sol\";\nimport \"../../../utils/AddressUpgradeable.sol\";\n\n/**\n * @title SafeERC20\n * @dev Wrappers around ERC20 operations that throw on failure (when the token\n * contract returns false). Tokens that return no value (and instead revert or\n * throw on failure) are also supported, non-reverting calls are assumed to be\n * successful.\n * To use this library you can add a `using SafeERC20 for IERC20;` statement to your contract,\n * which allows you to call the safe operations as `token.safeTransfer(...)`, etc.\n */\nlibrary SafeERC20Upgradeable {\n using AddressUpgradeable for address;\n\n /**\n * @dev Transfer `value` amount of `token` from the calling contract to `to`. If `token` returns no value,\n * non-reverting calls are assumed to be successful.\n */\n function safeTransfer(IERC20Upgradeable token, address to, uint256 value) internal {\n _callOptionalReturn(token, abi.encodeWithSelector(token.transfer.selector, to, value));\n }\n\n /**\n * @dev Transfer `value` amount of `token` from `from` to `to`, spending the approval given by `from` to the\n * calling contract. If `token` returns no value, non-reverting calls are assumed to be successful.\n */\n function safeTransferFrom(IERC20Upgradeable token, address from, address to, uint256 value) internal {\n _callOptionalReturn(token, abi.encodeWithSelector(token.transferFrom.selector, from, to, value));\n }\n\n /**\n * @dev Deprecated. This function has issues similar to the ones found in\n * {IERC20-approve}, and its usage is discouraged.\n *\n * Whenever possible, use {safeIncreaseAllowance} and\n * {safeDecreaseAllowance} instead.\n */\n function safeApprove(IERC20Upgradeable token, address spender, uint256 value) internal {\n // safeApprove should only be called when setting an initial allowance,\n // or when resetting it to zero. To increase and decrease it, use\n // 'safeIncreaseAllowance' and 'safeDecreaseAllowance'\n require(\n (value == 0) || (token.allowance(address(this), spender) == 0),\n \"SafeERC20: approve from non-zero to non-zero allowance\"\n );\n _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, value));\n }\n\n /**\n * @dev Increase the calling contract's allowance toward `spender` by `value`. If `token` returns no value,\n * non-reverting calls are assumed to be successful.\n */\n function safeIncreaseAllowance(IERC20Upgradeable token, address spender, uint256 value) internal {\n uint256 oldAllowance = token.allowance(address(this), spender);\n _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, oldAllowance + value));\n }\n\n /**\n * @dev Decrease the calling contract's allowance toward `spender` by `value`. If `token` returns no value,\n * non-reverting calls are assumed to be successful.\n */\n function safeDecreaseAllowance(IERC20Upgradeable token, address spender, uint256 value) internal {\n unchecked {\n uint256 oldAllowance = token.allowance(address(this), spender);\n require(oldAllowance >= value, \"SafeERC20: decreased allowance below zero\");\n _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, oldAllowance - value));\n }\n }\n\n /**\n * @dev Set the calling contract's allowance toward `spender` to `value`. If `token` returns no value,\n * non-reverting calls are assumed to be successful. Meant to be used with tokens that require the approval\n * to be set to zero before setting it to a non-zero value, such as USDT.\n */\n function forceApprove(IERC20Upgradeable token, address spender, uint256 value) internal {\n bytes memory approvalCall = abi.encodeWithSelector(token.approve.selector, spender, value);\n\n if (!_callOptionalReturnBool(token, approvalCall)) {\n _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, 0));\n _callOptionalReturn(token, approvalCall);\n }\n }\n\n /**\n * @dev Use a ERC-2612 signature to set the `owner` approval toward `spender` on `token`.\n * Revert on invalid signature.\n */\n function safePermit(\n IERC20PermitUpgradeable token,\n address owner,\n address spender,\n uint256 value,\n uint256 deadline,\n uint8 v,\n bytes32 r,\n bytes32 s\n ) internal {\n uint256 nonceBefore = token.nonces(owner);\n token.permit(owner, spender, value, deadline, v, r, s);\n uint256 nonceAfter = token.nonces(owner);\n require(nonceAfter == nonceBefore + 1, \"SafeERC20: permit did not succeed\");\n }\n\n /**\n * @dev Imitates a Solidity high-level call (i.e. a regular function call to a contract), relaxing the requirement\n * on the return value: the return value is optional (but if data is returned, it must not be false).\n * @param token The token targeted by the call.\n * @param data The call data (encoded using abi.encode or one of its variants).\n */\n function _callOptionalReturn(IERC20Upgradeable token, bytes memory data) private {\n // We need to perform a low level call here, to bypass Solidity's return data size checking mechanism, since\n // we're implementing it ourselves. We use {Address-functionCall} to perform this call, which verifies that\n // the target address contains contract code and also asserts for success in the low-level call.\n\n bytes memory returndata = address(token).functionCall(data, \"SafeERC20: low-level call failed\");\n require(returndata.length == 0 || abi.decode(returndata, (bool)), \"SafeERC20: ERC20 operation did not succeed\");\n }\n\n /**\n * @dev Imitates a Solidity high-level call (i.e. a regular function call to a contract), relaxing the requirement\n * on the return value: the return value is optional (but if data is returned, it must not be false).\n * @param token The token targeted by the call.\n * @param data The call data (encoded using abi.encode or one of its variants).\n *\n * This is a variant of {_callOptionalReturn} that silents catches all reverts and returns a bool instead.\n */\n function _callOptionalReturnBool(IERC20Upgradeable token, bytes memory data) private returns (bool) {\n // We need to perform a low level call here, to bypass Solidity's return data size checking mechanism, since\n // we're implementing it ourselves. We cannot use {Address-functionCall} here since this should return false\n // and not revert is the subcall reverts.\n\n (bool success, bytes memory returndata) = address(token).call(data);\n return\n success && (returndata.length == 0 || abi.decode(returndata, (bool))) && AddressUpgradeable.isContract(address(token));\n }\n}\n"
+ },
+ "@openzeppelin/contracts-upgradeable/utils/AddressUpgradeable.sol": {
+ "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (utils/Address.sol)\n\npragma solidity ^0.8.1;\n\n/**\n * @dev Collection of functions related to the address type\n */\nlibrary AddressUpgradeable {\n /**\n * @dev Returns true if `account` is a contract.\n *\n * [IMPORTANT]\n * ====\n * It is unsafe to assume that an address for which this function returns\n * false is an externally-owned account (EOA) and not a contract.\n *\n * Among others, `isContract` will return false for the following\n * types of addresses:\n *\n * - an externally-owned account\n * - a contract in construction\n * - an address where a contract will be created\n * - an address where a contract lived, but was destroyed\n *\n * Furthermore, `isContract` will also return true if the target contract within\n * the same transaction is already scheduled for destruction by `SELFDESTRUCT`,\n * which only has an effect at the end of a transaction.\n * ====\n *\n * [IMPORTANT]\n * ====\n * You shouldn't rely on `isContract` to protect against flash loan attacks!\n *\n * Preventing calls from contracts is highly discouraged. It breaks composability, breaks support for smart wallets\n * like Gnosis Safe, and does not provide security since it can be circumvented by calling from a contract\n * constructor.\n * ====\n */\n function isContract(address account) internal view returns (bool) {\n // This method relies on extcodesize/address.code.length, which returns 0\n // for contracts in construction, since the code is only stored at the end\n // of the constructor execution.\n\n return account.code.length > 0;\n }\n\n /**\n * @dev Replacement for Solidity's `transfer`: sends `amount` wei to\n * `recipient`, forwarding all available gas and reverting on errors.\n *\n * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost\n * of certain opcodes, possibly making contracts go over the 2300 gas limit\n * imposed by `transfer`, making them unable to receive funds via\n * `transfer`. {sendValue} removes this limitation.\n *\n * https://consensys.net/diligence/blog/2019/09/stop-using-soliditys-transfer-now/[Learn more].\n *\n * IMPORTANT: because control is transferred to `recipient`, care must be\n * taken to not create reentrancy vulnerabilities. Consider using\n * {ReentrancyGuard} or the\n * https://solidity.readthedocs.io/en/v0.8.0/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].\n */\n function sendValue(address payable recipient, uint256 amount) internal {\n require(address(this).balance >= amount, \"Address: insufficient balance\");\n\n (bool success, ) = recipient.call{value: amount}(\"\");\n require(success, \"Address: unable to send value, recipient may have reverted\");\n }\n\n /**\n * @dev Performs a Solidity function call using a low level `call`. A\n * plain `call` is an unsafe replacement for a function call: use this\n * function instead.\n *\n * If `target` reverts with a revert reason, it is bubbled up by this\n * function (like regular Solidity function calls).\n *\n * Returns the raw returned data. To convert to the expected return value,\n * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].\n *\n * Requirements:\n *\n * - `target` must be a contract.\n * - calling `target` with `data` must not revert.\n *\n * _Available since v3.1._\n */\n function functionCall(address target, bytes memory data) internal returns (bytes memory) {\n return functionCallWithValue(target, data, 0, \"Address: low-level call failed\");\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with\n * `errorMessage` as a fallback revert reason when `target` reverts.\n *\n * _Available since v3.1._\n */\n function functionCall(\n address target,\n bytes memory data,\n string memory errorMessage\n ) internal returns (bytes memory) {\n return functionCallWithValue(target, data, 0, errorMessage);\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\n * but also transferring `value` wei to `target`.\n *\n * Requirements:\n *\n * - the calling contract must have an ETH balance of at least `value`.\n * - the called Solidity function must be `payable`.\n *\n * _Available since v3.1._\n */\n function functionCallWithValue(address target, bytes memory data, uint256 value) internal returns (bytes memory) {\n return functionCallWithValue(target, data, value, \"Address: low-level call with value failed\");\n }\n\n /**\n * @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but\n * with `errorMessage` as a fallback revert reason when `target` reverts.\n *\n * _Available since v3.1._\n */\n function functionCallWithValue(\n address target,\n bytes memory data,\n uint256 value,\n string memory errorMessage\n ) internal returns (bytes memory) {\n require(address(this).balance >= value, \"Address: insufficient balance for call\");\n (bool success, bytes memory returndata) = target.call{value: value}(data);\n return verifyCallResultFromTarget(target, success, returndata, errorMessage);\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\n * but performing a static call.\n *\n * _Available since v3.3._\n */\n function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {\n return functionStaticCall(target, data, \"Address: low-level static call failed\");\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],\n * but performing a static call.\n *\n * _Available since v3.3._\n */\n function functionStaticCall(\n address target,\n bytes memory data,\n string memory errorMessage\n ) internal view returns (bytes memory) {\n (bool success, bytes memory returndata) = target.staticcall(data);\n return verifyCallResultFromTarget(target, success, returndata, errorMessage);\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\n * but performing a delegate call.\n *\n * _Available since v3.4._\n */\n function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) {\n return functionDelegateCall(target, data, \"Address: low-level delegate call failed\");\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],\n * but performing a delegate call.\n *\n * _Available since v3.4._\n */\n function functionDelegateCall(\n address target,\n bytes memory data,\n string memory errorMessage\n ) internal returns (bytes memory) {\n (bool success, bytes memory returndata) = target.delegatecall(data);\n return verifyCallResultFromTarget(target, success, returndata, errorMessage);\n }\n\n /**\n * @dev Tool to verify that a low level call to smart-contract was successful, and revert (either by bubbling\n * the revert reason or using the provided one) in case of unsuccessful call or if target was not a contract.\n *\n * _Available since v4.8._\n */\n function verifyCallResultFromTarget(\n address target,\n bool success,\n bytes memory returndata,\n string memory errorMessage\n ) internal view returns (bytes memory) {\n if (success) {\n if (returndata.length == 0) {\n // only check isContract if the call was successful and the return data is empty\n // otherwise we already know that it was a contract\n require(isContract(target), \"Address: call to non-contract\");\n }\n return returndata;\n } else {\n _revert(returndata, errorMessage);\n }\n }\n\n /**\n * @dev Tool to verify that a low level call was successful, and revert if it wasn't, either by bubbling the\n * revert reason or using the provided one.\n *\n * _Available since v4.3._\n */\n function verifyCallResult(\n bool success,\n bytes memory returndata,\n string memory errorMessage\n ) internal pure returns (bytes memory) {\n if (success) {\n return returndata;\n } else {\n _revert(returndata, errorMessage);\n }\n }\n\n function _revert(bytes memory returndata, string memory errorMessage) private pure {\n // Look for revert reason and bubble it up if present\n if (returndata.length > 0) {\n // The easiest way to bubble the revert reason is using memory via assembly\n /// @solidity memory-safe-assembly\n assembly {\n let returndata_size := mload(returndata)\n revert(add(32, returndata), returndata_size)\n }\n } else {\n revert(errorMessage);\n }\n }\n}\n"
+ },
+ "@openzeppelin/contracts-upgradeable/utils/cryptography/ECDSAUpgradeable.sol": {
+ "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (utils/cryptography/ECDSA.sol)\n\npragma solidity ^0.8.0;\n\nimport \"../StringsUpgradeable.sol\";\n\n/**\n * @dev Elliptic Curve Digital Signature Algorithm (ECDSA) operations.\n *\n * These functions can be used to verify that a message was signed by the holder\n * of the private keys of a given address.\n */\nlibrary ECDSAUpgradeable {\n enum RecoverError {\n NoError,\n InvalidSignature,\n InvalidSignatureLength,\n InvalidSignatureS,\n InvalidSignatureV // Deprecated in v4.8\n }\n\n function _throwError(RecoverError error) private pure {\n if (error == RecoverError.NoError) {\n return; // no error: do nothing\n } else if (error == RecoverError.InvalidSignature) {\n revert(\"ECDSA: invalid signature\");\n } else if (error == RecoverError.InvalidSignatureLength) {\n revert(\"ECDSA: invalid signature length\");\n } else if (error == RecoverError.InvalidSignatureS) {\n revert(\"ECDSA: invalid signature 's' value\");\n }\n }\n\n /**\n * @dev Returns the address that signed a hashed message (`hash`) with\n * `signature` or error string. This address can then be used for verification purposes.\n *\n * The `ecrecover` EVM opcode allows for malleable (non-unique) signatures:\n * this function rejects them by requiring the `s` value to be in the lower\n * half order, and the `v` value to be either 27 or 28.\n *\n * IMPORTANT: `hash` _must_ be the result of a hash operation for the\n * verification to be secure: it is possible to craft signatures that\n * recover to arbitrary addresses for non-hashed data. A safe way to ensure\n * this is by receiving a hash of the original message (which may otherwise\n * be too long), and then calling {toEthSignedMessageHash} on it.\n *\n * Documentation for signature generation:\n * - with https://web3js.readthedocs.io/en/v1.3.4/web3-eth-accounts.html#sign[Web3.js]\n * - with https://docs.ethers.io/v5/api/signer/#Signer-signMessage[ethers]\n *\n * _Available since v4.3._\n */\n function tryRecover(bytes32 hash, bytes memory signature) internal pure returns (address, RecoverError) {\n if (signature.length == 65) {\n bytes32 r;\n bytes32 s;\n uint8 v;\n // ecrecover takes the signature parameters, and the only way to get them\n // currently is to use assembly.\n /// @solidity memory-safe-assembly\n assembly {\n r := mload(add(signature, 0x20))\n s := mload(add(signature, 0x40))\n v := byte(0, mload(add(signature, 0x60)))\n }\n return tryRecover(hash, v, r, s);\n } else {\n return (address(0), RecoverError.InvalidSignatureLength);\n }\n }\n\n /**\n * @dev Returns the address that signed a hashed message (`hash`) with\n * `signature`. This address can then be used for verification purposes.\n *\n * The `ecrecover` EVM opcode allows for malleable (non-unique) signatures:\n * this function rejects them by requiring the `s` value to be in the lower\n * half order, and the `v` value to be either 27 or 28.\n *\n * IMPORTANT: `hash` _must_ be the result of a hash operation for the\n * verification to be secure: it is possible to craft signatures that\n * recover to arbitrary addresses for non-hashed data. A safe way to ensure\n * this is by receiving a hash of the original message (which may otherwise\n * be too long), and then calling {toEthSignedMessageHash} on it.\n */\n function recover(bytes32 hash, bytes memory signature) internal pure returns (address) {\n (address recovered, RecoverError error) = tryRecover(hash, signature);\n _throwError(error);\n return recovered;\n }\n\n /**\n * @dev Overload of {ECDSA-tryRecover} that receives the `r` and `vs` short-signature fields separately.\n *\n * See https://eips.ethereum.org/EIPS/eip-2098[EIP-2098 short signatures]\n *\n * _Available since v4.3._\n */\n function tryRecover(bytes32 hash, bytes32 r, bytes32 vs) internal pure returns (address, RecoverError) {\n bytes32 s = vs & bytes32(0x7fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff);\n uint8 v = uint8((uint256(vs) >> 255) + 27);\n return tryRecover(hash, v, r, s);\n }\n\n /**\n * @dev Overload of {ECDSA-recover} that receives the `r and `vs` short-signature fields separately.\n *\n * _Available since v4.2._\n */\n function recover(bytes32 hash, bytes32 r, bytes32 vs) internal pure returns (address) {\n (address recovered, RecoverError error) = tryRecover(hash, r, vs);\n _throwError(error);\n return recovered;\n }\n\n /**\n * @dev Overload of {ECDSA-tryRecover} that receives the `v`,\n * `r` and `s` signature fields separately.\n *\n * _Available since v4.3._\n */\n function tryRecover(bytes32 hash, uint8 v, bytes32 r, bytes32 s) internal pure returns (address, RecoverError) {\n // EIP-2 still allows signature malleability for ecrecover(). Remove this possibility and make the signature\n // unique. Appendix F in the Ethereum Yellow paper (https://ethereum.github.io/yellowpaper/paper.pdf), defines\n // the valid range for s in (301): 0 < s < secp256k1n ÷ 2 + 1, and for v in (302): v ∈ {27, 28}. Most\n // signatures from current libraries generate a unique signature with an s-value in the lower half order.\n //\n // If your library generates malleable signatures, such as s-values in the upper range, calculate a new s-value\n // with 0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFEBAAEDCE6AF48A03BBFD25E8CD0364141 - s1 and flip v from 27 to 28 or\n // vice versa. If your library also generates signatures with 0/1 for v instead 27/28, add 27 to v to accept\n // these malleable signatures as well.\n if (uint256(s) > 0x7FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF5D576E7357A4501DDFE92F46681B20A0) {\n return (address(0), RecoverError.InvalidSignatureS);\n }\n\n // If the signature is valid (and not malleable), return the signer address\n address signer = ecrecover(hash, v, r, s);\n if (signer == address(0)) {\n return (address(0), RecoverError.InvalidSignature);\n }\n\n return (signer, RecoverError.NoError);\n }\n\n /**\n * @dev Overload of {ECDSA-recover} that receives the `v`,\n * `r` and `s` signature fields separately.\n */\n function recover(bytes32 hash, uint8 v, bytes32 r, bytes32 s) internal pure returns (address) {\n (address recovered, RecoverError error) = tryRecover(hash, v, r, s);\n _throwError(error);\n return recovered;\n }\n\n /**\n * @dev Returns an Ethereum Signed Message, created from a `hash`. This\n * produces hash corresponding to the one signed with the\n * https://eth.wiki/json-rpc/API#eth_sign[`eth_sign`]\n * JSON-RPC method as part of EIP-191.\n *\n * See {recover}.\n */\n function toEthSignedMessageHash(bytes32 hash) internal pure returns (bytes32 message) {\n // 32 is the length in bytes of hash,\n // enforced by the type signature above\n /// @solidity memory-safe-assembly\n assembly {\n mstore(0x00, \"\\x19Ethereum Signed Message:\\n32\")\n mstore(0x1c, hash)\n message := keccak256(0x00, 0x3c)\n }\n }\n\n /**\n * @dev Returns an Ethereum Signed Message, created from `s`. This\n * produces hash corresponding to the one signed with the\n * https://eth.wiki/json-rpc/API#eth_sign[`eth_sign`]\n * JSON-RPC method as part of EIP-191.\n *\n * See {recover}.\n */\n function toEthSignedMessageHash(bytes memory s) internal pure returns (bytes32) {\n return keccak256(abi.encodePacked(\"\\x19Ethereum Signed Message:\\n\", StringsUpgradeable.toString(s.length), s));\n }\n\n /**\n * @dev Returns an Ethereum Signed Typed Data, created from a\n * `domainSeparator` and a `structHash`. This produces hash corresponding\n * to the one signed with the\n * https://eips.ethereum.org/EIPS/eip-712[`eth_signTypedData`]\n * JSON-RPC method as part of EIP-712.\n *\n * See {recover}.\n */\n function toTypedDataHash(bytes32 domainSeparator, bytes32 structHash) internal pure returns (bytes32 data) {\n /// @solidity memory-safe-assembly\n assembly {\n let ptr := mload(0x40)\n mstore(ptr, \"\\x19\\x01\")\n mstore(add(ptr, 0x02), domainSeparator)\n mstore(add(ptr, 0x22), structHash)\n data := keccak256(ptr, 0x42)\n }\n }\n\n /**\n * @dev Returns an Ethereum Signed Data with intended validator, created from a\n * `validator` and `data` according to the version 0 of EIP-191.\n *\n * See {recover}.\n */\n function toDataWithIntendedValidatorHash(address validator, bytes memory data) internal pure returns (bytes32) {\n return keccak256(abi.encodePacked(\"\\x19\\x00\", validator, data));\n }\n}\n"
+ },
+ "@openzeppelin/contracts-upgradeable/utils/math/MathUpgradeable.sol": {
+ "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (utils/math/Math.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @dev Standard math utilities missing in the Solidity language.\n */\nlibrary MathUpgradeable {\n enum Rounding {\n Down, // Toward negative infinity\n Up, // Toward infinity\n Zero // Toward zero\n }\n\n /**\n * @dev Returns the largest of two numbers.\n */\n function max(uint256 a, uint256 b) internal pure returns (uint256) {\n return a > b ? a : b;\n }\n\n /**\n * @dev Returns the smallest of two numbers.\n */\n function min(uint256 a, uint256 b) internal pure returns (uint256) {\n return a < b ? a : b;\n }\n\n /**\n * @dev Returns the average of two numbers. The result is rounded towards\n * zero.\n */\n function average(uint256 a, uint256 b) internal pure returns (uint256) {\n // (a + b) / 2 can overflow.\n return (a & b) + (a ^ b) / 2;\n }\n\n /**\n * @dev Returns the ceiling of the division of two numbers.\n *\n * This differs from standard division with `/` in that it rounds up instead\n * of rounding down.\n */\n function ceilDiv(uint256 a, uint256 b) internal pure returns (uint256) {\n // (a + b - 1) / b can overflow on addition, so we distribute.\n return a == 0 ? 0 : (a - 1) / b + 1;\n }\n\n /**\n * @notice Calculates floor(x * y / denominator) with full precision. Throws if result overflows a uint256 or denominator == 0\n * @dev Original credit to Remco Bloemen under MIT license (https://xn--2-umb.com/21/muldiv)\n * with further edits by Uniswap Labs also under MIT license.\n */\n function mulDiv(uint256 x, uint256 y, uint256 denominator) internal pure returns (uint256 result) {\n unchecked {\n // 512-bit multiply [prod1 prod0] = x * y. Compute the product mod 2^256 and mod 2^256 - 1, then use\n // use the Chinese Remainder Theorem to reconstruct the 512 bit result. The result is stored in two 256\n // variables such that product = prod1 * 2^256 + prod0.\n uint256 prod0; // Least significant 256 bits of the product\n uint256 prod1; // Most significant 256 bits of the product\n assembly {\n let mm := mulmod(x, y, not(0))\n prod0 := mul(x, y)\n prod1 := sub(sub(mm, prod0), lt(mm, prod0))\n }\n\n // Handle non-overflow cases, 256 by 256 division.\n if (prod1 == 0) {\n // Solidity will revert if denominator == 0, unlike the div opcode on its own.\n // The surrounding unchecked block does not change this fact.\n // See https://docs.soliditylang.org/en/latest/control-structures.html#checked-or-unchecked-arithmetic.\n return prod0 / denominator;\n }\n\n // Make sure the result is less than 2^256. Also prevents denominator == 0.\n require(denominator > prod1, \"Math: mulDiv overflow\");\n\n ///////////////////////////////////////////////\n // 512 by 256 division.\n ///////////////////////////////////////////////\n\n // Make division exact by subtracting the remainder from [prod1 prod0].\n uint256 remainder;\n assembly {\n // Compute remainder using mulmod.\n remainder := mulmod(x, y, denominator)\n\n // Subtract 256 bit number from 512 bit number.\n prod1 := sub(prod1, gt(remainder, prod0))\n prod0 := sub(prod0, remainder)\n }\n\n // Factor powers of two out of denominator and compute largest power of two divisor of denominator. Always >= 1.\n // See https://cs.stackexchange.com/q/138556/92363.\n\n // Does not overflow because the denominator cannot be zero at this stage in the function.\n uint256 twos = denominator & (~denominator + 1);\n assembly {\n // Divide denominator by twos.\n denominator := div(denominator, twos)\n\n // Divide [prod1 prod0] by twos.\n prod0 := div(prod0, twos)\n\n // Flip twos such that it is 2^256 / twos. If twos is zero, then it becomes one.\n twos := add(div(sub(0, twos), twos), 1)\n }\n\n // Shift in bits from prod1 into prod0.\n prod0 |= prod1 * twos;\n\n // Invert denominator mod 2^256. Now that denominator is an odd number, it has an inverse modulo 2^256 such\n // that denominator * inv = 1 mod 2^256. Compute the inverse by starting with a seed that is correct for\n // four bits. That is, denominator * inv = 1 mod 2^4.\n uint256 inverse = (3 * denominator) ^ 2;\n\n // Use the Newton-Raphson iteration to improve the precision. Thanks to Hensel's lifting lemma, this also works\n // in modular arithmetic, doubling the correct bits in each step.\n inverse *= 2 - denominator * inverse; // inverse mod 2^8\n inverse *= 2 - denominator * inverse; // inverse mod 2^16\n inverse *= 2 - denominator * inverse; // inverse mod 2^32\n inverse *= 2 - denominator * inverse; // inverse mod 2^64\n inverse *= 2 - denominator * inverse; // inverse mod 2^128\n inverse *= 2 - denominator * inverse; // inverse mod 2^256\n\n // Because the division is now exact we can divide by multiplying with the modular inverse of denominator.\n // This will give us the correct result modulo 2^256. Since the preconditions guarantee that the outcome is\n // less than 2^256, this is the final result. We don't need to compute the high bits of the result and prod1\n // is no longer required.\n result = prod0 * inverse;\n return result;\n }\n }\n\n /**\n * @notice Calculates x * y / denominator with full precision, following the selected rounding direction.\n */\n function mulDiv(uint256 x, uint256 y, uint256 denominator, Rounding rounding) internal pure returns (uint256) {\n uint256 result = mulDiv(x, y, denominator);\n if (rounding == Rounding.Up && mulmod(x, y, denominator) > 0) {\n result += 1;\n }\n return result;\n }\n\n /**\n * @dev Returns the square root of a number. If the number is not a perfect square, the value is rounded down.\n *\n * Inspired by Henry S. Warren, Jr.'s \"Hacker's Delight\" (Chapter 11).\n */\n function sqrt(uint256 a) internal pure returns (uint256) {\n if (a == 0) {\n return 0;\n }\n\n // For our first guess, we get the biggest power of 2 which is smaller than the square root of the target.\n //\n // We know that the \"msb\" (most significant bit) of our target number `a` is a power of 2 such that we have\n // `msb(a) <= a < 2*msb(a)`. This value can be written `msb(a)=2**k` with `k=log2(a)`.\n //\n // This can be rewritten `2**log2(a) <= a < 2**(log2(a) + 1)`\n // → `sqrt(2**k) <= sqrt(a) < sqrt(2**(k+1))`\n // → `2**(k/2) <= sqrt(a) < 2**((k+1)/2) <= 2**(k/2 + 1)`\n //\n // Consequently, `2**(log2(a) / 2)` is a good first approximation of `sqrt(a)` with at least 1 correct bit.\n uint256 result = 1 << (log2(a) >> 1);\n\n // At this point `result` is an estimation with one bit of precision. We know the true value is a uint128,\n // since it is the square root of a uint256. Newton's method converges quadratically (precision doubles at\n // every iteration). We thus need at most 7 iteration to turn our partial result with one bit of precision\n // into the expected uint128 result.\n unchecked {\n result = (result + a / result) >> 1;\n result = (result + a / result) >> 1;\n result = (result + a / result) >> 1;\n result = (result + a / result) >> 1;\n result = (result + a / result) >> 1;\n result = (result + a / result) >> 1;\n result = (result + a / result) >> 1;\n return min(result, a / result);\n }\n }\n\n /**\n * @notice Calculates sqrt(a), following the selected rounding direction.\n */\n function sqrt(uint256 a, Rounding rounding) internal pure returns (uint256) {\n unchecked {\n uint256 result = sqrt(a);\n return result + (rounding == Rounding.Up && result * result < a ? 1 : 0);\n }\n }\n\n /**\n * @dev Return the log in base 2, rounded down, of a positive value.\n * Returns 0 if given 0.\n */\n function log2(uint256 value) internal pure returns (uint256) {\n uint256 result = 0;\n unchecked {\n if (value >> 128 > 0) {\n value >>= 128;\n result += 128;\n }\n if (value >> 64 > 0) {\n value >>= 64;\n result += 64;\n }\n if (value >> 32 > 0) {\n value >>= 32;\n result += 32;\n }\n if (value >> 16 > 0) {\n value >>= 16;\n result += 16;\n }\n if (value >> 8 > 0) {\n value >>= 8;\n result += 8;\n }\n if (value >> 4 > 0) {\n value >>= 4;\n result += 4;\n }\n if (value >> 2 > 0) {\n value >>= 2;\n result += 2;\n }\n if (value >> 1 > 0) {\n result += 1;\n }\n }\n return result;\n }\n\n /**\n * @dev Return the log in base 2, following the selected rounding direction, of a positive value.\n * Returns 0 if given 0.\n */\n function log2(uint256 value, Rounding rounding) internal pure returns (uint256) {\n unchecked {\n uint256 result = log2(value);\n return result + (rounding == Rounding.Up && 1 << result < value ? 1 : 0);\n }\n }\n\n /**\n * @dev Return the log in base 10, rounded down, of a positive value.\n * Returns 0 if given 0.\n */\n function log10(uint256 value) internal pure returns (uint256) {\n uint256 result = 0;\n unchecked {\n if (value >= 10 ** 64) {\n value /= 10 ** 64;\n result += 64;\n }\n if (value >= 10 ** 32) {\n value /= 10 ** 32;\n result += 32;\n }\n if (value >= 10 ** 16) {\n value /= 10 ** 16;\n result += 16;\n }\n if (value >= 10 ** 8) {\n value /= 10 ** 8;\n result += 8;\n }\n if (value >= 10 ** 4) {\n value /= 10 ** 4;\n result += 4;\n }\n if (value >= 10 ** 2) {\n value /= 10 ** 2;\n result += 2;\n }\n if (value >= 10 ** 1) {\n result += 1;\n }\n }\n return result;\n }\n\n /**\n * @dev Return the log in base 10, following the selected rounding direction, of a positive value.\n * Returns 0 if given 0.\n */\n function log10(uint256 value, Rounding rounding) internal pure returns (uint256) {\n unchecked {\n uint256 result = log10(value);\n return result + (rounding == Rounding.Up && 10 ** result < value ? 1 : 0);\n }\n }\n\n /**\n * @dev Return the log in base 256, rounded down, of a positive value.\n * Returns 0 if given 0.\n *\n * Adding one to the result gives the number of pairs of hex symbols needed to represent `value` as a hex string.\n */\n function log256(uint256 value) internal pure returns (uint256) {\n uint256 result = 0;\n unchecked {\n if (value >> 128 > 0) {\n value >>= 128;\n result += 16;\n }\n if (value >> 64 > 0) {\n value >>= 64;\n result += 8;\n }\n if (value >> 32 > 0) {\n value >>= 32;\n result += 4;\n }\n if (value >> 16 > 0) {\n value >>= 16;\n result += 2;\n }\n if (value >> 8 > 0) {\n result += 1;\n }\n }\n return result;\n }\n\n /**\n * @dev Return the log in base 256, following the selected rounding direction, of a positive value.\n * Returns 0 if given 0.\n */\n function log256(uint256 value, Rounding rounding) internal pure returns (uint256) {\n unchecked {\n uint256 result = log256(value);\n return result + (rounding == Rounding.Up && 1 << (result << 3) < value ? 1 : 0);\n }\n }\n}\n"
+ },
+ "@openzeppelin/contracts-upgradeable/utils/math/SignedMathUpgradeable.sol": {
+ "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.8.0) (utils/math/SignedMath.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @dev Standard signed math utilities missing in the Solidity language.\n */\nlibrary SignedMathUpgradeable {\n /**\n * @dev Returns the largest of two signed numbers.\n */\n function max(int256 a, int256 b) internal pure returns (int256) {\n return a > b ? a : b;\n }\n\n /**\n * @dev Returns the smallest of two signed numbers.\n */\n function min(int256 a, int256 b) internal pure returns (int256) {\n return a < b ? a : b;\n }\n\n /**\n * @dev Returns the average of two signed numbers without overflow.\n * The result is rounded towards zero.\n */\n function average(int256 a, int256 b) internal pure returns (int256) {\n // Formula from the book \"Hacker's Delight\"\n int256 x = (a & b) + ((a ^ b) >> 1);\n return x + (int256(uint256(x) >> 255) & (a ^ b));\n }\n\n /**\n * @dev Returns the absolute unsigned value of a signed value.\n */\n function abs(int256 n) internal pure returns (uint256) {\n unchecked {\n // must be unchecked in order to support `n = type(int256).min`\n return uint256(n >= 0 ? n : -n);\n }\n }\n}\n"
+ },
+ "@openzeppelin/contracts-upgradeable/utils/StorageSlotUpgradeable.sol": {
+ "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (utils/StorageSlot.sol)\n// This file was procedurally generated from scripts/generate/templates/StorageSlot.js.\n\npragma solidity ^0.8.0;\n\n/**\n * @dev Library for reading and writing primitive types to specific storage slots.\n *\n * Storage slots are often used to avoid storage conflict when dealing with upgradeable contracts.\n * This library helps with reading and writing to such slots without the need for inline assembly.\n *\n * The functions in this library return Slot structs that contain a `value` member that can be used to read or write.\n *\n * Example usage to set ERC1967 implementation slot:\n * ```solidity\n * contract ERC1967 {\n * bytes32 internal constant _IMPLEMENTATION_SLOT = 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc;\n *\n * function _getImplementation() internal view returns (address) {\n * return StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value;\n * }\n *\n * function _setImplementation(address newImplementation) internal {\n * require(Address.isContract(newImplementation), \"ERC1967: new implementation is not a contract\");\n * StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value = newImplementation;\n * }\n * }\n * ```\n *\n * _Available since v4.1 for `address`, `bool`, `bytes32`, `uint256`._\n * _Available since v4.9 for `string`, `bytes`._\n */\nlibrary StorageSlotUpgradeable {\n struct AddressSlot {\n address value;\n }\n\n struct BooleanSlot {\n bool value;\n }\n\n struct Bytes32Slot {\n bytes32 value;\n }\n\n struct Uint256Slot {\n uint256 value;\n }\n\n struct StringSlot {\n string value;\n }\n\n struct BytesSlot {\n bytes value;\n }\n\n /**\n * @dev Returns an `AddressSlot` with member `value` located at `slot`.\n */\n function getAddressSlot(bytes32 slot) internal pure returns (AddressSlot storage r) {\n /// @solidity memory-safe-assembly\n assembly {\n r.slot := slot\n }\n }\n\n /**\n * @dev Returns an `BooleanSlot` with member `value` located at `slot`.\n */\n function getBooleanSlot(bytes32 slot) internal pure returns (BooleanSlot storage r) {\n /// @solidity memory-safe-assembly\n assembly {\n r.slot := slot\n }\n }\n\n /**\n * @dev Returns an `Bytes32Slot` with member `value` located at `slot`.\n */\n function getBytes32Slot(bytes32 slot) internal pure returns (Bytes32Slot storage r) {\n /// @solidity memory-safe-assembly\n assembly {\n r.slot := slot\n }\n }\n\n /**\n * @dev Returns an `Uint256Slot` with member `value` located at `slot`.\n */\n function getUint256Slot(bytes32 slot) internal pure returns (Uint256Slot storage r) {\n /// @solidity memory-safe-assembly\n assembly {\n r.slot := slot\n }\n }\n\n /**\n * @dev Returns an `StringSlot` with member `value` located at `slot`.\n */\n function getStringSlot(bytes32 slot) internal pure returns (StringSlot storage r) {\n /// @solidity memory-safe-assembly\n assembly {\n r.slot := slot\n }\n }\n\n /**\n * @dev Returns an `StringSlot` representation of the string storage pointer `store`.\n */\n function getStringSlot(string storage store) internal pure returns (StringSlot storage r) {\n /// @solidity memory-safe-assembly\n assembly {\n r.slot := store.slot\n }\n }\n\n /**\n * @dev Returns an `BytesSlot` with member `value` located at `slot`.\n */\n function getBytesSlot(bytes32 slot) internal pure returns (BytesSlot storage r) {\n /// @solidity memory-safe-assembly\n assembly {\n r.slot := slot\n }\n }\n\n /**\n * @dev Returns an `BytesSlot` representation of the bytes storage pointer `store`.\n */\n function getBytesSlot(bytes storage store) internal pure returns (BytesSlot storage r) {\n /// @solidity memory-safe-assembly\n assembly {\n r.slot := store.slot\n }\n }\n}\n"
+ },
+ "@openzeppelin/contracts-upgradeable/utils/StringsUpgradeable.sol": {
+ "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (utils/Strings.sol)\n\npragma solidity ^0.8.0;\n\nimport \"./math/MathUpgradeable.sol\";\nimport \"./math/SignedMathUpgradeable.sol\";\n\n/**\n * @dev String operations.\n */\nlibrary StringsUpgradeable {\n bytes16 private constant _SYMBOLS = \"0123456789abcdef\";\n uint8 private constant _ADDRESS_LENGTH = 20;\n\n /**\n * @dev Converts a `uint256` to its ASCII `string` decimal representation.\n */\n function toString(uint256 value) internal pure returns (string memory) {\n unchecked {\n uint256 length = MathUpgradeable.log10(value) + 1;\n string memory buffer = new string(length);\n uint256 ptr;\n /// @solidity memory-safe-assembly\n assembly {\n ptr := add(buffer, add(32, length))\n }\n while (true) {\n ptr--;\n /// @solidity memory-safe-assembly\n assembly {\n mstore8(ptr, byte(mod(value, 10), _SYMBOLS))\n }\n value /= 10;\n if (value == 0) break;\n }\n return buffer;\n }\n }\n\n /**\n * @dev Converts a `int256` to its ASCII `string` decimal representation.\n */\n function toString(int256 value) internal pure returns (string memory) {\n return string(abi.encodePacked(value < 0 ? \"-\" : \"\", toString(SignedMathUpgradeable.abs(value))));\n }\n\n /**\n * @dev Converts a `uint256` to its ASCII `string` hexadecimal representation.\n */\n function toHexString(uint256 value) internal pure returns (string memory) {\n unchecked {\n return toHexString(value, MathUpgradeable.log256(value) + 1);\n }\n }\n\n /**\n * @dev Converts a `uint256` to its ASCII `string` hexadecimal representation with fixed length.\n */\n function toHexString(uint256 value, uint256 length) internal pure returns (string memory) {\n bytes memory buffer = new bytes(2 * length + 2);\n buffer[0] = \"0\";\n buffer[1] = \"x\";\n for (uint256 i = 2 * length + 1; i > 1; --i) {\n buffer[i] = _SYMBOLS[value & 0xf];\n value >>= 4;\n }\n require(value == 0, \"Strings: hex length insufficient\");\n return string(buffer);\n }\n\n /**\n * @dev Converts an `address` with fixed length of 20 bytes to its not checksummed ASCII `string` hexadecimal representation.\n */\n function toHexString(address addr) internal pure returns (string memory) {\n return toHexString(uint256(uint160(addr)), _ADDRESS_LENGTH);\n }\n\n /**\n * @dev Returns true if the two strings are equal.\n */\n function equal(string memory a, string memory b) internal pure returns (bool) {\n return keccak256(bytes(a)) == keccak256(bytes(b));\n }\n}\n"
+ },
+ "@openzeppelin/contracts-upgradeable/vendor/optimism/ICrossDomainMessengerUpgradeable.sol": {
+ "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (vendor/optimism/ICrossDomainMessenger.sol)\npragma solidity >0.5.0 <0.9.0;\n\n/**\n * @title ICrossDomainMessenger\n */\ninterface ICrossDomainMessengerUpgradeable {\n /**********\n * Events *\n **********/\n\n event SentMessage(address indexed target, address sender, bytes message, uint256 messageNonce, uint256 gasLimit);\n event RelayedMessage(bytes32 indexed msgHash);\n event FailedRelayedMessage(bytes32 indexed msgHash);\n\n /*************\n * Variables *\n *************/\n\n function xDomainMessageSender() external view returns (address);\n\n /********************\n * Public Functions *\n ********************/\n\n /**\n * Sends a cross domain message to the target messenger.\n * @param _target Target contract address.\n * @param _message Message to send to the target.\n * @param _gasLimit Gas limit for the provided message.\n */\n function sendMessage(address _target, bytes calldata _message, uint32 _gasLimit) external;\n}\n"
+ },
+ "@openzeppelin/contracts/interfaces/IERC1271.sol": {
+ "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts v4.4.1 (interfaces/IERC1271.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @dev Interface of the ERC1271 standard signature validation method for\n * contracts as defined in https://eips.ethereum.org/EIPS/eip-1271[ERC-1271].\n *\n * _Available since v4.1._\n */\ninterface IERC1271 {\n /**\n * @dev Should return whether the signature provided is valid for the provided data\n * @param hash Hash of the data to be signed\n * @param signature Signature byte array associated with _data\n */\n function isValidSignature(bytes32 hash, bytes memory signature) external view returns (bytes4 magicValue);\n}\n"
+ },
+ "@openzeppelin/contracts/token/ERC20/extensions/IERC20Permit.sol": {
+ "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.4) (token/ERC20/extensions/IERC20Permit.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @dev Interface of the ERC20 Permit extension allowing approvals to be made via signatures, as defined in\n * https://eips.ethereum.org/EIPS/eip-2612[EIP-2612].\n *\n * Adds the {permit} method, which can be used to change an account's ERC20 allowance (see {IERC20-allowance}) by\n * presenting a message signed by the account. By not relying on {IERC20-approve}, the token holder account doesn't\n * need to send a transaction, and thus is not required to hold Ether at all.\n *\n * ==== Security Considerations\n *\n * There are two important considerations concerning the use of `permit`. The first is that a valid permit signature\n * expresses an allowance, and it should not be assumed to convey additional meaning. In particular, it should not be\n * considered as an intention to spend the allowance in any specific way. The second is that because permits have\n * built-in replay protection and can be submitted by anyone, they can be frontrun. A protocol that uses permits should\n * take this into consideration and allow a `permit` call to fail. Combining these two aspects, a pattern that may be\n * generally recommended is:\n *\n * ```solidity\n * function doThingWithPermit(..., uint256 value, uint256 deadline, uint8 v, bytes32 r, bytes32 s) public {\n * try token.permit(msg.sender, address(this), value, deadline, v, r, s) {} catch {}\n * doThing(..., value);\n * }\n *\n * function doThing(..., uint256 value) public {\n * token.safeTransferFrom(msg.sender, address(this), value);\n * ...\n * }\n * ```\n *\n * Observe that: 1) `msg.sender` is used as the owner, leaving no ambiguity as to the signer intent, and 2) the use of\n * `try/catch` allows the permit to fail and makes the code tolerant to frontrunning. (See also\n * {SafeERC20-safeTransferFrom}).\n *\n * Additionally, note that smart contract wallets (such as Argent or Safe) are not able to produce permit signatures, so\n * contracts should have entry points that don't rely on permit.\n */\ninterface IERC20Permit {\n /**\n * @dev Sets `value` as the allowance of `spender` over ``owner``'s tokens,\n * given ``owner``'s signed approval.\n *\n * IMPORTANT: The same issues {IERC20-approve} has related to transaction\n * ordering also apply here.\n *\n * Emits an {Approval} event.\n *\n * Requirements:\n *\n * - `spender` cannot be the zero address.\n * - `deadline` must be a timestamp in the future.\n * - `v`, `r` and `s` must be a valid `secp256k1` signature from `owner`\n * over the EIP712-formatted function arguments.\n * - the signature must use ``owner``'s current nonce (see {nonces}).\n *\n * For more information on the signature format, see the\n * https://eips.ethereum.org/EIPS/eip-2612#specification[relevant EIP\n * section].\n *\n * CAUTION: See Security Considerations above.\n */\n function permit(\n address owner,\n address spender,\n uint256 value,\n uint256 deadline,\n uint8 v,\n bytes32 r,\n bytes32 s\n ) external;\n\n /**\n * @dev Returns the current nonce for `owner`. This value must be\n * included whenever a signature is generated for {permit}.\n *\n * Every successful call to {permit} increases ``owner``'s nonce by one. This\n * prevents a signature from being used multiple times.\n */\n function nonces(address owner) external view returns (uint256);\n\n /**\n * @dev Returns the domain separator used in the encoding of the signature for {permit}, as defined by {EIP712}.\n */\n // solhint-disable-next-line func-name-mixedcase\n function DOMAIN_SEPARATOR() external view returns (bytes32);\n}\n"
+ },
+ "@openzeppelin/contracts/token/ERC20/IERC20.sol": {
+ "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (token/ERC20/IERC20.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @dev Interface of the ERC20 standard as defined in the EIP.\n */\ninterface IERC20 {\n /**\n * @dev Emitted when `value` tokens are moved from one account (`from`) to\n * another (`to`).\n *\n * Note that `value` may be zero.\n */\n event Transfer(address indexed from, address indexed to, uint256 value);\n\n /**\n * @dev Emitted when the allowance of a `spender` for an `owner` is set by\n * a call to {approve}. `value` is the new allowance.\n */\n event Approval(address indexed owner, address indexed spender, uint256 value);\n\n /**\n * @dev Returns the amount of tokens in existence.\n */\n function totalSupply() external view returns (uint256);\n\n /**\n * @dev Returns the amount of tokens owned by `account`.\n */\n function balanceOf(address account) external view returns (uint256);\n\n /**\n * @dev Moves `amount` tokens from the caller's account to `to`.\n *\n * Returns a boolean value indicating whether the operation succeeded.\n *\n * Emits a {Transfer} event.\n */\n function transfer(address to, uint256 amount) external returns (bool);\n\n /**\n * @dev Returns the remaining number of tokens that `spender` will be\n * allowed to spend on behalf of `owner` through {transferFrom}. This is\n * zero by default.\n *\n * This value changes when {approve} or {transferFrom} are called.\n */\n function allowance(address owner, address spender) external view returns (uint256);\n\n /**\n * @dev Sets `amount` as the allowance of `spender` over the caller's tokens.\n *\n * Returns a boolean value indicating whether the operation succeeded.\n *\n * IMPORTANT: Beware that changing an allowance with this method brings the risk\n * that someone may use both the old and the new allowance by unfortunate\n * transaction ordering. One possible solution to mitigate this race\n * condition is to first reduce the spender's allowance to 0 and set the\n * desired value afterwards:\n * https://github.com/ethereum/EIPs/issues/20#issuecomment-263524729\n *\n * Emits an {Approval} event.\n */\n function approve(address spender, uint256 amount) external returns (bool);\n\n /**\n * @dev Moves `amount` tokens from `from` to `to` using the\n * allowance mechanism. `amount` is then deducted from the caller's\n * allowance.\n *\n * Returns a boolean value indicating whether the operation succeeded.\n *\n * Emits a {Transfer} event.\n */\n function transferFrom(address from, address to, uint256 amount) external returns (bool);\n}\n"
+ },
+ "@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol": {
+ "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.3) (token/ERC20/utils/SafeERC20.sol)\n\npragma solidity ^0.8.0;\n\nimport \"../IERC20.sol\";\nimport \"../extensions/IERC20Permit.sol\";\nimport \"../../../utils/Address.sol\";\n\n/**\n * @title SafeERC20\n * @dev Wrappers around ERC20 operations that throw on failure (when the token\n * contract returns false). Tokens that return no value (and instead revert or\n * throw on failure) are also supported, non-reverting calls are assumed to be\n * successful.\n * To use this library you can add a `using SafeERC20 for IERC20;` statement to your contract,\n * which allows you to call the safe operations as `token.safeTransfer(...)`, etc.\n */\nlibrary SafeERC20 {\n using Address for address;\n\n /**\n * @dev Transfer `value` amount of `token` from the calling contract to `to`. If `token` returns no value,\n * non-reverting calls are assumed to be successful.\n */\n function safeTransfer(IERC20 token, address to, uint256 value) internal {\n _callOptionalReturn(token, abi.encodeWithSelector(token.transfer.selector, to, value));\n }\n\n /**\n * @dev Transfer `value` amount of `token` from `from` to `to`, spending the approval given by `from` to the\n * calling contract. If `token` returns no value, non-reverting calls are assumed to be successful.\n */\n function safeTransferFrom(IERC20 token, address from, address to, uint256 value) internal {\n _callOptionalReturn(token, abi.encodeWithSelector(token.transferFrom.selector, from, to, value));\n }\n\n /**\n * @dev Deprecated. This function has issues similar to the ones found in\n * {IERC20-approve}, and its usage is discouraged.\n *\n * Whenever possible, use {safeIncreaseAllowance} and\n * {safeDecreaseAllowance} instead.\n */\n function safeApprove(IERC20 token, address spender, uint256 value) internal {\n // safeApprove should only be called when setting an initial allowance,\n // or when resetting it to zero. To increase and decrease it, use\n // 'safeIncreaseAllowance' and 'safeDecreaseAllowance'\n require(\n (value == 0) || (token.allowance(address(this), spender) == 0),\n \"SafeERC20: approve from non-zero to non-zero allowance\"\n );\n _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, value));\n }\n\n /**\n * @dev Increase the calling contract's allowance toward `spender` by `value`. If `token` returns no value,\n * non-reverting calls are assumed to be successful.\n */\n function safeIncreaseAllowance(IERC20 token, address spender, uint256 value) internal {\n uint256 oldAllowance = token.allowance(address(this), spender);\n _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, oldAllowance + value));\n }\n\n /**\n * @dev Decrease the calling contract's allowance toward `spender` by `value`. If `token` returns no value,\n * non-reverting calls are assumed to be successful.\n */\n function safeDecreaseAllowance(IERC20 token, address spender, uint256 value) internal {\n unchecked {\n uint256 oldAllowance = token.allowance(address(this), spender);\n require(oldAllowance >= value, \"SafeERC20: decreased allowance below zero\");\n _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, oldAllowance - value));\n }\n }\n\n /**\n * @dev Set the calling contract's allowance toward `spender` to `value`. If `token` returns no value,\n * non-reverting calls are assumed to be successful. Meant to be used with tokens that require the approval\n * to be set to zero before setting it to a non-zero value, such as USDT.\n */\n function forceApprove(IERC20 token, address spender, uint256 value) internal {\n bytes memory approvalCall = abi.encodeWithSelector(token.approve.selector, spender, value);\n\n if (!_callOptionalReturnBool(token, approvalCall)) {\n _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, 0));\n _callOptionalReturn(token, approvalCall);\n }\n }\n\n /**\n * @dev Use a ERC-2612 signature to set the `owner` approval toward `spender` on `token`.\n * Revert on invalid signature.\n */\n function safePermit(\n IERC20Permit token,\n address owner,\n address spender,\n uint256 value,\n uint256 deadline,\n uint8 v,\n bytes32 r,\n bytes32 s\n ) internal {\n uint256 nonceBefore = token.nonces(owner);\n token.permit(owner, spender, value, deadline, v, r, s);\n uint256 nonceAfter = token.nonces(owner);\n require(nonceAfter == nonceBefore + 1, \"SafeERC20: permit did not succeed\");\n }\n\n /**\n * @dev Imitates a Solidity high-level call (i.e. a regular function call to a contract), relaxing the requirement\n * on the return value: the return value is optional (but if data is returned, it must not be false).\n * @param token The token targeted by the call.\n * @param data The call data (encoded using abi.encode or one of its variants).\n */\n function _callOptionalReturn(IERC20 token, bytes memory data) private {\n // We need to perform a low level call here, to bypass Solidity's return data size checking mechanism, since\n // we're implementing it ourselves. We use {Address-functionCall} to perform this call, which verifies that\n // the target address contains contract code and also asserts for success in the low-level call.\n\n bytes memory returndata = address(token).functionCall(data, \"SafeERC20: low-level call failed\");\n require(returndata.length == 0 || abi.decode(returndata, (bool)), \"SafeERC20: ERC20 operation did not succeed\");\n }\n\n /**\n * @dev Imitates a Solidity high-level call (i.e. a regular function call to a contract), relaxing the requirement\n * on the return value: the return value is optional (but if data is returned, it must not be false).\n * @param token The token targeted by the call.\n * @param data The call data (encoded using abi.encode or one of its variants).\n *\n * This is a variant of {_callOptionalReturn} that silents catches all reverts and returns a bool instead.\n */\n function _callOptionalReturnBool(IERC20 token, bytes memory data) private returns (bool) {\n // We need to perform a low level call here, to bypass Solidity's return data size checking mechanism, since\n // we're implementing it ourselves. We cannot use {Address-functionCall} here since this should return false\n // and not revert is the subcall reverts.\n\n (bool success, bytes memory returndata) = address(token).call(data);\n return\n success && (returndata.length == 0 || abi.decode(returndata, (bool))) && Address.isContract(address(token));\n }\n}\n"
+ },
+ "@openzeppelin/contracts/utils/Address.sol": {
+ "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (utils/Address.sol)\n\npragma solidity ^0.8.1;\n\n/**\n * @dev Collection of functions related to the address type\n */\nlibrary Address {\n /**\n * @dev Returns true if `account` is a contract.\n *\n * [IMPORTANT]\n * ====\n * It is unsafe to assume that an address for which this function returns\n * false is an externally-owned account (EOA) and not a contract.\n *\n * Among others, `isContract` will return false for the following\n * types of addresses:\n *\n * - an externally-owned account\n * - a contract in construction\n * - an address where a contract will be created\n * - an address where a contract lived, but was destroyed\n *\n * Furthermore, `isContract` will also return true if the target contract within\n * the same transaction is already scheduled for destruction by `SELFDESTRUCT`,\n * which only has an effect at the end of a transaction.\n * ====\n *\n * [IMPORTANT]\n * ====\n * You shouldn't rely on `isContract` to protect against flash loan attacks!\n *\n * Preventing calls from contracts is highly discouraged. It breaks composability, breaks support for smart wallets\n * like Gnosis Safe, and does not provide security since it can be circumvented by calling from a contract\n * constructor.\n * ====\n */\n function isContract(address account) internal view returns (bool) {\n // This method relies on extcodesize/address.code.length, which returns 0\n // for contracts in construction, since the code is only stored at the end\n // of the constructor execution.\n\n return account.code.length > 0;\n }\n\n /**\n * @dev Replacement for Solidity's `transfer`: sends `amount` wei to\n * `recipient`, forwarding all available gas and reverting on errors.\n *\n * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost\n * of certain opcodes, possibly making contracts go over the 2300 gas limit\n * imposed by `transfer`, making them unable to receive funds via\n * `transfer`. {sendValue} removes this limitation.\n *\n * https://consensys.net/diligence/blog/2019/09/stop-using-soliditys-transfer-now/[Learn more].\n *\n * IMPORTANT: because control is transferred to `recipient`, care must be\n * taken to not create reentrancy vulnerabilities. Consider using\n * {ReentrancyGuard} or the\n * https://solidity.readthedocs.io/en/v0.8.0/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].\n */\n function sendValue(address payable recipient, uint256 amount) internal {\n require(address(this).balance >= amount, \"Address: insufficient balance\");\n\n (bool success, ) = recipient.call{value: amount}(\"\");\n require(success, \"Address: unable to send value, recipient may have reverted\");\n }\n\n /**\n * @dev Performs a Solidity function call using a low level `call`. A\n * plain `call` is an unsafe replacement for a function call: use this\n * function instead.\n *\n * If `target` reverts with a revert reason, it is bubbled up by this\n * function (like regular Solidity function calls).\n *\n * Returns the raw returned data. To convert to the expected return value,\n * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].\n *\n * Requirements:\n *\n * - `target` must be a contract.\n * - calling `target` with `data` must not revert.\n *\n * _Available since v3.1._\n */\n function functionCall(address target, bytes memory data) internal returns (bytes memory) {\n return functionCallWithValue(target, data, 0, \"Address: low-level call failed\");\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with\n * `errorMessage` as a fallback revert reason when `target` reverts.\n *\n * _Available since v3.1._\n */\n function functionCall(\n address target,\n bytes memory data,\n string memory errorMessage\n ) internal returns (bytes memory) {\n return functionCallWithValue(target, data, 0, errorMessage);\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\n * but also transferring `value` wei to `target`.\n *\n * Requirements:\n *\n * - the calling contract must have an ETH balance of at least `value`.\n * - the called Solidity function must be `payable`.\n *\n * _Available since v3.1._\n */\n function functionCallWithValue(address target, bytes memory data, uint256 value) internal returns (bytes memory) {\n return functionCallWithValue(target, data, value, \"Address: low-level call with value failed\");\n }\n\n /**\n * @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but\n * with `errorMessage` as a fallback revert reason when `target` reverts.\n *\n * _Available since v3.1._\n */\n function functionCallWithValue(\n address target,\n bytes memory data,\n uint256 value,\n string memory errorMessage\n ) internal returns (bytes memory) {\n require(address(this).balance >= value, \"Address: insufficient balance for call\");\n (bool success, bytes memory returndata) = target.call{value: value}(data);\n return verifyCallResultFromTarget(target, success, returndata, errorMessage);\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\n * but performing a static call.\n *\n * _Available since v3.3._\n */\n function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {\n return functionStaticCall(target, data, \"Address: low-level static call failed\");\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],\n * but performing a static call.\n *\n * _Available since v3.3._\n */\n function functionStaticCall(\n address target,\n bytes memory data,\n string memory errorMessage\n ) internal view returns (bytes memory) {\n (bool success, bytes memory returndata) = target.staticcall(data);\n return verifyCallResultFromTarget(target, success, returndata, errorMessage);\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\n * but performing a delegate call.\n *\n * _Available since v3.4._\n */\n function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) {\n return functionDelegateCall(target, data, \"Address: low-level delegate call failed\");\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],\n * but performing a delegate call.\n *\n * _Available since v3.4._\n */\n function functionDelegateCall(\n address target,\n bytes memory data,\n string memory errorMessage\n ) internal returns (bytes memory) {\n (bool success, bytes memory returndata) = target.delegatecall(data);\n return verifyCallResultFromTarget(target, success, returndata, errorMessage);\n }\n\n /**\n * @dev Tool to verify that a low level call to smart-contract was successful, and revert (either by bubbling\n * the revert reason or using the provided one) in case of unsuccessful call or if target was not a contract.\n *\n * _Available since v4.8._\n */\n function verifyCallResultFromTarget(\n address target,\n bool success,\n bytes memory returndata,\n string memory errorMessage\n ) internal view returns (bytes memory) {\n if (success) {\n if (returndata.length == 0) {\n // only check isContract if the call was successful and the return data is empty\n // otherwise we already know that it was a contract\n require(isContract(target), \"Address: call to non-contract\");\n }\n return returndata;\n } else {\n _revert(returndata, errorMessage);\n }\n }\n\n /**\n * @dev Tool to verify that a low level call was successful, and revert if it wasn't, either by bubbling the\n * revert reason or using the provided one.\n *\n * _Available since v4.3._\n */\n function verifyCallResult(\n bool success,\n bytes memory returndata,\n string memory errorMessage\n ) internal pure returns (bytes memory) {\n if (success) {\n return returndata;\n } else {\n _revert(returndata, errorMessage);\n }\n }\n\n function _revert(bytes memory returndata, string memory errorMessage) private pure {\n // Look for revert reason and bubble it up if present\n if (returndata.length > 0) {\n // The easiest way to bubble the revert reason is using memory via assembly\n /// @solidity memory-safe-assembly\n assembly {\n let returndata_size := mload(returndata)\n revert(add(32, returndata), returndata_size)\n }\n } else {\n revert(errorMessage);\n }\n }\n}\n"
+ },
+ "@openzeppelin/contracts/utils/cryptography/ECDSA.sol": {
+ "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (utils/cryptography/ECDSA.sol)\n\npragma solidity ^0.8.0;\n\nimport \"../Strings.sol\";\n\n/**\n * @dev Elliptic Curve Digital Signature Algorithm (ECDSA) operations.\n *\n * These functions can be used to verify that a message was signed by the holder\n * of the private keys of a given address.\n */\nlibrary ECDSA {\n enum RecoverError {\n NoError,\n InvalidSignature,\n InvalidSignatureLength,\n InvalidSignatureS,\n InvalidSignatureV // Deprecated in v4.8\n }\n\n function _throwError(RecoverError error) private pure {\n if (error == RecoverError.NoError) {\n return; // no error: do nothing\n } else if (error == RecoverError.InvalidSignature) {\n revert(\"ECDSA: invalid signature\");\n } else if (error == RecoverError.InvalidSignatureLength) {\n revert(\"ECDSA: invalid signature length\");\n } else if (error == RecoverError.InvalidSignatureS) {\n revert(\"ECDSA: invalid signature 's' value\");\n }\n }\n\n /**\n * @dev Returns the address that signed a hashed message (`hash`) with\n * `signature` or error string. This address can then be used for verification purposes.\n *\n * The `ecrecover` EVM opcode allows for malleable (non-unique) signatures:\n * this function rejects them by requiring the `s` value to be in the lower\n * half order, and the `v` value to be either 27 or 28.\n *\n * IMPORTANT: `hash` _must_ be the result of a hash operation for the\n * verification to be secure: it is possible to craft signatures that\n * recover to arbitrary addresses for non-hashed data. A safe way to ensure\n * this is by receiving a hash of the original message (which may otherwise\n * be too long), and then calling {toEthSignedMessageHash} on it.\n *\n * Documentation for signature generation:\n * - with https://web3js.readthedocs.io/en/v1.3.4/web3-eth-accounts.html#sign[Web3.js]\n * - with https://docs.ethers.io/v5/api/signer/#Signer-signMessage[ethers]\n *\n * _Available since v4.3._\n */\n function tryRecover(bytes32 hash, bytes memory signature) internal pure returns (address, RecoverError) {\n if (signature.length == 65) {\n bytes32 r;\n bytes32 s;\n uint8 v;\n // ecrecover takes the signature parameters, and the only way to get them\n // currently is to use assembly.\n /// @solidity memory-safe-assembly\n assembly {\n r := mload(add(signature, 0x20))\n s := mload(add(signature, 0x40))\n v := byte(0, mload(add(signature, 0x60)))\n }\n return tryRecover(hash, v, r, s);\n } else {\n return (address(0), RecoverError.InvalidSignatureLength);\n }\n }\n\n /**\n * @dev Returns the address that signed a hashed message (`hash`) with\n * `signature`. This address can then be used for verification purposes.\n *\n * The `ecrecover` EVM opcode allows for malleable (non-unique) signatures:\n * this function rejects them by requiring the `s` value to be in the lower\n * half order, and the `v` value to be either 27 or 28.\n *\n * IMPORTANT: `hash` _must_ be the result of a hash operation for the\n * verification to be secure: it is possible to craft signatures that\n * recover to arbitrary addresses for non-hashed data. A safe way to ensure\n * this is by receiving a hash of the original message (which may otherwise\n * be too long), and then calling {toEthSignedMessageHash} on it.\n */\n function recover(bytes32 hash, bytes memory signature) internal pure returns (address) {\n (address recovered, RecoverError error) = tryRecover(hash, signature);\n _throwError(error);\n return recovered;\n }\n\n /**\n * @dev Overload of {ECDSA-tryRecover} that receives the `r` and `vs` short-signature fields separately.\n *\n * See https://eips.ethereum.org/EIPS/eip-2098[EIP-2098 short signatures]\n *\n * _Available since v4.3._\n */\n function tryRecover(bytes32 hash, bytes32 r, bytes32 vs) internal pure returns (address, RecoverError) {\n bytes32 s = vs & bytes32(0x7fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff);\n uint8 v = uint8((uint256(vs) >> 255) + 27);\n return tryRecover(hash, v, r, s);\n }\n\n /**\n * @dev Overload of {ECDSA-recover} that receives the `r and `vs` short-signature fields separately.\n *\n * _Available since v4.2._\n */\n function recover(bytes32 hash, bytes32 r, bytes32 vs) internal pure returns (address) {\n (address recovered, RecoverError error) = tryRecover(hash, r, vs);\n _throwError(error);\n return recovered;\n }\n\n /**\n * @dev Overload of {ECDSA-tryRecover} that receives the `v`,\n * `r` and `s` signature fields separately.\n *\n * _Available since v4.3._\n */\n function tryRecover(bytes32 hash, uint8 v, bytes32 r, bytes32 s) internal pure returns (address, RecoverError) {\n // EIP-2 still allows signature malleability for ecrecover(). Remove this possibility and make the signature\n // unique. Appendix F in the Ethereum Yellow paper (https://ethereum.github.io/yellowpaper/paper.pdf), defines\n // the valid range for s in (301): 0 < s < secp256k1n ÷ 2 + 1, and for v in (302): v ∈ {27, 28}. Most\n // signatures from current libraries generate a unique signature with an s-value in the lower half order.\n //\n // If your library generates malleable signatures, such as s-values in the upper range, calculate a new s-value\n // with 0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFEBAAEDCE6AF48A03BBFD25E8CD0364141 - s1 and flip v from 27 to 28 or\n // vice versa. If your library also generates signatures with 0/1 for v instead 27/28, add 27 to v to accept\n // these malleable signatures as well.\n if (uint256(s) > 0x7FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF5D576E7357A4501DDFE92F46681B20A0) {\n return (address(0), RecoverError.InvalidSignatureS);\n }\n\n // If the signature is valid (and not malleable), return the signer address\n address signer = ecrecover(hash, v, r, s);\n if (signer == address(0)) {\n return (address(0), RecoverError.InvalidSignature);\n }\n\n return (signer, RecoverError.NoError);\n }\n\n /**\n * @dev Overload of {ECDSA-recover} that receives the `v`,\n * `r` and `s` signature fields separately.\n */\n function recover(bytes32 hash, uint8 v, bytes32 r, bytes32 s) internal pure returns (address) {\n (address recovered, RecoverError error) = tryRecover(hash, v, r, s);\n _throwError(error);\n return recovered;\n }\n\n /**\n * @dev Returns an Ethereum Signed Message, created from a `hash`. This\n * produces hash corresponding to the one signed with the\n * https://eth.wiki/json-rpc/API#eth_sign[`eth_sign`]\n * JSON-RPC method as part of EIP-191.\n *\n * See {recover}.\n */\n function toEthSignedMessageHash(bytes32 hash) internal pure returns (bytes32 message) {\n // 32 is the length in bytes of hash,\n // enforced by the type signature above\n /// @solidity memory-safe-assembly\n assembly {\n mstore(0x00, \"\\x19Ethereum Signed Message:\\n32\")\n mstore(0x1c, hash)\n message := keccak256(0x00, 0x3c)\n }\n }\n\n /**\n * @dev Returns an Ethereum Signed Message, created from `s`. This\n * produces hash corresponding to the one signed with the\n * https://eth.wiki/json-rpc/API#eth_sign[`eth_sign`]\n * JSON-RPC method as part of EIP-191.\n *\n * See {recover}.\n */\n function toEthSignedMessageHash(bytes memory s) internal pure returns (bytes32) {\n return keccak256(abi.encodePacked(\"\\x19Ethereum Signed Message:\\n\", Strings.toString(s.length), s));\n }\n\n /**\n * @dev Returns an Ethereum Signed Typed Data, created from a\n * `domainSeparator` and a `structHash`. This produces hash corresponding\n * to the one signed with the\n * https://eips.ethereum.org/EIPS/eip-712[`eth_signTypedData`]\n * JSON-RPC method as part of EIP-712.\n *\n * See {recover}.\n */\n function toTypedDataHash(bytes32 domainSeparator, bytes32 structHash) internal pure returns (bytes32 data) {\n /// @solidity memory-safe-assembly\n assembly {\n let ptr := mload(0x40)\n mstore(ptr, \"\\x19\\x01\")\n mstore(add(ptr, 0x02), domainSeparator)\n mstore(add(ptr, 0x22), structHash)\n data := keccak256(ptr, 0x42)\n }\n }\n\n /**\n * @dev Returns an Ethereum Signed Data with intended validator, created from a\n * `validator` and `data` according to the version 0 of EIP-191.\n *\n * See {recover}.\n */\n function toDataWithIntendedValidatorHash(address validator, bytes memory data) internal pure returns (bytes32) {\n return keccak256(abi.encodePacked(\"\\x19\\x00\", validator, data));\n }\n}\n"
+ },
+ "@openzeppelin/contracts/utils/cryptography/MerkleProof.sol": {
+ "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.2) (utils/cryptography/MerkleProof.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @dev These functions deal with verification of Merkle Tree proofs.\n *\n * The tree and the proofs can be generated using our\n * https://github.com/OpenZeppelin/merkle-tree[JavaScript library].\n * You will find a quickstart guide in the readme.\n *\n * WARNING: You should avoid using leaf values that are 64 bytes long prior to\n * hashing, or use a hash function other than keccak256 for hashing leaves.\n * This is because the concatenation of a sorted pair of internal nodes in\n * the merkle tree could be reinterpreted as a leaf value.\n * OpenZeppelin's JavaScript library generates merkle trees that are safe\n * against this attack out of the box.\n */\nlibrary MerkleProof {\n /**\n * @dev Returns true if a `leaf` can be proved to be a part of a Merkle tree\n * defined by `root`. For this, a `proof` must be provided, containing\n * sibling hashes on the branch from the leaf to the root of the tree. Each\n * pair of leaves and each pair of pre-images are assumed to be sorted.\n */\n function verify(bytes32[] memory proof, bytes32 root, bytes32 leaf) internal pure returns (bool) {\n return processProof(proof, leaf) == root;\n }\n\n /**\n * @dev Calldata version of {verify}\n *\n * _Available since v4.7._\n */\n function verifyCalldata(bytes32[] calldata proof, bytes32 root, bytes32 leaf) internal pure returns (bool) {\n return processProofCalldata(proof, leaf) == root;\n }\n\n /**\n * @dev Returns the rebuilt hash obtained by traversing a Merkle tree up\n * from `leaf` using `proof`. A `proof` is valid if and only if the rebuilt\n * hash matches the root of the tree. When processing the proof, the pairs\n * of leafs & pre-images are assumed to be sorted.\n *\n * _Available since v4.4._\n */\n function processProof(bytes32[] memory proof, bytes32 leaf) internal pure returns (bytes32) {\n bytes32 computedHash = leaf;\n for (uint256 i = 0; i < proof.length; i++) {\n computedHash = _hashPair(computedHash, proof[i]);\n }\n return computedHash;\n }\n\n /**\n * @dev Calldata version of {processProof}\n *\n * _Available since v4.7._\n */\n function processProofCalldata(bytes32[] calldata proof, bytes32 leaf) internal pure returns (bytes32) {\n bytes32 computedHash = leaf;\n for (uint256 i = 0; i < proof.length; i++) {\n computedHash = _hashPair(computedHash, proof[i]);\n }\n return computedHash;\n }\n\n /**\n * @dev Returns true if the `leaves` can be simultaneously proven to be a part of a merkle tree defined by\n * `root`, according to `proof` and `proofFlags` as described in {processMultiProof}.\n *\n * CAUTION: Not all merkle trees admit multiproofs. See {processMultiProof} for details.\n *\n * _Available since v4.7._\n */\n function multiProofVerify(\n bytes32[] memory proof,\n bool[] memory proofFlags,\n bytes32 root,\n bytes32[] memory leaves\n ) internal pure returns (bool) {\n return processMultiProof(proof, proofFlags, leaves) == root;\n }\n\n /**\n * @dev Calldata version of {multiProofVerify}\n *\n * CAUTION: Not all merkle trees admit multiproofs. See {processMultiProof} for details.\n *\n * _Available since v4.7._\n */\n function multiProofVerifyCalldata(\n bytes32[] calldata proof,\n bool[] calldata proofFlags,\n bytes32 root,\n bytes32[] memory leaves\n ) internal pure returns (bool) {\n return processMultiProofCalldata(proof, proofFlags, leaves) == root;\n }\n\n /**\n * @dev Returns the root of a tree reconstructed from `leaves` and sibling nodes in `proof`. The reconstruction\n * proceeds by incrementally reconstructing all inner nodes by combining a leaf/inner node with either another\n * leaf/inner node or a proof sibling node, depending on whether each `proofFlags` item is true or false\n * respectively.\n *\n * CAUTION: Not all merkle trees admit multiproofs. To use multiproofs, it is sufficient to ensure that: 1) the tree\n * is complete (but not necessarily perfect), 2) the leaves to be proven are in the opposite order they are in the\n * tree (i.e., as seen from right to left starting at the deepest layer and continuing at the next layer).\n *\n * _Available since v4.7._\n */\n function processMultiProof(\n bytes32[] memory proof,\n bool[] memory proofFlags,\n bytes32[] memory leaves\n ) internal pure returns (bytes32 merkleRoot) {\n // This function rebuilds the root hash by traversing the tree up from the leaves. The root is rebuilt by\n // consuming and producing values on a queue. The queue starts with the `leaves` array, then goes onto the\n // `hashes` array. At the end of the process, the last hash in the `hashes` array should contain the root of\n // the merkle tree.\n uint256 leavesLen = leaves.length;\n uint256 proofLen = proof.length;\n uint256 totalHashes = proofFlags.length;\n\n // Check proof validity.\n require(leavesLen + proofLen - 1 == totalHashes, \"MerkleProof: invalid multiproof\");\n\n // The xxxPos values are \"pointers\" to the next value to consume in each array. All accesses are done using\n // `xxx[xxxPos++]`, which return the current value and increment the pointer, thus mimicking a queue's \"pop\".\n bytes32[] memory hashes = new bytes32[](totalHashes);\n uint256 leafPos = 0;\n uint256 hashPos = 0;\n uint256 proofPos = 0;\n // At each step, we compute the next hash using two values:\n // - a value from the \"main queue\". If not all leaves have been consumed, we get the next leaf, otherwise we\n // get the next hash.\n // - depending on the flag, either another value from the \"main queue\" (merging branches) or an element from the\n // `proof` array.\n for (uint256 i = 0; i < totalHashes; i++) {\n bytes32 a = leafPos < leavesLen ? leaves[leafPos++] : hashes[hashPos++];\n bytes32 b = proofFlags[i]\n ? (leafPos < leavesLen ? leaves[leafPos++] : hashes[hashPos++])\n : proof[proofPos++];\n hashes[i] = _hashPair(a, b);\n }\n\n if (totalHashes > 0) {\n require(proofPos == proofLen, \"MerkleProof: invalid multiproof\");\n unchecked {\n return hashes[totalHashes - 1];\n }\n } else if (leavesLen > 0) {\n return leaves[0];\n } else {\n return proof[0];\n }\n }\n\n /**\n * @dev Calldata version of {processMultiProof}.\n *\n * CAUTION: Not all merkle trees admit multiproofs. See {processMultiProof} for details.\n *\n * _Available since v4.7._\n */\n function processMultiProofCalldata(\n bytes32[] calldata proof,\n bool[] calldata proofFlags,\n bytes32[] memory leaves\n ) internal pure returns (bytes32 merkleRoot) {\n // This function rebuilds the root hash by traversing the tree up from the leaves. The root is rebuilt by\n // consuming and producing values on a queue. The queue starts with the `leaves` array, then goes onto the\n // `hashes` array. At the end of the process, the last hash in the `hashes` array should contain the root of\n // the merkle tree.\n uint256 leavesLen = leaves.length;\n uint256 proofLen = proof.length;\n uint256 totalHashes = proofFlags.length;\n\n // Check proof validity.\n require(leavesLen + proofLen - 1 == totalHashes, \"MerkleProof: invalid multiproof\");\n\n // The xxxPos values are \"pointers\" to the next value to consume in each array. All accesses are done using\n // `xxx[xxxPos++]`, which return the current value and increment the pointer, thus mimicking a queue's \"pop\".\n bytes32[] memory hashes = new bytes32[](totalHashes);\n uint256 leafPos = 0;\n uint256 hashPos = 0;\n uint256 proofPos = 0;\n // At each step, we compute the next hash using two values:\n // - a value from the \"main queue\". If not all leaves have been consumed, we get the next leaf, otherwise we\n // get the next hash.\n // - depending on the flag, either another value from the \"main queue\" (merging branches) or an element from the\n // `proof` array.\n for (uint256 i = 0; i < totalHashes; i++) {\n bytes32 a = leafPos < leavesLen ? leaves[leafPos++] : hashes[hashPos++];\n bytes32 b = proofFlags[i]\n ? (leafPos < leavesLen ? leaves[leafPos++] : hashes[hashPos++])\n : proof[proofPos++];\n hashes[i] = _hashPair(a, b);\n }\n\n if (totalHashes > 0) {\n require(proofPos == proofLen, \"MerkleProof: invalid multiproof\");\n unchecked {\n return hashes[totalHashes - 1];\n }\n } else if (leavesLen > 0) {\n return leaves[0];\n } else {\n return proof[0];\n }\n }\n\n function _hashPair(bytes32 a, bytes32 b) private pure returns (bytes32) {\n return a < b ? _efficientHash(a, b) : _efficientHash(b, a);\n }\n\n function _efficientHash(bytes32 a, bytes32 b) private pure returns (bytes32 value) {\n /// @solidity memory-safe-assembly\n assembly {\n mstore(0x00, a)\n mstore(0x20, b)\n value := keccak256(0x00, 0x40)\n }\n }\n}\n"
+ },
+ "@openzeppelin/contracts/utils/cryptography/SignatureChecker.sol": {
+ "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (utils/cryptography/SignatureChecker.sol)\n\npragma solidity ^0.8.0;\n\nimport \"./ECDSA.sol\";\nimport \"../../interfaces/IERC1271.sol\";\n\n/**\n * @dev Signature verification helper that can be used instead of `ECDSA.recover` to seamlessly support both ECDSA\n * signatures from externally owned accounts (EOAs) as well as ERC1271 signatures from smart contract wallets like\n * Argent and Gnosis Safe.\n *\n * _Available since v4.1._\n */\nlibrary SignatureChecker {\n /**\n * @dev Checks if a signature is valid for a given signer and data hash. If the signer is a smart contract, the\n * signature is validated against that smart contract using ERC1271, otherwise it's validated using `ECDSA.recover`.\n *\n * NOTE: Unlike ECDSA signatures, contract signatures are revocable, and the outcome of this function can thus\n * change through time. It could return true at block N and false at block N+1 (or the opposite).\n */\n function isValidSignatureNow(address signer, bytes32 hash, bytes memory signature) internal view returns (bool) {\n (address recovered, ECDSA.RecoverError error) = ECDSA.tryRecover(hash, signature);\n return\n (error == ECDSA.RecoverError.NoError && recovered == signer) ||\n isValidERC1271SignatureNow(signer, hash, signature);\n }\n\n /**\n * @dev Checks if a signature is valid for a given signer and data hash. The signature is validated\n * against the signer smart contract using ERC1271.\n *\n * NOTE: Unlike ECDSA signatures, contract signatures are revocable, and the outcome of this function can thus\n * change through time. It could return true at block N and false at block N+1 (or the opposite).\n */\n function isValidERC1271SignatureNow(\n address signer,\n bytes32 hash,\n bytes memory signature\n ) internal view returns (bool) {\n (bool success, bytes memory result) = signer.staticcall(\n abi.encodeWithSelector(IERC1271.isValidSignature.selector, hash, signature)\n );\n return (success &&\n result.length >= 32 &&\n abi.decode(result, (bytes32)) == bytes32(IERC1271.isValidSignature.selector));\n }\n}\n"
+ },
+ "@openzeppelin/contracts/utils/math/Math.sol": {
+ "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (utils/math/Math.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @dev Standard math utilities missing in the Solidity language.\n */\nlibrary Math {\n enum Rounding {\n Down, // Toward negative infinity\n Up, // Toward infinity\n Zero // Toward zero\n }\n\n /**\n * @dev Returns the largest of two numbers.\n */\n function max(uint256 a, uint256 b) internal pure returns (uint256) {\n return a > b ? a : b;\n }\n\n /**\n * @dev Returns the smallest of two numbers.\n */\n function min(uint256 a, uint256 b) internal pure returns (uint256) {\n return a < b ? a : b;\n }\n\n /**\n * @dev Returns the average of two numbers. The result is rounded towards\n * zero.\n */\n function average(uint256 a, uint256 b) internal pure returns (uint256) {\n // (a + b) / 2 can overflow.\n return (a & b) + (a ^ b) / 2;\n }\n\n /**\n * @dev Returns the ceiling of the division of two numbers.\n *\n * This differs from standard division with `/` in that it rounds up instead\n * of rounding down.\n */\n function ceilDiv(uint256 a, uint256 b) internal pure returns (uint256) {\n // (a + b - 1) / b can overflow on addition, so we distribute.\n return a == 0 ? 0 : (a - 1) / b + 1;\n }\n\n /**\n * @notice Calculates floor(x * y / denominator) with full precision. Throws if result overflows a uint256 or denominator == 0\n * @dev Original credit to Remco Bloemen under MIT license (https://xn--2-umb.com/21/muldiv)\n * with further edits by Uniswap Labs also under MIT license.\n */\n function mulDiv(uint256 x, uint256 y, uint256 denominator) internal pure returns (uint256 result) {\n unchecked {\n // 512-bit multiply [prod1 prod0] = x * y. Compute the product mod 2^256 and mod 2^256 - 1, then use\n // use the Chinese Remainder Theorem to reconstruct the 512 bit result. The result is stored in two 256\n // variables such that product = prod1 * 2^256 + prod0.\n uint256 prod0; // Least significant 256 bits of the product\n uint256 prod1; // Most significant 256 bits of the product\n assembly {\n let mm := mulmod(x, y, not(0))\n prod0 := mul(x, y)\n prod1 := sub(sub(mm, prod0), lt(mm, prod0))\n }\n\n // Handle non-overflow cases, 256 by 256 division.\n if (prod1 == 0) {\n // Solidity will revert if denominator == 0, unlike the div opcode on its own.\n // The surrounding unchecked block does not change this fact.\n // See https://docs.soliditylang.org/en/latest/control-structures.html#checked-or-unchecked-arithmetic.\n return prod0 / denominator;\n }\n\n // Make sure the result is less than 2^256. Also prevents denominator == 0.\n require(denominator > prod1, \"Math: mulDiv overflow\");\n\n ///////////////////////////////////////////////\n // 512 by 256 division.\n ///////////////////////////////////////////////\n\n // Make division exact by subtracting the remainder from [prod1 prod0].\n uint256 remainder;\n assembly {\n // Compute remainder using mulmod.\n remainder := mulmod(x, y, denominator)\n\n // Subtract 256 bit number from 512 bit number.\n prod1 := sub(prod1, gt(remainder, prod0))\n prod0 := sub(prod0, remainder)\n }\n\n // Factor powers of two out of denominator and compute largest power of two divisor of denominator. Always >= 1.\n // See https://cs.stackexchange.com/q/138556/92363.\n\n // Does not overflow because the denominator cannot be zero at this stage in the function.\n uint256 twos = denominator & (~denominator + 1);\n assembly {\n // Divide denominator by twos.\n denominator := div(denominator, twos)\n\n // Divide [prod1 prod0] by twos.\n prod0 := div(prod0, twos)\n\n // Flip twos such that it is 2^256 / twos. If twos is zero, then it becomes one.\n twos := add(div(sub(0, twos), twos), 1)\n }\n\n // Shift in bits from prod1 into prod0.\n prod0 |= prod1 * twos;\n\n // Invert denominator mod 2^256. Now that denominator is an odd number, it has an inverse modulo 2^256 such\n // that denominator * inv = 1 mod 2^256. Compute the inverse by starting with a seed that is correct for\n // four bits. That is, denominator * inv = 1 mod 2^4.\n uint256 inverse = (3 * denominator) ^ 2;\n\n // Use the Newton-Raphson iteration to improve the precision. Thanks to Hensel's lifting lemma, this also works\n // in modular arithmetic, doubling the correct bits in each step.\n inverse *= 2 - denominator * inverse; // inverse mod 2^8\n inverse *= 2 - denominator * inverse; // inverse mod 2^16\n inverse *= 2 - denominator * inverse; // inverse mod 2^32\n inverse *= 2 - denominator * inverse; // inverse mod 2^64\n inverse *= 2 - denominator * inverse; // inverse mod 2^128\n inverse *= 2 - denominator * inverse; // inverse mod 2^256\n\n // Because the division is now exact we can divide by multiplying with the modular inverse of denominator.\n // This will give us the correct result modulo 2^256. Since the preconditions guarantee that the outcome is\n // less than 2^256, this is the final result. We don't need to compute the high bits of the result and prod1\n // is no longer required.\n result = prod0 * inverse;\n return result;\n }\n }\n\n /**\n * @notice Calculates x * y / denominator with full precision, following the selected rounding direction.\n */\n function mulDiv(uint256 x, uint256 y, uint256 denominator, Rounding rounding) internal pure returns (uint256) {\n uint256 result = mulDiv(x, y, denominator);\n if (rounding == Rounding.Up && mulmod(x, y, denominator) > 0) {\n result += 1;\n }\n return result;\n }\n\n /**\n * @dev Returns the square root of a number. If the number is not a perfect square, the value is rounded down.\n *\n * Inspired by Henry S. Warren, Jr.'s \"Hacker's Delight\" (Chapter 11).\n */\n function sqrt(uint256 a) internal pure returns (uint256) {\n if (a == 0) {\n return 0;\n }\n\n // For our first guess, we get the biggest power of 2 which is smaller than the square root of the target.\n //\n // We know that the \"msb\" (most significant bit) of our target number `a` is a power of 2 such that we have\n // `msb(a) <= a < 2*msb(a)`. This value can be written `msb(a)=2**k` with `k=log2(a)`.\n //\n // This can be rewritten `2**log2(a) <= a < 2**(log2(a) + 1)`\n // → `sqrt(2**k) <= sqrt(a) < sqrt(2**(k+1))`\n // → `2**(k/2) <= sqrt(a) < 2**((k+1)/2) <= 2**(k/2 + 1)`\n //\n // Consequently, `2**(log2(a) / 2)` is a good first approximation of `sqrt(a)` with at least 1 correct bit.\n uint256 result = 1 << (log2(a) >> 1);\n\n // At this point `result` is an estimation with one bit of precision. We know the true value is a uint128,\n // since it is the square root of a uint256. Newton's method converges quadratically (precision doubles at\n // every iteration). We thus need at most 7 iteration to turn our partial result with one bit of precision\n // into the expected uint128 result.\n unchecked {\n result = (result + a / result) >> 1;\n result = (result + a / result) >> 1;\n result = (result + a / result) >> 1;\n result = (result + a / result) >> 1;\n result = (result + a / result) >> 1;\n result = (result + a / result) >> 1;\n result = (result + a / result) >> 1;\n return min(result, a / result);\n }\n }\n\n /**\n * @notice Calculates sqrt(a), following the selected rounding direction.\n */\n function sqrt(uint256 a, Rounding rounding) internal pure returns (uint256) {\n unchecked {\n uint256 result = sqrt(a);\n return result + (rounding == Rounding.Up && result * result < a ? 1 : 0);\n }\n }\n\n /**\n * @dev Return the log in base 2, rounded down, of a positive value.\n * Returns 0 if given 0.\n */\n function log2(uint256 value) internal pure returns (uint256) {\n uint256 result = 0;\n unchecked {\n if (value >> 128 > 0) {\n value >>= 128;\n result += 128;\n }\n if (value >> 64 > 0) {\n value >>= 64;\n result += 64;\n }\n if (value >> 32 > 0) {\n value >>= 32;\n result += 32;\n }\n if (value >> 16 > 0) {\n value >>= 16;\n result += 16;\n }\n if (value >> 8 > 0) {\n value >>= 8;\n result += 8;\n }\n if (value >> 4 > 0) {\n value >>= 4;\n result += 4;\n }\n if (value >> 2 > 0) {\n value >>= 2;\n result += 2;\n }\n if (value >> 1 > 0) {\n result += 1;\n }\n }\n return result;\n }\n\n /**\n * @dev Return the log in base 2, following the selected rounding direction, of a positive value.\n * Returns 0 if given 0.\n */\n function log2(uint256 value, Rounding rounding) internal pure returns (uint256) {\n unchecked {\n uint256 result = log2(value);\n return result + (rounding == Rounding.Up && 1 << result < value ? 1 : 0);\n }\n }\n\n /**\n * @dev Return the log in base 10, rounded down, of a positive value.\n * Returns 0 if given 0.\n */\n function log10(uint256 value) internal pure returns (uint256) {\n uint256 result = 0;\n unchecked {\n if (value >= 10 ** 64) {\n value /= 10 ** 64;\n result += 64;\n }\n if (value >= 10 ** 32) {\n value /= 10 ** 32;\n result += 32;\n }\n if (value >= 10 ** 16) {\n value /= 10 ** 16;\n result += 16;\n }\n if (value >= 10 ** 8) {\n value /= 10 ** 8;\n result += 8;\n }\n if (value >= 10 ** 4) {\n value /= 10 ** 4;\n result += 4;\n }\n if (value >= 10 ** 2) {\n value /= 10 ** 2;\n result += 2;\n }\n if (value >= 10 ** 1) {\n result += 1;\n }\n }\n return result;\n }\n\n /**\n * @dev Return the log in base 10, following the selected rounding direction, of a positive value.\n * Returns 0 if given 0.\n */\n function log10(uint256 value, Rounding rounding) internal pure returns (uint256) {\n unchecked {\n uint256 result = log10(value);\n return result + (rounding == Rounding.Up && 10 ** result < value ? 1 : 0);\n }\n }\n\n /**\n * @dev Return the log in base 256, rounded down, of a positive value.\n * Returns 0 if given 0.\n *\n * Adding one to the result gives the number of pairs of hex symbols needed to represent `value` as a hex string.\n */\n function log256(uint256 value) internal pure returns (uint256) {\n uint256 result = 0;\n unchecked {\n if (value >> 128 > 0) {\n value >>= 128;\n result += 16;\n }\n if (value >> 64 > 0) {\n value >>= 64;\n result += 8;\n }\n if (value >> 32 > 0) {\n value >>= 32;\n result += 4;\n }\n if (value >> 16 > 0) {\n value >>= 16;\n result += 2;\n }\n if (value >> 8 > 0) {\n result += 1;\n }\n }\n return result;\n }\n\n /**\n * @dev Return the log in base 256, following the selected rounding direction, of a positive value.\n * Returns 0 if given 0.\n */\n function log256(uint256 value, Rounding rounding) internal pure returns (uint256) {\n unchecked {\n uint256 result = log256(value);\n return result + (rounding == Rounding.Up && 1 << (result << 3) < value ? 1 : 0);\n }\n }\n}\n"
+ },
+ "@openzeppelin/contracts/utils/math/SignedMath.sol": {
+ "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.8.0) (utils/math/SignedMath.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @dev Standard signed math utilities missing in the Solidity language.\n */\nlibrary SignedMath {\n /**\n * @dev Returns the largest of two signed numbers.\n */\n function max(int256 a, int256 b) internal pure returns (int256) {\n return a > b ? a : b;\n }\n\n /**\n * @dev Returns the smallest of two signed numbers.\n */\n function min(int256 a, int256 b) internal pure returns (int256) {\n return a < b ? a : b;\n }\n\n /**\n * @dev Returns the average of two signed numbers without overflow.\n * The result is rounded towards zero.\n */\n function average(int256 a, int256 b) internal pure returns (int256) {\n // Formula from the book \"Hacker's Delight\"\n int256 x = (a & b) + ((a ^ b) >> 1);\n return x + (int256(uint256(x) >> 255) & (a ^ b));\n }\n\n /**\n * @dev Returns the absolute unsigned value of a signed value.\n */\n function abs(int256 n) internal pure returns (uint256) {\n unchecked {\n // must be unchecked in order to support `n = type(int256).min`\n return uint256(n >= 0 ? n : -n);\n }\n }\n}\n"
+ },
+ "@openzeppelin/contracts/utils/Strings.sol": {
+ "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (utils/Strings.sol)\n\npragma solidity ^0.8.0;\n\nimport \"./math/Math.sol\";\nimport \"./math/SignedMath.sol\";\n\n/**\n * @dev String operations.\n */\nlibrary Strings {\n bytes16 private constant _SYMBOLS = \"0123456789abcdef\";\n uint8 private constant _ADDRESS_LENGTH = 20;\n\n /**\n * @dev Converts a `uint256` to its ASCII `string` decimal representation.\n */\n function toString(uint256 value) internal pure returns (string memory) {\n unchecked {\n uint256 length = Math.log10(value) + 1;\n string memory buffer = new string(length);\n uint256 ptr;\n /// @solidity memory-safe-assembly\n assembly {\n ptr := add(buffer, add(32, length))\n }\n while (true) {\n ptr--;\n /// @solidity memory-safe-assembly\n assembly {\n mstore8(ptr, byte(mod(value, 10), _SYMBOLS))\n }\n value /= 10;\n if (value == 0) break;\n }\n return buffer;\n }\n }\n\n /**\n * @dev Converts a `int256` to its ASCII `string` decimal representation.\n */\n function toString(int256 value) internal pure returns (string memory) {\n return string(abi.encodePacked(value < 0 ? \"-\" : \"\", toString(SignedMath.abs(value))));\n }\n\n /**\n * @dev Converts a `uint256` to its ASCII `string` hexadecimal representation.\n */\n function toHexString(uint256 value) internal pure returns (string memory) {\n unchecked {\n return toHexString(value, Math.log256(value) + 1);\n }\n }\n\n /**\n * @dev Converts a `uint256` to its ASCII `string` hexadecimal representation with fixed length.\n */\n function toHexString(uint256 value, uint256 length) internal pure returns (string memory) {\n bytes memory buffer = new bytes(2 * length + 2);\n buffer[0] = \"0\";\n buffer[1] = \"x\";\n for (uint256 i = 2 * length + 1; i > 1; --i) {\n buffer[i] = _SYMBOLS[value & 0xf];\n value >>= 4;\n }\n require(value == 0, \"Strings: hex length insufficient\");\n return string(buffer);\n }\n\n /**\n * @dev Converts an `address` with fixed length of 20 bytes to its not checksummed ASCII `string` hexadecimal representation.\n */\n function toHexString(address addr) internal pure returns (string memory) {\n return toHexString(uint256(uint160(addr)), _ADDRESS_LENGTH);\n }\n\n /**\n * @dev Returns true if the two strings are equal.\n */\n function equal(string memory a, string memory b) internal pure returns (bool) {\n return keccak256(bytes(a)) == keccak256(bytes(b));\n }\n}\n"
+ },
+ "@uma/core/contracts/common/implementation/MultiCaller.sol": {
+ "content": "// SPDX-License-Identifier: AGPL-3.0-only\npragma solidity ^0.8.0;\n\n// This contract is taken from Uniswap's multi call implementation (https://github.com/Uniswap/uniswap-v3-periphery/blob/main/contracts/base/Multicall.sol)\n// and was modified to be solidity 0.8 compatible. Additionally, the method was restricted to only work with msg.value\n// set to 0 to avoid any nasty attack vectors on function calls that use value sent with deposits.\n\n/// @title MultiCaller\n/// @notice Enables calling multiple methods in a single call to the contract\ncontract MultiCaller {\n function multicall(bytes[] calldata data) external returns (bytes[] memory results) {\n results = new bytes[](data.length);\n for (uint256 i = 0; i < data.length; i++) {\n (bool success, bytes memory result) = address(this).delegatecall(data[i]);\n\n if (!success) {\n // Next 5 lines from https://ethereum.stackexchange.com/a/83577\n if (result.length < 68) revert();\n assembly {\n result := add(result, 0x04)\n }\n revert(abi.decode(result, (string)));\n }\n\n results[i] = result;\n }\n }\n}\n"
+ },
+ "contracts/AlephZero_SpokePool.sol": {
+ "content": "// SPDX-License-Identifier: BUSL-1.1\n\n// Arbitrum only supports v0.8.19\n// See https://docs.arbitrum.io/for-devs/concepts/differences-between-arbitrum-ethereum/solidity-support#differences-from-solidity-on-ethereum\npragma solidity ^0.8.19;\n\nimport \"./Arbitrum_SpokePool.sol\";\n\n/**\n * @notice AVM specific SpokePool. Uses AVM cross-domain-enabled logic to implement admin only access to functions.\n * @custom:security-contact bugs@across.to\n */\ncontract AlephZero_SpokePool is Arbitrum_SpokePool {\n /// @custom:oz-upgrades-unsafe-allow constructor\n constructor(\n address _wrappedNativeTokenAddress,\n uint32 _depositQuoteTimeBuffer,\n uint32 _fillDeadlineBuffer,\n IERC20 _l2Usdc,\n ITokenMessenger _cctpTokenMessenger\n )\n Arbitrum_SpokePool(\n _wrappedNativeTokenAddress,\n _depositQuoteTimeBuffer,\n _fillDeadlineBuffer,\n _l2Usdc,\n _cctpTokenMessenger\n )\n {} // solhint-disable-line no-empty-blocks\n}\n"
+ },
+ "contracts/Arbitrum_SpokePool.sol": {
+ "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\n\nimport \"./SpokePool.sol\";\nimport \"./libraries/CircleCCTPAdapter.sol\";\nimport { CrossDomainAddressUtils } from \"./libraries/CrossDomainAddressUtils.sol\";\nimport { ArbitrumL2ERC20GatewayLike } from \"./interfaces/ArbitrumBridge.sol\";\n\n/**\n * @notice AVM specific SpokePool. Uses AVM cross-domain-enabled logic to implement admin only access to functions.\n * @custom:security-contact bugs@across.to\n */\ncontract Arbitrum_SpokePool is SpokePool, CircleCCTPAdapter {\n // Address of the Arbitrum L2 token gateway to send funds to L1.\n address public l2GatewayRouter;\n\n // Admin controlled mapping of arbitrum tokens to L1 counterpart. L1 counterpart addresses\n // are necessary params used when bridging tokens to L1.\n mapping(address => address) public whitelistedTokens;\n\n event SetL2GatewayRouter(address indexed newL2GatewayRouter);\n event WhitelistedTokens(address indexed l2Token, address indexed l1Token);\n\n /// @custom:oz-upgrades-unsafe-allow constructor\n constructor(\n address _wrappedNativeTokenAddress,\n uint32 _depositQuoteTimeBuffer,\n uint32 _fillDeadlineBuffer,\n IERC20 _l2Usdc,\n ITokenMessenger _cctpTokenMessenger\n )\n SpokePool(_wrappedNativeTokenAddress, _depositQuoteTimeBuffer, _fillDeadlineBuffer)\n CircleCCTPAdapter(_l2Usdc, _cctpTokenMessenger, CircleDomainIds.Ethereum)\n {} // solhint-disable-line no-empty-blocks\n\n /**\n * @notice Construct the AVM SpokePool.\n * @param _initialDepositId Starting deposit ID. Set to 0 unless this is a re-deployment in order to mitigate\n * relay hash collisions.\n * @param _l2GatewayRouter Address of L2 token gateway. Can be reset by admin.\n * @param _crossDomainAdmin Cross domain admin to set. Can be changed by admin.\n * @param _withdrawalRecipient Address which receives token withdrawals. Can be changed by admin. For Spoke Pools on L2, this will\n * likely be the hub pool.\n */\n function initialize(\n uint32 _initialDepositId,\n address _l2GatewayRouter,\n address _crossDomainAdmin,\n address _withdrawalRecipient\n ) public initializer {\n __SpokePool_init(_initialDepositId, _crossDomainAdmin, _withdrawalRecipient);\n _setL2GatewayRouter(_l2GatewayRouter);\n }\n\n modifier onlyFromCrossDomainAdmin() {\n require(msg.sender == CrossDomainAddressUtils.applyL1ToL2Alias(crossDomainAdmin), \"ONLY_COUNTERPART_GATEWAY\");\n _;\n }\n\n /********************************************************\n * ARBITRUM-SPECIFIC CROSS-CHAIN ADMIN FUNCTIONS *\n ********************************************************/\n\n /**\n * @notice Change L2 gateway router. Callable only by admin.\n * @param newL2GatewayRouter New L2 gateway router.\n */\n function setL2GatewayRouter(address newL2GatewayRouter) public onlyAdmin nonReentrant {\n _setL2GatewayRouter(newL2GatewayRouter);\n }\n\n /**\n * @notice Add L2 -> L1 token mapping. Callable only by admin.\n * @param l2Token Arbitrum token.\n * @param l1Token Ethereum version of l2Token.\n */\n function whitelistToken(address l2Token, address l1Token) public onlyAdmin nonReentrant {\n _whitelistToken(l2Token, l1Token);\n }\n\n /**************************************\n * INTERNAL FUNCTIONS *\n **************************************/\n\n function _bridgeTokensToHubPool(uint256 amountToReturn, address l2TokenAddress) internal override {\n // If the l2TokenAddress is UDSC, we need to use the CCTP bridge.\n if (_isCCTPEnabled() && l2TokenAddress == address(usdcToken)) {\n _transferUsdc(withdrawalRecipient, amountToReturn);\n } else {\n // Check that the Ethereum counterpart of the L2 token is stored on this contract.\n address ethereumTokenToBridge = whitelistedTokens[l2TokenAddress];\n require(ethereumTokenToBridge != address(0), \"Uninitialized mainnet token\");\n //slither-disable-next-line unused-return\n ArbitrumL2ERC20GatewayLike(l2GatewayRouter).outboundTransfer(\n ethereumTokenToBridge, // _l1Token. Address of the L1 token to bridge over.\n withdrawalRecipient, // _to. Withdraw, over the bridge, to the l1 hub pool contract.\n amountToReturn, // _amount.\n \"\" // _data. We don't need to send any data for the bridging action.\n );\n }\n }\n\n function _setL2GatewayRouter(address _l2GatewayRouter) internal {\n l2GatewayRouter = _l2GatewayRouter;\n emit SetL2GatewayRouter(l2GatewayRouter);\n }\n\n function _whitelistToken(address _l2Token, address _l1Token) internal {\n whitelistedTokens[_l2Token] = _l1Token;\n emit WhitelistedTokens(_l2Token, _l1Token);\n }\n\n // Apply AVM-specific transformation to cross domain admin address on L1.\n function _requireAdminSender() internal override onlyFromCrossDomainAdmin {}\n}\n"
+ },
+ "contracts/Boba_SpokePool.sol": {
+ "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\n\nimport \"./Ovm_SpokePool.sol\";\n\n/**\n * @notice Boba Spoke pool. Note that the l2ETH and l2WETH are the opposite as that in Optimism.\n */\ncontract Boba_SpokePool is Ovm_SpokePool {\n /// @custom:oz-upgrades-unsafe-allow constructor\n constructor(\n address _wrappedNativeTokenAddress,\n uint32 _depositQuoteTimeBuffer,\n uint32 _fillDeadlineBuffer\n )\n Ovm_SpokePool(\n _wrappedNativeTokenAddress,\n _depositQuoteTimeBuffer,\n _fillDeadlineBuffer,\n IERC20(address(0)),\n ITokenMessenger(address(0))\n )\n {} // solhint-disable-line no-empty-blocks\n\n /**\n * @notice Construct the OVM Boba SpokePool.\n * @param _initialDepositId Starting deposit ID. Set to 0 unless this is a re-deployment in order to mitigate\n * relay hash collisions.\n * @param _crossDomainAdmin Cross domain admin to set. Can be changed by admin.\n * @param _withdrawalRecipient Address which receives token withdrawals. Can be changed by admin. For Spoke Pools on L2, this will\n * likely be the hub pool.\n */\n function initialize(\n uint32 _initialDepositId,\n address _crossDomainAdmin,\n address _withdrawalRecipient\n ) public initializer {\n __OvmSpokePool_init(\n _initialDepositId,\n _crossDomainAdmin,\n _withdrawalRecipient,\n 0x4200000000000000000000000000000000000006\n );\n }\n}\n"
+ },
+ "contracts/chain-adapters/Arbitrum_Adapter.sol": {
+ "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\n\nimport \"./interfaces/AdapterInterface.sol\";\n\nimport \"@openzeppelin/contracts/token/ERC20/IERC20.sol\";\nimport \"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\";\nimport \"../external/interfaces/CCTPInterfaces.sol\";\nimport \"../libraries/CircleCCTPAdapter.sol\";\nimport { ArbitrumInboxLike as ArbitrumL1InboxLike, ArbitrumL1ERC20GatewayLike } from \"../interfaces/ArbitrumBridge.sol\";\n\n/**\n * @notice Contract containing logic to send messages from L1 to Arbitrum.\n * @dev Public functions calling external contracts do not guard against reentrancy because they are expected to be\n * called via delegatecall, which will execute this contract's logic within the context of the originating contract.\n * For example, the HubPool will delegatecall these functions, therefore its only necessary that the HubPool's methods\n * that call this contract's logic guard against reentrancy.\n */\n\n// solhint-disable-next-line contract-name-camelcase\ncontract Arbitrum_Adapter is AdapterInterface, CircleCCTPAdapter {\n using SafeERC20 for IERC20;\n\n // Amount of ETH allocated to pay for the base submission fee. The base submission fee is a parameter unique to\n // retryable transactions; the user is charged the base submission fee to cover the storage costs of keeping their\n // ticket’s calldata in the retry buffer. (current base submission fee is queryable via\n // ArbRetryableTx.getSubmissionPrice). ArbRetryableTicket precompile interface exists at L2 address\n // 0x000000000000000000000000000000000000006E.\n uint256 public constant L2_MAX_SUBMISSION_COST = 0.01e18;\n\n // L2 Gas price bid for immediate L2 execution attempt (queryable via standard eth*gasPrice RPC)\n uint256 public constant L2_GAS_PRICE = 5e9; // 5 gWei\n\n // Native token expected to be sent in L2 message. Should be 0 for only use case of this constant, which\n // includes is sending messages from L1 to L2.\n uint256 public constant L2_CALL_VALUE = 0;\n\n // Gas limit for L2 execution of a cross chain token transfer sent via the inbox.\n uint32 public constant RELAY_TOKENS_L2_GAS_LIMIT = 300_000;\n // Gas limit for L2 execution of a message sent via the inbox.\n uint32 public constant RELAY_MESSAGE_L2_GAS_LIMIT = 2_000_000;\n\n address public constant L1_DAI = 0x6B175474E89094C44Da98b954EedeAC495271d0F;\n\n // This address on L2 receives extra ETH that is left over after relaying a message via the inbox.\n address public immutable L2_REFUND_L2_ADDRESS;\n\n // Inbox system contract to send messages to Arbitrum. Token bridges use this to send tokens to L2.\n // https://github.com/OffchainLabs/nitro-contracts/blob/f7894d3a6d4035ba60f51a7f1334f0f2d4f02dce/src/bridge/Inbox.sol\n ArbitrumL1InboxLike public immutable L1_INBOX;\n\n // Router contract to send tokens to Arbitrum. Routes to correct gateway to bridge tokens. Internally this\n // contract calls the Inbox.\n // Generic gateway: https://github.com/OffchainLabs/token-bridge-contracts/blob/main/contracts/tokenbridge/ethereum/gateway/L1ArbitrumGateway.sol\n ArbitrumL1ERC20GatewayLike public immutable L1_ERC20_GATEWAY_ROUTER;\n\n /**\n * @notice Constructs new Adapter.\n * @param _l1ArbitrumInbox Inbox helper contract to send messages to Arbitrum.\n * @param _l1ERC20GatewayRouter ERC20 gateway router contract to send tokens to Arbitrum.\n * @param _l2RefundL2Address L2 address to receive gas refunds on after a message is relayed.\n * @param _l1Usdc USDC address on L1.\n * @param _cctpTokenMessenger TokenMessenger contract to bridge via CCTP.\n */\n constructor(\n ArbitrumL1InboxLike _l1ArbitrumInbox,\n ArbitrumL1ERC20GatewayLike _l1ERC20GatewayRouter,\n address _l2RefundL2Address,\n IERC20 _l1Usdc,\n ITokenMessenger _cctpTokenMessenger\n ) CircleCCTPAdapter(_l1Usdc, _cctpTokenMessenger, CircleDomainIds.Arbitrum) {\n L1_INBOX = _l1ArbitrumInbox;\n L1_ERC20_GATEWAY_ROUTER = _l1ERC20GatewayRouter;\n L2_REFUND_L2_ADDRESS = _l2RefundL2Address;\n }\n\n /**\n * @notice Send cross-chain message to target on Arbitrum.\n * @notice This contract must hold at least getL1CallValue() amount of ETH to send a message via the Inbox\n * successfully, or the message will get stuck.\n * @param target Contract on Arbitrum that will receive message.\n * @param message Data to send to target.\n */\n function relayMessage(address target, bytes memory message) external payable override {\n uint256 requiredL1CallValue = _contractHasSufficientEthBalance(RELAY_MESSAGE_L2_GAS_LIMIT);\n\n L1_INBOX.createRetryableTicket{ value: requiredL1CallValue }(\n target, // destAddr destination L2 contract address\n L2_CALL_VALUE, // l2CallValue call value for retryable L2 message\n L2_MAX_SUBMISSION_COST, // maxSubmissionCost Max gas deducted from user's L2 balance to cover base fee\n L2_REFUND_L2_ADDRESS, // excessFeeRefundAddress maxgas * gasprice - execution cost gets credited here on L2\n L2_REFUND_L2_ADDRESS, // callValueRefundAddress l2Callvalue gets credited here on L2 if retryable txn times out or gets cancelled\n RELAY_MESSAGE_L2_GAS_LIMIT, // maxGas Max gas deducted from user's L2 balance to cover L2 execution\n L2_GAS_PRICE, // gasPriceBid price bid for L2 execution\n message // data ABI encoded data of L2 message\n );\n\n emit MessageRelayed(target, message);\n }\n\n /**\n * @notice Bridge tokens to Arbitrum.\n * @notice This contract must hold at least getL1CallValue() amount of ETH to send a message via the Inbox\n * successfully, or the message will get stuck.\n * @param l1Token L1 token to deposit.\n * @param l2Token L2 token to receive.\n * @param amount Amount of L1 tokens to deposit and L2 tokens to receive.\n * @param to Bridge recipient.\n */\n function relayTokens(\n address l1Token,\n address l2Token, // l2Token is unused for Arbitrum.\n uint256 amount,\n address to\n ) external payable override {\n // Check if this token is USDC, which requires a custom bridge via CCTP.\n if (_isCCTPEnabled() && l1Token == address(usdcToken)) {\n _transferUsdc(to, amount);\n }\n // If not, we can use the Arbitrum gateway\n else {\n uint256 requiredL1CallValue = _contractHasSufficientEthBalance(RELAY_TOKENS_L2_GAS_LIMIT);\n\n // Approve the gateway, not the router, to spend the hub pool's balance. The gateway, which is different\n // per L1 token, will temporarily escrow the tokens to be bridged and pull them from this contract.\n address erc20Gateway = L1_ERC20_GATEWAY_ROUTER.getGateway(l1Token);\n IERC20(l1Token).safeIncreaseAllowance(erc20Gateway, amount);\n\n // `outboundTransfer` expects that the caller includes a bytes message as the last param that includes the\n // maxSubmissionCost to use when creating an L2 retryable ticket: https://github.com/OffchainLabs/arbitrum/blob/e98d14873dd77513b569771f47b5e05b72402c5e/packages/arb-bridge-peripherals/contracts/tokenbridge/ethereum/gateway/L1GatewayRouter.sol#L232\n bytes memory data = abi.encode(L2_MAX_SUBMISSION_COST, \"\");\n\n // Note: Legacy routers don't have the outboundTransferCustomRefund method, so default to using\n // outboundTransfer(). Legacy routers are used for the following tokens that are currently enabled:\n // - DAI: the implementation of `outboundTransfer` at the current DAI custom gateway\n // (https://etherscan.io/address/0xD3B5b60020504bc3489D6949d545893982BA3011#writeContract) sets the\n // sender as the refund address so the aliased HubPool should receive excess funds. Implementation here:\n // https://github.com/makerdao/arbitrum-dai-bridge/blob/11a80385e2622968069c34d401b3d54a59060e87/contracts/l1/L1DaiGateway.sol#L109\n if (l1Token == L1_DAI) {\n // This means that the excess ETH to pay for the L2 transaction will be sent to the aliased\n // contract address on L2, which we'd have to retrieve via a custom adapter, the Arbitrum_RescueAdapter.\n // To do so, in a single transaction: 1) setCrossChainContracts to Arbitrum_RescueAdapter, 2) relayMessage\n // with function data = abi.encode(amountToRescue), 3) setCrossChainContracts back to this adapter.\n L1_ERC20_GATEWAY_ROUTER.outboundTransfer{ value: requiredL1CallValue }(\n l1Token,\n to,\n amount,\n RELAY_TOKENS_L2_GAS_LIMIT,\n L2_GAS_PRICE,\n data\n );\n } else {\n L1_ERC20_GATEWAY_ROUTER.outboundTransferCustomRefund{ value: requiredL1CallValue }(\n l1Token,\n L2_REFUND_L2_ADDRESS,\n to,\n amount,\n RELAY_TOKENS_L2_GAS_LIMIT,\n L2_GAS_PRICE,\n data\n );\n }\n }\n emit TokensRelayed(l1Token, l2Token, amount, to);\n }\n\n /**\n * @notice Returns required amount of ETH to send a message via the Inbox.\n * @param l2GasLimit L2 gas limit for the message.\n * @return amount of ETH that this contract needs to hold in order for relayMessage to succeed.\n */\n function getL1CallValue(uint32 l2GasLimit) public pure returns (uint256) {\n return L2_MAX_SUBMISSION_COST + L2_GAS_PRICE * l2GasLimit;\n }\n\n function _contractHasSufficientEthBalance(uint32 l2GasLimit) internal view returns (uint256) {\n uint256 requiredL1CallValue = getL1CallValue(l2GasLimit);\n require(address(this).balance >= requiredL1CallValue, \"Insufficient ETH balance\");\n return requiredL1CallValue;\n }\n}\n"
+ },
+ "contracts/chain-adapters/Arbitrum_CustomGasToken_Adapter.sol": {
+ "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\n\nimport { AdapterInterface } from \"./interfaces/AdapterInterface.sol\";\n\nimport { IERC20 } from \"@openzeppelin/contracts/token/ERC20/IERC20.sol\";\nimport { SafeERC20 } from \"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\";\nimport { ITokenMessenger as ICCTPTokenMessenger } from \"../external/interfaces/CCTPInterfaces.sol\";\nimport { CircleCCTPAdapter, CircleDomainIds } from \"../libraries/CircleCCTPAdapter.sol\";\nimport { ArbitrumERC20Bridge as ArbitrumL1ERC20Bridge, ArbitrumCustomGasTokenInbox as ArbitrumL1InboxLike, ArbitrumL1ERC20GatewayLike } from \"../interfaces/ArbitrumBridge.sol\";\n\n/**\n * @notice Interface for funder contract that this contract pulls from to pay for relayMessage()/relayTokens()\n * fees using a custom gas token.\n */\ninterface FunderInterface {\n /**\n * @notice Withdraws amount of token from funder contract to the caller.\n * @dev Can only be called by owner of Funder contract, which therefore must be\n * this contract.\n * @param token Token to withdraw.\n * @param amount Amount to withdraw.\n */\n function withdraw(IERC20 token, uint256 amount) external;\n}\n\n/**\n * @notice Contract containing logic to send messages from L1 to Arbitrum.\n * @dev Public functions calling external contracts do not guard against reentrancy because they are expected to be\n * called via delegatecall, which will execute this contract's logic within the context of the originating contract.\n * For example, the HubPool will delegatecall these functions, therefore its only necessary that the HubPool's methods\n * that call this contract's logic guard against reentrancy.\n * @dev This contract is very similar to Arbitrum_Adapter but it allows the caller to pay for submission\n * fees using a custom gas token. This is required to support certain Arbitrum orbit L2s and L3s.\n * @dev https://docs.arbitrum.io/launch-orbit-chain/how-tos/use-a-custom-gas-token\n */\n\n// solhint-disable-next-line contract-name-camelcase\ncontract Arbitrum_CustomGasToken_Adapter is AdapterInterface, CircleCCTPAdapter {\n using SafeERC20 for IERC20;\n\n // Amount of gas token allocated to pay for the base submission fee. The base submission fee is a parameter unique to\n // retryable transactions; the user is charged the base submission fee to cover the storage costs of keeping their\n // ticket’s calldata in the retry buffer. (current base submission fee is queryable via\n // ArbRetryableTx.getSubmissionPrice). ArbRetryableTicket precompile interface exists at L2 address\n // 0x000000000000000000000000000000000000006E.\n // The Arbitrum Inbox requires that this uses 18 decimal precision.\n uint256 public immutable L2_MAX_SUBMISSION_COST;\n\n // L2 Gas price bid for immediate L2 execution attempt (queryable via standard eth*gasPrice RPC)\n // The Arbitrum Inbox requires that this is specified in gWei (e.g. 1e9 = 1 gWei)\n uint256 public immutable L2_GAS_PRICE;\n\n // Native token expected to be sent in L2 message. Should be 0 for most use cases of this constant. This\n // constant is unused when sending the native gas token over the inbox since the inbox interprets `l2CallValue`\n // as the amount of the L2 native token to send.\n uint256 public constant L2_CALL_VALUE = 0;\n\n // Gas limit for L2 execution of a cross chain token transfer sent via the inbox.\n uint32 public constant RELAY_TOKENS_L2_GAS_LIMIT = 300_000;\n // Gas limit for L2 execution of a message sent via the inbox.\n uint32 public constant RELAY_MESSAGE_L2_GAS_LIMIT = 2_000_000;\n\n // The number of decimals of precision for the custom gas token. This is defined in the constructor and not dynamically fetched since decimals are\n // not part of the standard ERC20 interface.\n uint8 public immutable NATIVE_TOKEN_DECIMALS;\n\n // This address on L2 receives extra gas token that is left over after relaying a message via the inbox.\n address public immutable L2_REFUND_L2_ADDRESS;\n\n // Inbox system contract to send messages to Arbitrum. Token bridges use this to send tokens to L2.\n // https://github.com/OffchainLabs/nitro-contracts/blob/f7894d3a6d4035ba60f51a7f1334f0f2d4f02dce/src/bridge/Inbox.sol\n ArbitrumL1InboxLike public immutable L1_INBOX;\n\n // Router contract to send tokens to Arbitrum. Routes to correct gateway to bridge tokens. Internally this\n // contract calls the Inbox.\n // Generic gateway: https://github.com/OffchainLabs/token-bridge-contracts/blob/main/contracts/tokenbridge/ethereum/gateway/L1ArbitrumGateway.sol\n // Gateway used for communicating with chains that use custom gas tokens:\n // https://github.com/OffchainLabs/token-bridge-contracts/blob/main/contracts/tokenbridge/ethereum/gateway/L1ERC20Gateway.sol\n ArbitrumL1ERC20GatewayLike public immutable L1_ERC20_GATEWAY_ROUTER;\n\n // This token is used to pay for l1 to l2 messages if its configured by an Arbitrum orbit chain.\n IERC20 public immutable CUSTOM_GAS_TOKEN;\n\n // Contract that funds Inbox cross chain messages with the custom gas token.\n FunderInterface public immutable CUSTOM_GAS_TOKEN_FUNDER;\n\n error InvalidCustomGasToken();\n error InsufficientCustomGasToken();\n error InvalidNativeTokenDecimals();\n\n /**\n * @notice Constructs new Adapter.\n * @param _l1ArbitrumInbox Inbox helper contract to send messages to Arbitrum.\n * @param _l1ERC20GatewayRouter ERC20 gateway router contract to send tokens to Arbitrum.\n * @param _l2RefundL2Address L2 address to receive gas refunds on after a message is relayed.\n * @param _l1Usdc USDC address on L1.\n * @param _cctpTokenMessenger TokenMessenger contract to bridge via CCTP.\n * @param _cctpDomainId Circle CCTP domain identifier for the destination chain.\n * @param _nativeTokenDecimals Number of decimals corresponding to the L2's gas/fee token.\n * @param _customGasTokenFunder Contract that funds the custom gas token.\n * @param _l2MaxSubmissionCost Amount of gas token allocated to pay for the base submission fee. The base\n * submission fee is a parameter unique to Arbitrum retryable transactions. This value is hardcoded\n * and used for all messages sent by this adapter.\n * @param _l2GasPrice Gas price bid for L2 execution. Should be set conservatively high to avoid stuck messages.\n */\n constructor(\n ArbitrumL1InboxLike _l1ArbitrumInbox,\n ArbitrumL1ERC20GatewayLike _l1ERC20GatewayRouter,\n address _l2RefundL2Address,\n IERC20 _l1Usdc,\n ICCTPTokenMessenger _cctpTokenMessenger,\n uint32 _cctpDomainId,\n uint8 _nativeTokenDecimals,\n FunderInterface _customGasTokenFunder,\n uint256 _l2MaxSubmissionCost,\n uint256 _l2GasPrice\n ) CircleCCTPAdapter(_l1Usdc, _cctpTokenMessenger, _cctpDomainId) {\n L1_INBOX = _l1ArbitrumInbox;\n L1_ERC20_GATEWAY_ROUTER = _l1ERC20GatewayRouter;\n L2_REFUND_L2_ADDRESS = _l2RefundL2Address;\n CUSTOM_GAS_TOKEN = IERC20(L1_INBOX.bridge().nativeToken());\n if (address(CUSTOM_GAS_TOKEN) == address(0)) revert InvalidCustomGasToken();\n L2_MAX_SUBMISSION_COST = _l2MaxSubmissionCost;\n L2_GAS_PRICE = _l2GasPrice;\n CUSTOM_GAS_TOKEN_FUNDER = _customGasTokenFunder;\n if (_nativeTokenDecimals == 0) revert InvalidNativeTokenDecimals();\n NATIVE_TOKEN_DECIMALS = _nativeTokenDecimals;\n }\n\n /**\n * @notice Send cross-chain message to target on Arbitrum.\n * @notice This contract must hold at least getL1CallValue() amount of the custom gas token\n * to send a message via the Inbox successfully, or the message will get stuck.\n * @param target Contract on Arbitrum that will receive message.\n * @param message Data to send to target.\n */\n function relayMessage(address target, bytes memory message) external payable override {\n uint256 requiredL1TokenTotalFeeAmount = _pullCustomGas(RELAY_MESSAGE_L2_GAS_LIMIT);\n CUSTOM_GAS_TOKEN.safeIncreaseAllowance(address(L1_INBOX), requiredL1TokenTotalFeeAmount);\n L1_INBOX.createRetryableTicket(\n target, // destAddr destination L2 contract address\n L2_CALL_VALUE, // l2CallValue call value for retryable L2 message\n L2_MAX_SUBMISSION_COST, // maxSubmissionCost Max gas deducted from user's L2 balance to cover base fee\n L2_REFUND_L2_ADDRESS, // excessFeeRefundAddress maxgas * gasprice - execution cost gets credited here on L2\n L2_REFUND_L2_ADDRESS, // callValueRefundAddress l2Callvalue gets credited here on L2 if retryable txn times out or gets cancelled\n RELAY_MESSAGE_L2_GAS_LIMIT, // maxGas Max gas deducted from user's L2 balance to cover L2 execution\n L2_GAS_PRICE, // gasPriceBid price bid for L2 execution\n requiredL1TokenTotalFeeAmount, // tokenTotalFeeAmount amount of fees to be deposited in native token.\n // This should be in the precision of the custom gas token.\n message // data ABI encoded data of L2 message\n );\n emit MessageRelayed(target, message);\n }\n\n /**\n * @notice Bridge tokens to Arbitrum.\n * @notice This contract must hold at least getL1CallValue() amount of ETH or custom gas token\n * to send a message via the Inbox successfully, or the message will get stuck.\n * @param l1Token L1 token to deposit.\n * @param l2Token L2 token to receive.\n * @param amount Amount of L1 tokens to deposit and L2 tokens to receive.\n * @param to Bridge recipient.\n */\n function relayTokens(\n address l1Token,\n address l2Token, // l2Token is unused for Arbitrum.\n uint256 amount,\n address to\n ) external payable override {\n // Check if this token is USDC, which requires a custom bridge via CCTP.\n if (_isCCTPEnabled() && l1Token == address(usdcToken)) {\n _transferUsdc(to, amount);\n }\n // If not, we can use the Arbitrum gateway\n else {\n address erc20Gateway = L1_ERC20_GATEWAY_ROUTER.getGateway(l1Token);\n\n // If custom gas token, call special functions that handle paying with custom gas tokens.\n uint256 requiredL1TokenTotalFeeAmount = _pullCustomGas(RELAY_MESSAGE_L2_GAS_LIMIT);\n\n // Must use Inbox to bridge custom gas token.\n // Source: https://github.com/OffchainLabs/token-bridge-contracts/blob/5bdf33259d2d9ae52ddc69bc5a9cbc558c4c40c7/contracts/tokenbridge/ethereum/gateway/L1OrbitERC20Gateway.sol#L33\n if (l1Token == address(CUSTOM_GAS_TOKEN)) {\n // amount and requiredL1TokenTotalFeeAmount are in the precision of the custom gas token.\n uint256 amountToBridge = amount + requiredL1TokenTotalFeeAmount;\n CUSTOM_GAS_TOKEN.safeIncreaseAllowance(address(L1_INBOX), amountToBridge);\n // Both `l2CallValue` and `tokenTotalFeeAmount` are rounded in the conversion to/from native/18 decimals. `l2CallValue` is rounded down by the call to _fromNativeTo18Decimals()\n // in cases where the token's decimals exceeds 18, since we would rather round down and be forced to donate a small amount of the l2 token to the spoke pool to cover the roundoff\n // error than overshoot a transfer amount. `amountToBridge` is rounded up since we would rather overpay for gas and be refunded on l2 than underpay and risk stuck cross-chain messages.\n L1_INBOX.createRetryableTicket(\n to, // destAddr destination L2 contract address\n _fromNativeTo18Decimals(amount), // l2CallValue call value for retryable L2 message\n L2_MAX_SUBMISSION_COST, // maxSubmissionCost Max gas deducted from user's L2 balance to cover base fee\n L2_REFUND_L2_ADDRESS, // excessFeeRefundAddress maxgas * gasprice - execution cost gets credited here on L2\n L2_REFUND_L2_ADDRESS, // callValueRefundAddress l2Callvalue gets credited here on L2 if retryable txn times out or gets cancelled\n RELAY_MESSAGE_L2_GAS_LIMIT, // maxGas Max gas deducted from user's L2 balance to cover L2 execution\n L2_GAS_PRICE, // gasPriceBid price bid for L2 execution\n amountToBridge, // tokenTotalFeeAmount amount of fees to be deposited in native token.\n \"0x\" // data ABI encoded data of L2 message\n );\n } else {\n IERC20(l1Token).safeIncreaseAllowance(erc20Gateway, amount);\n CUSTOM_GAS_TOKEN.safeIncreaseAllowance(erc20Gateway, requiredL1TokenTotalFeeAmount);\n\n // To pay for gateway outbound transfer with custom gas token, encode the tokenTotalFeeAmount in the data field:\n // The data format should be (uint256 maxSubmissionCost, bytes extraData, uint256 tokenTotalFeeAmount).\n // Source: https://github.com/OffchainLabs/token-bridge-contracts/blob/5bdf33259d2d9ae52ddc69bc5a9cbc558c4c40c7/contracts/tokenbridge/ethereum/gateway/L1OrbitERC20Gateway.sol#L57\n bytes memory data = abi.encode(L2_MAX_SUBMISSION_COST, \"\", requiredL1TokenTotalFeeAmount);\n L1_ERC20_GATEWAY_ROUTER.outboundTransferCustomRefund(\n l1Token,\n L2_REFUND_L2_ADDRESS,\n to,\n amount,\n RELAY_TOKENS_L2_GAS_LIMIT,\n L2_GAS_PRICE,\n data\n );\n }\n }\n emit TokensRelayed(l1Token, l2Token, amount, to);\n }\n\n /**\n * @notice Returns required amount of gas token to send a message via the Inbox.\n * @dev Should return a value in the same precision as the gas token's precision.\n * @param l2GasLimit L2 gas limit for the message.\n * @return amount of gas token that this contract needs to hold in order for relayMessage to succeed.\n */\n function getL1CallValue(uint32 l2GasLimit) public view returns (uint256) {\n return _from18ToNativeDecimals(L2_MAX_SUBMISSION_COST + L2_GAS_PRICE * l2GasLimit);\n }\n\n function _pullCustomGas(uint32 l2GasLimit) internal returns (uint256) {\n uint256 requiredL1CallValue = getL1CallValue(l2GasLimit);\n CUSTOM_GAS_TOKEN_FUNDER.withdraw(CUSTOM_GAS_TOKEN, requiredL1CallValue);\n if (CUSTOM_GAS_TOKEN.balanceOf(address(this)) < requiredL1CallValue) revert InsufficientCustomGasToken();\n return requiredL1CallValue;\n }\n\n function _from18ToNativeDecimals(uint256 amount) internal view returns (uint256) {\n if (NATIVE_TOKEN_DECIMALS == 18) {\n return amount;\n } else if (NATIVE_TOKEN_DECIMALS < 18) {\n // Round up the division result so that the L1 call value is always sufficient to cover the submission fee.\n uint256 reductionFactor = 10**(18 - NATIVE_TOKEN_DECIMALS);\n uint256 divFloor = amount / reductionFactor;\n uint256 mod = amount % reductionFactor;\n if (mod != 0) {\n return divFloor + 1;\n } else {\n return divFloor;\n }\n } else {\n return amount * 10**(NATIVE_TOKEN_DECIMALS - 18);\n }\n }\n\n function _fromNativeTo18Decimals(uint256 amount) internal view returns (uint256) {\n if (NATIVE_TOKEN_DECIMALS == 18) {\n return amount;\n } else if (NATIVE_TOKEN_DECIMALS < 18) {\n return amount * 10**(18 - NATIVE_TOKEN_DECIMALS);\n } else {\n return amount / 10**(NATIVE_TOKEN_DECIMALS - 18);\n }\n }\n}\n"
+ },
+ "contracts/chain-adapters/Arbitrum_RescueAdapter.sol": {
+ "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\n\nimport \"./interfaces/AdapterInterface.sol\";\nimport \"./Arbitrum_Adapter.sol\"; // Used to import `ArbitrumL1ERC20GatewayLike` and `ArbitrumL1InboxLike`\n\nimport \"@openzeppelin/contracts/token/ERC20/IERC20.sol\";\nimport \"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\";\n\n/**\n * @notice Meant to copy the Arbitrum_Adapter exactly in how it sends L1 --> L2 messages but is designed only to be\n * used by the owner of the HubPool to retrieve ETH held by its aliased address on L2. This ETH builds up because\n * `relayTokens` calls `l1ERC20GatewayRouter.outboundTransfer` which does not allow the caller to specify an L2 refund\n * address the same way that `l1Inbox.createRetryableTicket` does. This means that the alias address of the caller, the\n * HubPool in this case, receives ETH on L2. This Adapter can be used to send messages to Arbitrum specifically to send\n * transactions as if called by the aliased HubPool address.\n */\n\n// solhint-disable-next-line contract-name-camelcase\ncontract Arbitrum_RescueAdapter is AdapterInterface {\n using SafeERC20 for IERC20;\n\n // Amount of ETH allocated to pay for the base submission fee. The base submission fee is a parameter unique to\n // retryable transactions; the user is charged the base submission fee to cover the storage costs of keeping their\n // ticket’s calldata in the retry buffer. (current base submission fee is queryable via\n // ArbRetryableTx.getSubmissionPrice). ArbRetryableTicket precompile interface exists at L2 address\n // 0x000000000000000000000000000000000000006E.\n uint256 public immutable l2MaxSubmissionCost = 0.01e18;\n\n // L2 Gas price bid for immediate L2 execution attempt (queryable via standard eth*gasPrice RPC)\n uint256 public immutable l2GasPrice = 5e9; // 5 gWei\n\n // Gas limit for immediate L2 execution attempt (can be estimated via NodeInterface.estimateRetryableTicket).\n // NodeInterface precompile interface exists at L2 address 0x00000000000000000000000000000000000000C8\n uint32 public immutable l2GasLimit = 2_000_000;\n\n // This address on L2 receives extra ETH that is left over after relaying a message via the inbox.\n address public immutable l2RefundL2Address;\n\n // L1 HubPool address aliased on L2: https://github.com/OffchainLabs/arbitrum/blob/master/docs/L1_L2_Messages.md#address-aliasing\n address public immutable aliasedL2HubPoolAddress = 0xd297fA914353c44B2e33EBE05F21846f1048CFeB;\n\n ArbitrumL1InboxLike public immutable l1Inbox;\n\n /**\n * @notice Constructs new Adapter.\n * @param _l1ArbitrumInbox Inbox helper contract to send messages to Arbitrum.\n */\n constructor(ArbitrumL1InboxLike _l1ArbitrumInbox) {\n l1Inbox = _l1ArbitrumInbox;\n\n l2RefundL2Address = msg.sender;\n }\n\n /**\n * @notice Send cross-chain message to aliased hub pool address on Arbitrum.\n * @notice This contract must hold at least getL1CallValue() amount of ETH to send a message via the Inbox\n * successfully, or the message will get stuck.\n * @param message Data to send to aliased hub pool.\n */\n function relayMessage(address, bytes memory message) external payable override {\n uint256 valueToReturn = abi.decode(message, (uint256));\n\n uint256 requiredL1CallValue = _contractHasSufficientEthBalance();\n\n // In the rescue ETH setup, we send the transaction to the refund address, we provide a call value equal to the\n // amount we want to rescue, and we specify an empty calldata, since it's a simple ETH transfer.\n // Note: we use the unsafe version of createRetryableTicket because it doesn't require the msg.sender to pass\n // in arbTxCallValue in addition to maxSubmissionCost + maxGas * gasPriceBid.\n l1Inbox.unsafeCreateRetryableTicket{ value: requiredL1CallValue }(\n l2RefundL2Address, // destAddr destination L2 contract address\n valueToReturn, // l2CallValue call value for retryable L2 message\n l2MaxSubmissionCost, // maxSubmissionCost Max gas deducted from user's L2 balance to cover base fee\n l2RefundL2Address, // excessFeeRefundAddress maxgas * gasprice - execution cost gets credited here on L2\n l2RefundL2Address, // callValueRefundAddress l2Callvalue gets credited here on L2 if retryable txn times out or gets cancelled\n l2GasLimit, // maxGas Max gas deducted from user's L2 balance to cover L2 execution\n l2GasPrice, // gasPriceBid price bid for L2 execution\n \"\" // data ABI encoded data of L2 message\n );\n\n emit MessageRelayed(aliasedL2HubPoolAddress, \"\");\n }\n\n /**\n * @notice Should never be called.\n */\n function relayTokens(\n address,\n address,\n uint256,\n address\n ) external payable override {\n revert(\"useless function\");\n }\n\n /**\n * @notice Returns required amount of ETH to send a message via the Inbox.\n * @return amount of ETH that this contract needs to hold in order for relayMessage to succeed.\n */\n function getL1CallValue() public pure returns (uint256) {\n return l2MaxSubmissionCost + l2GasPrice * l2GasLimit;\n }\n\n function _contractHasSufficientEthBalance() internal view returns (uint256 requiredL1CallValue) {\n requiredL1CallValue = getL1CallValue();\n require(address(this).balance >= requiredL1CallValue, \"Insufficient ETH balance\");\n }\n}\n"
+ },
+ "contracts/chain-adapters/Arbitrum_SendTokensAdapter.sol": {
+ "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\n\nimport \"./interfaces/AdapterInterface.sol\";\nimport { ArbitrumL1ERC20GatewayLike } from \"./Arbitrum_Adapter.sol\";\n\nimport \"@openzeppelin/contracts/token/ERC20/IERC20.sol\";\nimport \"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\";\n\n/**\n * @notice This adapter is built for emergencies to send funds from the Hub to a Spoke in the event that a spoke pool\n * received a duplicate root bundle relay, due to some replay issue.\n */\n// solhint-disable-next-line contract-name-camelcase\ncontract Arbitrum_SendTokensAdapter is AdapterInterface {\n using SafeERC20 for IERC20;\n\n uint256 public immutable l2MaxSubmissionCost = 0.01e18;\n uint256 public immutable l2GasPrice = 5e9;\n uint32 public constant RELAY_TOKENS_L2_GAS_LIMIT = 300_000;\n\n ArbitrumL1ERC20GatewayLike public immutable l1ERC20GatewayRouter;\n address public immutable l2RefundL2Address;\n\n /**\n * @notice Constructs new Adapter.\n * @param _l1ERC20GatewayRouter ERC20 gateway router contract to send tokens to Arbitrum.\n * @param _l2RefundL2Address L2 address to receive gas refunds on after a message is relayed.\n */\n constructor(ArbitrumL1ERC20GatewayLike _l1ERC20GatewayRouter, address _l2RefundL2Address) {\n l1ERC20GatewayRouter = _l1ERC20GatewayRouter;\n l2RefundL2Address = _l2RefundL2Address;\n }\n\n /**\n * @notice Send tokens to SpokePool. Enables HubPool admin to call relaySpokePoolAdminFunction that will trigger\n * this function.\n * @dev This performs similar logic to relayTokens in the normal Arbitrum_Adapter by sending tokens\n * the Arbitrum_SpokePool out of the HubPool.\n * @param message The encoded address of the ERC20 to send to the rescue address.\n */\n function relayMessage(address target, bytes memory message) external payable override {\n (address l1Token, uint256 amount) = abi.decode(message, (address, uint256));\n\n uint256 requiredL1CallValue = _contractHasSufficientEthBalance();\n\n // Approve the gateway, not the router, to spend the hub pool's balance. The gateway, which is different\n // per L1 token, will temporarily escrow the tokens to be bridged and pull them from this contract.\n address erc20Gateway = l1ERC20GatewayRouter.getGateway(l1Token);\n IERC20(l1Token).safeIncreaseAllowance(erc20Gateway, amount);\n\n // `outboundTransfer` expects that the caller includes a bytes message as the last param that includes the\n // maxSubmissionCost to use when creating an L2 retryable ticket: https://github.com/OffchainLabs/arbitrum/blob/e98d14873dd77513b569771f47b5e05b72402c5e/packages/arb-bridge-peripherals/contracts/tokenbridge/ethereum/gateway/L1GatewayRouter.sol#L232\n bytes memory data = abi.encode(l2MaxSubmissionCost, \"\");\n\n l1ERC20GatewayRouter.outboundTransferCustomRefund{ value: requiredL1CallValue }(\n l1Token,\n l2RefundL2Address,\n target,\n amount,\n RELAY_TOKENS_L2_GAS_LIMIT,\n l2GasPrice,\n data\n );\n\n // Purposefully not emitting any events so as not to confuse off-chain monitors that track this event.\n // emit TokensRelayed(l1Token, l2Token, amount, to);\n }\n\n /**\n * @notice Should never be called.\n */\n function relayTokens(\n address,\n address,\n uint256,\n address\n ) external payable override {\n revert(\"relayTokens disabled\");\n }\n\n /**\n * @notice Returns required amount of ETH to send a message via the Inbox.\n * @return amount of ETH that this contract needs to hold in order for relayMessage to succeed.\n */\n function getL1CallValue() public pure returns (uint256) {\n return l2MaxSubmissionCost + l2GasPrice * RELAY_TOKENS_L2_GAS_LIMIT;\n }\n\n function _contractHasSufficientEthBalance() internal view returns (uint256 requiredL1CallValue) {\n requiredL1CallValue = getL1CallValue();\n require(address(this).balance >= requiredL1CallValue, \"Insufficient ETH balance\");\n }\n}\n"
+ },
+ "contracts/chain-adapters/Base_Adapter.sol": {
+ "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\n\nimport \"./interfaces/AdapterInterface.sol\";\nimport \"../external/interfaces/WETH9Interface.sol\";\n\n// @dev Use local modified CrossDomainEnabled contract instead of one exported by eth-optimism because we need\n// this contract's state variables to be `immutable` because of the delegateCall call.\nimport \"./CrossDomainEnabled.sol\";\nimport \"@eth-optimism/contracts/L1/messaging/IL1StandardBridge.sol\";\n\nimport \"@openzeppelin/contracts/token/ERC20/IERC20.sol\";\nimport \"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\";\n\nimport \"../libraries/CircleCCTPAdapter.sol\";\nimport \"../external/interfaces/CCTPInterfaces.sol\";\n\n/**\n * @notice Contract containing logic to send messages from L1 to Base. This is a modified version of the Optimism adapter\n * that excludes the custom bridging logic.\n * @custom:security-contact bugs@across.to\n * @dev Public functions calling external contracts do not guard against reentrancy because they are expected to be\n * called via delegatecall, which will execute this contract's logic within the context of the originating contract.\n * For example, the HubPool will delegatecall these functions, therefore its only necessary that the HubPool's methods\n * that call this contract's logic guard against reentrancy.\n */\n\n// solhint-disable-next-line contract-name-camelcase\ncontract Base_Adapter is CrossDomainEnabled, AdapterInterface, CircleCCTPAdapter {\n using SafeERC20 for IERC20;\n uint32 public constant L2_GAS_LIMIT = 200_000;\n\n WETH9Interface public immutable L1_WETH;\n\n IL1StandardBridge public immutable L1_STANDARD_BRIDGE;\n\n /**\n * @notice Constructs new Adapter.\n * @param _l1Weth WETH address on L1.\n * @param _crossDomainMessenger XDomainMessenger Base system contract.\n * @param _l1StandardBridge Standard bridge contract.\n * @param _l1Usdc USDC address on L1.\n * @param _cctpTokenMessenger TokenMessenger contract to bridge via CCTP.\n */\n constructor(\n WETH9Interface _l1Weth,\n address _crossDomainMessenger,\n IL1StandardBridge _l1StandardBridge,\n IERC20 _l1Usdc,\n ITokenMessenger _cctpTokenMessenger\n ) CrossDomainEnabled(_crossDomainMessenger) CircleCCTPAdapter(_l1Usdc, _cctpTokenMessenger, CircleDomainIds.Base) {\n L1_WETH = _l1Weth;\n L1_STANDARD_BRIDGE = _l1StandardBridge;\n }\n\n /**\n * @notice Send cross-chain message to target on Base.\n * @param target Contract on Base that will receive message.\n * @param message Data to send to target.\n */\n function relayMessage(address target, bytes calldata message) external payable override {\n sendCrossDomainMessage(target, L2_GAS_LIMIT, message);\n emit MessageRelayed(target, message);\n }\n\n /**\n * @notice Bridge tokens to Base.\n * @param l1Token L1 token to deposit.\n * @param l2Token L2 token to receive.\n * @param amount Amount of L1 tokens to deposit and L2 tokens to receive.\n * @param to Bridge recipient.\n */\n function relayTokens(\n address l1Token,\n address l2Token,\n uint256 amount,\n address to\n ) external payable override {\n // If the l1Token is weth then unwrap it to ETH then send the ETH to the standard bridge.\n if (l1Token == address(L1_WETH)) {\n L1_WETH.withdraw(amount);\n L1_STANDARD_BRIDGE.depositETHTo{ value: amount }(to, L2_GAS_LIMIT, \"\");\n }\n // Check if this token is USDC, which requires a custom bridge via CCTP.\n else if (_isCCTPEnabled() && l1Token == address(usdcToken)) {\n _transferUsdc(to, amount);\n } else {\n IL1StandardBridge _l1StandardBridge = L1_STANDARD_BRIDGE;\n\n IERC20(l1Token).safeIncreaseAllowance(address(_l1StandardBridge), amount);\n _l1StandardBridge.depositERC20To(l1Token, l2Token, to, amount, L2_GAS_LIMIT, \"\");\n }\n emit TokensRelayed(l1Token, l2Token, amount, to);\n }\n}\n"
+ },
+ "contracts/chain-adapters/Blast_Adapter.sol": {
+ "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\n\nimport \"./interfaces/AdapterInterface.sol\";\nimport \"../external/interfaces/WETH9Interface.sol\";\n\n// @dev Use local modified CrossDomainEnabled contract instead of one exported by eth-optimism because we need\n// this contract's state variables to be `immutable` because of the delegateCall call.\nimport \"./CrossDomainEnabled.sol\";\nimport { IL1StandardBridge } from \"@eth-optimism/contracts/L1/messaging/IL1StandardBridge.sol\";\n\nimport \"@openzeppelin/contracts/token/ERC20/IERC20.sol\";\nimport \"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\";\n\nimport \"../libraries/CircleCCTPAdapter.sol\";\nimport \"../external/interfaces/CCTPInterfaces.sol\";\n\ninterface IL1ERC20Bridge {\n /// @notice Sends ERC20 tokens to a receiver's address on the other chain. Note that if the\n /// ERC20 token on the other chain does not recognize the local token as the correct\n /// pair token, the ERC20 bridge will fail and the tokens will be returned to sender on\n /// this chain.\n /// @param _localToken Address of the ERC20 on this chain.\n /// @param _remoteToken Address of the corresponding token on the remote chain.\n /// @param _to Address of the receiver.\n /// @param _amount Amount of local tokens to deposit.\n /// @param _minGasLimit Minimum amount of gas that the bridge can be relayed with.\n /// @param _extraData Extra data to be sent with the transaction. Note that the recipient will\n /// not be triggered with this data, but it will be emitted and can be used\n /// to identify the transaction.\n function bridgeERC20To(\n address _localToken,\n address _remoteToken,\n address _to,\n uint256 _amount,\n uint32 _minGasLimit,\n bytes calldata _extraData\n ) external;\n}\n\n/**\n * @notice Contract containing logic to send messages from L1 to Blast. This is a modified version of the Optimism adapter\n * that excludes the custom bridging logic. It differs from the Base Adapter in that it uses a special\n * Blast contract to bridge WETH and DAI, which are yielding rebasing tokens on L2, WETH and USDB.\n * @custom:security-contact bugs@across.to\n */\n\n// solhint-disable-next-line contract-name-camelcase\ncontract Blast_Adapter is CrossDomainEnabled, AdapterInterface, CircleCCTPAdapter {\n using SafeERC20 for IERC20;\n uint32 public immutable L2_GAS_LIMIT; // 200,000 is a reasonable default.\n\n WETH9Interface public immutable L1_WETH;\n\n IL1StandardBridge public immutable L1_STANDARD_BRIDGE; // 0x697402166Fbf2F22E970df8a6486Ef171dbfc524\n\n // Bridge used to get yielding version of ERC20's on L2.\n IL1ERC20Bridge public immutable L1_BLAST_BRIDGE; // 0x3a05E5d33d7Ab3864D53aaEc93c8301C1Fa49115 on mainnet.\n address public immutable L1_DAI; // 0x6B175474E89094C44Da98b954EedeAC495271d0F on mainnet.\n\n /**\n * @notice Constructs new Adapter.\n * @param _l1Weth WETH address on L1.\n * @param _crossDomainMessenger XDomainMessenger Blast system contract.\n * @param _l1StandardBridge Standard bridge contract.\n * @param _l1Usdc USDC address on L1.\n */\n constructor(\n WETH9Interface _l1Weth,\n address _crossDomainMessenger,\n IL1StandardBridge _l1StandardBridge,\n IERC20 _l1Usdc,\n IL1ERC20Bridge l1BlastBridge,\n address l1Dai,\n uint32 l2GasLimit\n )\n CrossDomainEnabled(_crossDomainMessenger)\n // Hardcode cctp messenger to 0x0 to disable CCTP bridging.\n CircleCCTPAdapter(_l1Usdc, ITokenMessenger(address(0)), CircleDomainIds.UNINITIALIZED)\n {\n L1_WETH = _l1Weth;\n L1_STANDARD_BRIDGE = _l1StandardBridge;\n L1_BLAST_BRIDGE = l1BlastBridge;\n L1_DAI = l1Dai;\n L2_GAS_LIMIT = l2GasLimit;\n }\n\n /**\n * @notice Send cross-chain message to target on Blast.\n * @param target Contract on Blast that will receive message.\n * @param message Data to send to target.\n */\n function relayMessage(address target, bytes calldata message) external payable override {\n sendCrossDomainMessage(target, L2_GAS_LIMIT, message);\n emit MessageRelayed(target, message);\n }\n\n /**\n * @notice Bridge tokens to Blast.\n * @param l1Token L1 token to deposit.\n * @param l2Token L2 token to receive.\n * @param amount Amount of L1 tokens to deposit and L2 tokens to receive.\n * @param to Bridge recipient.\n */\n function relayTokens(\n address l1Token,\n address l2Token,\n uint256 amount,\n address to\n ) external payable override {\n // If token can be bridged into yield-ing version of ERC20 on L2 side, then use Blast Bridge, otherwise\n // use standard bridge.\n\n // If the l1Token is weth then unwrap it to ETH then send the ETH to the standard bridge.\n if (l1Token == address(L1_WETH)) {\n L1_WETH.withdraw(amount);\n // @dev: we can use the standard or the blast bridge to deposit ETH here:\n L1_STANDARD_BRIDGE.depositETHTo{ value: amount }(to, L2_GAS_LIMIT, \"\");\n }\n // Check if this token is DAI, then use the L1 Blast Bridge\n else if (l1Token == L1_DAI) {\n IERC20(l1Token).safeIncreaseAllowance(address(L1_BLAST_BRIDGE), amount);\n L1_BLAST_BRIDGE.bridgeERC20To(l1Token, l2Token, to, amount, L2_GAS_LIMIT, \"\");\n } else {\n IL1StandardBridge _l1StandardBridge = L1_STANDARD_BRIDGE;\n\n IERC20(l1Token).safeIncreaseAllowance(address(_l1StandardBridge), amount);\n _l1StandardBridge.depositERC20To(l1Token, l2Token, to, amount, L2_GAS_LIMIT, \"\");\n }\n emit TokensRelayed(l1Token, l2Token, amount, to);\n }\n}\n"
+ },
+ "contracts/chain-adapters/CrossDomainEnabled.sol": {
+ "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\n/* Interface Imports */\nimport { ICrossDomainMessenger } from \"@eth-optimism/contracts/libraries/bridge/ICrossDomainMessenger.sol\";\n\n/**\n * @title CrossDomainEnabled\n * @custom:security-contact bugs@across.to\n * @dev Helper contract for contracts performing cross-domain communications between L1 and Optimism.\n * @dev This modifies the eth-optimism/CrossDomainEnabled contract only by changing state variables to be\n * immutable for use in contracts like the Optimism_Adapter which use delegateCall().\n */\ncontract CrossDomainEnabled {\n // Messenger contract used to send and recieve messages from the other domain.\n address public immutable MESSENGER;\n\n /**\n * @param _messenger Address of the CrossDomainMessenger on the current layer.\n */\n constructor(address _messenger) {\n MESSENGER = _messenger;\n }\n\n /**\n * Gets the messenger, usually from storage. This function is exposed in case a child contract\n * needs to override.\n * @return The address of the cross-domain messenger contract which should be used.\n */\n function getCrossDomainMessenger() internal virtual returns (ICrossDomainMessenger) {\n return ICrossDomainMessenger(MESSENGER);\n }\n\n /**\n * Sends a message to an account on another domain\n * @param _crossDomainTarget The intended recipient on the destination domain\n * @param _gasLimit The gasLimit for the receipt of the message on the target domain.\n * @param _message The data to send to the target (usually calldata to a function with\n * onlyFromCrossDomainAccount())\n */\n function sendCrossDomainMessage(\n address _crossDomainTarget,\n uint32 _gasLimit,\n bytes calldata _message\n ) internal {\n // slither-disable-next-line reentrancy-events, reentrancy-benign\n getCrossDomainMessenger().sendMessage(_crossDomainTarget, _message, _gasLimit);\n }\n}\n"
+ },
+ "contracts/chain-adapters/DoctorWho_Adapter.sol": {
+ "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\n\nimport \"./interfaces/AdapterInterface.sol\";\nimport \"../external/interfaces/WETH9Interface.sol\";\n\n// @dev Use local modified CrossDomainEnabled contract instead of one exported by eth-optimism because we need\n// this contract's state variables to be `immutable` because of the delegateCall call.\nimport \"./CrossDomainEnabled.sol\";\nimport \"@eth-optimism/contracts/L1/messaging/IL1StandardBridge.sol\";\n\nimport \"@openzeppelin/contracts/token/ERC20/IERC20.sol\";\nimport \"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\";\n\nimport \"../libraries/CircleCCTPAdapter.sol\";\nimport \"../external/interfaces/CCTPInterfaces.sol\";\n\n/**\n * @notice Contract containing logic to send messages from L1 to Doctor Who. This is a modified version of the Optimism adapter\n * that excludes the custom bridging logic.\n * @custom:security-contact bugs@across.to\n * @dev Public functions calling external contracts do not guard against reentrancy because they are expected to be\n * called via delegatecall, which will execute this contract's logic within the context of the originating contract.\n * For example, the HubPool will delegatecall these functions, therefore its only necessary that the HubPool's methods\n * that call this contract's logic guard against reentrancy.\n */\n\n// solhint-disable-next-line contract-name-camelcase\ncontract DoctorWho_Adapter is CrossDomainEnabled, AdapterInterface, CircleCCTPAdapter {\n using SafeERC20 for IERC20;\n uint32 public constant L2_GAS_LIMIT = 200_000;\n\n WETH9Interface public immutable L1_WETH;\n\n IL1StandardBridge public immutable L1_STANDARD_BRIDGE;\n\n /**\n * @notice Constructs new Adapter.\n * @param _l1Weth WETH address on L1.\n * @param _crossDomainMessenger XDomainMessenger Doctor Who system contract.\n * @param _l1StandardBridge Standard bridge contract.\n * @param _l1Usdc USDC address on L1.\n * @param _cctpTokenMessenger TokenMessenger contract to bridge via CCTP.\n */\n constructor(\n WETH9Interface _l1Weth,\n address _crossDomainMessenger,\n IL1StandardBridge _l1StandardBridge,\n IERC20 _l1Usdc,\n ITokenMessenger _cctpTokenMessenger\n )\n CrossDomainEnabled(_crossDomainMessenger)\n CircleCCTPAdapter(_l1Usdc, _cctpTokenMessenger, CircleDomainIds.DoctorWho)\n {\n L1_WETH = _l1Weth;\n L1_STANDARD_BRIDGE = _l1StandardBridge;\n }\n\n /**\n * @notice Send cross-chain message to target on Doctor Who.\n * @param target Contract on Doctor Who that will receive message.\n * @param message Data to send to target.\n */\n function relayMessage(address target, bytes calldata message) external payable override {\n sendCrossDomainMessage(target, L2_GAS_LIMIT, message);\n emit MessageRelayed(target, message);\n }\n\n /**\n * @notice Bridge tokens to Doctor Who.\n * @param l1Token L1 token to deposit.\n * @param l2Token L2 token to receive.\n * @param amount Amount of L1 tokens to deposit and L2 tokens to receive.\n * @param to Bridge recipient.\n */\n function relayTokens(\n address l1Token,\n address l2Token,\n uint256 amount,\n address to\n ) external payable override {\n // If the l1Token is weth then unwrap it to ETH then send the ETH to the standard bridge.\n if (l1Token == address(L1_WETH)) {\n L1_WETH.withdraw(amount);\n L1_STANDARD_BRIDGE.depositETHTo{ value: amount }(to, L2_GAS_LIMIT, \"\");\n }\n // Check if this token is USDC, which requires a custom bridge via CCTP.\n else if (_isCCTPEnabled() && l1Token == address(usdcToken)) {\n _transferUsdc(to, amount);\n } else {\n IL1StandardBridge _l1StandardBridge = L1_STANDARD_BRIDGE;\n\n IERC20(l1Token).safeIncreaseAllowance(address(_l1StandardBridge), amount);\n _l1StandardBridge.depositERC20To(l1Token, l2Token, to, amount, L2_GAS_LIMIT, \"\");\n }\n emit TokensRelayed(l1Token, l2Token, amount, to);\n }\n}\n"
+ },
+ "contracts/chain-adapters/interfaces/AdapterInterface.sol": {
+ "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\n\n/**\n * @notice Sends cross chain messages and tokens to contracts on a specific L2 network.\n * This interface is implemented by an adapter contract that is deployed on L1.\n */\n\ninterface AdapterInterface {\n event MessageRelayed(address target, bytes message);\n\n event TokensRelayed(address l1Token, address l2Token, uint256 amount, address to);\n\n /**\n * @notice Send message to `target` on L2.\n * @dev This method is marked payable because relaying the message might require a fee\n * to be paid by the sender to forward the message to L2. However, it will not send msg.value\n * to the target contract on L2.\n * @param target L2 address to send message to.\n * @param message Message to send to `target`.\n */\n function relayMessage(address target, bytes calldata message) external payable;\n\n /**\n * @notice Send `amount` of `l1Token` to `to` on L2. `l2Token` is the L2 address equivalent of `l1Token`.\n * @dev This method is marked payable because relaying the message might require a fee\n * to be paid by the sender to forward the message to L2. However, it will not send msg.value\n * to the target contract on L2.\n * @param l1Token L1 token to bridge.\n * @param l2Token L2 token to receive.\n * @param amount Amount of `l1Token` to bridge.\n * @param to Bridge recipient.\n */\n function relayTokens(\n address l1Token,\n address l2Token,\n uint256 amount,\n address to\n ) external payable;\n}\n"
+ },
+ "contracts/chain-adapters/l2/Arbitrum_WithdrawalHelper.sol": {
+ "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\n\nimport { IERC20 } from \"@openzeppelin/contracts/token/ERC20/IERC20.sol\";\nimport { SafeERC20 } from \"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\";\nimport { ArbitrumL2ERC20GatewayLike } from \"../../interfaces/ArbitrumBridge.sol\";\nimport { WithdrawalHelperBase } from \"./WithdrawalHelperBase.sol\";\nimport { ITokenMessenger } from \"../../external/interfaces/CCTPInterfaces.sol\";\nimport { WETH9Interface } from \"../../external/interfaces/WETH9Interface.sol\";\nimport { CrossDomainAddressUtils } from \"../../libraries/CrossDomainAddressUtils.sol\";\n\n/**\n * @title Arbitrum_WithdrawalHelper\n * @notice This contract interfaces with L2-L1 token bridges and withdraws tokens to a single address on L1.\n * @dev This contract should be deployed on Arbitrum L2s which only use CCTP or the canonical Arbitrum gateway router to withdraw tokens.\n * @custom:security-contact bugs@across.to\n */\ncontract Arbitrum_WithdrawalHelper is WithdrawalHelperBase {\n using SafeERC20 for IERC20;\n\n // Error which triggers when the supplied L1 token does not match the Arbitrum gateway router's expected L2 token.\n error InvalidTokenMapping();\n\n /*\n * @notice Constructs the Arbitrum_WithdrawalHelper.\n * @param _l2Usdc Address of native USDC on the L2.\n * @param _cctpTokenMessenger Address of the CCTP token messenger contract on L2.\n * @param _wrappedNativeToken Address of the wrapped native token contract on L2.\n * @param _destinationCircleDomainId Circle's assigned CCTP domain ID for the destination network. For Ethereum, this is 0.\n * @param _l2GatewayRouter Address of the Arbitrum l2 gateway router contract.\n * @param _tokenRecipient L1 Address which will unconditionally receive tokens withdrawn from this contract.\n */\n constructor(\n IERC20 _l2Usdc,\n ITokenMessenger _cctpTokenMessenger,\n WETH9Interface _wrappedNativeToken,\n uint32 _destinationCircleDomainId,\n address _l2GatewayRouter,\n address _tokenRecipient\n )\n WithdrawalHelperBase(\n _l2Usdc,\n _cctpTokenMessenger,\n _wrappedNativeToken,\n _destinationCircleDomainId,\n _l2GatewayRouter,\n _tokenRecipient\n )\n {}\n\n /**\n * @notice Initializes the withdrawal helper contract.\n * @param _crossDomainAdmin L1 address of the contract which may execute admin functions on this contract.\n */\n function initialize(address _crossDomainAdmin) public initializer {\n __WithdrawalHelper_init(_crossDomainAdmin);\n }\n\n /*\n * @notice Calls CCTP or the Arbitrum gateway router to withdraw tokens back to the TOKEN_RECIPIENT L1 address.\n * @param l1Token Address of the L1 token to receive.\n * @param l2Token Address of the L2 token to send back.\n * @param amountToReturn Amount of l2Token to send back.\n */\n function withdrawToken(\n address l1Token,\n address l2Token,\n uint256 amountToReturn\n ) public override {\n // If the l2TokenAddress is UDSC, we need to use the CCTP bridge.\n if (l2Token == address(usdcToken) && _isCCTPEnabled()) {\n _transferUsdc(TOKEN_RECIPIENT, amountToReturn);\n } else {\n if (l2Token == address(WRAPPED_NATIVE_TOKEN)) _wrapNativeToken();\n // Otherwise, we use the Arbitrum ERC20 Gateway router.\n ArbitrumL2ERC20GatewayLike tokenBridge = ArbitrumL2ERC20GatewayLike(L2_TOKEN_GATEWAY);\n // If the gateway router's expected L2 token address does not match then revert. This check does not actually\n // impact whether the bridge will succeed, since the ERC20 gateway router only requires the L1 token address, but\n // it is added here to potentially catch scenarios where there was a mistake in the calldata.\n if (tokenBridge.calculateL2TokenAddress(l1Token) != l2Token) revert InvalidTokenMapping();\n //slither-disable-next-line unused-return\n tokenBridge.outboundTransfer(\n l1Token, // _l1Token. Address of the L1 token to bridge over.\n TOKEN_RECIPIENT, // _to. Withdraw, over the bridge, to the recipient.\n amountToReturn, // _amount.\n \"\" // _data. We don't need to send any data for the bridging action.\n );\n }\n }\n\n function _requireAdminSender() internal view override {\n if (msg.sender != CrossDomainAddressUtils.applyL1ToL2Alias(crossDomainAdmin)) revert NotCrossDomainAdmin();\n }\n}\n"
+ },
+ "contracts/chain-adapters/l2/Ovm_WithdrawalHelper.sol": {
+ "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\n\nimport { WithdrawalHelperBase } from \"./WithdrawalHelperBase.sol\";\nimport { IERC20 } from \"@openzeppelin/contracts/token/ERC20/IERC20.sol\";\nimport { SafeERC20 } from \"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\";\nimport { WETH9Interface } from \"../../external/interfaces/WETH9Interface.sol\";\nimport { ITokenMessenger } from \"../../external/interfaces/CCTPInterfaces.sol\";\nimport { Lib_PredeployAddresses } from \"@eth-optimism/contracts/libraries/constants/Lib_PredeployAddresses.sol\";\nimport { LibOptimismUpgradeable } from \"@openzeppelin/contracts-upgradeable/crosschain/optimism/LibOptimismUpgradeable.sol\";\nimport { IL2ERC20Bridge } from \"../../Ovm_SpokePool.sol\";\n\n/**\n * @notice Minimal interface for the Ovm_SpokePool contract. This interface is called to pull state from the network's\n * spoke pool contract to be used by this withdrawal adapter.\n */\ninterface IOvm_SpokePool {\n // Returns the address of the token bridge for the input l2 token.\n function tokenBridges(address token) external view returns (address);\n\n // Returns the address of the l1 token set in the spoke pool for the input l2 token.\n function remoteL1Tokens(address token) external view returns (address);\n\n // Returns the address for the representation of ETH on the l2.\n function l2Eth() external view returns (address);\n\n // Returns the amount of gas the contract allocates for a token withdrawal.\n function l1Gas() external view returns (uint32);\n}\n\n/**\n * @title Ovm_WithdrawalAdapter\n * @notice This contract interfaces with L2-L1 token bridges and withdraws tokens to a single address on L1.\n * @dev This contract should be deployed on OpStack L2s which both have a Ovm_SpokePool contract deployed to the L2\n * network AND only use token bridges defined in the Ovm_SpokePool. A notable exception to this requirement is Optimism,\n * which has a special SNX bridge (and thus this adapter will NOT work for Optimism).\n * @custom:security-contact bugs@across.to\n */\ncontract Ovm_WithdrawalHelper is WithdrawalHelperBase {\n using SafeERC20 for IERC20;\n\n // Address of the corresponding spoke pool on L2. This is to piggyback off of the spoke pool's supported\n // token routes/defined token bridges.\n IOvm_SpokePool public immutable spokePool;\n // Address of native ETH on the l2. For OpStack chains, this address is used to indicate a native ETH withdrawal.\n // In general, this address is 0xDeadDeAddeAddEAddeadDEaDDEAdDeaDDeAD0000.\n address public immutable l2Eth;\n // Address of the messenger contract on L2. This is by default defined in Lib_PredeployAddresses.\n address public constant MESSENGER = Lib_PredeployAddresses.L2_CROSS_DOMAIN_MESSENGER;\n\n /*\n * @notice Constructs the Ovm_WithdrawalAdapter.\n * @param _l2Usdc Address of native USDC on the L2.\n * @param _cctpTokenMessenger Address of the CCTP token messenger contract on L2.\n * @param _wrappedNativeToken Address of the wrapped native token contract on L2.\n * @param _destinationCircleDomainId Circle's assigned CCTP domain ID for the destination network. For Ethereum, this\n * is 0.\n * @param _l2Gateway Address of the Optimism ERC20 L2 standard bridge contract.\n * @param _tokenRecipient The L1 address which will unconditionally receive tokens from withdrawals by this contract.\n * @param _spokePool The contract address of the Ovm_SpokePool which is deployed on this L2 network.\n */\n constructor(\n IERC20 _l2Usdc,\n ITokenMessenger _cctpTokenMessenger,\n WETH9Interface _wrappedNativeToken,\n uint32 _destinationCircleDomainId,\n address _l2Gateway,\n address _tokenRecipient,\n IOvm_SpokePool _spokePool\n )\n WithdrawalHelperBase(\n _l2Usdc,\n _cctpTokenMessenger,\n _wrappedNativeToken,\n _destinationCircleDomainId,\n _l2Gateway,\n _tokenRecipient\n )\n {\n spokePool = _spokePool;\n\n // This address is immutable in the spoke pool so we query once and save its value locally.\n l2Eth = spokePool.l2Eth();\n }\n\n /**\n * @notice Initializes the withdrawal helper contract.\n * @param _crossDomainAdmin L1 address of the contract which can send root bundles/messages to this forwarder contract.\n */\n function initialize(address _crossDomainAdmin) public initializer {\n __WithdrawalHelper_init(_crossDomainAdmin);\n }\n\n /*\n * @notice Calls CCTP or the Optimism token gateway to withdraw tokens back to the recipient.\n * @param l2Token address of the l2Token to send back.\n * @param amountToReturn amount of l2Token to send back.\n * @dev The l1Token parameter is unused since we obtain the l1Token to receive by querying the state of the Ovm_SpokePool deployed\n * to this network.\n * @dev This function is a copy of the `_bridgeTokensToHubPool` function found on the Ovm_SpokePool contract here:\n * https://github.com/across-protocol/contracts/blob/65191dbcded95c8fe050e0f95eb7848e3784e61f/contracts/Ovm_SpokePool.sol#L148.\n * New lines of code correspond to instances where this contract queries state from the spoke pool, such as determining\n * the appropriate token bridge for the withdrawal or finding the remoteL1Token to withdraw.\n */\n function withdrawToken(\n address,\n address l2Token,\n uint256 amountToReturn\n ) public override {\n // Fetch the current l1Gas defined in the Ovm_SpokePool.\n uint32 l1Gas = spokePool.l1Gas();\n // If the token being bridged is WETH then we need to first unwrap it to ETH and then send ETH over the\n // canonical bridge. On Optimism, this is address 0xDeadDeAddeAddEAddeadDEaDDEAdDeaDDeAD0000.\n if (l2Token == address(WRAPPED_NATIVE_TOKEN)) {\n // Wrap the contract's balance of the native token if we are withdrawing the L2's native token. We need wrap the contract's balance\n // and then unwrap the amount to send to account for cases where `amountToReturn` is greater than the contract's native token balance\n // and wrapped native token balance, but less than their sum.\n _wrapNativeToken();\n WETH9Interface(l2Token).withdraw(amountToReturn); // Unwrap into ETH.\n l2Token = l2Eth; // Set the l2Token to ETH.\n IL2ERC20Bridge(Lib_PredeployAddresses.L2_STANDARD_BRIDGE).withdrawTo{ value: amountToReturn }(\n l2Token, // _l2Token. Address of the L2 token to bridge over.\n TOKEN_RECIPIENT, // _to. Withdraw, over the bridge, to the l1 pool contract.\n amountToReturn, // _amount.\n l1Gas, // _l1Gas. Unused, but included for potential forward compatibility considerations\n \"\" // _data. We don't need to send any data for the bridging action.\n );\n }\n // If the token is USDC && CCTP bridge is enabled, then bridge USDC via CCTP.\n else if (l2Token == address(usdcToken) && _isCCTPEnabled()) {\n _transferUsdc(TOKEN_RECIPIENT, amountToReturn);\n }\n // Note we'll default to withdrawTo instead of bridgeERC20To unless the remoteL1Tokens mapping is set for\n // the l2Token. withdrawTo should be used to bridge back non-native L2 tokens\n // (i.e. non-native L2 tokens have a canonical L1 token). If we should bridge \"native L2\" tokens then\n // we'd need to call bridgeERC20To and give allowance to the tokenBridge to spend l2Token from this contract.\n // Therefore for native tokens we should set ensure that remoteL1Tokens is set for the l2Token.\n else {\n IL2ERC20Bridge tokenBridge = IL2ERC20Bridge(\n spokePool.tokenBridges(l2Token) == address(0)\n ? Lib_PredeployAddresses.L2_STANDARD_BRIDGE\n : spokePool.tokenBridges(l2Token)\n );\n address remoteL1Token = spokePool.remoteL1Tokens(l2Token);\n if (remoteL1Token != address(0)) {\n // If there is a mapping for this L2 token to an L1 token, then use the L1 token address and\n // call bridgeERC20To.\n IERC20(l2Token).safeIncreaseAllowance(address(tokenBridge), amountToReturn);\n tokenBridge.bridgeERC20To(\n l2Token, // _l2Token. Address of the L2 token to bridge over.\n remoteL1Token, // Remote token to be received on L1 side. If the\n // remoteL1Token on the other chain does not recognize the local token as the correct\n // pair token, the ERC20 bridge will fail and the tokens will be returned to sender on\n // this chain.\n TOKEN_RECIPIENT, // _to\n amountToReturn, // _amount\n l1Gas, // _l1Gas\n \"\" // _data\n );\n } else {\n tokenBridge.withdrawTo(\n l2Token, // _l2Token. Address of the L2 token to bridge over.\n TOKEN_RECIPIENT, // _to. Withdraw, over the bridge, to the l1 pool contract.\n amountToReturn, // _amount.\n l1Gas, // _l1Gas. Unused, but included for potential forward compatibility considerations\n \"\" // _data. We don't need to send any data for the bridging action.\n );\n }\n }\n }\n\n function _requireAdminSender() internal view override {\n if (LibOptimismUpgradeable.crossChainSender(MESSENGER) != crossDomainAdmin) revert NotCrossDomainAdmin();\n }\n}\n"
+ },
+ "contracts/chain-adapters/l2/WithdrawalHelperBase.sol": {
+ "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\n\nimport { IERC20 } from \"@openzeppelin/contracts/token/ERC20/IERC20.sol\";\nimport { MultiCaller } from \"@uma/core/contracts/common/implementation/MultiCaller.sol\";\nimport { CircleCCTPAdapter, ITokenMessenger, CircleDomainIds } from \"../../libraries/CircleCCTPAdapter.sol\";\nimport { WETH9Interface } from \"../../external/interfaces/WETH9Interface.sol\";\nimport { UUPSUpgradeable } from \"@openzeppelin/contracts-upgradeable/proxy/utils/UUPSUpgradeable.sol\";\n\n/**\n * @title WithdrawalHelperBase\n * @notice This contract contains general configurations for bridging tokens from an L2 to a single recipient on L1.\n * @dev This contract should be deployed on L2. It provides an interface to withdraw tokens to some address on L1. The only\n * function which must be implemented in contracts which inherit this contract is `withdrawToken`. It is up to that function\n * to determine which bridges to use for an input L2 token. Importantly, that function must also verify that the L2 to L1\n * token mapping is correct so that the bridge call itself can succeed.\n */\nabstract contract WithdrawalHelperBase is CircleCCTPAdapter, MultiCaller, UUPSUpgradeable {\n // The L2 address of the wrapped native token for this L2.\n WETH9Interface public immutable WRAPPED_NATIVE_TOKEN;\n // The L1 address which will unconditionally receive all withdrawals from this contract.\n address public immutable TOKEN_RECIPIENT;\n // The address of the primary or default token gateway/canonical bridge contract on L2.\n address public immutable L2_TOKEN_GATEWAY;\n // The address of the admin contract on L1,which will likely be the hub pool. As a last resort, this admin can rescue stuck tokens\n // on this withdrawal helper contract, similar to how it may send admin functions to spoke pools.\n address public crossDomainAdmin;\n\n event SetXDomainAdmin(address indexed _crossDomainAdmin);\n\n // Error which triggers when the cross domain admin was attempted to be set to the zero address.\n error InvalidCrossDomainAdmin();\n // Error which triggers when the caller of a protected function is not the cross domain admin.\n error NotCrossDomainAdmin();\n\n // Functions which contain this modifier should only be callable via a cross-chain call where the L1 msg.sender is the hub pool.\n modifier onlyAdmin() {\n _requireAdminSender();\n _;\n }\n\n /*\n * @notice Constructs a new withdrawal helper.\n * @param _l2Usdc Address of native USDC on the L2.\n * @param _cctpTokenMessenger Address of the CCTP token messenger contract on L2.\n * @param _wrappedNativeToken Address of the wrapped native token contract on L2.\n * @param _destinationCircleDomainId Circle's assigned CCTP domain ID for the destination network.\n * @param _l2TokenGateway Address of the network's l2 token gateway/bridge contract.\n * @param _tokenRecipient L1 address which will unconditionally receive all withdrawals originating from this contract.\n * @dev _disableInitializers() restricts anybody from initializing the implementation contract, which if not done,\n * may disrupt the proxy if another EOA were to initialize it.\n */\n constructor(\n IERC20 _l2Usdc,\n ITokenMessenger _cctpTokenMessenger,\n WETH9Interface _wrappedNativeToken,\n uint32 _destinationCircleDomainId,\n address _l2TokenGateway,\n address _tokenRecipient\n ) CircleCCTPAdapter(_l2Usdc, _cctpTokenMessenger, _destinationCircleDomainId) {\n L2_TOKEN_GATEWAY = _l2TokenGateway;\n TOKEN_RECIPIENT = _tokenRecipient;\n WRAPPED_NATIVE_TOKEN = _wrappedNativeToken;\n _disableInitializers();\n }\n\n /**\n * @notice Receives the native token from bridge contracts.\n * @dev When bridging from L3 to the L2's native token, OpStack bridges will send the \"unwrapped\"/native token to the recipient on L2\n * during withdrawals. This means that this contract must be able to accept value transfers.\n */\n receive() external payable {}\n\n /**\n * @notice Initializes the withdrawal helper contract.\n * @param _crossDomainAdmin L1 address of the contract which can send root bundles/messages to this forwarder contract.\n */\n function __WithdrawalHelper_init(address _crossDomainAdmin) public onlyInitializing {\n __UUPSUpgradeable_init();\n _setCrossDomainAdmin(_crossDomainAdmin);\n }\n\n /*\n * @notice Sets a new cross domain admin. The admin cannot be the zero address. The cross domain admin is the only address which may call\n * upgrade this contract.\n * @param _newCrossDomainAdmin L1 address of the new cross domain admin.\n */\n function _setCrossDomainAdmin(address _newCrossDomainAdmin) internal {\n if (_newCrossDomainAdmin == address(0)) revert InvalidCrossDomainAdmin();\n crossDomainAdmin = _newCrossDomainAdmin;\n emit SetXDomainAdmin(_newCrossDomainAdmin);\n }\n\n /*\n * @notice Withdraws a specified token to L1. This may be implemented uniquely for each L2, since each L2 has various\n * dependencies to withdraw a token, such as the token bridge to use, mappings for L1 and L2 tokens, and gas configurations.\n * Notably, withdrawals should always send token back to `TOKEN_RECIPIENT`.\n * @param l1Token Address of the l1Token to receive.\n * @param l2Token Address of the l2Token to send back.\n * @param amountToReturn Amount of l2Token to send back.\n * @dev Some networks do not require the L1/L2 token argument to withdraw tokens, while others enable contracts to derive the\n * L1/L2 given knowledge of only one of the addresses. Both arguments are provided to enable a flexible interface; however, due\n * to this, `withdrawToken` MUST account for situations where the L1/L2 token mapping is incorrect.\n */\n function withdrawToken(\n address l1Token,\n address l2Token,\n uint256 amountToReturn\n ) public virtual;\n\n /*\n * @notice Wraps the contract's entire balance of the native token.\n */\n function _wrapNativeToken() internal virtual {\n if (address(this).balance > 0) WRAPPED_NATIVE_TOKEN.deposit{ value: address(this).balance }();\n }\n\n /*\n * @notice Checks that the L1 msg.sender is the `crossDomainAdmin` address.\n * @dev This implementation must change on a per-chain basis, since each L2 network has their own method of deriving the L1 msg.sender.\n */\n function _requireAdminSender() internal virtual;\n\n /*\n * @notice Access control check for upgrading this proxy contract\n * @dev This requires that _requireAdminSender() is properly implemented on all contracts which inherit WithdrawalHelperBase.\n */\n function _authorizeUpgrade(address) internal override onlyAdmin {}\n\n // Reserve storage slots for future versions of this base contract to add state variables without\n // affecting the storage layout of child contracts. Decrement the size of __gap whenever state variables\n // are added. This is at bottom of contract to make sure it's always at the end of storage.\n uint256[1000] private __gap;\n}\n"
+ },
+ "contracts/chain-adapters/Linea_Adapter.sol": {
+ "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\n\nimport \"./interfaces/AdapterInterface.sol\";\nimport \"../external/interfaces/WETH9Interface.sol\";\nimport \"../libraries/CircleCCTPAdapter.sol\";\n\nimport { IMessageService, ITokenBridge, IUSDCBridge } from \"../external/interfaces/LineaInterfaces.sol\";\n\nimport \"@openzeppelin/contracts/token/ERC20/IERC20.sol\";\nimport \"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\";\n\n/**\n * @notice Supports sending messages and tokens from L1 to Linea.\n * @custom:security-contact bugs@across.to\n */\n// solhint-disable-next-line contract-name-camelcase\ncontract Linea_Adapter is AdapterInterface, CircleCCTPAdapter {\n using SafeERC20 for IERC20;\n\n WETH9Interface public immutable L1_WETH;\n IMessageService public immutable L1_MESSAGE_SERVICE;\n ITokenBridge public immutable L1_TOKEN_BRIDGE;\n\n /**\n * @notice Constructs new Adapter.\n * @param _l1Weth WETH address on L1.\n * @param _l1MessageService Canonical message service contract on L1.\n * @param _l1TokenBridge Canonical token bridge contract on L1.\n */\n constructor(\n WETH9Interface _l1Weth,\n IMessageService _l1MessageService,\n ITokenBridge _l1TokenBridge,\n IERC20 _l1Usdc,\n ITokenMessenger _cctpTokenMessenger\n ) CircleCCTPAdapter(_l1Usdc, _cctpTokenMessenger, CircleDomainIds.Linea) {\n L1_WETH = _l1Weth;\n L1_MESSAGE_SERVICE = _l1MessageService;\n L1_TOKEN_BRIDGE = _l1TokenBridge;\n }\n\n /**\n * @notice Send cross-chain message to target on Linea.\n * @param target Contract on Linea that will receive message.\n * @param message Data to send to target.\n */\n function relayMessage(address target, bytes calldata message) external payable override {\n // Linea currently does not support auto-claiming of cross-chain messages that have\n // non-empty calldata. As we need to manually claim these messages, we can set the\n // message fees to 0.\n L1_MESSAGE_SERVICE.sendMessage(target, 0, message);\n emit MessageRelayed(target, message);\n }\n\n /**\n * @notice Bridge tokens to Linea.\n * @param l1Token L1 token to deposit.\n * @param l2Token L2 token to receive.\n * @param amount Amount of L1 tokens to deposit and L2 tokens to receive.\n * @param to Bridge recipient.\n */\n function relayTokens(\n address l1Token,\n address l2Token,\n uint256 amount,\n address to\n ) external payable override {\n if (l1Token == address(usdcToken) && _isCCTPEnabled()) {\n _transferUsdc(to, amount);\n }\n // If the l1Token is WETH then unwrap it to ETH then send the ETH directly\n // via the Canoncial Message Service.\n else if (l1Token == address(L1_WETH)) {\n L1_WETH.withdraw(amount);\n L1_MESSAGE_SERVICE.sendMessage{ value: amount }(to, 0, \"\");\n }\n // For other tokens, we can use the Canonical Token Bridge.\n else {\n IERC20(l1Token).safeIncreaseAllowance(address(L1_TOKEN_BRIDGE), amount);\n L1_TOKEN_BRIDGE.bridgeToken(l1Token, amount, to);\n }\n\n emit TokensRelayed(l1Token, l2Token, amount, to);\n }\n}\n"
+ },
+ "contracts/chain-adapters/Lisk_Adapter.sol": {
+ "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\n\nimport \"./interfaces/AdapterInterface.sol\";\nimport \"../external/interfaces/WETH9Interface.sol\";\n\n// @dev Use local modified CrossDomainEnabled contract instead of one exported by eth-optimism because we need\n// this contract's state variables to be `immutable` because of the delegateCall call.\nimport \"./CrossDomainEnabled.sol\";\nimport \"@eth-optimism/contracts/L1/messaging/IL1StandardBridge.sol\";\n\nimport \"@openzeppelin/contracts/token/ERC20/IERC20.sol\";\nimport \"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\";\n\nimport \"../libraries/CircleCCTPAdapter.sol\";\nimport \"../external/interfaces/CCTPInterfaces.sol\";\n\n/**\n * @notice Contract containing logic to send messages from L1 to Lisk. This is a clone of the Base/Mode adapter\n * @dev Public functions calling external contracts do not guard against reentrancy because they are expected to be\n * called via delegatecall, which will execute this contract's logic within the context of the originating contract.\n * For example, the HubPool will delegatecall these functions, therefore its only necessary that the HubPool's methods\n * that call this contract's logic guard against reentrancy.\n * @custom:security-contact bugs@across.to\n */\n\n// solhint-disable-next-line contract-name-camelcase\ncontract Lisk_Adapter is CrossDomainEnabled, AdapterInterface, CircleCCTPAdapter {\n using SafeERC20 for IERC20;\n uint32 public constant L2_GAS_LIMIT = 200_000;\n\n WETH9Interface public immutable L1_WETH;\n\n IL1StandardBridge public immutable L1_STANDARD_BRIDGE;\n\n /**\n * @notice Constructs new Adapter.\n * @param _l1Weth WETH address on L1.\n * @param _crossDomainMessenger XDomainMessenger Lisk system contract.\n * @param _l1StandardBridge Standard bridge contract.\n * @param _l1Usdc USDC address on L1.\n */\n constructor(\n WETH9Interface _l1Weth,\n address _crossDomainMessenger,\n IL1StandardBridge _l1StandardBridge,\n IERC20 _l1Usdc\n )\n CrossDomainEnabled(_crossDomainMessenger)\n CircleCCTPAdapter(\n _l1Usdc,\n // Hardcode cctp messenger to 0x0 to disable CCTP bridging.\n ITokenMessenger(address(0)),\n CircleDomainIds.UNINITIALIZED\n )\n {\n L1_WETH = _l1Weth;\n L1_STANDARD_BRIDGE = _l1StandardBridge;\n }\n\n /**\n * @notice Send cross-chain message to target on Lisk.\n * @param target Contract on Lisk that will receive message.\n * @param message Data to send to target.\n */\n function relayMessage(address target, bytes calldata message) external payable override {\n sendCrossDomainMessage(target, L2_GAS_LIMIT, message);\n emit MessageRelayed(target, message);\n }\n\n /**\n * @notice Bridge tokens to Lisk.\n * @param l1Token L1 token to deposit.\n * @param l2Token L2 token to receive.\n * @param amount Amount of L1 tokens to deposit and L2 tokens to receive.\n * @param to Bridge recipient.\n */\n function relayTokens(\n address l1Token,\n address l2Token,\n uint256 amount,\n address to\n ) external payable override {\n // If the l1Token is weth then unwrap it to ETH then send the ETH to the standard bridge.\n if (l1Token == address(L1_WETH)) {\n L1_WETH.withdraw(amount);\n L1_STANDARD_BRIDGE.depositETHTo{ value: amount }(to, L2_GAS_LIMIT, \"\");\n }\n // Check if this token is USDC, which requires a custom bridge via CCTP.\n else if (_isCCTPEnabled() && l1Token == address(usdcToken)) {\n _transferUsdc(to, amount);\n } else {\n IL1StandardBridge _l1StandardBridge = L1_STANDARD_BRIDGE;\n\n IERC20(l1Token).safeIncreaseAllowance(address(_l1StandardBridge), amount);\n _l1StandardBridge.depositERC20To(l1Token, l2Token, to, amount, L2_GAS_LIMIT, \"\");\n }\n emit TokensRelayed(l1Token, l2Token, amount, to);\n }\n}\n"
+ },
+ "contracts/chain-adapters/Mode_Adapter.sol": {
+ "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\n\nimport \"./interfaces/AdapterInterface.sol\";\nimport \"../external/interfaces/WETH9Interface.sol\";\n\n// @dev Use local modified CrossDomainEnabled contract instead of one exported by eth-optimism because we need\n// this contract's state variables to be `immutable` because of the delegateCall call.\nimport \"./CrossDomainEnabled.sol\";\nimport \"@eth-optimism/contracts/L1/messaging/IL1StandardBridge.sol\";\n\nimport \"@openzeppelin/contracts/token/ERC20/IERC20.sol\";\nimport \"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\";\n\nimport \"../libraries/CircleCCTPAdapter.sol\";\nimport \"../external/interfaces/CCTPInterfaces.sol\";\n\n/**\n * @notice Contract containing logic to send messages from L1 to Mode. This is a clone of the Base adapter\n * @dev Public functions calling external contracts do not guard against reentrancy because they are expected to be\n * called via delegatecall, which will execute this contract's logic within the context of the originating contract.\n * For example, the HubPool will delegatecall these functions, therefore its only necessary that the HubPool's methods\n * that call this contract's logic guard against reentrancy.\n * @custom:security-contact bugs@across.to\n */\n\n// solhint-disable-next-line contract-name-camelcase\ncontract Mode_Adapter is CrossDomainEnabled, AdapterInterface, CircleCCTPAdapter {\n using SafeERC20 for IERC20;\n uint32 public constant L2_GAS_LIMIT = 200_000;\n\n WETH9Interface public immutable L1_WETH;\n\n IL1StandardBridge public immutable L1_STANDARD_BRIDGE;\n\n /**\n * @notice Constructs new Adapter.\n * @param _l1Weth WETH address on L1.\n * @param _crossDomainMessenger XDomainMessenger Mode system contract.\n * @param _l1StandardBridge Standard bridge contract.\n * @param _l1Usdc USDC address on L1.\n */\n constructor(\n WETH9Interface _l1Weth,\n address _crossDomainMessenger,\n IL1StandardBridge _l1StandardBridge,\n IERC20 _l1Usdc\n )\n CrossDomainEnabled(_crossDomainMessenger)\n CircleCCTPAdapter(\n _l1Usdc,\n // Hardcode cctp messenger to 0x0 to disable CCTP bridging.\n ITokenMessenger(address(0)),\n CircleDomainIds.UNINITIALIZED\n )\n {\n L1_WETH = _l1Weth;\n L1_STANDARD_BRIDGE = _l1StandardBridge;\n }\n\n /**\n * @notice Send cross-chain message to target on Mode.\n * @param target Contract on Mode that will receive message.\n * @param message Data to send to target.\n */\n function relayMessage(address target, bytes calldata message) external payable override {\n sendCrossDomainMessage(target, L2_GAS_LIMIT, message);\n emit MessageRelayed(target, message);\n }\n\n /**\n * @notice Bridge tokens to Mode.\n * @param l1Token L1 token to deposit.\n * @param l2Token L2 token to receive.\n * @param amount Amount of L1 tokens to deposit and L2 tokens to receive.\n * @param to Bridge recipient.\n */\n function relayTokens(\n address l1Token,\n address l2Token,\n uint256 amount,\n address to\n ) external payable override {\n // If the l1Token is weth then unwrap it to ETH then send the ETH to the standard bridge.\n if (l1Token == address(L1_WETH)) {\n L1_WETH.withdraw(amount);\n L1_STANDARD_BRIDGE.depositETHTo{ value: amount }(to, L2_GAS_LIMIT, \"\");\n }\n // Check if this token is USDC, which requires a custom bridge via CCTP.\n else if (_isCCTPEnabled() && l1Token == address(usdcToken)) {\n _transferUsdc(to, amount);\n } else {\n IL1StandardBridge _l1StandardBridge = L1_STANDARD_BRIDGE;\n\n IERC20(l1Token).safeIncreaseAllowance(address(_l1StandardBridge), amount);\n _l1StandardBridge.depositERC20To(l1Token, l2Token, to, amount, L2_GAS_LIMIT, \"\");\n }\n emit TokensRelayed(l1Token, l2Token, amount, to);\n }\n}\n"
+ },
+ "contracts/chain-adapters/OP_Adapter.sol": {
+ "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\n\nimport \"@eth-optimism/contracts/L1/messaging/IL1StandardBridge.sol\";\nimport \"@openzeppelin/contracts/token/ERC20/IERC20.sol\";\nimport \"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\";\n\nimport { CircleCCTPAdapter, CircleDomainIds } from \"../libraries/CircleCCTPAdapter.sol\";\nimport { ITokenMessenger } from \"../external/interfaces/CCTPInterfaces.sol\";\nimport { IOpUSDCBridgeAdapter } from \"../external/interfaces/IOpUSDCBridgeAdapter.sol\";\nimport { WETH9Interface } from \"../external/interfaces/WETH9Interface.sol\";\nimport { AdapterInterface } from \"./interfaces/AdapterInterface.sol\";\n\n// @dev Use local modified CrossDomainEnabled contract instead of one exported by eth-optimism because we need\n// this contract's state variables to be `immutable` because of the delegateCall call.\nimport { CrossDomainEnabled } from \"./CrossDomainEnabled.sol\";\n\n/**\n * @notice Contract containing logic to send messages from L1 to an OP stack chain.\n * @notice This adapter supports the OpUSDCBridgeAdapter interface for bridging into Circle Bridged USDC.\n * @dev Public functions calling external contracts do not guard against reentrancy because they are expected to be\n * called via delegatecall, which will execute this contract's logic within the context of the originating contract.\n * For example, the HubPool will delegatecall these functions, therefore its only necessary that the HubPool's methods\n * that call this contract's logic guard against reentrancy.\n * @custom:security-contact bugs@across.to\n */\n\n// solhint-disable-next-line contract-name-camelcase\ncontract OP_Adapter is CrossDomainEnabled, AdapterInterface, CircleCCTPAdapter {\n using SafeERC20 for IERC20;\n uint32 public constant L2_GAS_LIMIT = 200_000;\n\n WETH9Interface public immutable L1_WETH;\n\n IL1StandardBridge public immutable L1_STANDARD_BRIDGE;\n IOpUSDCBridgeAdapter public immutable L1_OP_USDC_BRIDGE;\n\n /**\n * @notice Constructs new Adapter.\n * @param _l1Weth WETH address on L1.\n * @param _crossDomainMessenger XDomainMessenger Desination chain system contract.\n * @param _l1StandardBridge Standard bridge contract.\n * @param _l1Usdc USDC address on L1.\n */\n constructor(\n WETH9Interface _l1Weth,\n IERC20 _l1Usdc,\n address _crossDomainMessenger,\n IL1StandardBridge _l1StandardBridge,\n IOpUSDCBridgeAdapter _l1USDCBridge\n )\n CrossDomainEnabled(_crossDomainMessenger)\n CircleCCTPAdapter(\n _l1Usdc,\n // Hardcode cctp messenger to 0x0 to disable CCTP bridging.\n ITokenMessenger(address(0)),\n CircleDomainIds.UNINITIALIZED\n )\n {\n L1_WETH = _l1Weth;\n L1_STANDARD_BRIDGE = _l1StandardBridge;\n L1_OP_USDC_BRIDGE = _l1USDCBridge;\n }\n\n /**\n * @notice Send cross-chain message to target on destination chain.\n * @param target Contract on destination chain that will receive message.\n * @param message Data to send to target.\n */\n function relayMessage(address target, bytes calldata message) external payable override {\n sendCrossDomainMessage(target, L2_GAS_LIMIT, message);\n emit MessageRelayed(target, message);\n }\n\n /**\n * @notice Bridge tokens to destination chain.\n * @param l1Token L1 token to deposit.\n * @param l2Token L2 token to receive.\n * @param amount Amount of L1 tokens to deposit and L2 tokens to receive.\n * @param to Bridge recipient.\n */\n function relayTokens(\n address l1Token,\n address l2Token,\n uint256 amount,\n address to\n ) external payable override {\n // If the l1Token is weth then unwrap it to ETH then send the ETH to the standard bridge.\n if (l1Token == address(L1_WETH)) {\n L1_WETH.withdraw(amount);\n L1_STANDARD_BRIDGE.depositETHTo{ value: amount }(to, L2_GAS_LIMIT, \"\");\n } else if (l1Token == address(usdcToken)) {\n if (_isCCTPEnabled()) {\n _transferUsdc(to, amount);\n } else {\n // Use the relevant OP USDC bridge to received bridged USDC on L2.\n IERC20(l1Token).safeIncreaseAllowance(address(L1_OP_USDC_BRIDGE), amount);\n L1_OP_USDC_BRIDGE.sendMessage(to, amount, L2_GAS_LIMIT);\n }\n } else {\n IERC20(l1Token).safeIncreaseAllowance(address(L1_STANDARD_BRIDGE), amount);\n L1_STANDARD_BRIDGE.depositERC20To(l1Token, l2Token, to, amount, L2_GAS_LIMIT, \"\");\n }\n emit TokensRelayed(l1Token, l2Token, amount, to);\n }\n}\n"
+ },
+ "contracts/chain-adapters/Optimism_Adapter.sol": {
+ "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\n\nimport \"./interfaces/AdapterInterface.sol\";\nimport \"../external/interfaces/WETH9Interface.sol\";\nimport \"../libraries/CircleCCTPAdapter.sol\";\nimport \"../external/interfaces/CCTPInterfaces.sol\";\n\n// @dev Use local modified CrossDomainEnabled contract instead of one exported by eth-optimism because we need\n// this contract's state variables to be `immutable` because of the delegateCall call.\nimport \"./CrossDomainEnabled.sol\";\nimport \"@eth-optimism/contracts/L1/messaging/IL1StandardBridge.sol\";\n\nimport \"@openzeppelin/contracts/token/ERC20/IERC20.sol\";\nimport \"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\";\n\n/**\n * @notice Interface for Synthetix custom bridge to Optimism.\n */\ninterface SynthetixBridgeToOptimism is IL1StandardBridge {\n /**\n * @notice Send tokens to Optimism.\n * @param to Address to send tokens to on L2.\n * @param amount Amount of tokens to send.\n */\n function depositTo(address to, uint256 amount) external;\n}\n\n/**\n * @notice Contract containing logic to send messages from L1 to Optimism.\n * @dev Public functions calling external contracts do not guard against reentrancy because they are expected to be\n * called via delegatecall, which will execute this contract's logic within the context of the originating contract.\n * For example, the HubPool will delegatecall these functions, therefore it's only necessary that the HubPool's methods\n * that call this contract's logic guard against reentrancy.\n * @custom:security-contact bugs@across.to\n */\n\n// solhint-disable-next-line contract-name-camelcase\ncontract Optimism_Adapter is CrossDomainEnabled, AdapterInterface, CircleCCTPAdapter {\n using SafeERC20 for IERC20;\n uint32 public constant L2_GAS_LIMIT = 200_000;\n\n WETH9Interface public immutable L1_WETH;\n\n IL1StandardBridge public immutable L1_STANDARD_BRIDGE;\n\n // Optimism has the ability to support \"custom\" bridges. These bridges are not supported by the canonical bridge\n // and so we need to store the address of the custom token and the associated bridge. In the event we want to\n // support a new token that is not supported by Optimism, we can add a new custom bridge for it and re-deploy the\n // adapter. A full list of custom optimism tokens and their associated bridges can be found here:\n // https://github.com/ethereum-optimism/ethereum-optimism.github.io/blob/master/optimism.tokenlist.json\n address public constant DAI = 0x6B175474E89094C44Da98b954EedeAC495271d0F;\n address public constant DAI_OPTIMISM_BRIDGE = 0x10E6593CDda8c58a1d0f14C5164B376352a55f2F;\n address public constant SNX = 0xC011a73ee8576Fb46F5E1c5751cA3B9Fe0af2a6F;\n address public constant SNX_OPTIMISM_BRIDGE = 0x39Ea01a0298C315d149a490E34B59Dbf2EC7e48F;\n\n /**\n * @notice Constructs new Adapter.\n * @param _l1Weth WETH address on L1.\n * @param _crossDomainMessenger XDomainMessenger Optimism system contract.\n * @param _l1StandardBridge Standard bridge contract.\n * @param _l1Usdc USDC address on L1.\n * @param _cctpTokenMessenger TokenMessenger contract to bridge via CCTP.\n */\n constructor(\n WETH9Interface _l1Weth,\n address _crossDomainMessenger,\n IL1StandardBridge _l1StandardBridge,\n IERC20 _l1Usdc,\n ITokenMessenger _cctpTokenMessenger\n )\n CrossDomainEnabled(_crossDomainMessenger)\n CircleCCTPAdapter(_l1Usdc, _cctpTokenMessenger, CircleDomainIds.Optimism)\n {\n L1_WETH = _l1Weth;\n L1_STANDARD_BRIDGE = _l1StandardBridge;\n }\n\n /**\n * @notice Send cross-chain message to target on Optimism.\n * @param target Contract on Optimism that will receive message.\n * @param message Data to send to target.\n */\n function relayMessage(address target, bytes calldata message) external payable override {\n sendCrossDomainMessage(target, L2_GAS_LIMIT, message);\n emit MessageRelayed(target, message);\n }\n\n /**\n * @notice Bridge tokens to Optimism.\n * @param l1Token L1 token to deposit.\n * @param l2Token L2 token to receive.\n * @param amount Amount of L1 tokens to deposit and L2 tokens to receive.\n * @param to Bridge recipient.\n */\n function relayTokens(\n address l1Token,\n address l2Token,\n uint256 amount,\n address to\n ) external payable override {\n // If the l1Token is weth then unwrap it to ETH then send the ETH to the standard bridge.\n if (l1Token == address(L1_WETH)) {\n L1_WETH.withdraw(amount);\n L1_STANDARD_BRIDGE.depositETHTo{ value: amount }(to, L2_GAS_LIMIT, \"\");\n }\n // If the l1Token is USDC, then we send it to the CCTP bridge\n else if (_isCCTPEnabled() && l1Token == address(usdcToken)) {\n _transferUsdc(to, amount);\n } else {\n address bridgeToUse = address(L1_STANDARD_BRIDGE);\n\n // Check if the L1 token requires a custom bridge. If so, use that bridge over the standard bridge.\n if (l1Token == DAI) bridgeToUse = DAI_OPTIMISM_BRIDGE; // 1. DAI\n if (l1Token == SNX) bridgeToUse = SNX_OPTIMISM_BRIDGE; // 2. SNX\n\n IERC20(l1Token).safeIncreaseAllowance(bridgeToUse, amount);\n if (l1Token == SNX) SynthetixBridgeToOptimism(bridgeToUse).depositTo(to, amount);\n else IL1StandardBridge(bridgeToUse).depositERC20To(l1Token, l2Token, to, amount, L2_GAS_LIMIT, \"\");\n }\n emit TokensRelayed(l1Token, l2Token, amount, to);\n }\n}\n"
+ },
+ "contracts/chain-adapters/Polygon_Adapter.sol": {
+ "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\n\nimport \"./interfaces/AdapterInterface.sol\";\nimport \"../external/interfaces/WETH9Interface.sol\";\n\nimport \"@openzeppelin/contracts/token/ERC20/IERC20.sol\";\nimport \"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\";\n\nimport \"../libraries/CircleCCTPAdapter.sol\";\nimport \"../external/interfaces/CCTPInterfaces.sol\";\n\n/**\n * @notice Send tokens to Polygon.\n */\ninterface IRootChainManager {\n /**\n * @notice Send msg.value of ETH to Polygon\n * @param user Recipient of ETH on Polygon.\n */\n function depositEtherFor(address user) external payable;\n\n /**\n * @notice Send ERC20 tokens to Polygon.\n * @param user Recipient of L2 equivalent tokens on Polygon.\n * @param rootToken L1 Address of token to send.\n * @param depositData Data to pass to L2 including amount of tokens to send. Should be abi.encode(amount).\n */\n function depositFor(\n address user,\n address rootToken,\n bytes calldata depositData\n ) external;\n}\n\n/**\n * @notice Send arbitrary messages to Polygon.\n */\ninterface IFxStateSender {\n /**\n * @notice Send arbitrary message to Polygon.\n * @param _receiver Address on Polygon to receive message.\n * @param _data Message to send to `_receiver` on Polygon.\n */\n function sendMessageToChild(address _receiver, bytes calldata _data) external;\n}\n\n/**\n * @notice Similar to RootChainManager, but for Matic (Plasma) bridge.\n */\ninterface DepositManager {\n /**\n * @notice Send tokens to Polygon. Only used to send MATIC in this Polygon_Adapter.\n * @param token L1 token to send. Should be MATIC.\n * @param user Recipient of L2 equivalent tokens on Polygon.\n * @param amount Amount of `token` to send.\n */\n function depositERC20ForUser(\n address token,\n address user,\n uint256 amount\n ) external;\n}\n\n/**\n * @notice Sends cross chain messages Polygon L2 network.\n * @dev Public functions calling external contracts do not guard against reentrancy because they are expected to be\n * called via delegatecall, which will execute this contract's logic within the context of the originating contract.\n * For example, the HubPool will delegatecall these functions, therefore its only necessary that the HubPool's methods\n * that call this contract's logic guard against reentrancy.\n * @custom:security-contact bugs@across.to\n */\n\n// solhint-disable-next-line contract-name-camelcase\ncontract Polygon_Adapter is AdapterInterface, CircleCCTPAdapter {\n using SafeERC20 for IERC20;\n IRootChainManager public immutable ROOT_CHAIN_MANAGER;\n IFxStateSender public immutable FX_STATE_SENDER;\n DepositManager public immutable DEPOSIT_MANAGER;\n address public immutable ERC20_PREDICATE;\n address public immutable L1_MATIC;\n WETH9Interface public immutable L1_WETH;\n\n /**\n * @notice Constructs new Adapter.\n * @param _rootChainManager RootChainManager Polygon system contract to deposit tokens over the PoS bridge.\n * @param _fxStateSender FxStateSender Polygon system contract to send arbitrary messages to L2.\n * @param _depositManager DepositManager Polygon system contract to deposit tokens over the Plasma bridge (Matic).\n * @param _erc20Predicate ERC20Predicate Polygon system contract to approve when depositing to the PoS bridge.\n * @param _l1Matic matic address on l1.\n * @param _l1Weth WETH address on L1.\n * @param _l1Usdc USDC address on L1.\n * @param _cctpTokenMessenger TokenMessenger contract to bridge via CCTP.\n */\n constructor(\n IRootChainManager _rootChainManager,\n IFxStateSender _fxStateSender,\n DepositManager _depositManager,\n address _erc20Predicate,\n address _l1Matic,\n WETH9Interface _l1Weth,\n IERC20 _l1Usdc,\n ITokenMessenger _cctpTokenMessenger\n ) CircleCCTPAdapter(_l1Usdc, _cctpTokenMessenger, CircleDomainIds.Polygon) {\n ROOT_CHAIN_MANAGER = _rootChainManager;\n FX_STATE_SENDER = _fxStateSender;\n DEPOSIT_MANAGER = _depositManager;\n ERC20_PREDICATE = _erc20Predicate;\n L1_MATIC = _l1Matic;\n L1_WETH = _l1Weth;\n }\n\n /**\n * @notice Send cross-chain message to target on Polygon.\n * @param target Contract on Polygon that will receive message.\n * @param message Data to send to target.\n */\n\n function relayMessage(address target, bytes calldata message) external payable override {\n FX_STATE_SENDER.sendMessageToChild(target, message);\n emit MessageRelayed(target, message);\n }\n\n /**\n * @notice Bridge tokens to Polygon.\n * @param l1Token L1 token to deposit.\n * @param l2Token L2 token to receive.\n * @param amount Amount of L1 tokens to deposit and L2 tokens to receive.\n * @param to Bridge recipient.\n */\n function relayTokens(\n address l1Token,\n address l2Token,\n uint256 amount,\n address to\n ) external payable override {\n // If the l1Token is weth then unwrap it to ETH then send the ETH to the standard bridge.\n if (l1Token == address(L1_WETH)) {\n L1_WETH.withdraw(amount);\n ROOT_CHAIN_MANAGER.depositEtherFor{ value: amount }(to);\n }\n // If the l1Token is USDC, then we send it to the CCTP bridge\n else if (_isCCTPEnabled() && l1Token == address(usdcToken)) {\n _transferUsdc(to, amount);\n } else if (l1Token == L1_MATIC) {\n IERC20(l1Token).safeIncreaseAllowance(address(DEPOSIT_MANAGER), amount);\n DEPOSIT_MANAGER.depositERC20ForUser(l1Token, to, amount);\n } else {\n IERC20(l1Token).safeIncreaseAllowance(ERC20_PREDICATE, amount);\n ROOT_CHAIN_MANAGER.depositFor(to, l1Token, abi.encode(amount));\n }\n emit TokensRelayed(l1Token, l2Token, amount, to);\n }\n}\n"
+ },
+ "contracts/chain-adapters/Redstone_Adapter.sol": {
+ "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\n\nimport \"./interfaces/AdapterInterface.sol\";\nimport \"../external/interfaces/WETH9Interface.sol\";\n\n// @dev Use local modified CrossDomainEnabled contract instead of one exported by eth-optimism because we need\n// this contract's state variables to be `immutable` because of the delegateCall call.\nimport \"./CrossDomainEnabled.sol\";\nimport \"@eth-optimism/contracts/L1/messaging/IL1StandardBridge.sol\";\n\nimport \"@openzeppelin/contracts/token/ERC20/IERC20.sol\";\nimport \"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\";\n\nimport \"../libraries/CircleCCTPAdapter.sol\";\nimport \"../external/interfaces/CCTPInterfaces.sol\";\n\n/**\n * @notice Contract containing logic to send messages from L1 to Redstone. This is a clone of the Base/Mode adapter\n * @dev Public functions calling external contracts do not guard against reentrancy because they are expected to be\n * called via delegatecall, which will execute this contract's logic within the context of the originating contract.\n * For example, the HubPool will delegatecall these functions, therefore its only necessary that the HubPool's methods\n * that call this contract's logic guard against reentrancy.\n * @custom:security-contact bugs@across.to\n */\n\n// solhint-disable-next-line contract-name-camelcase\ncontract Redstone_Adapter is CrossDomainEnabled, AdapterInterface, CircleCCTPAdapter {\n using SafeERC20 for IERC20;\n uint32 public constant L2_GAS_LIMIT = 200_000;\n\n WETH9Interface public immutable L1_WETH;\n\n IL1StandardBridge public immutable L1_STANDARD_BRIDGE;\n\n /**\n * @notice Constructs new Adapter.\n * @param _l1Weth WETH address on L1.\n * @param _crossDomainMessenger XDomainMessenger Redstone system contract.\n * @param _l1StandardBridge Standard bridge contract.\n * @param _l1Usdc USDC address on L1.\n */\n constructor(\n WETH9Interface _l1Weth,\n address _crossDomainMessenger,\n IL1StandardBridge _l1StandardBridge,\n IERC20 _l1Usdc\n )\n CrossDomainEnabled(_crossDomainMessenger)\n CircleCCTPAdapter(\n _l1Usdc,\n // Hardcode cctp messenger to 0x0 to disable CCTP bridging.\n ITokenMessenger(address(0)),\n CircleDomainIds.UNINITIALIZED\n )\n {\n L1_WETH = _l1Weth;\n L1_STANDARD_BRIDGE = _l1StandardBridge;\n }\n\n /**\n * @notice Send cross-chain message to target on Redstone.\n * @param target Contract on Redstone that will receive message.\n * @param message Data to send to target.\n */\n function relayMessage(address target, bytes calldata message) external payable override {\n sendCrossDomainMessage(target, L2_GAS_LIMIT, message);\n emit MessageRelayed(target, message);\n }\n\n /**\n * @notice Bridge tokens to Redstone.\n * @param l1Token L1 token to deposit.\n * @param l2Token L2 token to receive.\n * @param amount Amount of L1 tokens to deposit and L2 tokens to receive.\n * @param to Bridge recipient.\n */\n function relayTokens(\n address l1Token,\n address l2Token,\n uint256 amount,\n address to\n ) external payable override {\n // If the l1Token is weth then unwrap it to ETH then send the ETH to the standard bridge.\n if (l1Token == address(L1_WETH)) {\n L1_WETH.withdraw(amount);\n L1_STANDARD_BRIDGE.depositETHTo{ value: amount }(to, L2_GAS_LIMIT, \"\");\n }\n // Check if this token is USDC, which requires a custom bridge via CCTP.\n else if (_isCCTPEnabled() && l1Token == address(usdcToken)) {\n _transferUsdc(to, amount);\n } else {\n IL1StandardBridge _l1StandardBridge = L1_STANDARD_BRIDGE;\n\n IERC20(l1Token).safeIncreaseAllowance(address(_l1StandardBridge), amount);\n _l1StandardBridge.depositERC20To(l1Token, l2Token, to, amount, L2_GAS_LIMIT, \"\");\n }\n emit TokensRelayed(l1Token, l2Token, amount, to);\n }\n}\n"
+ },
+ "contracts/chain-adapters/Solana_Adapter.sol": {
+ "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\n\nimport { IMessageTransmitter, ITokenMessenger } from \"../external/interfaces/CCTPInterfaces.sol\";\nimport { SpokePoolInterface } from \"../interfaces/SpokePoolInterface.sol\";\nimport { AdapterInterface } from \"./interfaces/AdapterInterface.sol\";\nimport { CircleCCTPAdapter, CircleDomainIds } from \"../libraries/CircleCCTPAdapter.sol\";\nimport { Bytes32ToAddress } from \"../libraries/AddressConverters.sol\";\n\nimport { IERC20 } from \"@openzeppelin/contracts/token/ERC20/IERC20.sol\";\n\n/**\n * @notice Contract containing logic to send messages from L1 to Solana via CCTP.\n * @dev Public functions calling external contracts do not guard against reentrancy because they are expected to be\n * called via delegatecall, which will execute this contract's logic within the context of the originating contract.\n * For example, the HubPool will delegatecall these functions, therefore it's only necessary that the HubPool's methods\n * that call this contract's logic guard against reentrancy.\n * @custom:security-contact bugs@across.to\n */\n\n// solhint-disable-next-line contract-name-camelcase\ncontract Solana_Adapter is AdapterInterface, CircleCCTPAdapter {\n /**\n * @notice We use Bytes32ToAddress library to map a Solana address to an Ethereum address representation.\n * @dev The Ethereum address is derived from the Solana address by truncating it to its lowest 20 bytes. This same\n * conversion must be done by the HubPool owner when adding Solana spoke pool and setting the corresponding pool\n * rebalance and deposit routes.\n */\n using Bytes32ToAddress for bytes32;\n\n /**\n * @notice The official Circle CCTP MessageTransmitter contract endpoint.\n * @dev Posted officially here: https://developers.circle.com/stablecoins/docs/evm-smart-contracts\n */\n // solhint-disable-next-line immutable-vars-naming\n IMessageTransmitter public immutable cctpMessageTransmitter;\n\n // Solana spoke pool address, decoded from Base58 to bytes32.\n bytes32 public immutable SOLANA_SPOKE_POOL_BYTES32;\n\n // Solana spoke pool address, mapped to its EVM address representation.\n address public immutable SOLANA_SPOKE_POOL_ADDRESS;\n\n // USDC mint address on Solana, mapped to its EVM address representation.\n address public immutable SOLANA_USDC_ADDRESS;\n\n // USDC token address on Solana for the spoke pool (vault ATA), decoded from Base58 to bytes32.\n bytes32 public immutable SOLANA_SPOKE_POOL_USDC_VAULT;\n\n // Custom errors for constructor argument validation.\n error InvalidCctpTokenMessenger(address tokenMessenger);\n error InvalidCctpMessageTransmitter(address messageTransmitter);\n\n // Custom errors for relayMessage validation.\n error InvalidRelayMessageTarget(address target);\n\n // Custom errors for relayTokens validation.\n error InvalidL1Token(address l1Token);\n error InvalidL2Token(address l2Token);\n error InvalidAmount(uint256 amount);\n error InvalidTokenRecipient(address to);\n\n /**\n * @notice Constructs new Adapter.\n * @param _l1Usdc USDC address on L1.\n * @param _cctpTokenMessenger TokenMessenger contract to bridge tokens via CCTP.\n * @param _cctpMessageTransmitter MessageTransmitter contract to bridge messages via CCTP.\n * @param solanaSpokePool Solana spoke pool address, decoded from Base58 to bytes32.\n * @param solanaUsdc USDC mint address on Solana, decoded from Base58 to bytes32.\n * @param solanaSpokePoolUsdcVault USDC token address on Solana for the spoke pool, decoded from Base58 to bytes32.\n */\n constructor(\n IERC20 _l1Usdc,\n ITokenMessenger _cctpTokenMessenger,\n IMessageTransmitter _cctpMessageTransmitter,\n bytes32 solanaSpokePool,\n bytes32 solanaUsdc,\n bytes32 solanaSpokePoolUsdcVault\n ) CircleCCTPAdapter(_l1Usdc, _cctpTokenMessenger, CircleDomainIds.Solana) {\n // Solana adapter requires CCTP TokenMessenger and MessageTransmitter contracts to be set.\n if (address(_cctpTokenMessenger) == address(0)) {\n revert InvalidCctpTokenMessenger(address(_cctpTokenMessenger));\n }\n if (address(_cctpMessageTransmitter) == address(0)) {\n revert InvalidCctpMessageTransmitter(address(_cctpMessageTransmitter));\n }\n\n cctpMessageTransmitter = _cctpMessageTransmitter;\n\n SOLANA_SPOKE_POOL_BYTES32 = solanaSpokePool;\n SOLANA_SPOKE_POOL_ADDRESS = solanaSpokePool.toAddressUnchecked();\n\n SOLANA_USDC_ADDRESS = solanaUsdc.toAddressUnchecked();\n\n SOLANA_SPOKE_POOL_USDC_VAULT = solanaSpokePoolUsdcVault;\n }\n\n /**\n * @notice Send cross-chain message to target on Solana.\n * @dev Only allows sending messages to the Solana spoke pool.\n * @param target Program on Solana (translated as EVM address) that will receive message.\n * @param message Data to send to target.\n */\n function relayMessage(address target, bytes calldata message) external payable override {\n if (target != SOLANA_SPOKE_POOL_ADDRESS) {\n revert InvalidRelayMessageTarget(target);\n }\n cctpMessageTransmitter.sendMessage(CircleDomainIds.Solana, SOLANA_SPOKE_POOL_BYTES32, message);\n\n // TODO: consider if we need also to emit the translated message.\n emit MessageRelayed(target, message);\n }\n\n /**\n * @notice Bridge tokens to Solana.\n * @dev Only allows bridging USDC to Solana spoke pool.\n * @param l1Token L1 token to deposit.\n * @param l2Token L2 token to receive.\n * @param amount Amount of L1 tokens to deposit and L2 tokens to receive.\n * @param to Bridge recipient.\n */\n function relayTokens(\n address l1Token,\n address l2Token,\n uint256 amount,\n address to\n ) external payable override {\n if (l1Token != address(usdcToken)) {\n revert InvalidL1Token(l1Token);\n }\n if (l2Token != SOLANA_USDC_ADDRESS) {\n revert InvalidL2Token(l2Token);\n }\n if (amount > type(uint64).max) {\n revert InvalidAmount(amount);\n }\n if (to != SOLANA_SPOKE_POOL_ADDRESS) {\n revert InvalidTokenRecipient(to);\n }\n\n _transferUsdc(SOLANA_SPOKE_POOL_USDC_VAULT, amount);\n\n // TODO: consider if we need also to emit the translated addresses.\n emit TokensRelayed(l1Token, l2Token, amount, to);\n }\n}\n"
+ },
+ "contracts/chain-adapters/Universal_Adapter.sol": {
+ "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\n\nimport \"./interfaces/AdapterInterface.sol\";\n\nimport \"../libraries/CircleCCTPAdapter.sol\";\nimport { SpokePoolInterface } from \"../interfaces/SpokePoolInterface.sol\";\nimport { HubPoolStore } from \"./utilities/HubPoolStore.sol\";\n\ninterface IOwnable {\n function owner() external view returns (address);\n}\n\n/**\n * @notice Stores data that can be relayed to L2 SpokePool using storage proof verification and light client contracts\n * on the L2 where the SpokePool is deployed. Designed to be used as a singleton contract that can be used to relay\n * messages to multiple SpokePools on different chains.\n * @dev This contract should NOT be reused to send messages to SpokePools that have the same address on different L2s.\n * @dev This contract can be redeployed to point to a new HubPoolStore if the data store gets corrupted and new data\n * can't get written to the store for some reason. The corresponding Universal_SpokePool contract will\n * also need to be redeployed to point to the new HubPoolStore.\n * @custom:security-contact bugs@across.to\n */\ncontract Universal_Adapter is AdapterInterface, CircleCCTPAdapter {\n /// @notice Contract that stores calldata to be relayed to L2 via storage proofs.\n HubPoolStore public immutable DATA_STORE;\n\n error NotImplemented();\n\n constructor(\n HubPoolStore _store,\n IERC20 _l1Usdc,\n ITokenMessenger _cctpTokenMessenger,\n uint32 _cctpDestinationDomainId\n ) CircleCCTPAdapter(_l1Usdc, _cctpTokenMessenger, _cctpDestinationDomainId) {\n DATA_STORE = _store;\n }\n\n /**\n * @notice Saves calldata in a simple storage contract whose state can be proven and relayed to L2.\n * @param target Contract on the destination that will receive the message. Unused if the message is created\n * by the HubPool admin.\n * @param message Data to send to target.\n */\n function relayMessage(address target, bytes calldata message) external payable override {\n // Admin messages are stored differently in the data store than non-admin messages, because admin\n // messages must only be sent to a single target on a specific L2 chain. Non-admin messages are sent\n // to any target on any L2 chain because the only type of an non-admin message is the result of a\n // HubPool.executeRootBundle() call which attempts to relay a relayRootBundle() call to all SpokePools using\n // this adapter. Therefore, non-admin messages are stored optimally in the data store\n // by only storing the message once and allowing any SpokePool target to read it via storage proofs.\n\n // We assume that the HubPool is delegatecall-ing into this function, therefore address(this) is the HubPool's\n // address. As a result, we can determine whether this message is an admin function based on the msg.sender.\n // If an admin sends a message that could have been relayed as a non-admin message (e.g. the admin\n // calls executeRootBundle()), then the message won't be stored optimally in the data store, but the\n // message can still be delivered to the target.\n bool isAdminSender = msg.sender == IOwnable(address(this)).owner();\n DATA_STORE.storeRelayMessageCalldata(target, message, isAdminSender);\n emit MessageRelayed(target, message);\n }\n\n /**\n * @notice Relays tokens from L1 to L2.\n * @dev This function only uses the CircleCCTPAdapter to relay USDC tokens to CCTP enabled L2 chains.\n * Relaying other tokens will cause this function to revert.\n * @param l1Token Address of the token on L1.\n * @param l2Token Address of the token on L2. Unused\n * @param amount Amount of tokens to relay.\n * @param to Address to receive the tokens on L2. Should be SpokePool address.\n */\n function relayTokens(\n address l1Token,\n address l2Token,\n uint256 amount,\n address to\n ) external payable override {\n if (_isCCTPEnabled() && l1Token == address(usdcToken)) {\n _transferUsdc(to, amount);\n } else {\n revert NotImplemented();\n }\n }\n}\n"
+ },
+ "contracts/chain-adapters/utilities/HubPoolStore.sol": {
+ "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\n\nimport { HubPoolInterface } from \"../../interfaces/HubPoolInterface.sol\";\n\ninterface IHubPool {\n function rootBundleProposal() external view returns (HubPoolInterface.RootBundle memory);\n}\n\n/**\n * @notice Stores data that can be relayed to L2 SpokePool using storage proof verification and light client contracts\n * on the L2 where the SpokePool is deployed. Only the HubPool can store data to this contract. Each data to be\n * relayed is written to a unique slot key and that slot key's value can never be modified.\n * @dev Designed to be used with Universal_Adapter and Universal_SpokePool.\n * @dev This contract DOES NOT prevent replay attacks of storage proofs on the L2 spoke pool if the\n * UniversalStorageProof_Adapters using this contract are mapped to spokepools with the same address on different\n * L2 chains. See comment in storeRelayAdminFunctionCalldata() for more details.\n * @custom:security-contact bugs@across.to\n */\ncontract HubPoolStore {\n error NotHubPool();\n\n /// @notice Maps nonce to hash of calldata.\n mapping(uint256 => bytes32) public relayMessageCallData;\n\n /// @notice Counter to ensure that each relay admin function calldata is unique.\n uint256 private dataUuid;\n\n /// @notice Address of the HubPool contract, the only contract that can store data to this contract.\n address public immutable hubPool;\n\n /// @notice Event designed to be queried off chain and relayed to Universal SpokePool.\n event StoredCallData(address indexed target, bytes data, uint256 indexed nonce);\n\n modifier onlyHubPool() {\n if (msg.sender != hubPool) {\n revert NotHubPool();\n }\n _;\n }\n\n constructor(address _hubPool) {\n hubPool = _hubPool;\n }\n\n /**\n * @notice To be called by HubPool to store calldata that will be relayed\n * to the Universal_SpokePool via storage proofs.\n * @dev Only callable by the HubPool contract.\n * @param target Address of the contract on the destination that will receive the message. Unused if the\n * data is NOT an admin function and can be relayed to any target.\n * @param data Data to send to Universal SpokePool.\n * @param isAdminSender True if the data is an admin function call, false otherwise.\n */\n function storeRelayMessageCalldata(\n address target,\n bytes calldata data,\n bool isAdminSender\n ) external onlyHubPool {\n if (isAdminSender) {\n _storeData(target, dataUuid++, data);\n } else {\n _storeRelayMessageCalldataForAnyTarget(data);\n }\n }\n\n function _storeRelayMessageCalldataForAnyTarget(bytes calldata data) internal {\n // When the data can be sent to any target, we assume that the data contains a relayRootBundleCall as\n // constructed by an executeRootBundle() call, therefore this data will be identical for all spoke pools\n // in this bundle. We can use the current hub pool's challengePeriodEndTimestamp as the nonce for this data\n // so that all relayRootBundle calldata for this bundle gets stored to the same slot and we only write to\n // this slot once.\n _storeData(address(0), IHubPool(hubPool).rootBundleProposal().challengePeriodEndTimestamp, data);\n }\n\n function _storeData(\n address target,\n uint256 nonce,\n bytes calldata data\n ) internal {\n if (relayMessageCallData[nonce] != bytes32(0)) {\n // Data is already stored, do nothing.\n return;\n }\n relayMessageCallData[nonce] = keccak256(abi.encode(target, data));\n emit StoredCallData(target, data, nonce);\n }\n}\n"
+ },
+ "contracts/chain-adapters/WorldChain_Adapter.sol": {
+ "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\n\nimport \"./interfaces/AdapterInterface.sol\";\nimport \"../external/interfaces/WETH9Interface.sol\";\n\n// @dev Use local modified CrossDomainEnabled contract instead of one exported by eth-optimism because we need\n// this contract's state variables to be `immutable` because of the delegateCall call.\nimport \"./CrossDomainEnabled.sol\";\nimport \"@eth-optimism/contracts/L1/messaging/IL1StandardBridge.sol\";\n\nimport \"@openzeppelin/contracts/token/ERC20/IERC20.sol\";\nimport \"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\";\n\nimport \"../libraries/CircleCCTPAdapter.sol\";\nimport \"../external/interfaces/CCTPInterfaces.sol\";\n\n/**\n * @notice Contract containing logic to send messages from L1 to Doctor Who. This is a modified version of the Optimism adapter\n * that excludes the custom bridging logic.\n * @custom:security-contact bugs@across.to\n * @dev Public functions calling external contracts do not guard against reentrancy because they are expected to be\n * called via delegatecall, which will execute this contract's logic within the context of the originating contract.\n * For example, the HubPool will delegatecall these functions, therefore its only necessary that the HubPool's methods\n * that call this contract's logic guard against reentrancy.\n */\n\n// solhint-disable-next-line contract-name-camelcase\ncontract WorldChain_Adapter is CrossDomainEnabled, AdapterInterface, CircleCCTPAdapter {\n using SafeERC20 for IERC20;\n uint32 public constant L2_GAS_LIMIT = 200_000;\n\n WETH9Interface public immutable L1_WETH;\n\n IL1StandardBridge public immutable L1_STANDARD_BRIDGE;\n\n /**\n * @notice Constructs new Adapter.\n * @param _l1Weth WETH address on L1.\n * @param _crossDomainMessenger XDomainMessenger Doctor Who system contract.\n * @param _l1StandardBridge Standard bridge contract.\n * @param _l1Usdc USDC address on L1.\n * @param _cctpTokenMessenger TokenMessenger contract to bridge via CCTP.\n */\n constructor(\n WETH9Interface _l1Weth,\n address _crossDomainMessenger,\n IL1StandardBridge _l1StandardBridge,\n IERC20 _l1Usdc,\n ITokenMessenger _cctpTokenMessenger\n )\n CrossDomainEnabled(_crossDomainMessenger)\n CircleCCTPAdapter(_l1Usdc, _cctpTokenMessenger, CircleDomainIds.WorldChain)\n {\n L1_WETH = _l1Weth;\n L1_STANDARD_BRIDGE = _l1StandardBridge;\n }\n\n /**\n * @notice Send cross-chain message to target on Doctor Who.\n * @param target Contract on Doctor Who that will receive message.\n * @param message Data to send to target.\n */\n function relayMessage(address target, bytes calldata message) external payable override {\n sendCrossDomainMessage(target, L2_GAS_LIMIT, message);\n emit MessageRelayed(target, message);\n }\n\n /**\n * @notice Bridge tokens to Doctor Who.\n * @param l1Token L1 token to deposit.\n * @param l2Token L2 token to receive.\n * @param amount Amount of L1 tokens to deposit and L2 tokens to receive.\n * @param to Bridge recipient.\n */\n function relayTokens(\n address l1Token,\n address l2Token,\n uint256 amount,\n address to\n ) external payable override {\n // If the l1Token is weth then unwrap it to ETH then send the ETH to the standard bridge.\n if (l1Token == address(L1_WETH)) {\n L1_WETH.withdraw(amount);\n L1_STANDARD_BRIDGE.depositETHTo{ value: amount }(to, L2_GAS_LIMIT, \"\");\n }\n // Check if this token is USDC, which requires a custom bridge via CCTP.\n else if (_isCCTPEnabled() && l1Token == address(usdcToken)) {\n _transferUsdc(to, amount);\n } else {\n IL1StandardBridge _l1StandardBridge = L1_STANDARD_BRIDGE;\n\n IERC20(l1Token).safeIncreaseAllowance(address(_l1StandardBridge), amount);\n _l1StandardBridge.depositERC20To(l1Token, l2Token, to, amount, L2_GAS_LIMIT, \"\");\n }\n emit TokensRelayed(l1Token, l2Token, amount, to);\n }\n}\n"
+ },
+ "contracts/chain-adapters/ZkStack_Adapter.sol": {
+ "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\n\nimport \"./interfaces/AdapterInterface.sol\";\nimport \"../external/interfaces/WETH9Interface.sol\";\n\nimport \"@openzeppelin/contracts/token/ERC20/IERC20.sol\";\nimport \"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\";\nimport { BridgeHubInterface } from \"../interfaces/ZkStackBridgeHub.sol\";\nimport { CircleCCTPAdapter } from \"../libraries/CircleCCTPAdapter.sol\";\nimport { ITokenMessenger } from \"../external/interfaces/CCTPInterfaces.sol\";\n\n/**\n * @notice Contract containing logic to send messages from L1 to ZkStack with ETH as the gas token.\n * @dev Public functions calling external contracts do not guard against reentrancy because they are expected to be\n * called via delegatecall, which will execute this contract's logic within the context of the originating contract.\n * For example, the HubPool will delegatecall these functions, therefore its only necessary that the HubPool's methods\n * that call this contract's logic guard against reentrancy.\n * @custom:security-contact bugs@across.to\n */\n\n// solhint-disable-next-line contract-name-camelcase\ncontract ZkStack_Adapter is AdapterInterface, CircleCCTPAdapter {\n using SafeERC20 for IERC20;\n\n // The ZkSync bridgehub contract treats address(1) to represent ETH.\n address private constant ETH_TOKEN_ADDRESS = address(1);\n\n // We need to pay a base fee to the operator to include our L1 --> L2 transaction.\n // https://docs.zksync.io/build/developer-reference/l1-l2-interoperability#l1-to-l2-gas-estimation-for-transactions\n\n // Limit on L2 gas to spend.\n uint256 public immutable L2_GAS_LIMIT; // typically 2_000_000\n\n // How much gas is required to publish a byte of data from L1 to L2. 800 is the required value\n // as set here https://github.com/matter-labs/era-contracts/blob/6391c0d7bf6184d7f6718060e3991ba6f0efe4a7/ethereum/contracts/zksync/facets/Mailbox.sol#L226\n // Note, this value can change and will require an updated adapter.\n uint256 public immutable L1_GAS_TO_L2_GAS_PER_PUB_DATA_LIMIT; // Typically 800\n\n // This address receives any remaining fee after an L1 to L2 transaction completes.\n // If refund recipient = address(0) then L2 msg.sender is used, unless msg.sender is a contract then its address\n // gets aliased.\n address public immutable L2_REFUND_ADDRESS;\n\n // L2 chain id\n uint256 public immutable CHAIN_ID;\n\n // BridgeHub address\n BridgeHubInterface public immutable BRIDGE_HUB;\n\n // Set l1Weth at construction time to make testing easier.\n WETH9Interface public immutable L1_WETH;\n\n // USDC SharedBridge address, which is passed in on construction and used as the second bridge contract for USDC transfers.\n address public immutable USDC_SHARED_BRIDGE;\n\n // The maximum gas price a transaction sent to this adapter may have. This is set to prevent a block producer from setting an artificially high priority fee\n // when calling a hub pool message relay, which would otherwise cause a large amount of ETH to be sent to L2.\n uint256 private immutable MAX_TX_GASPRICE;\n\n error ETHGasTokenRequired();\n error TransactionFeeTooHigh();\n error InvalidBridgeConfig();\n\n /**\n * @notice Constructs new Adapter.\n * @notice Circle bridged & native USDC are optionally supported via configuration, but are mutually exclusive.\n * @param _chainId The target ZkStack network's chain ID.\n * @param _bridgeHub The bridge hub contract address for the ZkStack network.\n * @param _circleUSDC Circle USDC address on L1. If not set to address(0), then either the USDCSharedBridge\n * or CCTP token messenger must be set and will be used to bridge this token.\n * @param _usdcSharedBridge Address of the second bridge contract for USDC corresponding to the configured ZkStack network.\n * @param _cctpTokenMessenger address of the CCTP token messenger contract for the configured network.\n * @param _recipientCircleDomainId Circle domain ID for the destination network.\n * @param _l1Weth WETH address on L1.\n * @param _l2RefundAddress address that recieves excess gas refunds on L2.\n * @param _l2GasLimit The maximum amount of gas this contract is willing to pay to execute a transaction on L2.\n * @param _l1GasToL2GasPerPubDataLimit The exchange rate of l1 gas to l2 gas.\n * @param _maxTxGasprice The maximum effective gas price any transaction sent to this adapter may have.\n */\n constructor(\n uint256 _chainId,\n BridgeHubInterface _bridgeHub,\n IERC20 _circleUSDC,\n address _usdcSharedBridge,\n ITokenMessenger _cctpTokenMessenger,\n uint32 _recipientCircleDomainId,\n WETH9Interface _l1Weth,\n address _l2RefundAddress,\n uint256 _l2GasLimit,\n uint256 _l1GasToL2GasPerPubDataLimit,\n uint256 _maxTxGasprice\n ) CircleCCTPAdapter(_circleUSDC, _cctpTokenMessenger, _recipientCircleDomainId) {\n CHAIN_ID = _chainId;\n BRIDGE_HUB = _bridgeHub;\n L1_WETH = _l1Weth;\n L2_REFUND_ADDRESS = _l2RefundAddress;\n L2_GAS_LIMIT = _l2GasLimit;\n MAX_TX_GASPRICE = _maxTxGasprice;\n L1_GAS_TO_L2_GAS_PER_PUB_DATA_LIMIT = _l1GasToL2GasPerPubDataLimit;\n address zero = address(0);\n if (address(_circleUSDC) != zero) {\n bool zkUSDCBridgeDisabled = _usdcSharedBridge == zero;\n bool cctpUSDCBridgeDisabled = address(_cctpTokenMessenger) == zero;\n // Bridged and Native USDC are mutually exclusive.\n if (zkUSDCBridgeDisabled == cctpUSDCBridgeDisabled) {\n revert InvalidBridgeConfig();\n }\n }\n USDC_SHARED_BRIDGE = _usdcSharedBridge;\n address gasToken = BRIDGE_HUB.baseToken(CHAIN_ID);\n if (gasToken != ETH_TOKEN_ADDRESS) {\n revert ETHGasTokenRequired();\n }\n }\n\n /**\n * @notice Send cross-chain message to target on ZkStack.\n * @dev The HubPool must hold enough ETH to pay for the L2 txn.\n * @param target Contract on L2 that will receive message.\n * @param message Data to send to target.\n */\n function relayMessage(address target, bytes memory message) external payable override {\n uint256 txBaseCost = _computeETHTxCost(L2_GAS_LIMIT);\n\n BRIDGE_HUB.requestL2TransactionDirect{ value: txBaseCost }(\n BridgeHubInterface.L2TransactionRequestDirect({\n chainId: CHAIN_ID,\n mintValue: txBaseCost,\n l2Contract: target,\n l2Value: 0,\n l2Calldata: message,\n l2GasLimit: L2_GAS_LIMIT,\n l2GasPerPubdataByteLimit: L1_GAS_TO_L2_GAS_PER_PUB_DATA_LIMIT,\n factoryDeps: new bytes[](0),\n refundRecipient: L2_REFUND_ADDRESS\n })\n );\n\n emit MessageRelayed(target, message);\n }\n\n /**\n * @notice Bridge tokens to ZkStack.\n * @dev The HubPool must hold enough ETH to pay for the L2 txn.\n * @param l1Token L1 token to deposit.\n * @param l2Token L2 token to receive.\n * @param amount Amount of L1 tokens to deposit and L2 tokens to receive.\n * @param to Bridge recipient.\n */\n function relayTokens(\n address l1Token,\n address l2Token, // l2Token is unused.\n uint256 amount,\n address to\n ) external payable override {\n // A bypass proxy seems to no longer be needed to avoid deposit limits. The tracking of these limits seems to be deprecated.\n // See: https://github.com/matter-labs/era-contracts/blob/bce4b2d0f34bd87f1aaadd291772935afb1c3bd6/l1-contracts/contracts/bridge/L1ERC20Bridge.sol#L54-L55\n uint256 txBaseCost = _computeETHTxCost(L2_GAS_LIMIT);\n\n bytes32 txHash;\n if (l1Token == address(L1_WETH)) {\n // If the l1Token is WETH then unwrap it to ETH then send the ETH to the standard bridge along with the base\n // cost.\n L1_WETH.withdraw(amount);\n txHash = BRIDGE_HUB.requestL2TransactionDirect{ value: amount + txBaseCost }(\n BridgeHubInterface.L2TransactionRequestDirect({\n chainId: CHAIN_ID,\n mintValue: txBaseCost + amount,\n l2Contract: to,\n l2Value: amount,\n l2Calldata: \"\",\n l2GasLimit: L2_GAS_LIMIT,\n l2GasPerPubdataByteLimit: L1_GAS_TO_L2_GAS_PER_PUB_DATA_LIMIT,\n factoryDeps: new bytes[](0),\n refundRecipient: L2_REFUND_ADDRESS\n })\n );\n } else if (l1Token == address(usdcToken)) {\n // Either use CCTP or the custom shared bridge when bridging USDC.\n if (_isCCTPEnabled()) {\n _transferUsdc(to, amount);\n } else {\n IERC20(l1Token).forceApprove(USDC_SHARED_BRIDGE, amount);\n txHash = BRIDGE_HUB.requestL2TransactionTwoBridges(\n BridgeHubInterface.L2TransactionRequestTwoBridgesOuter({\n chainId: CHAIN_ID,\n mintValue: txBaseCost,\n l2Value: 0,\n l2GasLimit: L2_GAS_LIMIT,\n l2GasPerPubdataByteLimit: L1_GAS_TO_L2_GAS_PER_PUB_DATA_LIMIT,\n refundRecipient: L2_REFUND_ADDRESS,\n secondBridgeAddress: USDC_SHARED_BRIDGE,\n secondBridgeValue: 0,\n secondBridgeCalldata: _secondBridgeCalldata(to, l1Token, amount)\n })\n );\n }\n } else {\n // An standard bridged ERC20, separate from WETH and Circle Bridged/Native USDC.\n address sharedBridge = BRIDGE_HUB.sharedBridge();\n IERC20(l1Token).forceApprove(sharedBridge, amount);\n txHash = BRIDGE_HUB.requestL2TransactionTwoBridges{ value: txBaseCost }(\n BridgeHubInterface.L2TransactionRequestTwoBridgesOuter({\n chainId: CHAIN_ID,\n mintValue: txBaseCost,\n l2Value: 0,\n l2GasLimit: L2_GAS_LIMIT,\n l2GasPerPubdataByteLimit: L1_GAS_TO_L2_GAS_PER_PUB_DATA_LIMIT,\n refundRecipient: L2_REFUND_ADDRESS,\n secondBridgeAddress: sharedBridge,\n secondBridgeValue: 0,\n secondBridgeCalldata: _secondBridgeCalldata(to, l1Token, amount)\n })\n );\n }\n\n emit TokensRelayed(l1Token, l2Token, amount, to);\n }\n\n /**\n * @notice Computes the calldata for the \"second bridge\", which handles sending non native tokens.\n * @param l2Recipient recipient of the tokens.\n * @param l1Token the l1 address of the token. Note: ETH is encoded as address(1).\n * @param amount number of tokens to send.\n * @return abi encoded bytes.\n */\n function _secondBridgeCalldata(\n address l2Recipient,\n address l1Token,\n uint256 amount\n ) internal pure returns (bytes memory) {\n return abi.encode(l1Token, amount, l2Recipient);\n }\n\n /**\n * @notice For a given l2 gas limit, this computes the amount of ETH needed and\n * returns the amount.\n * @param l2GasLimit L2 gas limit for the message.\n * @return amount of ETH that this contract needs to provide in order for the l2 transaction to succeed.\n */\n function _computeETHTxCost(uint256 l2GasLimit) internal view returns (uint256) {\n if (tx.gasprice > MAX_TX_GASPRICE) revert TransactionFeeTooHigh();\n return BRIDGE_HUB.l2TransactionBaseCost(CHAIN_ID, tx.gasprice, l2GasLimit, L1_GAS_TO_L2_GAS_PER_PUB_DATA_LIMIT);\n }\n}\n"
+ },
+ "contracts/chain-adapters/ZkStack_CustomGasToken_Adapter.sol": {
+ "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\n\nimport \"./interfaces/AdapterInterface.sol\";\nimport \"../external/interfaces/WETH9Interface.sol\";\n\nimport \"@openzeppelin/contracts/token/ERC20/IERC20.sol\";\nimport \"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\";\nimport { BridgeHubInterface } from \"../interfaces/ZkStackBridgeHub.sol\";\nimport { CircleCCTPAdapter } from \"../libraries/CircleCCTPAdapter.sol\";\nimport { ITokenMessenger } from \"../external/interfaces/CCTPInterfaces.sol\";\n\n/**\n * @notice Interface for funder contract that this contract pulls from to pay for relayMessage()/relayTokens()\n * fees using a custom gas token.\n */\ninterface FunderInterface {\n /**\n * @notice Withdraws amount of token from funder contract to the caller.\n * @dev Can only be called by owner of Funder contract, which therefore must be\n * this contract.\n * @param token Token to withdraw.\n * @param amount Amount to withdraw.\n */\n function withdraw(IERC20 token, uint256 amount) external;\n}\n\n/**\n * @notice Contract containing logic to send messages from L1 to ZkStack with a custom gas token.\n * @dev Public functions calling external contracts do not guard against reentrancy because they are expected to be\n * called via delegatecall, which will execute this contract's logic within the context of the originating contract.\n * For example, the HubPool will delegatecall these functions, therefore its only necessary that the HubPool's methods\n * that call this contract's logic guard against reentrancy.\n * @custom:security-contact bugs@across.to\n */\n\n// solhint-disable-next-line contract-name-camelcase\ncontract ZkStack_CustomGasToken_Adapter is AdapterInterface, CircleCCTPAdapter {\n using SafeERC20 for IERC20;\n\n // The ZkSync bridgehub contract treats address(1) to represent ETH.\n address private constant ETH_TOKEN_ADDRESS = address(1);\n\n // We need to pay a base fee to the operator to include our L1 --> L2 transaction.\n // https://docs.zksync.io/build/developer-reference/l1-l2-interoperability#l1-to-l2-gas-estimation-for-transactions\n\n // Limit on L2 gas to spend.\n uint256 public immutable L2_GAS_LIMIT; // typically 2_000_000\n\n // How much gas is required to publish a byte of data from L1 to L2. 800 is the required value\n // as set here https://github.com/matter-labs/era-contracts/blob/6391c0d7bf6184d7f6718060e3991ba6f0efe4a7/ethereum/contracts/zksync/facets/Mailbox.sol#L226\n // Note, this value can change and will require an updated adapter.\n uint256 public immutable L1_GAS_TO_L2_GAS_PER_PUB_DATA_LIMIT; // Typically 800\n\n // This address receives any remaining fee after an L1 to L2 transaction completes.\n // If refund recipient = address(0) then L2 msg.sender is used, unless msg.sender is a contract then its address\n // gets aliased.\n address public immutable L2_REFUND_ADDRESS;\n\n // L2 chain id\n uint256 public immutable CHAIN_ID;\n\n // BridgeHub address\n BridgeHubInterface public immutable BRIDGE_HUB;\n\n // Set l1Weth at construction time to make testing easier.\n WETH9Interface public immutable L1_WETH;\n\n // USDC SharedBridge address, which is passed in on construction and used as the second bridge contract for USDC transfers.\n address public immutable USDC_SHARED_BRIDGE;\n\n // Custom gas token address, which is read from the BridgeHub at construction.\n address public immutable CUSTOM_GAS_TOKEN;\n\n // Custom gas token funder\n FunderInterface public immutable CUSTOM_GAS_TOKEN_FUNDER;\n\n // The maximum gas price a transaction sent to this adapter may have. This is set to prevent a block producer from setting an artificially high priority fee\n // when calling a hub pool message relay, which would otherwise cause a large amount of the custom gas token to be sent to L2.\n uint256 private immutable MAX_TX_GASPRICE;\n\n error ETHGasTokenNotAllowed();\n error TransactionFeeTooHigh();\n error InvalidBridgeConfig();\n\n /**\n * @notice Constructs new Adapter.\n * @notice Circle bridged & native USDC are optionally supported via configuration, but are mutually exclusive.\n * @param _chainId The target ZkStack network's chain ID.\n * @param _bridgeHub The bridge hub contract address for the ZkStack network.\n * @param _circleUSDC Circle USDC address on L1. If not set to address(0), then either the USDCSharedBridge\n * or CCTP token messenger must be set and will be used to bridge this token.\n * @param _usdcSharedBridge Address of the second bridge contract for USDC corresponding to the configured ZkStack network.\n * @param _cctpTokenMessenger address of the CCTP token messenger contract for the configured network.\n * @param _recipientCircleDomainId Circle domain ID for the destination network.\n * @param _l1Weth WETH address on L1.\n * @param _l2RefundAddress address that recieves excess gas refunds on L2.\n * @param _customGasTokenFunder Contract on L1 which funds bridge fees with amounts in the custom gas token.\n * @param _l2GasLimit The maximum amount of gas this contract is willing to pay to execute a transaction on L2.\n * @param _l1GasToL2GasPerPubDataLimit The exchange rate of l1 gas to l2 gas.\n * @param _maxTxGasprice The maximum effective gas price any transaction sent to this adapter may have.\n */\n constructor(\n uint256 _chainId,\n BridgeHubInterface _bridgeHub,\n IERC20 _circleUSDC,\n address _usdcSharedBridge,\n ITokenMessenger _cctpTokenMessenger,\n uint32 _recipientCircleDomainId,\n WETH9Interface _l1Weth,\n address _l2RefundAddress,\n FunderInterface _customGasTokenFunder,\n uint256 _l2GasLimit,\n uint256 _l1GasToL2GasPerPubDataLimit,\n uint256 _maxTxGasprice\n ) CircleCCTPAdapter(_circleUSDC, _cctpTokenMessenger, _recipientCircleDomainId) {\n CHAIN_ID = _chainId;\n BRIDGE_HUB = _bridgeHub;\n L1_WETH = _l1Weth;\n L2_REFUND_ADDRESS = _l2RefundAddress;\n CUSTOM_GAS_TOKEN_FUNDER = _customGasTokenFunder;\n L2_GAS_LIMIT = _l2GasLimit;\n MAX_TX_GASPRICE = _maxTxGasprice;\n L1_GAS_TO_L2_GAS_PER_PUB_DATA_LIMIT = _l1GasToL2GasPerPubDataLimit;\n address zero = address(0);\n if (address(_circleUSDC) != zero) {\n bool zkUSDCBridgeDisabled = _usdcSharedBridge == zero;\n bool cctpUSDCBridgeDisabled = address(_cctpTokenMessenger) == zero;\n // Bridged and Native USDC are mutually exclusive.\n if (zkUSDCBridgeDisabled == cctpUSDCBridgeDisabled) {\n revert InvalidBridgeConfig();\n }\n }\n USDC_SHARED_BRIDGE = _usdcSharedBridge;\n CUSTOM_GAS_TOKEN = BRIDGE_HUB.baseToken(CHAIN_ID);\n if (CUSTOM_GAS_TOKEN == ETH_TOKEN_ADDRESS) {\n revert ETHGasTokenNotAllowed();\n }\n }\n\n /**\n * @notice Send cross-chain message to target on ZkStack.\n * @dev The CUSTOM_GAS_TOKEN_FUNDER must hold enough of the gas token to pay for the L2 txn.\n * @param target Contract on L2 that will receive message.\n * @param message Data to send to target.\n */\n function relayMessage(address target, bytes memory message) external payable override {\n uint256 txBaseCost = _pullCustomGas(L2_GAS_LIMIT);\n IERC20(CUSTOM_GAS_TOKEN).forceApprove(BRIDGE_HUB.sharedBridge(), txBaseCost);\n\n BRIDGE_HUB.requestL2TransactionDirect(\n BridgeHubInterface.L2TransactionRequestDirect({\n chainId: CHAIN_ID,\n mintValue: txBaseCost,\n l2Contract: target,\n l2Value: 0,\n l2Calldata: message,\n l2GasLimit: L2_GAS_LIMIT,\n l2GasPerPubdataByteLimit: L1_GAS_TO_L2_GAS_PER_PUB_DATA_LIMIT,\n factoryDeps: new bytes[](0),\n refundRecipient: L2_REFUND_ADDRESS\n })\n );\n\n emit MessageRelayed(target, message);\n }\n\n /**\n * @notice Bridge tokens to ZkStack.\n * @dev The CUSTOM_GAS_TOKEN_FUNDER must hold enough of the gas token to pay for the L2 txn.\n * @param l1Token L1 token to deposit.\n * @param l2Token L2 token to receive.\n * @param amount Amount of L1 tokens to deposit and L2 tokens to receive.\n * @param to Bridge recipient.\n */\n function relayTokens(\n address l1Token,\n address l2Token, // l2Token is unused.\n uint256 amount,\n address to\n ) external payable override {\n // The Hub Pool will always bridge via CCTP to a ZkStack network if CCTP is enabled for that network. Therefore, we can short-circuit ZkStack-specific logic\n // like pulling custom gas or getting the shared bridge address if CCTP is enabled and we are bridging USDC.\n if (l1Token == address(usdcToken) && _isCCTPEnabled()) {\n _transferUsdc(to, amount);\n emit TokensRelayed(l1Token, l2Token, amount, to);\n return;\n }\n // A bypass proxy seems to no longer be needed to avoid deposit limits. The tracking of these limits seems to be deprecated.\n // See: https://github.com/matter-labs/era-contracts/blob/bce4b2d0f34bd87f1aaadd291772935afb1c3bd6/l1-contracts/contracts/bridge/L1ERC20Bridge.sol#L54-L55\n uint256 txBaseCost = _pullCustomGas(L2_GAS_LIMIT);\n address sharedBridge = BRIDGE_HUB.sharedBridge();\n\n bytes32 txHash;\n if (l1Token == address(L1_WETH)) {\n // If the l1Token is WETH then unwrap it to ETH then send the ETH to the standard bridge along with the base\n // cost of custom gas tokens.\n L1_WETH.withdraw(amount);\n IERC20(CUSTOM_GAS_TOKEN).forceApprove(sharedBridge, txBaseCost);\n // Note: When bridging ETH with `L2TransactionRequestTwoBridgesOuter`, the second bridge must be 0 for the shared bridge call to not revert.\n // https://github.com/matter-labs/era-contracts/blob/aafee035db892689df3f7afe4b89fd6467a39313/l1-contracts/contracts/bridge/L1SharedBridge.sol#L328\n txHash = BRIDGE_HUB.requestL2TransactionTwoBridges{ value: amount }(\n BridgeHubInterface.L2TransactionRequestTwoBridgesOuter({\n chainId: CHAIN_ID,\n mintValue: txBaseCost,\n l2Value: 0,\n l2GasLimit: L2_GAS_LIMIT,\n l2GasPerPubdataByteLimit: L1_GAS_TO_L2_GAS_PER_PUB_DATA_LIMIT,\n refundRecipient: L2_REFUND_ADDRESS,\n secondBridgeAddress: sharedBridge,\n secondBridgeValue: amount,\n secondBridgeCalldata: _secondBridgeCalldata(to, ETH_TOKEN_ADDRESS, 0)\n })\n );\n } else if (l1Token == CUSTOM_GAS_TOKEN) {\n // The chain's custom gas token.\n IERC20(l1Token).forceApprove(sharedBridge, txBaseCost + amount);\n txHash = BRIDGE_HUB.requestL2TransactionDirect(\n BridgeHubInterface.L2TransactionRequestDirect({\n chainId: CHAIN_ID,\n mintValue: txBaseCost + amount,\n l2Contract: to,\n l2Value: amount,\n l2Calldata: \"\",\n l2GasLimit: L2_GAS_LIMIT,\n l2GasPerPubdataByteLimit: L1_GAS_TO_L2_GAS_PER_PUB_DATA_LIMIT,\n factoryDeps: new bytes[](0),\n refundRecipient: L2_REFUND_ADDRESS\n })\n );\n } else if (l1Token == address(usdcToken)) {\n // Since we already checked if we are bridging USDC via CCTP, if this conditional is hit, then we must be bridging USDC via the `USDC_SHARED_BRIDGE`.\n IERC20(CUSTOM_GAS_TOKEN).forceApprove(sharedBridge, txBaseCost);\n IERC20(l1Token).forceApprove(USDC_SHARED_BRIDGE, amount);\n txHash = BRIDGE_HUB.requestL2TransactionTwoBridges(\n BridgeHubInterface.L2TransactionRequestTwoBridgesOuter({\n chainId: CHAIN_ID,\n mintValue: txBaseCost,\n l2Value: 0,\n l2GasLimit: L2_GAS_LIMIT,\n l2GasPerPubdataByteLimit: L1_GAS_TO_L2_GAS_PER_PUB_DATA_LIMIT,\n refundRecipient: L2_REFUND_ADDRESS,\n secondBridgeAddress: USDC_SHARED_BRIDGE,\n secondBridgeValue: 0,\n secondBridgeCalldata: _secondBridgeCalldata(to, l1Token, amount)\n })\n );\n } else {\n // An standard bridged ERC20, separate from WETH and Circle Bridged/Native USDC.\n IERC20(CUSTOM_GAS_TOKEN).forceApprove(sharedBridge, txBaseCost);\n IERC20(l1Token).forceApprove(sharedBridge, amount);\n txHash = BRIDGE_HUB.requestL2TransactionTwoBridges(\n BridgeHubInterface.L2TransactionRequestTwoBridgesOuter({\n chainId: CHAIN_ID,\n mintValue: txBaseCost,\n l2Value: 0,\n l2GasLimit: L2_GAS_LIMIT,\n l2GasPerPubdataByteLimit: L1_GAS_TO_L2_GAS_PER_PUB_DATA_LIMIT,\n refundRecipient: L2_REFUND_ADDRESS,\n secondBridgeAddress: sharedBridge,\n secondBridgeValue: 0,\n secondBridgeCalldata: _secondBridgeCalldata(to, l1Token, amount)\n })\n );\n }\n\n emit TokensRelayed(l1Token, l2Token, amount, to);\n }\n\n /**\n * @notice Computes the calldata for the \"second bridge\", which handles sending non native tokens.\n * @param l2Recipient recipient of the tokens.\n * @param l1Token the l1 address of the token. Note: ETH is encoded as address(1).\n * @param amount number of tokens to send.\n * @return abi encoded bytes.\n */\n function _secondBridgeCalldata(\n address l2Recipient,\n address l1Token,\n uint256 amount\n ) internal pure returns (bytes memory) {\n return abi.encode(l1Token, amount, l2Recipient);\n }\n\n /**\n * @notice For a given l2 gas limit, this computes the amount of tokens needed, pulls them from the funder, and\n * returns the amount.\n * @dev Should return a value in the same precision as the gas token's precision.\n * @param l2GasLimit L2 gas limit for the message.\n * @return amount of gas token that this contract needs to provide in order for the l2 transaction to succeed.\n */\n function _pullCustomGas(uint256 l2GasLimit) internal returns (uint256) {\n if (tx.gasprice > MAX_TX_GASPRICE) revert TransactionFeeTooHigh();\n uint256 cost = BRIDGE_HUB.l2TransactionBaseCost(\n CHAIN_ID,\n tx.gasprice,\n l2GasLimit,\n L1_GAS_TO_L2_GAS_PER_PUB_DATA_LIMIT\n );\n CUSTOM_GAS_TOKEN_FUNDER.withdraw(IERC20(CUSTOM_GAS_TOKEN), cost);\n\n return cost;\n }\n}\n"
+ },
+ "contracts/chain-adapters/Zora_Adapter.sol": {
+ "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\n\nimport \"./interfaces/AdapterInterface.sol\";\nimport \"../external/interfaces/WETH9Interface.sol\";\n\n// @dev Use local modified CrossDomainEnabled contract instead of one exported by eth-optimism because we need\n// this contract's state variables to be `immutable` because of the delegateCall call.\nimport \"./CrossDomainEnabled.sol\";\nimport \"@eth-optimism/contracts/L1/messaging/IL1StandardBridge.sol\";\n\nimport \"@openzeppelin/contracts/token/ERC20/IERC20.sol\";\nimport \"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\";\n\nimport \"../libraries/CircleCCTPAdapter.sol\";\nimport \"../external/interfaces/CCTPInterfaces.sol\";\n\n/**\n * @notice Contract containing logic to send messages from L1 to Zora. This is a clone of the Base/Mode adapter\n * @dev Public functions calling external contracts do not guard against reentrancy because they are expected to be\n * called via delegatecall, which will execute this contract's logic within the context of the originating contract.\n * For example, the HubPool will delegatecall these functions, therefore its only necessary that the HubPool's methods\n * that call this contract's logic guard against reentrancy.\n * @custom:security-contact bugs@across.to\n */\n\n// solhint-disable-next-line contract-name-camelcase\ncontract Zora_Adapter is CrossDomainEnabled, AdapterInterface, CircleCCTPAdapter {\n using SafeERC20 for IERC20;\n uint32 public constant L2_GAS_LIMIT = 200_000;\n\n WETH9Interface public immutable L1_WETH;\n\n IL1StandardBridge public immutable L1_STANDARD_BRIDGE;\n\n /**\n * @notice Constructs new Adapter.\n * @param _l1Weth WETH address on L1.\n * @param _crossDomainMessenger XDomainMessenger Zora system contract.\n * @param _l1StandardBridge Standard bridge contract.\n * @param _l1Usdc USDC address on L1.\n */\n constructor(\n WETH9Interface _l1Weth,\n address _crossDomainMessenger,\n IL1StandardBridge _l1StandardBridge,\n IERC20 _l1Usdc\n )\n CrossDomainEnabled(_crossDomainMessenger)\n CircleCCTPAdapter(\n _l1Usdc,\n // Hardcode cctp messenger to 0x0 to disable CCTP bridging.\n ITokenMessenger(address(0)),\n CircleDomainIds.UNINITIALIZED\n )\n {\n L1_WETH = _l1Weth;\n L1_STANDARD_BRIDGE = _l1StandardBridge;\n }\n\n /**\n * @notice Send cross-chain message to target on Zora.\n * @param target Contract on Zora that will receive message.\n * @param message Data to send to target.\n */\n function relayMessage(address target, bytes calldata message) external payable override {\n sendCrossDomainMessage(target, L2_GAS_LIMIT, message);\n emit MessageRelayed(target, message);\n }\n\n /**\n * @notice Bridge tokens to Zora.\n * @param l1Token L1 token to deposit.\n * @param l2Token L2 token to receive.\n * @param amount Amount of L1 tokens to deposit and L2 tokens to receive.\n * @param to Bridge recipient.\n */\n function relayTokens(\n address l1Token,\n address l2Token,\n uint256 amount,\n address to\n ) external payable override {\n // If the l1Token is weth then unwrap it to ETH then send the ETH to the standard bridge.\n if (l1Token == address(L1_WETH)) {\n L1_WETH.withdraw(amount);\n L1_STANDARD_BRIDGE.depositETHTo{ value: amount }(to, L2_GAS_LIMIT, \"\");\n }\n // Check if this token is USDC, which requires a custom bridge via CCTP.\n else if (_isCCTPEnabled() && l1Token == address(usdcToken)) {\n _transferUsdc(to, amount);\n } else {\n IL1StandardBridge _l1StandardBridge = L1_STANDARD_BRIDGE;\n\n IERC20(l1Token).safeIncreaseAllowance(address(_l1StandardBridge), amount);\n _l1StandardBridge.depositERC20To(l1Token, l2Token, to, amount, L2_GAS_LIMIT, \"\");\n }\n emit TokensRelayed(l1Token, l2Token, amount, to);\n }\n}\n"
+ },
+ "contracts/erc7683/ERC7683.sol": {
+ "content": "// SPDX-License-Identifier: GPL-3.0-or-later\npragma solidity ^0.8.0;\n\n/// @title GaslessCrossChainOrder CrossChainOrder type\n/// @notice Standard order struct to be signed by users, disseminated to fillers, and submitted to origin settler contracts\nstruct GaslessCrossChainOrder {\n /// @dev The contract address that the order is meant to be settled by.\n /// Fillers send this order to this contract address on the origin chain\n address originSettler;\n /// @dev The address of the user who is initiating the swap,\n /// whose input tokens will be taken and escrowed\n address user;\n /// @dev Nonce to be used as replay protection for the order\n uint256 nonce;\n /// @dev The chainId of the origin chain\n uint256 originChainId;\n /// @dev The timestamp by which the order must be opened\n uint32 openDeadline;\n /// @dev The timestamp by which the order must be filled on the destination chain\n uint32 fillDeadline;\n /// @dev Type identifier for the order data. This is an EIP-712 typehash.\n bytes32 orderDataType;\n /// @dev Arbitrary implementation-specific data\n /// Can be used to define tokens, amounts, destination chains, fees, settlement parameters,\n /// or any other order-type specific information\n bytes orderData;\n}\n\n/// @title OnchainCrossChainOrder CrossChainOrder type\n/// @notice Standard order struct for user-opened orders, where the user is the msg.sender.\nstruct OnchainCrossChainOrder {\n /// @dev The timestamp by which the order must be filled on the destination chain\n uint32 fillDeadline;\n /// @dev Type identifier for the order data. This is an EIP-712 typehash.\n bytes32 orderDataType;\n /// @dev Arbitrary implementation-specific data\n /// Can be used to define tokens, amounts, destination chains, fees, settlement parameters,\n /// or any other order-type specific information\n bytes orderData;\n}\n\n/// @title ResolvedCrossChainOrder type\n/// @notice An implementation-generic representation of an order intended for filler consumption\n/// @dev Defines all requirements for filling an order by unbundling the implementation-specific orderData.\n/// @dev Intended to improve integration generalization by allowing fillers to compute the exact input and output information of any order\nstruct ResolvedCrossChainOrder {\n /// @dev The address of the user who is initiating the transfer\n address user;\n /// @dev The chainId of the origin chain\n uint256 originChainId;\n /// @dev The timestamp by which the order must be opened\n uint32 openDeadline;\n /// @dev The timestamp by which the order must be filled on the destination chain(s)\n uint32 fillDeadline;\n /// @dev The unique identifier for this order within this settlement system\n bytes32 orderId;\n /// @dev The max outputs that the filler will send. It's possible the actual amount depends on the state of the destination\n /// chain (destination dutch auction, for instance), so these outputs should be considered a cap on filler liabilities.\n Output[] maxSpent;\n /// @dev The minimum outputs that must to be given to the filler as part of order settlement. Similar to maxSpent, it's possible\n /// that special order types may not be able to guarantee the exact amount at open time, so this should be considered\n /// a floor on filler receipts.\n Output[] minReceived;\n /// @dev Each instruction in this array is parameterizes a single leg of the fill. This provides the filler with the information\n /// necessary to perform the fill on the destination(s).\n FillInstruction[] fillInstructions;\n}\n\n/// @notice Tokens that must be receive for a valid order fulfillment\nstruct Output {\n /// @dev The address of the ERC20 token on the destination chain\n /// @dev address(0) used as a sentinel for the native token\n bytes32 token;\n /// @dev The amount of the token to be sent\n uint256 amount;\n /// @dev The address to receive the output tokens\n bytes32 recipient;\n /// @dev The destination chain for this output\n uint256 chainId;\n}\n\n/// @title FillInstruction type\n/// @notice Instructions to parameterize each leg of the fill\n/// @dev Provides all the origin-generated information required to produce a valid fill leg\nstruct FillInstruction {\n /// @dev The contract address that the order is meant to be settled by\n uint64 destinationChainId;\n /// @dev The contract address that the order is meant to be filled on\n bytes32 destinationSettler;\n /// @dev The data generated on the origin chain needed by the destinationSettler to process the fill\n bytes originData;\n}\n\n/// @title IOriginSettler\n/// @notice Standard interface for settlement contracts on the origin chain\ninterface IOriginSettler {\n /// @notice Signals that an order has been opened\n /// @param orderId a unique order identifier within this settlement system\n /// @param resolvedOrder resolved order that would be returned by resolve if called instead of Open\n event Open(bytes32 indexed orderId, ResolvedCrossChainOrder resolvedOrder);\n\n /// @notice Opens a gasless cross-chain order on behalf of a user.\n /// @dev To be called by the filler.\n /// @dev This method must emit the Open event\n /// @param order The GaslessCrossChainOrder definition\n /// @param signature The user's signature over the order\n /// @param originFillerData Any filler-defined data required by the settler\n function openFor(\n GaslessCrossChainOrder calldata order,\n bytes calldata signature,\n bytes calldata originFillerData\n ) external;\n\n /// @notice Opens a cross-chain order\n /// @dev To be called by the user\n /// @dev This method must emit the Open event\n /// @param order The OnchainCrossChainOrder definition\n function open(OnchainCrossChainOrder calldata order) external;\n\n /// @notice Resolves a specific GaslessCrossChainOrder into a generic ResolvedCrossChainOrder\n /// @dev Intended to improve standardized integration of various order types and settlement contracts\n /// @param order The GaslessCrossChainOrder definition\n /// @param originFillerData Any filler-defined data required by the settler\n /// @return ResolvedCrossChainOrder hydrated order data including the inputs and outputs of the order\n function resolveFor(GaslessCrossChainOrder calldata order, bytes calldata originFillerData)\n external\n view\n returns (ResolvedCrossChainOrder memory);\n\n /// @notice Resolves a specific OnchainCrossChainOrder into a generic ResolvedCrossChainOrder\n /// @dev Intended to improve standardized integration of various order types and settlement contracts\n /// @param order The OnchainCrossChainOrder definition\n /// @return ResolvedCrossChainOrder hydrated order data including the inputs and outputs of the order\n function resolve(OnchainCrossChainOrder calldata order) external view returns (ResolvedCrossChainOrder memory);\n}\n\n/// @title IDestinationSettler\n/// @notice Standard interface for settlement contracts on the destination chain\ninterface IDestinationSettler {\n /// @notice Fills a single leg of a particular order on the destination chain\n /// @param orderId Unique order identifier for this order\n /// @param originData Data emitted on the origin to parameterize the fill\n /// @param fillerData Data provided by the filler to inform the fill or express their preferences\n function fill(\n bytes32 orderId,\n bytes calldata originData,\n bytes calldata fillerData\n ) external;\n}\n"
+ },
+ "contracts/erc7683/ERC7683Permit2Lib.sol": {
+ "content": "// SPDX-License-Identifier: UNLICENSED\npragma solidity ^0.8.0;\n\nimport \"../external/interfaces/IPermit2.sol\";\nimport { GaslessCrossChainOrder } from \"./ERC7683.sol\";\n\n// Data unique to every CrossChainOrder settled on Across\nstruct AcrossOrderData {\n address inputToken;\n uint256 inputAmount;\n address outputToken;\n uint256 outputAmount;\n uint256 destinationChainId;\n bytes32 recipient;\n address exclusiveRelayer;\n /// @notice User needs to be careful not to re-use a deposit nonce when depositing into Across otherwise the\n /// user risks their deposit being unfillable. See @across/contracts/SpokePool.sol#unsafeDeposit() for\n /// more details on this situation.\n uint256 depositNonce;\n uint32 exclusivityPeriod;\n bytes message;\n}\n\nstruct AcrossOriginFillerData {\n address exclusiveRelayer;\n}\n\nstruct AcrossDestinationFillerData {\n uint256 repaymentChainId;\n}\n\nbytes constant ACROSS_ORDER_DATA_TYPE = abi.encodePacked(\n \"AcrossOrderData(\",\n \"address inputToken,\",\n \"uint256 inputAmount,\",\n \"address outputToken,\",\n \"uint256 outputAmount,\",\n \"uint256 destinationChainId,\",\n \"bytes32 recipient,\",\n \"address exclusiveRelayer,\"\n \"uint256 depositNonce,\",\n \"uint32 exclusivityPeriod,\",\n \"bytes message)\"\n);\n\nbytes32 constant ACROSS_ORDER_DATA_TYPE_HASH = keccak256(ACROSS_ORDER_DATA_TYPE);\n\n/**\n * @notice ERC7683Permit2Lib knows how to process a particular type of external Permit2Order so that it can be used in Across.\n * @dev This library is responsible for definining the ERC712 type strings/hashes and performing hashes on the types.\n * @custom:security-contact bugs@across.to\n */\nlibrary ERC7683Permit2Lib {\n bytes internal constant GASLESS_CROSS_CHAIN_ORDER_TYPE =\n abi.encodePacked(\n \"GaslessCrossChainOrder(\",\n \"address originSettler,\",\n \"address user,\",\n \"uint256 nonce,\",\n \"uint256 originChainId,\",\n \"uint32 openDeadline,\",\n \"uint32 fillDeadline,\",\n \"bytes32 orderDataType,\",\n \"AcrossOrderData orderData)\"\n );\n\n bytes internal constant GASLESS_CROSS_CHAIN_ORDER_EIP712_TYPE =\n abi.encodePacked(GASLESS_CROSS_CHAIN_ORDER_TYPE, ACROSS_ORDER_DATA_TYPE);\n bytes32 internal constant GASLESS_CROSS_CHAIN_ORDER_TYPE_HASH = keccak256(GASLESS_CROSS_CHAIN_ORDER_EIP712_TYPE);\n\n string private constant TOKEN_PERMISSIONS_TYPE = \"TokenPermissions(address token,uint256 amount)\";\n string internal constant PERMIT2_ORDER_TYPE =\n string(\n abi.encodePacked(\n \"GaslessCrossChainOrder witness)\",\n ACROSS_ORDER_DATA_TYPE,\n GASLESS_CROSS_CHAIN_ORDER_TYPE,\n TOKEN_PERMISSIONS_TYPE\n )\n );\n\n // Hashes an order to get an order hash. Needed for permit2.\n function hashOrder(GaslessCrossChainOrder memory order, bytes32 orderDataHash) internal pure returns (bytes32) {\n return\n keccak256(\n abi.encode(\n GASLESS_CROSS_CHAIN_ORDER_TYPE_HASH,\n order.originSettler,\n order.user,\n order.nonce,\n order.originChainId,\n order.openDeadline,\n order.fillDeadline,\n order.orderDataType,\n orderDataHash\n )\n );\n }\n\n function hashOrderData(AcrossOrderData memory orderData) internal pure returns (bytes32) {\n return\n keccak256(\n abi.encode(\n ACROSS_ORDER_DATA_TYPE_HASH,\n orderData.inputToken,\n orderData.inputAmount,\n orderData.outputToken,\n orderData.outputAmount,\n orderData.destinationChainId,\n orderData.recipient,\n orderData.exclusiveRelayer,\n orderData.depositNonce,\n orderData.exclusivityPeriod,\n keccak256(orderData.message)\n )\n );\n }\n}\n"
+ },
+ "contracts/external/interfaces/CCTPInterfaces.sol": {
+ "content": "/**\n * Copyright (C) 2015, 2016, 2017 Dapphub\n *\n * This program is free software: you can redistribute it and/or modify\n * it under the terms of the GNU General Public License as published by\n * the Free Software Foundation, either version 3 of the License, or\n * (at your option) any later version.\n *\n * This program is distributed in the hope that it will be useful,\n * but WITHOUT ANY WARRANTY; without even the implied warranty of\n * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the\n * GNU General Public License for more details.\n *\n * You should have received a copy of the GNU General Public License\n * along with this program. If not, see .\n */\n\n// SPDX-License-Identifier: GPL-3.0-or-later\npragma solidity ^0.8.0;\n\n/**\n * Imported as-is from commit 139d8d0ce3b5531d3c7ec284f89d946dfb720016 of:\n * * https://github.com/walkerq/evm-cctp-contracts/blob/139d8d0ce3b5531d3c7ec284f89d946dfb720016/src/TokenMessenger.sol\n * Changes applied post-import:\n * * Removed a majority of code from this contract and converted the needed function signatures in this interface.\n */\ninterface ITokenMessenger {\n /**\n * @notice Deposits and burns tokens from sender to be minted on destination domain.\n * Emits a `DepositForBurn` event.\n * @dev reverts if:\n * - given burnToken is not supported\n * - given destinationDomain has no TokenMessenger registered\n * - transferFrom() reverts. For example, if sender's burnToken balance or approved allowance\n * to this contract is less than `amount`.\n * - burn() reverts. For example, if `amount` is 0.\n * - MessageTransmitter returns false or reverts.\n * @param amount amount of tokens to burn\n * @param destinationDomain destination domain\n * @param mintRecipient address of mint recipient on destination domain\n * @param burnToken address of contract to burn deposited tokens, on local domain\n * @return _nonce unique nonce reserved by message\n */\n function depositForBurn(\n uint256 amount,\n uint32 destinationDomain,\n bytes32 mintRecipient,\n address burnToken\n ) external returns (uint64 _nonce);\n\n /**\n * @notice Minter responsible for minting and burning tokens on the local domain\n * @dev A TokenMessenger stores a TokenMinter contract which extends the TokenController contract.\n * https://github.com/circlefin/evm-cctp-contracts/blob/817397db0a12963accc08ff86065491577bbc0e5/src/TokenMessenger.sol#L110\n * @return minter Token Minter contract.\n */\n function localMinter() external view returns (ITokenMinter minter);\n}\n\n// Source: https://github.com/circlefin/evm-cctp-contracts/blob/63ab1f0ac06ce0793c0bbfbb8d09816bc211386d/src/v2/TokenMessengerV2.sol#L138C1-L166C15\ninterface ITokenMessengerV2 {\n /**\n * @notice Deposits and burns tokens from sender to be minted on destination domain.\n * Emits a `DepositForBurn` event.\n * @dev reverts if:\n * - given burnToken is not supported\n * - given destinationDomain has no TokenMessenger registered\n * - transferFrom() reverts. For example, if sender's burnToken balance or approved allowance\n * to this contract is less than `amount`.\n * - burn() reverts. For example, if `amount` is 0.\n * - maxFee is greater than or equal to `amount`.\n * - MessageTransmitterV2#sendMessage reverts.\n * @param amount amount of tokens to burn\n * @param destinationDomain destination domain to receive message on\n * @param mintRecipient address of mint recipient on destination domain\n * @param burnToken token to burn `amount` of, on local domain\n * @param destinationCaller authorized caller on the destination domain, as bytes32. If equal to bytes32(0),\n * any address can broadcast the message.\n * @param maxFee maximum fee to pay on the destination domain, specified in units of burnToken\n * @param minFinalityThreshold the minimum finality at which a burn message will be attested to.\n */\n function depositForBurn(\n uint256 amount,\n uint32 destinationDomain,\n bytes32 mintRecipient,\n address burnToken,\n bytes32 destinationCaller,\n uint256 maxFee,\n uint32 minFinalityThreshold\n ) external;\n}\n\n/**\n * A TokenMessenger stores a TokenMinter contract which extends the TokenController contract. The TokenController\n * contract has a burnLimitsPerMessage public mapping which can be queried to find the per-message burn limit\n * for a given token:\n * https://github.com/circlefin/evm-cctp-contracts/blob/817397db0a12963accc08ff86065491577bbc0e5/src/TokenMinter.sol#L33\n * https://github.com/circlefin/evm-cctp-contracts/blob/817397db0a12963accc08ff86065491577bbc0e5/src/roles/TokenController.sol#L69C40-L69C60\n *\n */\ninterface ITokenMinter {\n /**\n * @notice Supported burnable tokens on the local domain\n * local token (address) => maximum burn amounts per message\n * @param token address of token contract\n * @return burnLimit maximum burn amount per message for token\n */\n function burnLimitsPerMessage(address token) external view returns (uint256);\n}\n\n/**\n * IMessageTransmitter in CCTP inherits IRelayer and IReceiver, but here we only import sendMessage from IRelayer:\n * https://github.com/circlefin/evm-cctp-contracts/blob/377c9bd813fb86a42d900ae4003599d82aef635a/src/interfaces/IMessageTransmitter.sol#L25\n * https://github.com/circlefin/evm-cctp-contracts/blob/377c9bd813fb86a42d900ae4003599d82aef635a/src/interfaces/IRelayer.sol#L23-L35\n */\ninterface IMessageTransmitter {\n /**\n * @notice Sends an outgoing message from the source domain.\n * @dev Increment nonce, format the message, and emit `MessageSent` event with message information.\n * @param destinationDomain Domain of destination chain\n * @param recipient Address of message recipient on destination domain as bytes32\n * @param messageBody Raw bytes content of message\n * @return nonce reserved by message\n */\n function sendMessage(\n uint32 destinationDomain,\n bytes32 recipient,\n bytes calldata messageBody\n ) external returns (uint64);\n}\n"
+ },
+ "contracts/external/interfaces/IOpUSDCBridgeAdapter.sol": {
+ "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\n/**\n * Imported from https://github.com/defi-wonderland/opUSDC\n * https://github.com/defi-wonderland/opUSDC/blob/ef22e5731f1655bf5249b2160452cce9aa06ff3f/src/interfaces/IOpUSDCBridgeAdapter.sol#L198C1-L204C84\n */\ninterface IOpUSDCBridgeAdapter {\n /**\n * @notice Send tokens to another chain through the linked adapter\n * @param _to The target address on the destination chain\n * @param _amount The amount of tokens to send\n * @param _minGasLimit Minimum gas limit that the message can be executed with\n */\n function sendMessage(\n address _to,\n uint256 _amount,\n uint32 _minGasLimit\n ) external;\n}\n"
+ },
+ "contracts/external/interfaces/IPermit2.sol": {
+ "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\ninterface IPermit2 {\n struct TokenPermissions {\n address token;\n uint256 amount;\n }\n\n struct PermitTransferFrom {\n TokenPermissions permitted;\n uint256 nonce;\n uint256 deadline;\n }\n\n struct SignatureTransferDetails {\n address to;\n uint256 requestedAmount;\n }\n\n function permitWitnessTransferFrom(\n PermitTransferFrom memory permit,\n SignatureTransferDetails calldata transferDetails,\n address owner,\n bytes32 witness,\n string calldata witnessTypeString,\n bytes calldata signature\n ) external;\n\n function transferFrom(\n address from,\n address to,\n uint160 amount,\n address token\n ) external;\n}\n"
+ },
+ "contracts/external/interfaces/LineaInterfaces.sol": {
+ "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\n\n/**\n * @notice Interface of Linea's Canonical Message Service\n * See https://github.com/Consensys/linea-contracts/blob/3cf85529fd4539eb06ba998030c37e47f98c528a/contracts/interfaces/IMessageService.sol\n */\ninterface IMessageService {\n /**\n * @notice Sends a message for transporting from the given chain.\n * @dev This function should be called with a msg.value = _value + _fee. The fee will be paid on the destination chain.\n * @param _to The destination address on the destination chain.\n * @param _fee The message service fee on the origin chain.\n * @param _calldata The calldata used by the destination message service to call the destination contract.\n */\n function sendMessage(\n address _to,\n uint256 _fee,\n bytes calldata _calldata\n ) external payable;\n\n /**\n * @notice Returns the original sender of the message on the origin layer.\n */\n function sender() external view returns (address);\n\n /**\n * @notice Minimum fee to use when sending a message. Currently, only exists on L2MessageService.\n * See https://github.com/Consensys/linea-contracts/blob/3cf85529fd4539eb06ba998030c37e47f98c528a/contracts/messageService/l2/L2MessageService.sol#L37\n */\n function minimumFeeInWei() external view returns (uint256);\n}\n\n/**\n * @notice Interface of Linea's Canonical Token Bridge\n * See https://github.com/Consensys/linea-contracts/blob/3cf85529fd4539eb06ba998030c37e47f98c528a/contracts/tokenBridge/interfaces/ITokenBridge.sol\n */\ninterface ITokenBridge {\n /**\n * @notice This function is the single entry point to bridge tokens to the\n * other chain, both for native and already bridged tokens. You can use it\n * to bridge any ERC20. If the token is bridged for the first time an ERC20\n * (BridgedToken.sol) will be automatically deployed on the target chain.\n * @dev User should first allow the bridge to transfer tokens on his behalf.\n * Alternatively, you can use `bridgeTokenWithPermit` to do so in a single\n * transaction. If you want the transfer to be automatically executed on the\n * destination chain. You should send enough ETH to pay the postman fees.\n * Note that Linea can reserve some tokens (which use a dedicated bridge).\n * In this case, the token cannot be bridged. Linea can only reserve tokens\n * that have not been bridged yet.\n * Linea can pause the bridge for security reason. In this case new bridge\n * transaction would revert.\n * @param _token The address of the token to be bridged.\n * @param _amount The amount of the token to be bridged.\n * @param _recipient The address that will receive the tokens on the other chain.\n */\n function bridgeToken(\n address _token,\n uint256 _amount,\n address _recipient\n ) external payable;\n}\n\ninterface IUSDCBridge {\n function usdc() external view returns (address);\n\n /**\n * @dev Sends the sender's USDC from L1 to the recipient on L2, locks the USDC sent\n * in this contract and sends a message to the message bridge\n * contract to mint the equivalent USDC on L2\n * @param amount The amount of USDC to send\n * @param to The recipient's address to receive the funds\n */\n function depositTo(uint256 amount, address to) external payable;\n}\n"
+ },
+ "contracts/external/interfaces/WETH9Interface.sol": {
+ "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\n\n/**\n * @notice Interface for the WETH9 contract.\n */\ninterface WETH9Interface {\n /**\n * @notice Burn Wrapped Ether and receive native Ether.\n * @param wad Amount of WETH to unwrap and send to caller.\n */\n function withdraw(uint256 wad) external;\n\n /**\n * @notice Lock native Ether and mint Wrapped Ether ERC20\n * @dev msg.value is amount of Wrapped Ether to mint/Ether to lock.\n */\n function deposit() external payable;\n\n /**\n * @notice Get balance of WETH held by `guy`.\n * @param guy Address to get balance of.\n * @return wad Amount of WETH held by `guy`.\n */\n function balanceOf(address guy) external view returns (uint256 wad);\n\n /**\n * @notice Transfer `wad` of WETH from caller to `guy`.\n * @param guy Address to send WETH to.\n * @param wad Amount of WETH to send.\n * @return ok True if transfer succeeded.\n */\n function transfer(address guy, uint256 wad) external returns (bool);\n}\n"
+ },
+ "contracts/interfaces/ArbitrumBridge.sol": {
+ "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\n\n/**\n * @title Staging ground for incoming and outgoing messages\n * @notice Unlike the standard Eth bridge, native token bridge escrows the custom ERC20 token which is\n * used as native currency on upper layer.\n * @dev Fees are paid in this token. There are certain restrictions on the native token:\n * - The token can't be rebasing or have a transfer fee\n * - The token must only be transferrable via a call to the token address itself\n * - The token must only be able to set allowance via a call to the token address itself\n * - The token must not have a callback on transfer, and more generally a user must not be able to make a transfer to themselves revert\n * - The token must have a max of 2^256 - 1 wei total supply unscaled\n * - The token must have a max of 2^256 - 1 wei total supply when scaled to 18 decimals\n */\ninterface ArbitrumERC20Bridge {\n /**\n * @notice Returns token that is escrowed in bridge on the lower layer and minted on the upper layer as native currency.\n * @dev This function doesn't exist on the generic Bridge interface.\n * @return address of the native token.\n */\n function nativeToken() external view returns (address);\n\n /**\n * @dev number of decimals used by the native token\n * This is set on bridge initialization using nativeToken.decimals()\n * If the token does not have decimals() method, we assume it have 0 decimals\n */\n function nativeTokenDecimals() external view returns (uint8);\n}\n\n/**\n * @title Inbox for user and contract originated messages\n * @notice Messages created via this inbox are enqueued in the delayed accumulator\n * to await inclusion in the SequencerInbox\n */\ninterface ArbitrumInboxLike {\n /**\n * @dev we only use this function to check the native token used by the bridge, so we hardcode the interface\n * to return an ArbitrumERC20Bridge instead of a more generic Bridge interface.\n * @return address of the bridge.\n */\n function bridge() external view returns (ArbitrumERC20Bridge);\n\n /**\n * @notice Put a message in the inbox that can be reexecuted for some fixed amount of time if it reverts\n * @dev Gas limit and maxFeePerGas should not be set to 1 as that is used to trigger the RetryableData error\n * @dev Caller must set msg.value equal to at least `maxSubmissionCost + maxGas * gasPriceBid`.\n * all msg.value will deposited to callValueRefundAddress on the upper layer\n * @dev More details can be found here: https://developer.arbitrum.io/arbos/l1-to-l2-messaging\n * @param to destination contract address\n * @param callValue call value for retryable message\n * @param maxSubmissionCost Max gas deducted from user's (upper layer) balance to cover base submission fee\n * @param excessFeeRefundAddress gasLimit x maxFeePerGas - execution cost gets credited here on (upper layer) balance\n * @param callValueRefundAddress callvalue gets credited here on upper layer if retryable txn times out or gets cancelled\n * @param gasLimit Max gas deducted from user's upper layer balance to cover upper layer execution. Should not be set to 1 (magic value used to trigger the RetryableData error)\n * @param maxFeePerGas price bid for upper layer execution. Should not be set to 1 (magic value used to trigger the RetryableData error)\n * @param data ABI encoded data of message\n * @return unique message number of the retryable transaction\n */\n function createRetryableTicket(\n address to,\n uint256 callValue,\n uint256 maxSubmissionCost,\n address excessFeeRefundAddress,\n address callValueRefundAddress,\n uint256 gasLimit,\n uint256 maxFeePerGas,\n bytes calldata data\n ) external payable returns (uint256);\n\n /**\n * @notice Put a message in the source chain inbox that can be reexecuted for some fixed amount of time if it reverts\n * @dev Same as createRetryableTicket, but does not guarantee that submission will succeed by requiring the needed\n * funds come from the deposit alone, rather than falling back on the user's balance\n * @dev Advanced usage only (does not rewrite aliases for excessFeeRefundAddress and callValueRefundAddress).\n * createRetryableTicket method is the recommended standard.\n * @dev Gas limit and maxFeePerGas should not be set to 1 as that is used to trigger the RetryableData error\n * @param to destination contract address\n * @param callValue call value for retryable message\n * @param maxSubmissionCost Max gas deducted from user's source chain balance to cover base submission fee\n * @param excessFeeRefundAddress gasLimit x maxFeePerGas - execution cost gets credited here on source chain balance\n * @param callValueRefundAddress callvalue gets credited here on source chain if retryable txn times out or gets cancelled\n * @param gasLimit Max gas deducted from user's balance to cover execution. Should not be set to 1 (magic value used to trigger the RetryableData error)\n * @param maxFeePerGas price bid for execution. Should not be set to 1 (magic value used to trigger the RetryableData error)\n * @param data ABI encoded data of the message\n * @return unique message number of the retryable transaction\n */\n function unsafeCreateRetryableTicket(\n address to,\n uint256 callValue,\n uint256 maxSubmissionCost,\n address excessFeeRefundAddress,\n address callValueRefundAddress,\n uint256 gasLimit,\n uint256 maxFeePerGas,\n bytes calldata data\n ) external payable returns (uint256);\n}\n\n/**\n * @notice Interface which extends ArbitrumInboxLike with functions used to interact with bridges that use a custom gas token.\n */\ninterface ArbitrumCustomGasTokenInbox is ArbitrumInboxLike {\n /**\n * @notice Put a message in the inbox that can be reexecuted for some fixed amount of time if it reverts\n * @notice Overloads the `createRetryableTicket` function but is not payable, and should only be called when paying\n * for message using a custom gas token.\n * @dev all tokenTotalFeeAmount will be deposited to callValueRefundAddress on upper layer\n * @dev Gas limit and maxFeePerGas should not be set to 1 as that is used to trigger the RetryableData error\n * @dev In case of native token having non-18 decimals: tokenTotalFeeAmount is denominated in native token's decimals. All other value params - callValue, maxSubmissionCost and maxFeePerGas are denominated in child chain's native 18 decimals.\n * @param to destination contract address\n * @param callValue call value for retryable message\n * @param maxSubmissionCost Max gas deducted from user's upper layer balance to cover base submission fee\n * @param excessFeeRefundAddress the address which receives the difference between execution fee paid and the actual execution cost. In case this address is a contract, funds will be received in its alias on upper layer.\n * @param callValueRefundAddress callvalue gets credited here on upper layer if retryable txn times out or gets cancelled. In case this address is a contract, funds will be received in its alias on upper layer.\n * @param gasLimit Max gas deducted from user's balance to cover execution. Should not be set to 1 (magic value used to trigger the RetryableData error)\n * @param maxFeePerGas price bid for execution. Should not be set to 1 (magic value used to trigger the RetryableData error)\n * @param tokenTotalFeeAmount amount of fees to be deposited in native token to cover for retryable ticket cost\n * @param data ABI encoded data of message\n * @return unique message number of the retryable transaction\n */\n function createRetryableTicket(\n address to,\n uint256 callValue,\n uint256 maxSubmissionCost,\n address excessFeeRefundAddress,\n address callValueRefundAddress,\n uint256 gasLimit,\n uint256 maxFeePerGas,\n uint256 tokenTotalFeeAmount,\n bytes calldata data\n ) external returns (uint256);\n}\n\n/**\n * @notice Generic gateway contract for bridging standard ERC20s to/from Arbitrum-like networks.\n * @notice These function signatures are shared between the L1 and L2 gateway router contracts.\n */\ninterface ArbitrumL1ERC20GatewayLike {\n /**\n * @notice Deprecated in favor of outboundTransferCustomRefund but still used in custom bridges\n * like the DAI bridge.\n * @dev Refunded to aliased address of sender if sender has code on source chain, otherwise to to sender's EOA on destination chain.\n * @param _sourceToken address of ERC20\n * @param _to Account to be credited with the tokens at the destination (can be the user's account or a contract),\n * not subject to aliasing. This account, or its alias if it has code in the source chain, will also be able to\n * cancel the retryable ticket and receive callvalue refund\n * @param _amount Token Amount\n * @param _maxGas Max gas deducted from user's balance to cover execution\n * @param _gasPriceBid Gas price for execution\n * @param _data encoded data from router and user\n * @return res abi encoded inbox sequence number\n */\n function outboundTransfer(\n address _sourceToken,\n address _to,\n uint256 _amount,\n uint256 _maxGas,\n uint256 _gasPriceBid,\n bytes calldata _data\n ) external payable returns (bytes memory);\n\n /**\n * @notice get ERC20 gateway for token.\n * @param _token ERC20 address.\n * @return address of ERC20 gateway.\n */\n function getGateway(address _token) external view returns (address);\n\n /**\n * @notice Deposit ERC20 token from Ethereum into Arbitrum-like networks.\n * @dev Upper layer address alias will not be applied to the following types of addresses on lower layer:\n * - an externally-owned account\n * - a contract in construction\n * - an address where a contract will be created\n * - an address where a contract lived, but was destroyed\n * @param _sourceToken address of ERC20 on source chain.\n * @param _refundTo Account, or its alias if it has code on the source chain, to be credited with excess gas refund at destination\n * @param _to Account to be credited with the tokens in the L3 (can be the user's L3 account or a contract),\n * not subject to aliasing. This account, or its alias if it has code on the source chain, will also be able to\n * cancel the retryable ticket and receive callvalue refund\n * @param _amount Token Amount\n * @param _maxGas Max gas deducted from user's balance to cover execution\n * @param _gasPriceBid Gas price for execution\n * @param _data encoded data from router and user\n * @return res abi encoded inbox sequence number\n */\n function outboundTransferCustomRefund(\n address _sourceToken,\n address _refundTo,\n address _to,\n uint256 _amount,\n uint256 _maxGas,\n uint256 _gasPriceBid,\n bytes calldata _data\n ) external payable returns (bytes memory);\n}\n\ninterface ArbitrumL2ERC20GatewayLike {\n /**\n * @notice Fetches the l2 token address from the gateway router for the input l1 token address\n * @param _l1Erc20 address of the l1 token.\n */\n function calculateL2TokenAddress(address _l1Erc20) external view returns (address);\n\n /**\n * @notice Withdraws a specified amount of an l2 token to an l1 token.\n * @param _l1Token address of the token to withdraw on L1.\n * @param _to address on L1 which will receive the tokens upon withdrawal.\n * @param _amount amount of the token to withdraw.\n * @param _data encoded data to send to the gateway router.\n */\n function outboundTransfer(\n address _l1Token,\n address _to,\n uint256 _amount,\n bytes calldata _data\n ) external payable returns (bytes memory);\n}\n"
+ },
+ "contracts/interfaces/HubPoolInterface.sol": {
+ "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport \"@openzeppelin/contracts/token/ERC20/IERC20.sol\";\n\n/**\n * @notice Concise list of functions in HubPool implementation.\n */\ninterface HubPoolInterface {\n // This leaf is meant to be decoded in the HubPool to rebalance tokens between HubPool and SpokePool.\n struct PoolRebalanceLeaf {\n // This is used to know which chain to send cross-chain transactions to (and which SpokePool to send to).\n uint256 chainId;\n // Total LP fee amount per token in this bundle, encompassing all associated bundled relays.\n uint256[] bundleLpFees;\n // Represents the amount to push to or pull from the SpokePool. If +, the pool pays the SpokePool. If negative\n // the SpokePool pays the HubPool. There can be arbitrarily complex rebalancing rules defined offchain. This\n // number is only nonzero when the rules indicate that a rebalancing action should occur. When a rebalance does\n // occur, runningBalances must be set to zero for this token and netSendAmounts should be set to the previous\n // runningBalances + relays - deposits in this bundle. If non-zero then it must be set on the SpokePool's\n // RelayerRefundLeaf amountToReturn as -1 * this value to show if funds are being sent from or to the SpokePool.\n int256[] netSendAmounts;\n // This is only here to be emitted in an event to track a running unpaid balance between the L2 pool and the L1\n // pool. A positive number indicates that the HubPool owes the SpokePool funds. A negative number indicates that\n // the SpokePool owes the HubPool funds. See the comment above for the dynamics of this and netSendAmounts.\n int256[] runningBalances;\n // Used by data worker to mark which leaves should relay roots to SpokePools, and to otherwise organize leaves.\n // For example, each leaf should contain all the rebalance information for a single chain, but in the case where\n // the list of l1Tokens is very large such that they all can't fit into a single leaf that can be executed under\n // the block gas limit, then the data worker can use this groupIndex to organize them. Any leaves with\n // a groupIndex equal to 0 will relay roots to the SpokePool, so the data worker should ensure that only one\n // leaf for a specific chainId should have a groupIndex equal to 0.\n uint256 groupIndex;\n // Used as the index in the bitmap to track whether this leaf has been executed or not.\n uint8 leafId;\n // The bundleLpFees, netSendAmounts, and runningBalances are required to be the same length. They are parallel\n // arrays for the given chainId and should be ordered by the l1Tokens field. All whitelisted tokens with nonzero\n // relays on this chain in this bundle in the order of whitelisting.\n address[] l1Tokens;\n }\n\n // A data worker can optimistically store several merkle roots on this contract by staking a bond and calling\n // proposeRootBundle. By staking a bond, the data worker is alleging that the merkle roots all contain valid leaves\n // that can be executed later to:\n // - Send funds from this contract to a SpokePool or vice versa\n // - Send funds from a SpokePool to Relayer as a refund for a relayed deposit\n // - Send funds from a SpokePool to a deposit recipient to fulfill a \"slow\" relay\n // Anyone can dispute this struct if the merkle roots contain invalid leaves before the\n // challengePeriodEndTimestamp. Once the expiration timestamp is passed, executeRootBundle to execute a leaf\n // from the poolRebalanceRoot on this contract and it will simultaneously publish the relayerRefundRoot and\n // slowRelayRoot to a SpokePool. The latter two roots, once published to the SpokePool, contain\n // leaves that can be executed on the SpokePool to pay relayers or recipients.\n struct RootBundle {\n // Contains leaves instructing this contract to send funds to SpokePools.\n bytes32 poolRebalanceRoot;\n // Relayer refund merkle root to be published to a SpokePool.\n bytes32 relayerRefundRoot;\n // Slow relay merkle root to be published to a SpokePool.\n bytes32 slowRelayRoot;\n // This is a 1D bitmap, with max size of 256 elements, limiting us to 256 chainsIds.\n uint256 claimedBitMap;\n // Proposer of this root bundle.\n address proposer;\n // Number of pool rebalance leaves to execute in the poolRebalanceRoot. After this number\n // of leaves are executed, a new root bundle can be proposed\n uint8 unclaimedPoolRebalanceLeafCount;\n // When root bundle challenge period passes and this root bundle becomes executable.\n uint32 challengePeriodEndTimestamp;\n }\n\n // Each whitelisted L1 token has an associated pooledToken struct that contains all information used to track the\n // cumulative LP positions and if this token is enabled for deposits.\n struct PooledToken {\n // LP token given to LPs of a specific L1 token.\n address lpToken;\n // True if accepting new LP's.\n bool isEnabled;\n // Timestamp of last LP fee update.\n uint32 lastLpFeeUpdate;\n // Number of LP funds sent via pool rebalances to SpokePools and are expected to be sent\n // back later.\n int256 utilizedReserves;\n // Number of LP funds held in contract less utilized reserves.\n uint256 liquidReserves;\n // Number of LP funds reserved to pay out to LPs as fees.\n uint256 undistributedLpFees;\n }\n\n // Helper contracts to facilitate cross chain actions between HubPool and SpokePool for a specific network.\n struct CrossChainContract {\n address adapter;\n address spokePool;\n }\n\n function setPaused(bool pause) external;\n\n function emergencyDeleteProposal() external;\n\n function relaySpokePoolAdminFunction(uint256 chainId, bytes memory functionData) external;\n\n function setProtocolFeeCapture(address newProtocolFeeCaptureAddress, uint256 newProtocolFeeCapturePct) external;\n\n function setBond(IERC20 newBondToken, uint256 newBondAmount) external;\n\n function setLiveness(uint32 newLiveness) external;\n\n function setIdentifier(bytes32 newIdentifier) external;\n\n function setCrossChainContracts(\n uint256 l2ChainId,\n address adapter,\n address spokePool\n ) external;\n\n function enableL1TokenForLiquidityProvision(address l1Token) external;\n\n function disableL1TokenForLiquidityProvision(address l1Token) external;\n\n function addLiquidity(address l1Token, uint256 l1TokenAmount) external payable;\n\n function removeLiquidity(\n address l1Token,\n uint256 lpTokenAmount,\n bool sendEth\n ) external;\n\n function exchangeRateCurrent(address l1Token) external returns (uint256);\n\n function liquidityUtilizationCurrent(address l1Token) external returns (uint256);\n\n function liquidityUtilizationPostRelay(address l1Token, uint256 relayedAmount) external returns (uint256);\n\n function sync(address l1Token) external;\n\n function proposeRootBundle(\n uint256[] memory bundleEvaluationBlockNumbers,\n uint8 poolRebalanceLeafCount,\n bytes32 poolRebalanceRoot,\n bytes32 relayerRefundRoot,\n bytes32 slowRelayRoot\n ) external;\n\n function executeRootBundle(\n uint256 chainId,\n uint256 groupIndex,\n uint256[] memory bundleLpFees,\n int256[] memory netSendAmounts,\n int256[] memory runningBalances,\n uint8 leafId,\n address[] memory l1Tokens,\n bytes32[] memory proof\n ) external;\n\n function disputeRootBundle() external;\n\n function claimProtocolFeesCaptured(address l1Token) external;\n\n function setPoolRebalanceRoute(\n uint256 destinationChainId,\n address l1Token,\n address destinationToken\n ) external;\n\n function setDepositRoute(\n uint256 originChainId,\n uint256 destinationChainId,\n address originToken,\n bool depositsEnabled\n ) external;\n\n function poolRebalanceRoute(uint256 destinationChainId, address l1Token)\n external\n view\n returns (address destinationToken);\n\n function loadEthForL2Calls() external payable;\n}\n"
+ },
+ "contracts/interfaces/SpokePoolInterface.sol": {
+ "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\n/**\n * @notice Contains common data structures and functions used by all SpokePool implementations.\n */\ninterface SpokePoolInterface {\n // This leaf is meant to be decoded in the SpokePool to pay out successful relayers.\n struct RelayerRefundLeaf {\n // This is the amount to return to the HubPool. This occurs when there is a PoolRebalanceLeaf netSendAmount that\n // is negative. This is just the negative of this value.\n uint256 amountToReturn;\n // Used to verify that this is being executed on the correct destination chainId.\n uint256 chainId;\n // This array designates how much each of those addresses should be refunded.\n uint256[] refundAmounts;\n // Used as the index in the bitmap to track whether this leaf has been executed or not.\n uint32 leafId;\n // The associated L2TokenAddress that these claims apply to.\n address l2TokenAddress;\n // Must be same length as refundAmounts and designates each address that must be refunded.\n address[] refundAddresses;\n }\n\n // Stores collection of merkle roots that can be published to this contract from the HubPool, which are referenced\n // by \"data workers\" via inclusion proofs to execute leaves in the roots.\n struct RootBundle {\n // Merkle root of slow relays that were not fully filled and whose recipient is still owed funds from the LP pool.\n bytes32 slowRelayRoot;\n // Merkle root of relayer refunds for successful relays.\n bytes32 relayerRefundRoot;\n // This is a 2D bitmap tracking which leaves in the relayer refund root have been claimed, with max size of\n // 256x(2^248) leaves per root.\n mapping(uint256 => uint256) claimedBitmap;\n }\n\n function setCrossDomainAdmin(address newCrossDomainAdmin) external;\n\n function setWithdrawalRecipient(address newWithdrawalRecipient) external;\n\n function pauseDeposits(bool pause) external;\n\n function pauseFills(bool pause) external;\n\n function relayRootBundle(bytes32 relayerRefundRoot, bytes32 slowRelayRoot) external;\n\n function emergencyDeleteRootBundle(uint256 rootBundleId) external;\n\n function depositDeprecated_5947912356(\n address recipient,\n address originToken,\n uint256 amount,\n uint256 destinationChainId,\n int64 relayerFeePct,\n uint32 quoteTimestamp,\n bytes memory message,\n uint256 maxCount\n ) external payable;\n\n function depositFor(\n address depositor,\n address recipient,\n address originToken,\n uint256 amount,\n uint256 destinationChainId,\n int64 relayerFeePct,\n uint32 quoteTimestamp,\n bytes memory message,\n uint256 maxCount\n ) external payable;\n\n function executeRelayerRefundLeaf(\n uint32 rootBundleId,\n SpokePoolInterface.RelayerRefundLeaf memory relayerRefundLeaf,\n bytes32[] memory proof\n ) external payable;\n\n function chainId() external view returns (uint256);\n\n error NotEOA();\n error InvalidDepositorSignature();\n error InvalidRelayerFeePct();\n error MaxTransferSizeExceeded();\n error InvalidCrossDomainAdmin();\n error InvalidWithdrawalRecipient();\n error DepositsArePaused();\n error FillsArePaused();\n}\n"
+ },
+ "contracts/interfaces/SpokePoolMessageHandler.sol": {
+ "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\n// This interface is expected to be implemented by any contract that expects to receive messages from the SpokePool.\ninterface AcrossMessageHandler {\n function handleV3AcrossMessage(\n address tokenSent,\n uint256 amount,\n address relayer,\n bytes memory message\n ) external;\n}\n"
+ },
+ "contracts/interfaces/V3SpokePoolInterface.sol": {
+ "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\n// Contains structs and functions used by SpokePool contracts to facilitate universal settlement.\ninterface V3SpokePoolInterface {\n /**************************************\n * ENUMS *\n **************************************/\n\n // Fill status tracks on-chain state of deposit, uniquely identified by relayHash.\n enum FillStatus {\n Unfilled,\n RequestedSlowFill,\n Filled\n }\n // Fill type is emitted in the FilledRelay event to assist Dataworker with determining which types of\n // fills to refund (e.g. only fast fills) and whether a fast fill created a sow fill excess.\n enum FillType {\n FastFill,\n // Fast fills are normal fills that do not replace a slow fill request.\n ReplacedSlowFill,\n // Replaced slow fills are fast fills that replace a slow fill request. This type is used by the Dataworker\n // to know when to send excess funds from the SpokePool to the HubPool because they can no longer be used\n // for a slow fill execution.\n SlowFill\n }\n // Slow fills are requested via requestSlowFill and executed by executeSlowRelayLeaf after a bundle containing\n // the slow fill is validated.\n\n /**************************************\n * STRUCTS *\n **************************************/\n\n // This struct represents the data to fully specify a **unique** relay submitted on this chain.\n // This data is hashed with the chainId() and saved by the SpokePool to prevent collisions and protect against\n // replay attacks on other chains. If any portion of this data differs, the relay is considered to be\n // completely distinct.\n struct V3RelayData {\n // The bytes32 that made the deposit on the origin chain.\n bytes32 depositor;\n // The recipient bytes32 on the destination chain.\n bytes32 recipient;\n // This is the exclusive relayer who can fill the deposit before the exclusivity deadline.\n bytes32 exclusiveRelayer;\n // Token that is deposited on origin chain by depositor.\n bytes32 inputToken;\n // Token that is received on destination chain by recipient.\n bytes32 outputToken;\n // The amount of input token deposited by depositor.\n uint256 inputAmount;\n // The amount of output token to be received by recipient.\n uint256 outputAmount;\n // Origin chain id.\n uint256 originChainId;\n // The id uniquely identifying this deposit on the origin chain.\n uint256 depositId;\n // The timestamp on the destination chain after which this deposit can no longer be filled.\n uint32 fillDeadline;\n // The timestamp on the destination chain after which any relayer can fill the deposit.\n uint32 exclusivityDeadline;\n // Data that is forwarded to the recipient.\n bytes message;\n }\n\n // Same as V3RelayData but using addresses instead of bytes32 & depositId is uint32.\n // Will be deprecated in favor of V3RelayData in the future.\n struct V3RelayDataLegacy {\n address depositor;\n address recipient;\n address exclusiveRelayer;\n address inputToken;\n address outputToken;\n uint256 inputAmount;\n uint256 outputAmount;\n uint256 originChainId;\n uint32 depositId;\n uint32 fillDeadline;\n uint32 exclusivityDeadline;\n bytes message;\n }\n\n // Contains parameters passed in by someone who wants to execute a slow relay leaf.\n struct V3SlowFill {\n V3RelayData relayData;\n uint256 chainId;\n uint256 updatedOutputAmount;\n }\n\n // Contains information about a relay to be sent along with additional information that is not unique to the\n // relay itself but is required to know how to process the relay. For example, \"updatedX\" fields can be used\n // by the relayer to modify fields of the relay with the depositor's permission, and \"repaymentChainId\" is specified\n // by the relayer to determine where to take a relayer refund, but doesn't affect the uniqueness of the relay.\n struct V3RelayExecutionParams {\n V3RelayData relay;\n bytes32 relayHash;\n uint256 updatedOutputAmount;\n bytes32 updatedRecipient;\n bytes updatedMessage;\n uint256 repaymentChainId;\n }\n\n // Packs together parameters emitted in FilledRelay because there are too many emitted otherwise.\n // Similar to V3RelayExecutionParams, these parameters are not used to uniquely identify the deposit being\n // filled so they don't have to be unpacked by all clients.\n struct V3RelayExecutionEventInfo {\n bytes32 updatedRecipient;\n bytes32 updatedMessageHash;\n uint256 updatedOutputAmount;\n FillType fillType;\n }\n\n // Represents the parameters required for a V3 deposit operation in the SpokePool.\n struct DepositV3Params {\n bytes32 depositor;\n bytes32 recipient;\n bytes32 inputToken;\n bytes32 outputToken;\n uint256 inputAmount;\n uint256 outputAmount;\n uint256 destinationChainId;\n bytes32 exclusiveRelayer;\n uint256 depositId;\n uint32 quoteTimestamp;\n uint32 fillDeadline;\n uint32 exclusivityParameter;\n bytes message;\n }\n\n /**************************************\n * EVENTS *\n **************************************/\n\n event FundsDeposited(\n bytes32 inputToken,\n bytes32 outputToken,\n uint256 inputAmount,\n uint256 outputAmount,\n uint256 indexed destinationChainId,\n uint256 indexed depositId,\n uint32 quoteTimestamp,\n uint32 fillDeadline,\n uint32 exclusivityDeadline,\n bytes32 indexed depositor,\n bytes32 recipient,\n bytes32 exclusiveRelayer,\n bytes message\n );\n\n event RequestedSpeedUpDeposit(\n uint256 updatedOutputAmount,\n uint256 indexed depositId,\n bytes32 indexed depositor,\n bytes32 updatedRecipient,\n bytes updatedMessage,\n bytes depositorSignature\n );\n\n event FilledRelay(\n bytes32 inputToken,\n bytes32 outputToken,\n uint256 inputAmount,\n uint256 outputAmount,\n uint256 repaymentChainId,\n uint256 indexed originChainId,\n uint256 indexed depositId,\n uint32 fillDeadline,\n uint32 exclusivityDeadline,\n bytes32 exclusiveRelayer,\n bytes32 indexed relayer,\n bytes32 depositor,\n bytes32 recipient,\n bytes32 messageHash,\n V3RelayExecutionEventInfo relayExecutionInfo\n );\n\n event RequestedSlowFill(\n bytes32 inputToken,\n bytes32 outputToken,\n uint256 inputAmount,\n uint256 outputAmount,\n uint256 indexed originChainId,\n uint256 indexed depositId,\n uint32 fillDeadline,\n uint32 exclusivityDeadline,\n bytes32 exclusiveRelayer,\n bytes32 depositor,\n bytes32 recipient,\n bytes32 messageHash\n );\n\n event ClaimedRelayerRefund(\n bytes32 indexed l2TokenAddress,\n bytes32 indexed refundAddress,\n uint256 amount,\n address indexed caller\n );\n\n /**************************************\n * FUNCTIONS *\n **************************************/\n\n function deposit(\n bytes32 depositor,\n bytes32 recipient,\n bytes32 inputToken,\n bytes32 outputToken,\n uint256 inputAmount,\n uint256 outputAmount,\n uint256 destinationChainId,\n bytes32 exclusiveRelayer,\n uint32 quoteTimestamp,\n uint32 fillDeadline,\n uint32 exclusivityDeadline,\n bytes calldata message\n ) external payable;\n\n function depositV3(\n address depositor,\n address recipient,\n address inputToken,\n address outputToken,\n uint256 inputAmount,\n uint256 outputAmount,\n uint256 destinationChainId,\n address exclusiveRelayer,\n uint32 quoteTimestamp,\n uint32 fillDeadline,\n uint32 exclusivityDeadline,\n bytes calldata message\n ) external payable;\n\n function depositNow(\n bytes32 depositor,\n bytes32 recipient,\n bytes32 inputToken,\n bytes32 outputToken,\n uint256 inputAmount,\n uint256 outputAmount,\n uint256 destinationChainId,\n bytes32 exclusiveRelayer,\n uint32 fillDeadlineOffset,\n uint32 exclusivityDeadline,\n bytes calldata message\n ) external payable;\n\n function depositV3Now(\n address depositor,\n address recipient,\n address inputToken,\n address outputToken,\n uint256 inputAmount,\n uint256 outputAmount,\n uint256 destinationChainId,\n address exclusiveRelayer,\n uint32 fillDeadlineOffset,\n uint32 exclusivityDeadline,\n bytes calldata message\n ) external payable;\n\n function unsafeDeposit(\n bytes32 depositor,\n bytes32 recipient,\n bytes32 inputToken,\n bytes32 outputToken,\n uint256 inputAmount,\n uint256 outputAmount,\n uint256 destinationChainId,\n bytes32 exclusiveRelayer,\n uint256 depositNonce,\n uint32 quoteTimestamp,\n uint32 fillDeadline,\n uint32 exclusivityParameter,\n bytes calldata message\n ) external payable;\n\n function speedUpDeposit(\n bytes32 depositor,\n uint256 depositId,\n uint256 updatedOutputAmount,\n bytes32 updatedRecipient,\n bytes calldata updatedMessage,\n bytes calldata depositorSignature\n ) external;\n\n function speedUpV3Deposit(\n address depositor,\n uint256 depositId,\n uint256 updatedOutputAmount,\n address updatedRecipient,\n bytes calldata updatedMessage,\n bytes calldata depositorSignature\n ) external;\n\n function fillRelay(\n V3RelayData calldata relayData,\n uint256 repaymentChainId,\n bytes32 repaymentAddress\n ) external;\n\n function fillV3Relay(V3RelayDataLegacy calldata relayData, uint256 repaymentChainId) external;\n\n function fillRelayWithUpdatedDeposit(\n V3RelayData calldata relayData,\n uint256 repaymentChainId,\n bytes32 repaymentAddress,\n uint256 updatedOutputAmount,\n bytes32 updatedRecipient,\n bytes calldata updatedMessage,\n bytes calldata depositorSignature\n ) external;\n\n function requestSlowFill(V3RelayData calldata relayData) external;\n\n function executeSlowRelayLeaf(\n V3SlowFill calldata slowFillLeaf,\n uint32 rootBundleId,\n bytes32[] calldata proof\n ) external;\n\n function claimRelayerRefund(bytes32 l2TokenAddress, bytes32 refundAddress) external;\n\n /**************************************\n * ERRORS *\n **************************************/\n\n error DisabledRoute();\n error InvalidQuoteTimestamp();\n error InvalidFillDeadline();\n error InvalidExclusiveRelayer();\n error MsgValueDoesNotMatchInputAmount();\n error NotExclusiveRelayer();\n error NoSlowFillsInExclusivityWindow();\n error RelayFilled();\n error InvalidSlowFillRequest();\n error ExpiredFillDeadline();\n error InvalidMerkleProof();\n error InvalidChainId();\n error InvalidMerkleLeaf();\n error ClaimedMerkleLeaf();\n error InvalidPayoutAdjustmentPct();\n error WrongERC7683OrderId();\n error LowLevelCallFailed(bytes data);\n error InsufficientSpokePoolBalanceToExecuteLeaf();\n error NoRelayerRefundToClaim();\n\n /**************************************\n * LEGACY EVENTS *\n **************************************/\n\n // Note: these events are unused, but included in the ABI for ease of migration.\n event V3FundsDeposited(\n address inputToken,\n address outputToken,\n uint256 inputAmount,\n uint256 outputAmount,\n uint256 indexed destinationChainId,\n uint32 indexed depositId,\n uint32 quoteTimestamp,\n uint32 fillDeadline,\n uint32 exclusivityDeadline,\n address indexed depositor,\n address recipient,\n address exclusiveRelayer,\n bytes message\n );\n\n event RequestedSpeedUpV3Deposit(\n uint256 updatedOutputAmount,\n uint32 indexed depositId,\n address indexed depositor,\n address updatedRecipient,\n bytes updatedMessage,\n bytes depositorSignature\n );\n\n // Legacy struct only used to preserve the FilledV3Relay event definition.\n struct LegacyV3RelayExecutionEventInfo {\n address updatedRecipient;\n bytes updatedMessage;\n uint256 updatedOutputAmount;\n FillType fillType;\n }\n\n event FilledV3Relay(\n address inputToken,\n address outputToken,\n uint256 inputAmount,\n uint256 outputAmount,\n uint256 repaymentChainId,\n uint256 indexed originChainId,\n uint32 indexed depositId,\n uint32 fillDeadline,\n uint32 exclusivityDeadline,\n address exclusiveRelayer,\n address indexed relayer,\n address depositor,\n address recipient,\n bytes message,\n LegacyV3RelayExecutionEventInfo relayExecutionInfo\n );\n\n event RequestedV3SlowFill(\n address inputToken,\n address outputToken,\n uint256 inputAmount,\n uint256 outputAmount,\n uint256 indexed originChainId,\n uint32 indexed depositId,\n uint32 fillDeadline,\n uint32 exclusivityDeadline,\n address exclusiveRelayer,\n address depositor,\n address recipient,\n bytes message\n );\n}\n"
+ },
+ "contracts/interfaces/ZkStackBridgeHub.sol": {
+ "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\n\n/**\n * @title BridgeHubInterface\n * @notice This interface is shared between ZkStack adapters. It is the main interaction point for bridging to ZkStack chains.\n */\ninterface BridgeHubInterface {\n struct L2TransactionRequestDirect {\n uint256 chainId;\n uint256 mintValue;\n address l2Contract;\n uint256 l2Value;\n bytes l2Calldata;\n uint256 l2GasLimit;\n uint256 l2GasPerPubdataByteLimit;\n bytes[] factoryDeps;\n address refundRecipient;\n }\n\n /**\n * @notice the mailbox is called directly after the sharedBridge received the deposit.\n * This assumes that either ether is the base token or the msg.sender has approved mintValue allowance for the\n * sharedBridge. This means this is not ideal for contract calls, as the contract would have to handle token\n * allowance of the base Token.\n * @param _request the direct request.\n */\n function requestL2TransactionDirect(L2TransactionRequestDirect calldata _request)\n external\n payable\n returns (bytes32 canonicalTxHash);\n\n struct L2TransactionRequestTwoBridgesOuter {\n uint256 chainId;\n uint256 mintValue;\n uint256 l2Value;\n uint256 l2GasLimit;\n uint256 l2GasPerPubdataByteLimit;\n address refundRecipient;\n address secondBridgeAddress;\n uint256 secondBridgeValue;\n bytes secondBridgeCalldata;\n }\n\n /**\n * @notice After depositing funds to the sharedBridge, the secondBridge is called to return the actual L2 message\n * which is sent to the Mailbox. This assumes that either ether is the base token or the msg.sender has approved\n * the sharedBridge with the mintValue, and also the necessary approvals are given for the second bridge. The logic\n * of this bridge is to allow easy depositing for bridges. Each contract that handles the users ERC20 tokens needs\n * approvals from the user, this contract allows the user to approve for each token only its respective bridge.\n * This function is great for contract calls to L2, the secondBridge can be any contract.\n * @param _request the two bridges request.\n */\n function requestL2TransactionTwoBridges(L2TransactionRequestTwoBridgesOuter calldata _request)\n external\n payable\n returns (bytes32 canonicalTxHash);\n\n /**\n * @notice Gets the shared bridge.\n * @dev The shared bridge manages ERC20 tokens.\n */\n function sharedBridge() external view returns (address);\n\n /**\n * @notice Gets the base token for a chain.\n * @dev Base token == native token.\n */\n function baseToken(uint256 _chainId) external view returns (address);\n\n /**\n * @notice Computes the base transaction cost for a transaction.\n * @param _chainId the chain the transaction is being sent to.\n * @param _gasPrice the l1 gas price at time of execution.\n * @param _l2GasLimit the gas limit for the l2 transaction.\n * @param _l2GasPerPubdataByteLimit configuration value that changes infrequently.\n */\n function l2TransactionBaseCost(\n uint256 _chainId,\n uint256 _gasPrice,\n uint256 _l2GasLimit,\n uint256 _l2GasPerPubdataByteLimit\n ) external view returns (uint256);\n}\n"
+ },
+ "contracts/Lens_SpokePool.sol": {
+ "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\n\nimport \"./ZkSync_SpokePool.sol\";\n\n/**\n * @notice Lens specific SpokePool. Wrapper around the ZkSync_SpokePool contract.\n * @dev Resources for compiling and deploying contracts with hardhat: https://era.zksync.io/docs/tools/hardhat/hardhat-zksync-solc.html\n * @custom:security-contact bugs@across.to\n */\ncontract Lens_SpokePool is ZkSync_SpokePool {\n /// @custom:oz-upgrades-unsafe-allow constructor\n constructor(\n address _wrappedNativeTokenAddress,\n IERC20 _circleUSDC,\n ZkBridgeLike _zkUSDCBridge,\n ITokenMessenger _cctpTokenMessenger,\n uint32 _depositQuoteTimeBuffer,\n uint32 _fillDeadlineBuffer\n )\n ZkSync_SpokePool(\n _wrappedNativeTokenAddress,\n _circleUSDC,\n _zkUSDCBridge,\n _cctpTokenMessenger,\n _depositQuoteTimeBuffer,\n _fillDeadlineBuffer\n )\n {}\n}\n"
+ },
+ "contracts/libraries/AddressConverters.sol": {
+ "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\n\nlibrary Bytes32ToAddress {\n /**************************************\n * ERRORS *\n **************************************/\n error InvalidBytes32();\n\n function toAddress(bytes32 _bytes32) internal pure returns (address) {\n checkAddress(_bytes32);\n return address(uint160(uint256(_bytes32)));\n }\n\n function toAddressUnchecked(bytes32 _bytes32) internal pure returns (address) {\n return address(uint160(uint256(_bytes32)));\n }\n\n function checkAddress(bytes32 _bytes32) internal pure {\n if (uint256(_bytes32) >> 160 != 0) {\n revert InvalidBytes32();\n }\n }\n}\n\nlibrary AddressToBytes32 {\n function toBytes32(address _address) internal pure returns (bytes32) {\n return bytes32(uint256(uint160(_address)));\n }\n}\n"
+ },
+ "contracts/libraries/CircleCCTPAdapter.sol": {
+ "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\n\nimport \"@openzeppelin/contracts/token/ERC20/IERC20.sol\";\nimport \"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\";\nimport \"../external/interfaces/CCTPInterfaces.sol\";\nimport { AddressToBytes32 } from \"../libraries/AddressConverters.sol\";\n\nlibrary CircleDomainIds {\n uint32 public constant Ethereum = 0;\n uint32 public constant Optimism = 2;\n uint32 public constant Arbitrum = 3;\n uint32 public constant Solana = 5;\n uint32 public constant Base = 6;\n uint32 public constant Polygon = 7;\n uint32 public constant DoctorWho = 10;\n uint32 public constant Linea = 11;\n uint32 public constant WorldChain = 14;\n uint32 public constant UNINITIALIZED = type(uint32).max;\n}\n\n/**\n * @notice Facilitate bridging USDC via Circle's CCTP.\n * @dev This contract is intended to be inherited by other chain-specific adapters and spoke pools.\n * @custom:security-contact bugs@across.to\n */\nabstract contract CircleCCTPAdapter {\n using SafeERC20 for IERC20;\n using AddressToBytes32 for address;\n /**\n * @notice The domain ID that CCTP will transfer funds to.\n * @dev This identifier is assigned by Circle and is not related to a chain ID.\n * @dev Official domain list can be found here: https://developers.circle.com/stablecoins/docs/supported-domains\n */\n /// @custom:oz-upgrades-unsafe-allow state-variable-immutable\n\n uint32 public immutable recipientCircleDomainId;\n\n /**\n * @notice The official USDC contract address on this chain.\n * @dev Posted officially here: https://developers.circle.com/stablecoins/docs/usdc-on-main-networks\n */\n /// @custom:oz-upgrades-unsafe-allow state-variable-immutable\n IERC20 public immutable usdcToken;\n\n /**\n * @notice The official Circle CCTP token bridge contract endpoint.\n * @dev Posted officially here: https://developers.circle.com/stablecoins/docs/evm-smart-contracts\n */\n /// @custom:oz-upgrades-unsafe-allow state-variable-immutable\n ITokenMessenger public immutable cctpTokenMessenger;\n\n /**\n * @notice Indicates if the CCTP V2 TokenMessenger is being used.\n * @dev This is determined by checking if the feeRecipient() function exists and returns a non-zero address.\n */\n /// @custom:oz-upgrades-unsafe-allow state-variable-immutable\n bool public immutable cctpV2;\n\n /**\n * @notice intiailizes the CircleCCTPAdapter contract.\n * @param _usdcToken USDC address on the current chain.\n * @param _cctpTokenMessenger TokenMessenger contract to bridge via CCTP. If the zero address is passed, CCTP bridging will be disabled.\n * @param _recipientCircleDomainId The domain ID that CCTP will transfer funds to.\n */\n /// @custom:oz-upgrades-unsafe-allow constructor\n constructor(\n IERC20 _usdcToken,\n /// @dev This should ideally be an address but it's kept as an ITokenMessenger to avoid rippling changes to the\n /// constructors for every SpokePool/Adapter.\n ITokenMessenger _cctpTokenMessenger,\n uint32 _recipientCircleDomainId\n ) {\n usdcToken = _usdcToken;\n cctpTokenMessenger = _cctpTokenMessenger;\n recipientCircleDomainId = _recipientCircleDomainId;\n\n // Only the CCTP V2 TokenMessenger has a feeRecipient() function, so we use it to\n // figure out if we are using CCTP V2 or V1. `success` can be true even if the contract doesn't\n // implement feeRecipient but it has a fallback function so to be extra safe, we check the return value\n // of feeRecipient() as well.\n (bool success, bytes memory feeRecipient) = address(cctpTokenMessenger).staticcall(\n abi.encodeWithSignature(\"feeRecipient()\")\n );\n // In case of a call to nonexistent contract or a call to a contract with a fallback function which\n // doesn't return any data, feeRecipient can be empty so check its length.\n // Even with this check, it's possible that the contract has implemented a fallback function that returns\n // 32 bytes of data but its not actually the feeRecipient address. This is extremely low risk but worth\n // mentioning that the following check is not 100% safe.\n cctpV2 = (success &&\n feeRecipient.length == 32 &&\n address(uint160(uint256(bytes32(feeRecipient)))) != address(0));\n }\n\n /**\n * @notice Returns whether or not the CCTP bridge is enabled.\n * @dev If the CCTPTokenMessenger is the zero address, CCTP bridging is disabled.\n */\n function _isCCTPEnabled() internal view returns (bool) {\n return address(cctpTokenMessenger) != address(0);\n }\n\n /**\n * @notice Transfers USDC from the current domain to the given address on the new domain.\n * @dev This function will revert if the CCTP bridge is disabled. I.e. if the zero address is passed to the constructor for the cctpTokenMessenger.\n * @param to Address to receive USDC on the new domain.\n * @param amount Amount of USDC to transfer.\n */\n function _transferUsdc(address to, uint256 amount) internal {\n _transferUsdc(to.toBytes32(), amount);\n }\n\n /**\n * @notice Transfers USDC from the current domain to the given address on the new domain.\n * @dev This function will revert if the CCTP bridge is disabled. I.e. if the zero address is passed to the constructor for the cctpTokenMessenger.\n * @param to Address to receive USDC on the new domain represented as bytes32.\n * @param amount Amount of USDC to transfer.\n */\n function _transferUsdc(bytes32 to, uint256 amount) internal {\n // Only approve the exact amount to be transferred\n usdcToken.safeIncreaseAllowance(address(cctpTokenMessenger), amount);\n // Submit the amount to be transferred to bridge via the TokenMessenger.\n // If the amount to send exceeds the burn limit per message, then split the message into smaller parts.\n // @dev We do not care about casting cctpTokenMessenger to ITokenMessengerV2 since both V1 and V2\n // expose a localMinter() view function that returns either an ITokenMinterV1 or ITokenMinterV2. Regardless,\n // we only care about the burnLimitsPerMessage function which is available in both versions and performs\n // the same logic, therefore we purposefully do not re-cast the cctpTokenMessenger and cctpMinter\n // to the specific version.\n ITokenMinter cctpMinter = cctpTokenMessenger.localMinter();\n uint256 burnLimit = cctpMinter.burnLimitsPerMessage(address(usdcToken));\n uint256 remainingAmount = amount;\n while (remainingAmount > 0) {\n uint256 partAmount = remainingAmount > burnLimit ? burnLimit : remainingAmount;\n if (cctpV2) {\n // Uses the CCTP V2 \"standard transfer\" speed and\n // therefore pays no additional fee for the transfer to be sped up.\n ITokenMessengerV2(address(cctpTokenMessenger)).depositForBurn(\n partAmount,\n recipientCircleDomainId,\n to,\n address(usdcToken),\n // The following parameters are new in this function from V2 to V1, can read more here:\n // https://developers.circle.com/stablecoins/evm-smart-contracts\n bytes32(0), // destinationCaller is set to bytes32(0) to indicate that anyone can call\n // receiveMessage on the destination to finalize the transfer\n 0, // maxFee can be set to 0 for a \"standard transfer\"\n 2000 // minFinalityThreshold can be set to 2000 for a \"standard transfer\",\n // https://github.com/circlefin/evm-cctp-contracts/blob/63ab1f0ac06ce0793c0bbfbb8d09816bc211386d/src/v2/FinalityThresholds.sol#L21\n );\n } else {\n cctpTokenMessenger.depositForBurn(partAmount, recipientCircleDomainId, to, address(usdcToken));\n }\n remainingAmount -= partAmount;\n }\n }\n}\n"
+ },
+ "contracts/libraries/CrossDomainAddressUtils.sol": {
+ "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\n\n/**\n * @title AddressUtils\n * @notice This library contains internal functions for manipulating addresses.\n */\nlibrary CrossDomainAddressUtils {\n // L1 addresses are transformed during l1->l2 calls.\n // This cannot be pulled directly from Arbitrum contracts because their contracts are not 0.8.X compatible and\n // this operation takes advantage of overflows, whose behavior changed in 0.8.0.\n function applyL1ToL2Alias(address l1Address) internal pure returns (address l2Address) {\n unchecked {\n l2Address = address(uint160(l1Address) + uint160(0x1111000000000000000000000000000000001111));\n }\n }\n}\n"
+ },
+ "contracts/Lockable.sol": {
+ "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\n\n/**\n * @title A contract that provides modifiers to prevent reentrancy to state-changing and view-only methods. This contract\n * is inspired by https://github.com/OpenZeppelin/openzeppelin-contracts/blob/master/contracts/utils/ReentrancyGuard.sol\n * and https://github.com/balancer-labs/balancer-core/blob/master/contracts/BPool.sol.\n * @dev The reason why we use this local contract instead of importing from uma/contracts is because of the addition\n * of the internal method `functionCallStackOriginatesFromOutsideThisContract` which doesn't exist in the one exported\n * by uma/contracts.\n * @custom:security-contact bugs@across.to\n */\ncontract Lockable {\n bool internal _notEntered;\n\n constructor() {\n // Storing an initial non-zero value makes deployment a bit more expensive, but in exchange the refund on every\n // call to nonReentrant will be lower in amount. Since refunds are capped to a percentage of the total\n // transaction's gas, it is best to keep them low in cases like this one, to increase the likelihood of the full\n // refund coming into effect.\n _notEntered = true;\n }\n\n /**\n * @dev Prevents a contract from calling itself, directly or indirectly.\n * Calling a nonReentrant function from another nonReentrant function is not supported. It is possible to\n * prevent this from happening by making the nonReentrant function external, and making it call a private\n * function that does the actual state modification.\n */\n modifier nonReentrant() {\n _preEntranceCheck();\n _preEntranceSet();\n _;\n _postEntranceReset();\n }\n\n /**\n * @dev Designed to prevent a view-only method from being re-entered during a call to a nonReentrant() state-changing method.\n */\n modifier nonReentrantView() {\n _preEntranceCheck();\n _;\n }\n\n /**\n * @dev Returns true if the contract is currently in a non-entered state, meaning that the origination of the call\n * came from outside the contract. This is relevant with fallback/receive methods to see if the call came from ETH\n * being dropped onto the contract externally or due to ETH dropped on the contract from within a method in this\n * contract, such as unwrapping WETH to ETH within the contract.\n */\n function functionCallStackOriginatesFromOutsideThisContract() internal view returns (bool) {\n return _notEntered;\n }\n\n // Internal methods are used to avoid copying the require statement's bytecode to every nonReentrant() method.\n // On entry into a function, _preEntranceCheck() should always be called to check if the function is being\n // re-entered. Then, if the function modifies state, it should call _postEntranceSet(), perform its logic, and\n // then call _postEntranceReset().\n // View-only methods can simply call _preEntranceCheck() to make sure that it is not being re-entered.\n function _preEntranceCheck() internal view {\n // On the first call to nonReentrant, _notEntered will be true\n require(_notEntered, \"ReentrancyGuard: reentrant call\");\n }\n\n function _preEntranceSet() internal {\n // Any calls to nonReentrant after this point will fail\n _notEntered = false;\n }\n\n function _postEntranceReset() internal {\n // By storing the original value once again, a refund is triggered (see\n // https://eips.ethereum.org/EIPS/eip-2200)\n _notEntered = true;\n }\n}\n"
+ },
+ "contracts/MerkleLib.sol": {
+ "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\n\nimport \"./interfaces/SpokePoolInterface.sol\";\nimport \"./interfaces/V3SpokePoolInterface.sol\";\nimport \"./interfaces/HubPoolInterface.sol\";\n\nimport \"@openzeppelin/contracts/utils/cryptography/MerkleProof.sol\";\n\n/**\n * @notice Library to help with merkle roots, proofs, and claims.\n * @custom:security-contact bugs@across.to\n */\nlibrary MerkleLib {\n /**\n * @notice Verifies that a repayment is contained within a merkle root.\n * @param root the merkle root.\n * @param rebalance the rebalance struct.\n * @param proof the merkle proof.\n * @return bool to signal if the pool rebalance proof correctly shows inclusion of the rebalance within the tree.\n */\n function verifyPoolRebalance(\n bytes32 root,\n HubPoolInterface.PoolRebalanceLeaf memory rebalance,\n bytes32[] memory proof\n ) internal pure returns (bool) {\n return MerkleProof.verify(proof, root, keccak256(abi.encode(rebalance)));\n }\n\n /**\n * @notice Verifies that a relayer refund is contained within a merkle root.\n * @param root the merkle root.\n * @param refund the refund struct.\n * @param proof the merkle proof.\n * @return bool to signal if the relayer refund proof correctly shows inclusion of the refund within the tree.\n */\n function verifyRelayerRefund(\n bytes32 root,\n SpokePoolInterface.RelayerRefundLeaf memory refund,\n bytes32[] memory proof\n ) internal pure returns (bool) {\n return MerkleProof.verify(proof, root, keccak256(abi.encode(refund)));\n }\n\n function verifyV3SlowRelayFulfillment(\n bytes32 root,\n V3SpokePoolInterface.V3SlowFill memory slowRelayFulfillment,\n bytes32[] memory proof\n ) internal pure returns (bool) {\n return MerkleProof.verify(proof, root, keccak256(abi.encode(slowRelayFulfillment)));\n }\n\n // The following functions are primarily copied from\n // https://github.com/Uniswap/merkle-distributor/blob/master/contracts/MerkleDistributor.sol with minor changes.\n\n /**\n * @notice Tests whether a claim is contained within a claimedBitMap mapping.\n * @param claimedBitMap a simple uint256 mapping in storage used as a bitmap.\n * @param index the index to check in the bitmap.\n * @return bool indicating if the index within the claimedBitMap has been marked as claimed.\n */\n function isClaimed(mapping(uint256 => uint256) storage claimedBitMap, uint256 index) internal view returns (bool) {\n uint256 claimedWordIndex = index / 256;\n uint256 claimedBitIndex = index % 256;\n uint256 claimedWord = claimedBitMap[claimedWordIndex];\n uint256 mask = (1 << claimedBitIndex);\n return claimedWord & mask == mask;\n }\n\n /**\n * @notice Marks an index in a claimedBitMap as claimed.\n * @param claimedBitMap a simple uint256 mapping in storage used as a bitmap.\n * @param index the index to mark in the bitmap.\n */\n function setClaimed(mapping(uint256 => uint256) storage claimedBitMap, uint256 index) internal {\n uint256 claimedWordIndex = index / 256;\n uint256 claimedBitIndex = index % 256;\n claimedBitMap[claimedWordIndex] = claimedBitMap[claimedWordIndex] | (1 << claimedBitIndex);\n }\n\n /**\n * @notice Tests whether a claim is contained within a 1D claimedBitMap mapping.\n * @param claimedBitMap a simple uint256 value, encoding a 1D bitmap.\n * @param index the index to check in the bitmap. Uint8 type enforces that index can't be > 255.\n * @return bool indicating if the index within the claimedBitMap has been marked as claimed.\n */\n function isClaimed1D(uint256 claimedBitMap, uint8 index) internal pure returns (bool) {\n uint256 mask = (1 << index);\n return claimedBitMap & mask == mask;\n }\n\n /**\n * @notice Marks an index in a claimedBitMap as claimed.\n * @param claimedBitMap a simple uint256 mapping in storage used as a bitmap. Uint8 type enforces that index\n * can't be > 255.\n * @param index the index to mark in the bitmap.\n * @return uint256 representing the modified input claimedBitMap with the index set to true.\n */\n function setClaimed1D(uint256 claimedBitMap, uint8 index) internal pure returns (uint256) {\n return claimedBitMap | (1 << index);\n }\n}\n"
+ },
+ "contracts/Ovm_SpokePool.sol": {
+ "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\n\nimport \"./SpokePool.sol\";\nimport \"./external/interfaces/WETH9Interface.sol\";\nimport \"./libraries/CircleCCTPAdapter.sol\";\n\nimport \"@openzeppelin/contracts-upgradeable/crosschain/optimism/LibOptimismUpgradeable.sol\";\nimport \"@eth-optimism/contracts/libraries/constants/Lib_PredeployAddresses.sol\";\n\n// https://github.com/ethereum-optimism/optimism/blob/bf51c4935261634120f31827c3910aa631f6bf9c/packages/contracts-bedrock/contracts/L2/L2StandardBridge.sol\ninterface IL2ERC20Bridge {\n function withdrawTo(\n address _l2Token,\n address _to,\n uint256 _amount,\n uint32 _minGasLimit,\n bytes calldata _extraData\n ) external payable;\n\n function bridgeERC20To(\n address _localToken,\n address _remoteToken,\n address _to,\n uint256 _amount,\n uint32 _minGasLimit,\n bytes calldata _extraData\n ) external;\n}\n\n/**\n * @notice OVM specific SpokePool. Uses OVM cross-domain-enabled logic to implement admin only access to functions. * Optimism, Base, and Boba each implement this spoke pool and set their chain specific contract addresses for l2Eth and l2Weth.\n * @custom:security-contact bugs@across.to\n */\ncontract Ovm_SpokePool is SpokePool, CircleCCTPAdapter {\n using SafeERC20 for IERC20;\n // \"l1Gas\" parameter used in call to bridge tokens from this contract back to L1 via IL2ERC20Bridge. Currently\n // unused by bridge but included for future compatibility.\n uint32 public l1Gas;\n\n // ETH is an ERC20 on OVM.\n address public l2Eth;\n\n // Address of the Optimism L2 messenger.\n address public constant MESSENGER = Lib_PredeployAddresses.L2_CROSS_DOMAIN_MESSENGER;\n // @dev This storage slot is reserved to replace the old messenger public variable that has now been\n // replaced by the above constant.\n address private __deprecated_messenger;\n\n // Stores alternative token bridges to use for L2 tokens that don't go over the standard bridge. This is needed\n // to support non-standard ERC20 tokens on Optimism, such as DAI which uses a custom bridge with the same\n // interface as the standard bridge.\n mapping(address => address) public tokenBridges;\n\n // Stores mapping of L2 tokens to L1 equivalent tokens. If a mapping is defined for a given L2 token, then\n // the mapped L1 token can be used in _bridgeTokensToHubPool which can then call bridgeERC20To, which\n // requires specfiying an L1 token.\n mapping(address => address) public remoteL1Tokens;\n\n event SetL1Gas(uint32 indexed newL1Gas);\n event SetL2TokenBridge(address indexed l2Token, address indexed tokenBridge);\n event SetRemoteL1Token(address indexed l2Token, address indexed l1Token);\n\n error NotCrossDomainAdmin();\n\n /// @custom:oz-upgrades-unsafe-allow constructor\n constructor(\n address _wrappedNativeTokenAddress,\n uint32 _depositQuoteTimeBuffer,\n uint32 _fillDeadlineBuffer,\n IERC20 _l2Usdc,\n ITokenMessenger _cctpTokenMessenger\n )\n SpokePool(_wrappedNativeTokenAddress, _depositQuoteTimeBuffer, _fillDeadlineBuffer)\n CircleCCTPAdapter(_l2Usdc, _cctpTokenMessenger, CircleDomainIds.Ethereum)\n {} // solhint-disable-line no-empty-blocks\n\n /**\n * @notice Construct the OVM SpokePool.\n * @param _initialDepositId Starting deposit ID. Set to 0 unless this is a re-deployment in order to mitigate\n * relay hash collisions.\n * @param _crossDomainAdmin Cross domain admin to set. Can be changed by admin.\n * @param _withdrawalRecipient Address which receives token withdrawals. Can be changed by admin. For Spoke Pools on L2, this will\n * likely be the hub pool.\n * @param _l2Eth Address of L2 ETH token. Usually should be Lib_PreeployAddresses.OVM_ETH but sometimes this can\n * be different, like with Boba which flips the WETH and OVM_ETH addresses.\n */\n function __OvmSpokePool_init(\n uint32 _initialDepositId,\n address _crossDomainAdmin,\n address _withdrawalRecipient,\n address _l2Eth\n ) public onlyInitializing {\n l1Gas = 5_000_000;\n __SpokePool_init(_initialDepositId, _crossDomainAdmin, _withdrawalRecipient);\n //slither-disable-next-line missing-zero-check\n l2Eth = _l2Eth;\n }\n\n /*******************************************\n * OPTIMISM-SPECIFIC ADMIN FUNCTIONS *\n *******************************************/\n\n /**\n * @notice Change L1 gas limit. Callable only by admin.\n * @param newl1Gas New L1 gas limit to set.\n */\n function setL1GasLimit(uint32 newl1Gas) public onlyAdmin nonReentrant {\n l1Gas = newl1Gas;\n emit SetL1Gas(newl1Gas);\n }\n\n function setRemoteL1Token(address l2Token, address l1Token) public onlyAdmin nonReentrant {\n remoteL1Tokens[l2Token] = l1Token;\n emit SetRemoteL1Token(l2Token, l1Token);\n }\n\n /**\n * @notice Set bridge contract for L2 token used to withdraw back to L1.\n * @dev If this mapping isn't set for an L2 token, then the standard bridge will be used to bridge this token.\n * @param tokenBridge Address of token bridge\n */\n function setTokenBridge(address l2Token, address tokenBridge) public onlyAdmin nonReentrant {\n tokenBridges[l2Token] = tokenBridge;\n emit SetL2TokenBridge(l2Token, tokenBridge);\n }\n\n /**************************************\n * INTERNAL FUNCTIONS *\n **************************************/\n\n /**\n * @notice Wraps any ETH into WETH before executing leaves. This is necessary because SpokePool receives\n * ETH over the canonical token bridge instead of WETH.\n */\n function _preExecuteLeafHook(address l2TokenAddress) internal override {\n if (l2TokenAddress == address(wrappedNativeToken)) _depositEthToWeth();\n }\n\n // Wrap any ETH owned by this contract so we can send expected L2 token to recipient. This is necessary because\n // this SpokePool will receive ETH from the canonical token bridge instead of WETH. Its not sufficient to execute\n // this logic inside a fallback method that executes when this contract receives ETH because ETH is an ERC20\n // on the OVM.\n function _depositEthToWeth() internal {\n //slither-disable-next-line arbitrary-send-eth\n if (address(this).balance > 0) wrappedNativeToken.deposit{ value: address(this).balance }();\n }\n\n function _bridgeTokensToHubPool(uint256 amountToReturn, address l2TokenAddress) internal virtual override {\n // If the token being bridged is WETH then we need to first unwrap it to ETH and then send ETH over the\n // canonical bridge. On Optimism, this is address 0xDeadDeAddeAddEAddeadDEaDDEAdDeaDDeAD0000.\n if (l2TokenAddress == address(wrappedNativeToken)) {\n WETH9Interface(l2TokenAddress).withdraw(amountToReturn); // Unwrap into ETH.\n l2TokenAddress = l2Eth; // Set the l2TokenAddress to ETH.\n IL2ERC20Bridge(Lib_PredeployAddresses.L2_STANDARD_BRIDGE).withdrawTo{ value: amountToReturn }(\n l2TokenAddress, // _l2Token. Address of the L2 token to bridge over.\n withdrawalRecipient, // _to. Withdraw, over the bridge, to the l1 pool contract.\n amountToReturn, // _amount.\n l1Gas, // _l1Gas. Unused, but included for potential forward compatibility considerations\n \"\" // _data. We don't need to send any data for the bridging action.\n );\n }\n // If the token is USDC && CCTP bridge is enabled, then bridge USDC via CCTP.\n else if (_isCCTPEnabled() && l2TokenAddress == address(usdcToken)) {\n _transferUsdc(withdrawalRecipient, amountToReturn);\n }\n // Note we'll default to withdrawTo instead of bridgeERC20To unless the remoteL1Tokens mapping is set for\n // the l2TokenAddress. withdrawTo should be used to bridge back non-native L2 tokens\n // (i.e. non-native L2 tokens have a canonical L1 token). If we should bridge \"native L2\" tokens then\n // we'd need to call bridgeERC20To and give allowance to the tokenBridge to spend l2Token from this contract.\n // Therefore for native tokens we should set ensure that remoteL1Tokens is set for the l2TokenAddress.\n else {\n IL2ERC20Bridge tokenBridge = IL2ERC20Bridge(\n tokenBridges[l2TokenAddress] == address(0)\n ? Lib_PredeployAddresses.L2_STANDARD_BRIDGE\n : tokenBridges[l2TokenAddress]\n );\n if (remoteL1Tokens[l2TokenAddress] != address(0)) {\n // If there is a mapping for this L2 token to an L1 token, then use the L1 token address and\n // call bridgeERC20To.\n IERC20(l2TokenAddress).safeIncreaseAllowance(address(tokenBridge), amountToReturn);\n address remoteL1Token = remoteL1Tokens[l2TokenAddress];\n tokenBridge.bridgeERC20To(\n l2TokenAddress, // _l2Token. Address of the L2 token to bridge over.\n remoteL1Token, // Remote token to be received on L1 side. If the\n // remoteL1Token on the other chain does not recognize the local token as the correct\n // pair token, the ERC20 bridge will fail and the tokens will be returned to sender on\n // this chain.\n withdrawalRecipient, // _to\n amountToReturn, // _amount\n l1Gas, // _l1Gas\n \"\" // _data\n );\n } else {\n tokenBridge.withdrawTo(\n l2TokenAddress, // _l2Token. Address of the L2 token to bridge over.\n withdrawalRecipient, // _to. Withdraw, over the bridge, to the l1 pool contract.\n amountToReturn, // _amount.\n l1Gas, // _l1Gas. Unused, but included for potential forward compatibility considerations\n \"\" // _data. We don't need to send any data for the bridging action.\n );\n }\n }\n }\n\n // Apply OVM-specific transformation to cross domain admin address on L1.\n function _requireAdminSender() internal view override {\n if (LibOptimismUpgradeable.crossChainSender(MESSENGER) != crossDomainAdmin) revert NotCrossDomainAdmin();\n }\n\n // Reserve storage slots for future versions of this base contract to add state variables without\n // affecting the storage layout of child contracts. Decrement the size of __gap whenever state variables\n // are added. This is at bottom of contract to make sure its always at the end of storage.\n uint256[999] private __gap;\n}\n"
+ },
+ "contracts/Polygon_SpokePool.sol": {
+ "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\n\nimport \"./SpokePool.sol\";\nimport \"./PolygonTokenBridger.sol\";\nimport \"./external/interfaces/WETH9Interface.sol\";\nimport \"./interfaces/SpokePoolInterface.sol\";\nimport \"./libraries/CircleCCTPAdapter.sol\";\n\n/**\n * @notice IFxMessageProcessor represents interface to process messages.\n */\ninterface IFxMessageProcessor {\n /**\n * @notice Called by FxChild upon receiving L1 message that targets this contract. Performs an additional check\n * that the L1 caller was the expected cross domain admin, and then delegate calls.\n * @notice Polygon bridge only executes this external function on the target Polygon contract when relaying\n * messages from L1, so all functions on this SpokePool are expected to originate via this call.\n * @dev stateId value isn't used because it isn't relevant for this method. It doesn't care what state sync\n * triggered this call.\n * @param rootMessageSender Original L1 sender of data.\n * @param data ABI encoded function call to execute on this contract.\n */\n function processMessageFromRoot(\n uint256 stateId,\n address rootMessageSender,\n bytes calldata data\n ) external;\n}\n\n/**\n * @notice Polygon specific SpokePool.\n * @custom:security-contact bugs@across.to\n */\ncontract Polygon_SpokePool is IFxMessageProcessor, SpokePool, CircleCCTPAdapter {\n using SafeERC20Upgradeable for PolygonIERC20Upgradeable;\n\n // Address of FxChild which sends and receives messages to and from L1.\n address public fxChild;\n\n // Contract deployed on L1 and L2 processes all cross-chain transfers between this contract and the HubPool.\n // Required because bridging tokens from Polygon to Ethereum has special constraints.\n PolygonTokenBridger public polygonTokenBridger;\n\n // Internal variable that only flips temporarily to true upon receiving messages from L1. Used to authenticate that\n // the caller is the fxChild AND that the fxChild called processMessageFromRoot\n bool private callValidated;\n\n error MulticallExecuteLeaf();\n\n event SetFxChild(address indexed newFxChild);\n event SetPolygonTokenBridger(address indexed polygonTokenBridger);\n event ReceivedMessageFromL1(address indexed caller, address indexed rootMessageSender);\n\n error CallValidatedAlreadySet();\n error CallValidatedNotSet();\n error DelegateCallFailed();\n error NotHubPool();\n error NotFxChild();\n\n // Note: validating calls this way ensures that strange calls coming from the fxChild won't be misinterpreted.\n // Put differently, just checking that msg.sender == fxChild is not sufficient.\n // All calls that have admin privileges must be fired from within the processMessageFromRoot method that's gone\n // through validation where the sender is checked and the root (mainnet) sender is also validated.\n // This modifier sets the callValidated variable so this condition can be checked in _requireAdminSender().\n modifier validateInternalCalls() {\n // Make sure callValidated is set to True only once at beginning of processMessageFromRoot, which prevents\n // processMessageFromRoot from being re-entered.\n if (callValidated) revert CallValidatedAlreadySet();\n\n // This sets a variable indicating that we're now inside a validated call.\n // Note: this is used by other methods to ensure that this call has been validated by this method and is not\n // spoofed. See comment for `_requireAdminSender` for more details.\n callValidated = true;\n\n _;\n\n // Reset callValidated to false to disallow admin calls after this method exits.\n callValidated = false;\n }\n\n /// @custom:oz-upgrades-unsafe-allow constructor\n constructor(\n address _wrappedNativeTokenAddress,\n uint32 _depositQuoteTimeBuffer,\n uint32 _fillDeadlineBuffer,\n IERC20 _l2Usdc,\n ITokenMessenger _cctpTokenMessenger\n )\n SpokePool(_wrappedNativeTokenAddress, _depositQuoteTimeBuffer, _fillDeadlineBuffer)\n CircleCCTPAdapter(_l2Usdc, _cctpTokenMessenger, CircleDomainIds.Ethereum)\n {} // solhint-disable-line no-empty-blocks\n\n /**\n * @notice Construct the Polygon SpokePool.\n * @param _initialDepositId Starting deposit ID. Set to 0 unless this is a re-deployment in order to mitigate\n * relay hash collisions.\n * @param _polygonTokenBridger Token routing contract that sends tokens from here to HubPool. Changeable by Admin.\n * @param _crossDomainAdmin Cross domain admin to set. Can be changed by admin.\n * @param _withdrawalRecipient Address which receives token withdrawals. Can be changed by admin. For Spoke Pools on L2, this will\n * likely be the hub pool.\n * @param _fxChild FxChild contract, changeable by Admin.\n */\n function initialize(\n uint32 _initialDepositId,\n PolygonTokenBridger _polygonTokenBridger,\n address _crossDomainAdmin,\n address _withdrawalRecipient,\n address _fxChild\n ) public initializer {\n callValidated = false;\n __SpokePool_init(_initialDepositId, _crossDomainAdmin, _withdrawalRecipient);\n _setPolygonTokenBridger(payable(_polygonTokenBridger));\n //slither-disable-next-line missing-zero-check\n _setFxChild(_fxChild);\n }\n\n /********************************************************\n * POLYGON-SPECIFIC CROSS-CHAIN ADMIN FUNCTIONS *\n ********************************************************/\n\n /**\n * @notice Change FxChild address. Callable only by admin via processMessageFromRoot.\n * @param newFxChild New FxChild.\n */\n function setFxChild(address newFxChild) public onlyAdmin nonReentrant {\n _setFxChild(newFxChild);\n }\n\n /**\n * @notice Change polygonTokenBridger address. Callable only by admin via processMessageFromRoot.\n * @param newPolygonTokenBridger New Polygon Token Bridger contract.\n */\n function setPolygonTokenBridger(address payable newPolygonTokenBridger) public onlyAdmin nonReentrant {\n _setPolygonTokenBridger(newPolygonTokenBridger);\n }\n\n /**\n * @notice Called by FxChild upon receiving L1 message that targets this contract. Performs an additional check\n * that the L1 caller was the expected cross domain admin, and then delegate calls.\n * @notice Polygon bridge only executes this external function on the target Polygon contract when relaying\n * messages from L1, so all functions on this SpokePool are expected to originate via this call.\n * @dev stateId value isn't used because it isn't relevant for this method. It doesn't care what state sync\n * triggered this call.\n * @param rootMessageSender Original L1 sender of data.\n * @param data ABI encoded function call to execute on this contract.\n */\n function processMessageFromRoot(\n uint256, /*stateId*/\n address rootMessageSender,\n bytes calldata data\n ) public validateInternalCalls {\n // Validation logic.\n if (msg.sender != fxChild) revert NotFxChild();\n if (rootMessageSender != crossDomainAdmin) revert NotHubPool();\n\n // This uses delegatecall to take the information in the message and process it as a function call on this contract.\n /// This is a safe delegatecall because its made to address(this) so there is no risk of delegating to a\n /// selfdestruct().\n //slither-disable-start low-level-calls\n /// @custom:oz-upgrades-unsafe-allow delegatecall\n (bool success, ) = address(this).delegatecall(data);\n //slither-disable-end low-level-calls\n if (!success) revert DelegateCallFailed();\n\n emit ReceivedMessageFromL1(msg.sender, rootMessageSender);\n }\n\n /**\n * @notice Allows the caller to trigger the wrapping of any unwrapped matic tokens.\n * @dev Unlike other ERC20 transfers, Matic transfers from L1 -> L2 bridging don't result in an L2 call into\n * the contract receiving the tokens, so wrapping must be done via a separate transaction. In other words,\n * we can't rely upon a `fallback()` method being triggered to wrap MATIC upon receiving it.\n */\n function wrap() public nonReentrant {\n _wrap();\n }\n\n /**\n * @notice Override multicall so that it cannot include executeRelayerRefundLeaf\n * as one of the calls combined with other public function calls and blocks nested multicalls in general, which\n * don't have any practical use case. We also block nested multicalls which could be used to bypass\n * this check and there are no practical use cases for nested multicalls.\n * @dev Multicalling a single transaction will always succeed.\n * @dev Multicalling execute functions without combining other public function calls will succeed.\n * @dev Nested multicalls will always fail.\n * @dev Multicalling public function calls without combining execute functions will succeed.\n */\n function _validateMulticallData(bytes[] calldata data) internal pure override {\n bool hasOtherPublicFunctionCall = false;\n bool hasExecutedLeafCall = false;\n for (uint256 i = 0; i < data.length; i++) {\n bytes4 selector = bytes4(data[i][:4]);\n if (selector == MultiCallerUpgradeable.multicall.selector) {\n revert MulticallExecuteLeaf();\n } else if (selector == SpokePoolInterface.executeRelayerRefundLeaf.selector) {\n if (hasOtherPublicFunctionCall) revert MulticallExecuteLeaf();\n hasExecutedLeafCall = true;\n } else {\n if (hasExecutedLeafCall) revert MulticallExecuteLeaf();\n hasOtherPublicFunctionCall = true;\n }\n }\n }\n\n /**\n * @notice This function can send an L2 to L1 message so we are extra cautious about preventing a griefing vector\n * whereby someone batches this call with a bunch of other calls and produces a very large L2 burn transaction.\n * This might make the L2 -> L1 message fail due to exceeding the L1 calldata limit.\n */\n\n function executeRelayerRefundLeaf(\n uint32 rootBundleId,\n SpokePoolInterface.RelayerRefundLeaf memory relayerRefundLeaf,\n bytes32[] memory proof\n ) public payable override {\n // AddressLibUpgradeable.isContract isn't a sufficient check because it checks the contract code size of\n // msg.sender which is 0 if called from a constructor function on msg.sender. This is why we check if\n // msg.sender is equal to tx.origin which is fine as long as Polygon supports the tx.origin opcode. We also\n // check if the msg.sender has delegated their code to a contract via EIP7702.\n // solhint-disable-next-line avoid-tx-origin\n if (relayerRefundLeaf.amountToReturn > 0 && (msg.sender != tx.origin || msg.sender.code.length > 0))\n revert NotEOA();\n super.executeRelayerRefundLeaf(rootBundleId, relayerRefundLeaf, proof);\n }\n\n /**************************************\n * INTERNAL FUNCTIONS *\n **************************************/\n\n function _setFxChild(address _fxChild) internal {\n //slither-disable-next-line missing-zero-check\n fxChild = _fxChild;\n emit SetFxChild(_fxChild);\n }\n\n function _setPolygonTokenBridger(address payable _polygonTokenBridger) internal {\n polygonTokenBridger = PolygonTokenBridger(_polygonTokenBridger);\n emit SetPolygonTokenBridger(address(_polygonTokenBridger));\n }\n\n function _preExecuteLeafHook(address) internal override {\n // Wraps MATIC --> WMATIC before distributing tokens from this contract.\n _wrap();\n }\n\n function _bridgeTokensToHubPool(uint256 amountToReturn, address l2TokenAddress) internal override {\n // WARNING: Withdrawing MATIC can result in the L1 PolygonTokenBridger.startExitWithBurntTokens() failing\n // due to a MAX_LOGS constraint imposed by the ERC20Predicate, so if this SpokePool will be used to withdraw\n // MATIC then additional constraints need to be imposed to limit the # of logs produed by the L2 withdrawal\n // transaction. Currently, MATIC is not a supported token in Across for this SpokePool.\n\n // If the token is USDC, we need to use the CCTP bridge to transfer it to the hub pool.\n if (_isCCTPEnabled() && l2TokenAddress == address(usdcToken)) {\n _transferUsdc(withdrawalRecipient, amountToReturn);\n } else {\n PolygonIERC20Upgradeable(l2TokenAddress).safeIncreaseAllowance(\n address(polygonTokenBridger),\n amountToReturn\n );\n // Note: WrappedNativeToken is WMATIC on matic, so this tells the tokenbridger that this is an unwrappable native token.\n polygonTokenBridger.send(PolygonIERC20Upgradeable(l2TokenAddress), amountToReturn);\n }\n }\n\n function _wrap() internal {\n uint256 balance = address(this).balance;\n //slither-disable-next-line arbitrary-send-eth\n if (balance > 0) wrappedNativeToken.deposit{ value: balance }();\n }\n\n // @dev: This contract will trigger admin functions internally via the `processMessageFromRoot`, which is why\n // the `callValidated` check is made below and why we use the `validateInternalCalls` modifier on\n // `processMessageFromRoot`. This prevents calling the admin functions from any other method besides\n // `processMessageFromRoot`.\n function _requireAdminSender() internal view override {\n if (!callValidated) revert CallValidatedNotSet();\n }\n}\n"
+ },
+ "contracts/PolygonTokenBridger.sol": {
+ "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\n\nimport \"./Lockable.sol\";\nimport \"./external/interfaces/WETH9Interface.sol\";\n\nimport \"@openzeppelin/contracts-upgradeable/token/ERC20/IERC20Upgradeable.sol\";\nimport \"@openzeppelin/contracts-upgradeable/token/ERC20/utils/SafeERC20Upgradeable.sol\";\n\n// Polygon Registry contract that stores their addresses.\ninterface PolygonRegistry {\n function erc20Predicate() external returns (address);\n}\n\n// Polygon ERC20Predicate contract that handles Plasma exits (only used for Matic).\ninterface PolygonERC20Predicate {\n function startExitWithBurntTokens(bytes calldata data) external;\n}\n\n// ERC20s (on polygon) compatible with polygon's bridge have a withdraw method.\ninterface PolygonIERC20Upgradeable is IERC20Upgradeable {\n function withdraw(uint256 amount) external;\n}\n\ninterface MaticToken {\n function withdraw(uint256 amount) external payable;\n}\n\n/**\n * @notice Contract deployed on Ethereum and Polygon to facilitate token transfers from Polygon to the HubPool and back.\n * @dev Because Polygon only allows withdrawals from a particular address to go to that same address on mainnet, we need to\n * have some sort of contract that can guarantee identical addresses on Polygon and Ethereum. This contract is intended\n * to be completely immutable, so it's guaranteed that the contract on each side is configured identically as long as\n * it is created via create2. create2 is an alternative creation method that uses a different address determination\n * mechanism from normal create.\n * Normal create: address = hash(deployer_address, deployer_nonce)\n * create2: address = hash(0xFF, sender, salt, bytecode)\n * This ultimately allows create2 to generate deterministic addresses that don't depend on the transaction count of the\n * sender.\n * @custom:security-contact bugs@across.to\n */\ncontract PolygonTokenBridger is Lockable {\n using SafeERC20Upgradeable for PolygonIERC20Upgradeable;\n using SafeERC20Upgradeable for IERC20Upgradeable;\n\n // Gas token for Polygon.\n MaticToken public constant MATIC = MaticToken(0x0000000000000000000000000000000000001010);\n\n // Should be set to HubPool on Ethereum, or unused on Polygon.\n address public immutable destination;\n\n // Registry that stores L1 polygon addresses.\n PolygonRegistry public immutable l1PolygonRegistry;\n\n // WETH contract on Ethereum.\n WETH9Interface public immutable l1Weth;\n\n // Wrapped Matic on Polygon\n address public immutable l2WrappedMatic;\n\n // Chain id for the L1 that this contract is deployed on or communicates with.\n // For example: if this contract were meant to facilitate transfers from polygon to mainnet, this value would be\n // the mainnet chainId 1.\n uint256 public immutable l1ChainId;\n\n // Chain id for the L2 that this contract is deployed on or communicates with.\n // For example: if this contract were meant to facilitate transfers from polygon to mainnet, this value would be\n // the polygon chainId 137.\n uint256 public immutable l2ChainId;\n\n modifier onlyChainId(uint256 chainId) {\n _requireChainId(chainId);\n _;\n }\n\n /**\n * @notice Constructs Token Bridger contract.\n * @param _destination Where to send tokens to for this network.\n * @param _l1PolygonRegistry L1 registry that stores updated addresses of polygon contracts. This should always be\n * set to the L1 registry regardless if whether it's deployed on L2 or L1.\n * @param _l1Weth L1 WETH address.\n * @param _l2WrappedMatic L2 address of wrapped matic token.\n * @param _l1ChainId the chain id for the L1 in this environment.\n * @param _l2ChainId the chain id for the L2 in this environment.\n */\n constructor(\n address _destination,\n PolygonRegistry _l1PolygonRegistry,\n WETH9Interface _l1Weth,\n address _l2WrappedMatic,\n uint256 _l1ChainId,\n uint256 _l2ChainId\n ) {\n //slither-disable-next-line missing-zero-check\n destination = _destination;\n l1PolygonRegistry = _l1PolygonRegistry;\n l1Weth = _l1Weth;\n //slither-disable-next-line missing-zero-check\n l2WrappedMatic = _l2WrappedMatic;\n l1ChainId = _l1ChainId;\n l2ChainId = _l2ChainId;\n }\n\n /**\n * @notice Called by Polygon SpokePool to send tokens over bridge to contract with the same address as this.\n * @notice The caller of this function must approve this contract to spend amount of token.\n * @param token Token to bridge.\n * @param amount Amount to bridge.\n */\n function send(PolygonIERC20Upgradeable token, uint256 amount) public nonReentrant onlyChainId(l2ChainId) {\n token.safeTransferFrom(msg.sender, address(this), amount);\n\n // In the wMatic case, this unwraps. For other ERC20s, this is the burn/send action.\n token.withdraw(token.balanceOf(address(this)));\n\n // This takes the token that was withdrawn and calls withdraw on the \"native\" ERC20.\n if (address(token) == l2WrappedMatic) MATIC.withdraw{ value: address(this).balance }(address(this).balance);\n }\n\n /**\n * @notice Called by someone to send tokens to the destination, which should be set to the HubPool.\n * @param token Token to send to destination.\n */\n function retrieve(IERC20Upgradeable token) public nonReentrant onlyChainId(l1ChainId) {\n if (address(token) == address(l1Weth)) {\n // For WETH, there is a pre-deposit step to ensure any ETH that has been sent to the contract is captured.\n //slither-disable-next-line arbitrary-send-eth\n l1Weth.deposit{ value: address(this).balance }();\n }\n token.safeTransfer(destination, token.balanceOf(address(this)));\n }\n\n /**\n * @notice Called to initiate an l1 exit (withdrawal) of matic tokens that have been sent over the plasma bridge.\n * @param data the proof data to trigger the exit. Can be generated using the maticjs-plasma package.\n */\n function callExit(bytes memory data) public nonReentrant onlyChainId(l1ChainId) {\n PolygonERC20Predicate erc20Predicate = PolygonERC20Predicate(l1PolygonRegistry.erc20Predicate());\n erc20Predicate.startExitWithBurntTokens(data);\n }\n\n receive() external payable {\n // This method is empty to avoid any gas expendatures that might cause transfers to fail.\n // Note: the fact that there is _no_ code in this function means that matic can be erroneously transferred in\n // to the contract on the polygon side. These tokens would be locked indefinitely since the receive function\n // cannot be called on the polygon side. While this does have some downsides, the lack of any functionality\n // in this function means that it has no chance of running out of gas on transfers, which is a much more\n // important benefit. This just makes the matic token risk similar to that of ERC20s that are erroneously\n // sent to the contract.\n }\n\n function _requireChainId(uint256 chainId) internal view {\n require(block.chainid == chainId, \"Cannot run method on this chain\");\n }\n}\n"
+ },
+ "contracts/SpokePool.sol": {
+ "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\n\nimport \"./MerkleLib.sol\";\nimport \"./erc7683/ERC7683.sol\";\nimport \"./erc7683/ERC7683Permit2Lib.sol\";\nimport \"./external/interfaces/WETH9Interface.sol\";\nimport \"./interfaces/SpokePoolMessageHandler.sol\";\nimport \"./interfaces/SpokePoolInterface.sol\";\nimport \"./interfaces/V3SpokePoolInterface.sol\";\nimport \"./upgradeable/MultiCallerUpgradeable.sol\";\nimport \"./upgradeable/EIP712CrossChainUpgradeable.sol\";\nimport \"./upgradeable/AddressLibUpgradeable.sol\";\nimport \"./libraries/AddressConverters.sol\";\n\nimport \"@openzeppelin/contracts-upgradeable/token/ERC20/IERC20Upgradeable.sol\";\nimport \"@openzeppelin/contracts-upgradeable/token/ERC20/utils/SafeERC20Upgradeable.sol\";\nimport \"@openzeppelin/contracts/utils/cryptography/SignatureChecker.sol\";\nimport \"@openzeppelin/contracts-upgradeable/proxy/utils/UUPSUpgradeable.sol\";\nimport \"@openzeppelin/contracts-upgradeable/security/ReentrancyGuardUpgradeable.sol\";\nimport \"@openzeppelin/contracts/utils/math/SignedMath.sol\";\n\n/**\n * @title SpokePool\n * @notice Base contract deployed on source and destination chains enabling depositors to transfer assets from source to\n * destination. Deposit orders are fulfilled by off-chain relayers who also interact with this contract. Deposited\n * tokens are locked on the source chain and relayers send the recipient the desired token currency and amount\n * on the destination chain. Locked source chain tokens are later sent over the canonical token bridge to L1 HubPool.\n * Relayers are refunded with destination tokens out of this contract after another off-chain actor, a \"data worker\",\n * submits a proof that the relayer correctly submitted a relay on this SpokePool.\n * @custom:security-contact bugs@across.to\n */\nabstract contract SpokePool is\n V3SpokePoolInterface,\n SpokePoolInterface,\n UUPSUpgradeable,\n ReentrancyGuardUpgradeable,\n MultiCallerUpgradeable,\n EIP712CrossChainUpgradeable,\n IDestinationSettler\n{\n using SafeERC20Upgradeable for IERC20Upgradeable;\n using AddressLibUpgradeable for address;\n using Bytes32ToAddress for bytes32;\n using AddressToBytes32 for address;\n\n // Address of the L1 contract that acts as the owner of this SpokePool. This should normally be set to the HubPool\n // address. The crossDomainAdmin address is unused when the SpokePool is deployed to the same chain as the HubPool.\n address public crossDomainAdmin;\n\n // Address of the L1 contract that will send tokens to and receive tokens from this contract to fund relayer\n // refunds and slow relays.\n address public withdrawalRecipient;\n\n // Note: The following two storage variables prefixed with DEPRECATED used to be variables that could be set by\n // the cross-domain admin. Admins ended up not changing these in production, so to reduce\n // gas in deposit/fill functions, we are converting them to private variables to maintain the contract\n // storage layout and replacing them with immutable or constant variables, because retrieving a constant\n // value is cheaper than retrieving a storage variable. Please see out the immutable/constant variable section.\n WETH9Interface private DEPRECATED_wrappedNativeToken;\n uint32 private DEPRECATED_depositQuoteTimeBuffer;\n\n // `numberOfDeposits` acts as a counter to generate unique deposit identifiers for this spoke pool.\n // It is a uint32 that increments with each `depositV3` call. In the `FundsDeposited` event, it is\n // implicitly cast to uint256 by setting its most significant bits to 0, reducing the risk of ID collisions\n // with unsafe deposits. However, this variable's name could be improved (e.g., `depositNonceCounter`)\n // since it does not accurately reflect the total number of deposits, as `unsafeDeposit` can bypass this increment.\n uint32 public numberOfDeposits;\n\n // Whether deposits and fills are disabled.\n bool public pausedFills;\n bool public pausedDeposits;\n\n // This contract can store as many root bundles as the HubPool chooses to publish here.\n RootBundle[] public rootBundles;\n\n // Origin token to destination token routings can be turned on or off, which can enable or disable deposits.\n mapping(address => mapping(uint256 => bool)) private DEPRECATED_enabledDepositRoutes;\n\n // Each relay is associated with the hash of parameters that uniquely identify the original deposit and a relay\n // attempt for that deposit. The relay itself is just represented as the amount filled so far. The total amount to\n // relay, the fees, and the agents are all parameters included in the hash key.\n mapping(bytes32 => uint256) private DEPRECATED_relayFills;\n\n // Note: We will likely un-deprecate the fill and deposit counters to implement a better\n // dynamic LP fee mechanism but for now we'll deprecate it to reduce bytecode\n // in deposit/fill functions. These counters are designed to implement a fee mechanism that is based on a\n // canonical history of deposit and fill events and how they update a virtual running balance of liabilities and\n // assets, which then determines the LP fee charged to relays.\n\n // This keeps track of the worst-case liabilities due to fills.\n // It is never reset. Users should only rely on it to determine the worst-case increase in liabilities between\n // two points. This is used to provide frontrunning protection to ensure the relayer's assumptions about the state\n // upon which their expected repayments are based will not change before their transaction is mined.\n mapping(address => uint256) private DEPRECATED_fillCounter;\n\n // This keeps track of the total running deposits for each token. This allows depositors to protect themselves from\n // frontrunning that might change their worst-case quote.\n mapping(address => uint256) private DEPRECATED_depositCounter;\n\n // This tracks the number of identical refunds that have been requested.\n // The intention is to allow an off-chain system to know when this could be a duplicate and ensure that the other\n // requests are known and accounted for.\n mapping(bytes32 => uint256) private DEPRECATED_refundsRequested;\n\n // Mapping of V3 relay hashes to fill statuses. Distinguished from relayFills\n // to eliminate any chance of collision between pre and post V3 relay hashes.\n mapping(bytes32 => uint256) public fillStatuses;\n\n // Mapping of L2TokenAddress to relayer to outstanding refund amount. Used when a relayer repayment fails for some\n // reason (eg blacklist) to track their outstanding liability, thereby letting them claim it later.\n mapping(address => mapping(address => uint256)) public relayerRefund;\n\n /**************************************************************\n * CONSTANT/IMMUTABLE VARIABLES *\n **************************************************************/\n // Constant and immutable variables do not take up storage slots and are instead added to the contract bytecode\n // at compile time. The difference between them is that constant variables must be declared inline, meaning\n // that they cannot be changed in production without changing the contract code, while immutable variables\n // can be set in the constructor. Therefore we use the immutable keyword for variables that we might want to be\n // different for each child contract (one obvious example of this is the wrappedNativeToken) or that we might\n // want to update in the future like depositQuoteTimeBuffer. Constants are unlikely to ever be changed.\n\n // Address of wrappedNativeToken contract for this network. If an origin token matches this, then the caller can\n // optionally instruct this contract to wrap native tokens when depositing (ie ETH->WETH or MATIC->WMATIC).\n /// @custom:oz-upgrades-unsafe-allow state-variable-immutable\n WETH9Interface public immutable wrappedNativeToken;\n\n // Any deposit quote times greater than or less than this value to the current contract time is blocked. Forces\n // caller to use an approximately \"current\" realized fee.\n /// @custom:oz-upgrades-unsafe-allow state-variable-immutable\n uint32 public immutable depositQuoteTimeBuffer;\n\n // The fill deadline can only be set this far into the future from the timestamp of the deposit on this contract.\n /// @custom:oz-upgrades-unsafe-allow state-variable-immutable\n uint32 public immutable fillDeadlineBuffer;\n\n uint256 public constant MAX_TRANSFER_SIZE = 1e36;\n\n bytes32 public constant UPDATE_BYTES32_DEPOSIT_DETAILS_HASH =\n keccak256(\n \"UpdateDepositDetails(uint256 depositId,uint256 originChainId,uint256 updatedOutputAmount,bytes32 updatedRecipient,bytes updatedMessage)\"\n );\n // Default chain Id used to signify that no repayment is requested, for example when executing a slow fill.\n uint256 public constant EMPTY_REPAYMENT_CHAIN_ID = 0;\n // Default address used to signify that no relayer should be credited with a refund, for example\n // when executing a slow fill.\n bytes32 public constant EMPTY_RELAYER = bytes32(0);\n // This is the magic value that signals to the off-chain validator\n // that this deposit can never expire. A deposit with this fill deadline should always be eligible for a\n // slow fill, meaning that its output token and input token must be \"equivalent\". Therefore, this value is only\n // used as a fillDeadline in deposit(), a soon to be deprecated function that also hardcodes outputToken to\n // the zero address, which forces the off-chain validator to replace the output token with the equivalent\n // token for the input token. By using this magic value, off-chain validators do not have to keep\n // this event in their lookback window when querying for expired deposits.\n uint32 public constant INFINITE_FILL_DEADLINE = type(uint32).max;\n\n // One year in seconds. If `exclusivityParameter` is set to a value less than this, then the emitted\n // exclusivityDeadline in a deposit event will be set to the current time plus this value.\n uint32 public constant MAX_EXCLUSIVITY_PERIOD_SECONDS = 31_536_000;\n /****************************************\n * EVENTS *\n ****************************************/\n event SetXDomainAdmin(address indexed newAdmin);\n event SetWithdrawalRecipient(address indexed newWithdrawalRecipient);\n event EnabledDepositRoute(address indexed originToken, uint256 indexed destinationChainId, bool enabled);\n event RelayedRootBundle(\n uint32 indexed rootBundleId,\n bytes32 indexed relayerRefundRoot,\n bytes32 indexed slowRelayRoot\n );\n event ExecutedRelayerRefundRoot(\n uint256 amountToReturn,\n uint256 indexed chainId,\n uint256[] refundAmounts,\n uint32 indexed rootBundleId,\n uint32 indexed leafId,\n address l2TokenAddress,\n address[] refundAddresses,\n bool deferredRefunds,\n address caller\n );\n event TokensBridged(\n uint256 amountToReturn,\n uint256 indexed chainId,\n uint32 indexed leafId,\n bytes32 indexed l2TokenAddress,\n address caller\n );\n event EmergencyDeletedRootBundle(uint256 indexed rootBundleId);\n event PausedDeposits(bool isPaused);\n event PausedFills(bool isPaused);\n\n /**\n * @notice Construct the SpokePool. Normally, logic contracts used in upgradeable proxies shouldn't\n * have constructors since the following code will be executed within the logic contract's state, not the\n * proxy contract's state. However, if we restrict the constructor to setting only immutable variables, then\n * we are safe because immutable variables are included in the logic contract's bytecode rather than its storage.\n * @dev Do not leave an implementation contract uninitialized. An uninitialized implementation contract can be\n * taken over by an attacker, which may impact the proxy. To prevent the implementation contract from being\n * used, you should invoke the _disableInitializers function in the constructor to automatically lock it when\n * it is deployed:\n * @param _wrappedNativeTokenAddress wrappedNativeToken address for this network to set.\n * @param _depositQuoteTimeBuffer depositQuoteTimeBuffer to set. Quote timestamps can't be set more than this amount\n * into the past from the block time of the deposit.\n * @param _fillDeadlineBuffer fillDeadlineBuffer to set. Fill deadlines can't be set more than this amount\n * into the future from the block time of the deposit.\n */\n /// @custom:oz-upgrades-unsafe-allow constructor\n constructor(\n address _wrappedNativeTokenAddress,\n uint32 _depositQuoteTimeBuffer,\n uint32 _fillDeadlineBuffer\n ) {\n wrappedNativeToken = WETH9Interface(_wrappedNativeTokenAddress);\n depositQuoteTimeBuffer = _depositQuoteTimeBuffer;\n fillDeadlineBuffer = _fillDeadlineBuffer;\n _disableInitializers();\n }\n\n /**\n * @notice Construct the base SpokePool.\n * @param _initialDepositId Starting deposit ID. Set to 0 unless this is a re-deployment in order to mitigate\n * relay hash collisions.\n * @param _crossDomainAdmin Cross domain admin to set. Can be changed by admin.\n * @param _withdrawalRecipient Address which receives token withdrawals. Can be changed by admin. For Spoke Pools on L2, this will\n * likely be the hub pool.\n */\n function __SpokePool_init(\n uint32 _initialDepositId,\n address _crossDomainAdmin,\n address _withdrawalRecipient\n ) public onlyInitializing {\n numberOfDeposits = _initialDepositId;\n __EIP712_init(\"ACROSS-V2\", \"1.0.0\");\n __UUPSUpgradeable_init();\n __ReentrancyGuard_init();\n _setCrossDomainAdmin(_crossDomainAdmin);\n _setWithdrawalRecipient(_withdrawalRecipient);\n }\n\n /****************************************\n * MODIFIERS *\n ****************************************/\n\n /**\n * @dev Function that should revert when `msg.sender` is not authorized to upgrade the contract. Called by\n * {upgradeTo} and {upgradeToAndCall}.\n * @dev This should be set to cross domain admin for specific SpokePool.\n */\n modifier onlyAdmin() {\n _requireAdminSender();\n _;\n }\n\n modifier unpausedDeposits() {\n if (pausedDeposits) revert DepositsArePaused();\n _;\n }\n\n modifier unpausedFills() {\n if (pausedFills) revert FillsArePaused();\n _;\n }\n\n /**************************************\n * ADMIN FUNCTIONS *\n **************************************/\n\n // Allows cross domain admin to upgrade UUPS proxy implementation.\n function _authorizeUpgrade(address newImplementation) internal override onlyAdmin {}\n\n /**\n * @notice Pauses deposit-related functions. This is intended to be used if this contract is deprecated or when\n * something goes awry.\n * @dev Affects `deposit()` but not `speedUpDeposit()`, so that existing deposits can be sped up and still\n * relayed.\n * @param pause true if the call is meant to pause the system, false if the call is meant to unpause it.\n */\n function pauseDeposits(bool pause) public override onlyAdmin nonReentrant {\n pausedDeposits = pause;\n emit PausedDeposits(pause);\n }\n\n /**\n * @notice Pauses fill-related functions. This is intended to be used if this contract is deprecated or when\n * something goes awry.\n * @dev Affects fillRelayWithUpdatedDeposit() and fillRelay().\n * @param pause true if the call is meant to pause the system, false if the call is meant to unpause it.\n */\n function pauseFills(bool pause) public override onlyAdmin nonReentrant {\n pausedFills = pause;\n emit PausedFills(pause);\n }\n\n /**\n * @notice Change cross domain admin address. Callable by admin only.\n * @param newCrossDomainAdmin New cross domain admin.\n */\n function setCrossDomainAdmin(address newCrossDomainAdmin) public override onlyAdmin nonReentrant {\n _setCrossDomainAdmin(newCrossDomainAdmin);\n }\n\n /**\n * @notice Change L1 withdrawal recipient address. Callable by admin only.\n * @param newWithdrawalRecipient New withdrawal recipient address.\n */\n function setWithdrawalRecipient(address newWithdrawalRecipient) public override onlyAdmin nonReentrant {\n _setWithdrawalRecipient(newWithdrawalRecipient);\n }\n\n /**\n * @notice This method stores a new root bundle in this contract that can be executed to refund relayers, fulfill\n * slow relays, and send funds back to the HubPool on L1. This method can only be called by the admin and is\n * designed to be called as part of a cross-chain message from the HubPool's executeRootBundle method.\n * @param relayerRefundRoot Merkle root containing relayer refund leaves that can be individually executed via\n * executeRelayerRefundLeaf().\n * @param slowRelayRoot Merkle root containing slow relay fulfillment leaves that can be individually executed via\n * executeSlowRelayLeaf().\n */\n function relayRootBundle(bytes32 relayerRefundRoot, bytes32 slowRelayRoot) public override onlyAdmin nonReentrant {\n uint32 rootBundleId = uint32(rootBundles.length);\n RootBundle storage rootBundle = rootBundles.push();\n rootBundle.relayerRefundRoot = relayerRefundRoot;\n rootBundle.slowRelayRoot = slowRelayRoot;\n emit RelayedRootBundle(rootBundleId, relayerRefundRoot, slowRelayRoot);\n }\n\n /**\n * @notice This method is intended to only be used in emergencies where a bad root bundle has reached the\n * SpokePool.\n * @param rootBundleId Index of the root bundle that needs to be deleted. Note: this is intentionally a uint256\n * to ensure that a small input range doesn't limit which indices this method is able to reach.\n */\n function emergencyDeleteRootBundle(uint256 rootBundleId) public override onlyAdmin nonReentrant {\n // Deleting a struct containing a mapping does not delete the mapping in Solidity, therefore the bitmap's\n // data will still remain potentially leading to vulnerabilities down the line. The way around this would\n // be to iterate through every key in the mapping and resetting the value to 0, but this seems expensive and\n // would require a new list in storage to keep track of keys.\n //slither-disable-next-line mapping-deletion\n delete rootBundles[rootBundleId];\n emit EmergencyDeletedRootBundle(rootBundleId);\n }\n\n /**************************************\n * LEGACY DEPOSITOR FUNCTIONS *\n **************************************/\n\n /**\n * @dev DEPRECATION NOTICE: this function is deprecated and will be removed in the future.\n * Please use deposit (under DEPOSITOR FUNCTIONS below) or depositV3 instead.\n * @notice Called by user to bridge funds from origin to destination chain. Depositor will effectively lock\n * tokens in this contract and receive a destination token on the destination chain. The origin => destination\n * token mapping is stored on the L1 HubPool.\n * @notice The caller must first approve this contract to spend amount of originToken.\n * @notice The originToken => destinationChainId must be enabled.\n * @notice This method is payable because the caller is able to deposit native token if the originToken is\n * wrappedNativeToken and this function will handle wrapping the native token to wrappedNativeToken.\n * @dev Produces a FundsDeposited event with an infinite expiry, meaning that this deposit can never expire.\n * Moreover, the event's outputToken is set to 0x0 meaning that this deposit can always be slow filled.\n * @param recipient Address to receive funds at on destination chain.\n * @param originToken Token to lock into this contract to initiate deposit.\n * @param amount Amount of tokens to deposit. Will be amount of tokens to receive less fees.\n * @param destinationChainId Denotes network where user will receive funds from SpokePool by a relayer.\n * @param relayerFeePct % of deposit amount taken out to incentivize a fast relayer.\n * @param quoteTimestamp Timestamp used by relayers to compute this deposit's realizedLPFeePct which is paid\n * to LP pool on HubPool.\n * @param message Arbitrary data that can be used to pass additional information to the recipient along with the tokens.\n * Note: this is intended to be used to pass along instructions for how a contract should use or allocate the tokens.\n */\n function depositDeprecated_5947912356(\n address recipient,\n address originToken,\n uint256 amount,\n uint256 destinationChainId,\n int64 relayerFeePct,\n uint32 quoteTimestamp,\n bytes memory message,\n uint256 // maxCount. Deprecated.\n ) public payable nonReentrant unpausedDeposits {\n _deposit(\n msg.sender,\n recipient,\n originToken,\n amount,\n destinationChainId,\n relayerFeePct,\n quoteTimestamp,\n message\n );\n }\n\n /**\n * @dev DEPRECATION NOTICE: this function is deprecated and will be removed in the future.\n * Please use the other deposit or depositV3 instead.\n * @notice The only difference between depositFor and deposit is that the depositor address stored\n * in the relay hash can be overridden by the caller. This means that the passed in depositor\n * can speed up the deposit, which is useful if the deposit is taken from the end user to a middle layer\n * contract, like an aggregator or the SpokePoolVerifier, before calling deposit on this contract.\n * @notice The caller must first approve this contract to spend amount of originToken.\n * @notice The originToken => destinationChainId must be enabled.\n * @notice This method is payable because the caller is able to deposit native token if the originToken is\n * wrappedNativeToken and this function will handle wrapping the native token to wrappedNativeToken.\n * @param depositor Address who is credited for depositing funds on origin chain and can speed up the deposit.\n * @param recipient Address to receive funds at on destination chain.\n * @param originToken Token to lock into this contract to initiate deposit.\n * @param amount Amount of tokens to deposit. Will be amount of tokens to receive less fees.\n * @param destinationChainId Denotes network where user will receive funds from SpokePool by a relayer.\n * @param relayerFeePct % of deposit amount taken out to incentivize a fast relayer.\n * @param quoteTimestamp Timestamp used by relayers to compute this deposit's realizedLPFeePct which is paid\n * to LP pool on HubPool.\n * @param message Arbitrary data that can be used to pass additional information to the recipient along with the tokens.\n * Note: this is intended to be used to pass along instructions for how a contract should use or allocate the tokens.\n */\n function depositFor(\n address depositor,\n address recipient,\n address originToken,\n uint256 amount,\n uint256 destinationChainId,\n int64 relayerFeePct,\n uint32 quoteTimestamp,\n bytes memory message,\n uint256 // maxCount. Deprecated.\n ) public payable nonReentrant unpausedDeposits {\n _deposit(depositor, recipient, originToken, amount, destinationChainId, relayerFeePct, quoteTimestamp, message);\n }\n\n /********************************************\n * DEPOSITOR FUNCTIONS *\n ********************************************/\n\n /**\n * @notice Previously, this function allowed the caller to specify the exclusivityDeadline, otherwise known as the\n * as exact timestamp on the destination chain before which only the exclusiveRelayer could fill the deposit. Now,\n * the caller is expected to pass in a number that will be interpreted either as an offset or a fixed\n * timestamp depending on its value.\n * @notice Request to bridge input token cross chain to a destination chain and receive a specified amount\n * of output tokens. The fee paid to relayers and the system should be captured in the spread between output\n * amount and input amount when adjusted to be denominated in the input token. A relayer on the destination\n * chain will send outputAmount of outputTokens to the recipient and receive inputTokens on a repayment\n * chain of their choice. Therefore, the fee should account for destination fee transaction costs,\n * the relayer's opportunity cost of capital while they wait to be refunded following an optimistic challenge\n * window in the HubPool, and the system fee that they'll be charged.\n * @dev On the destination chain, the hash of the deposit data will be used to uniquely identify this deposit, so\n * modifying any params in it will result in a different hash and a different deposit. The hash will comprise\n * all parameters to this function along with this chain's chainId(). Relayers are only refunded for filling\n * deposits with deposit hashes that map exactly to the one emitted by this contract.\n * @param depositor The account credited with the deposit who can request to \"speed up\" this deposit by modifying\n * the output amount, recipient, and message.\n * @param recipient The account receiving funds on the destination chain. Can be an EOA or a contract. If\n * the output token is the wrapped native token for the chain, then the recipient will receive native token if\n * an EOA or wrapped native token if a contract.\n * @param inputToken The token pulled from the caller's account and locked into this contract to\n * initiate the deposit. The equivalent of this token on the relayer's repayment chain of choice will be sent\n * as a refund. If this is equal to the wrapped native token then the caller can optionally pass in native token as\n * msg.value, as long as msg.value = inputTokenAmount.\n * @param outputToken The token that the relayer will send to the recipient on the destination chain. Must be an\n * ERC20.\n * @param inputAmount The amount of input tokens to pull from the caller's account and lock into this contract.\n * This amount will be sent to the relayer on their repayment chain of choice as a refund following an optimistic\n * challenge window in the HubPool, less a system fee.\n * @param outputAmount The amount of output tokens that the relayer will send to the recipient on the destination.\n * @param destinationChainId The destination chain identifier. Must be enabled along with the input token\n * as a valid deposit route from this spoke pool or this transaction will revert.\n * @param exclusiveRelayer The relayer that will be exclusively allowed to fill this deposit before the\n * exclusivity deadline timestamp. This must be a valid, non-zero address if the exclusivity deadline is\n * greater than the current block.timestamp. If the exclusivity deadline is < currentTime, then this must be\n * address(0), and vice versa if this is address(0).\n * @param quoteTimestamp The HubPool timestamp that is used to determine the system fee paid by the depositor.\n * This must be set to some time between [currentTime - depositQuoteTimeBuffer, currentTime]\n * where currentTime is block.timestamp on this chain or this transaction will revert.\n * @param fillDeadline The deadline for the relayer to fill the deposit. After this destination chain timestamp,\n * the fill will revert on the destination chain. Must be set before currentTime + fillDeadlineBuffer, where\n * currentTime is block.timestamp on this chain or this transaction will revert.\n * @param exclusivityParameter This value is used to set the exclusivity deadline timestamp in the emitted deposit\n * event. Before this destination chain timestamp, only the exclusiveRelayer (if set to a non-zero address),\n * can fill this deposit. There are three ways to use this parameter:\n * 1. NO EXCLUSIVITY: If this value is set to 0, then a timestamp of 0 will be emitted,\n * meaning that there is no exclusivity period.\n * 2. OFFSET: If this value is less than MAX_EXCLUSIVITY_PERIOD_SECONDS, then add this value to\n * the block.timestamp to derive the exclusive relayer deadline. Note that using the parameter in this way\n * will expose the filler of the deposit to the risk that the block.timestamp of this event gets changed\n * due to a chain-reorg, which would also change the exclusivity timestamp.\n * 3. TIMESTAMP: Otherwise, set this value as the exclusivity deadline timestamp.\n * which is the deadline for the exclusiveRelayer to fill the deposit.\n * @param message The message to send to the recipient on the destination chain if the recipient is a contract.\n * If the message is not empty, the recipient contract must implement handleV3AcrossMessage() or the fill will revert.\n */\n function deposit(\n bytes32 depositor,\n bytes32 recipient,\n bytes32 inputToken,\n bytes32 outputToken,\n uint256 inputAmount,\n uint256 outputAmount,\n uint256 destinationChainId,\n bytes32 exclusiveRelayer,\n uint32 quoteTimestamp,\n uint32 fillDeadline,\n uint32 exclusivityParameter,\n bytes calldata message\n ) public payable override nonReentrant unpausedDeposits {\n // Increment the `numberOfDeposits` counter to ensure a unique deposit ID for this spoke pool.\n DepositV3Params memory params = DepositV3Params({\n depositor: depositor,\n recipient: recipient,\n inputToken: inputToken,\n outputToken: outputToken,\n inputAmount: inputAmount,\n outputAmount: outputAmount,\n destinationChainId: destinationChainId,\n exclusiveRelayer: exclusiveRelayer,\n depositId: numberOfDeposits++,\n quoteTimestamp: quoteTimestamp,\n fillDeadline: fillDeadline,\n exclusivityParameter: exclusivityParameter,\n message: message\n });\n _depositV3(params);\n }\n\n /**\n * @notice A version of `deposit` that accepts `address` types for backward compatibility.\n * This function allows bridging of input tokens cross-chain to a destination chain, receiving a specified amount of output tokens.\n * The relayer is refunded in input tokens on a repayment chain of their choice, minus system fees, after an optimistic challenge\n * window. The exclusivity period is specified as an offset from the current block timestamp.\n *\n * @dev This version mirrors the original `depositV3` function, but uses `address` types for `depositor`, `recipient`,\n * `inputToken`, `outputToken`, and `exclusiveRelayer` for compatibility with contracts using the `address` type.\n *\n * The key functionality and logic remain identical, ensuring interoperability across both versions.\n *\n * @param depositor The account credited with the deposit who can request to \"speed up\" this deposit by modifying\n * the output amount, recipient, and message.\n * @param recipient The account receiving funds on the destination chain. Can be an EOA or a contract. If\n * the output token is the wrapped native token for the chain, then the recipient will receive native token if\n * an EOA or wrapped native token if a contract.\n * @param inputToken The token pulled from the caller's account and locked into this contract to initiate the deposit.\n * The equivalent of this token on the relayer's repayment chain of choice will be sent as a refund. If this is equal\n * to the wrapped native token, the caller can optionally pass in native token as msg.value, provided msg.value = inputTokenAmount.\n * @param outputToken The token that the relayer will send to the recipient on the destination chain. Must be an ERC20.\n * @param inputAmount The amount of input tokens pulled from the caller's account and locked into this contract. This\n * amount will be sent to the relayer as a refund following an optimistic challenge window in the HubPool, less a system fee.\n * @param outputAmount The amount of output tokens that the relayer will send to the recipient on the destination.\n * @param destinationChainId The destination chain identifier. Must be enabled along with the input token as a valid\n * deposit route from this spoke pool or this transaction will revert.\n * @param exclusiveRelayer The relayer exclusively allowed to fill this deposit before the exclusivity deadline.\n * @param quoteTimestamp The HubPool timestamp that determines the system fee paid by the depositor. This must be set\n * between [currentTime - depositQuoteTimeBuffer, currentTime] where currentTime is block.timestamp on this chain.\n * @param fillDeadline The deadline for the relayer to fill the deposit. After this destination chain timestamp, the fill will\n * revert on the destination chain. Must be set before currentTime + fillDeadlineBuffer, where currentTime is block.timestamp\n * on this chain.\n * @param exclusivityParameter This value is used to set the exclusivity deadline timestamp in the emitted deposit\n * event. Before this destination chain timestamp, only the exclusiveRelayer (if set to a non-zero address),\n * can fill this deposit. There are three ways to use this parameter:\n * 1. NO EXCLUSIVITY: If this value is set to 0, then a timestamp of 0 will be emitted,\n * meaning that there is no exclusivity period.\n * 2. OFFSET: If this value is less than MAX_EXCLUSIVITY_PERIOD_SECONDS, then add this value to\n * the block.timestamp to derive the exclusive relayer deadline. Note that using the parameter in this way\n * will expose the filler of the deposit to the risk that the block.timestamp of this event gets changed\n * due to a chain-reorg, which would also change the exclusivity timestamp.\n * 3. TIMESTAMP: Otherwise, set this value as the exclusivity deadline timestamp.\n * which is the deadline for the exclusiveRelayer to fill the deposit.\n * @param message The message to send to the recipient on the destination chain if the recipient is a contract. If the\n * message is not empty, the recipient contract must implement `handleV3AcrossMessage()` or the fill will revert.\n */\n function depositV3(\n address depositor,\n address recipient,\n address inputToken,\n address outputToken,\n uint256 inputAmount,\n uint256 outputAmount,\n uint256 destinationChainId,\n address exclusiveRelayer,\n uint32 quoteTimestamp,\n uint32 fillDeadline,\n uint32 exclusivityParameter,\n bytes calldata message\n ) public payable override {\n deposit(\n depositor.toBytes32(),\n recipient.toBytes32(),\n inputToken.toBytes32(),\n outputToken.toBytes32(),\n inputAmount,\n outputAmount,\n destinationChainId,\n exclusiveRelayer.toBytes32(),\n quoteTimestamp,\n fillDeadline,\n exclusivityParameter,\n message\n );\n }\n\n /**\n * @notice See deposit for details. This function is identical to deposit except that it does not use the\n * global deposit ID counter as a deposit nonce, instead allowing the caller to pass in a deposit nonce. This\n * function is designed to be used by anyone who wants to pre-compute their resultant relay data hash, which\n * could be useful for filling a deposit faster and avoiding any risk of a relay hash unexpectedly changing\n * due to another deposit front-running this one and incrementing the global deposit ID counter.\n * @dev This is labeled \"unsafe\" because there is no guarantee that the depositId emitted in the resultant\n * FundsDeposited event is unique which means that the\n * corresponding fill might collide with an existing relay hash on the destination chain SpokePool,\n * which would make this deposit unfillable. In this case, the depositor would subsequently receive a refund\n * of `inputAmount` of `inputToken` on the origin chain after the fill deadline. Re-using a depositNonce is very\n * dangerous when combined with `speedUpDeposit`, as a speed up signature can be re-used for any deposits\n * with the same deposit ID.\n * @dev On the destination chain, the hash of the deposit data will be used to uniquely identify this deposit, so\n * modifying any params in it will result in a different hash and a different deposit. The hash will comprise\n * all parameters to this function along with this chain's chainId(). Relayers are only refunded for filling\n * deposits with deposit hashes that map exactly to the one emitted by this contract.\n * @param depositNonce The nonce that uniquely identifies this deposit. This function will combine this parameter\n * with the msg.sender address to create a unique uint256 depositNonce and ensure that the msg.sender cannot\n * use this function to front-run another depositor's unsafe deposit. This function guarantees that the resultant\n * deposit nonce will not collide with a safe uint256 deposit nonce whose 24 most significant bytes are always 0.\n * @param depositor See identically named parameter in depositV3() comments.\n * @param recipient See identically named parameter in depositV3() comments.\n * @param inputToken See identically named parameter in depositV3() comments.\n * @param outputToken See identically named parameter in depositV3() comments.\n * @param inputAmount See identically named parameter in depositV3() comments.\n * @param outputAmount See identically named parameter in depositV3() comments.\n * @param destinationChainId See identically named parameter in depositV3() comments.\n * @param exclusiveRelayer See identically named parameter in depositV3() comments.\n * @param quoteTimestamp See identically named parameter in depositV3() comments.\n * @param fillDeadline See identically named parameter in depositV3() comments.\n * @param exclusivityParameter See identically named parameter in depositV3() comments.\n * @param message See identically named parameter in depositV3() comments.\n */\n function unsafeDeposit(\n bytes32 depositor,\n bytes32 recipient,\n bytes32 inputToken,\n bytes32 outputToken,\n uint256 inputAmount,\n uint256 outputAmount,\n uint256 destinationChainId,\n bytes32 exclusiveRelayer,\n uint256 depositNonce,\n uint32 quoteTimestamp,\n uint32 fillDeadline,\n uint32 exclusivityParameter,\n bytes calldata message\n ) public payable nonReentrant unpausedDeposits {\n // @dev Create the uint256 deposit ID by concatenating the msg.sender and depositor address with the inputted\n // depositNonce parameter. The resultant 32 byte string will be hashed and then casted to an \"unsafe\"\n // uint256 deposit ID. The probability that the resultant ID collides with a \"safe\" deposit ID is\n // equal to the chance that the first 28 bytes of the hash are 0, which is too small for us to consider.\n\n uint256 depositId = getUnsafeDepositId(msg.sender, depositor, depositNonce);\n DepositV3Params memory params = DepositV3Params({\n depositor: depositor,\n recipient: recipient,\n inputToken: inputToken,\n outputToken: outputToken,\n inputAmount: inputAmount,\n outputAmount: outputAmount,\n destinationChainId: destinationChainId,\n exclusiveRelayer: exclusiveRelayer,\n depositId: depositId,\n quoteTimestamp: quoteTimestamp,\n fillDeadline: fillDeadline,\n exclusivityParameter: exclusivityParameter,\n message: message\n });\n _depositV3(params);\n }\n\n /**\n * @notice Submits deposit and sets quoteTimestamp to current Time. Sets fill and exclusivity\n * deadlines as offsets added to the current time. This function is designed to be called by users\n * such as Multisig contracts who do not have certainty when their transaction will mine.\n * @param depositor The account credited with the deposit who can request to \"speed up\" this deposit by modifying\n * the output amount, recipient, and message.\n * @param recipient The account receiving funds on the destination chain. Can be an EOA or a contract. If\n * the output token is the wrapped native token for the chain, then the recipient will receive native token if\n * an EOA or wrapped native token if a contract.\n * @param inputToken The token pulled from the caller's account and locked into this contract to\n * initiate the deposit. The equivalent of this token on the relayer's repayment chain of choice will be sent\n * as a refund. If this is equal to the wrapped native token then the caller can optionally pass in native token as\n * msg.value, as long as msg.value = inputTokenAmount.\n * @param outputToken The token that the relayer will send to the recipient on the destination chain. Must be an\n * ERC20.\n * @param inputAmount The amount of input tokens to pull from the caller's account and lock into this contract.\n * This amount will be sent to the relayer on their repayment chain of choice as a refund following an optimistic\n * challenge window in the HubPool, plus a system fee.\n * @param outputAmount The amount of output tokens that the relayer will send to the recipient on the destination.\n * @param destinationChainId The destination chain identifier. Must be enabled along with the input token\n * as a valid deposit route from this spoke pool or this transaction will revert.\n * @param exclusiveRelayer The relayer that will be exclusively allowed to fill this deposit before the\n * exclusivity deadline timestamp.\n * @param fillDeadlineOffset Added to the current time to set the fill deadline, which is the deadline for the\n * relayer to fill the deposit. After this destination chain timestamp, the fill will revert on the\n * destination chain.\n * @param exclusivityParameter See identically named parameter in deposit() comments.\n * @param message The message to send to the recipient on the destination chain if the recipient is a contract.\n * If the message is not empty, the recipient contract must implement handleV3AcrossMessage() or the fill will revert.\n */\n function depositNow(\n bytes32 depositor,\n bytes32 recipient,\n bytes32 inputToken,\n bytes32 outputToken,\n uint256 inputAmount,\n uint256 outputAmount,\n uint256 destinationChainId,\n bytes32 exclusiveRelayer,\n uint32 fillDeadlineOffset,\n uint32 exclusivityParameter,\n bytes calldata message\n ) external payable override {\n deposit(\n depositor,\n recipient,\n inputToken,\n outputToken,\n inputAmount,\n outputAmount,\n destinationChainId,\n exclusiveRelayer,\n uint32(getCurrentTime()),\n uint32(getCurrentTime()) + fillDeadlineOffset,\n exclusivityParameter,\n message\n );\n }\n\n /**\n * @notice A version of `depositNow` that supports addresses as input types for backward compatibility.\n * This function submits a deposit and sets `quoteTimestamp` to the current time. The `fill` and `exclusivity` deadlines\n * are set as offsets added to the current time. It is designed to be called by users, including Multisig contracts, who may\n * not have certainty when their transaction will be mined.\n *\n * @dev This version is identical to the original `depositV3Now` but uses `address` types for `depositor`, `recipient`,\n * `inputToken`, `outputToken`, and `exclusiveRelayer` to support compatibility with older systems.\n * It maintains the same logic and purpose, ensuring interoperability with both versions.\n *\n * @param depositor The account credited with the deposit, who can request to \"speed up\" this deposit by modifying\n * the output amount, recipient, and message.\n * @param recipient The account receiving funds on the destination chain. Can be an EOA or a contract. If\n * the output token is the wrapped native token for the chain, then the recipient will receive the native token if\n * an EOA or wrapped native token if a contract.\n * @param inputToken The token pulled from the caller's account and locked into this contract to initiate the deposit.\n * Equivalent tokens on the relayer's repayment chain will be sent as a refund. If this is the wrapped native token,\n * msg.value must equal inputTokenAmount when passed.\n * @param outputToken The token the relayer will send to the recipient on the destination chain. Must be an ERC20.\n * @param inputAmount The amount of input tokens pulled from the caller's account and locked into this contract.\n * This amount will be sent to the relayer as a refund following an optimistic challenge window in the HubPool, plus a system fee.\n * @param outputAmount The amount of output tokens the relayer will send to the recipient on the destination.\n * @param destinationChainId The destination chain identifier. Must be enabled with the input token as a valid deposit route\n * from this spoke pool, or the transaction will revert.\n * @param exclusiveRelayer The relayer exclusively allowed to fill the deposit before the exclusivity deadline.\n * @param fillDeadlineOffset Added to the current time to set the fill deadline. After this timestamp, fills on the\n * destination chain will revert.\n * @param exclusivityParameter See identically named parameter in deposit() comments.\n * @param message The message to send to the recipient on the destination chain. If the recipient is a contract, it must\n * implement `handleV3AcrossMessage()` if the message is not empty, or the fill will revert.\n */\n function depositV3Now(\n address depositor,\n address recipient,\n address inputToken,\n address outputToken,\n uint256 inputAmount,\n uint256 outputAmount,\n uint256 destinationChainId,\n address exclusiveRelayer,\n uint32 fillDeadlineOffset,\n uint32 exclusivityParameter,\n bytes calldata message\n ) external payable override {\n depositV3(\n depositor,\n recipient,\n inputToken,\n outputToken,\n inputAmount,\n outputAmount,\n destinationChainId,\n exclusiveRelayer,\n uint32(getCurrentTime()),\n uint32(getCurrentTime()) + fillDeadlineOffset,\n exclusivityParameter,\n message\n );\n }\n\n /**\n * @notice Depositor can use this function to signal to relayer to use updated output amount, recipient,\n * and/or message. The speed up signature uniquely identifies the speed up based only on\n * depositor, deposit ID and origin chain, so using this function in conjunction with unsafeDeposit is risky\n * due to the chance of repeating a deposit ID.\n * @dev the depositor and depositId must match the params in a FundsDeposited event that the depositor\n * wants to speed up. The relayer has the option but not the obligation to use this updated information\n * when filling the deposit via fillRelayWithUpdatedDeposit().\n * @param depositor Depositor that must sign the depositorSignature and was the original depositor.\n * @param depositId Deposit ID to speed up.\n * @param updatedOutputAmount New output amount to use for this deposit. Should be lower than previous value\n * otherwise relayer has no incentive to use this updated value.\n * @param updatedRecipient New recipient to use for this deposit. Can be modified if the recipient is a contract\n * that expects to receive a message from the relay and for some reason needs to be modified.\n * @param updatedMessage New message to use for this deposit. Can be modified if the recipient is a contract\n * that expects to receive a message from the relay and for some reason needs to be modified.\n * @param depositorSignature Signed EIP712 hashstruct containing the deposit ID. Should be signed by the depositor\n * account. If depositor is a contract, then should implement EIP1271 to sign as a contract. See\n * _verifyUpdateV3DepositMessage() for more details about how this signature should be constructed.\n */\n function speedUpDeposit(\n bytes32 depositor,\n uint256 depositId,\n uint256 updatedOutputAmount,\n bytes32 updatedRecipient,\n bytes calldata updatedMessage,\n bytes calldata depositorSignature\n ) public override nonReentrant {\n _verifyUpdateV3DepositMessage(\n depositor.toAddress(),\n depositId,\n chainId(),\n updatedOutputAmount,\n updatedRecipient,\n updatedMessage,\n depositorSignature,\n UPDATE_BYTES32_DEPOSIT_DETAILS_HASH\n );\n\n // Assuming the above checks passed, a relayer can take the signature and the updated deposit information\n // from the following event to submit a fill with updated relay data.\n emit RequestedSpeedUpDeposit(\n updatedOutputAmount,\n depositId,\n depositor,\n updatedRecipient,\n updatedMessage,\n depositorSignature\n );\n }\n\n /**\n * @notice A version of `speedUpDeposit` using `address` types for backward compatibility.\n * This function allows the depositor to signal to the relayer to use updated output amount, recipient, and/or message\n * when filling a deposit. This can be useful when the deposit needs to be modified after the original transaction has\n * been mined.\n *\n * @dev The `depositor` and `depositId` must match the parameters in a `FundsDeposited` event that the depositor wants to speed up.\n * The relayer is not obligated but has the option to use this updated information when filling the deposit using\n * `fillRelayWithUpdatedDeposit()`. This version uses `address` types for compatibility with systems relying on\n * `address`-based implementations.\n *\n * @param depositor The depositor that must sign the `depositorSignature` and was the original depositor.\n * @param depositId The deposit ID to speed up.\n * @param updatedOutputAmount The new output amount to use for this deposit. It should be lower than the previous value,\n * otherwise the relayer has no incentive to use this updated value.\n * @param updatedRecipient The new recipient for this deposit. Can be modified if the original recipient is a contract that\n * expects to receive a message from the relay and needs to be changed.\n * @param updatedMessage The new message for this deposit. Can be modified if the recipient is a contract that expects\n * to receive a message from the relay and needs to be updated.\n * @param depositorSignature The signed EIP712 hashstruct containing the deposit ID. Should be signed by the depositor account.\n * If the depositor is a contract, it should implement EIP1271 to sign as a contract. See `_verifyUpdateV3DepositMessage()`\n * for more details on how the signature should be constructed.\n */\n function speedUpV3Deposit(\n address depositor,\n uint256 depositId,\n uint256 updatedOutputAmount,\n address updatedRecipient,\n bytes calldata updatedMessage,\n bytes calldata depositorSignature\n ) public {\n _verifyUpdateV3DepositMessage(\n depositor,\n depositId,\n chainId(),\n updatedOutputAmount,\n updatedRecipient.toBytes32(),\n updatedMessage,\n depositorSignature,\n UPDATE_BYTES32_DEPOSIT_DETAILS_HASH\n );\n\n // Assuming the above checks passed, a relayer can take the signature and the updated deposit information\n // from the following event to submit a fill with updated relay data.\n emit RequestedSpeedUpDeposit(\n updatedOutputAmount,\n depositId,\n depositor.toBytes32(),\n updatedRecipient.toBytes32(),\n updatedMessage,\n depositorSignature\n );\n }\n\n /**************************************\n * RELAYER FUNCTIONS *\n **************************************/\n\n /**\n * @notice Fulfill request to bridge cross chain by sending specified output tokens to the recipient.\n * @dev The fee paid to relayers and the system should be captured in the spread between output\n * amount and input amount when adjusted to be denominated in the input token. A relayer on the destination\n * chain will send outputAmount of outputTokens to the recipient and receive inputTokens on a repayment\n * chain of their choice. Therefore, the fee should account for destination fee transaction costs, the\n * relayer's opportunity cost of capital while they wait to be refunded following an optimistic challenge\n * window in the HubPool, and a system fee charged to relayers.\n * @dev The hash of the relayData will be used to uniquely identify the deposit to fill, so\n * modifying any params in it will result in a different hash and a different deposit. The hash will comprise\n * all parameters passed to deposit() on the origin chain along with that chain's chainId(). This chain's\n * chainId() must therefore match the destinationChainId passed into deposit.\n * Relayers are only refunded for filling deposits with deposit hashes that map exactly to the one emitted by the\n * origin SpokePool therefore the relayer should not modify any params in relayData.\n * @dev Cannot fill more than once. Partial fills are not supported.\n * @param relayData struct containing all the data needed to identify the deposit to be filled. Should match\n * all the same-named parameters emitted in the origin chain FundsDeposited event.\n * - depositor: The account credited with the deposit who can request to \"speed up\" this deposit by modifying\n * the output amount, recipient, and message.\n * - recipient The account receiving funds on this chain. Can be an EOA or a contract. If\n * the output token is the wrapped native token for the chain, then the recipient will receive native token if\n * an EOA or wrapped native token if a contract.\n * - inputToken: The token pulled from the caller's account to initiate the deposit. The equivalent of this\n * token on the repayment chain will be sent as a refund to the caller.\n * - outputToken The token that the caller will send to the recipient on the destination chain. Must be an\n * ERC20.\n * - inputAmount: This amount, less a system fee, will be sent to the caller on their repayment chain of choice as a refund\n * following an optimistic challenge window in the HubPool.\n * - outputAmount: The amount of output tokens that the caller will send to the recipient.\n * - originChainId: The origin chain identifier.\n * - exclusiveRelayer The relayer that will be exclusively allowed to fill this deposit before the\n * exclusivity deadline timestamp.\n * - fillDeadline The deadline for the caller to fill the deposit. After this timestamp,\n * the fill will revert on the destination chain.\n * - exclusivityDeadline: The deadline for the exclusive relayer to fill the deposit. After this\n * timestamp, anyone can fill this deposit. Note that if this value was set in deposit by adding an offset\n * to the deposit's block.timestamp, there is re-org risk for the caller of this method because the event's\n * block.timestamp can change. Read the comments in `deposit` about the `exclusivityParameter` for more details.\n * - message The message to send to the recipient if the recipient is a contract that implements a\n * handleV3AcrossMessage() public function\n * @param repaymentChainId Chain of SpokePool where relayer wants to be refunded after the challenge window has\n * passed. Will receive inputAmount of the equivalent token to inputToken on the repayment chain.\n * @param repaymentAddress Address the relayer wants to be receive their refund at.\n */\n function fillRelay(\n V3RelayData memory relayData,\n uint256 repaymentChainId,\n bytes32 repaymentAddress\n ) public override nonReentrant unpausedFills {\n // Exclusivity deadline is inclusive and is the latest timestamp that the exclusive relayer has sole right\n // to fill the relay.\n if (\n _fillIsExclusive(relayData.exclusivityDeadline, uint32(getCurrentTime())) &&\n relayData.exclusiveRelayer.toAddress() != msg.sender\n ) {\n revert NotExclusiveRelayer();\n }\n\n V3RelayExecutionParams memory relayExecution = V3RelayExecutionParams({\n relay: relayData,\n relayHash: getV3RelayHash(relayData),\n updatedOutputAmount: relayData.outputAmount,\n updatedRecipient: relayData.recipient,\n updatedMessage: relayData.message,\n repaymentChainId: repaymentChainId\n });\n\n _fillRelayV3(relayExecution, repaymentAddress, false);\n }\n\n // Exposes the same function as fillRelay but with a legacy V3RelayData struct that takes in address types. Inner\n // function fillV3Relay() applies reentrancy & non-paused checks.\n function fillV3Relay(V3RelayDataLegacy calldata relayData, uint256 repaymentChainId) public override {\n // Convert V3RelayDataLegacy to V3RelayData using the .toBytes32() method.\n V3RelayData memory convertedRelayData = V3RelayData({\n depositor: relayData.depositor.toBytes32(),\n recipient: relayData.recipient.toBytes32(),\n exclusiveRelayer: relayData.exclusiveRelayer.toBytes32(),\n inputToken: relayData.inputToken.toBytes32(),\n outputToken: relayData.outputToken.toBytes32(),\n inputAmount: relayData.inputAmount,\n outputAmount: relayData.outputAmount,\n originChainId: relayData.originChainId,\n depositId: relayData.depositId,\n fillDeadline: relayData.fillDeadline,\n exclusivityDeadline: relayData.exclusivityDeadline,\n message: relayData.message\n });\n\n fillRelay(convertedRelayData, repaymentChainId, msg.sender.toBytes32());\n }\n\n /**\n * @notice Identical to fillV3Relay except that the relayer wants to use a depositor's updated output amount,\n * recipient, and/or message. The relayer should only use this function if they can supply a message signed\n * by the depositor that contains the fill's matching deposit ID along with updated relay parameters.\n * If the signature can be verified, then this function will emit a FilledV3Event that will be used by\n * the system for refund verification purposes. In other words, this function is an alternative way to fill a\n * a deposit than fillV3Relay.\n * @dev Subject to same exclusivity deadline rules as fillV3Relay().\n * @param relayData struct containing all the data needed to identify the deposit to be filled. See fillV3Relay().\n * @param repaymentChainId Chain of SpokePool where relayer wants to be refunded after the challenge window has\n * passed. See fillV3Relay().\n * @param repaymentAddress Address the relayer wants to be receive their refund at.\n * @param updatedOutputAmount New output amount to use for this deposit.\n * @param updatedRecipient New recipient to use for this deposit.\n * @param updatedMessage New message to use for this deposit.\n * @param depositorSignature Signed EIP712 hashstruct containing the deposit ID. Should be signed by the depositor\n * account.\n */\n function fillRelayWithUpdatedDeposit(\n V3RelayData calldata relayData,\n uint256 repaymentChainId,\n bytes32 repaymentAddress,\n uint256 updatedOutputAmount,\n bytes32 updatedRecipient,\n bytes calldata updatedMessage,\n bytes calldata depositorSignature\n ) public override nonReentrant unpausedFills {\n // Exclusivity deadline is inclusive and is the latest timestamp that the exclusive relayer has sole right\n // to fill the relay.\n if (\n _fillIsExclusive(relayData.exclusivityDeadline, uint32(getCurrentTime())) &&\n relayData.exclusiveRelayer.toAddress() != msg.sender\n ) {\n revert NotExclusiveRelayer();\n }\n\n V3RelayExecutionParams memory relayExecution = V3RelayExecutionParams({\n relay: relayData,\n relayHash: getV3RelayHash(relayData),\n updatedOutputAmount: updatedOutputAmount,\n updatedRecipient: updatedRecipient,\n updatedMessage: updatedMessage,\n repaymentChainId: repaymentChainId\n });\n\n _verifyUpdateV3DepositMessage(\n relayData.depositor.toAddress(),\n relayData.depositId,\n relayData.originChainId,\n updatedOutputAmount,\n updatedRecipient,\n updatedMessage,\n depositorSignature,\n UPDATE_BYTES32_DEPOSIT_DETAILS_HASH\n );\n\n _fillRelayV3(relayExecution, repaymentAddress, false);\n }\n\n /**\n * @notice Request Across to send LP funds to this contract to fulfill a slow fill relay\n * for a deposit in the next bundle.\n * @dev Slow fills are not possible unless the input and output tokens are \"equivalent\", i.e.\n * they route to the same L1 token via PoolRebalanceRoutes.\n * @dev Slow fills are created by inserting slow fill objects into a merkle tree that is included\n * in the next HubPool \"root bundle\". Once the optimistic challenge window has passed, the HubPool\n * will relay the slow root to this chain via relayRootBundle(). Once the slow root is relayed,\n * the slow fill can be executed by anyone who calls executeSlowRelayLeaf().\n * @dev Cannot request a slow fill if the fill deadline has passed.\n * @dev Cannot request a slow fill if the relay has already been filled or a slow fill has already been requested.\n * @param relayData struct containing all the data needed to identify the deposit that should be\n * slow filled. If any of the params are missing or different from the origin chain deposit,\n * then Across will not include a slow fill for the intended deposit.\n */\n function requestSlowFill(V3RelayData calldata relayData) public override nonReentrant unpausedFills {\n uint32 currentTime = uint32(getCurrentTime());\n // If a depositor has set an exclusivity deadline, then only the exclusive relayer should be able to\n // fast fill within this deadline. Moreover, the depositor should expect to get *fast* filled within\n // this deadline, not slow filled. As a simplifying assumption, we will not allow slow fills to be requested\n // during this exclusivity period.\n if (_fillIsExclusive(relayData.exclusivityDeadline, currentTime)) {\n revert NoSlowFillsInExclusivityWindow();\n }\n if (relayData.fillDeadline < currentTime) revert ExpiredFillDeadline();\n\n bytes32 relayHash = getV3RelayHash(relayData);\n if (fillStatuses[relayHash] != uint256(FillStatus.Unfilled)) revert InvalidSlowFillRequest();\n fillStatuses[relayHash] = uint256(FillStatus.RequestedSlowFill);\n\n emit RequestedSlowFill(\n relayData.inputToken,\n relayData.outputToken,\n relayData.inputAmount,\n relayData.outputAmount,\n relayData.originChainId,\n relayData.depositId,\n relayData.fillDeadline,\n relayData.exclusivityDeadline,\n relayData.exclusiveRelayer,\n relayData.depositor,\n relayData.recipient,\n _hashNonEmptyMessage(relayData.message)\n );\n }\n\n /**\n * @notice Fills a single leg of a particular order on the destination chain\n * @dev ERC-7683 fill function.\n * @param orderId Unique order identifier for this order\n * @param originData Data emitted on the origin to parameterize the fill\n * @param fillerData Data provided by the filler to inform the fill or express their preferences\n */\n function fill(\n bytes32 orderId,\n bytes calldata originData,\n bytes calldata fillerData\n ) external {\n if (keccak256(abi.encode(originData, chainId())) != orderId) {\n revert WrongERC7683OrderId();\n }\n\n // Ensure that the call is not malformed. If the call is malformed, abi.decode will fail.\n V3SpokePoolInterface.V3RelayData memory relayData = abi.decode(originData, (V3SpokePoolInterface.V3RelayData));\n AcrossDestinationFillerData memory destinationFillerData = abi.decode(\n fillerData,\n (AcrossDestinationFillerData)\n );\n\n // Must do a delegatecall because the function requires the inputs to be calldata.\n (bool success, bytes memory data) = address(this).delegatecall(\n abi.encodeCall(\n V3SpokePoolInterface.fillRelay,\n (relayData, destinationFillerData.repaymentChainId, msg.sender.toBytes32())\n )\n );\n if (!success) {\n revert LowLevelCallFailed(data);\n }\n }\n\n /**************************************\n * DATA WORKER FUNCTIONS *\n **************************************/\n\n /**\n * @notice Executes a slow relay leaf stored as part of a root bundle relayed by the HubPool.\n * @dev Executing a slow fill leaf is equivalent to filling the relayData so this function cannot be used to\n * double fill a recipient. The relayData that is filled is included in the slowFillLeaf and is hashed\n * like any other fill sent through a fill method.\n * @dev There is no relayer credited with filling this relay since funds are sent directly out of this contract.\n * @param slowFillLeaf Contains all data necessary to uniquely identify a relay for this chain. This struct is\n * hashed and included in a merkle root that is relayed to all spoke pools.\n * - relayData: struct containing all the data needed to identify the original deposit to be slow filled.\n * - chainId: chain identifier where slow fill leaf should be executed. If this doesn't match this chain's\n * chainId, then this function will revert.\n * - updatedOutputAmount: Amount to be sent to recipient out of this contract's balance. Can be set differently\n * from relayData.outputAmount to charge a different fee because this deposit was \"slow\" filled. Usually,\n * this will be set higher to reimburse the recipient for waiting for the slow fill.\n * @param rootBundleId Unique ID of root bundle containing slow relay root that this leaf is contained in.\n * @param proof Inclusion proof for this leaf in slow relay root in root bundle.\n */\n function executeSlowRelayLeaf(\n V3SlowFill calldata slowFillLeaf,\n uint32 rootBundleId,\n bytes32[] calldata proof\n ) public override nonReentrant {\n V3RelayData memory relayData = slowFillLeaf.relayData;\n\n _preExecuteLeafHook(relayData.outputToken.toAddress());\n\n // @TODO In the future consider allowing way for slow fill leaf to be created with updated\n // deposit params like outputAmount, message and recipient.\n V3RelayExecutionParams memory relayExecution = V3RelayExecutionParams({\n relay: relayData,\n relayHash: getV3RelayHash(relayData),\n updatedOutputAmount: slowFillLeaf.updatedOutputAmount,\n updatedRecipient: relayData.recipient,\n updatedMessage: relayData.message,\n repaymentChainId: EMPTY_REPAYMENT_CHAIN_ID // Repayment not relevant for slow fills.\n });\n\n _verifyV3SlowFill(relayExecution, rootBundleId, proof);\n\n // - No relayer to refund for slow fill executions.\n _fillRelayV3(relayExecution, EMPTY_RELAYER, true);\n }\n\n /**\n * @notice Executes a relayer refund leaf stored as part of a root bundle. Will send the relayer the amount they\n * sent to the recipient plus a relayer fee.\n * @param rootBundleId Unique ID of root bundle containing relayer refund root that this leaf is contained in.\n * @param relayerRefundLeaf Contains all data necessary to reconstruct leaf contained in root bundle and to\n * refund relayer. This data structure is explained in detail in the SpokePoolInterface.\n * @param proof Inclusion proof for this leaf in relayer refund root in root bundle.\n */\n function executeRelayerRefundLeaf(\n uint32 rootBundleId,\n SpokePoolInterface.RelayerRefundLeaf memory relayerRefundLeaf,\n bytes32[] memory proof\n ) public payable virtual override nonReentrant {\n _preExecuteLeafHook(relayerRefundLeaf.l2TokenAddress);\n\n if (relayerRefundLeaf.chainId != chainId()) revert InvalidChainId();\n\n RootBundle storage rootBundle = rootBundles[rootBundleId];\n\n // Check that proof proves that relayerRefundLeaf is contained within the relayer refund root.\n // Note: This should revert if the relayerRefundRoot is uninitialized.\n if (!MerkleLib.verifyRelayerRefund(rootBundle.relayerRefundRoot, relayerRefundLeaf, proof)) {\n revert InvalidMerkleProof();\n }\n\n _setClaimedLeaf(rootBundleId, relayerRefundLeaf.leafId);\n\n bool deferredRefunds = _distributeRelayerRefunds(\n relayerRefundLeaf.chainId,\n relayerRefundLeaf.amountToReturn,\n relayerRefundLeaf.refundAmounts,\n relayerRefundLeaf.leafId,\n relayerRefundLeaf.l2TokenAddress,\n relayerRefundLeaf.refundAddresses\n );\n\n emit ExecutedRelayerRefundRoot(\n relayerRefundLeaf.amountToReturn,\n relayerRefundLeaf.chainId,\n relayerRefundLeaf.refundAmounts,\n rootBundleId,\n relayerRefundLeaf.leafId,\n relayerRefundLeaf.l2TokenAddress,\n relayerRefundLeaf.refundAddresses,\n deferredRefunds,\n msg.sender\n );\n }\n\n /**\n * @notice Enables a relayer to claim outstanding repayments. Should virtually never be used, unless for some reason\n * relayer repayment transfer fails for reasons such as token transfer reverts due to blacklisting. In this case,\n * the relayer can still call this method and claim the tokens to a new address.\n * @param l2TokenAddress Address of the L2 token to claim refunds for.\n * @param refundAddress Address to send the refund to.\n */\n function claimRelayerRefund(bytes32 l2TokenAddress, bytes32 refundAddress) external {\n uint256 refund = relayerRefund[l2TokenAddress.toAddress()][msg.sender];\n if (refund == 0) revert NoRelayerRefundToClaim();\n relayerRefund[l2TokenAddress.toAddress()][msg.sender] = 0;\n IERC20Upgradeable(l2TokenAddress.toAddress()).safeTransfer(refundAddress.toAddress(), refund);\n\n emit ClaimedRelayerRefund(l2TokenAddress, refundAddress, refund, msg.sender);\n }\n\n /**************************************\n * VIEW FUNCTIONS *\n **************************************/\n\n /**\n * @notice Returns chain ID for this network.\n * @dev Some L2s like ZKSync don't support the CHAIN_ID opcode so we allow the implementer to override this.\n */\n function chainId() public view virtual override returns (uint256) {\n return block.chainid;\n }\n\n /**\n * @notice Gets the current time.\n * @return uint for the current timestamp.\n */\n function getCurrentTime() public view virtual returns (uint256) {\n return block.timestamp; // solhint-disable-line not-rely-on-time\n }\n\n /**\n * @notice Returns the deposit ID for an unsafe deposit. This function is used to compute the deposit ID\n * in unsafeDeposit and is provided as a convenience.\n * @dev msgSender and depositor are both used as inputs to allow passthrough depositors to create unique\n * deposit hash spaces for unique depositors.\n * @param msgSender The caller of the transaction used as input to produce the deposit ID.\n * @param depositor The depositor address used as input to produce the deposit ID.\n * @param depositNonce The nonce used as input to produce the deposit ID.\n * @return The deposit ID for the unsafe deposit.\n */\n function getUnsafeDepositId(\n address msgSender,\n bytes32 depositor,\n uint256 depositNonce\n ) public pure returns (uint256) {\n return uint256(keccak256(abi.encodePacked(msgSender, depositor, depositNonce)));\n }\n\n function getRelayerRefund(address l2TokenAddress, address refundAddress) public view returns (uint256) {\n return relayerRefund[l2TokenAddress][refundAddress];\n }\n\n function getV3RelayHash(V3RelayData memory relayData) public view returns (bytes32) {\n return keccak256(abi.encode(relayData, chainId()));\n }\n\n /**************************************\n * INTERNAL FUNCTIONS *\n **************************************/\n\n function _depositV3(DepositV3Params memory params) internal {\n // Verify depositor is a valid EVM address.\n params.depositor.checkAddress();\n\n // Require that quoteTimestamp has a maximum age so that depositors pay an LP fee based on recent HubPool usage.\n // It is assumed that cross-chain timestamps are normally loosely in-sync, but clock drift can occur. If the\n // SpokePool time stalls or lags significantly, it is still possible to make deposits by setting quoteTimestamp\n // within the configured buffer. The owner should pause deposits/fills if this is undesirable.\n // This will underflow if quoteTimestamp is more than depositQuoteTimeBuffer;\n // this is safe but will throw an unintuitive error.\n\n // slither-disable-next-line timestamp\n uint256 currentTime = getCurrentTime();\n if (currentTime < params.quoteTimestamp || currentTime - params.quoteTimestamp > depositQuoteTimeBuffer)\n revert InvalidQuoteTimestamp();\n\n // fillDeadline is relative to the destination chain.\n // Don’t allow fillDeadline to be more than several bundles into the future.\n // This limits the maximum required lookback for dataworker and relayer instances.\n if (params.fillDeadline > currentTime + fillDeadlineBuffer) revert InvalidFillDeadline();\n\n // There are three cases for setting the exclusivity deadline using the exclusivity parameter:\n // 1. If this parameter is 0, then there is no exclusivity period and emit 0 for the deadline. This\n // means that fillers of this deposit do not have to worry about the block.timestamp of this event changing\n // due to re-orgs when filling this deposit.\n // 2. If the exclusivity parameter is less than or equal to MAX_EXCLUSIVITY_PERIOD_SECONDS, then the exclusivity\n // deadline is set to the block.timestamp of this event plus the exclusivity parameter. This means that the\n // filler of this deposit assumes re-org risk when filling this deposit because the block.timestamp of this\n // event affects the exclusivity deadline.\n // 3. Otherwise, interpret this parameter as a timestamp and emit it as the exclusivity deadline. This means\n // that the filler of this deposit will not assume re-org risk related to the block.timestamp of this\n // event changing.\n uint32 exclusivityDeadline = params.exclusivityParameter;\n if (exclusivityDeadline > 0) {\n if (exclusivityDeadline <= MAX_EXCLUSIVITY_PERIOD_SECONDS) {\n exclusivityDeadline += uint32(currentTime);\n }\n\n // As a safety measure, prevent caller from inadvertently locking funds during exclusivity period\n // by forcing them to specify an exclusive relayer.\n if (params.exclusiveRelayer == bytes32(0)) revert InvalidExclusiveRelayer();\n }\n\n // If the address of the origin token is a wrappedNativeToken contract and there is a msg.value with the\n // transaction then the user is sending the native token. In this case, the native token should be\n // wrapped.\n if (params.inputToken == address(wrappedNativeToken).toBytes32() && msg.value > 0) {\n if (msg.value != params.inputAmount) revert MsgValueDoesNotMatchInputAmount();\n wrappedNativeToken.deposit{ value: msg.value }();\n // Else, it is a normal ERC20. In this case pull the token from the caller as per normal.\n // Note: this includes the case where the L2 caller has WETH (already wrapped ETH) and wants to bridge them.\n // In this case the msg.value will be set to 0, indicating a \"normal\" ERC20 bridging action.\n } else {\n // msg.value should be 0 if input token isn't the wrapped native token.\n if (msg.value != 0) revert MsgValueDoesNotMatchInputAmount();\n IERC20Upgradeable(params.inputToken.toAddress()).safeTransferFrom(\n msg.sender,\n address(this),\n params.inputAmount\n );\n }\n\n emit FundsDeposited(\n params.inputToken,\n params.outputToken,\n params.inputAmount,\n params.outputAmount,\n params.destinationChainId,\n params.depositId,\n params.quoteTimestamp,\n params.fillDeadline,\n exclusivityDeadline,\n params.depositor,\n params.recipient,\n params.exclusiveRelayer,\n params.message\n );\n }\n\n function _deposit(\n address depositor,\n address recipient,\n address originToken,\n uint256 amount,\n uint256 destinationChainId,\n int64 relayerFeePct,\n uint32 quoteTimestamp,\n bytes memory message\n ) internal {\n // We limit the relay fees to prevent the user spending all their funds on fees.\n if (SignedMath.abs(relayerFeePct) >= 0.5e18) revert InvalidRelayerFeePct();\n if (amount > MAX_TRANSFER_SIZE) revert MaxTransferSizeExceeded();\n\n // Require that quoteTimestamp has a maximum age so that depositors pay an LP fee based on recent HubPool usage.\n // It is assumed that cross-chain timestamps are normally loosely in-sync, but clock drift can occur. If the\n // SpokePool time stalls or lags significantly, it is still possible to make deposits by setting quoteTimestamp\n // within the configured buffer. The owner should pause deposits if this is undesirable. This will underflow if\n // quoteTimestamp is more than depositQuoteTimeBuffer; this is safe but will throw an unintuitive error.\n\n // slither-disable-next-line timestamp\n if (getCurrentTime() - quoteTimestamp > depositQuoteTimeBuffer) revert InvalidQuoteTimestamp();\n\n // Increment count of deposits so that deposit ID for this spoke pool is unique.\n uint32 newDepositId = numberOfDeposits++;\n\n // If the address of the origin token is a wrappedNativeToken contract and there is a msg.value with the\n // transaction then the user is sending ETH. In this case, the ETH should be deposited to wrappedNativeToken.\n if (originToken == address(wrappedNativeToken) && msg.value > 0) {\n if (msg.value != amount) revert MsgValueDoesNotMatchInputAmount();\n wrappedNativeToken.deposit{ value: msg.value }();\n // Else, it is a normal ERC20. In this case pull the token from the user's wallet as per normal.\n // Note: this includes the case where the L2 user has WETH (already wrapped ETH) and wants to bridge them.\n // In this case the msg.value will be set to 0, indicating a \"normal\" ERC20 bridging action.\n } else {\n IERC20Upgradeable(originToken).safeTransferFrom(msg.sender, address(this), amount);\n }\n\n emit FundsDeposited(\n originToken.toBytes32(), // inputToken\n bytes32(0), // outputToken. Setting this to 0x0 means that the outputToken should be assumed to be the\n // canonical token for the destination chain matching the inputToken. Therefore, this deposit\n // can always be slow filled.\n // - setting token to 0x0 will signal to off-chain validator that the \"equivalent\"\n // token as the inputToken for the destination chain should be replaced here.\n amount, // inputAmount\n _computeAmountPostFees(amount, relayerFeePct), // outputAmount\n // - output amount will be the deposit amount less relayerFeePct, which should now be set\n // equal to realizedLpFeePct + gasFeePct + capitalCostFeePct where (gasFeePct + capitalCostFeePct)\n // is equal to the old usage of `relayerFeePct`.\n destinationChainId,\n newDepositId,\n quoteTimestamp,\n INFINITE_FILL_DEADLINE, // fillDeadline. Default to infinite expiry because\n // expired deposits refunds could be a breaking change for existing users of this function.\n 0, // exclusivityDeadline. Setting this to 0 along with the exclusiveRelayer to 0x0 means that there\n // is no exclusive deadline\n depositor.toBytes32(),\n recipient.toBytes32(),\n bytes32(0), // exclusiveRelayer. Setting this to 0x0 will signal to off-chain validator that there\n // is no exclusive relayer.\n message\n );\n }\n\n function _distributeRelayerRefunds(\n uint256 _chainId,\n uint256 amountToReturn,\n uint256[] memory refundAmounts,\n uint32 leafId,\n address l2TokenAddress,\n address[] memory refundAddresses\n ) internal returns (bool deferredRefunds) {\n uint256 numRefunds = refundAmounts.length;\n if (refundAddresses.length != numRefunds) revert InvalidMerkleLeaf();\n\n if (numRefunds > 0) {\n uint256 spokeStartBalance = IERC20Upgradeable(l2TokenAddress).balanceOf(address(this));\n uint256 totalRefundedAmount = 0; // Track the total amount refunded.\n\n // Send each relayer refund address the associated refundAmount for the L2 token address.\n // Note: Even if the L2 token is not enabled on this spoke pool, we should still refund relayers.\n for (uint256 i = 0; i < numRefunds; ++i) {\n if (refundAmounts[i] > 0) {\n totalRefundedAmount += refundAmounts[i];\n\n // Only if the total refunded amount exceeds the spoke starting balance, should we revert. This\n // ensures that bundles are atomic, if we have sufficient balance to refund all relayers and\n // prevents can only re-pay some of the relayers.\n if (totalRefundedAmount > spokeStartBalance) revert InsufficientSpokePoolBalanceToExecuteLeaf();\n\n bool success = _noRevertTransfer(l2TokenAddress, refundAddresses[i], refundAmounts[i]);\n\n // If the transfer failed then track a deferred transfer for the relayer. Given this function would\n // have reverted if there was insufficient balance, this will only happen if the transfer call\n // reverts. This will only occur if the underlying transfer method on the l2Token reverts due to\n // recipient blacklisting or other related modifications to the l2Token.transfer method.\n if (!success) {\n relayerRefund[l2TokenAddress][refundAddresses[i]] += refundAmounts[i];\n deferredRefunds = true;\n }\n }\n }\n }\n // If leaf's amountToReturn is positive, then send L2 --> L1 message to bridge tokens back via\n // chain-specific bridging method.\n if (amountToReturn > 0) {\n _bridgeTokensToHubPool(amountToReturn, l2TokenAddress);\n\n emit TokensBridged(amountToReturn, _chainId, leafId, l2TokenAddress.toBytes32(), msg.sender);\n }\n }\n\n // Re-implementation of OZ _callOptionalReturnBool to use private logic. Function executes a transfer and returns a\n // bool indicating if the external call was successful, rather than reverting. Original method:\n // https://github.com/OpenZeppelin/openzeppelin-contracts/blob/28aed34dc5e025e61ea0390c18cac875bfde1a78/contracts/token/ERC20/utils/SafeERC20.sol#L188\n function _noRevertTransfer(\n address token,\n address to,\n uint256 amount\n ) internal returns (bool) {\n bool success;\n uint256 returnSize;\n uint256 returnValue;\n bytes memory data = abi.encodeCall(IERC20Upgradeable.transfer, (to, amount));\n assembly {\n success := call(gas(), token, 0, add(data, 0x20), mload(data), 0, 0x20)\n returnSize := returndatasize()\n returnValue := mload(0)\n }\n return success && (returnSize == 0 ? address(token).code.length > 0 : returnValue == 1);\n }\n\n function _setCrossDomainAdmin(address newCrossDomainAdmin) internal {\n if (newCrossDomainAdmin == address(0)) revert InvalidCrossDomainAdmin();\n crossDomainAdmin = newCrossDomainAdmin;\n emit SetXDomainAdmin(newCrossDomainAdmin);\n }\n\n function _setWithdrawalRecipient(address newWithdrawalRecipient) internal {\n if (newWithdrawalRecipient == address(0)) revert InvalidWithdrawalRecipient();\n withdrawalRecipient = newWithdrawalRecipient;\n emit SetWithdrawalRecipient(newWithdrawalRecipient);\n }\n\n function _preExecuteLeafHook(address) internal virtual {\n // This method by default is a no-op. Different child spoke pools might want to execute functionality here\n // such as wrapping any native tokens owned by the contract into wrapped tokens before proceeding with\n // executing the leaf.\n }\n\n // Should be overriden by implementing contract depending on how L2 handles sending tokens to L1.\n function _bridgeTokensToHubPool(uint256 amountToReturn, address l2TokenAddress) internal virtual;\n\n function _setClaimedLeaf(uint32 rootBundleId, uint32 leafId) internal {\n RootBundle storage rootBundle = rootBundles[rootBundleId];\n\n // Verify the leafId in the leaf has not yet been claimed.\n if (MerkleLib.isClaimed(rootBundle.claimedBitmap, leafId)) revert ClaimedMerkleLeaf();\n\n // Set leaf as claimed in bitmap. This is passed by reference to the storage rootBundle.\n MerkleLib.setClaimed(rootBundle.claimedBitmap, leafId);\n }\n\n function _verifyUpdateV3DepositMessage(\n address depositor,\n uint256 depositId,\n uint256 originChainId,\n uint256 updatedOutputAmount,\n bytes32 updatedRecipient,\n bytes memory updatedMessage,\n bytes memory depositorSignature,\n bytes32 hashType\n ) internal view {\n // A depositor can request to modify an un-relayed deposit by signing a hash containing the updated\n // details and information uniquely identifying the deposit to relay. This information ensures\n // that this signature cannot be re-used for other deposits.\n bytes32 expectedTypedDataV4Hash = _hashTypedDataV4(\n keccak256(\n abi.encode(\n hashType,\n depositId,\n originChainId,\n updatedOutputAmount,\n updatedRecipient,\n keccak256(updatedMessage)\n )\n ),\n originChainId\n );\n _verifyDepositorSignature(depositor, expectedTypedDataV4Hash, depositorSignature);\n }\n\n // This function is isolated and made virtual to allow different L2's to implement chain specific recovery of\n // signers from signatures because some L2s might not support ecrecover. To be safe, consider always reverting\n // this function for L2s where ecrecover is different from how it works on Ethereum, otherwise there is the\n // potential to forge a signature from the depositor using a different private key than the original depositor's.\n function _verifyDepositorSignature(\n address depositor,\n bytes32 ethSignedMessageHash,\n bytes memory depositorSignature\n ) internal view virtual {\n // Note:\n // - We don't need to worry about re-entrancy from a contract deployed at the depositor address since the method\n // `SignatureChecker.isValidSignatureNow` is a view method. Re-entrancy can happen, but it cannot affect state.\n // - EIP-1271 signatures are supported. This means that a signature valid now, may not be valid later and vice-versa.\n // - For an EIP-1271 signature to work, the depositor contract address must map to a deployed contract on the destination\n // chain that can validate the signature.\n // - Regular signatures from an EOA are also supported.\n bool isValid = SignatureChecker.isValidSignatureNow(depositor, ethSignedMessageHash, depositorSignature);\n if (!isValid) revert InvalidDepositorSignature();\n }\n\n function _verifyV3SlowFill(\n V3RelayExecutionParams memory relayExecution,\n uint32 rootBundleId,\n bytes32[] memory proof\n ) internal view {\n V3SlowFill memory slowFill = V3SlowFill({\n relayData: relayExecution.relay,\n chainId: chainId(),\n updatedOutputAmount: relayExecution.updatedOutputAmount\n });\n\n if (!MerkleLib.verifyV3SlowRelayFulfillment(rootBundles[rootBundleId].slowRelayRoot, slowFill, proof)) {\n revert InvalidMerkleProof();\n }\n }\n\n function _computeAmountPostFees(uint256 amount, int256 feesPct) private pure returns (uint256) {\n return (amount * uint256(int256(1e18) - feesPct)) / 1e18;\n }\n\n // Unwraps ETH and does a transfer to a recipient address. If the recipient is a smart contract then sends wrappedNativeToken.\n function _unwrapwrappedNativeTokenTo(address payable to, uint256 amount) internal {\n if (address(to).isContract()) {\n IERC20Upgradeable(address(wrappedNativeToken)).safeTransfer(to, amount);\n } else {\n wrappedNativeToken.withdraw(amount);\n AddressLibUpgradeable.sendValue(to, amount);\n }\n }\n\n // @param relayer: relayer who is actually credited as filling this deposit. Can be different from\n // exclusiveRelayer if passed exclusivityDeadline or if slow fill.\n function _fillRelayV3(\n V3RelayExecutionParams memory relayExecution,\n bytes32 relayer,\n bool isSlowFill\n ) internal {\n V3RelayData memory relayData = relayExecution.relay;\n\n if (relayData.fillDeadline < getCurrentTime()) revert ExpiredFillDeadline();\n\n bytes32 relayHash = relayExecution.relayHash;\n\n // If a slow fill for this fill was requested then the relayFills value for this hash will be\n // FillStatus.RequestedSlowFill. Therefore, if this is the status, then this fast fill\n // will be replacing the slow fill. If this is a slow fill execution, then the following variable\n // is trivially true. We'll emit this value in the FilledRelay\n // event to assist the Dataworker in knowing when to return funds back to the HubPool that can no longer\n // be used for a slow fill execution.\n FillType fillType = isSlowFill\n ? FillType.SlowFill // The following is true if this is a fast fill that was sent after a slow fill request.\n : (\n fillStatuses[relayExecution.relayHash] == uint256(FillStatus.RequestedSlowFill)\n ? FillType.ReplacedSlowFill\n : FillType.FastFill\n );\n\n // @dev This function doesn't support partial fills. Therefore, we associate the relay hash with\n // an enum tracking its fill status. All filled relays, whether slow or fast fills, are set to the Filled\n // status. However, we also use this slot to track whether this fill had a slow fill requested. Therefore\n // we can include a bool in the FilledRelay event making it easy for the dataworker to compute if this\n // fill was a fast fill that replaced a slow fill and therefore this SpokePool has excess funds that it\n // needs to send back to the HubPool.\n if (fillStatuses[relayHash] == uint256(FillStatus.Filled)) revert RelayFilled();\n fillStatuses[relayHash] = uint256(FillStatus.Filled);\n\n // @dev Before returning early, emit events to assist the dataworker in being able to know which fills were\n // successful.\n emit FilledRelay(\n relayData.inputToken,\n relayData.outputToken,\n relayData.inputAmount,\n relayData.outputAmount,\n relayExecution.repaymentChainId,\n relayData.originChainId,\n relayData.depositId,\n relayData.fillDeadline,\n relayData.exclusivityDeadline,\n relayData.exclusiveRelayer,\n relayer,\n relayData.depositor,\n relayData.recipient,\n _hashNonEmptyMessage(relayData.message),\n V3RelayExecutionEventInfo({\n updatedRecipient: relayExecution.updatedRecipient,\n updatedMessageHash: _hashNonEmptyMessage(relayExecution.updatedMessage),\n updatedOutputAmount: relayExecution.updatedOutputAmount,\n fillType: fillType\n })\n );\n\n address outputToken = relayData.outputToken.toAddress();\n uint256 amountToSend = relayExecution.updatedOutputAmount;\n address recipientToSend = relayExecution.updatedRecipient.toAddress();\n // If relay token is wrappedNativeToken then unwrap and send native token.\n // Stack too deep.\n if (relayData.outputToken.toAddress() == address(wrappedNativeToken)) {\n // Note: useContractFunds is True if we want to send funds to the recipient directly out of this contract,\n // otherwise we expect the caller to send funds to the recipient. If useContractFunds is True and the\n // recipient wants wrappedNativeToken, then we can assume that wrappedNativeToken is already in the\n // contract, otherwise we'll need the user to send wrappedNativeToken to this contract. Regardless, we'll\n // need to unwrap it to native token before sending to the user.\n if (!isSlowFill) IERC20Upgradeable(outputToken).safeTransferFrom(msg.sender, address(this), amountToSend);\n _unwrapwrappedNativeTokenTo(payable(recipientToSend), amountToSend);\n // Else, this is a normal ERC20 token. Send to recipient.\n } else {\n // Note: Similar to note above, send token directly from the contract to the user in the slow relay case.\n if (!isSlowFill) IERC20Upgradeable(outputToken).safeTransferFrom(msg.sender, recipientToSend, amountToSend);\n else IERC20Upgradeable(outputToken).safeTransfer(recipientToSend, amountToSend);\n }\n\n bytes memory updatedMessage = relayExecution.updatedMessage;\n if (updatedMessage.length > 0 && recipientToSend.isContract()) {\n AcrossMessageHandler(recipientToSend).handleV3AcrossMessage(\n outputToken,\n amountToSend,\n msg.sender,\n updatedMessage\n );\n }\n }\n\n // Determine whether the exclusivityDeadline implies active exclusivity.\n function _fillIsExclusive(uint32 exclusivityDeadline, uint32 currentTime) internal pure returns (bool) {\n return exclusivityDeadline >= currentTime;\n }\n\n // Helper for emitting message hash. For easier easier human readability we return bytes32(0) for empty message.\n function _hashNonEmptyMessage(bytes memory message) internal pure returns (bytes32) {\n if (message.length == 0) return bytes32(0);\n else return keccak256(message);\n }\n\n // Implementing contract needs to override this to ensure that only the appropriate cross chain admin can execute\n // certain admin functions. For L2 contracts, the cross chain admin refers to some L1 address or contract, and for\n // L1, this would just be the same admin of the HubPool.\n function _requireAdminSender() internal virtual;\n\n // Added to enable the this contract to receive native token (ETH). Used when unwrapping wrappedNativeToken.\n receive() external payable {}\n\n // Reserve storage slots for future versions of this base contract to add state variables without\n // affecting the storage layout of child contracts. Decrement the size of __gap whenever state variables\n // are added. This is at bottom of contract to make sure it's always at the end of storage.\n uint256[998] private __gap;\n}\n"
+ },
+ "contracts/test/MockBedrockStandardBridge.sol": {
+ "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\n\nimport \"../Ovm_SpokePool.sol\";\n\n// Provides payable withdrawTo interface introduced on Bedrock\ncontract MockBedrockL2StandardBridge is IL2ERC20Bridge {\n event ERC20WithdrawalInitiated(address indexed l2Token, address indexed to, uint256 amount);\n\n function withdrawTo(\n address _l2Token,\n address _to,\n uint256 _amount,\n uint32,\n bytes calldata\n ) external payable {\n emit ERC20WithdrawalInitiated(_l2Token, _to, _amount);\n }\n\n function bridgeERC20To(\n address _localToken,\n address _remoteToken,\n address _to,\n uint256 _amount,\n uint32,\n bytes calldata\n ) external {\n // Check that caller has approved this contract to pull funds, mirroring mainnet's behavior\n IERC20(_localToken).transferFrom(msg.sender, address(this), _amount);\n IERC20(_remoteToken).transfer(_to, _amount);\n }\n}\n\ncontract MockBedrockL1StandardBridge {\n event ETHDepositInitiated(address indexed to, uint256 amount);\n event ERC20DepositInitiated(address indexed to, address l1Token, address l2Token, uint256 amount);\n\n function depositERC20To(\n address l1Token,\n address l2Token,\n address to,\n uint256 amount,\n uint32,\n bytes calldata\n ) external {\n IERC20(l1Token).transferFrom(msg.sender, address(this), amount);\n emit ERC20DepositInitiated(to, l1Token, l2Token, amount);\n }\n\n function depositETHTo(\n address to,\n uint32,\n bytes calldata\n ) external payable {\n emit ETHDepositInitiated(to, msg.value);\n }\n}\n\ncontract MockBedrockCrossDomainMessenger {\n event MessageSent(address indexed target);\n\n address private msgSender;\n\n function sendMessage(\n address target,\n bytes calldata,\n uint32\n ) external {\n emit MessageSent(target);\n }\n\n // Impersonates making a call on L2 from L1.\n function impersonateCall(address target, bytes memory data) external payable returns (bytes memory) {\n msgSender = msg.sender;\n (bool success, bytes memory returnData) = target.call{ value: msg.value }(data);\n\n // Revert if call reverted.\n if (!success) {\n assembly {\n revert(add(32, returnData), mload(returnData))\n }\n }\n return returnData;\n }\n\n function xDomainMessageSender() external view returns (address) {\n return msgSender;\n }\n}\n"
+ },
+ "contracts/test/MockCCTP.sol": {
+ "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\n\nimport \"../libraries/CircleCCTPAdapter.sol\";\n\ncontract MockCCTPMinter is ITokenMinter {\n function burnLimitsPerMessage(address) external pure returns (uint256) {\n return type(uint256).max;\n }\n}\n\ncontract MockCCTPMessenger is ITokenMessenger {\n ITokenMinter private minter;\n\n constructor(ITokenMinter _minter) {\n minter = _minter;\n }\n\n function depositForBurn(\n uint256,\n uint32,\n bytes32,\n address\n ) external pure returns (uint64 _nonce) {\n return 0;\n }\n\n function localMinter() external view returns (ITokenMinter) {\n return minter;\n }\n}\n"
+ },
+ "contracts/test/MockOptimism_SpokePool.sol": {
+ "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\nimport \"../Ovm_SpokePool.sol\";\n\n/**\n * @notice Mock Optimism Spoke pool allowing deployer to override constructor params.\n */\ncontract MockOptimism_SpokePool is Ovm_SpokePool {\n /// @custom:oz-upgrades-unsafe-allow constructor\n constructor(address _wrappedNativeTokenAddress)\n Ovm_SpokePool(_wrappedNativeTokenAddress, 1 hours, 9 hours, IERC20(address(0)), ITokenMessenger(address(0)))\n {} // solhint-disable-line no-empty-blocks\n\n function initialize(\n address l2Eth,\n uint32 _initialDepositId,\n address _crossDomainAdmin,\n address _hubPool\n ) public initializer {\n __OvmSpokePool_init(_initialDepositId, _crossDomainAdmin, _hubPool, l2Eth);\n }\n}\n"
+ },
+ "contracts/upgradeable/AddressLibUpgradeable.sol": {
+ "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (utils/Address.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @title AddressUpgradeable\n * @dev Collection of functions related to the address type\n * @notice Logic is 100% copied from \"@openzeppelin/contracts-upgradeable/contracts/utils/AddressUpgradeable.sol\" but one\n * comment is added to clarify why we allow delegatecall() in this contract, which is typically unsafe for use in\n * upgradeable implementation contracts.\n * @dev See https://docs.openzeppelin.com/upgrades-plugins/1.x/faq#delegatecall-selfdestruct for more details.\n * @custom:security-contact bugs@across.to\n */\nlibrary AddressLibUpgradeable {\n /**\n * @dev Returns true if `account` is a contract.\n *\n * [IMPORTANT]\n * ====\n * It is unsafe to assume that an address for which this function returns\n * false is an externally-owned account (EOA) and not a contract.\n *\n * Among others, `isContract` will return false for the following\n * types of addresses:\n *\n * - an externally-owned account\n * - a contract in construction\n * - an address where a contract will be created\n * - an address where a contract lived, but was destroyed\n *\n * Furthermore, `isContract` will also return true if the target contract within\n * the same transaction is already scheduled for destruction by `SELFDESTRUCT`,\n * which only has an effect at the end of a transaction.\n * ====\n *\n * [IMPORTANT]\n * ====\n * You shouldn't rely on `isContract` to protect against flash loan attacks!\n *\n * Preventing calls from contracts is highly discouraged. It breaks composability, breaks support for smart wallets\n * like Gnosis Safe, and does not provide security since it can be circumvented by calling from a contract\n * constructor.\n * ====\n */\n function isContract(address account) internal view returns (bool) {\n // This method relies on extcodesize/address.code.length, which returns 0\n // for contracts in construction, since the code is only stored at the end\n // of the constructor execution.\n\n return account.code.length > 0;\n }\n\n /**\n * @dev Replacement for Solidity's `transfer`: sends `amount` wei to\n * `recipient`, forwarding all available gas and reverting on errors.\n *\n * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost\n * of certain opcodes, possibly making contracts go over the 2300 gas limit\n * imposed by `transfer`, making them unable to receive funds via\n * `transfer`. {sendValue} removes this limitation.\n *\n * https://consensys.net/diligence/blog/2019/09/stop-using-soliditys-transfer-now/[Learn more].\n *\n * IMPORTANT: because control is transferred to `recipient`, care must be\n * taken to not create reentrancy vulnerabilities. Consider using\n * {ReentrancyGuard} or the\n * https://solidity.readthedocs.io/en/v0.8.0/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].\n */\n function sendValue(address payable recipient, uint256 amount) internal {\n require(address(this).balance >= amount, \"Address: insufficient balance\");\n\n (bool success, ) = recipient.call{ value: amount }(\"\");\n require(success, \"Address: unable to send value, recipient may have reverted\");\n }\n\n /**\n * @dev Performs a Solidity function call using a low level `call`. A\n * plain `call` is an unsafe replacement for a function call: use this\n * function instead.\n *\n * If `target` reverts with a revert reason, it is bubbled up by this\n * function (like regular Solidity function calls).\n *\n * Returns the raw returned data. To convert to the expected return value,\n * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].\n *\n * Requirements:\n *\n * - `target` must be a contract.\n * - calling `target` with `data` must not revert.\n *\n * _Available since v3.1._\n */\n function functionCall(address target, bytes memory data) internal returns (bytes memory) {\n return functionCallWithValue(target, data, 0, \"Address: low-level call failed\");\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with\n * `errorMessage` as a fallback revert reason when `target` reverts.\n *\n * _Available since v3.1._\n */\n function functionCall(\n address target,\n bytes memory data,\n string memory errorMessage\n ) internal returns (bytes memory) {\n return functionCallWithValue(target, data, 0, errorMessage);\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\n * but also transferring `value` wei to `target`.\n *\n * Requirements:\n *\n * - the calling contract must have an ETH balance of at least `value`.\n * - the called Solidity function must be `payable`.\n *\n * _Available since v3.1._\n */\n function functionCallWithValue(\n address target,\n bytes memory data,\n uint256 value\n ) internal returns (bytes memory) {\n return functionCallWithValue(target, data, value, \"Address: low-level call with value failed\");\n }\n\n /**\n * @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but\n * with `errorMessage` as a fallback revert reason when `target` reverts.\n *\n * _Available since v3.1._\n */\n function functionCallWithValue(\n address target,\n bytes memory data,\n uint256 value,\n string memory errorMessage\n ) internal returns (bytes memory) {\n require(address(this).balance >= value, \"Address: insufficient balance for call\");\n (bool success, bytes memory returndata) = target.call{ value: value }(data);\n return verifyCallResultFromTarget(target, success, returndata, errorMessage);\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\n * but performing a static call.\n *\n * _Available since v3.3._\n */\n function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {\n return functionStaticCall(target, data, \"Address: low-level static call failed\");\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],\n * but performing a static call.\n *\n * _Available since v3.3._\n */\n function functionStaticCall(\n address target,\n bytes memory data,\n string memory errorMessage\n ) internal view returns (bytes memory) {\n (bool success, bytes memory returndata) = target.staticcall(data);\n return verifyCallResultFromTarget(target, success, returndata, errorMessage);\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\n * but performing a delegate call.\n *\n * _Available since v3.4._\n */\n function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) {\n return functionDelegateCall(target, data, \"Address: low-level delegate call failed\");\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],\n * but performing a delegate call.\n *\n * _Available since v3.4._\n */\n function functionDelegateCall(\n address target,\n bytes memory data,\n string memory errorMessage\n ) internal returns (bytes memory) {\n /// @custom:oz-upgrades-unsafe-allow delegatecall\n (bool success, bytes memory returndata) = target.delegatecall(data);\n return verifyCallResultFromTarget(target, success, returndata, errorMessage);\n }\n\n /**\n * @dev Tool to verify that a low level call to smart-contract was successful, and revert (either by bubbling\n * the revert reason or using the provided one) in case of unsuccessful call or if target was not a contract.\n *\n * _Available since v4.8._\n */\n function verifyCallResultFromTarget(\n address target,\n bool success,\n bytes memory returndata,\n string memory errorMessage\n ) internal view returns (bytes memory) {\n if (success) {\n if (returndata.length == 0) {\n // only check isContract if the call was successful and the return data is empty\n // otherwise we already know that it was a contract\n require(isContract(target), \"Address: call to non-contract\");\n }\n return returndata;\n } else {\n _revert(returndata, errorMessage);\n }\n }\n\n /**\n * @dev Tool to verify that a low level call was successful, and revert if it wasn't, either by bubbling the\n * revert reason or using the provided one.\n *\n * _Available since v4.3._\n */\n function verifyCallResult(\n bool success,\n bytes memory returndata,\n string memory errorMessage\n ) internal pure returns (bytes memory) {\n if (success) {\n return returndata;\n } else {\n _revert(returndata, errorMessage);\n }\n }\n\n function _revert(bytes memory returndata, string memory errorMessage) private pure {\n // Look for revert reason and bubble it up if present\n if (returndata.length > 0) {\n // The easiest way to bubble the revert reason is using memory via assembly\n /// @solidity memory-safe-assembly\n assembly {\n let returndata_size := mload(returndata)\n revert(add(32, returndata), returndata_size)\n }\n } else {\n revert(errorMessage);\n }\n }\n}\n"
+ },
+ "contracts/upgradeable/EIP712CrossChainUpgradeable.sol": {
+ "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\n\nimport \"@openzeppelin/contracts-upgradeable/utils/cryptography/ECDSAUpgradeable.sol\";\nimport \"@openzeppelin/contracts-upgradeable/proxy/utils/Initializable.sol\";\n\n/**\n * @dev https://eips.ethereum.org/EIPS/eip-712[EIP 712] is a standard for hashing and signing of typed structured data.\n *\n * This contract is based on OpenZeppelin's implementation:\n * https://github.com/OpenZeppelin/openzeppelin-contracts-upgradeable/blob/master/contracts/utils/cryptography/EIP712Upgradeable.sol\n *\n * NOTE: Modified version that allows to build a domain separator that relies on a different chain id than the chain this\n * contract is deployed to. An example use case we want to support is:\n * - User A signs a message on chain with id = 1\n * - User B executes a method by verifying user A's EIP-712 compliant signature on a chain with id != 1\n * @custom:security-contact bugs@across.to\n */\nabstract contract EIP712CrossChainUpgradeable is Initializable {\n /* solhint-disable var-name-mixedcase */\n bytes32 private _HASHED_NAME;\n bytes32 private _HASHED_VERSION;\n bytes32 private constant _TYPE_HASH = keccak256(\"EIP712Domain(string name,string version,uint256 chainId)\");\n\n /* solhint-enable var-name-mixedcase */\n\n /**\n * @dev Initializes the domain separator and parameter caches.\n *\n * The meaning of `name` and `version` is specified in\n * https://eips.ethereum.org/EIPS/eip-712#definition-of-domainseparator[EIP 712]:\n *\n * - `name`: the user readable name of the signing domain, i.e. the name of the DApp or the protocol.\n * - `version`: the current major version of the signing domain.\n *\n * NOTE: These parameters cannot be changed except through a xref:learn::upgrading-smart-contracts.adoc[smart\n * contract upgrade].\n */\n function __EIP712_init(string memory name, string memory version) internal onlyInitializing {\n __EIP712_init_unchained(name, version);\n }\n\n function __EIP712_init_unchained(string memory name, string memory version) internal onlyInitializing {\n bytes32 hashedName = keccak256(bytes(name));\n bytes32 hashedVersion = keccak256(bytes(version));\n _HASHED_NAME = hashedName;\n _HASHED_VERSION = hashedVersion;\n }\n\n /**\n * @dev Returns the domain separator depending on the `originChainId`.\n * @param originChainId Chain id of network where message originates from.\n * @return bytes32 EIP-712-compliant domain separator.\n */\n function _domainSeparatorV4(uint256 originChainId) internal view returns (bytes32) {\n return keccak256(abi.encode(_TYPE_HASH, _HASHED_NAME, _HASHED_VERSION, originChainId));\n }\n\n /**\n * @dev Given an already https://eips.ethereum.org/EIPS/eip-712#definition-of-hashstruct[hashed struct], this\n * function returns the hash of the fully encoded EIP712 message for this domain.\n *\n * This hash can be used together with {ECDSA-recover} to obtain the signer of a message. For example:\n *\n * ```solidity\n * bytes32 structHash = keccak256(abi.encode(\n * keccak256(\"Mail(address to,string contents)\"),\n * mailTo,\n * keccak256(bytes(mailContents))\n * ));\n * bytes32 digest = _hashTypedDataV4(structHash, originChainId);\n * address signer = ECDSA.recover(digest, signature);\n * ```\n * @param structHash Hashed struct as defined in https://eips.ethereum.org/EIPS/eip-712#definition-of-hashstruct.\n * @param originChainId Chain id of network where message originates from.\n * @return bytes32 Hash digest that is recoverable via `EDCSA.recover`.\n */\n function _hashTypedDataV4(bytes32 structHash, uint256 originChainId) internal view virtual returns (bytes32) {\n return ECDSAUpgradeable.toTypedDataHash(_domainSeparatorV4(originChainId), structHash);\n }\n\n // Reserve storage slots for future versions of this base contract to add state variables without\n // affecting the storage layout of child contracts. Decrement the size of __gap whenever state variables\n // are added. This is at bottom of contract to make sure it's always at the end of storage.\n uint256[1000] private __gap;\n}\n"
+ },
+ "contracts/upgradeable/MultiCallerUpgradeable.sol": {
+ "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\n\n/**\n * @title MultiCallerUpgradeable\n * @notice Logic is 100% copied from \"@uma/core/contracts/common/implementation/MultiCaller.sol\" but one\n * comment is added to clarify why we allow delegatecall() in this contract, which is typically unsafe for use in\n * upgradeable implementation contracts.\n * @dev See https://docs.openzeppelin.com/upgrades-plugins/1.x/faq#delegatecall-selfdestruct for more details.\n * @custom:security-contact bugs@across.to\n */\ncontract MultiCallerUpgradeable {\n struct Result {\n bool success;\n bytes returnData;\n }\n\n function _validateMulticallData(bytes[] calldata data) internal virtual {\n // no-op\n }\n\n function multicall(bytes[] calldata data) external returns (bytes[] memory results) {\n _validateMulticallData(data);\n\n uint256 dataLength = data.length;\n results = new bytes[](dataLength);\n\n //slither-disable-start calls-loop\n for (uint256 i = 0; i < dataLength; ++i) {\n // Typically, implementation contracts used in the upgradeable proxy pattern shouldn't call `delegatecall`\n // because it could allow a malicious actor to call this implementation contract directly (rather than\n // through a proxy contract) and then selfdestruct() the contract, thereby freezing the upgradeable\n // proxy. However, since we're only delegatecall-ing into this contract, then we can consider this\n // use of delegatecall() safe.\n\n //slither-disable-start low-level-calls\n /// @custom:oz-upgrades-unsafe-allow delegatecall\n (bool success, bytes memory result) = address(this).delegatecall(data[i]);\n //slither-disable-end low-level-calls\n\n if (!success) {\n // Next 5 lines from https://ethereum.stackexchange.com/a/83577\n if (result.length < 68) revert();\n //slither-disable-next-line assembly\n assembly {\n result := add(result, 0x04)\n }\n revert(abi.decode(result, (string)));\n }\n\n results[i] = result;\n }\n //slither-disable-end calls-loop\n }\n\n function tryMulticall(bytes[] calldata data) external returns (Result[] memory results) {\n _validateMulticallData(data);\n\n uint256 dataLength = data.length;\n results = new Result[](dataLength);\n\n //slither-disable-start calls-loop\n for (uint256 i = 0; i < dataLength; ++i) {\n // The delegatecall here is safe for the same reasons outlined in the first multicall function.\n Result memory result = results[i];\n //slither-disable-start low-level-calls\n /// @custom:oz-upgrades-unsafe-allow delegatecall\n (result.success, result.returnData) = address(this).delegatecall(data[i]);\n //slither-disable-end low-level-calls\n }\n //slither-disable-end calls-loop\n }\n\n // Reserve storage slots for future versions of this base contract to add state variables without\n // affecting the storage layout of child contracts. Decrement the size of __gap whenever state variables\n // are added. This is at bottom of contract to make sure its always at the end of storage.\n uint256[1000] private __gap;\n}\n"
+ },
+ "contracts/ZkSync_SpokePool.sol": {
+ "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\n\nimport \"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\";\nimport { CircleCCTPAdapter, CircleDomainIds, ITokenMessenger } from \"./libraries/CircleCCTPAdapter.sol\";\nimport { CrossDomainAddressUtils } from \"./libraries/CrossDomainAddressUtils.sol\";\nimport \"./SpokePool.sol\";\n\n// https://github.com/matter-labs/era-contracts/blob/6391c0d7bf6184d7f6718060e3991ba6f0efe4a7/zksync/contracts/bridge/L2ERC20Bridge.sol#L104\ninterface ZkBridgeLike {\n function withdraw(\n address _l1Receiver,\n address _l2Token,\n uint256 _amount\n ) external;\n}\n\ninterface IL2ETH {\n function withdraw(address _l1Receiver) external payable;\n}\n\n/**\n * @notice ZkSync specific SpokePool, intended to be compiled with `@matterlabs/hardhat-zksync-solc`.\n * @dev Resources for compiling and deploying contracts with hardhat: https://era.zksync.io/docs/tools/hardhat/hardhat-zksync-solc.html\n * @custom:security-contact bugs@across.to\n */\ncontract ZkSync_SpokePool is SpokePool, CircleCCTPAdapter {\n using SafeERC20 for IERC20;\n\n // On Ethereum, avoiding constructor parameters and putting them into constants reduces some of the gas cost\n // upon contract deployment. On zkSync the opposite is true: deploying the same bytecode for contracts,\n // while changing only constructor parameters can lead to substantial fee savings. So, the following params\n // are all set by passing in constructor params where possible.\n\n // ETH on ZkSync implements a subset of the ERC-20 interface, with additional built-in support to bridge to L1.\n address public l2Eth;\n\n // Bridge used to withdraw ERC20's to L1\n ZkBridgeLike public zkErc20Bridge;\n /// @custom:oz-upgrades-unsafe-allow state-variable-immutable\n ZkBridgeLike public immutable zkUSDCBridge;\n\n event SetZkBridge(address indexed erc20Bridge, address indexed oldErc20Bridge);\n\n error InvalidBridgeConfig();\n\n /**\n * @notice Constructor.\n * @notice Circle bridged & native USDC are optionally supported via configuration, but are mutually exclusive.\n * @param _wrappedNativeTokenAddress wrappedNativeToken address for this network to set.\n * @param _circleUSDC Circle USDC address on the SpokePool. Set to 0x0 to use the standard ERC20 bridge instead.\n * If not set to zero, then either the zkUSDCBridge or cctpTokenMessenger must be set and will be used to\n * bridge this token.\n * @param _zkUSDCBridge Elastic chain custom bridge address for USDC (if deployed, or address(0) to disable).\n * @param _cctpTokenMessenger TokenMessenger contract to bridge via CCTP. If the zero address is passed, CCTP bridging will be disabled.\n * @param _depositQuoteTimeBuffer depositQuoteTimeBuffer to set. Quote timestamps can't be set more than this amount\n * into the past from the block time of the deposit.\n * @param _fillDeadlineBuffer fillDeadlineBuffer to set. Fill deadlines can't be set more than this amount\n * into the future from the block time of the deposit.\n */\n /// @custom:oz-upgrades-unsafe-allow constructor\n constructor(\n address _wrappedNativeTokenAddress,\n IERC20 _circleUSDC,\n ZkBridgeLike _zkUSDCBridge,\n ITokenMessenger _cctpTokenMessenger,\n uint32 _depositQuoteTimeBuffer,\n uint32 _fillDeadlineBuffer\n )\n SpokePool(_wrappedNativeTokenAddress, _depositQuoteTimeBuffer, _fillDeadlineBuffer)\n CircleCCTPAdapter(_circleUSDC, _cctpTokenMessenger, CircleDomainIds.Ethereum)\n {\n address zero = address(0);\n if (address(_circleUSDC) != zero) {\n bool zkUSDCBridgeDisabled = address(_zkUSDCBridge) == zero;\n bool cctpUSDCBridgeDisabled = address(_cctpTokenMessenger) == zero;\n // Bridged and Native USDC are mutually exclusive.\n if (zkUSDCBridgeDisabled == cctpUSDCBridgeDisabled) {\n revert InvalidBridgeConfig();\n }\n }\n\n zkUSDCBridge = _zkUSDCBridge;\n }\n\n /**\n * @notice Initialize the ZkSync SpokePool.\n * @param _initialDepositId Starting deposit ID. Set to 0 unless this is a re-deployment in order to mitigate\n * relay hash collisions.\n * @param _zkErc20Bridge Address of L2 ERC20 gateway. Can be reset by admin.\n * @param _crossDomainAdmin Cross domain admin to set. Can be changed by admin.\n * @param _withdrawalRecipient Address which receives token withdrawals. Can be changed by admin. For Spoke Pools on L2, this will\n * likely be the hub pool.\n */\n function initialize(\n uint32 _initialDepositId,\n ZkBridgeLike _zkErc20Bridge,\n address _crossDomainAdmin,\n address _withdrawalRecipient\n ) public initializer {\n l2Eth = 0x000000000000000000000000000000000000800A;\n __SpokePool_init(_initialDepositId, _crossDomainAdmin, _withdrawalRecipient);\n _setZkBridge(_zkErc20Bridge);\n }\n\n modifier onlyFromCrossDomainAdmin() {\n require(msg.sender == CrossDomainAddressUtils.applyL1ToL2Alias(crossDomainAdmin), \"ONLY_COUNTERPART_GATEWAY\");\n _;\n }\n\n /********************************************************\n * ZKSYNC-SPECIFIC CROSS-CHAIN ADMIN FUNCTIONS *\n ********************************************************/\n\n /**\n * @notice Change L2 token bridge addresses. Callable only by admin.\n * @param _zkErc20Bridge New address of L2 ERC20 gateway.\n */\n function setZkBridge(ZkBridgeLike _zkErc20Bridge) public onlyAdmin nonReentrant {\n _setZkBridge(_zkErc20Bridge);\n }\n\n /**************************************\n * INTERNAL FUNCTIONS *\n **************************************/\n\n /**\n * @notice Wraps any ETH into WETH before executing base function. This is necessary because SpokePool receives\n * ETH over the canonical token bridge instead of WETH.\n */\n function _preExecuteLeafHook(address l2TokenAddress) internal override {\n if (l2TokenAddress == address(wrappedNativeToken)) _depositEthToWeth();\n }\n\n // Wrap any ETH owned by this contract so we can send expected L2 token to recipient. This is necessary because\n // this SpokePool will receive ETH from the canonical token bridge instead of WETH. This may not be neccessary\n // if ETH on ZkSync is treated as ETH and the fallback() function is triggered when this contract receives\n // ETH. We will have to test this but this function for now allows the contract to safely convert all of its\n // held ETH into WETH at the cost of higher gas costs.\n function _depositEthToWeth() internal {\n //slither-disable-next-line arbitrary-send-eth\n if (address(this).balance > 0) wrappedNativeToken.deposit{ value: address(this).balance }();\n }\n\n function _bridgeTokensToHubPool(uint256 amountToReturn, address l2TokenAddress) internal override {\n // SpokePool is expected to receive ETH from the L1 HubPool and currently, withdrawing ETH directly\n // over the ERC20 Bridge is blocked at the contract level. Therefore, we need to unwrap it before withdrawing.\n if (l2TokenAddress == address(wrappedNativeToken)) {\n WETH9Interface(l2TokenAddress).withdraw(amountToReturn); // Unwrap into ETH.\n // To withdraw tokens, we actually call 'withdraw' on the L2 eth token itself.\n IL2ETH(l2Eth).withdraw{ value: amountToReturn }(withdrawalRecipient);\n } else if (l2TokenAddress == address(usdcToken)) {\n if (_isCCTPEnabled()) {\n // Circle native USDC via CCTP.\n _transferUsdc(withdrawalRecipient, amountToReturn);\n } else {\n // Matter Labs custom USDC bridge for Circle Bridged (upgradable) USDC.\n IERC20(l2TokenAddress).forceApprove(address(zkUSDCBridge), amountToReturn);\n zkUSDCBridge.withdraw(withdrawalRecipient, l2TokenAddress, amountToReturn);\n }\n } else {\n zkErc20Bridge.withdraw(withdrawalRecipient, l2TokenAddress, amountToReturn);\n }\n }\n\n function _setZkBridge(ZkBridgeLike _zkErc20Bridge) internal {\n address oldErc20Bridge = address(zkErc20Bridge);\n zkErc20Bridge = _zkErc20Bridge;\n emit SetZkBridge(address(_zkErc20Bridge), oldErc20Bridge);\n }\n\n function _requireAdminSender() internal override onlyFromCrossDomainAdmin {}\n\n // Reserve storage slots for future versions of this base contract to add state variables without\n // affecting the storage layout of child contracts. Decrement the size of __gap whenever state variables\n // are added. This is at bottom of contract to make sure its always at the end of storage.\n uint256[999] private __gap;\n}\n"
+ }
+ },
+ "settings": {
+ "optimizer": {
+ "enabled": true,
+ "runs": 1000000
+ },
+ "viaIR": true,
+ "debug": {
+ "revertStrings": "strip"
+ },
+ "outputSelection": {
+ "*": {
+ "*": [
+ "abi",
+ "evm.bytecode",
+ "evm.deployedBytecode",
+ "evm.methodIdentifiers",
+ "metadata",
+ "devdoc",
+ "userdoc",
+ "storageLayout",
+ "evm.gasEstimates"
+ ],
+ "": ["ast"]
+ }
+ },
+ "metadata": {
+ "useLiteralContent": true
+ }
+ }
+}
diff --git a/deployments/worldchain/WorldChain_SpokePool.json b/deployments/worldchain/WorldChain_SpokePool.json
index 4414f9a6e..ac7eea77a 100644
--- a/deployments/worldchain/WorldChain_SpokePool.json
+++ b/deployments/worldchain/WorldChain_SpokePool.json
@@ -1,5 +1,5 @@
{
- "address": "0xAcDE84590A2ba1aCfEbB220997Eb41B7A01f271f",
+ "address": "0x1771c470d41b8c39338450C380bf2C080a2CEdD8",
"abi": [
{
"inputs": [
@@ -1271,19 +1271,6 @@
"stateMutability": "view",
"type": "function"
},
- {
- "inputs": [],
- "name": "UPDATE_ADDRESS_DEPOSIT_DETAILS_HASH",
- "outputs": [
- {
- "internalType": "bytes32",
- "name": "",
- "type": "bytes32"
- }
- ],
- "stateMutability": "view",
- "type": "function"
- },
{
"inputs": [],
"name": "UPDATE_BYTES32_DEPOSIT_DETAILS_HASH",
@@ -1361,6 +1348,19 @@
"stateMutability": "view",
"type": "function"
},
+ {
+ "inputs": [],
+ "name": "cctpV2",
+ "outputs": [
+ {
+ "internalType": "bool",
+ "name": "",
+ "type": "bool"
+ }
+ ],
+ "stateMutability": "view",
+ "type": "function"
+ },
{
"inputs": [],
"name": "chainId",
@@ -1794,30 +1794,6 @@
"stateMutability": "nonpayable",
"type": "function"
},
- {
- "inputs": [
- {
- "internalType": "address",
- "name": "",
- "type": "address"
- },
- {
- "internalType": "uint256",
- "name": "",
- "type": "uint256"
- }
- ],
- "name": "enabledDepositRoutes",
- "outputs": [
- {
- "internalType": "bool",
- "name": "",
- "type": "bool"
- }
- ],
- "stateMutability": "view",
- "type": "function"
- },
{
"inputs": [
{
@@ -2779,29 +2755,6 @@
"stateMutability": "nonpayable",
"type": "function"
},
- {
- "inputs": [
- {
- "internalType": "address",
- "name": "originToken",
- "type": "address"
- },
- {
- "internalType": "uint256",
- "name": "destinationChainId",
- "type": "uint256"
- },
- {
- "internalType": "bool",
- "name": "enabled",
- "type": "bool"
- }
- ],
- "name": "setEnableRoute",
- "outputs": [],
- "stateMutability": "nonpayable",
- "type": "function"
- },
{
"inputs": [
{
@@ -3138,9 +3091,9 @@
"type": "receive"
}
],
- "numDeployments": 5,
- "solcInputHash": "9ca5938cf4c090d09521d58c1a5ad038",
- "metadata": "{\"compiler\":{\"version\":\"0.8.23+commit.f704f362\"},\"language\":\"Solidity\",\"output\":{\"abi\":[{\"inputs\":[{\"internalType\":\"address\",\"name\":\"_wrappedNativeTokenAddress\",\"type\":\"address\"},{\"internalType\":\"uint32\",\"name\":\"_depositQuoteTimeBuffer\",\"type\":\"uint32\"},{\"internalType\":\"uint32\",\"name\":\"_fillDeadlineBuffer\",\"type\":\"uint32\"},{\"internalType\":\"contract IERC20\",\"name\":\"_l2Usdc\",\"type\":\"address\"},{\"internalType\":\"contract ITokenMessenger\",\"name\":\"_cctpTokenMessenger\",\"type\":\"address\"}],\"stateMutability\":\"nonpayable\",\"type\":\"constructor\"},{\"inputs\":[],\"name\":\"ClaimedMerkleLeaf\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"DepositsArePaused\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"DisabledRoute\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"ExpiredFillDeadline\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"FillsArePaused\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"InsufficientSpokePoolBalanceToExecuteLeaf\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"InvalidBytes32\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"InvalidChainId\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"InvalidCrossDomainAdmin\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"InvalidDepositorSignature\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"InvalidExclusiveRelayer\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"InvalidFillDeadline\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"InvalidMerkleLeaf\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"InvalidMerkleProof\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"InvalidPayoutAdjustmentPct\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"InvalidQuoteTimestamp\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"InvalidRelayerFeePct\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"InvalidSlowFillRequest\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"InvalidWithdrawalRecipient\",\"type\":\"error\"},{\"inputs\":[{\"internalType\":\"bytes\",\"name\":\"data\",\"type\":\"bytes\"}],\"name\":\"LowLevelCallFailed\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"MaxTransferSizeExceeded\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"MsgValueDoesNotMatchInputAmount\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"NoRelayerRefundToClaim\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"NoSlowFillsInExclusivityWindow\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"NotCrossChainCall\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"NotCrossDomainAdmin\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"NotEOA\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"NotExclusiveRelayer\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"RelayFilled\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"WrongERC7683OrderId\",\"type\":\"error\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address\",\"name\":\"previousAdmin\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"newAdmin\",\"type\":\"address\"}],\"name\":\"AdminChanged\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"beacon\",\"type\":\"address\"}],\"name\":\"BeaconUpgraded\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"bytes32\",\"name\":\"l2TokenAddress\",\"type\":\"bytes32\"},{\"indexed\":true,\"internalType\":\"bytes32\",\"name\":\"refundAddress\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"amount\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"address\",\"name\":\"caller\",\"type\":\"address\"}],\"name\":\"ClaimedRelayerRefund\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"uint256\",\"name\":\"rootBundleId\",\"type\":\"uint256\"}],\"name\":\"EmergencyDeletedRootBundle\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"originToken\",\"type\":\"address\"},{\"indexed\":true,\"internalType\":\"uint256\",\"name\":\"destinationChainId\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"bool\",\"name\":\"enabled\",\"type\":\"bool\"}],\"name\":\"EnabledDepositRoute\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"amountToReturn\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"uint256\",\"name\":\"chainId\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"uint256[]\",\"name\":\"refundAmounts\",\"type\":\"uint256[]\"},{\"indexed\":true,\"internalType\":\"uint32\",\"name\":\"rootBundleId\",\"type\":\"uint32\"},{\"indexed\":true,\"internalType\":\"uint32\",\"name\":\"leafId\",\"type\":\"uint32\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"l2TokenAddress\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"address[]\",\"name\":\"refundAddresses\",\"type\":\"address[]\"},{\"indexed\":false,\"internalType\":\"bool\",\"name\":\"deferredRefunds\",\"type\":\"bool\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"caller\",\"type\":\"address\"}],\"name\":\"ExecutedRelayerRefundRoot\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"bytes32\",\"name\":\"inputToken\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"bytes32\",\"name\":\"outputToken\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"inputAmount\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"outputAmount\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"repaymentChainId\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"uint256\",\"name\":\"originChainId\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"uint256\",\"name\":\"depositId\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"uint32\",\"name\":\"fillDeadline\",\"type\":\"uint32\"},{\"indexed\":false,\"internalType\":\"uint32\",\"name\":\"exclusivityDeadline\",\"type\":\"uint32\"},{\"indexed\":false,\"internalType\":\"bytes32\",\"name\":\"exclusiveRelayer\",\"type\":\"bytes32\"},{\"indexed\":true,\"internalType\":\"bytes32\",\"name\":\"relayer\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"bytes32\",\"name\":\"depositor\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"bytes32\",\"name\":\"recipient\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"bytes32\",\"name\":\"messageHash\",\"type\":\"bytes32\"},{\"components\":[{\"internalType\":\"bytes32\",\"name\":\"updatedRecipient\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"updatedMessageHash\",\"type\":\"bytes32\"},{\"internalType\":\"uint256\",\"name\":\"updatedOutputAmount\",\"type\":\"uint256\"},{\"internalType\":\"enum V3SpokePoolInterface.FillType\",\"name\":\"fillType\",\"type\":\"uint8\"}],\"indexed\":false,\"internalType\":\"struct V3SpokePoolInterface.V3RelayExecutionEventInfo\",\"name\":\"relayExecutionInfo\",\"type\":\"tuple\"}],\"name\":\"FilledRelay\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address\",\"name\":\"inputToken\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"outputToken\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"inputAmount\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"outputAmount\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"repaymentChainId\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"uint256\",\"name\":\"originChainId\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"uint32\",\"name\":\"depositId\",\"type\":\"uint32\"},{\"indexed\":false,\"internalType\":\"uint32\",\"name\":\"fillDeadline\",\"type\":\"uint32\"},{\"indexed\":false,\"internalType\":\"uint32\",\"name\":\"exclusivityDeadline\",\"type\":\"uint32\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"exclusiveRelayer\",\"type\":\"address\"},{\"indexed\":true,\"internalType\":\"address\",\"name\":\"relayer\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"depositor\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"recipient\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"},{\"components\":[{\"internalType\":\"address\",\"name\":\"updatedRecipient\",\"type\":\"address\"},{\"internalType\":\"bytes\",\"name\":\"updatedMessage\",\"type\":\"bytes\"},{\"internalType\":\"uint256\",\"name\":\"updatedOutputAmount\",\"type\":\"uint256\"},{\"internalType\":\"enum V3SpokePoolInterface.FillType\",\"name\":\"fillType\",\"type\":\"uint8\"}],\"indexed\":false,\"internalType\":\"struct V3SpokePoolInterface.LegacyV3RelayExecutionEventInfo\",\"name\":\"relayExecutionInfo\",\"type\":\"tuple\"}],\"name\":\"FilledV3Relay\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"bytes32\",\"name\":\"inputToken\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"bytes32\",\"name\":\"outputToken\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"inputAmount\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"outputAmount\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"uint256\",\"name\":\"destinationChainId\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"uint256\",\"name\":\"depositId\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"uint32\",\"name\":\"quoteTimestamp\",\"type\":\"uint32\"},{\"indexed\":false,\"internalType\":\"uint32\",\"name\":\"fillDeadline\",\"type\":\"uint32\"},{\"indexed\":false,\"internalType\":\"uint32\",\"name\":\"exclusivityDeadline\",\"type\":\"uint32\"},{\"indexed\":true,\"internalType\":\"bytes32\",\"name\":\"depositor\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"bytes32\",\"name\":\"recipient\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"bytes32\",\"name\":\"exclusiveRelayer\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"}],\"name\":\"FundsDeposited\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"uint8\",\"name\":\"version\",\"type\":\"uint8\"}],\"name\":\"Initialized\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"bool\",\"name\":\"isPaused\",\"type\":\"bool\"}],\"name\":\"PausedDeposits\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"bool\",\"name\":\"isPaused\",\"type\":\"bool\"}],\"name\":\"PausedFills\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"uint32\",\"name\":\"rootBundleId\",\"type\":\"uint32\"},{\"indexed\":true,\"internalType\":\"bytes32\",\"name\":\"relayerRefundRoot\",\"type\":\"bytes32\"},{\"indexed\":true,\"internalType\":\"bytes32\",\"name\":\"slowRelayRoot\",\"type\":\"bytes32\"}],\"name\":\"RelayedRootBundle\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"bytes32\",\"name\":\"inputToken\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"bytes32\",\"name\":\"outputToken\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"inputAmount\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"outputAmount\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"uint256\",\"name\":\"originChainId\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"uint256\",\"name\":\"depositId\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"uint32\",\"name\":\"fillDeadline\",\"type\":\"uint32\"},{\"indexed\":false,\"internalType\":\"uint32\",\"name\":\"exclusivityDeadline\",\"type\":\"uint32\"},{\"indexed\":false,\"internalType\":\"bytes32\",\"name\":\"exclusiveRelayer\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"bytes32\",\"name\":\"depositor\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"bytes32\",\"name\":\"recipient\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"bytes32\",\"name\":\"messageHash\",\"type\":\"bytes32\"}],\"name\":\"RequestedSlowFill\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"updatedOutputAmount\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"uint256\",\"name\":\"depositId\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"bytes32\",\"name\":\"depositor\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"bytes32\",\"name\":\"updatedRecipient\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"bytes\",\"name\":\"updatedMessage\",\"type\":\"bytes\"},{\"indexed\":false,\"internalType\":\"bytes\",\"name\":\"depositorSignature\",\"type\":\"bytes\"}],\"name\":\"RequestedSpeedUpDeposit\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"updatedOutputAmount\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"uint32\",\"name\":\"depositId\",\"type\":\"uint32\"},{\"indexed\":true,\"internalType\":\"address\",\"name\":\"depositor\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"updatedRecipient\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"bytes\",\"name\":\"updatedMessage\",\"type\":\"bytes\"},{\"indexed\":false,\"internalType\":\"bytes\",\"name\":\"depositorSignature\",\"type\":\"bytes\"}],\"name\":\"RequestedSpeedUpV3Deposit\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address\",\"name\":\"inputToken\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"outputToken\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"inputAmount\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"outputAmount\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"uint256\",\"name\":\"originChainId\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"uint32\",\"name\":\"depositId\",\"type\":\"uint32\"},{\"indexed\":false,\"internalType\":\"uint32\",\"name\":\"fillDeadline\",\"type\":\"uint32\"},{\"indexed\":false,\"internalType\":\"uint32\",\"name\":\"exclusivityDeadline\",\"type\":\"uint32\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"exclusiveRelayer\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"depositor\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"recipient\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"}],\"name\":\"RequestedV3SlowFill\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"uint32\",\"name\":\"newL1Gas\",\"type\":\"uint32\"}],\"name\":\"SetL1Gas\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"l2Token\",\"type\":\"address\"},{\"indexed\":true,\"internalType\":\"address\",\"name\":\"tokenBridge\",\"type\":\"address\"}],\"name\":\"SetL2TokenBridge\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"l2Token\",\"type\":\"address\"},{\"indexed\":true,\"internalType\":\"address\",\"name\":\"l1Token\",\"type\":\"address\"}],\"name\":\"SetRemoteL1Token\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"newWithdrawalRecipient\",\"type\":\"address\"}],\"name\":\"SetWithdrawalRecipient\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"newAdmin\",\"type\":\"address\"}],\"name\":\"SetXDomainAdmin\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"amountToReturn\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"uint256\",\"name\":\"chainId\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"uint32\",\"name\":\"leafId\",\"type\":\"uint32\"},{\"indexed\":true,\"internalType\":\"bytes32\",\"name\":\"l2TokenAddress\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"caller\",\"type\":\"address\"}],\"name\":\"TokensBridged\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"implementation\",\"type\":\"address\"}],\"name\":\"Upgraded\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address\",\"name\":\"inputToken\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"outputToken\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"inputAmount\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"outputAmount\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"uint256\",\"name\":\"destinationChainId\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"uint32\",\"name\":\"depositId\",\"type\":\"uint32\"},{\"indexed\":false,\"internalType\":\"uint32\",\"name\":\"quoteTimestamp\",\"type\":\"uint32\"},{\"indexed\":false,\"internalType\":\"uint32\",\"name\":\"fillDeadline\",\"type\":\"uint32\"},{\"indexed\":false,\"internalType\":\"uint32\",\"name\":\"exclusivityDeadline\",\"type\":\"uint32\"},{\"indexed\":true,\"internalType\":\"address\",\"name\":\"depositor\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"recipient\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"exclusiveRelayer\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"}],\"name\":\"V3FundsDeposited\",\"type\":\"event\"},{\"inputs\":[],\"name\":\"EMPTY_RELAYER\",\"outputs\":[{\"internalType\":\"bytes32\",\"name\":\"\",\"type\":\"bytes32\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"EMPTY_REPAYMENT_CHAIN_ID\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"INFINITE_FILL_DEADLINE\",\"outputs\":[{\"internalType\":\"uint32\",\"name\":\"\",\"type\":\"uint32\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"MAX_EXCLUSIVITY_PERIOD_SECONDS\",\"outputs\":[{\"internalType\":\"uint32\",\"name\":\"\",\"type\":\"uint32\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"MAX_TRANSFER_SIZE\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"MESSENGER\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"UPDATE_ADDRESS_DEPOSIT_DETAILS_HASH\",\"outputs\":[{\"internalType\":\"bytes32\",\"name\":\"\",\"type\":\"bytes32\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"UPDATE_BYTES32_DEPOSIT_DETAILS_HASH\",\"outputs\":[{\"internalType\":\"bytes32\",\"name\":\"\",\"type\":\"bytes32\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint32\",\"name\":\"_initialDepositId\",\"type\":\"uint32\"},{\"internalType\":\"address\",\"name\":\"_crossDomainAdmin\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"_withdrawalRecipient\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"_l2Eth\",\"type\":\"address\"}],\"name\":\"__OvmSpokePool_init\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint32\",\"name\":\"_initialDepositId\",\"type\":\"uint32\"},{\"internalType\":\"address\",\"name\":\"_crossDomainAdmin\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"_withdrawalRecipient\",\"type\":\"address\"}],\"name\":\"__SpokePool_init\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"cctpTokenMessenger\",\"outputs\":[{\"internalType\":\"contract ITokenMessenger\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"chainId\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"bytes32\",\"name\":\"l2TokenAddress\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"refundAddress\",\"type\":\"bytes32\"}],\"name\":\"claimRelayerRefund\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"crossDomainAdmin\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"bytes32\",\"name\":\"depositor\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"recipient\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"inputToken\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"outputToken\",\"type\":\"bytes32\"},{\"internalType\":\"uint256\",\"name\":\"inputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"outputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"destinationChainId\",\"type\":\"uint256\"},{\"internalType\":\"bytes32\",\"name\":\"exclusiveRelayer\",\"type\":\"bytes32\"},{\"internalType\":\"uint32\",\"name\":\"quoteTimestamp\",\"type\":\"uint32\"},{\"internalType\":\"uint32\",\"name\":\"fillDeadline\",\"type\":\"uint32\"},{\"internalType\":\"uint32\",\"name\":\"exclusivityParameter\",\"type\":\"uint32\"},{\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"}],\"name\":\"deposit\",\"outputs\":[],\"stateMutability\":\"payable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"recipient\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"originToken\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"amount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"destinationChainId\",\"type\":\"uint256\"},{\"internalType\":\"int64\",\"name\":\"relayerFeePct\",\"type\":\"int64\"},{\"internalType\":\"uint32\",\"name\":\"quoteTimestamp\",\"type\":\"uint32\"},{\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"},{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"name\":\"depositDeprecated_5947912356\",\"outputs\":[],\"stateMutability\":\"payable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"depositor\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"recipient\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"originToken\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"amount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"destinationChainId\",\"type\":\"uint256\"},{\"internalType\":\"int64\",\"name\":\"relayerFeePct\",\"type\":\"int64\"},{\"internalType\":\"uint32\",\"name\":\"quoteTimestamp\",\"type\":\"uint32\"},{\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"},{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"name\":\"depositFor\",\"outputs\":[],\"stateMutability\":\"payable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"bytes32\",\"name\":\"depositor\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"recipient\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"inputToken\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"outputToken\",\"type\":\"bytes32\"},{\"internalType\":\"uint256\",\"name\":\"inputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"outputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"destinationChainId\",\"type\":\"uint256\"},{\"internalType\":\"bytes32\",\"name\":\"exclusiveRelayer\",\"type\":\"bytes32\"},{\"internalType\":\"uint32\",\"name\":\"fillDeadlineOffset\",\"type\":\"uint32\"},{\"internalType\":\"uint32\",\"name\":\"exclusivityParameter\",\"type\":\"uint32\"},{\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"}],\"name\":\"depositNow\",\"outputs\":[],\"stateMutability\":\"payable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"depositQuoteTimeBuffer\",\"outputs\":[{\"internalType\":\"uint32\",\"name\":\"\",\"type\":\"uint32\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"depositor\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"recipient\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"inputToken\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"outputToken\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"inputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"outputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"destinationChainId\",\"type\":\"uint256\"},{\"internalType\":\"address\",\"name\":\"exclusiveRelayer\",\"type\":\"address\"},{\"internalType\":\"uint32\",\"name\":\"quoteTimestamp\",\"type\":\"uint32\"},{\"internalType\":\"uint32\",\"name\":\"fillDeadline\",\"type\":\"uint32\"},{\"internalType\":\"uint32\",\"name\":\"exclusivityParameter\",\"type\":\"uint32\"},{\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"}],\"name\":\"depositV3\",\"outputs\":[],\"stateMutability\":\"payable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"depositor\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"recipient\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"inputToken\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"outputToken\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"inputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"outputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"destinationChainId\",\"type\":\"uint256\"},{\"internalType\":\"address\",\"name\":\"exclusiveRelayer\",\"type\":\"address\"},{\"internalType\":\"uint32\",\"name\":\"fillDeadlineOffset\",\"type\":\"uint32\"},{\"internalType\":\"uint32\",\"name\":\"exclusivityParameter\",\"type\":\"uint32\"},{\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"}],\"name\":\"depositV3Now\",\"outputs\":[],\"stateMutability\":\"payable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint256\",\"name\":\"rootBundleId\",\"type\":\"uint256\"}],\"name\":\"emergencyDeleteRootBundle\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"name\":\"enabledDepositRoutes\",\"outputs\":[{\"internalType\":\"bool\",\"name\":\"\",\"type\":\"bool\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint32\",\"name\":\"rootBundleId\",\"type\":\"uint32\"},{\"components\":[{\"internalType\":\"uint256\",\"name\":\"amountToReturn\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"chainId\",\"type\":\"uint256\"},{\"internalType\":\"uint256[]\",\"name\":\"refundAmounts\",\"type\":\"uint256[]\"},{\"internalType\":\"uint32\",\"name\":\"leafId\",\"type\":\"uint32\"},{\"internalType\":\"address\",\"name\":\"l2TokenAddress\",\"type\":\"address\"},{\"internalType\":\"address[]\",\"name\":\"refundAddresses\",\"type\":\"address[]\"}],\"internalType\":\"struct SpokePoolInterface.RelayerRefundLeaf\",\"name\":\"relayerRefundLeaf\",\"type\":\"tuple\"},{\"internalType\":\"bytes32[]\",\"name\":\"proof\",\"type\":\"bytes32[]\"}],\"name\":\"executeRelayerRefundLeaf\",\"outputs\":[],\"stateMutability\":\"payable\",\"type\":\"function\"},{\"inputs\":[{\"components\":[{\"components\":[{\"internalType\":\"bytes32\",\"name\":\"depositor\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"recipient\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"exclusiveRelayer\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"inputToken\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"outputToken\",\"type\":\"bytes32\"},{\"internalType\":\"uint256\",\"name\":\"inputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"outputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"originChainId\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"depositId\",\"type\":\"uint256\"},{\"internalType\":\"uint32\",\"name\":\"fillDeadline\",\"type\":\"uint32\"},{\"internalType\":\"uint32\",\"name\":\"exclusivityDeadline\",\"type\":\"uint32\"},{\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"}],\"internalType\":\"struct V3SpokePoolInterface.V3RelayData\",\"name\":\"relayData\",\"type\":\"tuple\"},{\"internalType\":\"uint256\",\"name\":\"chainId\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"updatedOutputAmount\",\"type\":\"uint256\"}],\"internalType\":\"struct V3SpokePoolInterface.V3SlowFill\",\"name\":\"slowFillLeaf\",\"type\":\"tuple\"},{\"internalType\":\"uint32\",\"name\":\"rootBundleId\",\"type\":\"uint32\"},{\"internalType\":\"bytes32[]\",\"name\":\"proof\",\"type\":\"bytes32[]\"}],\"name\":\"executeSlowRelayLeaf\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"bytes32\",\"name\":\"orderId\",\"type\":\"bytes32\"},{\"internalType\":\"bytes\",\"name\":\"originData\",\"type\":\"bytes\"},{\"internalType\":\"bytes\",\"name\":\"fillerData\",\"type\":\"bytes\"}],\"name\":\"fill\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"fillDeadlineBuffer\",\"outputs\":[{\"internalType\":\"uint32\",\"name\":\"\",\"type\":\"uint32\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"components\":[{\"internalType\":\"bytes32\",\"name\":\"depositor\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"recipient\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"exclusiveRelayer\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"inputToken\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"outputToken\",\"type\":\"bytes32\"},{\"internalType\":\"uint256\",\"name\":\"inputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"outputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"originChainId\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"depositId\",\"type\":\"uint256\"},{\"internalType\":\"uint32\",\"name\":\"fillDeadline\",\"type\":\"uint32\"},{\"internalType\":\"uint32\",\"name\":\"exclusivityDeadline\",\"type\":\"uint32\"},{\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"}],\"internalType\":\"struct V3SpokePoolInterface.V3RelayData\",\"name\":\"relayData\",\"type\":\"tuple\"},{\"internalType\":\"uint256\",\"name\":\"repaymentChainId\",\"type\":\"uint256\"},{\"internalType\":\"bytes32\",\"name\":\"repaymentAddress\",\"type\":\"bytes32\"}],\"name\":\"fillRelay\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"components\":[{\"internalType\":\"bytes32\",\"name\":\"depositor\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"recipient\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"exclusiveRelayer\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"inputToken\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"outputToken\",\"type\":\"bytes32\"},{\"internalType\":\"uint256\",\"name\":\"inputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"outputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"originChainId\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"depositId\",\"type\":\"uint256\"},{\"internalType\":\"uint32\",\"name\":\"fillDeadline\",\"type\":\"uint32\"},{\"internalType\":\"uint32\",\"name\":\"exclusivityDeadline\",\"type\":\"uint32\"},{\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"}],\"internalType\":\"struct V3SpokePoolInterface.V3RelayData\",\"name\":\"relayData\",\"type\":\"tuple\"},{\"internalType\":\"uint256\",\"name\":\"repaymentChainId\",\"type\":\"uint256\"},{\"internalType\":\"bytes32\",\"name\":\"repaymentAddress\",\"type\":\"bytes32\"},{\"internalType\":\"uint256\",\"name\":\"updatedOutputAmount\",\"type\":\"uint256\"},{\"internalType\":\"bytes32\",\"name\":\"updatedRecipient\",\"type\":\"bytes32\"},{\"internalType\":\"bytes\",\"name\":\"updatedMessage\",\"type\":\"bytes\"},{\"internalType\":\"bytes\",\"name\":\"depositorSignature\",\"type\":\"bytes\"}],\"name\":\"fillRelayWithUpdatedDeposit\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"bytes32\",\"name\":\"\",\"type\":\"bytes32\"}],\"name\":\"fillStatuses\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"components\":[{\"internalType\":\"address\",\"name\":\"depositor\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"recipient\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"exclusiveRelayer\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"inputToken\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"outputToken\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"inputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"outputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"originChainId\",\"type\":\"uint256\"},{\"internalType\":\"uint32\",\"name\":\"depositId\",\"type\":\"uint32\"},{\"internalType\":\"uint32\",\"name\":\"fillDeadline\",\"type\":\"uint32\"},{\"internalType\":\"uint32\",\"name\":\"exclusivityDeadline\",\"type\":\"uint32\"},{\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"}],\"internalType\":\"struct V3SpokePoolInterface.V3RelayDataLegacy\",\"name\":\"relayData\",\"type\":\"tuple\"},{\"internalType\":\"uint256\",\"name\":\"repaymentChainId\",\"type\":\"uint256\"}],\"name\":\"fillV3Relay\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"getCurrentTime\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"l2TokenAddress\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"refundAddress\",\"type\":\"address\"}],\"name\":\"getRelayerRefund\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"msgSender\",\"type\":\"address\"},{\"internalType\":\"bytes32\",\"name\":\"depositor\",\"type\":\"bytes32\"},{\"internalType\":\"uint256\",\"name\":\"depositNonce\",\"type\":\"uint256\"}],\"name\":\"getUnsafeDepositId\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"pure\",\"type\":\"function\"},{\"inputs\":[{\"components\":[{\"internalType\":\"bytes32\",\"name\":\"depositor\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"recipient\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"exclusiveRelayer\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"inputToken\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"outputToken\",\"type\":\"bytes32\"},{\"internalType\":\"uint256\",\"name\":\"inputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"outputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"originChainId\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"depositId\",\"type\":\"uint256\"},{\"internalType\":\"uint32\",\"name\":\"fillDeadline\",\"type\":\"uint32\"},{\"internalType\":\"uint32\",\"name\":\"exclusivityDeadline\",\"type\":\"uint32\"},{\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"}],\"internalType\":\"struct V3SpokePoolInterface.V3RelayData\",\"name\":\"relayData\",\"type\":\"tuple\"}],\"name\":\"getV3RelayHash\",\"outputs\":[{\"internalType\":\"bytes32\",\"name\":\"\",\"type\":\"bytes32\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint32\",\"name\":\"_initialDepositId\",\"type\":\"uint32\"},{\"internalType\":\"address\",\"name\":\"_crossDomainAdmin\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"_withdrawalRecipient\",\"type\":\"address\"}],\"name\":\"initialize\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"l1Gas\",\"outputs\":[{\"internalType\":\"uint32\",\"name\":\"\",\"type\":\"uint32\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"l2Eth\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"bytes[]\",\"name\":\"data\",\"type\":\"bytes[]\"}],\"name\":\"multicall\",\"outputs\":[{\"internalType\":\"bytes[]\",\"name\":\"results\",\"type\":\"bytes[]\"}],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"numberOfDeposits\",\"outputs\":[{\"internalType\":\"uint32\",\"name\":\"\",\"type\":\"uint32\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"bool\",\"name\":\"pause\",\"type\":\"bool\"}],\"name\":\"pauseDeposits\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"bool\",\"name\":\"pause\",\"type\":\"bool\"}],\"name\":\"pauseFills\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"pausedDeposits\",\"outputs\":[{\"internalType\":\"bool\",\"name\":\"\",\"type\":\"bool\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"pausedFills\",\"outputs\":[{\"internalType\":\"bool\",\"name\":\"\",\"type\":\"bool\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"proxiableUUID\",\"outputs\":[{\"internalType\":\"bytes32\",\"name\":\"\",\"type\":\"bytes32\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"recipientCircleDomainId\",\"outputs\":[{\"internalType\":\"uint32\",\"name\":\"\",\"type\":\"uint32\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"bytes32\",\"name\":\"relayerRefundRoot\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"slowRelayRoot\",\"type\":\"bytes32\"}],\"name\":\"relayRootBundle\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"name\":\"relayerRefund\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"name\":\"remoteL1Tokens\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"components\":[{\"internalType\":\"bytes32\",\"name\":\"depositor\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"recipient\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"exclusiveRelayer\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"inputToken\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"outputToken\",\"type\":\"bytes32\"},{\"internalType\":\"uint256\",\"name\":\"inputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"outputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"originChainId\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"depositId\",\"type\":\"uint256\"},{\"internalType\":\"uint32\",\"name\":\"fillDeadline\",\"type\":\"uint32\"},{\"internalType\":\"uint32\",\"name\":\"exclusivityDeadline\",\"type\":\"uint32\"},{\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"}],\"internalType\":\"struct V3SpokePoolInterface.V3RelayData\",\"name\":\"relayData\",\"type\":\"tuple\"}],\"name\":\"requestSlowFill\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"name\":\"rootBundles\",\"outputs\":[{\"internalType\":\"bytes32\",\"name\":\"slowRelayRoot\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"relayerRefundRoot\",\"type\":\"bytes32\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"newCrossDomainAdmin\",\"type\":\"address\"}],\"name\":\"setCrossDomainAdmin\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"originToken\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"destinationChainId\",\"type\":\"uint256\"},{\"internalType\":\"bool\",\"name\":\"enabled\",\"type\":\"bool\"}],\"name\":\"setEnableRoute\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint32\",\"name\":\"newl1Gas\",\"type\":\"uint32\"}],\"name\":\"setL1GasLimit\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"l2Token\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"l1Token\",\"type\":\"address\"}],\"name\":\"setRemoteL1Token\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"l2Token\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"tokenBridge\",\"type\":\"address\"}],\"name\":\"setTokenBridge\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"newWithdrawalRecipient\",\"type\":\"address\"}],\"name\":\"setWithdrawalRecipient\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"bytes32\",\"name\":\"depositor\",\"type\":\"bytes32\"},{\"internalType\":\"uint256\",\"name\":\"depositId\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"updatedOutputAmount\",\"type\":\"uint256\"},{\"internalType\":\"bytes32\",\"name\":\"updatedRecipient\",\"type\":\"bytes32\"},{\"internalType\":\"bytes\",\"name\":\"updatedMessage\",\"type\":\"bytes\"},{\"internalType\":\"bytes\",\"name\":\"depositorSignature\",\"type\":\"bytes\"}],\"name\":\"speedUpDeposit\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"depositor\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"depositId\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"updatedOutputAmount\",\"type\":\"uint256\"},{\"internalType\":\"address\",\"name\":\"updatedRecipient\",\"type\":\"address\"},{\"internalType\":\"bytes\",\"name\":\"updatedMessage\",\"type\":\"bytes\"},{\"internalType\":\"bytes\",\"name\":\"depositorSignature\",\"type\":\"bytes\"}],\"name\":\"speedUpV3Deposit\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"name\":\"tokenBridges\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"bytes[]\",\"name\":\"data\",\"type\":\"bytes[]\"}],\"name\":\"tryMulticall\",\"outputs\":[{\"components\":[{\"internalType\":\"bool\",\"name\":\"success\",\"type\":\"bool\"},{\"internalType\":\"bytes\",\"name\":\"returnData\",\"type\":\"bytes\"}],\"internalType\":\"struct MultiCallerUpgradeable.Result[]\",\"name\":\"results\",\"type\":\"tuple[]\"}],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"bytes32\",\"name\":\"depositor\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"recipient\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"inputToken\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"outputToken\",\"type\":\"bytes32\"},{\"internalType\":\"uint256\",\"name\":\"inputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"outputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"destinationChainId\",\"type\":\"uint256\"},{\"internalType\":\"bytes32\",\"name\":\"exclusiveRelayer\",\"type\":\"bytes32\"},{\"internalType\":\"uint256\",\"name\":\"depositNonce\",\"type\":\"uint256\"},{\"internalType\":\"uint32\",\"name\":\"quoteTimestamp\",\"type\":\"uint32\"},{\"internalType\":\"uint32\",\"name\":\"fillDeadline\",\"type\":\"uint32\"},{\"internalType\":\"uint32\",\"name\":\"exclusivityParameter\",\"type\":\"uint32\"},{\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"}],\"name\":\"unsafeDeposit\",\"outputs\":[],\"stateMutability\":\"payable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"newImplementation\",\"type\":\"address\"}],\"name\":\"upgradeTo\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"newImplementation\",\"type\":\"address\"},{\"internalType\":\"bytes\",\"name\":\"data\",\"type\":\"bytes\"}],\"name\":\"upgradeToAndCall\",\"outputs\":[],\"stateMutability\":\"payable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"usdcToken\",\"outputs\":[{\"internalType\":\"contract IERC20\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"withdrawalRecipient\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"wrappedNativeToken\",\"outputs\":[{\"internalType\":\"contract WETH9Interface\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"stateMutability\":\"payable\",\"type\":\"receive\"}],\"devdoc\":{\"custom:security-contact\":\"bugs@across.to\",\"events\":{\"AdminChanged(address,address)\":{\"details\":\"Emitted when the admin account has changed.\"},\"BeaconUpgraded(address)\":{\"details\":\"Emitted when the beacon is changed.\"},\"Initialized(uint8)\":{\"details\":\"Triggered when the contract has been initialized or reinitialized.\"},\"Upgraded(address)\":{\"details\":\"Emitted when the implementation is upgraded.\"}},\"kind\":\"dev\",\"methods\":{\"__OvmSpokePool_init(uint32,address,address,address)\":{\"params\":{\"_crossDomainAdmin\":\"Cross domain admin to set. Can be changed by admin.\",\"_initialDepositId\":\"Starting deposit ID. Set to 0 unless this is a re-deployment in order to mitigate relay hash collisions.\",\"_l2Eth\":\"Address of L2 ETH token. Usually should be Lib_PreeployAddresses.OVM_ETH but sometimes this can be different, like with Boba which flips the WETH and OVM_ETH addresses.\",\"_withdrawalRecipient\":\"Address which receives token withdrawals. Can be changed by admin. For Spoke Pools on L2, this will likely be the hub pool.\"}},\"__SpokePool_init(uint32,address,address)\":{\"params\":{\"_crossDomainAdmin\":\"Cross domain admin to set. Can be changed by admin.\",\"_initialDepositId\":\"Starting deposit ID. Set to 0 unless this is a re-deployment in order to mitigate relay hash collisions.\",\"_withdrawalRecipient\":\"Address which receives token withdrawals. Can be changed by admin. For Spoke Pools on L2, this will likely be the hub pool.\"}},\"chainId()\":{\"details\":\"Some L2s like ZKSync don't support the CHAIN_ID opcode so we allow the implementer to override this.\"},\"claimRelayerRefund(bytes32,bytes32)\":{\"params\":{\"l2TokenAddress\":\"Address of the L2 token to claim refunds for.\",\"refundAddress\":\"Address to send the refund to.\"}},\"constructor\":{\"custom:oz-upgrades-unsafe-allow\":\"constructor\"},\"deposit(bytes32,bytes32,bytes32,bytes32,uint256,uint256,uint256,bytes32,uint32,uint32,uint32,bytes)\":{\"details\":\"On the destination chain, the hash of the deposit data will be used to uniquely identify this deposit, so modifying any params in it will result in a different hash and a different deposit. The hash will comprise all parameters to this function along with this chain's chainId(). Relayers are only refunded for filling deposits with deposit hashes that map exactly to the one emitted by this contract.\",\"params\":{\"depositor\":\"The account credited with the deposit who can request to \\\"speed up\\\" this deposit by modifying the output amount, recipient, and message.\",\"destinationChainId\":\"The destination chain identifier. Must be enabled along with the input token as a valid deposit route from this spoke pool or this transaction will revert.\",\"exclusiveRelayer\":\"The relayer that will be exclusively allowed to fill this deposit before the exclusivity deadline timestamp. This must be a valid, non-zero address if the exclusivity deadline is greater than the current block.timestamp. If the exclusivity deadline is < currentTime, then this must be address(0), and vice versa if this is address(0).\",\"exclusivityParameter\":\"This value is used to set the exclusivity deadline timestamp in the emitted deposit event. Before this destination chain timestamp, only the exclusiveRelayer (if set to a non-zero address), can fill this deposit. There are three ways to use this parameter: 1. NO EXCLUSIVITY: If this value is set to 0, then a timestamp of 0 will be emitted, meaning that there is no exclusivity period. 2. OFFSET: If this value is less than MAX_EXCLUSIVITY_PERIOD_SECONDS, then add this value to the block.timestamp to derive the exclusive relayer deadline. Note that using the parameter in this way will expose the filler of the deposit to the risk that the block.timestamp of this event gets changed due to a chain-reorg, which would also change the exclusivity timestamp. 3. TIMESTAMP: Otherwise, set this value as the exclusivity deadline timestamp. which is the deadline for the exclusiveRelayer to fill the deposit.\",\"fillDeadline\":\"The deadline for the relayer to fill the deposit. After this destination chain timestamp, the fill will revert on the destination chain. Must be set before currentTime + fillDeadlineBuffer, where currentTime is block.timestamp on this chain or this transaction will revert.\",\"inputAmount\":\"The amount of input tokens to pull from the caller's account and lock into this contract. This amount will be sent to the relayer on their repayment chain of choice as a refund following an optimistic challenge window in the HubPool, less a system fee.\",\"inputToken\":\"The token pulled from the caller's account and locked into this contract to initiate the deposit. The equivalent of this token on the relayer's repayment chain of choice will be sent as a refund. If this is equal to the wrapped native token then the caller can optionally pass in native token as msg.value, as long as msg.value = inputTokenAmount.\",\"message\":\"The message to send to the recipient on the destination chain if the recipient is a contract. If the message is not empty, the recipient contract must implement handleV3AcrossMessage() or the fill will revert.\",\"outputAmount\":\"The amount of output tokens that the relayer will send to the recipient on the destination.\",\"outputToken\":\"The token that the relayer will send to the recipient on the destination chain. Must be an ERC20.\",\"quoteTimestamp\":\"The HubPool timestamp that is used to determine the system fee paid by the depositor. This must be set to some time between [currentTime - depositQuoteTimeBuffer, currentTime] where currentTime is block.timestamp on this chain or this transaction will revert.\",\"recipient\":\"The account receiving funds on the destination chain. Can be an EOA or a contract. If the output token is the wrapped native token for the chain, then the recipient will receive native token if an EOA or wrapped native token if a contract.\"}},\"depositDeprecated_5947912356(address,address,uint256,uint256,int64,uint32,bytes,uint256)\":{\"details\":\"DEPRECATION NOTICE: this function is deprecated and will be removed in the future. Please use deposit (under DEPOSITOR FUNCTIONS below) or depositV3 instead.Produces a FundsDeposited event with an infinite expiry, meaning that this deposit can never expire. Moreover, the event's outputToken is set to 0x0 meaning that this deposit can always be slow filled.\",\"params\":{\"amount\":\"Amount of tokens to deposit. Will be amount of tokens to receive less fees.\",\"destinationChainId\":\"Denotes network where user will receive funds from SpokePool by a relayer.\",\"message\":\"Arbitrary data that can be used to pass additional information to the recipient along with the tokens. Note: this is intended to be used to pass along instructions for how a contract should use or allocate the tokens.\",\"originToken\":\"Token to lock into this contract to initiate deposit.\",\"quoteTimestamp\":\"Timestamp used by relayers to compute this deposit's realizedLPFeePct which is paid to LP pool on HubPool.\",\"recipient\":\"Address to receive funds at on destination chain.\",\"relayerFeePct\":\"% of deposit amount taken out to incentivize a fast relayer.\"}},\"depositFor(address,address,address,uint256,uint256,int64,uint32,bytes,uint256)\":{\"details\":\"DEPRECATION NOTICE: this function is deprecated and will be removed in the future. Please use the other deposit or depositV3 instead.\",\"params\":{\"amount\":\"Amount of tokens to deposit. Will be amount of tokens to receive less fees.\",\"depositor\":\"Address who is credited for depositing funds on origin chain and can speed up the deposit.\",\"destinationChainId\":\"Denotes network where user will receive funds from SpokePool by a relayer.\",\"message\":\"Arbitrary data that can be used to pass additional information to the recipient along with the tokens. Note: this is intended to be used to pass along instructions for how a contract should use or allocate the tokens.\",\"originToken\":\"Token to lock into this contract to initiate deposit.\",\"quoteTimestamp\":\"Timestamp used by relayers to compute this deposit's realizedLPFeePct which is paid to LP pool on HubPool.\",\"recipient\":\"Address to receive funds at on destination chain.\",\"relayerFeePct\":\"% of deposit amount taken out to incentivize a fast relayer.\"}},\"depositNow(bytes32,bytes32,bytes32,bytes32,uint256,uint256,uint256,bytes32,uint32,uint32,bytes)\":{\"params\":{\"depositor\":\"The account credited with the deposit who can request to \\\"speed up\\\" this deposit by modifying the output amount, recipient, and message.\",\"destinationChainId\":\"The destination chain identifier. Must be enabled along with the input token as a valid deposit route from this spoke pool or this transaction will revert.\",\"exclusiveRelayer\":\"The relayer that will be exclusively allowed to fill this deposit before the exclusivity deadline timestamp.\",\"exclusivityParameter\":\"See identically named parameter in deposit() comments.\",\"fillDeadlineOffset\":\"Added to the current time to set the fill deadline, which is the deadline for the relayer to fill the deposit. After this destination chain timestamp, the fill will revert on the destination chain.\",\"inputAmount\":\"The amount of input tokens to pull from the caller's account and lock into this contract. This amount will be sent to the relayer on their repayment chain of choice as a refund following an optimistic challenge window in the HubPool, plus a system fee.\",\"inputToken\":\"The token pulled from the caller's account and locked into this contract to initiate the deposit. The equivalent of this token on the relayer's repayment chain of choice will be sent as a refund. If this is equal to the wrapped native token then the caller can optionally pass in native token as msg.value, as long as msg.value = inputTokenAmount.\",\"message\":\"The message to send to the recipient on the destination chain if the recipient is a contract. If the message is not empty, the recipient contract must implement handleV3AcrossMessage() or the fill will revert.\",\"outputAmount\":\"The amount of output tokens that the relayer will send to the recipient on the destination.\",\"outputToken\":\"The token that the relayer will send to the recipient on the destination chain. Must be an ERC20.\",\"recipient\":\"The account receiving funds on the destination chain. Can be an EOA or a contract. If the output token is the wrapped native token for the chain, then the recipient will receive native token if an EOA or wrapped native token if a contract.\"}},\"depositV3(address,address,address,address,uint256,uint256,uint256,address,uint32,uint32,uint32,bytes)\":{\"details\":\"This version mirrors the original `depositV3` function, but uses `address` types for `depositor`, `recipient`, `inputToken`, `outputToken`, and `exclusiveRelayer` for compatibility with contracts using the `address` type. The key functionality and logic remain identical, ensuring interoperability across both versions.\",\"params\":{\"depositor\":\"The account credited with the deposit who can request to \\\"speed up\\\" this deposit by modifying the output amount, recipient, and message.\",\"destinationChainId\":\"The destination chain identifier. Must be enabled along with the input token as a valid deposit route from this spoke pool or this transaction will revert.\",\"exclusiveRelayer\":\"The relayer exclusively allowed to fill this deposit before the exclusivity deadline.\",\"exclusivityParameter\":\"This value is used to set the exclusivity deadline timestamp in the emitted deposit event. Before this destination chain timestamp, only the exclusiveRelayer (if set to a non-zero address), can fill this deposit. There are three ways to use this parameter: 1. NO EXCLUSIVITY: If this value is set to 0, then a timestamp of 0 will be emitted, meaning that there is no exclusivity period. 2. OFFSET: If this value is less than MAX_EXCLUSIVITY_PERIOD_SECONDS, then add this value to the block.timestamp to derive the exclusive relayer deadline. Note that using the parameter in this way will expose the filler of the deposit to the risk that the block.timestamp of this event gets changed due to a chain-reorg, which would also change the exclusivity timestamp. 3. TIMESTAMP: Otherwise, set this value as the exclusivity deadline timestamp. which is the deadline for the exclusiveRelayer to fill the deposit.\",\"fillDeadline\":\"The deadline for the relayer to fill the deposit. After this destination chain timestamp, the fill will revert on the destination chain. Must be set before currentTime + fillDeadlineBuffer, where currentTime is block.timestamp on this chain.\",\"inputAmount\":\"The amount of input tokens pulled from the caller's account and locked into this contract. This amount will be sent to the relayer as a refund following an optimistic challenge window in the HubPool, less a system fee.\",\"inputToken\":\"The token pulled from the caller's account and locked into this contract to initiate the deposit. The equivalent of this token on the relayer's repayment chain of choice will be sent as a refund. If this is equal to the wrapped native token, the caller can optionally pass in native token as msg.value, provided msg.value = inputTokenAmount.\",\"message\":\"The message to send to the recipient on the destination chain if the recipient is a contract. If the message is not empty, the recipient contract must implement `handleV3AcrossMessage()` or the fill will revert.\",\"outputAmount\":\"The amount of output tokens that the relayer will send to the recipient on the destination.\",\"outputToken\":\"The token that the relayer will send to the recipient on the destination chain. Must be an ERC20.\",\"quoteTimestamp\":\"The HubPool timestamp that determines the system fee paid by the depositor. This must be set between [currentTime - depositQuoteTimeBuffer, currentTime] where currentTime is block.timestamp on this chain.\",\"recipient\":\"The account receiving funds on the destination chain. Can be an EOA or a contract. If the output token is the wrapped native token for the chain, then the recipient will receive native token if an EOA or wrapped native token if a contract.\"}},\"depositV3Now(address,address,address,address,uint256,uint256,uint256,address,uint32,uint32,bytes)\":{\"details\":\"This version is identical to the original `depositV3Now` but uses `address` types for `depositor`, `recipient`, `inputToken`, `outputToken`, and `exclusiveRelayer` to support compatibility with older systems. It maintains the same logic and purpose, ensuring interoperability with both versions.\",\"params\":{\"depositor\":\"The account credited with the deposit, who can request to \\\"speed up\\\" this deposit by modifying the output amount, recipient, and message.\",\"destinationChainId\":\"The destination chain identifier. Must be enabled with the input token as a valid deposit route from this spoke pool, or the transaction will revert.\",\"exclusiveRelayer\":\"The relayer exclusively allowed to fill the deposit before the exclusivity deadline.\",\"exclusivityParameter\":\"See identically named parameter in deposit() comments.\",\"fillDeadlineOffset\":\"Added to the current time to set the fill deadline. After this timestamp, fills on the destination chain will revert.\",\"inputAmount\":\"The amount of input tokens pulled from the caller's account and locked into this contract. This amount will be sent to the relayer as a refund following an optimistic challenge window in the HubPool, plus a system fee.\",\"inputToken\":\"The token pulled from the caller's account and locked into this contract to initiate the deposit. Equivalent tokens on the relayer's repayment chain will be sent as a refund. If this is the wrapped native token, msg.value must equal inputTokenAmount when passed.\",\"message\":\"The message to send to the recipient on the destination chain. If the recipient is a contract, it must implement `handleV3AcrossMessage()` if the message is not empty, or the fill will revert.\",\"outputAmount\":\"The amount of output tokens the relayer will send to the recipient on the destination.\",\"outputToken\":\"The token the relayer will send to the recipient on the destination chain. Must be an ERC20.\",\"recipient\":\"The account receiving funds on the destination chain. Can be an EOA or a contract. If the output token is the wrapped native token for the chain, then the recipient will receive the native token if an EOA or wrapped native token if a contract.\"}},\"emergencyDeleteRootBundle(uint256)\":{\"params\":{\"rootBundleId\":\"Index of the root bundle that needs to be deleted. Note: this is intentionally a uint256 to ensure that a small input range doesn't limit which indices this method is able to reach.\"}},\"executeRelayerRefundLeaf(uint32,(uint256,uint256,uint256[],uint32,address,address[]),bytes32[])\":{\"params\":{\"proof\":\"Inclusion proof for this leaf in relayer refund root in root bundle.\",\"relayerRefundLeaf\":\"Contains all data necessary to reconstruct leaf contained in root bundle and to refund relayer. This data structure is explained in detail in the SpokePoolInterface.\",\"rootBundleId\":\"Unique ID of root bundle containing relayer refund root that this leaf is contained in.\"}},\"executeSlowRelayLeaf(((bytes32,bytes32,bytes32,bytes32,bytes32,uint256,uint256,uint256,uint256,uint32,uint32,bytes),uint256,uint256),uint32,bytes32[])\":{\"details\":\"Executing a slow fill leaf is equivalent to filling the relayData so this function cannot be used to double fill a recipient. The relayData that is filled is included in the slowFillLeaf and is hashed like any other fill sent through a fill method.There is no relayer credited with filling this relay since funds are sent directly out of this contract.\",\"params\":{\"proof\":\"Inclusion proof for this leaf in slow relay root in root bundle.\",\"rootBundleId\":\"Unique ID of root bundle containing slow relay root that this leaf is contained in.\",\"slowFillLeaf\":\"Contains all data necessary to uniquely identify a relay for this chain. This struct is hashed and included in a merkle root that is relayed to all spoke pools. - relayData: struct containing all the data needed to identify the original deposit to be slow filled. - chainId: chain identifier where slow fill leaf should be executed. If this doesn't match this chain's chainId, then this function will revert. - updatedOutputAmount: Amount to be sent to recipient out of this contract's balance. Can be set differently from relayData.outputAmount to charge a different fee because this deposit was \\\"slow\\\" filled. Usually, this will be set higher to reimburse the recipient for waiting for the slow fill.\"}},\"fill(bytes32,bytes,bytes)\":{\"details\":\"ERC-7683 fill function.\",\"params\":{\"fillerData\":\"Data provided by the filler to inform the fill or express their preferences\",\"orderId\":\"Unique order identifier for this order\",\"originData\":\"Data emitted on the origin to parameterize the fill\"}},\"fillRelay((bytes32,bytes32,bytes32,bytes32,bytes32,uint256,uint256,uint256,uint256,uint32,uint32,bytes),uint256,bytes32)\":{\"details\":\"The fee paid to relayers and the system should be captured in the spread between output amount and input amount when adjusted to be denominated in the input token. A relayer on the destination chain will send outputAmount of outputTokens to the recipient and receive inputTokens on a repayment chain of their choice. Therefore, the fee should account for destination fee transaction costs, the relayer's opportunity cost of capital while they wait to be refunded following an optimistic challenge window in the HubPool, and a system fee charged to relayers.The hash of the relayData will be used to uniquely identify the deposit to fill, so modifying any params in it will result in a different hash and a different deposit. The hash will comprise all parameters passed to deposit() on the origin chain along with that chain's chainId(). This chain's chainId() must therefore match the destinationChainId passed into deposit. Relayers are only refunded for filling deposits with deposit hashes that map exactly to the one emitted by the origin SpokePool therefore the relayer should not modify any params in relayData.Cannot fill more than once. Partial fills are not supported.\",\"params\":{\"relayData\":\"struct containing all the data needed to identify the deposit to be filled. Should match all the same-named parameters emitted in the origin chain FundsDeposited event. - depositor: The account credited with the deposit who can request to \\\"speed up\\\" this deposit by modifying the output amount, recipient, and message. - recipient The account receiving funds on this chain. Can be an EOA or a contract. If the output token is the wrapped native token for the chain, then the recipient will receive native token if an EOA or wrapped native token if a contract. - inputToken: The token pulled from the caller's account to initiate the deposit. The equivalent of this token on the repayment chain will be sent as a refund to the caller. - outputToken The token that the caller will send to the recipient on the destination chain. Must be an ERC20. - inputAmount: This amount, less a system fee, will be sent to the caller on their repayment chain of choice as a refund following an optimistic challenge window in the HubPool. - outputAmount: The amount of output tokens that the caller will send to the recipient. - originChainId: The origin chain identifier. - exclusiveRelayer The relayer that will be exclusively allowed to fill this deposit before the exclusivity deadline timestamp. - fillDeadline The deadline for the caller to fill the deposit. After this timestamp, the fill will revert on the destination chain. - exclusivityDeadline: The deadline for the exclusive relayer to fill the deposit. After this timestamp, anyone can fill this deposit. Note that if this value was set in deposit by adding an offset to the deposit's block.timestamp, there is re-org risk for the caller of this method because the event's block.timestamp can change. Read the comments in `deposit` about the `exclusivityParameter` for more details. - message The message to send to the recipient if the recipient is a contract that implements a handleV3AcrossMessage() public function\",\"repaymentAddress\":\"Address the relayer wants to be receive their refund at.\",\"repaymentChainId\":\"Chain of SpokePool where relayer wants to be refunded after the challenge window has passed. Will receive inputAmount of the equivalent token to inputToken on the repayment chain.\"}},\"fillRelayWithUpdatedDeposit((bytes32,bytes32,bytes32,bytes32,bytes32,uint256,uint256,uint256,uint256,uint32,uint32,bytes),uint256,bytes32,uint256,bytes32,bytes,bytes)\":{\"details\":\"Subject to same exclusivity deadline rules as fillV3Relay().\",\"params\":{\"depositorSignature\":\"Signed EIP712 hashstruct containing the deposit ID. Should be signed by the depositor account.\",\"relayData\":\"struct containing all the data needed to identify the deposit to be filled. See fillV3Relay().\",\"repaymentAddress\":\"Address the relayer wants to be receive their refund at.\",\"repaymentChainId\":\"Chain of SpokePool where relayer wants to be refunded after the challenge window has passed. See fillV3Relay().\",\"updatedMessage\":\"New message to use for this deposit.\",\"updatedOutputAmount\":\"New output amount to use for this deposit.\",\"updatedRecipient\":\"New recipient to use for this deposit.\"}},\"getCurrentTime()\":{\"returns\":{\"_0\":\"uint for the current timestamp.\"}},\"getUnsafeDepositId(address,bytes32,uint256)\":{\"details\":\"msgSender and depositor are both used as inputs to allow passthrough depositors to create unique deposit hash spaces for unique depositors.\",\"params\":{\"depositNonce\":\"The nonce used as input to produce the deposit ID.\",\"depositor\":\"The depositor address used as input to produce the deposit ID.\",\"msgSender\":\"The caller of the transaction used as input to produce the deposit ID.\"},\"returns\":{\"_0\":\"The deposit ID for the unsafe deposit.\"}},\"initialize(uint32,address,address)\":{\"params\":{\"_crossDomainAdmin\":\"Cross domain admin to set. Can be changed by admin.\",\"_initialDepositId\":\"Starting deposit ID. Set to 0 unless this is a re-deployment in order to mitigate relay hash collisions.\",\"_withdrawalRecipient\":\"Address which receives token withdrawals. Can be changed by admin. For Spoke Pools on L2, this will\"}},\"pauseDeposits(bool)\":{\"details\":\"Affects `deposit()` but not `speedUpDeposit()`, so that existing deposits can be sped up and still relayed.\",\"params\":{\"pause\":\"true if the call is meant to pause the system, false if the call is meant to unpause it.\"}},\"pauseFills(bool)\":{\"details\":\"Affects fillRelayWithUpdatedDeposit() and fillRelay().\",\"params\":{\"pause\":\"true if the call is meant to pause the system, false if the call is meant to unpause it.\"}},\"proxiableUUID()\":{\"details\":\"Implementation of the ERC1822 {proxiableUUID} function. This returns the storage slot used by the implementation. It is used to validate the implementation's compatibility when performing an upgrade. IMPORTANT: A proxy pointing at a proxiable contract should not be considered proxiable itself, because this risks bricking a proxy that upgrades to it, by delegating to itself until out of gas. Thus it is critical that this function revert if invoked through a proxy. This is guaranteed by the `notDelegated` modifier.\"},\"relayRootBundle(bytes32,bytes32)\":{\"params\":{\"relayerRefundRoot\":\"Merkle root containing relayer refund leaves that can be individually executed via executeRelayerRefundLeaf().\",\"slowRelayRoot\":\"Merkle root containing slow relay fulfillment leaves that can be individually executed via executeSlowRelayLeaf().\"}},\"requestSlowFill((bytes32,bytes32,bytes32,bytes32,bytes32,uint256,uint256,uint256,uint256,uint32,uint32,bytes))\":{\"details\":\"Slow fills are not possible unless the input and output tokens are \\\"equivalent\\\", i.e. they route to the same L1 token via PoolRebalanceRoutes.Slow fills are created by inserting slow fill objects into a merkle tree that is included in the next HubPool \\\"root bundle\\\". Once the optimistic challenge window has passed, the HubPool will relay the slow root to this chain via relayRootBundle(). Once the slow root is relayed, the slow fill can be executed by anyone who calls executeSlowRelayLeaf().Cannot request a slow fill if the fill deadline has passed.Cannot request a slow fill if the relay has already been filled or a slow fill has already been requested.\",\"params\":{\"relayData\":\"struct containing all the data needed to identify the deposit that should be slow filled. If any of the params are missing or different from the origin chain deposit, then Across will not include a slow fill for the intended deposit.\"}},\"setCrossDomainAdmin(address)\":{\"params\":{\"newCrossDomainAdmin\":\"New cross domain admin.\"}},\"setEnableRoute(address,uint256,bool)\":{\"params\":{\"destinationChainId\":\"Chain ID for where depositor wants to receive funds.\",\"enabled\":\"True to enable deposits, False otherwise.\",\"originToken\":\"Token that depositor can deposit to this contract.\"}},\"setL1GasLimit(uint32)\":{\"params\":{\"newl1Gas\":\"New L1 gas limit to set.\"}},\"setTokenBridge(address,address)\":{\"details\":\"If this mapping isn't set for an L2 token, then the standard bridge will be used to bridge this token.\",\"params\":{\"tokenBridge\":\"Address of token bridge\"}},\"setWithdrawalRecipient(address)\":{\"params\":{\"newWithdrawalRecipient\":\"New withdrawal recipient address.\"}},\"speedUpDeposit(bytes32,uint256,uint256,bytes32,bytes,bytes)\":{\"details\":\"the depositor and depositId must match the params in a FundsDeposited event that the depositor wants to speed up. The relayer has the option but not the obligation to use this updated information when filling the deposit via fillRelayWithUpdatedDeposit().\",\"params\":{\"depositId\":\"Deposit ID to speed up.\",\"depositor\":\"Depositor that must sign the depositorSignature and was the original depositor.\",\"depositorSignature\":\"Signed EIP712 hashstruct containing the deposit ID. Should be signed by the depositor account. If depositor is a contract, then should implement EIP1271 to sign as a contract. See _verifyUpdateV3DepositMessage() for more details about how this signature should be constructed.\",\"updatedMessage\":\"New message to use for this deposit. Can be modified if the recipient is a contract that expects to receive a message from the relay and for some reason needs to be modified.\",\"updatedOutputAmount\":\"New output amount to use for this deposit. Should be lower than previous value otherwise relayer has no incentive to use this updated value.\",\"updatedRecipient\":\"New recipient to use for this deposit. Can be modified if the recipient is a contract that expects to receive a message from the relay and for some reason needs to be modified.\"}},\"speedUpV3Deposit(address,uint256,uint256,address,bytes,bytes)\":{\"details\":\"The `depositor` and `depositId` must match the parameters in a `FundsDeposited` event that the depositor wants to speed up. The relayer is not obligated but has the option to use this updated information when filling the deposit using `fillRelayWithUpdatedDeposit()`. This version uses `address` types for compatibility with systems relying on `address`-based implementations.\",\"params\":{\"depositId\":\"The deposit ID to speed up.\",\"depositor\":\"The depositor that must sign the `depositorSignature` and was the original depositor.\",\"depositorSignature\":\"The signed EIP712 hashstruct containing the deposit ID. Should be signed by the depositor account. If the depositor is a contract, it should implement EIP1271 to sign as a contract. See `_verifyUpdateV3DepositMessage()` for more details on how the signature should be constructed.\",\"updatedMessage\":\"The new message for this deposit. Can be modified if the recipient is a contract that expects to receive a message from the relay and needs to be updated.\",\"updatedOutputAmount\":\"The new output amount to use for this deposit. It should be lower than the previous value, otherwise the relayer has no incentive to use this updated value.\",\"updatedRecipient\":\"The new recipient for this deposit. Can be modified if the original recipient is a contract that expects to receive a message from the relay and needs to be changed.\"}},\"unsafeDeposit(bytes32,bytes32,bytes32,bytes32,uint256,uint256,uint256,bytes32,uint256,uint32,uint32,uint32,bytes)\":{\"details\":\"This is labeled \\\"unsafe\\\" because there is no guarantee that the depositId emitted in the resultant FundsDeposited event is unique which means that the corresponding fill might collide with an existing relay hash on the destination chain SpokePool, which would make this deposit unfillable. In this case, the depositor would subsequently receive a refund of `inputAmount` of `inputToken` on the origin chain after the fill deadline.On the destination chain, the hash of the deposit data will be used to uniquely identify this deposit, so modifying any params in it will result in a different hash and a different deposit. The hash will comprise all parameters to this function along with this chain's chainId(). Relayers are only refunded for filling deposits with deposit hashes that map exactly to the one emitted by this contract.\",\"params\":{\"depositNonce\":\"The nonce that uniquely identifies this deposit. This function will combine this parameter with the msg.sender address to create a unique uint256 depositNonce and ensure that the msg.sender cannot use this function to front-run another depositor's unsafe deposit. This function guarantees that the resultant deposit nonce will not collide with a safe uint256 deposit nonce whose 24 most significant bytes are always 0.\",\"depositor\":\"See identically named parameter in depositV3() comments.\",\"destinationChainId\":\"See identically named parameter in depositV3() comments.\",\"exclusiveRelayer\":\"See identically named parameter in depositV3() comments.\",\"exclusivityParameter\":\"See identically named parameter in depositV3() comments.\",\"fillDeadline\":\"See identically named parameter in depositV3() comments.\",\"inputAmount\":\"See identically named parameter in depositV3() comments.\",\"inputToken\":\"See identically named parameter in depositV3() comments.\",\"message\":\"See identically named parameter in depositV3() comments.\",\"outputAmount\":\"See identically named parameter in depositV3() comments.\",\"outputToken\":\"See identically named parameter in depositV3() comments.\",\"quoteTimestamp\":\"See identically named parameter in depositV3() comments.\",\"recipient\":\"See identically named parameter in depositV3() comments.\"}},\"upgradeTo(address)\":{\"custom:oz-upgrades-unsafe-allow-reachable\":\"delegatecall\",\"details\":\"Upgrade the implementation of the proxy to `newImplementation`. Calls {_authorizeUpgrade}. Emits an {Upgraded} event.\"},\"upgradeToAndCall(address,bytes)\":{\"custom:oz-upgrades-unsafe-allow-reachable\":\"delegatecall\",\"details\":\"Upgrade the implementation of the proxy to `newImplementation`, and subsequently execute the function call encoded in `data`. Calls {_authorizeUpgrade}. Emits an {Upgraded} event.\"}},\"version\":1},\"userdoc\":{\"kind\":\"user\",\"methods\":{\"__OvmSpokePool_init(uint32,address,address,address)\":{\"notice\":\"Construct the OVM SpokePool.\"},\"__SpokePool_init(uint32,address,address)\":{\"notice\":\"Construct the base SpokePool.\"},\"chainId()\":{\"notice\":\"Returns chain ID for this network.\"},\"claimRelayerRefund(bytes32,bytes32)\":{\"notice\":\"Enables a relayer to claim outstanding repayments. Should virtually never be used, unless for some reason relayer repayment transfer fails for reasons such as token transfer reverts due to blacklisting. In this case, the relayer can still call this method and claim the tokens to a new address.\"},\"deposit(bytes32,bytes32,bytes32,bytes32,uint256,uint256,uint256,bytes32,uint32,uint32,uint32,bytes)\":{\"notice\":\"Previously, this function allowed the caller to specify the exclusivityDeadline, otherwise known as the as exact timestamp on the destination chain before which only the exclusiveRelayer could fill the deposit. Now, the caller is expected to pass in a number that will be interpreted either as an offset or a fixed timestamp depending on its value.Request to bridge input token cross chain to a destination chain and receive a specified amount of output tokens. The fee paid to relayers and the system should be captured in the spread between output amount and input amount when adjusted to be denominated in the input token. A relayer on the destination chain will send outputAmount of outputTokens to the recipient and receive inputTokens on a repayment chain of their choice. Therefore, the fee should account for destination fee transaction costs, the relayer's opportunity cost of capital while they wait to be refunded following an optimistic challenge window in the HubPool, and the system fee that they'll be charged.\"},\"depositDeprecated_5947912356(address,address,uint256,uint256,int64,uint32,bytes,uint256)\":{\"notice\":\"Called by user to bridge funds from origin to destination chain. Depositor will effectively lock tokens in this contract and receive a destination token on the destination chain. The origin => destination token mapping is stored on the L1 HubPool.The caller must first approve this contract to spend amount of originToken.The originToken => destinationChainId must be enabled.This method is payable because the caller is able to deposit native token if the originToken is wrappedNativeToken and this function will handle wrapping the native token to wrappedNativeToken.\"},\"depositFor(address,address,address,uint256,uint256,int64,uint32,bytes,uint256)\":{\"notice\":\"The only difference between depositFor and deposit is that the depositor address stored in the relay hash can be overridden by the caller. This means that the passed in depositor can speed up the deposit, which is useful if the deposit is taken from the end user to a middle layer contract, like an aggregator or the SpokePoolVerifier, before calling deposit on this contract.The caller must first approve this contract to spend amount of originToken.The originToken => destinationChainId must be enabled.This method is payable because the caller is able to deposit native token if the originToken is wrappedNativeToken and this function will handle wrapping the native token to wrappedNativeToken.\"},\"depositNow(bytes32,bytes32,bytes32,bytes32,uint256,uint256,uint256,bytes32,uint32,uint32,bytes)\":{\"notice\":\"Submits deposit and sets quoteTimestamp to current Time. Sets fill and exclusivity deadlines as offsets added to the current time. This function is designed to be called by users such as Multisig contracts who do not have certainty when their transaction will mine.\"},\"depositV3(address,address,address,address,uint256,uint256,uint256,address,uint32,uint32,uint32,bytes)\":{\"notice\":\"A version of `deposit` that accepts `address` types for backward compatibility. This function allows bridging of input tokens cross-chain to a destination chain, receiving a specified amount of output tokens. The relayer is refunded in input tokens on a repayment chain of their choice, minus system fees, after an optimistic challenge window. The exclusivity period is specified as an offset from the current block timestamp.\"},\"depositV3Now(address,address,address,address,uint256,uint256,uint256,address,uint32,uint32,bytes)\":{\"notice\":\"A version of `depositNow` that supports addresses as input types for backward compatibility. This function submits a deposit and sets `quoteTimestamp` to the current time. The `fill` and `exclusivity` deadlines are set as offsets added to the current time. It is designed to be called by users, including Multisig contracts, who may not have certainty when their transaction will be mined.\"},\"emergencyDeleteRootBundle(uint256)\":{\"notice\":\"This method is intended to only be used in emergencies where a bad root bundle has reached the SpokePool.\"},\"executeRelayerRefundLeaf(uint32,(uint256,uint256,uint256[],uint32,address,address[]),bytes32[])\":{\"notice\":\"Executes a relayer refund leaf stored as part of a root bundle. Will send the relayer the amount they sent to the recipient plus a relayer fee.\"},\"executeSlowRelayLeaf(((bytes32,bytes32,bytes32,bytes32,bytes32,uint256,uint256,uint256,uint256,uint32,uint32,bytes),uint256,uint256),uint32,bytes32[])\":{\"notice\":\"Executes a slow relay leaf stored as part of a root bundle relayed by the HubPool.\"},\"fill(bytes32,bytes,bytes)\":{\"notice\":\"Fills a single leg of a particular order on the destination chain\"},\"fillRelay((bytes32,bytes32,bytes32,bytes32,bytes32,uint256,uint256,uint256,uint256,uint32,uint32,bytes),uint256,bytes32)\":{\"notice\":\"Fulfill request to bridge cross chain by sending specified output tokens to the recipient.\"},\"fillRelayWithUpdatedDeposit((bytes32,bytes32,bytes32,bytes32,bytes32,uint256,uint256,uint256,uint256,uint32,uint32,bytes),uint256,bytes32,uint256,bytes32,bytes,bytes)\":{\"notice\":\"Identical to fillV3Relay except that the relayer wants to use a depositor's updated output amount, recipient, and/or message. The relayer should only use this function if they can supply a message signed by the depositor that contains the fill's matching deposit ID along with updated relay parameters. If the signature can be verified, then this function will emit a FilledV3Event that will be used by the system for refund verification purposes. In other words, this function is an alternative way to fill a a deposit than fillV3Relay.\"},\"getCurrentTime()\":{\"notice\":\"Gets the current time.\"},\"getUnsafeDepositId(address,bytes32,uint256)\":{\"notice\":\"Returns the deposit ID for an unsafe deposit. This function is used to compute the deposit ID in unsafeDeposit and is provided as a convenience.\"},\"initialize(uint32,address,address)\":{\"notice\":\"Construct the OVM World Chain SpokePool.\"},\"pauseDeposits(bool)\":{\"notice\":\"Pauses deposit-related functions. This is intended to be used if this contract is deprecated or when something goes awry.\"},\"pauseFills(bool)\":{\"notice\":\"Pauses fill-related functions. This is intended to be used if this contract is deprecated or when something goes awry.\"},\"relayRootBundle(bytes32,bytes32)\":{\"notice\":\"This method stores a new root bundle in this contract that can be executed to refund relayers, fulfill slow relays, and send funds back to the HubPool on L1. This method can only be called by the admin and is designed to be called as part of a cross-chain message from the HubPool's executeRootBundle method.\"},\"requestSlowFill((bytes32,bytes32,bytes32,bytes32,bytes32,uint256,uint256,uint256,uint256,uint32,uint32,bytes))\":{\"notice\":\"Request Across to send LP funds to this contract to fulfill a slow fill relay for a deposit in the next bundle.\"},\"setCrossDomainAdmin(address)\":{\"notice\":\"Change cross domain admin address. Callable by admin only.\"},\"setEnableRoute(address,uint256,bool)\":{\"notice\":\"Enable/Disable an origin token => destination chain ID route for deposits. Callable by admin only.\"},\"setL1GasLimit(uint32)\":{\"notice\":\"Change L1 gas limit. Callable only by admin.\"},\"setTokenBridge(address,address)\":{\"notice\":\"Set bridge contract for L2 token used to withdraw back to L1.\"},\"setWithdrawalRecipient(address)\":{\"notice\":\"Change L1 withdrawal recipient address. Callable by admin only.\"},\"speedUpDeposit(bytes32,uint256,uint256,bytes32,bytes,bytes)\":{\"notice\":\"Depositor can use this function to signal to relayer to use updated output amount, recipient, and/or message.\"},\"speedUpV3Deposit(address,uint256,uint256,address,bytes,bytes)\":{\"notice\":\"A version of `speedUpDeposit` using `address` types for backward compatibility. This function allows the depositor to signal to the relayer to use updated output amount, recipient, and/or message when filling a deposit. This can be useful when the deposit needs to be modified after the original transaction has been mined.\"},\"unsafeDeposit(bytes32,bytes32,bytes32,bytes32,uint256,uint256,uint256,bytes32,uint256,uint32,uint32,uint32,bytes)\":{\"notice\":\"See deposit for details. This function is identical to deposit except that it does not use the global deposit ID counter as a deposit nonce, instead allowing the caller to pass in a deposit nonce. This function is designed to be used by anyone who wants to pre-compute their resultant relay data hash, which could be useful for filling a deposit faster and avoiding any risk of a relay hash unexpectedly changing due to another deposit front-running this one and incrementing the global deposit ID counter.\"}},\"notice\":\"World Chain Spoke pool.\",\"version\":1}},\"settings\":{\"compilationTarget\":{\"contracts/WorldChain_SpokePool.sol\":\"WorldChain_SpokePool\"},\"debug\":{\"revertStrings\":\"strip\"},\"evmVersion\":\"shanghai\",\"libraries\":{},\"metadata\":{\"bytecodeHash\":\"ipfs\"},\"optimizer\":{\"enabled\":true,\"runs\":800},\"remappings\":[],\"viaIR\":true},\"sources\":{\"@eth-optimism/contracts/libraries/constants/Lib_PredeployAddresses.sol\":{\"keccak256\":\"0x2bc28307af93e9716151a41a81694b56cbe513ef5eb335fb1d81f35e5db8edfa\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://bbdde142b16f7e0301b7b6a331b35ce609eaf5c9127f14f60c0008abb36e100f\",\"dweb:/ipfs/QmdKUiY6U2vh5egW1bYtvrNhpEmo4Jo4DEwUUmBCfW4eLy\"]},\"@openzeppelin/contracts-upgradeable/crosschain/errorsUpgradeable.sol\":{\"keccak256\":\"0xa1e9b651a2427925598b49ef35da5930abc07859cfac5b9dfb1912f063a024b3\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://c514518c36a3fb1c5f1a99d88857e93160c72ea1fd728c443406ad1acb43ae9a\",\"dweb:/ipfs/Qmc3oXjBNhdeM5cfWpsvewXZAhH34Scgna2W3MvLaiiapQ\"]},\"@openzeppelin/contracts-upgradeable/crosschain/optimism/LibOptimismUpgradeable.sol\":{\"keccak256\":\"0x4e749e196701e221283db53ccaafd372434cdaed2a0b1f5a81b23e36b826b3e8\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://c12147f335d1f8cfee08c853de86d06f63534fe8395f4f0c3c202c045f2ef4d2\",\"dweb:/ipfs/QmNnJzZGLymFtaaKn9zQAtxeNAGmXCDPFyjxzthkUTrKre\"]},\"@openzeppelin/contracts-upgradeable/interfaces/IERC1967Upgradeable.sol\":{\"keccak256\":\"0x47d6e06872b12e72c79d1b5eb55842f860b5fb1207b2317c2358d2766b950a7b\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://ac55bf6f92fc7b90c6d79d346163a0a02bd5c648c7fede08b20e5da96d4ae2a0\",\"dweb:/ipfs/QmQoSrHhka35iKDK5iyNt8cuXXS5ANXVPjLhfsJjktB8V9\"]},\"@openzeppelin/contracts-upgradeable/interfaces/draft-IERC1822Upgradeable.sol\":{\"keccak256\":\"0x77c89f893e403efc6929ba842b7ccf6534d4ffe03afe31670b4a528c0ad78c0f\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://496bd9b3df2455d571018c09f0c6badd29713fdeb907c6aa09d8d28cb603f053\",\"dweb:/ipfs/QmXdJDyYs6WMwMh21dez2BYPxhSUaUYFMDtVNcn2cgFR79\"]},\"@openzeppelin/contracts-upgradeable/proxy/ERC1967/ERC1967UpgradeUpgradeable.sol\":{\"keccak256\":\"0x7795808e3899c805254e3ae58074b20f799b466e3f43e057e47bedee5fb771f8\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://319853a2a682f3f72411507242669ef5e76e0ad3457be53102439709ee8948f0\",\"dweb:/ipfs/QmRtm4Ese9u4jfxXyuWPXLwzenwFotuQjAWV7rXtZTB1E9\"]},\"@openzeppelin/contracts-upgradeable/proxy/beacon/IBeaconUpgradeable.sol\":{\"keccak256\":\"0x24b86ac8c005b8c654fbf6ac34a5a4f61580d7273541e83e013e89d66fbf0908\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://4dbfe1a3b3b3fb64294ce41fd2ad362e7b7012208117864f42c1a67620a6d5c1\",\"dweb:/ipfs/QmVMU5tWt7zBQMmf5cpMX8UMHV86T3kFeTxBTBjFqVWfoJ\"]},\"@openzeppelin/contracts-upgradeable/proxy/utils/Initializable.sol\":{\"keccak256\":\"0x89be10e757d242e9b18d5a32c9fbe2019f6d63052bbe46397a430a1d60d7f794\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://f103ee2e4aecd37aac6ceefe670709cdd7613dee25fa2d4d9feaf7fc0aaa155e\",\"dweb:/ipfs/QmRiNZLoJk5k3HPMYGPGjZFd2ke1ZxjhJZkM45Ec9GH9hv\"]},\"@openzeppelin/contracts-upgradeable/proxy/utils/UUPSUpgradeable.sol\":{\"keccak256\":\"0xefb41f5c1a00249b7a99f0782f8c557865605426a3fb6e5fe9ae334293ae4f33\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://90def55e5782595aabc13f57780c02d3613e5226f20ce6c1709503a63fdeb58f\",\"dweb:/ipfs/Qmb5vcymmNEZUJMaHmYxnhvGJDEsGMae4YjcHwkA74jy99\"]},\"@openzeppelin/contracts-upgradeable/security/ReentrancyGuardUpgradeable.sol\":{\"keccak256\":\"0x2025ccf05f6f1f2fd4e078e552836f525a1864e3854ed555047cd732320ab29b\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://d27f4b23c2dee42394aebaf42bf238285230f472dfd3282a39c3f000ec28214f\",\"dweb:/ipfs/QmQa3DnvccwdWJeWrjgXPnFMTWbzWQWR39hVqC7eEwo2PC\"]},\"@openzeppelin/contracts-upgradeable/token/ERC20/IERC20Upgradeable.sol\":{\"keccak256\":\"0x0e1f0f5f62f67a881cd1a9597acbc0a5e4071f3c2c10449a183b922ae7272e3f\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://c25f742ff154998d19a669e2508c3597b363e123ce9144cd0fcf6521229f401f\",\"dweb:/ipfs/QmQXRuFzStEWqeEPbhQU6cAg9PaSowxJVo4PDKyRod7dco\"]},\"@openzeppelin/contracts-upgradeable/token/ERC20/extensions/IERC20PermitUpgradeable.sol\":{\"keccak256\":\"0x07e881de3b9f6d2c07909f193f24b96c7fe4ea60013260f3f25aecd8bab3c2f8\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://1fed09b97ccb0ff9ba9b6a94224f1d489026bf6b4b7279bfe64fb6e8749dee4d\",\"dweb:/ipfs/QmcRAzaSP1UnGr4vrGkfJmB2L9aiTYoXfV1Lg9gqrVRWn8\"]},\"@openzeppelin/contracts-upgradeable/token/ERC20/utils/SafeERC20Upgradeable.sol\":{\"keccak256\":\"0x23b997be73d3dd46885262704f0f8cfc7273fdadfe303d37969a9561373972b5\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://d03ebe5406134f0c4a017dee625ff615031194493bd1e88504e5c8fae55bc166\",\"dweb:/ipfs/QmUZV5bMbgk2PAkV3coouSeSainHN2jhqaQDJaA7hQRyu2\"]},\"@openzeppelin/contracts-upgradeable/utils/AddressUpgradeable.sol\":{\"keccak256\":\"0x9c80f545915582e63fe206c6ce27cbe85a86fc10b9cd2a0e8c9488fb7c2ee422\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://310136ad60820af4177a11a61d77a3686faf5fca4942b600e08fc940db38396b\",\"dweb:/ipfs/QmbCzMNSTL7Zi7M4UCSqBrkHtp4jjxUnGbkneCZKdR1qeq\"]},\"@openzeppelin/contracts-upgradeable/utils/StorageSlotUpgradeable.sol\":{\"keccak256\":\"0x07ac95acad040f1fb1f6120dd0aa5f702db69446e95f82613721879d30de0908\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://a9df9de7b5da1d1bd3d4b6c073d0174bc4211db60e794a321c8cb5d4eae34685\",\"dweb:/ipfs/QmWe49zj65jayrCe9jZpoWhYUZ1RiwSxyU2s7SBZnMztVy\"]},\"@openzeppelin/contracts-upgradeable/utils/StringsUpgradeable.sol\":{\"keccak256\":\"0xb96dc79b65b7c37937919dcdb356a969ce0aa2e8338322bf4dc027a3c9c9a7eb\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://f8613145881436fc0480fff22da4868d611e2b0c0c3da083334eb4362ce1945a\",\"dweb:/ipfs/QmPqpP3YeRbBdTJRe6Gv2eGsUaANf4J6RwTNRW36iYahfV\"]},\"@openzeppelin/contracts-upgradeable/utils/cryptography/ECDSAUpgradeable.sol\":{\"keccak256\":\"0xa014f65d84b02827055d99993ccdbfb4b56b2c9e91eb278d82a93330659d06e4\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://50a7e716a74f3d48a7f549086faa94afcd58b9f18ac8e9f74af4571f3a1d8d5c\",\"dweb:/ipfs/QmTkDNWkq5o9Cv2jS7s6JvSmsPBkeunZhPe7Z2njGL31wo\"]},\"@openzeppelin/contracts-upgradeable/utils/math/MathUpgradeable.sol\":{\"keccak256\":\"0x2bc0007987c229ae7624eb29be6a9b84f6a6a5872f76248b15208b131ea41c4e\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://2b2835c737d073ef8b82a4cc246495a9740f43e7ff2cf130906b2449ff9bfb91\",\"dweb:/ipfs/QmSCWfNoSvvTN57ic7o1RW6NqSxxGAqbBTnLKc7QHe27qB\"]},\"@openzeppelin/contracts-upgradeable/utils/math/SignedMathUpgradeable.sol\":{\"keccak256\":\"0x88f6b7bba3ee33eeb741f9a0f5bc98b6e6e352d0fe4905377bb328590f84095a\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://88ace2d60f265752f18903d839910be4e4e104340b2957678585b812447825d4\",\"dweb:/ipfs/QmXFkNxMc3AAGzhs2wUEZyErWQjsvoTGyYjuU5oZkFki5Z\"]},\"@openzeppelin/contracts-upgradeable/vendor/optimism/ICrossDomainMessengerUpgradeable.sol\":{\"keccak256\":\"0xb531a6941d55a97d0db7af85c19b6aaf7fc634e550b513daa28e874b2c9b2dfa\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://23b0ce75313d9863512271a51940f6876051a5cb6dce60dd06bc03e565631b9d\",\"dweb:/ipfs/QmZobv3VixcvPxVF6hZgWxo8ELd9nXK935aiBpyHypYSoL\"]},\"@openzeppelin/contracts/interfaces/IERC1271.sol\":{\"keccak256\":\"0x0705a4b1b86d7b0bd8432118f226ba139c44b9dcaba0a6eafba2dd7d0639c544\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://c45b821ef9e882e57c256697a152e108f0f2ad6997609af8904cae99c9bd422e\",\"dweb:/ipfs/QmRKCJW6jjzR5UYZcLpGnhEJ75UVbH6EHkEa49sWx2SKng\"]},\"@openzeppelin/contracts/token/ERC20/IERC20.sol\":{\"keccak256\":\"0x287b55befed2961a7eabd7d7b1b2839cbca8a5b80ef8dcbb25ed3d4c2002c305\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://bd39944e8fc06be6dbe2dd1d8449b5336e23c6a7ba3e8e9ae5ae0f37f35283f5\",\"dweb:/ipfs/QmPV3FGYjVwvKSgAXKUN3r9T9GwniZz83CxBpM7vyj2G53\"]},\"@openzeppelin/contracts/token/ERC20/extensions/IERC20Permit.sol\":{\"keccak256\":\"0xb264c03a3442eb37a68ad620cefd1182766b58bee6cec40343480392d6b14d69\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://28879d01fd22c07b44f006612775f8577defbe459cb01685c5e25cd518c91a71\",\"dweb:/ipfs/QmVgfkwv2Fxw6hhTcDUZhE7NkoSKjab3ipM7UaRbt6uXb5\"]},\"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\":{\"keccak256\":\"0xabefac93435967b4d36a4fabcbdbb918d1f0b7ae3c3d85bc30923b326c927ed1\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://9d213d3befca47da33f6db0310826bcdb148299805c10d77175ecfe1d06a9a68\",\"dweb:/ipfs/QmRgCn6SP1hbBkExUADFuDo8xkT4UU47yjNF5FhCeRbQmS\"]},\"@openzeppelin/contracts/utils/Address.sol\":{\"keccak256\":\"0x006dd67219697fe68d7fbfdea512e7c4cb64a43565ed86171d67e844982da6fa\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://2455248c8ddd9cc6a7af76a13973cddf222072427e7b0e2a7d1aff345145e931\",\"dweb:/ipfs/QmfYjnjRbWqYpuxurqveE6HtzsY1Xx323J428AKQgtBJZm\"]},\"@openzeppelin/contracts/utils/Strings.sol\":{\"keccak256\":\"0x3088eb2868e8d13d89d16670b5f8612c4ab9ff8956272837d8e90106c59c14a0\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://b81d9ff6559ea5c47fc573e17ece6d9ba5d6839e213e6ebc3b4c5c8fe4199d7f\",\"dweb:/ipfs/QmPCW1bFisUzJkyjroY3yipwfism9RRCigCcK1hbXtVM8n\"]},\"@openzeppelin/contracts/utils/cryptography/ECDSA.sol\":{\"keccak256\":\"0x809bc3edb4bcbef8263fa616c1b60ee0004b50a8a1bfa164d8f57fd31f520c58\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://8b93a1e39a4a19eba1600b92c96f435442db88cac91e315c8291547a2a7bcfe2\",\"dweb:/ipfs/QmTm34KVe6uZBZwq8dZDNWwPcm24qBJdxqL3rPxBJ4LrMv\"]},\"@openzeppelin/contracts/utils/cryptography/MerkleProof.sol\":{\"keccak256\":\"0xcf688741f79f4838d5301dcf72d0af9eff11bbab6ab0bb112ad144c7fb672dac\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://85d9c87a481fe99fd28a146c205da0867ef7e1b7edbe0036abc86d2e64eb1f04\",\"dweb:/ipfs/QmR7m1zWQNfZHUKTtqnjoCjCBbNFcjCxV27rxf6iMfhVtG\"]},\"@openzeppelin/contracts/utils/cryptography/SignatureChecker.sol\":{\"keccak256\":\"0x3af3ca86df39aac39a0514c84459d691434a108d2151c8ce9d69f32e315cab80\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://77d1f1cf302cd5e1dfbbb4ce3b281b28e8c52942d4319fce43df2e1b6f02a52d\",\"dweb:/ipfs/QmT6ZXStmK3Knhh9BokeVHQ9HXTBZNgL3Eb1ar1cYg1hWy\"]},\"@openzeppelin/contracts/utils/math/Math.sol\":{\"keccak256\":\"0xe4455ac1eb7fc497bb7402579e7b4d64d928b846fce7d2b6fde06d366f21c2b3\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://cc8841b3cd48ad125e2f46323c8bad3aa0e88e399ec62acb9e57efa7e7c8058c\",\"dweb:/ipfs/QmSqE4mXHA2BXW58deDbXE8MTcsL5JSKNDbm23sVQxRLPS\"]},\"@openzeppelin/contracts/utils/math/SignedMath.sol\":{\"keccak256\":\"0xf92515413956f529d95977adc9b0567d583c6203fc31ab1c23824c35187e3ddc\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://c50fcc459e49a9858b6d8ad5f911295cb7c9ab57567845a250bf0153f84a95c7\",\"dweb:/ipfs/QmcEW85JRzvDkQggxiBBLVAasXWdkhEysqypj9EaB6H2g6\"]},\"contracts/MerkleLib.sol\":{\"keccak256\":\"0xdaf19fdc82593b79a608af8f691aec89a3c0e47b210770deabbe66ece7c35bb1\",\"license\":\"BUSL-1.1\",\"urls\":[\"bzz-raw://03c37f78657beed37257187e237d74492de0199734aa03272a419f66161c0dca\",\"dweb:/ipfs/QmdcXMAoRLZejhh2xcVMWR3WfUvXcArKrCFEE82JDYiJbh\"]},\"contracts/Ovm_SpokePool.sol\":{\"keccak256\":\"0xc46d3c3c1b493137eca6fbe8cd9eae2381cb792945e7ede376cbe15ef95b5454\",\"license\":\"BUSL-1.1\",\"urls\":[\"bzz-raw://7e76ca618799ea810d1fce4449d55ec3bbfbe7482374cf4259755e0103a91c19\",\"dweb:/ipfs/QmVoiCjM4yKCLxe2TNL9i9QViYFCd4f2v9wB37ogtwb6Md\"]},\"contracts/SpokePool.sol\":{\"keccak256\":\"0x62c641e112f07f831e4141dcb6b2f5dade3e60b2c85ebb72d553e036742126fd\",\"license\":\"BUSL-1.1\",\"urls\":[\"bzz-raw://b2b4069889cdac14059dc0452dd352e8d899e85ac6a37886500fcb0608351739\",\"dweb:/ipfs/QmaLeMZevVxtrzxFd4ZER8Ukjk3HRTQ7da7QzzokKB6VMz\"]},\"contracts/WorldChain_SpokePool.sol\":{\"keccak256\":\"0xca2c33ecde7c11a115fac777e053aa03a096d39595778ee59dcc99248ead365f\",\"license\":\"BUSL-1.1\",\"urls\":[\"bzz-raw://c4f6577186f64b911880558c487434fd2f7347aa766be4f5f9cb807d874ab5c2\",\"dweb:/ipfs/QmcAAkTdakUqdz4TUEXYK28moXK8tQQ4ryZmQWb81AUU1t\"]},\"contracts/erc7683/ERC7683.sol\":{\"keccak256\":\"0x726d0426b0f3a11ff59d3a5bbe433c182c0feac9ea2c8c75377fcc2693eccded\",\"license\":\"GPL-3.0-or-later\",\"urls\":[\"bzz-raw://99336cc59dd5923815a8fad6e200b7b265e8446414b099e9b17e3f15f094b774\",\"dweb:/ipfs/QmWCrqefGqEpKsvfn1oBzTTUAFBjscjHc6g1EX2ab51bGA\"]},\"contracts/erc7683/ERC7683Permit2Lib.sol\":{\"keccak256\":\"0x12d0e6dd7e394b75067157ccbe3e8756db138b8f48b3c69494da2e2f294d582f\",\"license\":\"UNLICENSED\",\"urls\":[\"bzz-raw://f4185b2e3396fdb6ce934e462fcdca2c1be29caaa7949ab22072f2105354220e\",\"dweb:/ipfs/QmbPwAQK6K32ENZeytLkPi41TWiWXzFzpJ7Ah67hU8kvjw\"]},\"contracts/external/interfaces/CCTPInterfaces.sol\":{\"keccak256\":\"0xd9d9ecaf4617ec19f7c30f6ed94d15f656d8fc59eb7c757aca406331ba20424c\",\"license\":\"GPL-3.0-or-later\",\"urls\":[\"bzz-raw://19c87a9dfa12eccbfd8da0c5ad064608b0214536ad5fe5456725c8545b2d7372\",\"dweb:/ipfs/QmcaDCLq7bdk2EGi67Z9GfRe8pW77jZqveJvwyGJG5dnw3\"]},\"contracts/external/interfaces/IOpUSDCBridgeAdapter.sol\":{\"keccak256\":\"0x2a088bfda506fd767c796d29c049ac51f2a49bcd61a7f5b57110e55138b8cdc3\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://d97c8b596348a3dd2879d890d20cfb87262c8a3435a7e66927edf571796ee692\",\"dweb:/ipfs/Qmd8KSEvNZzVHpcngkGrahq8C3o9PcHkUtv89HLACYenGc\"]},\"contracts/external/interfaces/IPermit2.sol\":{\"keccak256\":\"0x68f40961ee44fbc71eff2037f2c88ba9bfbccf35b9b1eae5a527b71d19bf3a71\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://2281f309f1b0df4d1c9beeeaa2673152c73e6e20991438420a9de18c51269ea7\",\"dweb:/ipfs/QmafDC3g5yBqPvSof5FmGKv4gMR3TXT5Xj3tULDA5CKmaE\"]},\"contracts/external/interfaces/WETH9Interface.sol\":{\"keccak256\":\"0x3f7892554ec7f54681fdd3cc18a41346c246c9c1afba016c52990ef77741f718\",\"license\":\"BUSL-1.1\",\"urls\":[\"bzz-raw://76e901f8da798eb2fdef8fd0083a51088103269f08ee751598c5a6eba407785f\",\"dweb:/ipfs/QmcAHbwbwCZd78teaK4cHuAvXq71aWX1r9vTGkSRRBDJV1\"]},\"contracts/interfaces/HubPoolInterface.sol\":{\"keccak256\":\"0xefd509ab379b94004b5767d67971e5c0bda4ca1e9f376b5aea75a0297b5d7bd6\",\"license\":\"BUSL-1.1\",\"urls\":[\"bzz-raw://0b7e509e90bcca9b96bf55e92498b17bbb548359c470b17285740080a6c0d9de\",\"dweb:/ipfs/QmdviQBbB58H9HR3tKQepEuYcMKXZthyTThGXUgQDAC828\"]},\"contracts/interfaces/SpokePoolInterface.sol\":{\"keccak256\":\"0x4fefc97b3446f957f2679869ee7d8e8cc319a189f3fe47584b8203256a0d703b\",\"license\":\"BUSL-1.1\",\"urls\":[\"bzz-raw://0a73f80d7737c1a15f4d54225c66b7ffaf69fb85b0e9ef5a06a730f60d43ac13\",\"dweb:/ipfs/QmXegUowEkfsEraUYK2TgweT8j4uKVWxbQCiKV1qtDRKbt\"]},\"contracts/interfaces/SpokePoolMessageHandler.sol\":{\"keccak256\":\"0xef7377f05d40e665eb346fb1647e1341558ce5fd1e03768d81a41a579365ff47\",\"license\":\"BUSL-1.1\",\"urls\":[\"bzz-raw://6689551ad226c66bbab84387f193445ab209bf795f17ce4cf1be9ab5c1984e5d\",\"dweb:/ipfs/Qme3XnW4RZJruCDJTV8MNQsjJj14qPWZHLQZJhY4rh1iV6\"]},\"contracts/interfaces/V3SpokePoolInterface.sol\":{\"keccak256\":\"0x28d33b34690ea41eea70c5cce5db8c5f1066d74b59a23e28c7b4d9afddef7608\",\"license\":\"BUSL-1.1\",\"urls\":[\"bzz-raw://8098952a936841bb3616849c8ee96cf82328998a9cd739030f2ce57cf90d32ee\",\"dweb:/ipfs/Qmb1PpC5RkNsasyjyZrrmbMwXmKzMiSYfzm2B9Kutg6Bmf\"]},\"contracts/libraries/AddressConverters.sol\":{\"keccak256\":\"0x378f28bb4a17a5c47457cb9341086b2140f7faf6c048f702d3528166f0d74453\",\"license\":\"BUSL-1.1\",\"urls\":[\"bzz-raw://0fa273e028c9555202cac439ddf458d074b66c6f74778b2b0e5e17a0e331dc38\",\"dweb:/ipfs/QmYqEaWXgiJnsH8wRAuTKF41bxkxxvY947wdKoZrjM7HVx\"]},\"contracts/libraries/CircleCCTPAdapter.sol\":{\"keccak256\":\"0xf2d4f9d84b80259be516be7e543ea9a504ed665070d8105fbd7c84e7f79f8a32\",\"license\":\"BUSL-1.1\",\"urls\":[\"bzz-raw://42e842b241966fe9e0e612228e4ea43004d02d327bd67749b40fab2edde311bb\",\"dweb:/ipfs/QmafDiwZsycjYjsF32i5suqPTCCNEN3MQvxbvBskBJWggy\"]},\"contracts/upgradeable/AddressLibUpgradeable.sol\":{\"keccak256\":\"0x655040da45a857cf609d7176c7b0647bf76d36e73e856af79d511014c7e8ef81\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://5c17767f34d57380767b49f8584d62598964fc813e6f3587d76b51ec2357bb4e\",\"dweb:/ipfs/QmSyoTa1Snn3KiJD7KjCwsPmNqpJzusXterbEXxbYCZoJK\"]},\"contracts/upgradeable/EIP712CrossChainUpgradeable.sol\":{\"keccak256\":\"0xff617722706d1c0a6d346e56e4598cc5f60adea99b4ac1d2347dcd69270a14f6\",\"license\":\"BUSL-1.1\",\"urls\":[\"bzz-raw://e2d04649c09bad766c5632da2e3a4f1deed1e013e8b713fad1f101e06f4b56a3\",\"dweb:/ipfs/QmfCewdTDr2krzvNY5rH5BprngEtBmxPXCZf6JKavxw2Sb\"]},\"contracts/upgradeable/MultiCallerUpgradeable.sol\":{\"keccak256\":\"0xc1378a7d63785d9381b8fb6e42962499ab26a243292e20981c2792511a4697f3\",\"license\":\"BUSL-1.1\",\"urls\":[\"bzz-raw://2ec8d733e528d6e79732409eb04aa5f8a8bcdf5888e677919a07d8b84afb1598\",\"dweb:/ipfs/QmQF23Gf9vHb6Ne6kaEZmQTjobWzasEWWr5YaBFkuEypz4\"]}},\"version\":1}",
- "bytecode": "0x61016034620001e257601f6200596d38819003918201601f19168301916001600160401b03831184841017620001e65780849260a094604052833981010312620001e25780516001600160a01b03919082811690819003620001e2576200006960208301620001fa565b6200007760408401620001fa565b916060840151938585168503620001e257608001519485168503620001e2573060805260a05260c05260e0525f5460ff8160081c16620001e25760ff80821603620001a7575b50610120908152610140918252610100915f83526040519161576093846200020d8539608051848181611088015281816115a4015261171e015260a051848181610880015281816138e601528181613a57015281816140780152818161430a0152818161462201528181614c0601528181614c2d0152614f86015260c0518481816119eb0152818161389a0152614810015260e05184818161046e01526145d0015251838181611b94015261552001525182818161082301528181614ac5015281816152b8015261545701525181818161204e01528181614ba90152818161508d015261547a0152f35b60ff90811916175f557f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb3847402498602060405160ff8152a15f620000bd565b5f80fd5b634e487b7160e01b5f52604160045260245ffd5b519063ffffffff82168203620001e25756fe6080604052600436101561001a575b3615610018575f80fd5b005b5f3560e01c8063079bd2c71461043f5780630c5d5f731461043a5780630eaac9f0146104355780631186ec331461043057806311eac8551461042b57806315348e44146103b357806317fcb39b146104265780631b3d5559146104215780631fab657c1461041c578063272751c71461041757806329cb924d146104125780632e3781151461040d5780632e63e59a1461040857806333a84ff0146104035780633659cfe6146103fe578063431023b8146103f9578063437b9116146103f4578063490e49ef146103ef578063493a4f84146103ea5780634f1ef286146103e55780635249fef1146103e05780635285e058146103db57806352d1902d146103d6578063541f4f14146103d1578063577f51f8146103cc57806357f6dcb8146103c75780636068d6cb146103c2578063647c576c146103bd578063670fa8ac146103b85780636bbbcd2e146103b35780636e400983146103ae578063738b62e5146103a9578063766e0703146103a45780637aef642c1461039f5780637b9392321461039a5780637ef413e11461039557806382e2c43f146103905780638a7860ce1461038b5780638b15788e14610386578063927ede2d146103815780639748cf7c1461037c57806397943aa914610377578063979f2bc21461037257806399cc29681461036d5780639a8a059214610368578063a1244c6714610363578063a18a096e1461035e578063ac9650d814610359578063ad5425c614610354578063adb5a6a614610309578063b27a43001461034f578063b370b7f51461034a578063babb6aac14610345578063bf10268d14610340578063c35c83fc1461033b578063ceb4c98714610336578063d7e1583a14610331578063dda521131461032c578063ddd224f114610327578063de7eba7814610322578063deff4b241461031d578063e322921114610318578063ea86bd4614610313578063ee2a53f81461030e578063f79f29ed14610309578063fbbba9ac146103045763fc8a584f0361000e57612cc3565b612c3f565b6125fe565b612c01565b612afe565b612ad5565b6129e0565b6129b0565b612987565b612961565b61292b565b612831565b612806565b612782565b6126ab565b612684565b612645565b61249d565b6123fd565b612296565b61226f565b612255565b6121c0565b6120f2565b612072565b61202f565b612001565b611f83565b611f0b565b611df0565b611db9565b611d11565b611c71565b611c4d565b611bb8565b611b78565b610847565b611b3e565b611a67565b611a0f565b6119cf565b611831565b61176e565b611704565b6116dd565b61168f565b611561565b6114da565b6114bc565b6113ef565b611192565b611060565b611026565b610e2c565b610ccc565b610ca3565b610c04565b610af8565b6109ef565b610861565b610804565b610763565b610516565b6104b0565b610452565b5f91031261044e57565b5f80fd5b3461044e575f36600319011261044e57602060405163ffffffff7f0000000000000000000000000000000000000000000000000000000000000000168152f35b6001600160a01b0381160361044e57565b35906104ae82610492565b565b3461044e57602036600319011261044e5760206004356104cf81610492565b6001600160a01b038091165f52610c5d825260405f205416604051908152f35b63ffffffff81160361044e57565b61014435906104ae826104ef565b35906104ae826104ef565b3461044e57602036600319011261044e5763ffffffff600435610538816104ef565b6105406136d1565b610548613793565b16610c5a8163ffffffff198254161790557fe486a5c4bd7b36eabbfe274c99b39130277417be8d2209b4dae04c4fba64ee3a5f80a26001606555005b634e487b7160e01b5f52604160045260245ffd5b6040810190811067ffffffffffffffff8211176105b457604052565b610584565b6101a0810190811067ffffffffffffffff8211176105b457604052565b67ffffffffffffffff81116105b457604052565b6060810190811067ffffffffffffffff8211176105b457604052565b6080810190811067ffffffffffffffff8211176105b457604052565b6020810190811067ffffffffffffffff8211176105b457604052565b60e0810190811067ffffffffffffffff8211176105b457604052565b60a0810190811067ffffffffffffffff8211176105b457604052565b90601f8019910116810190811067ffffffffffffffff8211176105b457604052565b6040519060c0820182811067ffffffffffffffff8211176105b457604052565b60405190610180820182811067ffffffffffffffff8211176105b457604052565b604051906104ae826105b9565b604051906104ae82610606565b67ffffffffffffffff81116105b457601f01601f191660200190565b92919261071b826106f3565b916107296040519384610676565b82948184528183011161044e578281602093845f960137010152565b9080601f8301121561044e578160206107609335910161070f565b90565b61010036600319011261044e5760043561077c81610492565b60243561078881610492565b6084358060070b810361044e5760a435906107a2826104ef565b60c43567ffffffffffffffff811161044e576107c2903690600401610745565b926107cb613793565b60ff61086b5460e81c166107f2576107eb9460643591604435913361380e565b6001606555005b604051630b4cba3160e31b8152600490fd5b3461044e575f36600319011261044e5760206040516001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000168152f35b3461044e575f36600319011261044e5760206040515f8152f35b3461044e575f36600319011261044e5760206040516001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000168152f35b67ffffffffffffffff81116105b45760051b60200190565b9080601f8301121561044e5760209082356108d6816108a4565b936108e46040519586610676565b81855260208086019260051b82010192831161044e57602001905b82821061090d575050505090565b813581529083019083016108ff565b9080601f8301121561044e576020908235610936816108a4565b936109446040519586610676565b81855260208086019260051b82010192831161044e57602001905b82821061096d575050505090565b838091833561097b81610492565b81520191019061095f565b9291610991826108a4565b9161099f6040519384610676565b829481845260208094019160051b810192831161044e57905b8282106109c55750505050565b813581529083019083016109b8565b9080601f8301121561044e5781602061076093359101610986565b60031960603682011261044e57600435610a08816104ef565b60243567ffffffffffffffff9283821161044e5760c090823603011261044e57610a30610698565b908060040135825260248101356020830152604481013584811161044e57610a5e90600436918401016108bc565b6040830152610a6f6064820161050b565b6060830152610a80608482016104a3565b608083015260a48101359084821161044e576004610aa1923692010161091c565b60a082015260443592831161044e57610ac16100189336906004016109d4565b91612cf3565b9181601f8401121561044e5782359167ffffffffffffffff831161044e576020808501948460051b01011161044e57565b3461044e5760031960603682011261044e5760043567ffffffffffffffff80821161044e5760608236039384011261044e5760243590610b37826104ef565b60443590811161044e57610b4f903690600401610ac7565b919093610b5a613793565b600484013590610182190181121561044e57610bf094610beb93610b87610be4936004369189010161284f565b95610b9d610b986080890151613da4565b613a4d565b610ba687613604565b9060446020890151916101608a015193610bbe610698565b9a8b5260208b015201356040890152606088015260808701525f60a08701523691610986565b9083613dba565b613f0b565b6100186001606555565b8015150361044e57565b3461044e57606036600319011261044e57600435610c2181610492565b602435907f0a21fdd43d0ad0c62689ee7230a47309a050755bcc52eba00310add65297692a60206001600160a01b0360443593610c5d85610bfa565b610c656136d1565b610c6d613793565b1692835f5261086d825260405f20855f52825260405f209015159060ff1981541660ff8316179055604051908152a36001606555005b3461044e575f36600319011261044e576020604051428152f35b908161018091031261044e5790565b3461044e57604036600319011261044e5760043567ffffffffffffffff811161044e57610cfd903690600401610cbd565b610d0681612eeb565b6001600160a01b031690610d1c60208201612eeb565b6001600160a01b031691610d3260408301612eeb565b6001600160a01b0316610d4760608401612eeb565b6001600160a01b031692610d5d60808201612eeb565b6001600160a01b031690610100610d75818301612ef5565b9061012090610d85848301612ef5565b9261014094858101610d9690612ef5565b966101609a8b8301610da89084612eff565b9a909b610db36106b8565b9e8f91825260208201526040015260608d015260808c015260a081013560a08c015260c081013560c08c015260e0013560e08b015263ffffffff1690890152870190610e04919063ffffffff169052565b63ffffffff909116908501523690610e1b9261070f565b908201523360243561001892613635565b3461044e57602036600319011261044e576004803567ffffffffffffffff811161044e57610e5d9036908301610cbd565b610e65613793565b60ff61086b5460e01c166110165763ffffffff80421692610140830193610e9e81610e8f87612ef5565b63ffffffff9182169116101590565b61100657610120840192610eb184612ef5565b1610610ff757610ec9610ec4368561284f565b613604565b90610edd825f5261087260205260405f2090565b54610fe95750610f2c7f3cee3e290f36226751cd0b3321b213890fe9c768e922f267fa6111836ce05c3292610f27610f21610f32945f5261087260205260405f2090565b60019055565b612ef5565b93612ef5565b610f52610f4d610f46610160860186612eff565b369161070f565b6143e0565b90610fdc6040519283926101008701359760e08801359760208101359281359260408301359260c08101359060a081013590606060808201359101358b9693909a999895919261012098959361014089019c895260208901526040880152606087015263ffffffff80921660808701521660a085015260c084015260e08301526101008201520152565b0390a36100186001606555565b604051624be79160e21b8152fd5b60405163d642b7d960e01b8152fd5b50604051630277ae7b60e21b8152fd5b50604051633d90fc5560e11b8152fd5b3461044e575f36600319011261044e5760206040517f9c6dfd61d811b9950a4f2b9adf46357b717c816d22c420d0bde8f2360148f7cd8152f35b3461044e57602036600319011261044e5760043561107d81610492565b6001600160a01b03807f00000000000000000000000000000000000000000000000000000000000000001680301461044e577f360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc90828254160361044e576110e26136d1565b604051916110ef83610622565b5f83527f4910fdfa16fed3260ed0e7147f7cc6da11a60208b5b9406d12a635614ffd91435460ff16156111285750505061001890614dc5565b6020600491604051928380926352d1902d60e01b825288165afa5f9181611161575b50611153575f80fd5b0361044e5761001891614cac565b61118491925060203d60201161118b575b61117c8183610676565b810190613ba7565b905f61114a565b503d611172565b3461044e57608036600319011261044e576004356111af816104ef565b602435906111bc82610492565b6044356111c881610492565b606435916111d583610492565b60ff5f5460081c161561044e5761121c90610c5a624c4b4063ffffffff1982541617905561086b9063ffffffff60c01b1963ffffffff60c01b83549260c01b169116179055565b6040519061122982610598565b6009825260208201916820a1a927a9a996ab1960b91b8352640312e302e360dc1b602060405161125881610598565b60058152015260ff5f5460081c161561044e57610018946112bd936112b89251902061047f557f06c015bd22b4c69690933c1058878ebdfef31f9aaae40bbe86d8a09fe1b2972c610480556112ab614847565b6112b3614856565b61486a565b6148c4565b610c5a9077ffffffffffffffffffffffffffffffffffffffff000000001977ffffffffffffffffffffffffffffffffffffffff0000000083549260201b169116179055565b602060031982011261044e576004359067ffffffffffffffff821161044e5761132d91600401610ac7565b9091565b5f5b8381106113425750505f910152565b8181015183820152602001611333565b9060209161136b81518092818552858086019101611331565b601f01601f1916010190565b6020808201908083528351809252604092604081018260408560051b8401019601945f925b8584106113ad575050505050505090565b9091929394959685806113de600193603f1986820301885286838d5180511515845201519181858201520190611352565b99019401940192959493919061139c565b3461044e576113fd36611302565b611406816108a4565b9160406114166040519485610676565b828452601f19611425846108a4565b015f5b8181106114995750505f5b83811061144c57604051806114488782611377565b0390f35b8061149361145c60019388612f55565b515f8061146a858a8a612f69565b90611479895180938193612f80565b0390305af490611487612f8d565b60208201529015159052565b01611433565b60209083516114a781610598565b5f815282606081830152828901015201611428565b3461044e575f36600319011261044e5760206040516301e133808152f35b3461044e57604036600319011261044e576024356004356114f96136d1565b611501613793565b61086c8054680100000000000000008110156105b45763ffffffff916001820190558361152d82612bc2565b5084600182015555167fc86ba04c55bc5eb2f2876b91c438849a296dbec7b08751c3074d92e04f0a77af5f80a46001606555005b604036600319011261044e5760043561157981610492565b60243567ffffffffffffffff811161044e57611599903690600401610745565b6001600160a01b03807f0000000000000000000000000000000000000000000000000000000000000000169081301461044e577f360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc91818354160361044e576115ff6136d1565b7f4910fdfa16fed3260ed0e7147f7cc6da11a60208b5b9406d12a635614ffd91435460ff16156116355750505061001890614dc5565b6020600491604051928380926352d1902d60e01b825288165afa5f918161166e575b50611660575f80fd5b0361044e5761001891614d74565b61168891925060203d60201161118b5761117c8183610676565b905f611657565b3461044e57604036600319011261044e576001600160a01b036004356116b481610492565b165f5261086d60205260405f206024355f52602052602060ff60405f2054166040519015158152f35b3461044e575f36600319011261044e5760206001600160a01b036108695416604051908152f35b3461044e575f36600319011261044e576001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016300361044e5760206040517f360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc8152f35b61012036600319011261044e5760043561178781610492565b6024359061179482610492565b604435916117a183610492565b60a4358060070b810361044e5760c435916117bb836104ef565b60e43567ffffffffffffffff811161044e576117db903690600401610745565b936117e4613793565b60ff61086b5460e81c166107f2576107eb95608435926064359261380e565b9181601f8401121561044e5782359167ffffffffffffffff831161044e576020838186019501011161044e57565b3461044e5760c036600319011261044e5760043561184e81610492565b6024356044359160643561186181610492565b67ffffffffffffffff9160843583811161044e57611883903690600401611803565b60a49491943591821161044e577f45e04bc8f121ba11466985789ca2822a91109f31bb8ac85504a37b7eaf873c26946118c36119ca933690600401611803565b9290916001600160a01b038097168a6119be6118e036868661070f565b60428d6118ee368b8b61070f565b92602081519101209460409586519160208301937f9c6dfd61d811b9950a4f2b9adf46357b717c816d22c420d0bde8f2360148f7cd85528884015246606084015260808301528760a083015260c082015260c0815261194c8161063e565b51902061047f546104805486519060208201927fc2f8787176b8ac6bf7215b4adcc1e069bf4ab82d9ab1df05a57a91d425935b6e84528883015260608201524660808201526080815261199e8161065a565b5190209085519161190160f01b835260028301526022820152208a614e08565b51978897169a87612fdc565b0390a3005b3461044e575f36600319011261044e57602060405163ffffffff7f0000000000000000000000000000000000000000000000000000000000000000168152f35b3461044e575f36600319011261044e57602060ff61086b5460e81c166040519015158152f35b606090600319011261044e57600435611a4d816104ef565b90602435611a5a81610492565b9060443561076081610492565b3461044e57611a7536611a35565b5f54600881901c60ff1615939290849081611b30575b8115611b10575b501561044e57611ab69284611aad600160ff195f5416175f55565b611af95761300f565b611abc57005b611aca61ff00195f54165f55565b604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb384740249890602090a1005b611b0b61010061ff00195f5416175f55565b61300f565b303b15915081611b22575b505f611a92565b6001915060ff16145f611b1b565b600160ff8216109150611a8b565b3461044e575f36600319011261044e5760206040517f8d1994e2bbbd77564cdca06dd819e7ee2a5efa06c80dcb59a4a7b6e39edc538f8152f35b3461044e575f36600319011261044e57602060405163ffffffff7f0000000000000000000000000000000000000000000000000000000000000000168152f35b3461044e57602036600319011261044e577fe88463c2f254e2b070013a2dc7ee1e099f9bc00534cbdf03af551dc26ae492196020600435611bf881610bfa565b611c006136d1565b611c08613793565b151561086b80547fffff00ffffffffffffffffffffffffffffffffffffffffffffffffffffffffff60ff60e81b8460e81b169116179055604051908152a16001606555005b3461044e575f36600319011261044e57602063ffffffff610c5a5416604051908152f35b61016036600319011261044e57600435611c8a81610492565b60243590611c9782610492565b604435611ca381610492565b60643590611cb082610492565b60e435611cbc81610492565b6101043590611cca826104ef565b6101243592611cd8846104ef565b610144359667ffffffffffffffff881161044e57611cfd610018983690600401611803565b97909660c4359360a4359360843593613155565b61018036600319011261044e57600435611d2a81610492565b60243590611d3782610492565b604435611d4381610492565b60643590611d5082610492565b60e435611d5c81610492565b61010435611d69816104ef565b6101243591611d77836104ef565b611d7f6104fd565b93610164359767ffffffffffffffff891161044e57611da5610018993690600401611803565b98909760c4359360a4359360843593613177565b3461044e57606036600319011261044e576020611de8600435611ddb81610492565b6044359060243590613292565b604051908152f35b3461044e57606036600319011261044e5767ffffffffffffffff60243581811161044e57611e22903690600401611803565b9160443590811161044e57611e3b903690600401611803565b9060405193602085019480611e524684888a6132ce565b0395611e66601f1997888101845283610676565b6004359151902003611ef9575f94611e95611eb793611e8c87611ec3958a990190612905565b958101906132eb565b519360405193849160208301966337bfd2c960e21b88523391602485016133b3565b03908101835282610676565b5190305af4611ed0612f8d565b9015611ed857005b60405163b8fe37a760e01b8152908190611ef590600483016133d5565b0390fd5b604051630f0c8f4760e11b8152600490fd5b3461044e57602036600319011261044e57600435611f276136d1565b611f2f613793565b611f3881612bc2565b611f70576001815f80935501557f7c1af0646963afc3343245b103731965735a893347bfa0d58a5dc77a77ae691c5f80a26001606555005b634e487b7160e01b5f525f60045260245ffd5b6101a036600319011261044e5761012435611f9d816104ef565b61014435611faa816104ef565b6101643591611fb8836104ef565b610184359267ffffffffffffffff841161044e57611fdd610018943690600401611803565b9390926101043560e43560c43560a4356084356064356044356024356004356133e6565b3461044e575f36600319011261044e5760206040517342000000000000000000000000000000000000078152f35b3461044e575f36600319011261044e5760206040516001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000168152f35b3461044e5760e036600319011261044e5767ffffffffffffffff60043581811161044e576120a4903690600401610cbd565b60a43582811161044e576120bc903690600401611803565b60c49291923593841161044e576120da610018943690600401611803565b9390926084359060643590604435906024359061345e565b3461044e5761210036611a35565b909160ff5f5460081c161561044e576121369061086b9063ffffffff60c01b1963ffffffff60c01b83549260c01b169116179055565b60405161214281610598565b6009815260208101926820a1a927a9a996ab1960b91b8452640312e302e360dc1b602060405161217181610598565b60058152015260ff5f5460081c161561044e57610018936112b89251902061047f557f06c015bd22b4c69690933c1058878ebdfef31f9aaae40bbe86d8a09fe1b2972c610480556112ab614847565b3461044e57602036600319011261044e577f2d5b62420992e5a4afce0e77742636ca2608ef58289fd2e1baa5161ef6e7e41e602060043561220081610bfa565b6122086136d1565b612210613793565b151561086b80547fffffff00ffffffffffffffffffffffffffffffffffffffffffffffffffffffff60ff60e01b8460e01b169116179055604051908152a16001606555005b3461044e575f36600319011261044e576020604051468152f35b3461044e575f36600319011261044e57602063ffffffff61086b5460c01c16604051908152f35b3461044e57604036600319011261044e576004356024356122b682614bd0565b6001600160a01b0382165f526108736020526122e560405f20336001600160a01b03165f5260205260405f2090565b54918215612388575f61232c336123166122fe85613da4565b6001600160a01b03165f5261087360205260405f2090565b906001600160a01b03165f5260205260405f2090565b556123588361234961233d84613da4565b6001600160a01b031690565b61235285613da4565b9061491e565b60405192835233927f6c172ea51018fb2eb2118f3f8a507c4df71eb519b8c0052834dc3c920182fef490602090a4005b6040516336542bf760e21b8152600490fd5b6020808201906020835283518092526040830192602060408460051b8301019501935f915b8483106123cf5750505050505090565b90919293949584806123ed600193603f198682030187528a51611352565b98019301930191949392906123bf565b3461044e5761240b36611302565b9061241582613547565b915f5b81811061242d5760405180611448868261239a565b5f8061243a838587612f69565b9061244a60405180938193612f80565b0390305af4612457612f8d565b901561247d579060019161246b8287612f55565b526124768186612f55565b5001612418565b604481511061044e5780600461044e920151602480918301019101613590565b6101808060031936011261044e57610104356124b8816104ef565b61012435916124c6836104ef565b61014435926124d4846104ef565b6101643567ffffffffffffffff811161044e576124f5903690600401611803565b6124fd613793565b61086b549260ff8460e81c166107f257610bf0966125c2610f46926125b463ffffffff6125d09860c01c16996125586125358c6135ef565b61086b9063ffffffff60c01b1963ffffffff60c01b83549260c01b169116179055565b6125606106d9565b9a6004358c5260243560208d015260443560408d015260643560608d015260843560808d015260a43560a08d015260c43560c08d015260e43560e08d01526101008c01526101208b019063ffffffff169052565b63ffffffff16610140890152565b63ffffffff16610160870152565b90820152614527565b604090600319011261044e576004356125f181610492565b9060243561076081610492565b3461044e57602061263c6001600160a01b03612619366125d9565b91165f52610873835260405f20906001600160a01b03165f5260205260405f2090565b54604051908152f35b3461044e57602036600319011261044e57602060043561266481610492565b6001600160a01b038091165f52610c5c825260405f205416604051908152f35b3461044e575f36600319011261044e5760206001600160a01b0361086a5416604051908152f35b3461044e5760c036600319011261044e5760043560243567ffffffffffffffff60643560443560843583811161044e576126e9903690600401611803565b60a49491943591821161044e577f45e04bc8f121ba11466985789ca2822a91109f31bb8ac85504a37b7eaf873c2694612729612778933690600401611803565b929091612734613793565b61273d8a614bd0565b61276c898b898961274f36888861070f565b9261275b368b8b61070f565b946001600160a01b034692166143f5565b60405196879687612fdc565b0390a36001606555005b3461044e57612790366125d9565b906127996136d1565b6127a1613793565b6001600160a01b0380911691825f52610c5d6020526127d98160405f20906001600160a01b03166001600160a01b0319825416179055565b16907fcb84c2022106a6f2b6f805d446f32fbfd2a528474364fa755f37dac1c0c1b6c85f80a36001606555005b3461044e57602036600319011261044e576004355f52610872602052602060405f2054604051908152f35b3461044e575f36600319011261044e57602060405163ffffffff8152f35b91906101808382031261044e576128646106b8565b92803584526020810135602085015260408101356040850152606081013560608501526080810135608085015260a081013560a085015260c081013560c085015260e081013560e085015261010080820135908501526101206128c881830161050b565b908501526101406128da81830161050b565b90850152610160918282013567ffffffffffffffff811161044e576128ff9201610745565b90830152565b9060208282031261044e57813567ffffffffffffffff811161044e57610760920161284f565b3461044e57602036600319011261044e5760043567ffffffffffffffff811161044e57611de8610ec4602092369060040161284f565b3461044e575f36600319011261044e57602060ff61086b5460e01c166040519015158152f35b3461044e575f36600319011261044e5760206040516ec097ce7bc90715b34b9f10000000008152f35b3461044e57602036600319011261044e576107eb6004356129d081610492565b6129d86136d1565b6112b3613793565b3461044e57606036600319011261044e5760043567ffffffffffffffff811161044e57612a1190369060040161284f565b612a19613793565b60ff61086b5460e01c16612ac35761014081015163ffffffff4281169116101580612aa4575b612a925780612a50610bf092613604565b60c082015160208301519061016084015192612a6a610698565b948552602085015260408401526060830152608082015260243560a08201526044359061417f565b604051630c3a9b9d60e41b8152600490fd5b50612ab26040820151613da4565b6001600160a01b0316331415612a3f565b604051633d90fc5560e11b8152600490fd5b3461044e575f36600319011261044e576020610c5a546001600160a01b0360405191831c168152f35b6101608060031936011261044e5761010435612b19816104ef565b61012435612b26816104ef565b6101443567ffffffffffffffff811161044e57612b47903690600401611803565b63ffffffff94612b5a8642169586613138565b93612b63613793565b61086b549160ff8360e81c166107f257612b96612ba3966125b4610bf09a610f469660c01c16996125586125358c6135ef565b86019063ffffffff169052565b610180820152614527565b634e487b7160e01b5f52603260045260245ffd5b61086c908154811015612bfc576003915f52027f71cd7344f4eb2efc8e30291f6dbdb44d618ca368ea5425d217c1d604bf26b84d01905f90565b612bae565b3461044e57602036600319011261044e5760043561086c5481101561044e57612c2b604091612bc2565b506001815491015482519182526020820152f35b3461044e57612c4d366125d9565b90612c566136d1565b612c5e613793565b6001600160a01b0380911691825f52610c5c602052612c968160405f20906001600160a01b03166001600160a01b0319825416179055565b16907ff3dc137d2246f9b8abd0bb821e185ba01122c9b3ea3745ffca6208037674d6705f80a36001606555005b3461044e57602036600319011261044e576107eb600435612ce381610492565b612ceb6136d1565b6112b8613793565b91612cfc613793565b6080820191612d15610b9884516001600160a01b031690565b602081019182514603612e1c57612d3d612d4191836001612d3589612bc2565b500154613ac0565b1590565b612e0a578060607ff4ad92585b1bc117fbdd644990adf0827bc4c95baeae8a23322af807b6d0020e920193612d83612d7d865163ffffffff1690565b87613b52565b612dfd845194835193612de2612dd4612dc360408401998a51612daa8d5163ffffffff1690565b89516001600160a01b03169160a088019b8c5194613bc3565b925193519851995163ffffffff1690565b94516001600160a01b031690565b945163ffffffff9586604051978897169b1699339487612e9d565b0390a46104ae6001606555565b60405163582f497d60e11b8152600490fd5b604051633d23e4d160e11b8152600490fd5b9081518082526020808093019301915f5b828110612e4d575050505090565b835185529381019392810192600101612e3f565b9081518082526020808093019301915f5b828110612e80575050505090565b83516001600160a01b031685529381019392810192600101612e72565b9496959193612ebf60a095612edd93885260c0602089015260c0880190612e2e565b906001600160a01b0380951660408801528682036060880152612e61565b951515608085015216910152565b3561076081610492565b35610760816104ef565b903590601e198136030182121561044e570180359067ffffffffffffffff821161044e5760200191813603831361044e57565b634e487b7160e01b5f52602160045260245ffd5b60031115612f5057565b612f32565b8051821015612bfc5760209160051b010190565b90821015612bfc5761132d9160051b810190612eff565b908092918237015f815290565b3d15612fb7573d90612f9e826106f3565b91612fac6040519384610676565b82523d5f602084013e565b606090565b908060209392818452848401375f828201840152601f01601f1916010190565b9492909361300192610760979587526020870152608060408701526080860191612fbc565b926060818503910152612fbc565b91909160ff5f5460081c161561044e5761305990610c5a624c4b4063ffffffff1982541617905561086b9063ffffffff60c01b1963ffffffff60c01b83549260c01b169116179055565b60405161306581610598565b6009815260208101926820a1a927a9a996ab1960b91b8452640312e302e360dc1b602060405161309481610598565b60058152015260ff5f5460081c161561044e576130e3936112b89251902061047f557f06c015bd22b4c69690933c1058878ebdfef31f9aaae40bbe86d8a09fe1b2972c610480556112ab614847565b6104ae610c5a77deaddeaddeaddeaddeaddeaddeaddeaddead00000000000077ffffffffffffffffffffffffffffffffffffffff0000000019825416179055565b634e487b7160e01b5f52601160045260245ffd5b91909163ffffffff8080941691160191821161315057565b613124565b96949290916104ae9b9a999896949261317563ffffffff42169889613138565b985b9593919b999897969492909b61318b613793565b61086b549660ff8860e81c166107f2578760c01c63ffffffff166131ae906135ef565b6131d59061086b9063ffffffff60c01b1963ffffffff60c01b83549260c01b169116179055565b6131dd6106d9565b9d6001600160a01b038f921682526001600160a01b031690602001526001600160a01b031660408d01526001600160a01b031660608c015260808b015260a08a015260c08901526001600160a01b031660e088015260c01c63ffffffff16610100870152610120860190613256919063ffffffff169052565b63ffffffff1661014085015263ffffffff1661016084015236906132799261070f565b61018082015261328890614527565b6104ae6001606555565b916040519160208301936bffffffffffffffffffffffff199060601b16845260348301526054820152605481526132c881610606565b51902090565b9392916020916132e691604087526040870191612fbc565b930152565b9081602091031261044e57604051906020820182811067ffffffffffffffff8211176105b45760405235815290565b6107609161018090825181526020830151602082015260408301516040820152606083015160608201526080830151608082015260a083015160a082015260c083015160c082015260e083015160e0820152610100808401519082015261338f610120808501519083019063ffffffff169052565b6101408381015163ffffffff16908201528161016080940151938201520190611352565b6133cb6040929594939560608352606083019061331a565b9460208201520152565b906020610760928181520190611352565b9c9a99989796959493929190966133fb613793565b60ff61086b5460e81c166107f257613414908e33613292565b96604051809e613423826105b9565b81526020015260408d015260608c015260808b015260a08a015260c089015260e088015261010087015263ffffffff16610120860152613256565b97929095939196949761346f613793565b60ff61086b5460e01c16612ac35761348a6101408201612ef5565b63ffffffff8042169116101580613528575b612a9257613511613523966135096132889b6134bb610ec4368761284f565b9a6134c4610698565b9b6134cf368861284f565b8d5260208d01528660408d01528760608d01526134ed368b8461070f565b60808d015260a08c01526135018535613da4565b98369161070f565b95369161070f565b9461010060e0830135920135906143f5565b61417f565b506135366040820135613da4565b6001600160a01b031633141561349c565b90613551826108a4565b61355e6040519182610676565b828152809261356f601f19916108a4565b01905f5b82811061357f57505050565b806060602080938501015201613573565b60208183031261044e5780519067ffffffffffffffff821161044e570181601f8201121561044e5780516135c3816106f3565b926135d16040519485610676565b8184526020828401011161044e576107609160208085019101611331565b63ffffffff8091169081146131505760010190565b6040516132c881613621602082019460408652606083019061331a565b46604083015203601f198101835282610676565b919091613640613793565b60ff61086b5460e01c16612ac35761014081015163ffffffff42811691161015806136b2575b612a92576132889261367782613604565b60c083015160208401519061016085015192613691610698565b958652602086015260408501526060840152608083015260a082015261417f565b506136c06040820151613da4565b6001600160a01b0316331415613666565b73420000000000000000000000000000000000000780330361378157602060049160405192838092636e296e4560e01b82525afa90811561377c575f9161374d575b506001600160a01b0361373261233d610869546001600160a01b031690565b91160361373b57565b6040516336a816d960e01b8152600490fd5b61376f915060203d602011613775575b6137678183610676565b810190614966565b5f613713565b503d61375d565b6137b1565b60405163253a6fc960e11b8152600490fd5b60026065541461044e576002606555565b9190820391821161315057565b6040513d5f823e3d90fd5b926107609695929491946101409585525f60208601526040850152606084015263ffffffff809116608084015260a08301525f60c083015260e08201525f610100820152816101208201520190611352565b9193949690959661384f612d3d6138488861383b896001600160a01b03165f5261086d60205260405f2090565b905f5260205260405f2090565b5460ff1690565b613a3b5760070b906706f05b59d3b200006138698361497b565b1015613a29576ec097ce7bc90715b34b9f10000000008411613a175763ffffffff93613897858a16426137a4565b857f00000000000000000000000000000000000000000000000000000000000000001610613a055761086b5460c01c63ffffffff16986138d96125358b6135ef565b6001600160a01b039586807f000000000000000000000000000000000000000000000000000000000000000016981692888414806139fc575b156139c0578034036139ae57883b1561044e575f6004996040519a8b8092630d0e30db60e41b825234905af198891561377c5761397d613990978a927f32ed1a409ef04c7b0227189c3a103dc5ac10e775a15b785dcc510201f7c25ad39c613995575b505b836149c9565b92604051998a99169d169b1693876137bc565b0390a4565b806139a26139a8926105d6565b80610444565b5f613975565b604051636452a35d60e01b8152600490fd5b7f32ed1a409ef04c7b0227189c3a103dc5ac10e775a15b785dcc510201f7c25ad398508761397d613990976139f78430338a61498a565b613977565b50341515613912565b60405163f722177f60e01b8152600490fd5b60405163622db5a960e11b8152600490fd5b60405163284f109760e21b8152600490fd5b604051632a58c4f360e01b8152600490fd5b6001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000811691168114613a84575b50565b47613a8c5750565b4790803b1561044e575f90600460405180948193630d0e30db60e41b83525af1801561377c5715613a81576104ae906105d6565b6107609291604051613b4981613b3b602082019460208652805160408401526020810151606084015260a0613b05604083015160c06080870152610100860190612e2e565b606083015163ffffffff168583015260808301516001600160a01b031660c0860152910151838203603f190160e0850152612e61565b03601f198101835282610676565b519020916149ff565b613b5d600291612bc2565b500162ffffff8260081c16805f5281602052600160ff60405f205494161b8080941614613b95575f5260205260405f20908154179055565b60405163954476d960e01b8152600490fd5b9081602091031261044e575190565b9190820180921161315057565b91959495939092935f9681519081815103613d925781613c42575b50505082613bed575b50505050565b6001600160a01b0381613c217ffa7fa7cf6d7dde5f9be65a67e6a1a747e7aa864dcd2d793353c722d80fbbb3579386614ac2565b6040805195865233602087015291169463ffffffff1693a45f808080613be7565b604080516370a0823160e01b81523060048083019190915291906020816024816001600160a01b038b165afa90811561377c575f91613d73575b505f805b868110613c91575050505050613bde565b613c9b8189612f55565b51613ca9575b600101613c80565b90613cbf90613cb8838a612f55565b5190613bb6565b90828211613d6357613cf9612d3d613ce7613cda848a612f55565b516001600160a01b031690565b613cf1848c612f55565b51908c614a50565b15613ca1579c5087613d59613d518f613d3c613cda613d35613d1b848f612f55565b51966001600160a01b03165f5261087360205260405f2090565b928b612f55565b6001600160a01b03165f5260205260405f2090565b918254613bb6565b905560019c613ca1565b50505051632ddaa83160e11b8152fd5b613d8c915060203d60201161118b5761117c8183610676565b5f613c7c565b6040516319a5316760e31b8152600490fd5b6001600160a01b0390613db681614bd0565b1690565b91612d3d90613e3392845160408096015191865191613dd8836105ea565b8252613b49613df36020840192468452898501958652612bc2565b5054938851928391613e186020840196602088525160608d86015260a085019061331a565b9151606084015251608083015203601f198101835282610676565b613e3a5750565b5163582f497d60e11b8152600490fd5b613e5382612f46565b52565b9a989693919c9b9997959492909c6101e08c019d8c5260208c015260408b015260608a0152608089015263ffffffff80921660a08901521660c087015260e08601526101008501526101208401526101408301528051610160830152602081015161018083015260408101516101a08301526060015190613ed682612f46565b6101c00152565b9061076094936080936001600160a01b03809316845260208401521660408201528160608201520190611352565b905f82516101208101613f22815163ffffffff1690565b63ffffffff4291161061416d576020850151906002613f4a835f5261087260205260405f2090565b541461415b57613f6486925f5261087260205260405f2090565b6002905560608301519060808401519160a08501519260c0860151918560a0810151938860e0810151956101008201519751613fa39063ffffffff1690565b61014083015163ffffffff166040840151918451936020860151956101600151613fcc906143e0565b966060890151986080019e8f51613fe2906143e0565b906040015190613ff06106e6565b9a8b5260208b015260408a0152600260608a01526040519d8e9b6140149b8d613e56565b037f44b559f101f8fbcc8a0ea43fa91a05a729a5ea6e14a7c75aa750374690137208905f94a4608082015161404890613da4565b906040860151956060015161405c90613da4565b926080015161406a90613da4565b6001600160a01b03919082167f00000000000000000000000000000000000000000000000000000000000000008316036141465784614133575b6140b087838616614beb565b51928351151580614129575b6140ca575b50505050509050565b1690813b1561412557836140f8959660405196879586948593633a5be8cb60e01b8552339160048601613edd565b03925af1801561377c57614112575b8080808085946140c1565b806139a261411f926105d6565b5f614107565b8380fd5b50803b15156140bc565b61414187303385871661498a565b6140a4565b5f9450614156878585851661491e565b6140b0565b604051630479306360e51b8152600490fd5b60405163d642b7d960e01b8152600490fd5b8051916101208301614195815163ffffffff1690565b63ffffffff4291161061416d57602083015160016141bc825f5261087260205260405f2090565b54036143d9576001905b60026141db825f5261087260205260405f2090565b541461415b576141f76141fd915f5261087260205260405f2090565b60029055565b7f44b559f101f8fbcc8a0ea43fa91a05a729a5ea6e14a7c75aa75037469013720860608601516080870151906142ca8760a08a0151958a60c08101519760a08401519860e08301519961425a6101008501519c5163ffffffff1690565b61014085015163ffffffff16916040860151938651956142be61428661016060208b01519a01516143e0565b9960608c01519b604061429c60808301516143e0565b9101519060206142aa6106e6565b9e8f528e015260408d015260608c01613e4a565b6040519c8d9c8d613e56565b0390a46142da6080830151613da4565b9160408201519160806142fc816142f46060850151613da4565b940151613da4565b6001600160a01b03929083167f00000000000000000000000000000000000000000000000000000000000000008416036143c65761433e853033868a1661498a565b61434a85848616614beb565b01519182511515806143bc575b614363575b5050505050565b16803b1561044e57614391935f809460405196879586948593633a5be8cb60e01b8552339160048601613edd565b03925af1801561377c576143a9575b8080808061435c565b806139a26143b6926105d6565b5f6143a0565b50803b1515614357565b6143d4858533868a1661498a565b61434a565b5f906141c6565b805190816143ee5750505f90565b6020012090565b93926042936104ae979660208151910120906040519260208401947f8d1994e2bbbd77564cdca06dd819e7ee2a5efa06c80dcb59a4a7b6e39edc538f86526040850152856060850152608084015260a083015260c082015260c0815261445a8161063e565b5190209061047f549061048054906040519160208301937fc2f8787176b8ac6bf7215b4adcc1e069bf4ab82d9ab1df05a57a91d425935b6e8552604084015260608301526080820152608081526144b08161065a565b519020906040519161190160f01b8352600283015260228201522090614e08565b96926107609a9996949198959261014099895260208901526040880152606087015263ffffffff928380921660808801521660a08601521660c084015260e0830152610100820152816101208201520190611352565b6145318151614bd0565b6040908181019061455d6145458351613da4565b6001600160a01b03165f5261086d60205260405f2090565b9261457a612d3d61384860c085019687515f5260205260405f2090565b6148375761012082019261459e614595855163ffffffff1690565b63ffffffff1690565b8042109081156147fe575b506147ed576101408301926145c2845163ffffffff1690565b9163ffffffff92836145f6817f00000000000000000000000000000000000000000000000000000000000000001642613bb6565b9116116147dc5761016082015163ffffffff169280841680614798575b50508051936001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000168095148061478f575b15614729576080830151340361471957843b1561044e575f600495825196878092630d0e30db60e41b825234905af191821561377c577f32ed1a409ef04c7b0227189c3a103dc5ac10e775a15b785dcc510201f7c25ad39561399093614706575b505b519260608101519460808201519060a08301519a51986146e66146db6101008601519c5163ffffffff1690565b915163ffffffff1690565b9084519c60208601519461018060e088015197015197519a8b9a8b6144d1565b806139a2614713926105d6565b5f6146ac565b51636452a35d60e01b8152600490fd5b919293503461477e577f32ed1a409ef04c7b0227189c3a103dc5ac10e775a15b785dcc510201f7c25ad39392918161477961476a61233d6139909551613da4565b6080860151903090339061498a565b6146ae565b8151636452a35d60e01b8152600490fd5b5034151561464b565b6301e1338010156147c7575b5060e0820151156147b6575f80614613565b835163495d907f60e01b8152600490fd5b926147d59193421690613138565b915f6147a4565b835163582e388960e01b8152600490fd5b815163f722177f60e01b8152600490fd5b6148099150426137a4565b63ffffffff7f000000000000000000000000000000000000000000000000000000000000000016105f6145a9565b51632a58c4f360e01b8152600490fd5b60ff5f5460081c161561044e57565b60ff5f5460081c161561044e576001606555565b6001600160a01b031680156148b257610869816001600160a01b03198254161790557fa9e8c42c9e7fca7f62755189a16b2f5314d43d8fb24e91ba54e6d65f9314e8495f80a2565b60405163ba97b39d60e01b8152600490fd5b6001600160a01b0316801561490c5761086a816001600160a01b03198254161790557fa73e8909f8616742d7fe701153d82666f7b7cd480552e23ebb05d358c22fd04e5f80a2565b604051635b03092b60e11b8152600490fd5b60405163a9059cbb60e01b60208201526001600160a01b03909216602483015260448201929092526104ae9161496182606481015b03601f198101845283610676565b614ee6565b9081602091031261044e575161076081610492565b5f81126149855790565b5f0390565b90926104ae93604051936323b872dd60e01b60208601526001600160a01b0380921660248601521660448401526064830152606482526149618261065a565b90670de0b6b3a7640000915f82840392128383128116908484139015161761315057818102918183041490151715613150570490565b929091905f915b8451831015614a4857614a198386612f55565b519081811015614a37575f52602052600160405f205b920191614a06565b905f52602052600160405f20614a2f565b915092501490565b60405163a9059cbb60e01b60208281019182526001600160a01b039094166024830152604482019490945290925f91614a8c8160648101613b3b565b519082855af1903d5f519083614aa3575b50505090565b91925090614ab857503b15155b5f8080614a9d565b6001915014614ab0565b907f0000000000000000000000000000000000000000000000000000000000000000906001600160a01b03808316818316149081614ba5575b5015614b9a575081614b0c916152df565b61086a546001600160a01b0316610c5a5463ffffffff1673bd80b06d3dbd0801132c6689429ac09ca6d27f82803b1561044e5760405163262cc5ab60e11b81526001600160a01b039093166004840152602483019390935263ffffffff166044820152905f908290818381606481015b03925af1801561377c57614b8d5750565b806139a26104ae926105d6565b90506104ae91614f76565b90507f000000000000000000000000000000000000000000000000000000000000000016155f614afb565b60a01c614bd957565b6040516379ec0ed760e11b8152600490fd5b6001600160a01b0390811690813b15614c2b57906104ae92917f00000000000000000000000000000000000000000000000000000000000000001661491e565b7f000000000000000000000000000000000000000000000000000000000000000016803b1561044e575f8091602460405180948193632e1a7d4d60e01b83528860048401525af1801561377c57614c9d575b5081471061044e575f80809381935af1614c95612f8d565b501561044e57565b614ca6906105d6565b5f614c7d565b614cb581614dc5565b6001600160a01b0381167fbc7cd75a20ee27fd9adebab32041f755214dbc6bffa90cc0225b39da2e5c2d3b5f80a2815115801590614d6d575b614cf6575050565b5f80613a81937f206661696c65640000000000000000000000000000000000000000000000000060408051614d2a816105ea565b602781527f416464726573733a206c6f772d6c6576656c2064656c65676174652063616c6c60208201520152602081519101845af4614d67612f8d565b91615686565b505f614cee565b614d7d81614dc5565b6001600160a01b0381167fbc7cd75a20ee27fd9adebab32041f755214dbc6bffa90cc0225b39da2e5c2d3b5f80a2815115801590614dbd57614cf6575050565b506001614cee565b803b1561044e576001600160a01b037f360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc91166001600160a01b0319825416179055565b614e128383615635565b6005819592951015612f5057159384614ed0575b508315614e4a575b50505015614e3857565b60405163938a182160e01b8152600490fd5b5f929350908291604051614e8281613b3b6020820194630b135d3f60e11b998a87526024840152604060448401526064830190611352565b51915afa90614e8f612f8d565b82614ec2575b82614ea5575b50505f8080614e2e565b614eba91925060208082518301019101613ba7565b145f80614e9b565b915060208251101591614e95565b6001600160a01b0383811691161493505f614e26565b905f806001600160a01b03614f3d9416927f5361666545524332303a206c6f772d6c6576656c2063616c6c206661696c65646020604051614f2681610598565b818152015260208151910182855af1614d67612f8d565b8051908115918215614f53575b50501561044e57565b819250906020918101031261044e5760200151614f6f81610bfa565b5f80614f4a565b906001600160a01b0390818116907f0000000000000000000000000000000000000000000000000000000000000000831682036150895750803b1561044e57604051632e1a7d4d60e01b815260048101849052905f908290602490829084905af1801561377c57615076575b50610c5a5491614ffb61086a546001600160a01b031690565b73420000000000000000000000000000000000001090813b1561044e57604051631474f2a960e31b81526001600160a01b03602087901c90951685166004820152931660248401526044830182905263ffffffff909316606483015260a060848301525f60a483018190529192839182908160c48101614b7c565b806139a2615083926105d6565b5f614fe2565b91807f0000000000000000000000000000000000000000000000000000000000000000161515806152b4575b156150d9575050506104ae906150d461086a546001600160a01b031690565b615449565b806151066150f9856001600160a01b03165f52610c5c60205260405f2090565b546001600160a01b031690565b16615290577342000000000000000000000000000000000000105b169061514561233d6150f9856001600160a01b03165f52610c5d60205260405f2090565b1561520a5783826151559261539c565b6151746150f9836001600160a01b03165f52610c5d60205260405f2090565b9061518861086a546001600160a01b031690565b91615199610c5a5463ffffffff1690565b823b1561044e5760405163540abf7360e01b81526001600160a01b0395861660048201529185166024830152929093166044840152606483019390935263ffffffff16608482015260c060a48201525f60c482018190529091829060e490829084905af1801561377c57614b8d5750565b509161521f61086a546001600160a01b031690565b92615230610c5a5463ffffffff1690565b93813b1561044e57604051631474f2a960e31b81526001600160a01b03948516600482015293166024840152604483019190915263ffffffff909216606482015260a060848201525f60a482018190529091829081838160c48101614b7c565b6152af6150f9846001600160a01b03165f52610c5c60205260405f2090565b615121565b50807f00000000000000000000000000000000000000000000000000000000000000001682146150b5565b604051636eb1769f60e11b815230600482015273bd80b06d3dbd0801132c6689429ac09ca6d27f82602482015290916020826044816001600160a01b0387165afa91821561377c575f9261537b575b5081018091116131505760405163095ea7b360e01b602082015273bd80b06d3dbd0801132c6689429ac09ca6d27f82602482015260448101919091526104ae916149618260648101614953565b61539591925060203d60201161118b5761117c8183610676565b905f61532e565b604051636eb1769f60e11b81523060048201526001600160a01b03831660248201529192602083806044810103816001600160a01b0386165afa92831561377c575f93615428575b5082018092116131505760405163095ea7b360e01b60208201526001600160a01b03909316602484015260448301919091526104ae91906149618260648101614953565b61544291935060203d60201161118b5761117c8183610676565b915f6153e4565b6001600160a01b03809116917f000000000000000000000000000000000000000000000000000000000000000090827f0000000000000000000000000000000000000000000000000000000000000000166154a582828561539c565b604090604051916332dd704760e21b83526020936004958585600481875afa94851561377c57869189915f97615616575b501697604051958680926352b7631960e11b8252816155088d600483019190916001600160a01b036020820193169052565b0392165afa93841561377c575f946155f7575b5092947f000000000000000000000000000000000000000000000000000000000000000093805b61555157505050505050505050565b6155a290878111156155f15787905b84516337e9a82760e11b815284810183815263ffffffff89166020820152604081018d90526001600160a01b038c166060820152909389918591829160800190565b03815f8a5af192831561377c576155be936155c4575b506137a4565b80615542565b6155e390893d8b116155ea575b6155db8183610676565b810190615666565b505f6155b8565b503d6155d1565b80615560565b61560f919450853d871161118b5761117c8183610676565b925f61551b565b61562e919750833d8511613775576137678183610676565b955f6154d6565b9060418151145f1461565d5761132d91602082015190606060408401519301515f1a906156af565b50505f90600290565b9081602091031261044e575167ffffffffffffffff8116810361044e5790565b90156156a057815115615697575090565b3b1561044e5790565b50805190811561044e57602001fd5b7f7fffffffffffffffffffffffffffffff5d576e7357a4501ddfe92f46681b20a0841161571f576020935f9360ff60809460405194855216868401526040830152606082015282805260015afa1561377c575f516001600160a01b0381161561571757905f90565b505f90600190565b505050505f9060039056fea264697066735822122081de8cafbdfc055aa138e7706e83912b790d1c719a65b618b872483c2da3859c64736f6c63430008170033",
- "deployedBytecode": "0x6080604052600436101561001a575b3615610018575f80fd5b005b5f3560e01c8063079bd2c71461043f5780630c5d5f731461043a5780630eaac9f0146104355780631186ec331461043057806311eac8551461042b57806315348e44146103b357806317fcb39b146104265780631b3d5559146104215780631fab657c1461041c578063272751c71461041757806329cb924d146104125780632e3781151461040d5780632e63e59a1461040857806333a84ff0146104035780633659cfe6146103fe578063431023b8146103f9578063437b9116146103f4578063490e49ef146103ef578063493a4f84146103ea5780634f1ef286146103e55780635249fef1146103e05780635285e058146103db57806352d1902d146103d6578063541f4f14146103d1578063577f51f8146103cc57806357f6dcb8146103c75780636068d6cb146103c2578063647c576c146103bd578063670fa8ac146103b85780636bbbcd2e146103b35780636e400983146103ae578063738b62e5146103a9578063766e0703146103a45780637aef642c1461039f5780637b9392321461039a5780637ef413e11461039557806382e2c43f146103905780638a7860ce1461038b5780638b15788e14610386578063927ede2d146103815780639748cf7c1461037c57806397943aa914610377578063979f2bc21461037257806399cc29681461036d5780639a8a059214610368578063a1244c6714610363578063a18a096e1461035e578063ac9650d814610359578063ad5425c614610354578063adb5a6a614610309578063b27a43001461034f578063b370b7f51461034a578063babb6aac14610345578063bf10268d14610340578063c35c83fc1461033b578063ceb4c98714610336578063d7e1583a14610331578063dda521131461032c578063ddd224f114610327578063de7eba7814610322578063deff4b241461031d578063e322921114610318578063ea86bd4614610313578063ee2a53f81461030e578063f79f29ed14610309578063fbbba9ac146103045763fc8a584f0361000e57612cc3565b612c3f565b6125fe565b612c01565b612afe565b612ad5565b6129e0565b6129b0565b612987565b612961565b61292b565b612831565b612806565b612782565b6126ab565b612684565b612645565b61249d565b6123fd565b612296565b61226f565b612255565b6121c0565b6120f2565b612072565b61202f565b612001565b611f83565b611f0b565b611df0565b611db9565b611d11565b611c71565b611c4d565b611bb8565b611b78565b610847565b611b3e565b611a67565b611a0f565b6119cf565b611831565b61176e565b611704565b6116dd565b61168f565b611561565b6114da565b6114bc565b6113ef565b611192565b611060565b611026565b610e2c565b610ccc565b610ca3565b610c04565b610af8565b6109ef565b610861565b610804565b610763565b610516565b6104b0565b610452565b5f91031261044e57565b5f80fd5b3461044e575f36600319011261044e57602060405163ffffffff7f0000000000000000000000000000000000000000000000000000000000000000168152f35b6001600160a01b0381160361044e57565b35906104ae82610492565b565b3461044e57602036600319011261044e5760206004356104cf81610492565b6001600160a01b038091165f52610c5d825260405f205416604051908152f35b63ffffffff81160361044e57565b61014435906104ae826104ef565b35906104ae826104ef565b3461044e57602036600319011261044e5763ffffffff600435610538816104ef565b6105406136d1565b610548613793565b16610c5a8163ffffffff198254161790557fe486a5c4bd7b36eabbfe274c99b39130277417be8d2209b4dae04c4fba64ee3a5f80a26001606555005b634e487b7160e01b5f52604160045260245ffd5b6040810190811067ffffffffffffffff8211176105b457604052565b610584565b6101a0810190811067ffffffffffffffff8211176105b457604052565b67ffffffffffffffff81116105b457604052565b6060810190811067ffffffffffffffff8211176105b457604052565b6080810190811067ffffffffffffffff8211176105b457604052565b6020810190811067ffffffffffffffff8211176105b457604052565b60e0810190811067ffffffffffffffff8211176105b457604052565b60a0810190811067ffffffffffffffff8211176105b457604052565b90601f8019910116810190811067ffffffffffffffff8211176105b457604052565b6040519060c0820182811067ffffffffffffffff8211176105b457604052565b60405190610180820182811067ffffffffffffffff8211176105b457604052565b604051906104ae826105b9565b604051906104ae82610606565b67ffffffffffffffff81116105b457601f01601f191660200190565b92919261071b826106f3565b916107296040519384610676565b82948184528183011161044e578281602093845f960137010152565b9080601f8301121561044e578160206107609335910161070f565b90565b61010036600319011261044e5760043561077c81610492565b60243561078881610492565b6084358060070b810361044e5760a435906107a2826104ef565b60c43567ffffffffffffffff811161044e576107c2903690600401610745565b926107cb613793565b60ff61086b5460e81c166107f2576107eb9460643591604435913361380e565b6001606555005b604051630b4cba3160e31b8152600490fd5b3461044e575f36600319011261044e5760206040516001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000168152f35b3461044e575f36600319011261044e5760206040515f8152f35b3461044e575f36600319011261044e5760206040516001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000168152f35b67ffffffffffffffff81116105b45760051b60200190565b9080601f8301121561044e5760209082356108d6816108a4565b936108e46040519586610676565b81855260208086019260051b82010192831161044e57602001905b82821061090d575050505090565b813581529083019083016108ff565b9080601f8301121561044e576020908235610936816108a4565b936109446040519586610676565b81855260208086019260051b82010192831161044e57602001905b82821061096d575050505090565b838091833561097b81610492565b81520191019061095f565b9291610991826108a4565b9161099f6040519384610676565b829481845260208094019160051b810192831161044e57905b8282106109c55750505050565b813581529083019083016109b8565b9080601f8301121561044e5781602061076093359101610986565b60031960603682011261044e57600435610a08816104ef565b60243567ffffffffffffffff9283821161044e5760c090823603011261044e57610a30610698565b908060040135825260248101356020830152604481013584811161044e57610a5e90600436918401016108bc565b6040830152610a6f6064820161050b565b6060830152610a80608482016104a3565b608083015260a48101359084821161044e576004610aa1923692010161091c565b60a082015260443592831161044e57610ac16100189336906004016109d4565b91612cf3565b9181601f8401121561044e5782359167ffffffffffffffff831161044e576020808501948460051b01011161044e57565b3461044e5760031960603682011261044e5760043567ffffffffffffffff80821161044e5760608236039384011261044e5760243590610b37826104ef565b60443590811161044e57610b4f903690600401610ac7565b919093610b5a613793565b600484013590610182190181121561044e57610bf094610beb93610b87610be4936004369189010161284f565b95610b9d610b986080890151613da4565b613a4d565b610ba687613604565b9060446020890151916101608a015193610bbe610698565b9a8b5260208b015201356040890152606088015260808701525f60a08701523691610986565b9083613dba565b613f0b565b6100186001606555565b8015150361044e57565b3461044e57606036600319011261044e57600435610c2181610492565b602435907f0a21fdd43d0ad0c62689ee7230a47309a050755bcc52eba00310add65297692a60206001600160a01b0360443593610c5d85610bfa565b610c656136d1565b610c6d613793565b1692835f5261086d825260405f20855f52825260405f209015159060ff1981541660ff8316179055604051908152a36001606555005b3461044e575f36600319011261044e576020604051428152f35b908161018091031261044e5790565b3461044e57604036600319011261044e5760043567ffffffffffffffff811161044e57610cfd903690600401610cbd565b610d0681612eeb565b6001600160a01b031690610d1c60208201612eeb565b6001600160a01b031691610d3260408301612eeb565b6001600160a01b0316610d4760608401612eeb565b6001600160a01b031692610d5d60808201612eeb565b6001600160a01b031690610100610d75818301612ef5565b9061012090610d85848301612ef5565b9261014094858101610d9690612ef5565b966101609a8b8301610da89084612eff565b9a909b610db36106b8565b9e8f91825260208201526040015260608d015260808c015260a081013560a08c015260c081013560c08c015260e0013560e08b015263ffffffff1690890152870190610e04919063ffffffff169052565b63ffffffff909116908501523690610e1b9261070f565b908201523360243561001892613635565b3461044e57602036600319011261044e576004803567ffffffffffffffff811161044e57610e5d9036908301610cbd565b610e65613793565b60ff61086b5460e01c166110165763ffffffff80421692610140830193610e9e81610e8f87612ef5565b63ffffffff9182169116101590565b61100657610120840192610eb184612ef5565b1610610ff757610ec9610ec4368561284f565b613604565b90610edd825f5261087260205260405f2090565b54610fe95750610f2c7f3cee3e290f36226751cd0b3321b213890fe9c768e922f267fa6111836ce05c3292610f27610f21610f32945f5261087260205260405f2090565b60019055565b612ef5565b93612ef5565b610f52610f4d610f46610160860186612eff565b369161070f565b6143e0565b90610fdc6040519283926101008701359760e08801359760208101359281359260408301359260c08101359060a081013590606060808201359101358b9693909a999895919261012098959361014089019c895260208901526040880152606087015263ffffffff80921660808701521660a085015260c084015260e08301526101008201520152565b0390a36100186001606555565b604051624be79160e21b8152fd5b60405163d642b7d960e01b8152fd5b50604051630277ae7b60e21b8152fd5b50604051633d90fc5560e11b8152fd5b3461044e575f36600319011261044e5760206040517f9c6dfd61d811b9950a4f2b9adf46357b717c816d22c420d0bde8f2360148f7cd8152f35b3461044e57602036600319011261044e5760043561107d81610492565b6001600160a01b03807f00000000000000000000000000000000000000000000000000000000000000001680301461044e577f360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc90828254160361044e576110e26136d1565b604051916110ef83610622565b5f83527f4910fdfa16fed3260ed0e7147f7cc6da11a60208b5b9406d12a635614ffd91435460ff16156111285750505061001890614dc5565b6020600491604051928380926352d1902d60e01b825288165afa5f9181611161575b50611153575f80fd5b0361044e5761001891614cac565b61118491925060203d60201161118b575b61117c8183610676565b810190613ba7565b905f61114a565b503d611172565b3461044e57608036600319011261044e576004356111af816104ef565b602435906111bc82610492565b6044356111c881610492565b606435916111d583610492565b60ff5f5460081c161561044e5761121c90610c5a624c4b4063ffffffff1982541617905561086b9063ffffffff60c01b1963ffffffff60c01b83549260c01b169116179055565b6040519061122982610598565b6009825260208201916820a1a927a9a996ab1960b91b8352640312e302e360dc1b602060405161125881610598565b60058152015260ff5f5460081c161561044e57610018946112bd936112b89251902061047f557f06c015bd22b4c69690933c1058878ebdfef31f9aaae40bbe86d8a09fe1b2972c610480556112ab614847565b6112b3614856565b61486a565b6148c4565b610c5a9077ffffffffffffffffffffffffffffffffffffffff000000001977ffffffffffffffffffffffffffffffffffffffff0000000083549260201b169116179055565b602060031982011261044e576004359067ffffffffffffffff821161044e5761132d91600401610ac7565b9091565b5f5b8381106113425750505f910152565b8181015183820152602001611333565b9060209161136b81518092818552858086019101611331565b601f01601f1916010190565b6020808201908083528351809252604092604081018260408560051b8401019601945f925b8584106113ad575050505050505090565b9091929394959685806113de600193603f1986820301885286838d5180511515845201519181858201520190611352565b99019401940192959493919061139c565b3461044e576113fd36611302565b611406816108a4565b9160406114166040519485610676565b828452601f19611425846108a4565b015f5b8181106114995750505f5b83811061144c57604051806114488782611377565b0390f35b8061149361145c60019388612f55565b515f8061146a858a8a612f69565b90611479895180938193612f80565b0390305af490611487612f8d565b60208201529015159052565b01611433565b60209083516114a781610598565b5f815282606081830152828901015201611428565b3461044e575f36600319011261044e5760206040516301e133808152f35b3461044e57604036600319011261044e576024356004356114f96136d1565b611501613793565b61086c8054680100000000000000008110156105b45763ffffffff916001820190558361152d82612bc2565b5084600182015555167fc86ba04c55bc5eb2f2876b91c438849a296dbec7b08751c3074d92e04f0a77af5f80a46001606555005b604036600319011261044e5760043561157981610492565b60243567ffffffffffffffff811161044e57611599903690600401610745565b6001600160a01b03807f0000000000000000000000000000000000000000000000000000000000000000169081301461044e577f360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc91818354160361044e576115ff6136d1565b7f4910fdfa16fed3260ed0e7147f7cc6da11a60208b5b9406d12a635614ffd91435460ff16156116355750505061001890614dc5565b6020600491604051928380926352d1902d60e01b825288165afa5f918161166e575b50611660575f80fd5b0361044e5761001891614d74565b61168891925060203d60201161118b5761117c8183610676565b905f611657565b3461044e57604036600319011261044e576001600160a01b036004356116b481610492565b165f5261086d60205260405f206024355f52602052602060ff60405f2054166040519015158152f35b3461044e575f36600319011261044e5760206001600160a01b036108695416604051908152f35b3461044e575f36600319011261044e576001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016300361044e5760206040517f360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc8152f35b61012036600319011261044e5760043561178781610492565b6024359061179482610492565b604435916117a183610492565b60a4358060070b810361044e5760c435916117bb836104ef565b60e43567ffffffffffffffff811161044e576117db903690600401610745565b936117e4613793565b60ff61086b5460e81c166107f2576107eb95608435926064359261380e565b9181601f8401121561044e5782359167ffffffffffffffff831161044e576020838186019501011161044e57565b3461044e5760c036600319011261044e5760043561184e81610492565b6024356044359160643561186181610492565b67ffffffffffffffff9160843583811161044e57611883903690600401611803565b60a49491943591821161044e577f45e04bc8f121ba11466985789ca2822a91109f31bb8ac85504a37b7eaf873c26946118c36119ca933690600401611803565b9290916001600160a01b038097168a6119be6118e036868661070f565b60428d6118ee368b8b61070f565b92602081519101209460409586519160208301937f9c6dfd61d811b9950a4f2b9adf46357b717c816d22c420d0bde8f2360148f7cd85528884015246606084015260808301528760a083015260c082015260c0815261194c8161063e565b51902061047f546104805486519060208201927fc2f8787176b8ac6bf7215b4adcc1e069bf4ab82d9ab1df05a57a91d425935b6e84528883015260608201524660808201526080815261199e8161065a565b5190209085519161190160f01b835260028301526022820152208a614e08565b51978897169a87612fdc565b0390a3005b3461044e575f36600319011261044e57602060405163ffffffff7f0000000000000000000000000000000000000000000000000000000000000000168152f35b3461044e575f36600319011261044e57602060ff61086b5460e81c166040519015158152f35b606090600319011261044e57600435611a4d816104ef565b90602435611a5a81610492565b9060443561076081610492565b3461044e57611a7536611a35565b5f54600881901c60ff1615939290849081611b30575b8115611b10575b501561044e57611ab69284611aad600160ff195f5416175f55565b611af95761300f565b611abc57005b611aca61ff00195f54165f55565b604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb384740249890602090a1005b611b0b61010061ff00195f5416175f55565b61300f565b303b15915081611b22575b505f611a92565b6001915060ff16145f611b1b565b600160ff8216109150611a8b565b3461044e575f36600319011261044e5760206040517f8d1994e2bbbd77564cdca06dd819e7ee2a5efa06c80dcb59a4a7b6e39edc538f8152f35b3461044e575f36600319011261044e57602060405163ffffffff7f0000000000000000000000000000000000000000000000000000000000000000168152f35b3461044e57602036600319011261044e577fe88463c2f254e2b070013a2dc7ee1e099f9bc00534cbdf03af551dc26ae492196020600435611bf881610bfa565b611c006136d1565b611c08613793565b151561086b80547fffff00ffffffffffffffffffffffffffffffffffffffffffffffffffffffffff60ff60e81b8460e81b169116179055604051908152a16001606555005b3461044e575f36600319011261044e57602063ffffffff610c5a5416604051908152f35b61016036600319011261044e57600435611c8a81610492565b60243590611c9782610492565b604435611ca381610492565b60643590611cb082610492565b60e435611cbc81610492565b6101043590611cca826104ef565b6101243592611cd8846104ef565b610144359667ffffffffffffffff881161044e57611cfd610018983690600401611803565b97909660c4359360a4359360843593613155565b61018036600319011261044e57600435611d2a81610492565b60243590611d3782610492565b604435611d4381610492565b60643590611d5082610492565b60e435611d5c81610492565b61010435611d69816104ef565b6101243591611d77836104ef565b611d7f6104fd565b93610164359767ffffffffffffffff891161044e57611da5610018993690600401611803565b98909760c4359360a4359360843593613177565b3461044e57606036600319011261044e576020611de8600435611ddb81610492565b6044359060243590613292565b604051908152f35b3461044e57606036600319011261044e5767ffffffffffffffff60243581811161044e57611e22903690600401611803565b9160443590811161044e57611e3b903690600401611803565b9060405193602085019480611e524684888a6132ce565b0395611e66601f1997888101845283610676565b6004359151902003611ef9575f94611e95611eb793611e8c87611ec3958a990190612905565b958101906132eb565b519360405193849160208301966337bfd2c960e21b88523391602485016133b3565b03908101835282610676565b5190305af4611ed0612f8d565b9015611ed857005b60405163b8fe37a760e01b8152908190611ef590600483016133d5565b0390fd5b604051630f0c8f4760e11b8152600490fd5b3461044e57602036600319011261044e57600435611f276136d1565b611f2f613793565b611f3881612bc2565b611f70576001815f80935501557f7c1af0646963afc3343245b103731965735a893347bfa0d58a5dc77a77ae691c5f80a26001606555005b634e487b7160e01b5f525f60045260245ffd5b6101a036600319011261044e5761012435611f9d816104ef565b61014435611faa816104ef565b6101643591611fb8836104ef565b610184359267ffffffffffffffff841161044e57611fdd610018943690600401611803565b9390926101043560e43560c43560a4356084356064356044356024356004356133e6565b3461044e575f36600319011261044e5760206040517342000000000000000000000000000000000000078152f35b3461044e575f36600319011261044e5760206040516001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000168152f35b3461044e5760e036600319011261044e5767ffffffffffffffff60043581811161044e576120a4903690600401610cbd565b60a43582811161044e576120bc903690600401611803565b60c49291923593841161044e576120da610018943690600401611803565b9390926084359060643590604435906024359061345e565b3461044e5761210036611a35565b909160ff5f5460081c161561044e576121369061086b9063ffffffff60c01b1963ffffffff60c01b83549260c01b169116179055565b60405161214281610598565b6009815260208101926820a1a927a9a996ab1960b91b8452640312e302e360dc1b602060405161217181610598565b60058152015260ff5f5460081c161561044e57610018936112b89251902061047f557f06c015bd22b4c69690933c1058878ebdfef31f9aaae40bbe86d8a09fe1b2972c610480556112ab614847565b3461044e57602036600319011261044e577f2d5b62420992e5a4afce0e77742636ca2608ef58289fd2e1baa5161ef6e7e41e602060043561220081610bfa565b6122086136d1565b612210613793565b151561086b80547fffffff00ffffffffffffffffffffffffffffffffffffffffffffffffffffffff60ff60e01b8460e01b169116179055604051908152a16001606555005b3461044e575f36600319011261044e576020604051468152f35b3461044e575f36600319011261044e57602063ffffffff61086b5460c01c16604051908152f35b3461044e57604036600319011261044e576004356024356122b682614bd0565b6001600160a01b0382165f526108736020526122e560405f20336001600160a01b03165f5260205260405f2090565b54918215612388575f61232c336123166122fe85613da4565b6001600160a01b03165f5261087360205260405f2090565b906001600160a01b03165f5260205260405f2090565b556123588361234961233d84613da4565b6001600160a01b031690565b61235285613da4565b9061491e565b60405192835233927f6c172ea51018fb2eb2118f3f8a507c4df71eb519b8c0052834dc3c920182fef490602090a4005b6040516336542bf760e21b8152600490fd5b6020808201906020835283518092526040830192602060408460051b8301019501935f915b8483106123cf5750505050505090565b90919293949584806123ed600193603f198682030187528a51611352565b98019301930191949392906123bf565b3461044e5761240b36611302565b9061241582613547565b915f5b81811061242d5760405180611448868261239a565b5f8061243a838587612f69565b9061244a60405180938193612f80565b0390305af4612457612f8d565b901561247d579060019161246b8287612f55565b526124768186612f55565b5001612418565b604481511061044e5780600461044e920151602480918301019101613590565b6101808060031936011261044e57610104356124b8816104ef565b61012435916124c6836104ef565b61014435926124d4846104ef565b6101643567ffffffffffffffff811161044e576124f5903690600401611803565b6124fd613793565b61086b549260ff8460e81c166107f257610bf0966125c2610f46926125b463ffffffff6125d09860c01c16996125586125358c6135ef565b61086b9063ffffffff60c01b1963ffffffff60c01b83549260c01b169116179055565b6125606106d9565b9a6004358c5260243560208d015260443560408d015260643560608d015260843560808d015260a43560a08d015260c43560c08d015260e43560e08d01526101008c01526101208b019063ffffffff169052565b63ffffffff16610140890152565b63ffffffff16610160870152565b90820152614527565b604090600319011261044e576004356125f181610492565b9060243561076081610492565b3461044e57602061263c6001600160a01b03612619366125d9565b91165f52610873835260405f20906001600160a01b03165f5260205260405f2090565b54604051908152f35b3461044e57602036600319011261044e57602060043561266481610492565b6001600160a01b038091165f52610c5c825260405f205416604051908152f35b3461044e575f36600319011261044e5760206001600160a01b0361086a5416604051908152f35b3461044e5760c036600319011261044e5760043560243567ffffffffffffffff60643560443560843583811161044e576126e9903690600401611803565b60a49491943591821161044e577f45e04bc8f121ba11466985789ca2822a91109f31bb8ac85504a37b7eaf873c2694612729612778933690600401611803565b929091612734613793565b61273d8a614bd0565b61276c898b898961274f36888861070f565b9261275b368b8b61070f565b946001600160a01b034692166143f5565b60405196879687612fdc565b0390a36001606555005b3461044e57612790366125d9565b906127996136d1565b6127a1613793565b6001600160a01b0380911691825f52610c5d6020526127d98160405f20906001600160a01b03166001600160a01b0319825416179055565b16907fcb84c2022106a6f2b6f805d446f32fbfd2a528474364fa755f37dac1c0c1b6c85f80a36001606555005b3461044e57602036600319011261044e576004355f52610872602052602060405f2054604051908152f35b3461044e575f36600319011261044e57602060405163ffffffff8152f35b91906101808382031261044e576128646106b8565b92803584526020810135602085015260408101356040850152606081013560608501526080810135608085015260a081013560a085015260c081013560c085015260e081013560e085015261010080820135908501526101206128c881830161050b565b908501526101406128da81830161050b565b90850152610160918282013567ffffffffffffffff811161044e576128ff9201610745565b90830152565b9060208282031261044e57813567ffffffffffffffff811161044e57610760920161284f565b3461044e57602036600319011261044e5760043567ffffffffffffffff811161044e57611de8610ec4602092369060040161284f565b3461044e575f36600319011261044e57602060ff61086b5460e01c166040519015158152f35b3461044e575f36600319011261044e5760206040516ec097ce7bc90715b34b9f10000000008152f35b3461044e57602036600319011261044e576107eb6004356129d081610492565b6129d86136d1565b6112b3613793565b3461044e57606036600319011261044e5760043567ffffffffffffffff811161044e57612a1190369060040161284f565b612a19613793565b60ff61086b5460e01c16612ac35761014081015163ffffffff4281169116101580612aa4575b612a925780612a50610bf092613604565b60c082015160208301519061016084015192612a6a610698565b948552602085015260408401526060830152608082015260243560a08201526044359061417f565b604051630c3a9b9d60e41b8152600490fd5b50612ab26040820151613da4565b6001600160a01b0316331415612a3f565b604051633d90fc5560e11b8152600490fd5b3461044e575f36600319011261044e576020610c5a546001600160a01b0360405191831c168152f35b6101608060031936011261044e5761010435612b19816104ef565b61012435612b26816104ef565b6101443567ffffffffffffffff811161044e57612b47903690600401611803565b63ffffffff94612b5a8642169586613138565b93612b63613793565b61086b549160ff8360e81c166107f257612b96612ba3966125b4610bf09a610f469660c01c16996125586125358c6135ef565b86019063ffffffff169052565b610180820152614527565b634e487b7160e01b5f52603260045260245ffd5b61086c908154811015612bfc576003915f52027f71cd7344f4eb2efc8e30291f6dbdb44d618ca368ea5425d217c1d604bf26b84d01905f90565b612bae565b3461044e57602036600319011261044e5760043561086c5481101561044e57612c2b604091612bc2565b506001815491015482519182526020820152f35b3461044e57612c4d366125d9565b90612c566136d1565b612c5e613793565b6001600160a01b0380911691825f52610c5c602052612c968160405f20906001600160a01b03166001600160a01b0319825416179055565b16907ff3dc137d2246f9b8abd0bb821e185ba01122c9b3ea3745ffca6208037674d6705f80a36001606555005b3461044e57602036600319011261044e576107eb600435612ce381610492565b612ceb6136d1565b6112b8613793565b91612cfc613793565b6080820191612d15610b9884516001600160a01b031690565b602081019182514603612e1c57612d3d612d4191836001612d3589612bc2565b500154613ac0565b1590565b612e0a578060607ff4ad92585b1bc117fbdd644990adf0827bc4c95baeae8a23322af807b6d0020e920193612d83612d7d865163ffffffff1690565b87613b52565b612dfd845194835193612de2612dd4612dc360408401998a51612daa8d5163ffffffff1690565b89516001600160a01b03169160a088019b8c5194613bc3565b925193519851995163ffffffff1690565b94516001600160a01b031690565b945163ffffffff9586604051978897169b1699339487612e9d565b0390a46104ae6001606555565b60405163582f497d60e11b8152600490fd5b604051633d23e4d160e11b8152600490fd5b9081518082526020808093019301915f5b828110612e4d575050505090565b835185529381019392810192600101612e3f565b9081518082526020808093019301915f5b828110612e80575050505090565b83516001600160a01b031685529381019392810192600101612e72565b9496959193612ebf60a095612edd93885260c0602089015260c0880190612e2e565b906001600160a01b0380951660408801528682036060880152612e61565b951515608085015216910152565b3561076081610492565b35610760816104ef565b903590601e198136030182121561044e570180359067ffffffffffffffff821161044e5760200191813603831361044e57565b634e487b7160e01b5f52602160045260245ffd5b60031115612f5057565b612f32565b8051821015612bfc5760209160051b010190565b90821015612bfc5761132d9160051b810190612eff565b908092918237015f815290565b3d15612fb7573d90612f9e826106f3565b91612fac6040519384610676565b82523d5f602084013e565b606090565b908060209392818452848401375f828201840152601f01601f1916010190565b9492909361300192610760979587526020870152608060408701526080860191612fbc565b926060818503910152612fbc565b91909160ff5f5460081c161561044e5761305990610c5a624c4b4063ffffffff1982541617905561086b9063ffffffff60c01b1963ffffffff60c01b83549260c01b169116179055565b60405161306581610598565b6009815260208101926820a1a927a9a996ab1960b91b8452640312e302e360dc1b602060405161309481610598565b60058152015260ff5f5460081c161561044e576130e3936112b89251902061047f557f06c015bd22b4c69690933c1058878ebdfef31f9aaae40bbe86d8a09fe1b2972c610480556112ab614847565b6104ae610c5a77deaddeaddeaddeaddeaddeaddeaddeaddead00000000000077ffffffffffffffffffffffffffffffffffffffff0000000019825416179055565b634e487b7160e01b5f52601160045260245ffd5b91909163ffffffff8080941691160191821161315057565b613124565b96949290916104ae9b9a999896949261317563ffffffff42169889613138565b985b9593919b999897969492909b61318b613793565b61086b549660ff8860e81c166107f2578760c01c63ffffffff166131ae906135ef565b6131d59061086b9063ffffffff60c01b1963ffffffff60c01b83549260c01b169116179055565b6131dd6106d9565b9d6001600160a01b038f921682526001600160a01b031690602001526001600160a01b031660408d01526001600160a01b031660608c015260808b015260a08a015260c08901526001600160a01b031660e088015260c01c63ffffffff16610100870152610120860190613256919063ffffffff169052565b63ffffffff1661014085015263ffffffff1661016084015236906132799261070f565b61018082015261328890614527565b6104ae6001606555565b916040519160208301936bffffffffffffffffffffffff199060601b16845260348301526054820152605481526132c881610606565b51902090565b9392916020916132e691604087526040870191612fbc565b930152565b9081602091031261044e57604051906020820182811067ffffffffffffffff8211176105b45760405235815290565b6107609161018090825181526020830151602082015260408301516040820152606083015160608201526080830151608082015260a083015160a082015260c083015160c082015260e083015160e0820152610100808401519082015261338f610120808501519083019063ffffffff169052565b6101408381015163ffffffff16908201528161016080940151938201520190611352565b6133cb6040929594939560608352606083019061331a565b9460208201520152565b906020610760928181520190611352565b9c9a99989796959493929190966133fb613793565b60ff61086b5460e81c166107f257613414908e33613292565b96604051809e613423826105b9565b81526020015260408d015260608c015260808b015260a08a015260c089015260e088015261010087015263ffffffff16610120860152613256565b97929095939196949761346f613793565b60ff61086b5460e01c16612ac35761348a6101408201612ef5565b63ffffffff8042169116101580613528575b612a9257613511613523966135096132889b6134bb610ec4368761284f565b9a6134c4610698565b9b6134cf368861284f565b8d5260208d01528660408d01528760608d01526134ed368b8461070f565b60808d015260a08c01526135018535613da4565b98369161070f565b95369161070f565b9461010060e0830135920135906143f5565b61417f565b506135366040820135613da4565b6001600160a01b031633141561349c565b90613551826108a4565b61355e6040519182610676565b828152809261356f601f19916108a4565b01905f5b82811061357f57505050565b806060602080938501015201613573565b60208183031261044e5780519067ffffffffffffffff821161044e570181601f8201121561044e5780516135c3816106f3565b926135d16040519485610676565b8184526020828401011161044e576107609160208085019101611331565b63ffffffff8091169081146131505760010190565b6040516132c881613621602082019460408652606083019061331a565b46604083015203601f198101835282610676565b919091613640613793565b60ff61086b5460e01c16612ac35761014081015163ffffffff42811691161015806136b2575b612a92576132889261367782613604565b60c083015160208401519061016085015192613691610698565b958652602086015260408501526060840152608083015260a082015261417f565b506136c06040820151613da4565b6001600160a01b0316331415613666565b73420000000000000000000000000000000000000780330361378157602060049160405192838092636e296e4560e01b82525afa90811561377c575f9161374d575b506001600160a01b0361373261233d610869546001600160a01b031690565b91160361373b57565b6040516336a816d960e01b8152600490fd5b61376f915060203d602011613775575b6137678183610676565b810190614966565b5f613713565b503d61375d565b6137b1565b60405163253a6fc960e11b8152600490fd5b60026065541461044e576002606555565b9190820391821161315057565b6040513d5f823e3d90fd5b926107609695929491946101409585525f60208601526040850152606084015263ffffffff809116608084015260a08301525f60c083015260e08201525f610100820152816101208201520190611352565b9193949690959661384f612d3d6138488861383b896001600160a01b03165f5261086d60205260405f2090565b905f5260205260405f2090565b5460ff1690565b613a3b5760070b906706f05b59d3b200006138698361497b565b1015613a29576ec097ce7bc90715b34b9f10000000008411613a175763ffffffff93613897858a16426137a4565b857f00000000000000000000000000000000000000000000000000000000000000001610613a055761086b5460c01c63ffffffff16986138d96125358b6135ef565b6001600160a01b039586807f000000000000000000000000000000000000000000000000000000000000000016981692888414806139fc575b156139c0578034036139ae57883b1561044e575f6004996040519a8b8092630d0e30db60e41b825234905af198891561377c5761397d613990978a927f32ed1a409ef04c7b0227189c3a103dc5ac10e775a15b785dcc510201f7c25ad39c613995575b505b836149c9565b92604051998a99169d169b1693876137bc565b0390a4565b806139a26139a8926105d6565b80610444565b5f613975565b604051636452a35d60e01b8152600490fd5b7f32ed1a409ef04c7b0227189c3a103dc5ac10e775a15b785dcc510201f7c25ad398508761397d613990976139f78430338a61498a565b613977565b50341515613912565b60405163f722177f60e01b8152600490fd5b60405163622db5a960e11b8152600490fd5b60405163284f109760e21b8152600490fd5b604051632a58c4f360e01b8152600490fd5b6001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000811691168114613a84575b50565b47613a8c5750565b4790803b1561044e575f90600460405180948193630d0e30db60e41b83525af1801561377c5715613a81576104ae906105d6565b6107609291604051613b4981613b3b602082019460208652805160408401526020810151606084015260a0613b05604083015160c06080870152610100860190612e2e565b606083015163ffffffff168583015260808301516001600160a01b031660c0860152910151838203603f190160e0850152612e61565b03601f198101835282610676565b519020916149ff565b613b5d600291612bc2565b500162ffffff8260081c16805f5281602052600160ff60405f205494161b8080941614613b95575f5260205260405f20908154179055565b60405163954476d960e01b8152600490fd5b9081602091031261044e575190565b9190820180921161315057565b91959495939092935f9681519081815103613d925781613c42575b50505082613bed575b50505050565b6001600160a01b0381613c217ffa7fa7cf6d7dde5f9be65a67e6a1a747e7aa864dcd2d793353c722d80fbbb3579386614ac2565b6040805195865233602087015291169463ffffffff1693a45f808080613be7565b604080516370a0823160e01b81523060048083019190915291906020816024816001600160a01b038b165afa90811561377c575f91613d73575b505f805b868110613c91575050505050613bde565b613c9b8189612f55565b51613ca9575b600101613c80565b90613cbf90613cb8838a612f55565b5190613bb6565b90828211613d6357613cf9612d3d613ce7613cda848a612f55565b516001600160a01b031690565b613cf1848c612f55565b51908c614a50565b15613ca1579c5087613d59613d518f613d3c613cda613d35613d1b848f612f55565b51966001600160a01b03165f5261087360205260405f2090565b928b612f55565b6001600160a01b03165f5260205260405f2090565b918254613bb6565b905560019c613ca1565b50505051632ddaa83160e11b8152fd5b613d8c915060203d60201161118b5761117c8183610676565b5f613c7c565b6040516319a5316760e31b8152600490fd5b6001600160a01b0390613db681614bd0565b1690565b91612d3d90613e3392845160408096015191865191613dd8836105ea565b8252613b49613df36020840192468452898501958652612bc2565b5054938851928391613e186020840196602088525160608d86015260a085019061331a565b9151606084015251608083015203601f198101835282610676565b613e3a5750565b5163582f497d60e11b8152600490fd5b613e5382612f46565b52565b9a989693919c9b9997959492909c6101e08c019d8c5260208c015260408b015260608a0152608089015263ffffffff80921660a08901521660c087015260e08601526101008501526101208401526101408301528051610160830152602081015161018083015260408101516101a08301526060015190613ed682612f46565b6101c00152565b9061076094936080936001600160a01b03809316845260208401521660408201528160608201520190611352565b905f82516101208101613f22815163ffffffff1690565b63ffffffff4291161061416d576020850151906002613f4a835f5261087260205260405f2090565b541461415b57613f6486925f5261087260205260405f2090565b6002905560608301519060808401519160a08501519260c0860151918560a0810151938860e0810151956101008201519751613fa39063ffffffff1690565b61014083015163ffffffff166040840151918451936020860151956101600151613fcc906143e0565b966060890151986080019e8f51613fe2906143e0565b906040015190613ff06106e6565b9a8b5260208b015260408a0152600260608a01526040519d8e9b6140149b8d613e56565b037f44b559f101f8fbcc8a0ea43fa91a05a729a5ea6e14a7c75aa750374690137208905f94a4608082015161404890613da4565b906040860151956060015161405c90613da4565b926080015161406a90613da4565b6001600160a01b03919082167f00000000000000000000000000000000000000000000000000000000000000008316036141465784614133575b6140b087838616614beb565b51928351151580614129575b6140ca575b50505050509050565b1690813b1561412557836140f8959660405196879586948593633a5be8cb60e01b8552339160048601613edd565b03925af1801561377c57614112575b8080808085946140c1565b806139a261411f926105d6565b5f614107565b8380fd5b50803b15156140bc565b61414187303385871661498a565b6140a4565b5f9450614156878585851661491e565b6140b0565b604051630479306360e51b8152600490fd5b60405163d642b7d960e01b8152600490fd5b8051916101208301614195815163ffffffff1690565b63ffffffff4291161061416d57602083015160016141bc825f5261087260205260405f2090565b54036143d9576001905b60026141db825f5261087260205260405f2090565b541461415b576141f76141fd915f5261087260205260405f2090565b60029055565b7f44b559f101f8fbcc8a0ea43fa91a05a729a5ea6e14a7c75aa75037469013720860608601516080870151906142ca8760a08a0151958a60c08101519760a08401519860e08301519961425a6101008501519c5163ffffffff1690565b61014085015163ffffffff16916040860151938651956142be61428661016060208b01519a01516143e0565b9960608c01519b604061429c60808301516143e0565b9101519060206142aa6106e6565b9e8f528e015260408d015260608c01613e4a565b6040519c8d9c8d613e56565b0390a46142da6080830151613da4565b9160408201519160806142fc816142f46060850151613da4565b940151613da4565b6001600160a01b03929083167f00000000000000000000000000000000000000000000000000000000000000008416036143c65761433e853033868a1661498a565b61434a85848616614beb565b01519182511515806143bc575b614363575b5050505050565b16803b1561044e57614391935f809460405196879586948593633a5be8cb60e01b8552339160048601613edd565b03925af1801561377c576143a9575b8080808061435c565b806139a26143b6926105d6565b5f6143a0565b50803b1515614357565b6143d4858533868a1661498a565b61434a565b5f906141c6565b805190816143ee5750505f90565b6020012090565b93926042936104ae979660208151910120906040519260208401947f8d1994e2bbbd77564cdca06dd819e7ee2a5efa06c80dcb59a4a7b6e39edc538f86526040850152856060850152608084015260a083015260c082015260c0815261445a8161063e565b5190209061047f549061048054906040519160208301937fc2f8787176b8ac6bf7215b4adcc1e069bf4ab82d9ab1df05a57a91d425935b6e8552604084015260608301526080820152608081526144b08161065a565b519020906040519161190160f01b8352600283015260228201522090614e08565b96926107609a9996949198959261014099895260208901526040880152606087015263ffffffff928380921660808801521660a08601521660c084015260e0830152610100820152816101208201520190611352565b6145318151614bd0565b6040908181019061455d6145458351613da4565b6001600160a01b03165f5261086d60205260405f2090565b9261457a612d3d61384860c085019687515f5260205260405f2090565b6148375761012082019261459e614595855163ffffffff1690565b63ffffffff1690565b8042109081156147fe575b506147ed576101408301926145c2845163ffffffff1690565b9163ffffffff92836145f6817f00000000000000000000000000000000000000000000000000000000000000001642613bb6565b9116116147dc5761016082015163ffffffff169280841680614798575b50508051936001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000168095148061478f575b15614729576080830151340361471957843b1561044e575f600495825196878092630d0e30db60e41b825234905af191821561377c577f32ed1a409ef04c7b0227189c3a103dc5ac10e775a15b785dcc510201f7c25ad39561399093614706575b505b519260608101519460808201519060a08301519a51986146e66146db6101008601519c5163ffffffff1690565b915163ffffffff1690565b9084519c60208601519461018060e088015197015197519a8b9a8b6144d1565b806139a2614713926105d6565b5f6146ac565b51636452a35d60e01b8152600490fd5b919293503461477e577f32ed1a409ef04c7b0227189c3a103dc5ac10e775a15b785dcc510201f7c25ad39392918161477961476a61233d6139909551613da4565b6080860151903090339061498a565b6146ae565b8151636452a35d60e01b8152600490fd5b5034151561464b565b6301e1338010156147c7575b5060e0820151156147b6575f80614613565b835163495d907f60e01b8152600490fd5b926147d59193421690613138565b915f6147a4565b835163582e388960e01b8152600490fd5b815163f722177f60e01b8152600490fd5b6148099150426137a4565b63ffffffff7f000000000000000000000000000000000000000000000000000000000000000016105f6145a9565b51632a58c4f360e01b8152600490fd5b60ff5f5460081c161561044e57565b60ff5f5460081c161561044e576001606555565b6001600160a01b031680156148b257610869816001600160a01b03198254161790557fa9e8c42c9e7fca7f62755189a16b2f5314d43d8fb24e91ba54e6d65f9314e8495f80a2565b60405163ba97b39d60e01b8152600490fd5b6001600160a01b0316801561490c5761086a816001600160a01b03198254161790557fa73e8909f8616742d7fe701153d82666f7b7cd480552e23ebb05d358c22fd04e5f80a2565b604051635b03092b60e11b8152600490fd5b60405163a9059cbb60e01b60208201526001600160a01b03909216602483015260448201929092526104ae9161496182606481015b03601f198101845283610676565b614ee6565b9081602091031261044e575161076081610492565b5f81126149855790565b5f0390565b90926104ae93604051936323b872dd60e01b60208601526001600160a01b0380921660248601521660448401526064830152606482526149618261065a565b90670de0b6b3a7640000915f82840392128383128116908484139015161761315057818102918183041490151715613150570490565b929091905f915b8451831015614a4857614a198386612f55565b519081811015614a37575f52602052600160405f205b920191614a06565b905f52602052600160405f20614a2f565b915092501490565b60405163a9059cbb60e01b60208281019182526001600160a01b039094166024830152604482019490945290925f91614a8c8160648101613b3b565b519082855af1903d5f519083614aa3575b50505090565b91925090614ab857503b15155b5f8080614a9d565b6001915014614ab0565b907f0000000000000000000000000000000000000000000000000000000000000000906001600160a01b03808316818316149081614ba5575b5015614b9a575081614b0c916152df565b61086a546001600160a01b0316610c5a5463ffffffff1673bd80b06d3dbd0801132c6689429ac09ca6d27f82803b1561044e5760405163262cc5ab60e11b81526001600160a01b039093166004840152602483019390935263ffffffff166044820152905f908290818381606481015b03925af1801561377c57614b8d5750565b806139a26104ae926105d6565b90506104ae91614f76565b90507f000000000000000000000000000000000000000000000000000000000000000016155f614afb565b60a01c614bd957565b6040516379ec0ed760e11b8152600490fd5b6001600160a01b0390811690813b15614c2b57906104ae92917f00000000000000000000000000000000000000000000000000000000000000001661491e565b7f000000000000000000000000000000000000000000000000000000000000000016803b1561044e575f8091602460405180948193632e1a7d4d60e01b83528860048401525af1801561377c57614c9d575b5081471061044e575f80809381935af1614c95612f8d565b501561044e57565b614ca6906105d6565b5f614c7d565b614cb581614dc5565b6001600160a01b0381167fbc7cd75a20ee27fd9adebab32041f755214dbc6bffa90cc0225b39da2e5c2d3b5f80a2815115801590614d6d575b614cf6575050565b5f80613a81937f206661696c65640000000000000000000000000000000000000000000000000060408051614d2a816105ea565b602781527f416464726573733a206c6f772d6c6576656c2064656c65676174652063616c6c60208201520152602081519101845af4614d67612f8d565b91615686565b505f614cee565b614d7d81614dc5565b6001600160a01b0381167fbc7cd75a20ee27fd9adebab32041f755214dbc6bffa90cc0225b39da2e5c2d3b5f80a2815115801590614dbd57614cf6575050565b506001614cee565b803b1561044e576001600160a01b037f360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc91166001600160a01b0319825416179055565b614e128383615635565b6005819592951015612f5057159384614ed0575b508315614e4a575b50505015614e3857565b60405163938a182160e01b8152600490fd5b5f929350908291604051614e8281613b3b6020820194630b135d3f60e11b998a87526024840152604060448401526064830190611352565b51915afa90614e8f612f8d565b82614ec2575b82614ea5575b50505f8080614e2e565b614eba91925060208082518301019101613ba7565b145f80614e9b565b915060208251101591614e95565b6001600160a01b0383811691161493505f614e26565b905f806001600160a01b03614f3d9416927f5361666545524332303a206c6f772d6c6576656c2063616c6c206661696c65646020604051614f2681610598565b818152015260208151910182855af1614d67612f8d565b8051908115918215614f53575b50501561044e57565b819250906020918101031261044e5760200151614f6f81610bfa565b5f80614f4a565b906001600160a01b0390818116907f0000000000000000000000000000000000000000000000000000000000000000831682036150895750803b1561044e57604051632e1a7d4d60e01b815260048101849052905f908290602490829084905af1801561377c57615076575b50610c5a5491614ffb61086a546001600160a01b031690565b73420000000000000000000000000000000000001090813b1561044e57604051631474f2a960e31b81526001600160a01b03602087901c90951685166004820152931660248401526044830182905263ffffffff909316606483015260a060848301525f60a483018190529192839182908160c48101614b7c565b806139a2615083926105d6565b5f614fe2565b91807f0000000000000000000000000000000000000000000000000000000000000000161515806152b4575b156150d9575050506104ae906150d461086a546001600160a01b031690565b615449565b806151066150f9856001600160a01b03165f52610c5c60205260405f2090565b546001600160a01b031690565b16615290577342000000000000000000000000000000000000105b169061514561233d6150f9856001600160a01b03165f52610c5d60205260405f2090565b1561520a5783826151559261539c565b6151746150f9836001600160a01b03165f52610c5d60205260405f2090565b9061518861086a546001600160a01b031690565b91615199610c5a5463ffffffff1690565b823b1561044e5760405163540abf7360e01b81526001600160a01b0395861660048201529185166024830152929093166044840152606483019390935263ffffffff16608482015260c060a48201525f60c482018190529091829060e490829084905af1801561377c57614b8d5750565b509161521f61086a546001600160a01b031690565b92615230610c5a5463ffffffff1690565b93813b1561044e57604051631474f2a960e31b81526001600160a01b03948516600482015293166024840152604483019190915263ffffffff909216606482015260a060848201525f60a482018190529091829081838160c48101614b7c565b6152af6150f9846001600160a01b03165f52610c5c60205260405f2090565b615121565b50807f00000000000000000000000000000000000000000000000000000000000000001682146150b5565b604051636eb1769f60e11b815230600482015273bd80b06d3dbd0801132c6689429ac09ca6d27f82602482015290916020826044816001600160a01b0387165afa91821561377c575f9261537b575b5081018091116131505760405163095ea7b360e01b602082015273bd80b06d3dbd0801132c6689429ac09ca6d27f82602482015260448101919091526104ae916149618260648101614953565b61539591925060203d60201161118b5761117c8183610676565b905f61532e565b604051636eb1769f60e11b81523060048201526001600160a01b03831660248201529192602083806044810103816001600160a01b0386165afa92831561377c575f93615428575b5082018092116131505760405163095ea7b360e01b60208201526001600160a01b03909316602484015260448301919091526104ae91906149618260648101614953565b61544291935060203d60201161118b5761117c8183610676565b915f6153e4565b6001600160a01b03809116917f000000000000000000000000000000000000000000000000000000000000000090827f0000000000000000000000000000000000000000000000000000000000000000166154a582828561539c565b604090604051916332dd704760e21b83526020936004958585600481875afa94851561377c57869189915f97615616575b501697604051958680926352b7631960e11b8252816155088d600483019190916001600160a01b036020820193169052565b0392165afa93841561377c575f946155f7575b5092947f000000000000000000000000000000000000000000000000000000000000000093805b61555157505050505050505050565b6155a290878111156155f15787905b84516337e9a82760e11b815284810183815263ffffffff89166020820152604081018d90526001600160a01b038c166060820152909389918591829160800190565b03815f8a5af192831561377c576155be936155c4575b506137a4565b80615542565b6155e390893d8b116155ea575b6155db8183610676565b810190615666565b505f6155b8565b503d6155d1565b80615560565b61560f919450853d871161118b5761117c8183610676565b925f61551b565b61562e919750833d8511613775576137678183610676565b955f6154d6565b9060418151145f1461565d5761132d91602082015190606060408401519301515f1a906156af565b50505f90600290565b9081602091031261044e575167ffffffffffffffff8116810361044e5790565b90156156a057815115615697575090565b3b1561044e5790565b50805190811561044e57602001fd5b7f7fffffffffffffffffffffffffffffff5d576e7357a4501ddfe92f46681b20a0841161571f576020935f9360ff60809460405194855216868401526040830152606082015282805260015afa1561377c575f516001600160a01b0381161561571757905f90565b505f90600190565b505050505f9060039056fea264697066735822122081de8cafbdfc055aa138e7706e83912b790d1c719a65b618b872483c2da3859c64736f6c63430008170033"
+ "numDeployments": 6,
+ "solcInputHash": "f6db5bcc09d996b0e542155af45c1220",
+ "metadata": "{\"compiler\":{\"version\":\"0.8.23+commit.f704f362\"},\"language\":\"Solidity\",\"output\":{\"abi\":[{\"inputs\":[{\"internalType\":\"address\",\"name\":\"_wrappedNativeTokenAddress\",\"type\":\"address\"},{\"internalType\":\"uint32\",\"name\":\"_depositQuoteTimeBuffer\",\"type\":\"uint32\"},{\"internalType\":\"uint32\",\"name\":\"_fillDeadlineBuffer\",\"type\":\"uint32\"},{\"internalType\":\"contract IERC20\",\"name\":\"_l2Usdc\",\"type\":\"address\"},{\"internalType\":\"contract ITokenMessenger\",\"name\":\"_cctpTokenMessenger\",\"type\":\"address\"}],\"stateMutability\":\"nonpayable\",\"type\":\"constructor\"},{\"inputs\":[],\"name\":\"ClaimedMerkleLeaf\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"DepositsArePaused\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"DisabledRoute\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"ExpiredFillDeadline\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"FillsArePaused\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"InsufficientSpokePoolBalanceToExecuteLeaf\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"InvalidBytes32\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"InvalidChainId\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"InvalidCrossDomainAdmin\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"InvalidDepositorSignature\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"InvalidExclusiveRelayer\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"InvalidFillDeadline\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"InvalidMerkleLeaf\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"InvalidMerkleProof\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"InvalidPayoutAdjustmentPct\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"InvalidQuoteTimestamp\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"InvalidRelayerFeePct\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"InvalidSlowFillRequest\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"InvalidWithdrawalRecipient\",\"type\":\"error\"},{\"inputs\":[{\"internalType\":\"bytes\",\"name\":\"data\",\"type\":\"bytes\"}],\"name\":\"LowLevelCallFailed\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"MaxTransferSizeExceeded\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"MsgValueDoesNotMatchInputAmount\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"NoRelayerRefundToClaim\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"NoSlowFillsInExclusivityWindow\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"NotCrossChainCall\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"NotCrossDomainAdmin\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"NotEOA\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"NotExclusiveRelayer\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"RelayFilled\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"WrongERC7683OrderId\",\"type\":\"error\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address\",\"name\":\"previousAdmin\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"newAdmin\",\"type\":\"address\"}],\"name\":\"AdminChanged\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"beacon\",\"type\":\"address\"}],\"name\":\"BeaconUpgraded\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"bytes32\",\"name\":\"l2TokenAddress\",\"type\":\"bytes32\"},{\"indexed\":true,\"internalType\":\"bytes32\",\"name\":\"refundAddress\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"amount\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"address\",\"name\":\"caller\",\"type\":\"address\"}],\"name\":\"ClaimedRelayerRefund\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"uint256\",\"name\":\"rootBundleId\",\"type\":\"uint256\"}],\"name\":\"EmergencyDeletedRootBundle\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"originToken\",\"type\":\"address\"},{\"indexed\":true,\"internalType\":\"uint256\",\"name\":\"destinationChainId\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"bool\",\"name\":\"enabled\",\"type\":\"bool\"}],\"name\":\"EnabledDepositRoute\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"amountToReturn\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"uint256\",\"name\":\"chainId\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"uint256[]\",\"name\":\"refundAmounts\",\"type\":\"uint256[]\"},{\"indexed\":true,\"internalType\":\"uint32\",\"name\":\"rootBundleId\",\"type\":\"uint32\"},{\"indexed\":true,\"internalType\":\"uint32\",\"name\":\"leafId\",\"type\":\"uint32\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"l2TokenAddress\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"address[]\",\"name\":\"refundAddresses\",\"type\":\"address[]\"},{\"indexed\":false,\"internalType\":\"bool\",\"name\":\"deferredRefunds\",\"type\":\"bool\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"caller\",\"type\":\"address\"}],\"name\":\"ExecutedRelayerRefundRoot\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"bytes32\",\"name\":\"inputToken\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"bytes32\",\"name\":\"outputToken\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"inputAmount\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"outputAmount\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"repaymentChainId\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"uint256\",\"name\":\"originChainId\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"uint256\",\"name\":\"depositId\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"uint32\",\"name\":\"fillDeadline\",\"type\":\"uint32\"},{\"indexed\":false,\"internalType\":\"uint32\",\"name\":\"exclusivityDeadline\",\"type\":\"uint32\"},{\"indexed\":false,\"internalType\":\"bytes32\",\"name\":\"exclusiveRelayer\",\"type\":\"bytes32\"},{\"indexed\":true,\"internalType\":\"bytes32\",\"name\":\"relayer\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"bytes32\",\"name\":\"depositor\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"bytes32\",\"name\":\"recipient\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"bytes32\",\"name\":\"messageHash\",\"type\":\"bytes32\"},{\"components\":[{\"internalType\":\"bytes32\",\"name\":\"updatedRecipient\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"updatedMessageHash\",\"type\":\"bytes32\"},{\"internalType\":\"uint256\",\"name\":\"updatedOutputAmount\",\"type\":\"uint256\"},{\"internalType\":\"enum V3SpokePoolInterface.FillType\",\"name\":\"fillType\",\"type\":\"uint8\"}],\"indexed\":false,\"internalType\":\"struct V3SpokePoolInterface.V3RelayExecutionEventInfo\",\"name\":\"relayExecutionInfo\",\"type\":\"tuple\"}],\"name\":\"FilledRelay\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address\",\"name\":\"inputToken\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"outputToken\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"inputAmount\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"outputAmount\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"repaymentChainId\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"uint256\",\"name\":\"originChainId\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"uint32\",\"name\":\"depositId\",\"type\":\"uint32\"},{\"indexed\":false,\"internalType\":\"uint32\",\"name\":\"fillDeadline\",\"type\":\"uint32\"},{\"indexed\":false,\"internalType\":\"uint32\",\"name\":\"exclusivityDeadline\",\"type\":\"uint32\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"exclusiveRelayer\",\"type\":\"address\"},{\"indexed\":true,\"internalType\":\"address\",\"name\":\"relayer\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"depositor\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"recipient\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"},{\"components\":[{\"internalType\":\"address\",\"name\":\"updatedRecipient\",\"type\":\"address\"},{\"internalType\":\"bytes\",\"name\":\"updatedMessage\",\"type\":\"bytes\"},{\"internalType\":\"uint256\",\"name\":\"updatedOutputAmount\",\"type\":\"uint256\"},{\"internalType\":\"enum V3SpokePoolInterface.FillType\",\"name\":\"fillType\",\"type\":\"uint8\"}],\"indexed\":false,\"internalType\":\"struct V3SpokePoolInterface.LegacyV3RelayExecutionEventInfo\",\"name\":\"relayExecutionInfo\",\"type\":\"tuple\"}],\"name\":\"FilledV3Relay\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"bytes32\",\"name\":\"inputToken\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"bytes32\",\"name\":\"outputToken\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"inputAmount\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"outputAmount\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"uint256\",\"name\":\"destinationChainId\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"uint256\",\"name\":\"depositId\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"uint32\",\"name\":\"quoteTimestamp\",\"type\":\"uint32\"},{\"indexed\":false,\"internalType\":\"uint32\",\"name\":\"fillDeadline\",\"type\":\"uint32\"},{\"indexed\":false,\"internalType\":\"uint32\",\"name\":\"exclusivityDeadline\",\"type\":\"uint32\"},{\"indexed\":true,\"internalType\":\"bytes32\",\"name\":\"depositor\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"bytes32\",\"name\":\"recipient\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"bytes32\",\"name\":\"exclusiveRelayer\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"}],\"name\":\"FundsDeposited\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"uint8\",\"name\":\"version\",\"type\":\"uint8\"}],\"name\":\"Initialized\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"bool\",\"name\":\"isPaused\",\"type\":\"bool\"}],\"name\":\"PausedDeposits\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"bool\",\"name\":\"isPaused\",\"type\":\"bool\"}],\"name\":\"PausedFills\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"uint32\",\"name\":\"rootBundleId\",\"type\":\"uint32\"},{\"indexed\":true,\"internalType\":\"bytes32\",\"name\":\"relayerRefundRoot\",\"type\":\"bytes32\"},{\"indexed\":true,\"internalType\":\"bytes32\",\"name\":\"slowRelayRoot\",\"type\":\"bytes32\"}],\"name\":\"RelayedRootBundle\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"bytes32\",\"name\":\"inputToken\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"bytes32\",\"name\":\"outputToken\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"inputAmount\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"outputAmount\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"uint256\",\"name\":\"originChainId\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"uint256\",\"name\":\"depositId\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"uint32\",\"name\":\"fillDeadline\",\"type\":\"uint32\"},{\"indexed\":false,\"internalType\":\"uint32\",\"name\":\"exclusivityDeadline\",\"type\":\"uint32\"},{\"indexed\":false,\"internalType\":\"bytes32\",\"name\":\"exclusiveRelayer\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"bytes32\",\"name\":\"depositor\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"bytes32\",\"name\":\"recipient\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"bytes32\",\"name\":\"messageHash\",\"type\":\"bytes32\"}],\"name\":\"RequestedSlowFill\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"updatedOutputAmount\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"uint256\",\"name\":\"depositId\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"bytes32\",\"name\":\"depositor\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"bytes32\",\"name\":\"updatedRecipient\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"bytes\",\"name\":\"updatedMessage\",\"type\":\"bytes\"},{\"indexed\":false,\"internalType\":\"bytes\",\"name\":\"depositorSignature\",\"type\":\"bytes\"}],\"name\":\"RequestedSpeedUpDeposit\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"updatedOutputAmount\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"uint32\",\"name\":\"depositId\",\"type\":\"uint32\"},{\"indexed\":true,\"internalType\":\"address\",\"name\":\"depositor\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"updatedRecipient\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"bytes\",\"name\":\"updatedMessage\",\"type\":\"bytes\"},{\"indexed\":false,\"internalType\":\"bytes\",\"name\":\"depositorSignature\",\"type\":\"bytes\"}],\"name\":\"RequestedSpeedUpV3Deposit\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address\",\"name\":\"inputToken\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"outputToken\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"inputAmount\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"outputAmount\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"uint256\",\"name\":\"originChainId\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"uint32\",\"name\":\"depositId\",\"type\":\"uint32\"},{\"indexed\":false,\"internalType\":\"uint32\",\"name\":\"fillDeadline\",\"type\":\"uint32\"},{\"indexed\":false,\"internalType\":\"uint32\",\"name\":\"exclusivityDeadline\",\"type\":\"uint32\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"exclusiveRelayer\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"depositor\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"recipient\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"}],\"name\":\"RequestedV3SlowFill\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"uint32\",\"name\":\"newL1Gas\",\"type\":\"uint32\"}],\"name\":\"SetL1Gas\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"l2Token\",\"type\":\"address\"},{\"indexed\":true,\"internalType\":\"address\",\"name\":\"tokenBridge\",\"type\":\"address\"}],\"name\":\"SetL2TokenBridge\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"l2Token\",\"type\":\"address\"},{\"indexed\":true,\"internalType\":\"address\",\"name\":\"l1Token\",\"type\":\"address\"}],\"name\":\"SetRemoteL1Token\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"newWithdrawalRecipient\",\"type\":\"address\"}],\"name\":\"SetWithdrawalRecipient\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"newAdmin\",\"type\":\"address\"}],\"name\":\"SetXDomainAdmin\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"amountToReturn\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"uint256\",\"name\":\"chainId\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"uint32\",\"name\":\"leafId\",\"type\":\"uint32\"},{\"indexed\":true,\"internalType\":\"bytes32\",\"name\":\"l2TokenAddress\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"caller\",\"type\":\"address\"}],\"name\":\"TokensBridged\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"implementation\",\"type\":\"address\"}],\"name\":\"Upgraded\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address\",\"name\":\"inputToken\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"outputToken\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"inputAmount\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"outputAmount\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"uint256\",\"name\":\"destinationChainId\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"uint32\",\"name\":\"depositId\",\"type\":\"uint32\"},{\"indexed\":false,\"internalType\":\"uint32\",\"name\":\"quoteTimestamp\",\"type\":\"uint32\"},{\"indexed\":false,\"internalType\":\"uint32\",\"name\":\"fillDeadline\",\"type\":\"uint32\"},{\"indexed\":false,\"internalType\":\"uint32\",\"name\":\"exclusivityDeadline\",\"type\":\"uint32\"},{\"indexed\":true,\"internalType\":\"address\",\"name\":\"depositor\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"recipient\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"exclusiveRelayer\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"}],\"name\":\"V3FundsDeposited\",\"type\":\"event\"},{\"inputs\":[],\"name\":\"EMPTY_RELAYER\",\"outputs\":[{\"internalType\":\"bytes32\",\"name\":\"\",\"type\":\"bytes32\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"EMPTY_REPAYMENT_CHAIN_ID\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"INFINITE_FILL_DEADLINE\",\"outputs\":[{\"internalType\":\"uint32\",\"name\":\"\",\"type\":\"uint32\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"MAX_EXCLUSIVITY_PERIOD_SECONDS\",\"outputs\":[{\"internalType\":\"uint32\",\"name\":\"\",\"type\":\"uint32\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"MAX_TRANSFER_SIZE\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"MESSENGER\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"UPDATE_BYTES32_DEPOSIT_DETAILS_HASH\",\"outputs\":[{\"internalType\":\"bytes32\",\"name\":\"\",\"type\":\"bytes32\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint32\",\"name\":\"_initialDepositId\",\"type\":\"uint32\"},{\"internalType\":\"address\",\"name\":\"_crossDomainAdmin\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"_withdrawalRecipient\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"_l2Eth\",\"type\":\"address\"}],\"name\":\"__OvmSpokePool_init\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint32\",\"name\":\"_initialDepositId\",\"type\":\"uint32\"},{\"internalType\":\"address\",\"name\":\"_crossDomainAdmin\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"_withdrawalRecipient\",\"type\":\"address\"}],\"name\":\"__SpokePool_init\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"cctpTokenMessenger\",\"outputs\":[{\"internalType\":\"contract ITokenMessenger\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"cctpV2\",\"outputs\":[{\"internalType\":\"bool\",\"name\":\"\",\"type\":\"bool\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"chainId\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"bytes32\",\"name\":\"l2TokenAddress\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"refundAddress\",\"type\":\"bytes32\"}],\"name\":\"claimRelayerRefund\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"crossDomainAdmin\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"bytes32\",\"name\":\"depositor\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"recipient\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"inputToken\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"outputToken\",\"type\":\"bytes32\"},{\"internalType\":\"uint256\",\"name\":\"inputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"outputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"destinationChainId\",\"type\":\"uint256\"},{\"internalType\":\"bytes32\",\"name\":\"exclusiveRelayer\",\"type\":\"bytes32\"},{\"internalType\":\"uint32\",\"name\":\"quoteTimestamp\",\"type\":\"uint32\"},{\"internalType\":\"uint32\",\"name\":\"fillDeadline\",\"type\":\"uint32\"},{\"internalType\":\"uint32\",\"name\":\"exclusivityParameter\",\"type\":\"uint32\"},{\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"}],\"name\":\"deposit\",\"outputs\":[],\"stateMutability\":\"payable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"recipient\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"originToken\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"amount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"destinationChainId\",\"type\":\"uint256\"},{\"internalType\":\"int64\",\"name\":\"relayerFeePct\",\"type\":\"int64\"},{\"internalType\":\"uint32\",\"name\":\"quoteTimestamp\",\"type\":\"uint32\"},{\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"},{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"name\":\"depositDeprecated_5947912356\",\"outputs\":[],\"stateMutability\":\"payable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"depositor\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"recipient\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"originToken\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"amount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"destinationChainId\",\"type\":\"uint256\"},{\"internalType\":\"int64\",\"name\":\"relayerFeePct\",\"type\":\"int64\"},{\"internalType\":\"uint32\",\"name\":\"quoteTimestamp\",\"type\":\"uint32\"},{\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"},{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"name\":\"depositFor\",\"outputs\":[],\"stateMutability\":\"payable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"bytes32\",\"name\":\"depositor\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"recipient\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"inputToken\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"outputToken\",\"type\":\"bytes32\"},{\"internalType\":\"uint256\",\"name\":\"inputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"outputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"destinationChainId\",\"type\":\"uint256\"},{\"internalType\":\"bytes32\",\"name\":\"exclusiveRelayer\",\"type\":\"bytes32\"},{\"internalType\":\"uint32\",\"name\":\"fillDeadlineOffset\",\"type\":\"uint32\"},{\"internalType\":\"uint32\",\"name\":\"exclusivityParameter\",\"type\":\"uint32\"},{\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"}],\"name\":\"depositNow\",\"outputs\":[],\"stateMutability\":\"payable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"depositQuoteTimeBuffer\",\"outputs\":[{\"internalType\":\"uint32\",\"name\":\"\",\"type\":\"uint32\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"depositor\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"recipient\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"inputToken\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"outputToken\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"inputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"outputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"destinationChainId\",\"type\":\"uint256\"},{\"internalType\":\"address\",\"name\":\"exclusiveRelayer\",\"type\":\"address\"},{\"internalType\":\"uint32\",\"name\":\"quoteTimestamp\",\"type\":\"uint32\"},{\"internalType\":\"uint32\",\"name\":\"fillDeadline\",\"type\":\"uint32\"},{\"internalType\":\"uint32\",\"name\":\"exclusivityParameter\",\"type\":\"uint32\"},{\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"}],\"name\":\"depositV3\",\"outputs\":[],\"stateMutability\":\"payable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"depositor\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"recipient\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"inputToken\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"outputToken\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"inputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"outputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"destinationChainId\",\"type\":\"uint256\"},{\"internalType\":\"address\",\"name\":\"exclusiveRelayer\",\"type\":\"address\"},{\"internalType\":\"uint32\",\"name\":\"fillDeadlineOffset\",\"type\":\"uint32\"},{\"internalType\":\"uint32\",\"name\":\"exclusivityParameter\",\"type\":\"uint32\"},{\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"}],\"name\":\"depositV3Now\",\"outputs\":[],\"stateMutability\":\"payable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint256\",\"name\":\"rootBundleId\",\"type\":\"uint256\"}],\"name\":\"emergencyDeleteRootBundle\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint32\",\"name\":\"rootBundleId\",\"type\":\"uint32\"},{\"components\":[{\"internalType\":\"uint256\",\"name\":\"amountToReturn\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"chainId\",\"type\":\"uint256\"},{\"internalType\":\"uint256[]\",\"name\":\"refundAmounts\",\"type\":\"uint256[]\"},{\"internalType\":\"uint32\",\"name\":\"leafId\",\"type\":\"uint32\"},{\"internalType\":\"address\",\"name\":\"l2TokenAddress\",\"type\":\"address\"},{\"internalType\":\"address[]\",\"name\":\"refundAddresses\",\"type\":\"address[]\"}],\"internalType\":\"struct SpokePoolInterface.RelayerRefundLeaf\",\"name\":\"relayerRefundLeaf\",\"type\":\"tuple\"},{\"internalType\":\"bytes32[]\",\"name\":\"proof\",\"type\":\"bytes32[]\"}],\"name\":\"executeRelayerRefundLeaf\",\"outputs\":[],\"stateMutability\":\"payable\",\"type\":\"function\"},{\"inputs\":[{\"components\":[{\"components\":[{\"internalType\":\"bytes32\",\"name\":\"depositor\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"recipient\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"exclusiveRelayer\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"inputToken\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"outputToken\",\"type\":\"bytes32\"},{\"internalType\":\"uint256\",\"name\":\"inputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"outputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"originChainId\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"depositId\",\"type\":\"uint256\"},{\"internalType\":\"uint32\",\"name\":\"fillDeadline\",\"type\":\"uint32\"},{\"internalType\":\"uint32\",\"name\":\"exclusivityDeadline\",\"type\":\"uint32\"},{\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"}],\"internalType\":\"struct V3SpokePoolInterface.V3RelayData\",\"name\":\"relayData\",\"type\":\"tuple\"},{\"internalType\":\"uint256\",\"name\":\"chainId\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"updatedOutputAmount\",\"type\":\"uint256\"}],\"internalType\":\"struct V3SpokePoolInterface.V3SlowFill\",\"name\":\"slowFillLeaf\",\"type\":\"tuple\"},{\"internalType\":\"uint32\",\"name\":\"rootBundleId\",\"type\":\"uint32\"},{\"internalType\":\"bytes32[]\",\"name\":\"proof\",\"type\":\"bytes32[]\"}],\"name\":\"executeSlowRelayLeaf\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"bytes32\",\"name\":\"orderId\",\"type\":\"bytes32\"},{\"internalType\":\"bytes\",\"name\":\"originData\",\"type\":\"bytes\"},{\"internalType\":\"bytes\",\"name\":\"fillerData\",\"type\":\"bytes\"}],\"name\":\"fill\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"fillDeadlineBuffer\",\"outputs\":[{\"internalType\":\"uint32\",\"name\":\"\",\"type\":\"uint32\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"components\":[{\"internalType\":\"bytes32\",\"name\":\"depositor\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"recipient\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"exclusiveRelayer\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"inputToken\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"outputToken\",\"type\":\"bytes32\"},{\"internalType\":\"uint256\",\"name\":\"inputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"outputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"originChainId\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"depositId\",\"type\":\"uint256\"},{\"internalType\":\"uint32\",\"name\":\"fillDeadline\",\"type\":\"uint32\"},{\"internalType\":\"uint32\",\"name\":\"exclusivityDeadline\",\"type\":\"uint32\"},{\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"}],\"internalType\":\"struct V3SpokePoolInterface.V3RelayData\",\"name\":\"relayData\",\"type\":\"tuple\"},{\"internalType\":\"uint256\",\"name\":\"repaymentChainId\",\"type\":\"uint256\"},{\"internalType\":\"bytes32\",\"name\":\"repaymentAddress\",\"type\":\"bytes32\"}],\"name\":\"fillRelay\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"components\":[{\"internalType\":\"bytes32\",\"name\":\"depositor\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"recipient\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"exclusiveRelayer\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"inputToken\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"outputToken\",\"type\":\"bytes32\"},{\"internalType\":\"uint256\",\"name\":\"inputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"outputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"originChainId\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"depositId\",\"type\":\"uint256\"},{\"internalType\":\"uint32\",\"name\":\"fillDeadline\",\"type\":\"uint32\"},{\"internalType\":\"uint32\",\"name\":\"exclusivityDeadline\",\"type\":\"uint32\"},{\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"}],\"internalType\":\"struct V3SpokePoolInterface.V3RelayData\",\"name\":\"relayData\",\"type\":\"tuple\"},{\"internalType\":\"uint256\",\"name\":\"repaymentChainId\",\"type\":\"uint256\"},{\"internalType\":\"bytes32\",\"name\":\"repaymentAddress\",\"type\":\"bytes32\"},{\"internalType\":\"uint256\",\"name\":\"updatedOutputAmount\",\"type\":\"uint256\"},{\"internalType\":\"bytes32\",\"name\":\"updatedRecipient\",\"type\":\"bytes32\"},{\"internalType\":\"bytes\",\"name\":\"updatedMessage\",\"type\":\"bytes\"},{\"internalType\":\"bytes\",\"name\":\"depositorSignature\",\"type\":\"bytes\"}],\"name\":\"fillRelayWithUpdatedDeposit\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"bytes32\",\"name\":\"\",\"type\":\"bytes32\"}],\"name\":\"fillStatuses\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"components\":[{\"internalType\":\"address\",\"name\":\"depositor\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"recipient\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"exclusiveRelayer\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"inputToken\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"outputToken\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"inputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"outputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"originChainId\",\"type\":\"uint256\"},{\"internalType\":\"uint32\",\"name\":\"depositId\",\"type\":\"uint32\"},{\"internalType\":\"uint32\",\"name\":\"fillDeadline\",\"type\":\"uint32\"},{\"internalType\":\"uint32\",\"name\":\"exclusivityDeadline\",\"type\":\"uint32\"},{\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"}],\"internalType\":\"struct V3SpokePoolInterface.V3RelayDataLegacy\",\"name\":\"relayData\",\"type\":\"tuple\"},{\"internalType\":\"uint256\",\"name\":\"repaymentChainId\",\"type\":\"uint256\"}],\"name\":\"fillV3Relay\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"getCurrentTime\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"l2TokenAddress\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"refundAddress\",\"type\":\"address\"}],\"name\":\"getRelayerRefund\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"msgSender\",\"type\":\"address\"},{\"internalType\":\"bytes32\",\"name\":\"depositor\",\"type\":\"bytes32\"},{\"internalType\":\"uint256\",\"name\":\"depositNonce\",\"type\":\"uint256\"}],\"name\":\"getUnsafeDepositId\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"pure\",\"type\":\"function\"},{\"inputs\":[{\"components\":[{\"internalType\":\"bytes32\",\"name\":\"depositor\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"recipient\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"exclusiveRelayer\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"inputToken\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"outputToken\",\"type\":\"bytes32\"},{\"internalType\":\"uint256\",\"name\":\"inputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"outputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"originChainId\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"depositId\",\"type\":\"uint256\"},{\"internalType\":\"uint32\",\"name\":\"fillDeadline\",\"type\":\"uint32\"},{\"internalType\":\"uint32\",\"name\":\"exclusivityDeadline\",\"type\":\"uint32\"},{\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"}],\"internalType\":\"struct V3SpokePoolInterface.V3RelayData\",\"name\":\"relayData\",\"type\":\"tuple\"}],\"name\":\"getV3RelayHash\",\"outputs\":[{\"internalType\":\"bytes32\",\"name\":\"\",\"type\":\"bytes32\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint32\",\"name\":\"_initialDepositId\",\"type\":\"uint32\"},{\"internalType\":\"address\",\"name\":\"_crossDomainAdmin\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"_withdrawalRecipient\",\"type\":\"address\"}],\"name\":\"initialize\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"l1Gas\",\"outputs\":[{\"internalType\":\"uint32\",\"name\":\"\",\"type\":\"uint32\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"l2Eth\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"bytes[]\",\"name\":\"data\",\"type\":\"bytes[]\"}],\"name\":\"multicall\",\"outputs\":[{\"internalType\":\"bytes[]\",\"name\":\"results\",\"type\":\"bytes[]\"}],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"numberOfDeposits\",\"outputs\":[{\"internalType\":\"uint32\",\"name\":\"\",\"type\":\"uint32\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"bool\",\"name\":\"pause\",\"type\":\"bool\"}],\"name\":\"pauseDeposits\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"bool\",\"name\":\"pause\",\"type\":\"bool\"}],\"name\":\"pauseFills\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"pausedDeposits\",\"outputs\":[{\"internalType\":\"bool\",\"name\":\"\",\"type\":\"bool\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"pausedFills\",\"outputs\":[{\"internalType\":\"bool\",\"name\":\"\",\"type\":\"bool\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"proxiableUUID\",\"outputs\":[{\"internalType\":\"bytes32\",\"name\":\"\",\"type\":\"bytes32\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"recipientCircleDomainId\",\"outputs\":[{\"internalType\":\"uint32\",\"name\":\"\",\"type\":\"uint32\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"bytes32\",\"name\":\"relayerRefundRoot\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"slowRelayRoot\",\"type\":\"bytes32\"}],\"name\":\"relayRootBundle\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"name\":\"relayerRefund\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"name\":\"remoteL1Tokens\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"components\":[{\"internalType\":\"bytes32\",\"name\":\"depositor\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"recipient\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"exclusiveRelayer\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"inputToken\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"outputToken\",\"type\":\"bytes32\"},{\"internalType\":\"uint256\",\"name\":\"inputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"outputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"originChainId\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"depositId\",\"type\":\"uint256\"},{\"internalType\":\"uint32\",\"name\":\"fillDeadline\",\"type\":\"uint32\"},{\"internalType\":\"uint32\",\"name\":\"exclusivityDeadline\",\"type\":\"uint32\"},{\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"}],\"internalType\":\"struct V3SpokePoolInterface.V3RelayData\",\"name\":\"relayData\",\"type\":\"tuple\"}],\"name\":\"requestSlowFill\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"name\":\"rootBundles\",\"outputs\":[{\"internalType\":\"bytes32\",\"name\":\"slowRelayRoot\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"relayerRefundRoot\",\"type\":\"bytes32\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"newCrossDomainAdmin\",\"type\":\"address\"}],\"name\":\"setCrossDomainAdmin\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint32\",\"name\":\"newl1Gas\",\"type\":\"uint32\"}],\"name\":\"setL1GasLimit\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"l2Token\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"l1Token\",\"type\":\"address\"}],\"name\":\"setRemoteL1Token\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"l2Token\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"tokenBridge\",\"type\":\"address\"}],\"name\":\"setTokenBridge\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"newWithdrawalRecipient\",\"type\":\"address\"}],\"name\":\"setWithdrawalRecipient\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"bytes32\",\"name\":\"depositor\",\"type\":\"bytes32\"},{\"internalType\":\"uint256\",\"name\":\"depositId\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"updatedOutputAmount\",\"type\":\"uint256\"},{\"internalType\":\"bytes32\",\"name\":\"updatedRecipient\",\"type\":\"bytes32\"},{\"internalType\":\"bytes\",\"name\":\"updatedMessage\",\"type\":\"bytes\"},{\"internalType\":\"bytes\",\"name\":\"depositorSignature\",\"type\":\"bytes\"}],\"name\":\"speedUpDeposit\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"depositor\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"depositId\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"updatedOutputAmount\",\"type\":\"uint256\"},{\"internalType\":\"address\",\"name\":\"updatedRecipient\",\"type\":\"address\"},{\"internalType\":\"bytes\",\"name\":\"updatedMessage\",\"type\":\"bytes\"},{\"internalType\":\"bytes\",\"name\":\"depositorSignature\",\"type\":\"bytes\"}],\"name\":\"speedUpV3Deposit\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"name\":\"tokenBridges\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"bytes[]\",\"name\":\"data\",\"type\":\"bytes[]\"}],\"name\":\"tryMulticall\",\"outputs\":[{\"components\":[{\"internalType\":\"bool\",\"name\":\"success\",\"type\":\"bool\"},{\"internalType\":\"bytes\",\"name\":\"returnData\",\"type\":\"bytes\"}],\"internalType\":\"struct MultiCallerUpgradeable.Result[]\",\"name\":\"results\",\"type\":\"tuple[]\"}],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"bytes32\",\"name\":\"depositor\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"recipient\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"inputToken\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"outputToken\",\"type\":\"bytes32\"},{\"internalType\":\"uint256\",\"name\":\"inputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"outputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"destinationChainId\",\"type\":\"uint256\"},{\"internalType\":\"bytes32\",\"name\":\"exclusiveRelayer\",\"type\":\"bytes32\"},{\"internalType\":\"uint256\",\"name\":\"depositNonce\",\"type\":\"uint256\"},{\"internalType\":\"uint32\",\"name\":\"quoteTimestamp\",\"type\":\"uint32\"},{\"internalType\":\"uint32\",\"name\":\"fillDeadline\",\"type\":\"uint32\"},{\"internalType\":\"uint32\",\"name\":\"exclusivityParameter\",\"type\":\"uint32\"},{\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"}],\"name\":\"unsafeDeposit\",\"outputs\":[],\"stateMutability\":\"payable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"newImplementation\",\"type\":\"address\"}],\"name\":\"upgradeTo\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"newImplementation\",\"type\":\"address\"},{\"internalType\":\"bytes\",\"name\":\"data\",\"type\":\"bytes\"}],\"name\":\"upgradeToAndCall\",\"outputs\":[],\"stateMutability\":\"payable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"usdcToken\",\"outputs\":[{\"internalType\":\"contract IERC20\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"withdrawalRecipient\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"wrappedNativeToken\",\"outputs\":[{\"internalType\":\"contract WETH9Interface\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"stateMutability\":\"payable\",\"type\":\"receive\"}],\"devdoc\":{\"custom:security-contact\":\"bugs@across.to\",\"events\":{\"AdminChanged(address,address)\":{\"details\":\"Emitted when the admin account has changed.\"},\"BeaconUpgraded(address)\":{\"details\":\"Emitted when the beacon is changed.\"},\"Initialized(uint8)\":{\"details\":\"Triggered when the contract has been initialized or reinitialized.\"},\"Upgraded(address)\":{\"details\":\"Emitted when the implementation is upgraded.\"}},\"kind\":\"dev\",\"methods\":{\"__OvmSpokePool_init(uint32,address,address,address)\":{\"params\":{\"_crossDomainAdmin\":\"Cross domain admin to set. Can be changed by admin.\",\"_initialDepositId\":\"Starting deposit ID. Set to 0 unless this is a re-deployment in order to mitigate relay hash collisions.\",\"_l2Eth\":\"Address of L2 ETH token. Usually should be Lib_PreeployAddresses.OVM_ETH but sometimes this can be different, like with Boba which flips the WETH and OVM_ETH addresses.\",\"_withdrawalRecipient\":\"Address which receives token withdrawals. Can be changed by admin. For Spoke Pools on L2, this will likely be the hub pool.\"}},\"__SpokePool_init(uint32,address,address)\":{\"params\":{\"_crossDomainAdmin\":\"Cross domain admin to set. Can be changed by admin.\",\"_initialDepositId\":\"Starting deposit ID. Set to 0 unless this is a re-deployment in order to mitigate relay hash collisions.\",\"_withdrawalRecipient\":\"Address which receives token withdrawals. Can be changed by admin. For Spoke Pools on L2, this will likely be the hub pool.\"}},\"chainId()\":{\"details\":\"Some L2s like ZKSync don't support the CHAIN_ID opcode so we allow the implementer to override this.\"},\"claimRelayerRefund(bytes32,bytes32)\":{\"params\":{\"l2TokenAddress\":\"Address of the L2 token to claim refunds for.\",\"refundAddress\":\"Address to send the refund to.\"}},\"constructor\":{\"custom:oz-upgrades-unsafe-allow\":\"constructor\"},\"deposit(bytes32,bytes32,bytes32,bytes32,uint256,uint256,uint256,bytes32,uint32,uint32,uint32,bytes)\":{\"details\":\"On the destination chain, the hash of the deposit data will be used to uniquely identify this deposit, so modifying any params in it will result in a different hash and a different deposit. The hash will comprise all parameters to this function along with this chain's chainId(). Relayers are only refunded for filling deposits with deposit hashes that map exactly to the one emitted by this contract.\",\"params\":{\"depositor\":\"The account credited with the deposit who can request to \\\"speed up\\\" this deposit by modifying the output amount, recipient, and message.\",\"destinationChainId\":\"The destination chain identifier. Must be enabled along with the input token as a valid deposit route from this spoke pool or this transaction will revert.\",\"exclusiveRelayer\":\"The relayer that will be exclusively allowed to fill this deposit before the exclusivity deadline timestamp. This must be a valid, non-zero address if the exclusivity deadline is greater than the current block.timestamp. If the exclusivity deadline is < currentTime, then this must be address(0), and vice versa if this is address(0).\",\"exclusivityParameter\":\"This value is used to set the exclusivity deadline timestamp in the emitted deposit event. Before this destination chain timestamp, only the exclusiveRelayer (if set to a non-zero address), can fill this deposit. There are three ways to use this parameter: 1. NO EXCLUSIVITY: If this value is set to 0, then a timestamp of 0 will be emitted, meaning that there is no exclusivity period. 2. OFFSET: If this value is less than MAX_EXCLUSIVITY_PERIOD_SECONDS, then add this value to the block.timestamp to derive the exclusive relayer deadline. Note that using the parameter in this way will expose the filler of the deposit to the risk that the block.timestamp of this event gets changed due to a chain-reorg, which would also change the exclusivity timestamp. 3. TIMESTAMP: Otherwise, set this value as the exclusivity deadline timestamp. which is the deadline for the exclusiveRelayer to fill the deposit.\",\"fillDeadline\":\"The deadline for the relayer to fill the deposit. After this destination chain timestamp, the fill will revert on the destination chain. Must be set before currentTime + fillDeadlineBuffer, where currentTime is block.timestamp on this chain or this transaction will revert.\",\"inputAmount\":\"The amount of input tokens to pull from the caller's account and lock into this contract. This amount will be sent to the relayer on their repayment chain of choice as a refund following an optimistic challenge window in the HubPool, less a system fee.\",\"inputToken\":\"The token pulled from the caller's account and locked into this contract to initiate the deposit. The equivalent of this token on the relayer's repayment chain of choice will be sent as a refund. If this is equal to the wrapped native token then the caller can optionally pass in native token as msg.value, as long as msg.value = inputTokenAmount.\",\"message\":\"The message to send to the recipient on the destination chain if the recipient is a contract. If the message is not empty, the recipient contract must implement handleV3AcrossMessage() or the fill will revert.\",\"outputAmount\":\"The amount of output tokens that the relayer will send to the recipient on the destination.\",\"outputToken\":\"The token that the relayer will send to the recipient on the destination chain. Must be an ERC20.\",\"quoteTimestamp\":\"The HubPool timestamp that is used to determine the system fee paid by the depositor. This must be set to some time between [currentTime - depositQuoteTimeBuffer, currentTime] where currentTime is block.timestamp on this chain or this transaction will revert.\",\"recipient\":\"The account receiving funds on the destination chain. Can be an EOA or a contract. If the output token is the wrapped native token for the chain, then the recipient will receive native token if an EOA or wrapped native token if a contract.\"}},\"depositDeprecated_5947912356(address,address,uint256,uint256,int64,uint32,bytes,uint256)\":{\"details\":\"DEPRECATION NOTICE: this function is deprecated and will be removed in the future. Please use deposit (under DEPOSITOR FUNCTIONS below) or depositV3 instead.Produces a FundsDeposited event with an infinite expiry, meaning that this deposit can never expire. Moreover, the event's outputToken is set to 0x0 meaning that this deposit can always be slow filled.\",\"params\":{\"amount\":\"Amount of tokens to deposit. Will be amount of tokens to receive less fees.\",\"destinationChainId\":\"Denotes network where user will receive funds from SpokePool by a relayer.\",\"message\":\"Arbitrary data that can be used to pass additional information to the recipient along with the tokens. Note: this is intended to be used to pass along instructions for how a contract should use or allocate the tokens.\",\"originToken\":\"Token to lock into this contract to initiate deposit.\",\"quoteTimestamp\":\"Timestamp used by relayers to compute this deposit's realizedLPFeePct which is paid to LP pool on HubPool.\",\"recipient\":\"Address to receive funds at on destination chain.\",\"relayerFeePct\":\"% of deposit amount taken out to incentivize a fast relayer.\"}},\"depositFor(address,address,address,uint256,uint256,int64,uint32,bytes,uint256)\":{\"details\":\"DEPRECATION NOTICE: this function is deprecated and will be removed in the future. Please use the other deposit or depositV3 instead.\",\"params\":{\"amount\":\"Amount of tokens to deposit. Will be amount of tokens to receive less fees.\",\"depositor\":\"Address who is credited for depositing funds on origin chain and can speed up the deposit.\",\"destinationChainId\":\"Denotes network where user will receive funds from SpokePool by a relayer.\",\"message\":\"Arbitrary data that can be used to pass additional information to the recipient along with the tokens. Note: this is intended to be used to pass along instructions for how a contract should use or allocate the tokens.\",\"originToken\":\"Token to lock into this contract to initiate deposit.\",\"quoteTimestamp\":\"Timestamp used by relayers to compute this deposit's realizedLPFeePct which is paid to LP pool on HubPool.\",\"recipient\":\"Address to receive funds at on destination chain.\",\"relayerFeePct\":\"% of deposit amount taken out to incentivize a fast relayer.\"}},\"depositNow(bytes32,bytes32,bytes32,bytes32,uint256,uint256,uint256,bytes32,uint32,uint32,bytes)\":{\"params\":{\"depositor\":\"The account credited with the deposit who can request to \\\"speed up\\\" this deposit by modifying the output amount, recipient, and message.\",\"destinationChainId\":\"The destination chain identifier. Must be enabled along with the input token as a valid deposit route from this spoke pool or this transaction will revert.\",\"exclusiveRelayer\":\"The relayer that will be exclusively allowed to fill this deposit before the exclusivity deadline timestamp.\",\"exclusivityParameter\":\"See identically named parameter in deposit() comments.\",\"fillDeadlineOffset\":\"Added to the current time to set the fill deadline, which is the deadline for the relayer to fill the deposit. After this destination chain timestamp, the fill will revert on the destination chain.\",\"inputAmount\":\"The amount of input tokens to pull from the caller's account and lock into this contract. This amount will be sent to the relayer on their repayment chain of choice as a refund following an optimistic challenge window in the HubPool, plus a system fee.\",\"inputToken\":\"The token pulled from the caller's account and locked into this contract to initiate the deposit. The equivalent of this token on the relayer's repayment chain of choice will be sent as a refund. If this is equal to the wrapped native token then the caller can optionally pass in native token as msg.value, as long as msg.value = inputTokenAmount.\",\"message\":\"The message to send to the recipient on the destination chain if the recipient is a contract. If the message is not empty, the recipient contract must implement handleV3AcrossMessage() or the fill will revert.\",\"outputAmount\":\"The amount of output tokens that the relayer will send to the recipient on the destination.\",\"outputToken\":\"The token that the relayer will send to the recipient on the destination chain. Must be an ERC20.\",\"recipient\":\"The account receiving funds on the destination chain. Can be an EOA or a contract. If the output token is the wrapped native token for the chain, then the recipient will receive native token if an EOA or wrapped native token if a contract.\"}},\"depositV3(address,address,address,address,uint256,uint256,uint256,address,uint32,uint32,uint32,bytes)\":{\"details\":\"This version mirrors the original `depositV3` function, but uses `address` types for `depositor`, `recipient`, `inputToken`, `outputToken`, and `exclusiveRelayer` for compatibility with contracts using the `address` type. The key functionality and logic remain identical, ensuring interoperability across both versions.\",\"params\":{\"depositor\":\"The account credited with the deposit who can request to \\\"speed up\\\" this deposit by modifying the output amount, recipient, and message.\",\"destinationChainId\":\"The destination chain identifier. Must be enabled along with the input token as a valid deposit route from this spoke pool or this transaction will revert.\",\"exclusiveRelayer\":\"The relayer exclusively allowed to fill this deposit before the exclusivity deadline.\",\"exclusivityParameter\":\"This value is used to set the exclusivity deadline timestamp in the emitted deposit event. Before this destination chain timestamp, only the exclusiveRelayer (if set to a non-zero address), can fill this deposit. There are three ways to use this parameter: 1. NO EXCLUSIVITY: If this value is set to 0, then a timestamp of 0 will be emitted, meaning that there is no exclusivity period. 2. OFFSET: If this value is less than MAX_EXCLUSIVITY_PERIOD_SECONDS, then add this value to the block.timestamp to derive the exclusive relayer deadline. Note that using the parameter in this way will expose the filler of the deposit to the risk that the block.timestamp of this event gets changed due to a chain-reorg, which would also change the exclusivity timestamp. 3. TIMESTAMP: Otherwise, set this value as the exclusivity deadline timestamp. which is the deadline for the exclusiveRelayer to fill the deposit.\",\"fillDeadline\":\"The deadline for the relayer to fill the deposit. After this destination chain timestamp, the fill will revert on the destination chain. Must be set before currentTime + fillDeadlineBuffer, where currentTime is block.timestamp on this chain.\",\"inputAmount\":\"The amount of input tokens pulled from the caller's account and locked into this contract. This amount will be sent to the relayer as a refund following an optimistic challenge window in the HubPool, less a system fee.\",\"inputToken\":\"The token pulled from the caller's account and locked into this contract to initiate the deposit. The equivalent of this token on the relayer's repayment chain of choice will be sent as a refund. If this is equal to the wrapped native token, the caller can optionally pass in native token as msg.value, provided msg.value = inputTokenAmount.\",\"message\":\"The message to send to the recipient on the destination chain if the recipient is a contract. If the message is not empty, the recipient contract must implement `handleV3AcrossMessage()` or the fill will revert.\",\"outputAmount\":\"The amount of output tokens that the relayer will send to the recipient on the destination.\",\"outputToken\":\"The token that the relayer will send to the recipient on the destination chain. Must be an ERC20.\",\"quoteTimestamp\":\"The HubPool timestamp that determines the system fee paid by the depositor. This must be set between [currentTime - depositQuoteTimeBuffer, currentTime] where currentTime is block.timestamp on this chain.\",\"recipient\":\"The account receiving funds on the destination chain. Can be an EOA or a contract. If the output token is the wrapped native token for the chain, then the recipient will receive native token if an EOA or wrapped native token if a contract.\"}},\"depositV3Now(address,address,address,address,uint256,uint256,uint256,address,uint32,uint32,bytes)\":{\"details\":\"This version is identical to the original `depositV3Now` but uses `address` types for `depositor`, `recipient`, `inputToken`, `outputToken`, and `exclusiveRelayer` to support compatibility with older systems. It maintains the same logic and purpose, ensuring interoperability with both versions.\",\"params\":{\"depositor\":\"The account credited with the deposit, who can request to \\\"speed up\\\" this deposit by modifying the output amount, recipient, and message.\",\"destinationChainId\":\"The destination chain identifier. Must be enabled with the input token as a valid deposit route from this spoke pool, or the transaction will revert.\",\"exclusiveRelayer\":\"The relayer exclusively allowed to fill the deposit before the exclusivity deadline.\",\"exclusivityParameter\":\"See identically named parameter in deposit() comments.\",\"fillDeadlineOffset\":\"Added to the current time to set the fill deadline. After this timestamp, fills on the destination chain will revert.\",\"inputAmount\":\"The amount of input tokens pulled from the caller's account and locked into this contract. This amount will be sent to the relayer as a refund following an optimistic challenge window in the HubPool, plus a system fee.\",\"inputToken\":\"The token pulled from the caller's account and locked into this contract to initiate the deposit. Equivalent tokens on the relayer's repayment chain will be sent as a refund. If this is the wrapped native token, msg.value must equal inputTokenAmount when passed.\",\"message\":\"The message to send to the recipient on the destination chain. If the recipient is a contract, it must implement `handleV3AcrossMessage()` if the message is not empty, or the fill will revert.\",\"outputAmount\":\"The amount of output tokens the relayer will send to the recipient on the destination.\",\"outputToken\":\"The token the relayer will send to the recipient on the destination chain. Must be an ERC20.\",\"recipient\":\"The account receiving funds on the destination chain. Can be an EOA or a contract. If the output token is the wrapped native token for the chain, then the recipient will receive the native token if an EOA or wrapped native token if a contract.\"}},\"emergencyDeleteRootBundle(uint256)\":{\"params\":{\"rootBundleId\":\"Index of the root bundle that needs to be deleted. Note: this is intentionally a uint256 to ensure that a small input range doesn't limit which indices this method is able to reach.\"}},\"executeRelayerRefundLeaf(uint32,(uint256,uint256,uint256[],uint32,address,address[]),bytes32[])\":{\"params\":{\"proof\":\"Inclusion proof for this leaf in relayer refund root in root bundle.\",\"relayerRefundLeaf\":\"Contains all data necessary to reconstruct leaf contained in root bundle and to refund relayer. This data structure is explained in detail in the SpokePoolInterface.\",\"rootBundleId\":\"Unique ID of root bundle containing relayer refund root that this leaf is contained in.\"}},\"executeSlowRelayLeaf(((bytes32,bytes32,bytes32,bytes32,bytes32,uint256,uint256,uint256,uint256,uint32,uint32,bytes),uint256,uint256),uint32,bytes32[])\":{\"details\":\"Executing a slow fill leaf is equivalent to filling the relayData so this function cannot be used to double fill a recipient. The relayData that is filled is included in the slowFillLeaf and is hashed like any other fill sent through a fill method.There is no relayer credited with filling this relay since funds are sent directly out of this contract.\",\"params\":{\"proof\":\"Inclusion proof for this leaf in slow relay root in root bundle.\",\"rootBundleId\":\"Unique ID of root bundle containing slow relay root that this leaf is contained in.\",\"slowFillLeaf\":\"Contains all data necessary to uniquely identify a relay for this chain. This struct is hashed and included in a merkle root that is relayed to all spoke pools. - relayData: struct containing all the data needed to identify the original deposit to be slow filled. - chainId: chain identifier where slow fill leaf should be executed. If this doesn't match this chain's chainId, then this function will revert. - updatedOutputAmount: Amount to be sent to recipient out of this contract's balance. Can be set differently from relayData.outputAmount to charge a different fee because this deposit was \\\"slow\\\" filled. Usually, this will be set higher to reimburse the recipient for waiting for the slow fill.\"}},\"fill(bytes32,bytes,bytes)\":{\"details\":\"ERC-7683 fill function.\",\"params\":{\"fillerData\":\"Data provided by the filler to inform the fill or express their preferences\",\"orderId\":\"Unique order identifier for this order\",\"originData\":\"Data emitted on the origin to parameterize the fill\"}},\"fillRelay((bytes32,bytes32,bytes32,bytes32,bytes32,uint256,uint256,uint256,uint256,uint32,uint32,bytes),uint256,bytes32)\":{\"details\":\"The fee paid to relayers and the system should be captured in the spread between output amount and input amount when adjusted to be denominated in the input token. A relayer on the destination chain will send outputAmount of outputTokens to the recipient and receive inputTokens on a repayment chain of their choice. Therefore, the fee should account for destination fee transaction costs, the relayer's opportunity cost of capital while they wait to be refunded following an optimistic challenge window in the HubPool, and a system fee charged to relayers.The hash of the relayData will be used to uniquely identify the deposit to fill, so modifying any params in it will result in a different hash and a different deposit. The hash will comprise all parameters passed to deposit() on the origin chain along with that chain's chainId(). This chain's chainId() must therefore match the destinationChainId passed into deposit. Relayers are only refunded for filling deposits with deposit hashes that map exactly to the one emitted by the origin SpokePool therefore the relayer should not modify any params in relayData.Cannot fill more than once. Partial fills are not supported.\",\"params\":{\"relayData\":\"struct containing all the data needed to identify the deposit to be filled. Should match all the same-named parameters emitted in the origin chain FundsDeposited event. - depositor: The account credited with the deposit who can request to \\\"speed up\\\" this deposit by modifying the output amount, recipient, and message. - recipient The account receiving funds on this chain. Can be an EOA or a contract. If the output token is the wrapped native token for the chain, then the recipient will receive native token if an EOA or wrapped native token if a contract. - inputToken: The token pulled from the caller's account to initiate the deposit. The equivalent of this token on the repayment chain will be sent as a refund to the caller. - outputToken The token that the caller will send to the recipient on the destination chain. Must be an ERC20. - inputAmount: This amount, less a system fee, will be sent to the caller on their repayment chain of choice as a refund following an optimistic challenge window in the HubPool. - outputAmount: The amount of output tokens that the caller will send to the recipient. - originChainId: The origin chain identifier. - exclusiveRelayer The relayer that will be exclusively allowed to fill this deposit before the exclusivity deadline timestamp. - fillDeadline The deadline for the caller to fill the deposit. After this timestamp, the fill will revert on the destination chain. - exclusivityDeadline: The deadline for the exclusive relayer to fill the deposit. After this timestamp, anyone can fill this deposit. Note that if this value was set in deposit by adding an offset to the deposit's block.timestamp, there is re-org risk for the caller of this method because the event's block.timestamp can change. Read the comments in `deposit` about the `exclusivityParameter` for more details. - message The message to send to the recipient if the recipient is a contract that implements a handleV3AcrossMessage() public function\",\"repaymentAddress\":\"Address the relayer wants to be receive their refund at.\",\"repaymentChainId\":\"Chain of SpokePool where relayer wants to be refunded after the challenge window has passed. Will receive inputAmount of the equivalent token to inputToken on the repayment chain.\"}},\"fillRelayWithUpdatedDeposit((bytes32,bytes32,bytes32,bytes32,bytes32,uint256,uint256,uint256,uint256,uint32,uint32,bytes),uint256,bytes32,uint256,bytes32,bytes,bytes)\":{\"details\":\"Subject to same exclusivity deadline rules as fillV3Relay().\",\"params\":{\"depositorSignature\":\"Signed EIP712 hashstruct containing the deposit ID. Should be signed by the depositor account.\",\"relayData\":\"struct containing all the data needed to identify the deposit to be filled. See fillV3Relay().\",\"repaymentAddress\":\"Address the relayer wants to be receive their refund at.\",\"repaymentChainId\":\"Chain of SpokePool where relayer wants to be refunded after the challenge window has passed. See fillV3Relay().\",\"updatedMessage\":\"New message to use for this deposit.\",\"updatedOutputAmount\":\"New output amount to use for this deposit.\",\"updatedRecipient\":\"New recipient to use for this deposit.\"}},\"getCurrentTime()\":{\"returns\":{\"_0\":\"uint for the current timestamp.\"}},\"getUnsafeDepositId(address,bytes32,uint256)\":{\"details\":\"msgSender and depositor are both used as inputs to allow passthrough depositors to create unique deposit hash spaces for unique depositors.\",\"params\":{\"depositNonce\":\"The nonce used as input to produce the deposit ID.\",\"depositor\":\"The depositor address used as input to produce the deposit ID.\",\"msgSender\":\"The caller of the transaction used as input to produce the deposit ID.\"},\"returns\":{\"_0\":\"The deposit ID for the unsafe deposit.\"}},\"initialize(uint32,address,address)\":{\"params\":{\"_crossDomainAdmin\":\"Cross domain admin to set. Can be changed by admin.\",\"_initialDepositId\":\"Starting deposit ID. Set to 0 unless this is a re-deployment in order to mitigate relay hash collisions.\",\"_withdrawalRecipient\":\"Address which receives token withdrawals. Can be changed by admin. For Spoke Pools on L2, this will likely be the hub pool.\"}},\"pauseDeposits(bool)\":{\"details\":\"Affects `deposit()` but not `speedUpDeposit()`, so that existing deposits can be sped up and still relayed.\",\"params\":{\"pause\":\"true if the call is meant to pause the system, false if the call is meant to unpause it.\"}},\"pauseFills(bool)\":{\"details\":\"Affects fillRelayWithUpdatedDeposit() and fillRelay().\",\"params\":{\"pause\":\"true if the call is meant to pause the system, false if the call is meant to unpause it.\"}},\"proxiableUUID()\":{\"details\":\"Implementation of the ERC1822 {proxiableUUID} function. This returns the storage slot used by the implementation. It is used to validate the implementation's compatibility when performing an upgrade. IMPORTANT: A proxy pointing at a proxiable contract should not be considered proxiable itself, because this risks bricking a proxy that upgrades to it, by delegating to itself until out of gas. Thus it is critical that this function revert if invoked through a proxy. This is guaranteed by the `notDelegated` modifier.\"},\"relayRootBundle(bytes32,bytes32)\":{\"params\":{\"relayerRefundRoot\":\"Merkle root containing relayer refund leaves that can be individually executed via executeRelayerRefundLeaf().\",\"slowRelayRoot\":\"Merkle root containing slow relay fulfillment leaves that can be individually executed via executeSlowRelayLeaf().\"}},\"requestSlowFill((bytes32,bytes32,bytes32,bytes32,bytes32,uint256,uint256,uint256,uint256,uint32,uint32,bytes))\":{\"details\":\"Slow fills are not possible unless the input and output tokens are \\\"equivalent\\\", i.e. they route to the same L1 token via PoolRebalanceRoutes.Slow fills are created by inserting slow fill objects into a merkle tree that is included in the next HubPool \\\"root bundle\\\". Once the optimistic challenge window has passed, the HubPool will relay the slow root to this chain via relayRootBundle(). Once the slow root is relayed, the slow fill can be executed by anyone who calls executeSlowRelayLeaf().Cannot request a slow fill if the fill deadline has passed.Cannot request a slow fill if the relay has already been filled or a slow fill has already been requested.\",\"params\":{\"relayData\":\"struct containing all the data needed to identify the deposit that should be slow filled. If any of the params are missing or different from the origin chain deposit, then Across will not include a slow fill for the intended deposit.\"}},\"setCrossDomainAdmin(address)\":{\"params\":{\"newCrossDomainAdmin\":\"New cross domain admin.\"}},\"setL1GasLimit(uint32)\":{\"params\":{\"newl1Gas\":\"New L1 gas limit to set.\"}},\"setTokenBridge(address,address)\":{\"details\":\"If this mapping isn't set for an L2 token, then the standard bridge will be used to bridge this token.\",\"params\":{\"tokenBridge\":\"Address of token bridge\"}},\"setWithdrawalRecipient(address)\":{\"params\":{\"newWithdrawalRecipient\":\"New withdrawal recipient address.\"}},\"speedUpDeposit(bytes32,uint256,uint256,bytes32,bytes,bytes)\":{\"details\":\"the depositor and depositId must match the params in a FundsDeposited event that the depositor wants to speed up. The relayer has the option but not the obligation to use this updated information when filling the deposit via fillRelayWithUpdatedDeposit().\",\"params\":{\"depositId\":\"Deposit ID to speed up.\",\"depositor\":\"Depositor that must sign the depositorSignature and was the original depositor.\",\"depositorSignature\":\"Signed EIP712 hashstruct containing the deposit ID. Should be signed by the depositor account. If depositor is a contract, then should implement EIP1271 to sign as a contract. See _verifyUpdateV3DepositMessage() for more details about how this signature should be constructed.\",\"updatedMessage\":\"New message to use for this deposit. Can be modified if the recipient is a contract that expects to receive a message from the relay and for some reason needs to be modified.\",\"updatedOutputAmount\":\"New output amount to use for this deposit. Should be lower than previous value otherwise relayer has no incentive to use this updated value.\",\"updatedRecipient\":\"New recipient to use for this deposit. Can be modified if the recipient is a contract that expects to receive a message from the relay and for some reason needs to be modified.\"}},\"speedUpV3Deposit(address,uint256,uint256,address,bytes,bytes)\":{\"details\":\"The `depositor` and `depositId` must match the parameters in a `FundsDeposited` event that the depositor wants to speed up. The relayer is not obligated but has the option to use this updated information when filling the deposit using `fillRelayWithUpdatedDeposit()`. This version uses `address` types for compatibility with systems relying on `address`-based implementations.\",\"params\":{\"depositId\":\"The deposit ID to speed up.\",\"depositor\":\"The depositor that must sign the `depositorSignature` and was the original depositor.\",\"depositorSignature\":\"The signed EIP712 hashstruct containing the deposit ID. Should be signed by the depositor account. If the depositor is a contract, it should implement EIP1271 to sign as a contract. See `_verifyUpdateV3DepositMessage()` for more details on how the signature should be constructed.\",\"updatedMessage\":\"The new message for this deposit. Can be modified if the recipient is a contract that expects to receive a message from the relay and needs to be updated.\",\"updatedOutputAmount\":\"The new output amount to use for this deposit. It should be lower than the previous value, otherwise the relayer has no incentive to use this updated value.\",\"updatedRecipient\":\"The new recipient for this deposit. Can be modified if the original recipient is a contract that expects to receive a message from the relay and needs to be changed.\"}},\"unsafeDeposit(bytes32,bytes32,bytes32,bytes32,uint256,uint256,uint256,bytes32,uint256,uint32,uint32,uint32,bytes)\":{\"details\":\"This is labeled \\\"unsafe\\\" because there is no guarantee that the depositId emitted in the resultant FundsDeposited event is unique which means that the corresponding fill might collide with an existing relay hash on the destination chain SpokePool, which would make this deposit unfillable. In this case, the depositor would subsequently receive a refund of `inputAmount` of `inputToken` on the origin chain after the fill deadline. Re-using a depositNonce is very dangerous when combined with `speedUpDeposit`, as a speed up signature can be re-used for any deposits with the same deposit ID.On the destination chain, the hash of the deposit data will be used to uniquely identify this deposit, so modifying any params in it will result in a different hash and a different deposit. The hash will comprise all parameters to this function along with this chain's chainId(). Relayers are only refunded for filling deposits with deposit hashes that map exactly to the one emitted by this contract.\",\"params\":{\"depositNonce\":\"The nonce that uniquely identifies this deposit. This function will combine this parameter with the msg.sender address to create a unique uint256 depositNonce and ensure that the msg.sender cannot use this function to front-run another depositor's unsafe deposit. This function guarantees that the resultant deposit nonce will not collide with a safe uint256 deposit nonce whose 24 most significant bytes are always 0.\",\"depositor\":\"See identically named parameter in depositV3() comments.\",\"destinationChainId\":\"See identically named parameter in depositV3() comments.\",\"exclusiveRelayer\":\"See identically named parameter in depositV3() comments.\",\"exclusivityParameter\":\"See identically named parameter in depositV3() comments.\",\"fillDeadline\":\"See identically named parameter in depositV3() comments.\",\"inputAmount\":\"See identically named parameter in depositV3() comments.\",\"inputToken\":\"See identically named parameter in depositV3() comments.\",\"message\":\"See identically named parameter in depositV3() comments.\",\"outputAmount\":\"See identically named parameter in depositV3() comments.\",\"outputToken\":\"See identically named parameter in depositV3() comments.\",\"quoteTimestamp\":\"See identically named parameter in depositV3() comments.\",\"recipient\":\"See identically named parameter in depositV3() comments.\"}},\"upgradeTo(address)\":{\"custom:oz-upgrades-unsafe-allow-reachable\":\"delegatecall\",\"details\":\"Upgrade the implementation of the proxy to `newImplementation`. Calls {_authorizeUpgrade}. Emits an {Upgraded} event.\"},\"upgradeToAndCall(address,bytes)\":{\"custom:oz-upgrades-unsafe-allow-reachable\":\"delegatecall\",\"details\":\"Upgrade the implementation of the proxy to `newImplementation`, and subsequently execute the function call encoded in `data`. Calls {_authorizeUpgrade}. Emits an {Upgraded} event.\"}},\"version\":1},\"userdoc\":{\"kind\":\"user\",\"methods\":{\"__OvmSpokePool_init(uint32,address,address,address)\":{\"notice\":\"Construct the OVM SpokePool.\"},\"__SpokePool_init(uint32,address,address)\":{\"notice\":\"Construct the base SpokePool.\"},\"chainId()\":{\"notice\":\"Returns chain ID for this network.\"},\"claimRelayerRefund(bytes32,bytes32)\":{\"notice\":\"Enables a relayer to claim outstanding repayments. Should virtually never be used, unless for some reason relayer repayment transfer fails for reasons such as token transfer reverts due to blacklisting. In this case, the relayer can still call this method and claim the tokens to a new address.\"},\"deposit(bytes32,bytes32,bytes32,bytes32,uint256,uint256,uint256,bytes32,uint32,uint32,uint32,bytes)\":{\"notice\":\"Previously, this function allowed the caller to specify the exclusivityDeadline, otherwise known as the as exact timestamp on the destination chain before which only the exclusiveRelayer could fill the deposit. Now, the caller is expected to pass in a number that will be interpreted either as an offset or a fixed timestamp depending on its value.Request to bridge input token cross chain to a destination chain and receive a specified amount of output tokens. The fee paid to relayers and the system should be captured in the spread between output amount and input amount when adjusted to be denominated in the input token. A relayer on the destination chain will send outputAmount of outputTokens to the recipient and receive inputTokens on a repayment chain of their choice. Therefore, the fee should account for destination fee transaction costs, the relayer's opportunity cost of capital while they wait to be refunded following an optimistic challenge window in the HubPool, and the system fee that they'll be charged.\"},\"depositDeprecated_5947912356(address,address,uint256,uint256,int64,uint32,bytes,uint256)\":{\"notice\":\"Called by user to bridge funds from origin to destination chain. Depositor will effectively lock tokens in this contract and receive a destination token on the destination chain. The origin => destination token mapping is stored on the L1 HubPool.The caller must first approve this contract to spend amount of originToken.The originToken => destinationChainId must be enabled.This method is payable because the caller is able to deposit native token if the originToken is wrappedNativeToken and this function will handle wrapping the native token to wrappedNativeToken.\"},\"depositFor(address,address,address,uint256,uint256,int64,uint32,bytes,uint256)\":{\"notice\":\"The only difference between depositFor and deposit is that the depositor address stored in the relay hash can be overridden by the caller. This means that the passed in depositor can speed up the deposit, which is useful if the deposit is taken from the end user to a middle layer contract, like an aggregator or the SpokePoolVerifier, before calling deposit on this contract.The caller must first approve this contract to spend amount of originToken.The originToken => destinationChainId must be enabled.This method is payable because the caller is able to deposit native token if the originToken is wrappedNativeToken and this function will handle wrapping the native token to wrappedNativeToken.\"},\"depositNow(bytes32,bytes32,bytes32,bytes32,uint256,uint256,uint256,bytes32,uint32,uint32,bytes)\":{\"notice\":\"Submits deposit and sets quoteTimestamp to current Time. Sets fill and exclusivity deadlines as offsets added to the current time. This function is designed to be called by users such as Multisig contracts who do not have certainty when their transaction will mine.\"},\"depositV3(address,address,address,address,uint256,uint256,uint256,address,uint32,uint32,uint32,bytes)\":{\"notice\":\"A version of `deposit` that accepts `address` types for backward compatibility. This function allows bridging of input tokens cross-chain to a destination chain, receiving a specified amount of output tokens. The relayer is refunded in input tokens on a repayment chain of their choice, minus system fees, after an optimistic challenge window. The exclusivity period is specified as an offset from the current block timestamp.\"},\"depositV3Now(address,address,address,address,uint256,uint256,uint256,address,uint32,uint32,bytes)\":{\"notice\":\"A version of `depositNow` that supports addresses as input types for backward compatibility. This function submits a deposit and sets `quoteTimestamp` to the current time. The `fill` and `exclusivity` deadlines are set as offsets added to the current time. It is designed to be called by users, including Multisig contracts, who may not have certainty when their transaction will be mined.\"},\"emergencyDeleteRootBundle(uint256)\":{\"notice\":\"This method is intended to only be used in emergencies where a bad root bundle has reached the SpokePool.\"},\"executeRelayerRefundLeaf(uint32,(uint256,uint256,uint256[],uint32,address,address[]),bytes32[])\":{\"notice\":\"Executes a relayer refund leaf stored as part of a root bundle. Will send the relayer the amount they sent to the recipient plus a relayer fee.\"},\"executeSlowRelayLeaf(((bytes32,bytes32,bytes32,bytes32,bytes32,uint256,uint256,uint256,uint256,uint32,uint32,bytes),uint256,uint256),uint32,bytes32[])\":{\"notice\":\"Executes a slow relay leaf stored as part of a root bundle relayed by the HubPool.\"},\"fill(bytes32,bytes,bytes)\":{\"notice\":\"Fills a single leg of a particular order on the destination chain\"},\"fillRelay((bytes32,bytes32,bytes32,bytes32,bytes32,uint256,uint256,uint256,uint256,uint32,uint32,bytes),uint256,bytes32)\":{\"notice\":\"Fulfill request to bridge cross chain by sending specified output tokens to the recipient.\"},\"fillRelayWithUpdatedDeposit((bytes32,bytes32,bytes32,bytes32,bytes32,uint256,uint256,uint256,uint256,uint32,uint32,bytes),uint256,bytes32,uint256,bytes32,bytes,bytes)\":{\"notice\":\"Identical to fillV3Relay except that the relayer wants to use a depositor's updated output amount, recipient, and/or message. The relayer should only use this function if they can supply a message signed by the depositor that contains the fill's matching deposit ID along with updated relay parameters. If the signature can be verified, then this function will emit a FilledV3Event that will be used by the system for refund verification purposes. In other words, this function is an alternative way to fill a a deposit than fillV3Relay.\"},\"getCurrentTime()\":{\"notice\":\"Gets the current time.\"},\"getUnsafeDepositId(address,bytes32,uint256)\":{\"notice\":\"Returns the deposit ID for an unsafe deposit. This function is used to compute the deposit ID in unsafeDeposit and is provided as a convenience.\"},\"initialize(uint32,address,address)\":{\"notice\":\"Construct the OVM SpokePool.\"},\"pauseDeposits(bool)\":{\"notice\":\"Pauses deposit-related functions. This is intended to be used if this contract is deprecated or when something goes awry.\"},\"pauseFills(bool)\":{\"notice\":\"Pauses fill-related functions. This is intended to be used if this contract is deprecated or when something goes awry.\"},\"relayRootBundle(bytes32,bytes32)\":{\"notice\":\"This method stores a new root bundle in this contract that can be executed to refund relayers, fulfill slow relays, and send funds back to the HubPool on L1. This method can only be called by the admin and is designed to be called as part of a cross-chain message from the HubPool's executeRootBundle method.\"},\"requestSlowFill((bytes32,bytes32,bytes32,bytes32,bytes32,uint256,uint256,uint256,uint256,uint32,uint32,bytes))\":{\"notice\":\"Request Across to send LP funds to this contract to fulfill a slow fill relay for a deposit in the next bundle.\"},\"setCrossDomainAdmin(address)\":{\"notice\":\"Change cross domain admin address. Callable by admin only.\"},\"setL1GasLimit(uint32)\":{\"notice\":\"Change L1 gas limit. Callable only by admin.\"},\"setTokenBridge(address,address)\":{\"notice\":\"Set bridge contract for L2 token used to withdraw back to L1.\"},\"setWithdrawalRecipient(address)\":{\"notice\":\"Change L1 withdrawal recipient address. Callable by admin only.\"},\"speedUpDeposit(bytes32,uint256,uint256,bytes32,bytes,bytes)\":{\"notice\":\"Depositor can use this function to signal to relayer to use updated output amount, recipient, and/or message. The speed up signature uniquely identifies the speed up based only on depositor, deposit ID and origin chain, so using this function in conjunction with unsafeDeposit is risky due to the chance of repeating a deposit ID.\"},\"speedUpV3Deposit(address,uint256,uint256,address,bytes,bytes)\":{\"notice\":\"A version of `speedUpDeposit` using `address` types for backward compatibility. This function allows the depositor to signal to the relayer to use updated output amount, recipient, and/or message when filling a deposit. This can be useful when the deposit needs to be modified after the original transaction has been mined.\"},\"unsafeDeposit(bytes32,bytes32,bytes32,bytes32,uint256,uint256,uint256,bytes32,uint256,uint32,uint32,uint32,bytes)\":{\"notice\":\"See deposit for details. This function is identical to deposit except that it does not use the global deposit ID counter as a deposit nonce, instead allowing the caller to pass in a deposit nonce. This function is designed to be used by anyone who wants to pre-compute their resultant relay data hash, which could be useful for filling a deposit faster and avoiding any risk of a relay hash unexpectedly changing due to another deposit front-running this one and incrementing the global deposit ID counter.\"}},\"notice\":\"World Chain Spoke pool.\",\"version\":1}},\"settings\":{\"compilationTarget\":{\"contracts/WorldChain_SpokePool.sol\":\"WorldChain_SpokePool\"},\"debug\":{\"revertStrings\":\"strip\"},\"evmVersion\":\"shanghai\",\"libraries\":{},\"metadata\":{\"bytecodeHash\":\"ipfs\"},\"optimizer\":{\"enabled\":true,\"runs\":800},\"remappings\":[],\"viaIR\":true},\"sources\":{\"@eth-optimism/contracts/libraries/constants/Lib_PredeployAddresses.sol\":{\"keccak256\":\"0x2bc28307af93e9716151a41a81694b56cbe513ef5eb335fb1d81f35e5db8edfa\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://bbdde142b16f7e0301b7b6a331b35ce609eaf5c9127f14f60c0008abb36e100f\",\"dweb:/ipfs/QmdKUiY6U2vh5egW1bYtvrNhpEmo4Jo4DEwUUmBCfW4eLy\"]},\"@openzeppelin/contracts-upgradeable/crosschain/errorsUpgradeable.sol\":{\"keccak256\":\"0xa1e9b651a2427925598b49ef35da5930abc07859cfac5b9dfb1912f063a024b3\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://c514518c36a3fb1c5f1a99d88857e93160c72ea1fd728c443406ad1acb43ae9a\",\"dweb:/ipfs/Qmc3oXjBNhdeM5cfWpsvewXZAhH34Scgna2W3MvLaiiapQ\"]},\"@openzeppelin/contracts-upgradeable/crosschain/optimism/LibOptimismUpgradeable.sol\":{\"keccak256\":\"0x4e749e196701e221283db53ccaafd372434cdaed2a0b1f5a81b23e36b826b3e8\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://c12147f335d1f8cfee08c853de86d06f63534fe8395f4f0c3c202c045f2ef4d2\",\"dweb:/ipfs/QmNnJzZGLymFtaaKn9zQAtxeNAGmXCDPFyjxzthkUTrKre\"]},\"@openzeppelin/contracts-upgradeable/interfaces/IERC1967Upgradeable.sol\":{\"keccak256\":\"0x47d6e06872b12e72c79d1b5eb55842f860b5fb1207b2317c2358d2766b950a7b\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://ac55bf6f92fc7b90c6d79d346163a0a02bd5c648c7fede08b20e5da96d4ae2a0\",\"dweb:/ipfs/QmQoSrHhka35iKDK5iyNt8cuXXS5ANXVPjLhfsJjktB8V9\"]},\"@openzeppelin/contracts-upgradeable/interfaces/draft-IERC1822Upgradeable.sol\":{\"keccak256\":\"0x77c89f893e403efc6929ba842b7ccf6534d4ffe03afe31670b4a528c0ad78c0f\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://496bd9b3df2455d571018c09f0c6badd29713fdeb907c6aa09d8d28cb603f053\",\"dweb:/ipfs/QmXdJDyYs6WMwMh21dez2BYPxhSUaUYFMDtVNcn2cgFR79\"]},\"@openzeppelin/contracts-upgradeable/proxy/ERC1967/ERC1967UpgradeUpgradeable.sol\":{\"keccak256\":\"0x7795808e3899c805254e3ae58074b20f799b466e3f43e057e47bedee5fb771f8\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://319853a2a682f3f72411507242669ef5e76e0ad3457be53102439709ee8948f0\",\"dweb:/ipfs/QmRtm4Ese9u4jfxXyuWPXLwzenwFotuQjAWV7rXtZTB1E9\"]},\"@openzeppelin/contracts-upgradeable/proxy/beacon/IBeaconUpgradeable.sol\":{\"keccak256\":\"0x24b86ac8c005b8c654fbf6ac34a5a4f61580d7273541e83e013e89d66fbf0908\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://4dbfe1a3b3b3fb64294ce41fd2ad362e7b7012208117864f42c1a67620a6d5c1\",\"dweb:/ipfs/QmVMU5tWt7zBQMmf5cpMX8UMHV86T3kFeTxBTBjFqVWfoJ\"]},\"@openzeppelin/contracts-upgradeable/proxy/utils/Initializable.sol\":{\"keccak256\":\"0x89be10e757d242e9b18d5a32c9fbe2019f6d63052bbe46397a430a1d60d7f794\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://f103ee2e4aecd37aac6ceefe670709cdd7613dee25fa2d4d9feaf7fc0aaa155e\",\"dweb:/ipfs/QmRiNZLoJk5k3HPMYGPGjZFd2ke1ZxjhJZkM45Ec9GH9hv\"]},\"@openzeppelin/contracts-upgradeable/proxy/utils/UUPSUpgradeable.sol\":{\"keccak256\":\"0xefb41f5c1a00249b7a99f0782f8c557865605426a3fb6e5fe9ae334293ae4f33\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://90def55e5782595aabc13f57780c02d3613e5226f20ce6c1709503a63fdeb58f\",\"dweb:/ipfs/Qmb5vcymmNEZUJMaHmYxnhvGJDEsGMae4YjcHwkA74jy99\"]},\"@openzeppelin/contracts-upgradeable/security/ReentrancyGuardUpgradeable.sol\":{\"keccak256\":\"0x2025ccf05f6f1f2fd4e078e552836f525a1864e3854ed555047cd732320ab29b\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://d27f4b23c2dee42394aebaf42bf238285230f472dfd3282a39c3f000ec28214f\",\"dweb:/ipfs/QmQa3DnvccwdWJeWrjgXPnFMTWbzWQWR39hVqC7eEwo2PC\"]},\"@openzeppelin/contracts-upgradeable/token/ERC20/IERC20Upgradeable.sol\":{\"keccak256\":\"0x0e1f0f5f62f67a881cd1a9597acbc0a5e4071f3c2c10449a183b922ae7272e3f\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://c25f742ff154998d19a669e2508c3597b363e123ce9144cd0fcf6521229f401f\",\"dweb:/ipfs/QmQXRuFzStEWqeEPbhQU6cAg9PaSowxJVo4PDKyRod7dco\"]},\"@openzeppelin/contracts-upgradeable/token/ERC20/extensions/IERC20PermitUpgradeable.sol\":{\"keccak256\":\"0x07e881de3b9f6d2c07909f193f24b96c7fe4ea60013260f3f25aecd8bab3c2f8\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://1fed09b97ccb0ff9ba9b6a94224f1d489026bf6b4b7279bfe64fb6e8749dee4d\",\"dweb:/ipfs/QmcRAzaSP1UnGr4vrGkfJmB2L9aiTYoXfV1Lg9gqrVRWn8\"]},\"@openzeppelin/contracts-upgradeable/token/ERC20/utils/SafeERC20Upgradeable.sol\":{\"keccak256\":\"0x23b997be73d3dd46885262704f0f8cfc7273fdadfe303d37969a9561373972b5\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://d03ebe5406134f0c4a017dee625ff615031194493bd1e88504e5c8fae55bc166\",\"dweb:/ipfs/QmUZV5bMbgk2PAkV3coouSeSainHN2jhqaQDJaA7hQRyu2\"]},\"@openzeppelin/contracts-upgradeable/utils/AddressUpgradeable.sol\":{\"keccak256\":\"0x9c80f545915582e63fe206c6ce27cbe85a86fc10b9cd2a0e8c9488fb7c2ee422\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://310136ad60820af4177a11a61d77a3686faf5fca4942b600e08fc940db38396b\",\"dweb:/ipfs/QmbCzMNSTL7Zi7M4UCSqBrkHtp4jjxUnGbkneCZKdR1qeq\"]},\"@openzeppelin/contracts-upgradeable/utils/StorageSlotUpgradeable.sol\":{\"keccak256\":\"0x07ac95acad040f1fb1f6120dd0aa5f702db69446e95f82613721879d30de0908\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://a9df9de7b5da1d1bd3d4b6c073d0174bc4211db60e794a321c8cb5d4eae34685\",\"dweb:/ipfs/QmWe49zj65jayrCe9jZpoWhYUZ1RiwSxyU2s7SBZnMztVy\"]},\"@openzeppelin/contracts-upgradeable/utils/StringsUpgradeable.sol\":{\"keccak256\":\"0xb96dc79b65b7c37937919dcdb356a969ce0aa2e8338322bf4dc027a3c9c9a7eb\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://f8613145881436fc0480fff22da4868d611e2b0c0c3da083334eb4362ce1945a\",\"dweb:/ipfs/QmPqpP3YeRbBdTJRe6Gv2eGsUaANf4J6RwTNRW36iYahfV\"]},\"@openzeppelin/contracts-upgradeable/utils/cryptography/ECDSAUpgradeable.sol\":{\"keccak256\":\"0xa014f65d84b02827055d99993ccdbfb4b56b2c9e91eb278d82a93330659d06e4\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://50a7e716a74f3d48a7f549086faa94afcd58b9f18ac8e9f74af4571f3a1d8d5c\",\"dweb:/ipfs/QmTkDNWkq5o9Cv2jS7s6JvSmsPBkeunZhPe7Z2njGL31wo\"]},\"@openzeppelin/contracts-upgradeable/utils/math/MathUpgradeable.sol\":{\"keccak256\":\"0x2bc0007987c229ae7624eb29be6a9b84f6a6a5872f76248b15208b131ea41c4e\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://2b2835c737d073ef8b82a4cc246495a9740f43e7ff2cf130906b2449ff9bfb91\",\"dweb:/ipfs/QmSCWfNoSvvTN57ic7o1RW6NqSxxGAqbBTnLKc7QHe27qB\"]},\"@openzeppelin/contracts-upgradeable/utils/math/SignedMathUpgradeable.sol\":{\"keccak256\":\"0x88f6b7bba3ee33eeb741f9a0f5bc98b6e6e352d0fe4905377bb328590f84095a\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://88ace2d60f265752f18903d839910be4e4e104340b2957678585b812447825d4\",\"dweb:/ipfs/QmXFkNxMc3AAGzhs2wUEZyErWQjsvoTGyYjuU5oZkFki5Z\"]},\"@openzeppelin/contracts-upgradeable/vendor/optimism/ICrossDomainMessengerUpgradeable.sol\":{\"keccak256\":\"0xb531a6941d55a97d0db7af85c19b6aaf7fc634e550b513daa28e874b2c9b2dfa\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://23b0ce75313d9863512271a51940f6876051a5cb6dce60dd06bc03e565631b9d\",\"dweb:/ipfs/QmZobv3VixcvPxVF6hZgWxo8ELd9nXK935aiBpyHypYSoL\"]},\"@openzeppelin/contracts/interfaces/IERC1271.sol\":{\"keccak256\":\"0x0705a4b1b86d7b0bd8432118f226ba139c44b9dcaba0a6eafba2dd7d0639c544\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://c45b821ef9e882e57c256697a152e108f0f2ad6997609af8904cae99c9bd422e\",\"dweb:/ipfs/QmRKCJW6jjzR5UYZcLpGnhEJ75UVbH6EHkEa49sWx2SKng\"]},\"@openzeppelin/contracts/token/ERC20/IERC20.sol\":{\"keccak256\":\"0x287b55befed2961a7eabd7d7b1b2839cbca8a5b80ef8dcbb25ed3d4c2002c305\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://bd39944e8fc06be6dbe2dd1d8449b5336e23c6a7ba3e8e9ae5ae0f37f35283f5\",\"dweb:/ipfs/QmPV3FGYjVwvKSgAXKUN3r9T9GwniZz83CxBpM7vyj2G53\"]},\"@openzeppelin/contracts/token/ERC20/extensions/IERC20Permit.sol\":{\"keccak256\":\"0xb264c03a3442eb37a68ad620cefd1182766b58bee6cec40343480392d6b14d69\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://28879d01fd22c07b44f006612775f8577defbe459cb01685c5e25cd518c91a71\",\"dweb:/ipfs/QmVgfkwv2Fxw6hhTcDUZhE7NkoSKjab3ipM7UaRbt6uXb5\"]},\"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\":{\"keccak256\":\"0xabefac93435967b4d36a4fabcbdbb918d1f0b7ae3c3d85bc30923b326c927ed1\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://9d213d3befca47da33f6db0310826bcdb148299805c10d77175ecfe1d06a9a68\",\"dweb:/ipfs/QmRgCn6SP1hbBkExUADFuDo8xkT4UU47yjNF5FhCeRbQmS\"]},\"@openzeppelin/contracts/utils/Address.sol\":{\"keccak256\":\"0x006dd67219697fe68d7fbfdea512e7c4cb64a43565ed86171d67e844982da6fa\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://2455248c8ddd9cc6a7af76a13973cddf222072427e7b0e2a7d1aff345145e931\",\"dweb:/ipfs/QmfYjnjRbWqYpuxurqveE6HtzsY1Xx323J428AKQgtBJZm\"]},\"@openzeppelin/contracts/utils/Strings.sol\":{\"keccak256\":\"0x3088eb2868e8d13d89d16670b5f8612c4ab9ff8956272837d8e90106c59c14a0\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://b81d9ff6559ea5c47fc573e17ece6d9ba5d6839e213e6ebc3b4c5c8fe4199d7f\",\"dweb:/ipfs/QmPCW1bFisUzJkyjroY3yipwfism9RRCigCcK1hbXtVM8n\"]},\"@openzeppelin/contracts/utils/cryptography/ECDSA.sol\":{\"keccak256\":\"0x809bc3edb4bcbef8263fa616c1b60ee0004b50a8a1bfa164d8f57fd31f520c58\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://8b93a1e39a4a19eba1600b92c96f435442db88cac91e315c8291547a2a7bcfe2\",\"dweb:/ipfs/QmTm34KVe6uZBZwq8dZDNWwPcm24qBJdxqL3rPxBJ4LrMv\"]},\"@openzeppelin/contracts/utils/cryptography/MerkleProof.sol\":{\"keccak256\":\"0xcf688741f79f4838d5301dcf72d0af9eff11bbab6ab0bb112ad144c7fb672dac\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://85d9c87a481fe99fd28a146c205da0867ef7e1b7edbe0036abc86d2e64eb1f04\",\"dweb:/ipfs/QmR7m1zWQNfZHUKTtqnjoCjCBbNFcjCxV27rxf6iMfhVtG\"]},\"@openzeppelin/contracts/utils/cryptography/SignatureChecker.sol\":{\"keccak256\":\"0x3af3ca86df39aac39a0514c84459d691434a108d2151c8ce9d69f32e315cab80\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://77d1f1cf302cd5e1dfbbb4ce3b281b28e8c52942d4319fce43df2e1b6f02a52d\",\"dweb:/ipfs/QmT6ZXStmK3Knhh9BokeVHQ9HXTBZNgL3Eb1ar1cYg1hWy\"]},\"@openzeppelin/contracts/utils/math/Math.sol\":{\"keccak256\":\"0xe4455ac1eb7fc497bb7402579e7b4d64d928b846fce7d2b6fde06d366f21c2b3\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://cc8841b3cd48ad125e2f46323c8bad3aa0e88e399ec62acb9e57efa7e7c8058c\",\"dweb:/ipfs/QmSqE4mXHA2BXW58deDbXE8MTcsL5JSKNDbm23sVQxRLPS\"]},\"@openzeppelin/contracts/utils/math/SignedMath.sol\":{\"keccak256\":\"0xf92515413956f529d95977adc9b0567d583c6203fc31ab1c23824c35187e3ddc\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://c50fcc459e49a9858b6d8ad5f911295cb7c9ab57567845a250bf0153f84a95c7\",\"dweb:/ipfs/QmcEW85JRzvDkQggxiBBLVAasXWdkhEysqypj9EaB6H2g6\"]},\"contracts/MerkleLib.sol\":{\"keccak256\":\"0xdaf19fdc82593b79a608af8f691aec89a3c0e47b210770deabbe66ece7c35bb1\",\"license\":\"BUSL-1.1\",\"urls\":[\"bzz-raw://03c37f78657beed37257187e237d74492de0199734aa03272a419f66161c0dca\",\"dweb:/ipfs/QmdcXMAoRLZejhh2xcVMWR3WfUvXcArKrCFEE82JDYiJbh\"]},\"contracts/Ovm_SpokePool.sol\":{\"keccak256\":\"0xc46d3c3c1b493137eca6fbe8cd9eae2381cb792945e7ede376cbe15ef95b5454\",\"license\":\"BUSL-1.1\",\"urls\":[\"bzz-raw://7e76ca618799ea810d1fce4449d55ec3bbfbe7482374cf4259755e0103a91c19\",\"dweb:/ipfs/QmVoiCjM4yKCLxe2TNL9i9QViYFCd4f2v9wB37ogtwb6Md\"]},\"contracts/SpokePool.sol\":{\"keccak256\":\"0xc3ef7fff0c2985702bfd44a22f6b3b8b7e6150d37dd3e1db1bc966e892d629a9\",\"license\":\"BUSL-1.1\",\"urls\":[\"bzz-raw://be57513109cc0282ca1c307188c1b03595d547d66ced6d64cdc9040f19171f2a\",\"dweb:/ipfs/QmcoNGPYJk6e24Ma5T5wPaz2nXtPxqd1WQHjfXUXVHKegX\"]},\"contracts/WorldChain_SpokePool.sol\":{\"keccak256\":\"0xb70316e7560e04c79acdb9e4550567b0d96877d6d62637effa5c3ff7443af8bd\",\"license\":\"BUSL-1.1\",\"urls\":[\"bzz-raw://010c34b5e1df625843a129b5503cb99a1db910ab96542fbbf6731ec81b86bb5e\",\"dweb:/ipfs/QmPztgbFieX6axTtLPc15NusRZcKKu3dWxh63DeyaAhTub\"]},\"contracts/erc7683/ERC7683.sol\":{\"keccak256\":\"0x726d0426b0f3a11ff59d3a5bbe433c182c0feac9ea2c8c75377fcc2693eccded\",\"license\":\"GPL-3.0-or-later\",\"urls\":[\"bzz-raw://99336cc59dd5923815a8fad6e200b7b265e8446414b099e9b17e3f15f094b774\",\"dweb:/ipfs/QmWCrqefGqEpKsvfn1oBzTTUAFBjscjHc6g1EX2ab51bGA\"]},\"contracts/erc7683/ERC7683Permit2Lib.sol\":{\"keccak256\":\"0x47bf69c597fd6735fd4bb24c42d78a2c967d9bce0c303fe0a8ddafe6d2321f94\",\"license\":\"UNLICENSED\",\"urls\":[\"bzz-raw://d37b60c5b94d9bb29c42d41dd18dacbc54649921d5cdf85d8c20bb4e43c415b9\",\"dweb:/ipfs/QmZFhiKWztX7UTG6w4wrcK5LSaMHFKH7NxVgrzkxV24bEs\"]},\"contracts/external/interfaces/CCTPInterfaces.sol\":{\"keccak256\":\"0x69059bd91cdb9bea59242c543a167e38a9f3a7788687d4194f68420a956c7608\",\"license\":\"GPL-3.0-or-later\",\"urls\":[\"bzz-raw://0d0781aeb87d7f860ab9ff49c6c6af60b0e93fb547108b98ba8c8501c3980104\",\"dweb:/ipfs/QmY9H7YiXn3a8jdQgcADboxSEsi5V4F7CPcJrWNbxGToAu\"]},\"contracts/external/interfaces/IPermit2.sol\":{\"keccak256\":\"0x68f40961ee44fbc71eff2037f2c88ba9bfbccf35b9b1eae5a527b71d19bf3a71\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://2281f309f1b0df4d1c9beeeaa2673152c73e6e20991438420a9de18c51269ea7\",\"dweb:/ipfs/QmafDC3g5yBqPvSof5FmGKv4gMR3TXT5Xj3tULDA5CKmaE\"]},\"contracts/external/interfaces/WETH9Interface.sol\":{\"keccak256\":\"0x3f7892554ec7f54681fdd3cc18a41346c246c9c1afba016c52990ef77741f718\",\"license\":\"BUSL-1.1\",\"urls\":[\"bzz-raw://76e901f8da798eb2fdef8fd0083a51088103269f08ee751598c5a6eba407785f\",\"dweb:/ipfs/QmcAHbwbwCZd78teaK4cHuAvXq71aWX1r9vTGkSRRBDJV1\"]},\"contracts/interfaces/HubPoolInterface.sol\":{\"keccak256\":\"0xd8cfdded5db9bf29099e91abd8c8992b4deba1a22d4ffaed94c43ff3d47dcf33\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://aeefb0b7816fbfe2f63968f34726155d30b0428558df9a20f839042795b24c82\",\"dweb:/ipfs/QmT5uYJenMLkiBEWtzdEZ4SnsysAhQ9uyHdx3pKNU1gyVy\"]},\"contracts/interfaces/SpokePoolInterface.sol\":{\"keccak256\":\"0x67734f330d9b5eb5f7ea7f9f32d2d1cc107879154e9c9424623c6df1709b48e0\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://d80f8ef8f10046624d7ab588538f041bab0c18e475e90b287505d5feae52578f\",\"dweb:/ipfs/QmS7QbHqygik4H6BSm1Cvypx8cWB6QxoHSPZ3FAVDkgYQj\"]},\"contracts/interfaces/SpokePoolMessageHandler.sol\":{\"keccak256\":\"0xc522e2ee6d874df26cae297fc23fc6e8b5216fc8d1901299bb147a25a8c6c259\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://8942693e1cef207ae68750884e9e3c221df24dafe897af0ae6a1339e17391c29\",\"dweb:/ipfs/QmSCSQ5DNBetH8xUa73vWXR3D4CdsV6hHFmDqtT2QwLuWt\"]},\"contracts/interfaces/V3SpokePoolInterface.sol\":{\"keccak256\":\"0x15819fd7ff7b33d3fc55de30a5eb1136dfbcf953be2a962dddc550d77e1823fe\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://4f8c43279c38b718fe471171f8dd2eb9f6e8550b939ce65c7c71f0aa6233c421\",\"dweb:/ipfs/QmXFCLp8jWNKi7QRYTN9ZyNoxsTL1RZfJPLMYzUN9xQC9K\"]},\"contracts/libraries/AddressConverters.sol\":{\"keccak256\":\"0x378f28bb4a17a5c47457cb9341086b2140f7faf6c048f702d3528166f0d74453\",\"license\":\"BUSL-1.1\",\"urls\":[\"bzz-raw://0fa273e028c9555202cac439ddf458d074b66c6f74778b2b0e5e17a0e331dc38\",\"dweb:/ipfs/QmYqEaWXgiJnsH8wRAuTKF41bxkxxvY947wdKoZrjM7HVx\"]},\"contracts/libraries/CircleCCTPAdapter.sol\":{\"keccak256\":\"0x5007254d87c41857f737ddee8b06ef5838182acf6c593f8cc7ced972e03feecb\",\"license\":\"BUSL-1.1\",\"urls\":[\"bzz-raw://6559694d840b3fdbef6da3079478e0ffc168fef81a568633ecb2b9fb860caf34\",\"dweb:/ipfs/QmNnnB5pr745DFZTfDsFSq3BJi2DooaRM8f31qGwXNjLrb\"]},\"contracts/upgradeable/AddressLibUpgradeable.sol\":{\"keccak256\":\"0x655040da45a857cf609d7176c7b0647bf76d36e73e856af79d511014c7e8ef81\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://5c17767f34d57380767b49f8584d62598964fc813e6f3587d76b51ec2357bb4e\",\"dweb:/ipfs/QmSyoTa1Snn3KiJD7KjCwsPmNqpJzusXterbEXxbYCZoJK\"]},\"contracts/upgradeable/EIP712CrossChainUpgradeable.sol\":{\"keccak256\":\"0xff617722706d1c0a6d346e56e4598cc5f60adea99b4ac1d2347dcd69270a14f6\",\"license\":\"BUSL-1.1\",\"urls\":[\"bzz-raw://e2d04649c09bad766c5632da2e3a4f1deed1e013e8b713fad1f101e06f4b56a3\",\"dweb:/ipfs/QmfCewdTDr2krzvNY5rH5BprngEtBmxPXCZf6JKavxw2Sb\"]},\"contracts/upgradeable/MultiCallerUpgradeable.sol\":{\"keccak256\":\"0xc1378a7d63785d9381b8fb6e42962499ab26a243292e20981c2792511a4697f3\",\"license\":\"BUSL-1.1\",\"urls\":[\"bzz-raw://2ec8d733e528d6e79732409eb04aa5f8a8bcdf5888e677919a07d8b84afb1598\",\"dweb:/ipfs/QmQF23Gf9vHb6Ne6kaEZmQTjobWzasEWWr5YaBFkuEypz4\"]}},\"version\":1}",
+ "bytecode": "0x61018060409080825234620002b85760a081620056ac8038038091620000268285620002bc565b833981010312620002b85780516001600160a01b038082169391849003620002b85760209162000058838501620002e0565b9162000066828601620002e0565b6060860151958287168703620002b857608001519382851697888603620002b8573060805260a05260c05260e0525f5460ff8160081c16620002b85760ff808216036200027f575b506101209485526101409283525f610100908152825163011a412160e61b8682019081526004825291976001600160401b039282860191908483118484101762000261575f938493885251915afa943d1562000275573d918211620002615783519162000125601f8201601f1916830184620002bc565b82523d5f8284013e5b8562000255575b8562000220575b50505061016092835251926153b99485620002f38639608051858181610f85015281816114a101526115cd015260a051858181610860015281816136d80152818161383701528181613e58015281816140ea015281816143b90152818161482401528181614bcd0152614bf4015260c0518581816117d50152818161368c0152614572015260e05185818161044e015261436201525184818161197e0152818161510e01526151b901525183818161080301528181614b700152614fef015251828181611e7e015281816149420152615012015251818181611a7c01526150ae0152f35b90919294508082519201519181811062000244575b5050161515915f80806200013c565b5f19910360031b1b165f8062000235565b81518114955062000135565b634e487b7160e01b5f52604160045260245ffd5b606091506200012e565b60ff90811916175f557f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb384740249884835160ff8152a15f620000ae565b5f80fd5b601f909101601f19168101906001600160401b038211908210176200026157604052565b519063ffffffff82168203620002b85756fe6080604052600436101561001a575b3615610018575f80fd5b005b5f3560e01c8063079bd2c71461041f5780630c5d5f731461041a5780630eaac9f0146104155780631186ec331461041057806311eac8551461040b57806315348e44146103a257806317fcb39b146104065780631b3d5559146104015780631fab657c146103fc57806329cb924d146103f75780632e378115146103f25780632e63e59a146103ed5780633659cfe6146103e8578063431023b8146103e3578063437b9116146103de578063490e49ef146103d9578063493a4f84146103d45780634f1ef286146103cf5780635285e058146103ca57806352d1902d146103c5578063541f4f14146103c0578063577f51f8146103bb57806357f6dcb8146103b65780636068d6cb146103b1578063647c576c146103ac578063670fa8ac146103a75780636bbbcd2e146103a25780636e4009831461039d578063738b62e514610398578063766e070314610393578063775c0d031461038e5780637aef642c146103895780637b939232146103845780637ef413e11461037f57806382e2c43f1461037a5780638a7860ce146103755780638b15788e14610370578063927ede2d1461036b5780639748cf7c1461036657806397943aa914610361578063979f2bc21461035c57806399cc2968146103575780639a8a059214610352578063a1244c671461034d578063a18a096e14610348578063ac9650d814610343578063ad5425c61461033e578063adb5a6a6146102f3578063b27a430014610339578063b370b7f514610334578063babb6aac1461032f578063bf10268d1461032a578063c35c83fc14610325578063ceb4c98714610320578063d7e1583a1461031b578063dda5211314610316578063ddd224f114610311578063de7eba781461030c578063deff4b2414610307578063e322921114610302578063ea86bd46146102fd578063ee2a53f8146102f8578063f79f29ed146102f3578063fbbba9ac146102ee5763fc8a584f0361000e57612af3565b612a6f565b61242e565b612a31565b61292e565b612905565b612810565b6127e0565b6127b7565b612791565b61275b565b612661565b612636565b6125b2565b6124db565b6124b4565b612475565b6122cd565b61222d565b6120c6565b61209f565b612085565b611ff0565b611f22565b611ea2565b611e5f565b611e31565b611db3565b611d3b565b611c20565b611be9565b611b41565b611aa1565b611a65565b611a41565b6119ac565b611962565b610827565b611928565b611851565b6117f9565b6117b9565b6116e0565b61161d565b6115b3565b61158c565b61145e565b6113d7565b6113b9565b6112ec565b61108f565b610f5d565b610d63565b610c03565b610bda565b610ad8565b6109cf565b610841565b6107e4565b610743565b6104f6565b610490565b610432565b5f91031261042e57565b5f80fd5b3461042e575f36600319011261042e57602060405163ffffffff7f0000000000000000000000000000000000000000000000000000000000000000168152f35b6001600160a01b0381160361042e57565b359061048e82610472565b565b3461042e57602036600319011261042e5760206004356104af81610472565b6001600160a01b038091165f52610c5d825260405f205416604051908152f35b63ffffffff81160361042e57565b610144359061048e826104cf565b359061048e826104cf565b3461042e57602036600319011261042e5763ffffffff600435610518816104cf565b610520613501565b6105286135c3565b16610c5a8163ffffffff198254161790557fe486a5c4bd7b36eabbfe274c99b39130277417be8d2209b4dae04c4fba64ee3a5f80a26001606555005b634e487b7160e01b5f52604160045260245ffd5b6040810190811067ffffffffffffffff82111761059457604052565b610564565b6101a0810190811067ffffffffffffffff82111761059457604052565b67ffffffffffffffff811161059457604052565b6060810190811067ffffffffffffffff82111761059457604052565b6080810190811067ffffffffffffffff82111761059457604052565b6020810190811067ffffffffffffffff82111761059457604052565b60e0810190811067ffffffffffffffff82111761059457604052565b60a0810190811067ffffffffffffffff82111761059457604052565b90601f8019910116810190811067ffffffffffffffff82111761059457604052565b6040519060c0820182811067ffffffffffffffff82111761059457604052565b60405190610180820182811067ffffffffffffffff82111761059457604052565b6040519061048e82610599565b6040519061048e826105e6565b67ffffffffffffffff811161059457601f01601f191660200190565b9291926106fb826106d3565b916107096040519384610656565b82948184528183011161042e578281602093845f960137010152565b9080601f8301121561042e57816020610740933591016106ef565b90565b61010036600319011261042e5760043561075c81610472565b60243561076881610472565b6084358060070b810361042e5760a43590610782826104cf565b60c43567ffffffffffffffff811161042e576107a2903690600401610725565b926107ab6135c3565b60ff61086b5460e81c166107d2576107cb9460643591604435913361363e565b6001606555005b604051630b4cba3160e31b8152600490fd5b3461042e575f36600319011261042e5760206040516001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000168152f35b3461042e575f36600319011261042e5760206040515f8152f35b3461042e575f36600319011261042e5760206040516001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000168152f35b67ffffffffffffffff81116105945760051b60200190565b9080601f8301121561042e5760209082356108b681610884565b936108c46040519586610656565b81855260208086019260051b82010192831161042e57602001905b8282106108ed575050505090565b813581529083019083016108df565b9080601f8301121561042e57602090823561091681610884565b936109246040519586610656565b81855260208086019260051b82010192831161042e57602001905b82821061094d575050505090565b838091833561095b81610472565b81520191019061093f565b929161097182610884565b9161097f6040519384610656565b829481845260208094019160051b810192831161042e57905b8282106109a55750505050565b81358152908301908301610998565b9080601f8301121561042e5781602061074093359101610966565b60031960603682011261042e576004356109e8816104cf565b60243567ffffffffffffffff9283821161042e5760c090823603011261042e57610a10610678565b908060040135825260248101356020830152604481013584811161042e57610a3e906004369184010161089c565b6040830152610a4f606482016104eb565b6060830152610a6060848201610483565b608083015260a48101359084821161042e576004610a8192369201016108fc565b60a082015260443592831161042e57610aa16100189336906004016109b4565b91612b23565b9181601f8401121561042e5782359167ffffffffffffffff831161042e576020808501948460051b01011161042e57565b3461042e5760031960603682011261042e5760043567ffffffffffffffff80821161042e5760608236039384011261042e5760243590610b17826104cf565b60443590811161042e57610b2f903690600401610aa7565b919093610b3a6135c3565b600484013590610182190181121561042e57610bd094610bcb93610b67610bc4936004369189010161267f565b95610b7d610b786080890151613b84565b61382d565b610b8687613434565b9060446020890151916101608a015193610b9e610678565b9a8b5260208b015201356040890152606088015260808701525f60a08701523691610966565b9083613b9a565b613ceb565b6100186001606555565b3461042e575f36600319011261042e576020604051428152f35b908161018091031261042e5790565b3461042e57604036600319011261042e5760043567ffffffffffffffff811161042e57610c34903690600401610bf4565b610c3d81612d1b565b6001600160a01b031690610c5360208201612d1b565b6001600160a01b031691610c6960408301612d1b565b6001600160a01b0316610c7e60608401612d1b565b6001600160a01b031692610c9460808201612d1b565b6001600160a01b031690610100610cac818301612d25565b9061012090610cbc848301612d25565b9261014094858101610ccd90612d25565b966101609a8b8301610cdf9084612d2f565b9a909b610cea610698565b9e8f91825260208201526040015260608d015260808c015260a081013560a08c015260c081013560c08c015260e0013560e08b015263ffffffff1690890152870190610d3b919063ffffffff169052565b63ffffffff909116908501523690610d52926106ef565b908201523360243561001892613465565b3461042e57602036600319011261042e576004803567ffffffffffffffff811161042e57610d949036908301610bf4565b610d9c6135c3565b60ff61086b5460e01c16610f4d5763ffffffff80421692610140830193610dd581610dc687612d25565b63ffffffff9182169116101590565b610f3d57610120840192610de884612d25565b1610610f2e57610e00610dfb368561267f565b613434565b90610e14825f5261087260205260405f2090565b54610f205750610e637f3cee3e290f36226751cd0b3321b213890fe9c768e922f267fa6111836ce05c3292610e5e610e58610e69945f5261087260205260405f2090565b60019055565b612d25565b93612d25565b610e89610e84610e7d610160860186612d2f565b36916106ef565b6141c0565b90610f136040519283926101008701359760e08801359760208101359281359260408301359260c08101359060a081013590606060808201359101358b9693909a999895919261012098959361014089019c895260208901526040880152606087015263ffffffff80921660808701521660a085015260c084015260e08301526101008201520152565b0390a36100186001606555565b604051624be79160e21b8152fd5b60405163d642b7d960e01b8152fd5b50604051630277ae7b60e21b8152fd5b50604051633d90fc5560e11b8152fd5b3461042e57602036600319011261042e57600435610f7a81610472565b6001600160a01b03807f00000000000000000000000000000000000000000000000000000000000000001680301461042e577f360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc90828254160361042e57610fdf613501565b60405191610fec83610602565b5f83527f4910fdfa16fed3260ed0e7147f7cc6da11a60208b5b9406d12a635614ffd91435460ff16156110255750505061001890614d8c565b6020600491604051928380926352d1902d60e01b825288165afa5f918161105e575b50611050575f80fd5b0361042e5761001891614c73565b61108191925060203d602011611088575b6110798183610656565b810190613987565b905f611047565b503d61106f565b3461042e57608036600319011261042e576004356110ac816104cf565b602435906110b982610472565b6044356110c581610472565b606435916110d283610472565b60ff5f5460081c161561042e5761111990610c5a624c4b4063ffffffff1982541617905561086b9063ffffffff60c01b1963ffffffff60c01b83549260c01b169116179055565b6040519061112682610578565b6009825260208201916820a1a927a9a996ab1960b91b8352640312e302e360dc1b602060405161115581610578565b60058152015260ff5f5460081c161561042e57610018946111ba936111b59251902061047f557f06c015bd22b4c69690933c1058878ebdfef31f9aaae40bbe86d8a09fe1b2972c610480556111a8614599565b6111b06145a8565b6145bc565b614616565b610c5a9077ffffffffffffffffffffffffffffffffffffffff000000001977ffffffffffffffffffffffffffffffffffffffff0000000083549260201b169116179055565b602060031982011261042e576004359067ffffffffffffffff821161042e5761122a91600401610aa7565b9091565b5f5b83811061123f5750505f910152565b8181015183820152602001611230565b906020916112688151809281855285808601910161122e565b601f01601f1916010190565b6020808201908083528351809252604092604081018260408560051b8401019601945f925b8584106112aa575050505050505090565b9091929394959685806112db600193603f1986820301885286838d518051151584520151918185820152019061124f565b990194019401929594939190611299565b3461042e576112fa366111ff565b61130381610884565b9160406113136040519485610656565b828452601f1961132284610884565b015f5b8181106113965750505f5b83811061134957604051806113458782611274565b0390f35b8061139061135960019388612d85565b515f80611367858a8a612d99565b90611376895180938193612db0565b0390305af490611384612dbd565b60208201529015159052565b01611330565b60209083516113a481610578565b5f815282606081830152828901015201611325565b3461042e575f36600319011261042e5760206040516301e133808152f35b3461042e57604036600319011261042e576024356004356113f6613501565b6113fe6135c3565b61086c8054680100000000000000008110156105945763ffffffff916001820190558361142a826129f2565b5084600182015555167fc86ba04c55bc5eb2f2876b91c438849a296dbec7b08751c3074d92e04f0a77af5f80a46001606555005b604036600319011261042e5760043561147681610472565b60243567ffffffffffffffff811161042e57611496903690600401610725565b6001600160a01b03807f0000000000000000000000000000000000000000000000000000000000000000169081301461042e577f360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc91818354160361042e576114fc613501565b7f4910fdfa16fed3260ed0e7147f7cc6da11a60208b5b9406d12a635614ffd91435460ff16156115325750505061001890614d8c565b6020600491604051928380926352d1902d60e01b825288165afa5f918161156b575b5061155d575f80fd5b0361042e5761001891614d3b565b61158591925060203d602011611088576110798183610656565b905f611554565b3461042e575f36600319011261042e5760206001600160a01b036108695416604051908152f35b3461042e575f36600319011261042e576001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016300361042e5760206040517f360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc8152f35b61012036600319011261042e5760043561163681610472565b6024359061164382610472565b6044359161165083610472565b60a4358060070b810361042e5760c4359161166a836104cf565b60e43567ffffffffffffffff811161042e5761168a903690600401610725565b936116936135c3565b60ff61086b5460e81c166107d2576107cb95608435926064359261363e565b9181601f8401121561042e5782359167ffffffffffffffff831161042e576020838186019501011161042e57565b3461042e5760c036600319011261042e576004356116fd81610472565b6024356044359160643561171081610472565b67ffffffffffffffff9160843583811161042e576117329036906004016116b2565b60a49491943591821161042e577f45e04bc8f121ba11466985789ca2822a91109f31bb8ac85504a37b7eaf873c26946117726117b49336906004016116b2565b9290916001600160a01b038097166117a68a8c836117913688886106ef565b9161179d368b8b6106ef565b9346908d6141d5565b604051978897169a87612e0c565b0390a3005b3461042e575f36600319011261042e57602060405163ffffffff7f0000000000000000000000000000000000000000000000000000000000000000168152f35b3461042e575f36600319011261042e57602060ff61086b5460e81c166040519015158152f35b606090600319011261042e57600435611837816104cf565b9060243561184481610472565b9060443561074081610472565b3461042e5761185f3661181f565b5f54600881901c60ff161593929084908161191a575b81156118fa575b501561042e576118a09284611897600160ff195f5416175f55565b6118e357612e3f565b6118a657005b6118b461ff00195f54165f55565b604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb384740249890602090a1005b6118f561010061ff00195f5416175f55565b612e3f565b303b1591508161190c575b505f61187c565b6001915060ff16145f611905565b600160ff8216109150611875565b3461042e575f36600319011261042e5760206040517f8d1994e2bbbd77564cdca06dd819e7ee2a5efa06c80dcb59a4a7b6e39edc538f8152f35b3461042e575f36600319011261042e57602060405163ffffffff7f0000000000000000000000000000000000000000000000000000000000000000168152f35b8015150361042e57565b3461042e57602036600319011261042e577fe88463c2f254e2b070013a2dc7ee1e099f9bc00534cbdf03af551dc26ae4921960206004356119ec816119a2565b6119f4613501565b6119fc6135c3565b151561086b80547fffff00ffffffffffffffffffffffffffffffffffffffffffffffffffffffffff60ff60e81b8460e81b169116179055604051908152a16001606555005b3461042e575f36600319011261042e57602063ffffffff610c5a5416604051908152f35b3461042e575f36600319011261042e5760206040517f000000000000000000000000000000000000000000000000000000000000000015158152f35b61016036600319011261042e57600435611aba81610472565b60243590611ac782610472565b604435611ad381610472565b60643590611ae082610472565b60e435611aec81610472565b6101043590611afa826104cf565b6101243592611b08846104cf565b610144359667ffffffffffffffff881161042e57611b2d6100189836906004016116b2565b97909660c4359360a4359360843593612f85565b61018036600319011261042e57600435611b5a81610472565b60243590611b6782610472565b604435611b7381610472565b60643590611b8082610472565b60e435611b8c81610472565b61010435611b99816104cf565b6101243591611ba7836104cf565b611baf6104dd565b93610164359767ffffffffffffffff891161042e57611bd56100189936906004016116b2565b98909760c4359360a4359360843593612fa7565b3461042e57606036600319011261042e576020611c18600435611c0b81610472565b60443590602435906130c2565b604051908152f35b3461042e57606036600319011261042e5767ffffffffffffffff60243581811161042e57611c529036906004016116b2565b9160443590811161042e57611c6b9036906004016116b2565b9060405193602085019480611c824684888a6130fe565b0395611c96601f1997888101845283610656565b6004359151902003611d29575f94611cc5611ce793611cbc87611cf3958a990190612735565b9581019061311b565b519360405193849160208301966337bfd2c960e21b88523391602485016131e3565b03908101835282610656565b5190305af4611d00612dbd565b9015611d0857005b60405163b8fe37a760e01b8152908190611d259060048301613205565b0390fd5b604051630f0c8f4760e11b8152600490fd5b3461042e57602036600319011261042e57600435611d57613501565b611d5f6135c3565b611d68816129f2565b611da0576001815f80935501557f7c1af0646963afc3343245b103731965735a893347bfa0d58a5dc77a77ae691c5f80a26001606555005b634e487b7160e01b5f525f60045260245ffd5b6101a036600319011261042e5761012435611dcd816104cf565b61014435611dda816104cf565b6101643591611de8836104cf565b610184359267ffffffffffffffff841161042e57611e0d6100189436906004016116b2565b9390926101043560e43560c43560a435608435606435604435602435600435613216565b3461042e575f36600319011261042e5760206040517342000000000000000000000000000000000000078152f35b3461042e575f36600319011261042e5760206040516001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000168152f35b3461042e5760e036600319011261042e5767ffffffffffffffff60043581811161042e57611ed4903690600401610bf4565b60a43582811161042e57611eec9036906004016116b2565b60c49291923593841161042e57611f0a6100189436906004016116b2565b9390926084359060643590604435906024359061328e565b3461042e57611f303661181f565b909160ff5f5460081c161561042e57611f669061086b9063ffffffff60c01b1963ffffffff60c01b83549260c01b169116179055565b604051611f7281610578565b6009815260208101926820a1a927a9a996ab1960b91b8452640312e302e360dc1b6020604051611fa181610578565b60058152015260ff5f5460081c161561042e57610018936111b59251902061047f557f06c015bd22b4c69690933c1058878ebdfef31f9aaae40bbe86d8a09fe1b2972c610480556111a8614599565b3461042e57602036600319011261042e577f2d5b62420992e5a4afce0e77742636ca2608ef58289fd2e1baa5161ef6e7e41e6020600435612030816119a2565b612038613501565b6120406135c3565b151561086b80547fffffff00ffffffffffffffffffffffffffffffffffffffffffffffffffffffff60ff60e01b8460e01b169116179055604051908152a16001606555005b3461042e575f36600319011261042e576020604051468152f35b3461042e575f36600319011261042e57602063ffffffff61086b5460c01c16604051908152f35b3461042e57604036600319011261042e576004356024356120e682614b97565b6001600160a01b0382165f5261087360205261211560405f20336001600160a01b03165f5260205260405f2090565b549182156121b8575f61215c3361214661212e85613b84565b6001600160a01b03165f5261087360205260405f2090565b906001600160a01b03165f5260205260405f2090565b556121888361217961216d84613b84565b6001600160a01b031690565b61218285613b84565b90614670565b60405192835233927f6c172ea51018fb2eb2118f3f8a507c4df71eb519b8c0052834dc3c920182fef490602090a4005b6040516336542bf760e21b8152600490fd5b6020808201906020835283518092526040830192602060408460051b8301019501935f915b8483106121ff5750505050505090565b909192939495848061221d600193603f198682030187528a5161124f565b98019301930191949392906121ef565b3461042e5761223b366111ff565b9061224582613377565b915f5b81811061225d576040518061134586826121ca565b5f8061226a838587612d99565b9061227a60405180938193612db0565b0390305af4612287612dbd565b90156122ad579060019161229b8287612d85565b526122a68186612d85565b5001612248565b604481511061042e5780600461042e9201516024809183010191016133c0565b6101808060031936011261042e57610104356122e8816104cf565b61012435916122f6836104cf565b6101443592612304846104cf565b6101643567ffffffffffffffff811161042e576123259036906004016116b2565b61232d6135c3565b61086b549260ff8460e81c166107d257610bd0966123f2610e7d926123e463ffffffff6124009860c01c16996123886123658c61341f565b61086b9063ffffffff60c01b1963ffffffff60c01b83549260c01b169116179055565b6123906106b9565b9a6004358c5260243560208d015260443560408d015260643560608d015260843560808d015260a43560a08d015260c43560c08d015260e43560e08d01526101008c01526101208b019063ffffffff169052565b63ffffffff16610140890152565b63ffffffff16610160870152565b90820152614307565b604090600319011261042e5760043561242181610472565b9060243561074081610472565b3461042e57602061246c6001600160a01b0361244936612409565b91165f52610873835260405f20906001600160a01b03165f5260205260405f2090565b54604051908152f35b3461042e57602036600319011261042e57602060043561249481610472565b6001600160a01b038091165f52610c5c825260405f205416604051908152f35b3461042e575f36600319011261042e5760206001600160a01b0361086a5416604051908152f35b3461042e5760c036600319011261042e5760043560243567ffffffffffffffff60643560443560843583811161042e576125199036906004016116b2565b60a49491943591821161042e577f45e04bc8f121ba11466985789ca2822a91109f31bb8ac85504a37b7eaf873c26946125596125a89336906004016116b2565b9290916125646135c3565b61256d8a614b97565b61259c898b898961257f3688886106ef565b9261258b368b8b6106ef565b946001600160a01b034692166141d5565b60405196879687612e0c565b0390a36001606555005b3461042e576125c036612409565b906125c9613501565b6125d16135c3565b6001600160a01b0380911691825f52610c5d6020526126098160405f20906001600160a01b03166001600160a01b0319825416179055565b16907fcb84c2022106a6f2b6f805d446f32fbfd2a528474364fa755f37dac1c0c1b6c85f80a36001606555005b3461042e57602036600319011261042e576004355f52610872602052602060405f2054604051908152f35b3461042e575f36600319011261042e57602060405163ffffffff8152f35b91906101808382031261042e57612694610698565b92803584526020810135602085015260408101356040850152606081013560608501526080810135608085015260a081013560a085015260c081013560c085015260e081013560e085015261010080820135908501526101206126f88183016104eb565b9085015261014061270a8183016104eb565b90850152610160918282013567ffffffffffffffff811161042e5761272f9201610725565b90830152565b9060208282031261042e57813567ffffffffffffffff811161042e57610740920161267f565b3461042e57602036600319011261042e5760043567ffffffffffffffff811161042e57611c18610dfb602092369060040161267f565b3461042e575f36600319011261042e57602060ff61086b5460e01c166040519015158152f35b3461042e575f36600319011261042e5760206040516ec097ce7bc90715b34b9f10000000008152f35b3461042e57602036600319011261042e576107cb60043561280081610472565b612808613501565b6111b06135c3565b3461042e57606036600319011261042e5760043567ffffffffffffffff811161042e5761284190369060040161267f565b6128496135c3565b60ff61086b5460e01c166128f35761014081015163ffffffff42811691161015806128d4575b6128c25780612880610bd092613434565b60c08201516020830151906101608401519261289a610678565b948552602085015260408401526060830152608082015260243560a082015260443590613f5f565b604051630c3a9b9d60e41b8152600490fd5b506128e26040820151613b84565b6001600160a01b031633141561286f565b604051633d90fc5560e11b8152600490fd5b3461042e575f36600319011261042e576020610c5a546001600160a01b0360405191831c168152f35b6101608060031936011261042e5761010435612949816104cf565b61012435612956816104cf565b6101443567ffffffffffffffff811161042e576129779036906004016116b2565b63ffffffff9461298a8642169586612f68565b936129936135c3565b61086b549160ff8360e81c166107d2576129c66129d3966123e4610bd09a610e7d9660c01c16996123886123658c61341f565b86019063ffffffff169052565b610180820152614307565b634e487b7160e01b5f52603260045260245ffd5b61086c908154811015612a2c576003915f52027f71cd7344f4eb2efc8e30291f6dbdb44d618ca368ea5425d217c1d604bf26b84d01905f90565b6129de565b3461042e57602036600319011261042e5760043561086c5481101561042e57612a5b6040916129f2565b506001815491015482519182526020820152f35b3461042e57612a7d36612409565b90612a86613501565b612a8e6135c3565b6001600160a01b0380911691825f52610c5c602052612ac68160405f20906001600160a01b03166001600160a01b0319825416179055565b16907ff3dc137d2246f9b8abd0bb821e185ba01122c9b3ea3745ffca6208037674d6705f80a36001606555005b3461042e57602036600319011261042e576107cb600435612b1381610472565b612b1b613501565b6111b56135c3565b91612b2c6135c3565b6080820191612b45610b7884516001600160a01b031690565b602081019182514603612c4c57612b6d612b7191836001612b65896129f2565b5001546138a0565b1590565b612c3a578060607ff4ad92585b1bc117fbdd644990adf0827bc4c95baeae8a23322af807b6d0020e920193612bb3612bad865163ffffffff1690565b87613932565b612c2d845194835193612c12612c04612bf360408401998a51612bda8d5163ffffffff1690565b89516001600160a01b03169160a088019b8c51946139a3565b925193519851995163ffffffff1690565b94516001600160a01b031690565b945163ffffffff9586604051978897169b1699339487612ccd565b0390a461048e6001606555565b60405163582f497d60e11b8152600490fd5b604051633d23e4d160e11b8152600490fd5b9081518082526020808093019301915f5b828110612c7d575050505090565b835185529381019392810192600101612c6f565b9081518082526020808093019301915f5b828110612cb0575050505090565b83516001600160a01b031685529381019392810192600101612ca2565b9496959193612cef60a095612d0d93885260c0602089015260c0880190612c5e565b906001600160a01b0380951660408801528682036060880152612c91565b951515608085015216910152565b3561074081610472565b35610740816104cf565b903590601e198136030182121561042e570180359067ffffffffffffffff821161042e5760200191813603831361042e57565b634e487b7160e01b5f52602160045260245ffd5b60031115612d8057565b612d62565b8051821015612a2c5760209160051b010190565b90821015612a2c5761122a9160051b810190612d2f565b908092918237015f815290565b3d15612de7573d90612dce826106d3565b91612ddc6040519384610656565b82523d5f602084013e565b606090565b908060209392818452848401375f828201840152601f01601f1916010190565b94929093612e3192610740979587526020870152608060408701526080860191612dec565b926060818503910152612dec565b91909160ff5f5460081c161561042e57612e8990610c5a624c4b4063ffffffff1982541617905561086b9063ffffffff60c01b1963ffffffff60c01b83549260c01b169116179055565b604051612e9581610578565b6009815260208101926820a1a927a9a996ab1960b91b8452640312e302e360dc1b6020604051612ec481610578565b60058152015260ff5f5460081c161561042e57612f13936111b59251902061047f557f06c015bd22b4c69690933c1058878ebdfef31f9aaae40bbe86d8a09fe1b2972c610480556111a8614599565b61048e610c5a77deaddeaddeaddeaddeaddeaddeaddeaddead00000000000077ffffffffffffffffffffffffffffffffffffffff0000000019825416179055565b634e487b7160e01b5f52601160045260245ffd5b91909163ffffffff80809416911601918211612f8057565b612f54565b969492909161048e9b9a9998969492612fa563ffffffff42169889612f68565b985b9593919b999897969492909b612fbb6135c3565b61086b549660ff8860e81c166107d2578760c01c63ffffffff16612fde9061341f565b6130059061086b9063ffffffff60c01b1963ffffffff60c01b83549260c01b169116179055565b61300d6106b9565b9d6001600160a01b038f921682526001600160a01b031690602001526001600160a01b031660408d01526001600160a01b031660608c015260808b015260a08a015260c08901526001600160a01b031660e088015260c01c63ffffffff16610100870152610120860190613086919063ffffffff169052565b63ffffffff1661014085015263ffffffff1661016084015236906130a9926106ef565b6101808201526130b890614307565b61048e6001606555565b916040519160208301936bffffffffffffffffffffffff199060601b16845260348301526054820152605481526130f8816105e6565b51902090565b93929160209161311691604087526040870191612dec565b930152565b9081602091031261042e57604051906020820182811067ffffffffffffffff8211176105945760405235815290565b6107409161018090825181526020830151602082015260408301516040820152606083015160608201526080830151608082015260a083015160a082015260c083015160c082015260e083015160e082015261010080840151908201526131bf610120808501519083019063ffffffff169052565b6101408381015163ffffffff1690820152816101608094015193820152019061124f565b6131fb6040929594939560608352606083019061314a565b9460208201520152565b90602061074092818152019061124f565b9c9a999897969594939291909661322b6135c3565b60ff61086b5460e81c166107d257613244908e336130c2565b96604051809e61325382610599565b81526020015260408d015260608c015260808b015260a08a015260c089015260e088015261010087015263ffffffff16610120860152613086565b97929095939196949761329f6135c3565b60ff61086b5460e01c166128f3576132ba6101408201612d25565b63ffffffff8042169116101580613358575b6128c257613341613353966133396130b89b6132eb610dfb368761267f565b9a6132f4610678565b9b6132ff368861267f565b8d5260208d01528660408d01528760608d015261331d368b846106ef565b60808d015260a08c01526133318535613b84565b9836916106ef565b9536916106ef565b9461010060e0830135920135906141d5565b613f5f565b506133666040820135613b84565b6001600160a01b03163314156132cc565b9061338182610884565b61338e6040519182610656565b828152809261339f601f1991610884565b01905f5b8281106133af57505050565b8060606020809385010152016133a3565b60208183031261042e5780519067ffffffffffffffff821161042e570181601f8201121561042e5780516133f3816106d3565b926134016040519485610656565b8184526020828401011161042e57610740916020808501910161122e565b63ffffffff809116908114612f805760010190565b6040516130f881613451602082019460408652606083019061314a565b46604083015203601f198101835282610656565b9190916134706135c3565b60ff61086b5460e01c166128f35761014081015163ffffffff42811691161015806134e2575b6128c2576130b8926134a782613434565b60c0830151602084015190610160850151926134c1610678565b958652602086015260408501526060840152608083015260a0820152613f5f565b506134f06040820151613b84565b6001600160a01b0316331415613496565b7342000000000000000000000000000000000000078033036135b157602060049160405192838092636e296e4560e01b82525afa9081156135ac575f9161357d575b506001600160a01b0361356261216d610869546001600160a01b031690565b91160361356b57565b6040516336a816d960e01b8152600490fd5b61359f915060203d6020116135a5575b6135978183610656565b8101906146b8565b5f613543565b503d61358d565b6135e1565b60405163253a6fc960e11b8152600490fd5b60026065541461042e576002606555565b91908203918211612f8057565b6040513d5f823e3d90fd5b926107409695929491946101409585525f60208601526040850152606084015263ffffffff809116608084015260a08301525f60c083015260e08201525f61010082015281610120820152019061124f565b9193949690959660070b906706f05b59d3b2000061365b836146cd565b101561381b576ec097ce7bc90715b34b9f100000000084116138095763ffffffff93613689858a16426135d4565b857f000000000000000000000000000000000000000000000000000000000000000016106137f75761086b5460c01c63ffffffff16986136cb6123658b61341f565b6001600160a01b039586807f000000000000000000000000000000000000000000000000000000000000000016981692888414806137ee575b156137b2578034036137a057883b1561042e575f6004996040519a8b8092630d0e30db60e41b825234905af19889156135ac5761376f613782978a927f32ed1a409ef04c7b0227189c3a103dc5ac10e775a15b785dcc510201f7c25ad39c613787575b505b8361471b565b92604051998a99169d169b1693876135ec565b0390a4565b8061379461379a926105b6565b80610424565b5f613767565b604051636452a35d60e01b8152600490fd5b7f32ed1a409ef04c7b0227189c3a103dc5ac10e775a15b785dcc510201f7c25ad398508761376f613782976137e98430338a6146dc565b613769565b50341515613704565b60405163f722177f60e01b8152600490fd5b60405163622db5a960e11b8152600490fd5b60405163284f109760e21b8152600490fd5b6001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000811691168114613864575b50565b4761386c5750565b4790803b1561042e575f90600460405180948193630d0e30db60e41b83525af180156135ac57156138615761048e906105b6565b61074092916040516139298161391b602082019460208652805160408401526020810151606084015260a06138e5604083015160c06080870152610100860190612c5e565b606083015163ffffffff168583015260808301516001600160a01b031660c0860152910151838203603f190160e0850152612c91565b03601f198101835282610656565b51902091614751565b61393d6002916129f2565b500162ffffff8260081c16805f5281602052600160ff60405f205494161b8080941614613975575f5260205260405f20908154179055565b60405163954476d960e01b8152600490fd5b9081602091031261042e575190565b91908201809211612f8057565b91959495939092935f9681519081815103613b725781613a22575b505050826139cd575b50505050565b6001600160a01b0381613a017ffa7fa7cf6d7dde5f9be65a67e6a1a747e7aa864dcd2d793353c722d80fbbb3579386614814565b6040805195865233602087015291169463ffffffff1693a45f8080806139c7565b604080516370a0823160e01b81523060048083019190915291906020816024816001600160a01b038b165afa9081156135ac575f91613b53575b505f805b868110613a715750505050506139be565b613a7b8189612d85565b51613a89575b600101613a60565b90613a9f90613a98838a612d85565b5190613996565b90828211613b4357613ad9612b6d613ac7613aba848a612d85565b516001600160a01b031690565b613ad1848c612d85565b51908c6147a2565b15613a81579c5087613b39613b318f613b1c613aba613b15613afb848f612d85565b51966001600160a01b03165f5261087360205260405f2090565b928b612d85565b6001600160a01b03165f5260205260405f2090565b918254613996565b905560019c613a81565b50505051632ddaa83160e11b8152fd5b613b6c915060203d602011611088576110798183610656565b5f613a5c565b6040516319a5316760e31b8152600490fd5b6001600160a01b0390613b9681614b97565b1690565b91612b6d90613c1392845160408096015191865191613bb8836105ca565b8252613929613bd360208401924684528985019586526129f2565b5054938851928391613bf86020840196602088525160608d86015260a085019061314a565b9151606084015251608083015203601f198101835282610656565b613c1a5750565b5163582f497d60e11b8152600490fd5b613c3382612d76565b52565b9a989693919c9b9997959492909c6101e08c019d8c5260208c015260408b015260608a0152608089015263ffffffff80921660a08901521660c087015260e08601526101008501526101208401526101408301528051610160830152602081015161018083015260408101516101a08301526060015190613cb682612d76565b6101c00152565b9061074094936080936001600160a01b0380931684526020840152166040820152816060820152019061124f565b905f82516101208101613d02815163ffffffff1690565b63ffffffff42911610613f4d576020850151906002613d2a835f5261087260205260405f2090565b5414613f3b57613d4486925f5261087260205260405f2090565b6002905560608301519060808401519160a08501519260c0860151918560a0810151938860e0810151956101008201519751613d839063ffffffff1690565b61014083015163ffffffff166040840151918451936020860151956101600151613dac906141c0565b966060890151986080019e8f51613dc2906141c0565b906040015190613dd06106c6565b9a8b5260208b015260408a0152600260608a01526040519d8e9b613df49b8d613c36565b037f44b559f101f8fbcc8a0ea43fa91a05a729a5ea6e14a7c75aa750374690137208905f94a46080820151613e2890613b84565b9060408601519560600151613e3c90613b84565b9260800151613e4a90613b84565b6001600160a01b03919082167f0000000000000000000000000000000000000000000000000000000000000000831603613f265784613f13575b613e9087838616614bb2565b51928351151580613f09575b613eaa575b50505050509050565b1690813b15613f055783613ed8959660405196879586948593633a5be8cb60e01b8552339160048601613cbd565b03925af180156135ac57613ef2575b808080808594613ea1565b80613794613eff926105b6565b5f613ee7565b8380fd5b50803b1515613e9c565b613f218730338587166146dc565b613e84565b5f9450613f368785858516614670565b613e90565b604051630479306360e51b8152600490fd5b60405163d642b7d960e01b8152600490fd5b8051916101208301613f75815163ffffffff1690565b63ffffffff42911610613f4d5760208301516001613f9c825f5261087260205260405f2090565b54036141b9576001905b6002613fbb825f5261087260205260405f2090565b5414613f3b57613fd7613fdd915f5261087260205260405f2090565b60029055565b7f44b559f101f8fbcc8a0ea43fa91a05a729a5ea6e14a7c75aa75037469013720860608601516080870151906140aa8760a08a0151958a60c08101519760a08401519860e08301519961403a6101008501519c5163ffffffff1690565b61014085015163ffffffff169160408601519386519561409e61406661016060208b01519a01516141c0565b9960608c01519b604061407c60808301516141c0565b91015190602061408a6106c6565b9e8f528e015260408d015260608c01613c2a565b6040519c8d9c8d613c36565b0390a46140ba6080830151613b84565b9160408201519160806140dc816140d46060850151613b84565b940151613b84565b6001600160a01b03929083167f00000000000000000000000000000000000000000000000000000000000000008416036141a65761411e853033868a166146dc565b61412a85848616614bb2565b015191825115158061419c575b614143575b5050505050565b16803b1561042e57614171935f809460405196879586948593633a5be8cb60e01b8552339160048601613cbd565b03925af180156135ac57614189575b8080808061413c565b80613794614196926105b6565b5f614180565b50803b1515614137565b6141b4858533868a166146dc565b61412a565b5f90613fa6565b805190816141ce5750505f90565b6020012090565b939260429361048e979660208151910120906040519260208401947f8d1994e2bbbd77564cdca06dd819e7ee2a5efa06c80dcb59a4a7b6e39edc538f86526040850152856060850152608084015260a083015260c082015260c0815261423a8161061e565b5190209061047f549061048054906040519160208301937fc2f8787176b8ac6bf7215b4adcc1e069bf4ab82d9ab1df05a57a91d425935b6e8552604084015260608301526080820152608081526142908161063a565b519020906040519161190160f01b8352600283015260228201522090614dcf565b96926107409a9996949198959261014099895260208901526040880152606087015263ffffffff928380921660808801521660a08601521660c084015260e083015261010082015281610120820152019061124f565b6143118151614b97565b6101208101614330614327825163ffffffff1690565b63ffffffff1690565b804210908115614560575b506137f757610140820191614354835163ffffffff1690565b9063ffffffff9182614388817f00000000000000000000000000000000000000000000000000000000000000001642613996565b91161161454e5761016081015163ffffffff169180831680614509575b505060408101908151916001600160a01b037f00000000000000000000000000000000000000000000000000000000000000001680931480614500575b156144b357608082015134036137a057823b1561042e575f60049360405194858092630d0e30db60e41b825234905af19283156135ac577f32ed1a409ef04c7b0227189c3a103dc5ac10e775a15b785dcc510201f7c25ad3936144a0575b505b5161378260608301519260808101519060a081015160c08201519761447f6144746101008501519b5163ffffffff1690565b9b5163ffffffff1690565b83519b60208501519361018060e0870151960151966040519a8b9a8b6142b1565b806137946144ad926105b6565b5f614440565b9150346137a057816144fb6144ec61216d7f32ed1a409ef04c7b0227189c3a103dc5ac10e775a15b785dcc510201f7c25ad39551613b84565b608084015190309033906146dc565b614442565b503415156143e2565b6301e133801015614539575b5060e081015115614527575f806143a5565b60405163495d907f60e01b8152600490fd5b916145479192421690612f68565b905f614515565b60405163582e388960e01b8152600490fd5b61456b9150426135d4565b63ffffffff7f000000000000000000000000000000000000000000000000000000000000000016105f61433b565b60ff5f5460081c161561042e57565b60ff5f5460081c161561042e576001606555565b6001600160a01b0316801561460457610869816001600160a01b03198254161790557fa9e8c42c9e7fca7f62755189a16b2f5314d43d8fb24e91ba54e6d65f9314e8495f80a2565b60405163ba97b39d60e01b8152600490fd5b6001600160a01b0316801561465e5761086a816001600160a01b03198254161790557fa73e8909f8616742d7fe701153d82666f7b7cd480552e23ebb05d358c22fd04e5f80a2565b604051635b03092b60e11b8152600490fd5b60405163a9059cbb60e01b60208201526001600160a01b039092166024830152604482019290925261048e916146b382606481015b03601f198101845283610656565b614ead565b9081602091031261042e575161074081610472565b5f81126146d75790565b5f0390565b909261048e93604051936323b872dd60e01b60208601526001600160a01b0380921660248601521660448401526064830152606482526146b38261063a565b90670de0b6b3a7640000915f828403921283831281169084841390151617612f8057818102918183041490151715612f80570490565b929091905f915b845183101561479a5761476b8386612d85565b519081811015614789575f52602052600160405f205b920191614758565b905f52602052600160405f20614781565b915092501490565b60405163a9059cbb60e01b60208281019182526001600160a01b039094166024830152604482019490945290925f916147de816064810161391b565b519082855af1903d5f5190836147f5575b50505090565b9192509061480a57503b15155b5f80806147ef565b6001915014614802565b906001600160a01b0390818116907f00000000000000000000000000000000000000000000000000000000000000008316820361493e5750803b1561042e57604051632e1a7d4d60e01b815260048101849052905f908290602490829084905af180156135ac5761492b575b50610c5a549161489961086a546001600160a01b031690565b73420000000000000000000000000000000000001090813b1561042e57604051631474f2a960e31b8152602086901c949094166001600160a01b0390811660048601521660248401526044830182905263ffffffff909316606483015260a060848301525f60a483018190529192839160c4918391905af180156135ac5761491e5750565b8061379461048e926105b6565b80613794614938926105b6565b5f614880565b91807f000000000000000000000000000000000000000000000000000000000000000016151580614b6c575b1561498e5750505061048e9061498961086a546001600160a01b031690565b614fe1565b806149bb6149ae856001600160a01b03165f52610c5c60205260405f2090565b546001600160a01b031690565b16614b48577342000000000000000000000000000000000000105b16906149fa61216d6149ae856001600160a01b03165f52610c5d60205260405f2090565b15614ac2578382614a0a92614f3d565b614a296149ae836001600160a01b03165f52610c5d60205260405f2090565b90614a3d61086a546001600160a01b031690565b91614a4e610c5a5463ffffffff1690565b823b1561042e5760405163540abf7360e01b81526001600160a01b0395861660048201529185166024830152929093166044840152606483019390935263ffffffff16608482015260c060a48201525f60c482018190529091829081838160e481015b03925af180156135ac5761491e5750565b5091614ad761086a546001600160a01b031690565b92614ae8610c5a5463ffffffff1690565b93813b1561042e57604051631474f2a960e31b81526001600160a01b03948516600482015293166024840152604483019190915263ffffffff909216606482015260a060848201525f60a482018190529091829081838160c48101614ab1565b614b676149ae846001600160a01b03165f52610c5c60205260405f2090565b6149d6565b50807f000000000000000000000000000000000000000000000000000000000000000016821461496a565b60a01c614ba057565b6040516379ec0ed760e11b8152600490fd5b6001600160a01b0390811690813b15614bf2579061048e92917f000000000000000000000000000000000000000000000000000000000000000016614670565b7f000000000000000000000000000000000000000000000000000000000000000016803b1561042e575f8091602460405180948193632e1a7d4d60e01b83528860048401525af180156135ac57614c64575b5081471061042e575f80809381935af1614c5c612dbd565b501561042e57565b614c6d906105b6565b5f614c44565b614c7c81614d8c565b6001600160a01b0381167fbc7cd75a20ee27fd9adebab32041f755214dbc6bffa90cc0225b39da2e5c2d3b5f80a2815115801590614d34575b614cbd575050565b5f80613861937f206661696c65640000000000000000000000000000000000000000000000000060408051614cf1816105ca565b602781527f416464726573733a206c6f772d6c6576656c2064656c65676174652063616c6c60208201520152602081519101845af4614d2e612dbd565b916152df565b505f614cb5565b614d4481614d8c565b6001600160a01b0381167fbc7cd75a20ee27fd9adebab32041f755214dbc6bffa90cc0225b39da2e5c2d3b5f80a2815115801590614d8457614cbd575050565b506001614cb5565b803b1561042e576001600160a01b037f360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc91166001600160a01b0319825416179055565b614dd983836152ae565b6005819592951015612d8057159384614e97575b508315614e11575b50505015614dff57565b60405163938a182160e01b8152600490fd5b5f929350908291604051614e498161391b6020820194630b135d3f60e11b998a8752602484015260406044840152606483019061124f565b51915afa90614e56612dbd565b82614e89575b82614e6c575b50505f8080614df5565b614e8191925060208082518301019101613987565b145f80614e62565b915060208251101591614e5c565b6001600160a01b0383811691161493505f614ded565b905f806001600160a01b03614f049416927f5361666545524332303a206c6f772d6c6576656c2063616c6c206661696c65646020604051614eed81610578565b818152015260208151910182855af1614d2e612dbd565b8051908115918215614f1a575b50501561042e57565b819250906020918101031261042e5760200151614f36816119a2565b5f80614f11565b6044919260206001600160a01b0360405194858092636eb1769f60e11b8252306004830152808916602483015286165afa9283156135ac575f93614fc0575b508201809211612f805760405163095ea7b360e01b60208201526001600160a01b039093166024840152604483019190915261048e91906146b382606481016146a5565b614fda91935060203d602011611088576110798183610656565b915f614f7c565b906001600160a01b038092167f000000000000000000000000000000000000000000000000000000000000000090837f0000000000000000000000000000000000000000000000000000000000000000169361503e848685614f3d565b604094604051926332dd704760e21b84526020956004948781600481875afa9687156135ac5788915f9861526d575b506040516352b7631960e11b81529086166001600160a01b03811660048301529097909588916024918391165afa9586156135ac575f9661524e575b5095867f0000000000000000000000000000000000000000000000000000000000000000975b6150de57505050505050505050565b8681111561524857865b88156151a057843b1561042e578951634701287760e11b815287810182815263ffffffff7f0000000000000000000000000000000000000000000000000000000000000000166020820152604081018690526001600160a01b03881660608201525f6080820181905260a082018190526107d060c0830152919391908490819060e0010381838a5af19283156135ac576151879361518d575b506135d4565b806150cf565b8061379461519a926105b6565b5f615181565b89516337e9a82760e11b815287810182815263ffffffff7f0000000000000000000000000000000000000000000000000000000000000000166020820152604081018690526001600160a01b038816606082015290929084908490819060800103815f8a5af19283156135ac576151879361521b57506135d4565b61523a90853d8711615241575b6152328183610656565b81019061528e565b505f615181565b503d615228565b806150e8565b615266919650873d8911611088576110798183610656565b945f6150a9565b8691985061528790833d85116135a5576135978183610656565b979061506d565b9081602091031261042e575167ffffffffffffffff8116810361042e5790565b9060418151145f146152d65761122a91602082015190606060408401519301515f1a90615308565b50505f90600290565b90156152f9578151156152f0575090565b3b1561042e5790565b50805190811561042e57602001fd5b7f7fffffffffffffffffffffffffffffff5d576e7357a4501ddfe92f46681b20a08411615378576020935f9360ff60809460405194855216868401526040830152606082015282805260015afa156135ac575f516001600160a01b0381161561537057905f90565b505f90600190565b505050505f9060039056fea264697066735822122055ad2af729c797abdaca5785a9aa033a3c01eebb02e628fb93e9a77e28791a2964736f6c63430008170033",
+ "deployedBytecode": "0x6080604052600436101561001a575b3615610018575f80fd5b005b5f3560e01c8063079bd2c71461041f5780630c5d5f731461041a5780630eaac9f0146104155780631186ec331461041057806311eac8551461040b57806315348e44146103a257806317fcb39b146104065780631b3d5559146104015780631fab657c146103fc57806329cb924d146103f75780632e378115146103f25780632e63e59a146103ed5780633659cfe6146103e8578063431023b8146103e3578063437b9116146103de578063490e49ef146103d9578063493a4f84146103d45780634f1ef286146103cf5780635285e058146103ca57806352d1902d146103c5578063541f4f14146103c0578063577f51f8146103bb57806357f6dcb8146103b65780636068d6cb146103b1578063647c576c146103ac578063670fa8ac146103a75780636bbbcd2e146103a25780636e4009831461039d578063738b62e514610398578063766e070314610393578063775c0d031461038e5780637aef642c146103895780637b939232146103845780637ef413e11461037f57806382e2c43f1461037a5780638a7860ce146103755780638b15788e14610370578063927ede2d1461036b5780639748cf7c1461036657806397943aa914610361578063979f2bc21461035c57806399cc2968146103575780639a8a059214610352578063a1244c671461034d578063a18a096e14610348578063ac9650d814610343578063ad5425c61461033e578063adb5a6a6146102f3578063b27a430014610339578063b370b7f514610334578063babb6aac1461032f578063bf10268d1461032a578063c35c83fc14610325578063ceb4c98714610320578063d7e1583a1461031b578063dda5211314610316578063ddd224f114610311578063de7eba781461030c578063deff4b2414610307578063e322921114610302578063ea86bd46146102fd578063ee2a53f8146102f8578063f79f29ed146102f3578063fbbba9ac146102ee5763fc8a584f0361000e57612af3565b612a6f565b61242e565b612a31565b61292e565b612905565b612810565b6127e0565b6127b7565b612791565b61275b565b612661565b612636565b6125b2565b6124db565b6124b4565b612475565b6122cd565b61222d565b6120c6565b61209f565b612085565b611ff0565b611f22565b611ea2565b611e5f565b611e31565b611db3565b611d3b565b611c20565b611be9565b611b41565b611aa1565b611a65565b611a41565b6119ac565b611962565b610827565b611928565b611851565b6117f9565b6117b9565b6116e0565b61161d565b6115b3565b61158c565b61145e565b6113d7565b6113b9565b6112ec565b61108f565b610f5d565b610d63565b610c03565b610bda565b610ad8565b6109cf565b610841565b6107e4565b610743565b6104f6565b610490565b610432565b5f91031261042e57565b5f80fd5b3461042e575f36600319011261042e57602060405163ffffffff7f0000000000000000000000000000000000000000000000000000000000000000168152f35b6001600160a01b0381160361042e57565b359061048e82610472565b565b3461042e57602036600319011261042e5760206004356104af81610472565b6001600160a01b038091165f52610c5d825260405f205416604051908152f35b63ffffffff81160361042e57565b610144359061048e826104cf565b359061048e826104cf565b3461042e57602036600319011261042e5763ffffffff600435610518816104cf565b610520613501565b6105286135c3565b16610c5a8163ffffffff198254161790557fe486a5c4bd7b36eabbfe274c99b39130277417be8d2209b4dae04c4fba64ee3a5f80a26001606555005b634e487b7160e01b5f52604160045260245ffd5b6040810190811067ffffffffffffffff82111761059457604052565b610564565b6101a0810190811067ffffffffffffffff82111761059457604052565b67ffffffffffffffff811161059457604052565b6060810190811067ffffffffffffffff82111761059457604052565b6080810190811067ffffffffffffffff82111761059457604052565b6020810190811067ffffffffffffffff82111761059457604052565b60e0810190811067ffffffffffffffff82111761059457604052565b60a0810190811067ffffffffffffffff82111761059457604052565b90601f8019910116810190811067ffffffffffffffff82111761059457604052565b6040519060c0820182811067ffffffffffffffff82111761059457604052565b60405190610180820182811067ffffffffffffffff82111761059457604052565b6040519061048e82610599565b6040519061048e826105e6565b67ffffffffffffffff811161059457601f01601f191660200190565b9291926106fb826106d3565b916107096040519384610656565b82948184528183011161042e578281602093845f960137010152565b9080601f8301121561042e57816020610740933591016106ef565b90565b61010036600319011261042e5760043561075c81610472565b60243561076881610472565b6084358060070b810361042e5760a43590610782826104cf565b60c43567ffffffffffffffff811161042e576107a2903690600401610725565b926107ab6135c3565b60ff61086b5460e81c166107d2576107cb9460643591604435913361363e565b6001606555005b604051630b4cba3160e31b8152600490fd5b3461042e575f36600319011261042e5760206040516001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000168152f35b3461042e575f36600319011261042e5760206040515f8152f35b3461042e575f36600319011261042e5760206040516001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000168152f35b67ffffffffffffffff81116105945760051b60200190565b9080601f8301121561042e5760209082356108b681610884565b936108c46040519586610656565b81855260208086019260051b82010192831161042e57602001905b8282106108ed575050505090565b813581529083019083016108df565b9080601f8301121561042e57602090823561091681610884565b936109246040519586610656565b81855260208086019260051b82010192831161042e57602001905b82821061094d575050505090565b838091833561095b81610472565b81520191019061093f565b929161097182610884565b9161097f6040519384610656565b829481845260208094019160051b810192831161042e57905b8282106109a55750505050565b81358152908301908301610998565b9080601f8301121561042e5781602061074093359101610966565b60031960603682011261042e576004356109e8816104cf565b60243567ffffffffffffffff9283821161042e5760c090823603011261042e57610a10610678565b908060040135825260248101356020830152604481013584811161042e57610a3e906004369184010161089c565b6040830152610a4f606482016104eb565b6060830152610a6060848201610483565b608083015260a48101359084821161042e576004610a8192369201016108fc565b60a082015260443592831161042e57610aa16100189336906004016109b4565b91612b23565b9181601f8401121561042e5782359167ffffffffffffffff831161042e576020808501948460051b01011161042e57565b3461042e5760031960603682011261042e5760043567ffffffffffffffff80821161042e5760608236039384011261042e5760243590610b17826104cf565b60443590811161042e57610b2f903690600401610aa7565b919093610b3a6135c3565b600484013590610182190181121561042e57610bd094610bcb93610b67610bc4936004369189010161267f565b95610b7d610b786080890151613b84565b61382d565b610b8687613434565b9060446020890151916101608a015193610b9e610678565b9a8b5260208b015201356040890152606088015260808701525f60a08701523691610966565b9083613b9a565b613ceb565b6100186001606555565b3461042e575f36600319011261042e576020604051428152f35b908161018091031261042e5790565b3461042e57604036600319011261042e5760043567ffffffffffffffff811161042e57610c34903690600401610bf4565b610c3d81612d1b565b6001600160a01b031690610c5360208201612d1b565b6001600160a01b031691610c6960408301612d1b565b6001600160a01b0316610c7e60608401612d1b565b6001600160a01b031692610c9460808201612d1b565b6001600160a01b031690610100610cac818301612d25565b9061012090610cbc848301612d25565b9261014094858101610ccd90612d25565b966101609a8b8301610cdf9084612d2f565b9a909b610cea610698565b9e8f91825260208201526040015260608d015260808c015260a081013560a08c015260c081013560c08c015260e0013560e08b015263ffffffff1690890152870190610d3b919063ffffffff169052565b63ffffffff909116908501523690610d52926106ef565b908201523360243561001892613465565b3461042e57602036600319011261042e576004803567ffffffffffffffff811161042e57610d949036908301610bf4565b610d9c6135c3565b60ff61086b5460e01c16610f4d5763ffffffff80421692610140830193610dd581610dc687612d25565b63ffffffff9182169116101590565b610f3d57610120840192610de884612d25565b1610610f2e57610e00610dfb368561267f565b613434565b90610e14825f5261087260205260405f2090565b54610f205750610e637f3cee3e290f36226751cd0b3321b213890fe9c768e922f267fa6111836ce05c3292610e5e610e58610e69945f5261087260205260405f2090565b60019055565b612d25565b93612d25565b610e89610e84610e7d610160860186612d2f565b36916106ef565b6141c0565b90610f136040519283926101008701359760e08801359760208101359281359260408301359260c08101359060a081013590606060808201359101358b9693909a999895919261012098959361014089019c895260208901526040880152606087015263ffffffff80921660808701521660a085015260c084015260e08301526101008201520152565b0390a36100186001606555565b604051624be79160e21b8152fd5b60405163d642b7d960e01b8152fd5b50604051630277ae7b60e21b8152fd5b50604051633d90fc5560e11b8152fd5b3461042e57602036600319011261042e57600435610f7a81610472565b6001600160a01b03807f00000000000000000000000000000000000000000000000000000000000000001680301461042e577f360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc90828254160361042e57610fdf613501565b60405191610fec83610602565b5f83527f4910fdfa16fed3260ed0e7147f7cc6da11a60208b5b9406d12a635614ffd91435460ff16156110255750505061001890614d8c565b6020600491604051928380926352d1902d60e01b825288165afa5f918161105e575b50611050575f80fd5b0361042e5761001891614c73565b61108191925060203d602011611088575b6110798183610656565b810190613987565b905f611047565b503d61106f565b3461042e57608036600319011261042e576004356110ac816104cf565b602435906110b982610472565b6044356110c581610472565b606435916110d283610472565b60ff5f5460081c161561042e5761111990610c5a624c4b4063ffffffff1982541617905561086b9063ffffffff60c01b1963ffffffff60c01b83549260c01b169116179055565b6040519061112682610578565b6009825260208201916820a1a927a9a996ab1960b91b8352640312e302e360dc1b602060405161115581610578565b60058152015260ff5f5460081c161561042e57610018946111ba936111b59251902061047f557f06c015bd22b4c69690933c1058878ebdfef31f9aaae40bbe86d8a09fe1b2972c610480556111a8614599565b6111b06145a8565b6145bc565b614616565b610c5a9077ffffffffffffffffffffffffffffffffffffffff000000001977ffffffffffffffffffffffffffffffffffffffff0000000083549260201b169116179055565b602060031982011261042e576004359067ffffffffffffffff821161042e5761122a91600401610aa7565b9091565b5f5b83811061123f5750505f910152565b8181015183820152602001611230565b906020916112688151809281855285808601910161122e565b601f01601f1916010190565b6020808201908083528351809252604092604081018260408560051b8401019601945f925b8584106112aa575050505050505090565b9091929394959685806112db600193603f1986820301885286838d518051151584520151918185820152019061124f565b990194019401929594939190611299565b3461042e576112fa366111ff565b61130381610884565b9160406113136040519485610656565b828452601f1961132284610884565b015f5b8181106113965750505f5b83811061134957604051806113458782611274565b0390f35b8061139061135960019388612d85565b515f80611367858a8a612d99565b90611376895180938193612db0565b0390305af490611384612dbd565b60208201529015159052565b01611330565b60209083516113a481610578565b5f815282606081830152828901015201611325565b3461042e575f36600319011261042e5760206040516301e133808152f35b3461042e57604036600319011261042e576024356004356113f6613501565b6113fe6135c3565b61086c8054680100000000000000008110156105945763ffffffff916001820190558361142a826129f2565b5084600182015555167fc86ba04c55bc5eb2f2876b91c438849a296dbec7b08751c3074d92e04f0a77af5f80a46001606555005b604036600319011261042e5760043561147681610472565b60243567ffffffffffffffff811161042e57611496903690600401610725565b6001600160a01b03807f0000000000000000000000000000000000000000000000000000000000000000169081301461042e577f360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc91818354160361042e576114fc613501565b7f4910fdfa16fed3260ed0e7147f7cc6da11a60208b5b9406d12a635614ffd91435460ff16156115325750505061001890614d8c565b6020600491604051928380926352d1902d60e01b825288165afa5f918161156b575b5061155d575f80fd5b0361042e5761001891614d3b565b61158591925060203d602011611088576110798183610656565b905f611554565b3461042e575f36600319011261042e5760206001600160a01b036108695416604051908152f35b3461042e575f36600319011261042e576001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016300361042e5760206040517f360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc8152f35b61012036600319011261042e5760043561163681610472565b6024359061164382610472565b6044359161165083610472565b60a4358060070b810361042e5760c4359161166a836104cf565b60e43567ffffffffffffffff811161042e5761168a903690600401610725565b936116936135c3565b60ff61086b5460e81c166107d2576107cb95608435926064359261363e565b9181601f8401121561042e5782359167ffffffffffffffff831161042e576020838186019501011161042e57565b3461042e5760c036600319011261042e576004356116fd81610472565b6024356044359160643561171081610472565b67ffffffffffffffff9160843583811161042e576117329036906004016116b2565b60a49491943591821161042e577f45e04bc8f121ba11466985789ca2822a91109f31bb8ac85504a37b7eaf873c26946117726117b49336906004016116b2565b9290916001600160a01b038097166117a68a8c836117913688886106ef565b9161179d368b8b6106ef565b9346908d6141d5565b604051978897169a87612e0c565b0390a3005b3461042e575f36600319011261042e57602060405163ffffffff7f0000000000000000000000000000000000000000000000000000000000000000168152f35b3461042e575f36600319011261042e57602060ff61086b5460e81c166040519015158152f35b606090600319011261042e57600435611837816104cf565b9060243561184481610472565b9060443561074081610472565b3461042e5761185f3661181f565b5f54600881901c60ff161593929084908161191a575b81156118fa575b501561042e576118a09284611897600160ff195f5416175f55565b6118e357612e3f565b6118a657005b6118b461ff00195f54165f55565b604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb384740249890602090a1005b6118f561010061ff00195f5416175f55565b612e3f565b303b1591508161190c575b505f61187c565b6001915060ff16145f611905565b600160ff8216109150611875565b3461042e575f36600319011261042e5760206040517f8d1994e2bbbd77564cdca06dd819e7ee2a5efa06c80dcb59a4a7b6e39edc538f8152f35b3461042e575f36600319011261042e57602060405163ffffffff7f0000000000000000000000000000000000000000000000000000000000000000168152f35b8015150361042e57565b3461042e57602036600319011261042e577fe88463c2f254e2b070013a2dc7ee1e099f9bc00534cbdf03af551dc26ae4921960206004356119ec816119a2565b6119f4613501565b6119fc6135c3565b151561086b80547fffff00ffffffffffffffffffffffffffffffffffffffffffffffffffffffffff60ff60e81b8460e81b169116179055604051908152a16001606555005b3461042e575f36600319011261042e57602063ffffffff610c5a5416604051908152f35b3461042e575f36600319011261042e5760206040517f000000000000000000000000000000000000000000000000000000000000000015158152f35b61016036600319011261042e57600435611aba81610472565b60243590611ac782610472565b604435611ad381610472565b60643590611ae082610472565b60e435611aec81610472565b6101043590611afa826104cf565b6101243592611b08846104cf565b610144359667ffffffffffffffff881161042e57611b2d6100189836906004016116b2565b97909660c4359360a4359360843593612f85565b61018036600319011261042e57600435611b5a81610472565b60243590611b6782610472565b604435611b7381610472565b60643590611b8082610472565b60e435611b8c81610472565b61010435611b99816104cf565b6101243591611ba7836104cf565b611baf6104dd565b93610164359767ffffffffffffffff891161042e57611bd56100189936906004016116b2565b98909760c4359360a4359360843593612fa7565b3461042e57606036600319011261042e576020611c18600435611c0b81610472565b60443590602435906130c2565b604051908152f35b3461042e57606036600319011261042e5767ffffffffffffffff60243581811161042e57611c529036906004016116b2565b9160443590811161042e57611c6b9036906004016116b2565b9060405193602085019480611c824684888a6130fe565b0395611c96601f1997888101845283610656565b6004359151902003611d29575f94611cc5611ce793611cbc87611cf3958a990190612735565b9581019061311b565b519360405193849160208301966337bfd2c960e21b88523391602485016131e3565b03908101835282610656565b5190305af4611d00612dbd565b9015611d0857005b60405163b8fe37a760e01b8152908190611d259060048301613205565b0390fd5b604051630f0c8f4760e11b8152600490fd5b3461042e57602036600319011261042e57600435611d57613501565b611d5f6135c3565b611d68816129f2565b611da0576001815f80935501557f7c1af0646963afc3343245b103731965735a893347bfa0d58a5dc77a77ae691c5f80a26001606555005b634e487b7160e01b5f525f60045260245ffd5b6101a036600319011261042e5761012435611dcd816104cf565b61014435611dda816104cf565b6101643591611de8836104cf565b610184359267ffffffffffffffff841161042e57611e0d6100189436906004016116b2565b9390926101043560e43560c43560a435608435606435604435602435600435613216565b3461042e575f36600319011261042e5760206040517342000000000000000000000000000000000000078152f35b3461042e575f36600319011261042e5760206040516001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000168152f35b3461042e5760e036600319011261042e5767ffffffffffffffff60043581811161042e57611ed4903690600401610bf4565b60a43582811161042e57611eec9036906004016116b2565b60c49291923593841161042e57611f0a6100189436906004016116b2565b9390926084359060643590604435906024359061328e565b3461042e57611f303661181f565b909160ff5f5460081c161561042e57611f669061086b9063ffffffff60c01b1963ffffffff60c01b83549260c01b169116179055565b604051611f7281610578565b6009815260208101926820a1a927a9a996ab1960b91b8452640312e302e360dc1b6020604051611fa181610578565b60058152015260ff5f5460081c161561042e57610018936111b59251902061047f557f06c015bd22b4c69690933c1058878ebdfef31f9aaae40bbe86d8a09fe1b2972c610480556111a8614599565b3461042e57602036600319011261042e577f2d5b62420992e5a4afce0e77742636ca2608ef58289fd2e1baa5161ef6e7e41e6020600435612030816119a2565b612038613501565b6120406135c3565b151561086b80547fffffff00ffffffffffffffffffffffffffffffffffffffffffffffffffffffff60ff60e01b8460e01b169116179055604051908152a16001606555005b3461042e575f36600319011261042e576020604051468152f35b3461042e575f36600319011261042e57602063ffffffff61086b5460c01c16604051908152f35b3461042e57604036600319011261042e576004356024356120e682614b97565b6001600160a01b0382165f5261087360205261211560405f20336001600160a01b03165f5260205260405f2090565b549182156121b8575f61215c3361214661212e85613b84565b6001600160a01b03165f5261087360205260405f2090565b906001600160a01b03165f5260205260405f2090565b556121888361217961216d84613b84565b6001600160a01b031690565b61218285613b84565b90614670565b60405192835233927f6c172ea51018fb2eb2118f3f8a507c4df71eb519b8c0052834dc3c920182fef490602090a4005b6040516336542bf760e21b8152600490fd5b6020808201906020835283518092526040830192602060408460051b8301019501935f915b8483106121ff5750505050505090565b909192939495848061221d600193603f198682030187528a5161124f565b98019301930191949392906121ef565b3461042e5761223b366111ff565b9061224582613377565b915f5b81811061225d576040518061134586826121ca565b5f8061226a838587612d99565b9061227a60405180938193612db0565b0390305af4612287612dbd565b90156122ad579060019161229b8287612d85565b526122a68186612d85565b5001612248565b604481511061042e5780600461042e9201516024809183010191016133c0565b6101808060031936011261042e57610104356122e8816104cf565b61012435916122f6836104cf565b6101443592612304846104cf565b6101643567ffffffffffffffff811161042e576123259036906004016116b2565b61232d6135c3565b61086b549260ff8460e81c166107d257610bd0966123f2610e7d926123e463ffffffff6124009860c01c16996123886123658c61341f565b61086b9063ffffffff60c01b1963ffffffff60c01b83549260c01b169116179055565b6123906106b9565b9a6004358c5260243560208d015260443560408d015260643560608d015260843560808d015260a43560a08d015260c43560c08d015260e43560e08d01526101008c01526101208b019063ffffffff169052565b63ffffffff16610140890152565b63ffffffff16610160870152565b90820152614307565b604090600319011261042e5760043561242181610472565b9060243561074081610472565b3461042e57602061246c6001600160a01b0361244936612409565b91165f52610873835260405f20906001600160a01b03165f5260205260405f2090565b54604051908152f35b3461042e57602036600319011261042e57602060043561249481610472565b6001600160a01b038091165f52610c5c825260405f205416604051908152f35b3461042e575f36600319011261042e5760206001600160a01b0361086a5416604051908152f35b3461042e5760c036600319011261042e5760043560243567ffffffffffffffff60643560443560843583811161042e576125199036906004016116b2565b60a49491943591821161042e577f45e04bc8f121ba11466985789ca2822a91109f31bb8ac85504a37b7eaf873c26946125596125a89336906004016116b2565b9290916125646135c3565b61256d8a614b97565b61259c898b898961257f3688886106ef565b9261258b368b8b6106ef565b946001600160a01b034692166141d5565b60405196879687612e0c565b0390a36001606555005b3461042e576125c036612409565b906125c9613501565b6125d16135c3565b6001600160a01b0380911691825f52610c5d6020526126098160405f20906001600160a01b03166001600160a01b0319825416179055565b16907fcb84c2022106a6f2b6f805d446f32fbfd2a528474364fa755f37dac1c0c1b6c85f80a36001606555005b3461042e57602036600319011261042e576004355f52610872602052602060405f2054604051908152f35b3461042e575f36600319011261042e57602060405163ffffffff8152f35b91906101808382031261042e57612694610698565b92803584526020810135602085015260408101356040850152606081013560608501526080810135608085015260a081013560a085015260c081013560c085015260e081013560e085015261010080820135908501526101206126f88183016104eb565b9085015261014061270a8183016104eb565b90850152610160918282013567ffffffffffffffff811161042e5761272f9201610725565b90830152565b9060208282031261042e57813567ffffffffffffffff811161042e57610740920161267f565b3461042e57602036600319011261042e5760043567ffffffffffffffff811161042e57611c18610dfb602092369060040161267f565b3461042e575f36600319011261042e57602060ff61086b5460e01c166040519015158152f35b3461042e575f36600319011261042e5760206040516ec097ce7bc90715b34b9f10000000008152f35b3461042e57602036600319011261042e576107cb60043561280081610472565b612808613501565b6111b06135c3565b3461042e57606036600319011261042e5760043567ffffffffffffffff811161042e5761284190369060040161267f565b6128496135c3565b60ff61086b5460e01c166128f35761014081015163ffffffff42811691161015806128d4575b6128c25780612880610bd092613434565b60c08201516020830151906101608401519261289a610678565b948552602085015260408401526060830152608082015260243560a082015260443590613f5f565b604051630c3a9b9d60e41b8152600490fd5b506128e26040820151613b84565b6001600160a01b031633141561286f565b604051633d90fc5560e11b8152600490fd5b3461042e575f36600319011261042e576020610c5a546001600160a01b0360405191831c168152f35b6101608060031936011261042e5761010435612949816104cf565b61012435612956816104cf565b6101443567ffffffffffffffff811161042e576129779036906004016116b2565b63ffffffff9461298a8642169586612f68565b936129936135c3565b61086b549160ff8360e81c166107d2576129c66129d3966123e4610bd09a610e7d9660c01c16996123886123658c61341f565b86019063ffffffff169052565b610180820152614307565b634e487b7160e01b5f52603260045260245ffd5b61086c908154811015612a2c576003915f52027f71cd7344f4eb2efc8e30291f6dbdb44d618ca368ea5425d217c1d604bf26b84d01905f90565b6129de565b3461042e57602036600319011261042e5760043561086c5481101561042e57612a5b6040916129f2565b506001815491015482519182526020820152f35b3461042e57612a7d36612409565b90612a86613501565b612a8e6135c3565b6001600160a01b0380911691825f52610c5c602052612ac68160405f20906001600160a01b03166001600160a01b0319825416179055565b16907ff3dc137d2246f9b8abd0bb821e185ba01122c9b3ea3745ffca6208037674d6705f80a36001606555005b3461042e57602036600319011261042e576107cb600435612b1381610472565b612b1b613501565b6111b56135c3565b91612b2c6135c3565b6080820191612b45610b7884516001600160a01b031690565b602081019182514603612c4c57612b6d612b7191836001612b65896129f2565b5001546138a0565b1590565b612c3a578060607ff4ad92585b1bc117fbdd644990adf0827bc4c95baeae8a23322af807b6d0020e920193612bb3612bad865163ffffffff1690565b87613932565b612c2d845194835193612c12612c04612bf360408401998a51612bda8d5163ffffffff1690565b89516001600160a01b03169160a088019b8c51946139a3565b925193519851995163ffffffff1690565b94516001600160a01b031690565b945163ffffffff9586604051978897169b1699339487612ccd565b0390a461048e6001606555565b60405163582f497d60e11b8152600490fd5b604051633d23e4d160e11b8152600490fd5b9081518082526020808093019301915f5b828110612c7d575050505090565b835185529381019392810192600101612c6f565b9081518082526020808093019301915f5b828110612cb0575050505090565b83516001600160a01b031685529381019392810192600101612ca2565b9496959193612cef60a095612d0d93885260c0602089015260c0880190612c5e565b906001600160a01b0380951660408801528682036060880152612c91565b951515608085015216910152565b3561074081610472565b35610740816104cf565b903590601e198136030182121561042e570180359067ffffffffffffffff821161042e5760200191813603831361042e57565b634e487b7160e01b5f52602160045260245ffd5b60031115612d8057565b612d62565b8051821015612a2c5760209160051b010190565b90821015612a2c5761122a9160051b810190612d2f565b908092918237015f815290565b3d15612de7573d90612dce826106d3565b91612ddc6040519384610656565b82523d5f602084013e565b606090565b908060209392818452848401375f828201840152601f01601f1916010190565b94929093612e3192610740979587526020870152608060408701526080860191612dec565b926060818503910152612dec565b91909160ff5f5460081c161561042e57612e8990610c5a624c4b4063ffffffff1982541617905561086b9063ffffffff60c01b1963ffffffff60c01b83549260c01b169116179055565b604051612e9581610578565b6009815260208101926820a1a927a9a996ab1960b91b8452640312e302e360dc1b6020604051612ec481610578565b60058152015260ff5f5460081c161561042e57612f13936111b59251902061047f557f06c015bd22b4c69690933c1058878ebdfef31f9aaae40bbe86d8a09fe1b2972c610480556111a8614599565b61048e610c5a77deaddeaddeaddeaddeaddeaddeaddeaddead00000000000077ffffffffffffffffffffffffffffffffffffffff0000000019825416179055565b634e487b7160e01b5f52601160045260245ffd5b91909163ffffffff80809416911601918211612f8057565b612f54565b969492909161048e9b9a9998969492612fa563ffffffff42169889612f68565b985b9593919b999897969492909b612fbb6135c3565b61086b549660ff8860e81c166107d2578760c01c63ffffffff16612fde9061341f565b6130059061086b9063ffffffff60c01b1963ffffffff60c01b83549260c01b169116179055565b61300d6106b9565b9d6001600160a01b038f921682526001600160a01b031690602001526001600160a01b031660408d01526001600160a01b031660608c015260808b015260a08a015260c08901526001600160a01b031660e088015260c01c63ffffffff16610100870152610120860190613086919063ffffffff169052565b63ffffffff1661014085015263ffffffff1661016084015236906130a9926106ef565b6101808201526130b890614307565b61048e6001606555565b916040519160208301936bffffffffffffffffffffffff199060601b16845260348301526054820152605481526130f8816105e6565b51902090565b93929160209161311691604087526040870191612dec565b930152565b9081602091031261042e57604051906020820182811067ffffffffffffffff8211176105945760405235815290565b6107409161018090825181526020830151602082015260408301516040820152606083015160608201526080830151608082015260a083015160a082015260c083015160c082015260e083015160e082015261010080840151908201526131bf610120808501519083019063ffffffff169052565b6101408381015163ffffffff1690820152816101608094015193820152019061124f565b6131fb6040929594939560608352606083019061314a565b9460208201520152565b90602061074092818152019061124f565b9c9a999897969594939291909661322b6135c3565b60ff61086b5460e81c166107d257613244908e336130c2565b96604051809e61325382610599565b81526020015260408d015260608c015260808b015260a08a015260c089015260e088015261010087015263ffffffff16610120860152613086565b97929095939196949761329f6135c3565b60ff61086b5460e01c166128f3576132ba6101408201612d25565b63ffffffff8042169116101580613358575b6128c257613341613353966133396130b89b6132eb610dfb368761267f565b9a6132f4610678565b9b6132ff368861267f565b8d5260208d01528660408d01528760608d015261331d368b846106ef565b60808d015260a08c01526133318535613b84565b9836916106ef565b9536916106ef565b9461010060e0830135920135906141d5565b613f5f565b506133666040820135613b84565b6001600160a01b03163314156132cc565b9061338182610884565b61338e6040519182610656565b828152809261339f601f1991610884565b01905f5b8281106133af57505050565b8060606020809385010152016133a3565b60208183031261042e5780519067ffffffffffffffff821161042e570181601f8201121561042e5780516133f3816106d3565b926134016040519485610656565b8184526020828401011161042e57610740916020808501910161122e565b63ffffffff809116908114612f805760010190565b6040516130f881613451602082019460408652606083019061314a565b46604083015203601f198101835282610656565b9190916134706135c3565b60ff61086b5460e01c166128f35761014081015163ffffffff42811691161015806134e2575b6128c2576130b8926134a782613434565b60c0830151602084015190610160850151926134c1610678565b958652602086015260408501526060840152608083015260a0820152613f5f565b506134f06040820151613b84565b6001600160a01b0316331415613496565b7342000000000000000000000000000000000000078033036135b157602060049160405192838092636e296e4560e01b82525afa9081156135ac575f9161357d575b506001600160a01b0361356261216d610869546001600160a01b031690565b91160361356b57565b6040516336a816d960e01b8152600490fd5b61359f915060203d6020116135a5575b6135978183610656565b8101906146b8565b5f613543565b503d61358d565b6135e1565b60405163253a6fc960e11b8152600490fd5b60026065541461042e576002606555565b91908203918211612f8057565b6040513d5f823e3d90fd5b926107409695929491946101409585525f60208601526040850152606084015263ffffffff809116608084015260a08301525f60c083015260e08201525f61010082015281610120820152019061124f565b9193949690959660070b906706f05b59d3b2000061365b836146cd565b101561381b576ec097ce7bc90715b34b9f100000000084116138095763ffffffff93613689858a16426135d4565b857f000000000000000000000000000000000000000000000000000000000000000016106137f75761086b5460c01c63ffffffff16986136cb6123658b61341f565b6001600160a01b039586807f000000000000000000000000000000000000000000000000000000000000000016981692888414806137ee575b156137b2578034036137a057883b1561042e575f6004996040519a8b8092630d0e30db60e41b825234905af19889156135ac5761376f613782978a927f32ed1a409ef04c7b0227189c3a103dc5ac10e775a15b785dcc510201f7c25ad39c613787575b505b8361471b565b92604051998a99169d169b1693876135ec565b0390a4565b8061379461379a926105b6565b80610424565b5f613767565b604051636452a35d60e01b8152600490fd5b7f32ed1a409ef04c7b0227189c3a103dc5ac10e775a15b785dcc510201f7c25ad398508761376f613782976137e98430338a6146dc565b613769565b50341515613704565b60405163f722177f60e01b8152600490fd5b60405163622db5a960e11b8152600490fd5b60405163284f109760e21b8152600490fd5b6001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000811691168114613864575b50565b4761386c5750565b4790803b1561042e575f90600460405180948193630d0e30db60e41b83525af180156135ac57156138615761048e906105b6565b61074092916040516139298161391b602082019460208652805160408401526020810151606084015260a06138e5604083015160c06080870152610100860190612c5e565b606083015163ffffffff168583015260808301516001600160a01b031660c0860152910151838203603f190160e0850152612c91565b03601f198101835282610656565b51902091614751565b61393d6002916129f2565b500162ffffff8260081c16805f5281602052600160ff60405f205494161b8080941614613975575f5260205260405f20908154179055565b60405163954476d960e01b8152600490fd5b9081602091031261042e575190565b91908201809211612f8057565b91959495939092935f9681519081815103613b725781613a22575b505050826139cd575b50505050565b6001600160a01b0381613a017ffa7fa7cf6d7dde5f9be65a67e6a1a747e7aa864dcd2d793353c722d80fbbb3579386614814565b6040805195865233602087015291169463ffffffff1693a45f8080806139c7565b604080516370a0823160e01b81523060048083019190915291906020816024816001600160a01b038b165afa9081156135ac575f91613b53575b505f805b868110613a715750505050506139be565b613a7b8189612d85565b51613a89575b600101613a60565b90613a9f90613a98838a612d85565b5190613996565b90828211613b4357613ad9612b6d613ac7613aba848a612d85565b516001600160a01b031690565b613ad1848c612d85565b51908c6147a2565b15613a81579c5087613b39613b318f613b1c613aba613b15613afb848f612d85565b51966001600160a01b03165f5261087360205260405f2090565b928b612d85565b6001600160a01b03165f5260205260405f2090565b918254613996565b905560019c613a81565b50505051632ddaa83160e11b8152fd5b613b6c915060203d602011611088576110798183610656565b5f613a5c565b6040516319a5316760e31b8152600490fd5b6001600160a01b0390613b9681614b97565b1690565b91612b6d90613c1392845160408096015191865191613bb8836105ca565b8252613929613bd360208401924684528985019586526129f2565b5054938851928391613bf86020840196602088525160608d86015260a085019061314a565b9151606084015251608083015203601f198101835282610656565b613c1a5750565b5163582f497d60e11b8152600490fd5b613c3382612d76565b52565b9a989693919c9b9997959492909c6101e08c019d8c5260208c015260408b015260608a0152608089015263ffffffff80921660a08901521660c087015260e08601526101008501526101208401526101408301528051610160830152602081015161018083015260408101516101a08301526060015190613cb682612d76565b6101c00152565b9061074094936080936001600160a01b0380931684526020840152166040820152816060820152019061124f565b905f82516101208101613d02815163ffffffff1690565b63ffffffff42911610613f4d576020850151906002613d2a835f5261087260205260405f2090565b5414613f3b57613d4486925f5261087260205260405f2090565b6002905560608301519060808401519160a08501519260c0860151918560a0810151938860e0810151956101008201519751613d839063ffffffff1690565b61014083015163ffffffff166040840151918451936020860151956101600151613dac906141c0565b966060890151986080019e8f51613dc2906141c0565b906040015190613dd06106c6565b9a8b5260208b015260408a0152600260608a01526040519d8e9b613df49b8d613c36565b037f44b559f101f8fbcc8a0ea43fa91a05a729a5ea6e14a7c75aa750374690137208905f94a46080820151613e2890613b84565b9060408601519560600151613e3c90613b84565b9260800151613e4a90613b84565b6001600160a01b03919082167f0000000000000000000000000000000000000000000000000000000000000000831603613f265784613f13575b613e9087838616614bb2565b51928351151580613f09575b613eaa575b50505050509050565b1690813b15613f055783613ed8959660405196879586948593633a5be8cb60e01b8552339160048601613cbd565b03925af180156135ac57613ef2575b808080808594613ea1565b80613794613eff926105b6565b5f613ee7565b8380fd5b50803b1515613e9c565b613f218730338587166146dc565b613e84565b5f9450613f368785858516614670565b613e90565b604051630479306360e51b8152600490fd5b60405163d642b7d960e01b8152600490fd5b8051916101208301613f75815163ffffffff1690565b63ffffffff42911610613f4d5760208301516001613f9c825f5261087260205260405f2090565b54036141b9576001905b6002613fbb825f5261087260205260405f2090565b5414613f3b57613fd7613fdd915f5261087260205260405f2090565b60029055565b7f44b559f101f8fbcc8a0ea43fa91a05a729a5ea6e14a7c75aa75037469013720860608601516080870151906140aa8760a08a0151958a60c08101519760a08401519860e08301519961403a6101008501519c5163ffffffff1690565b61014085015163ffffffff169160408601519386519561409e61406661016060208b01519a01516141c0565b9960608c01519b604061407c60808301516141c0565b91015190602061408a6106c6565b9e8f528e015260408d015260608c01613c2a565b6040519c8d9c8d613c36565b0390a46140ba6080830151613b84565b9160408201519160806140dc816140d46060850151613b84565b940151613b84565b6001600160a01b03929083167f00000000000000000000000000000000000000000000000000000000000000008416036141a65761411e853033868a166146dc565b61412a85848616614bb2565b015191825115158061419c575b614143575b5050505050565b16803b1561042e57614171935f809460405196879586948593633a5be8cb60e01b8552339160048601613cbd565b03925af180156135ac57614189575b8080808061413c565b80613794614196926105b6565b5f614180565b50803b1515614137565b6141b4858533868a166146dc565b61412a565b5f90613fa6565b805190816141ce5750505f90565b6020012090565b939260429361048e979660208151910120906040519260208401947f8d1994e2bbbd77564cdca06dd819e7ee2a5efa06c80dcb59a4a7b6e39edc538f86526040850152856060850152608084015260a083015260c082015260c0815261423a8161061e565b5190209061047f549061048054906040519160208301937fc2f8787176b8ac6bf7215b4adcc1e069bf4ab82d9ab1df05a57a91d425935b6e8552604084015260608301526080820152608081526142908161063a565b519020906040519161190160f01b8352600283015260228201522090614dcf565b96926107409a9996949198959261014099895260208901526040880152606087015263ffffffff928380921660808801521660a08601521660c084015260e083015261010082015281610120820152019061124f565b6143118151614b97565b6101208101614330614327825163ffffffff1690565b63ffffffff1690565b804210908115614560575b506137f757610140820191614354835163ffffffff1690565b9063ffffffff9182614388817f00000000000000000000000000000000000000000000000000000000000000001642613996565b91161161454e5761016081015163ffffffff169180831680614509575b505060408101908151916001600160a01b037f00000000000000000000000000000000000000000000000000000000000000001680931480614500575b156144b357608082015134036137a057823b1561042e575f60049360405194858092630d0e30db60e41b825234905af19283156135ac577f32ed1a409ef04c7b0227189c3a103dc5ac10e775a15b785dcc510201f7c25ad3936144a0575b505b5161378260608301519260808101519060a081015160c08201519761447f6144746101008501519b5163ffffffff1690565b9b5163ffffffff1690565b83519b60208501519361018060e0870151960151966040519a8b9a8b6142b1565b806137946144ad926105b6565b5f614440565b9150346137a057816144fb6144ec61216d7f32ed1a409ef04c7b0227189c3a103dc5ac10e775a15b785dcc510201f7c25ad39551613b84565b608084015190309033906146dc565b614442565b503415156143e2565b6301e133801015614539575b5060e081015115614527575f806143a5565b60405163495d907f60e01b8152600490fd5b916145479192421690612f68565b905f614515565b60405163582e388960e01b8152600490fd5b61456b9150426135d4565b63ffffffff7f000000000000000000000000000000000000000000000000000000000000000016105f61433b565b60ff5f5460081c161561042e57565b60ff5f5460081c161561042e576001606555565b6001600160a01b0316801561460457610869816001600160a01b03198254161790557fa9e8c42c9e7fca7f62755189a16b2f5314d43d8fb24e91ba54e6d65f9314e8495f80a2565b60405163ba97b39d60e01b8152600490fd5b6001600160a01b0316801561465e5761086a816001600160a01b03198254161790557fa73e8909f8616742d7fe701153d82666f7b7cd480552e23ebb05d358c22fd04e5f80a2565b604051635b03092b60e11b8152600490fd5b60405163a9059cbb60e01b60208201526001600160a01b039092166024830152604482019290925261048e916146b382606481015b03601f198101845283610656565b614ead565b9081602091031261042e575161074081610472565b5f81126146d75790565b5f0390565b909261048e93604051936323b872dd60e01b60208601526001600160a01b0380921660248601521660448401526064830152606482526146b38261063a565b90670de0b6b3a7640000915f828403921283831281169084841390151617612f8057818102918183041490151715612f80570490565b929091905f915b845183101561479a5761476b8386612d85565b519081811015614789575f52602052600160405f205b920191614758565b905f52602052600160405f20614781565b915092501490565b60405163a9059cbb60e01b60208281019182526001600160a01b039094166024830152604482019490945290925f916147de816064810161391b565b519082855af1903d5f5190836147f5575b50505090565b9192509061480a57503b15155b5f80806147ef565b6001915014614802565b906001600160a01b0390818116907f00000000000000000000000000000000000000000000000000000000000000008316820361493e5750803b1561042e57604051632e1a7d4d60e01b815260048101849052905f908290602490829084905af180156135ac5761492b575b50610c5a549161489961086a546001600160a01b031690565b73420000000000000000000000000000000000001090813b1561042e57604051631474f2a960e31b8152602086901c949094166001600160a01b0390811660048601521660248401526044830182905263ffffffff909316606483015260a060848301525f60a483018190529192839160c4918391905af180156135ac5761491e5750565b8061379461048e926105b6565b80613794614938926105b6565b5f614880565b91807f000000000000000000000000000000000000000000000000000000000000000016151580614b6c575b1561498e5750505061048e9061498961086a546001600160a01b031690565b614fe1565b806149bb6149ae856001600160a01b03165f52610c5c60205260405f2090565b546001600160a01b031690565b16614b48577342000000000000000000000000000000000000105b16906149fa61216d6149ae856001600160a01b03165f52610c5d60205260405f2090565b15614ac2578382614a0a92614f3d565b614a296149ae836001600160a01b03165f52610c5d60205260405f2090565b90614a3d61086a546001600160a01b031690565b91614a4e610c5a5463ffffffff1690565b823b1561042e5760405163540abf7360e01b81526001600160a01b0395861660048201529185166024830152929093166044840152606483019390935263ffffffff16608482015260c060a48201525f60c482018190529091829081838160e481015b03925af180156135ac5761491e5750565b5091614ad761086a546001600160a01b031690565b92614ae8610c5a5463ffffffff1690565b93813b1561042e57604051631474f2a960e31b81526001600160a01b03948516600482015293166024840152604483019190915263ffffffff909216606482015260a060848201525f60a482018190529091829081838160c48101614ab1565b614b676149ae846001600160a01b03165f52610c5c60205260405f2090565b6149d6565b50807f000000000000000000000000000000000000000000000000000000000000000016821461496a565b60a01c614ba057565b6040516379ec0ed760e11b8152600490fd5b6001600160a01b0390811690813b15614bf2579061048e92917f000000000000000000000000000000000000000000000000000000000000000016614670565b7f000000000000000000000000000000000000000000000000000000000000000016803b1561042e575f8091602460405180948193632e1a7d4d60e01b83528860048401525af180156135ac57614c64575b5081471061042e575f80809381935af1614c5c612dbd565b501561042e57565b614c6d906105b6565b5f614c44565b614c7c81614d8c565b6001600160a01b0381167fbc7cd75a20ee27fd9adebab32041f755214dbc6bffa90cc0225b39da2e5c2d3b5f80a2815115801590614d34575b614cbd575050565b5f80613861937f206661696c65640000000000000000000000000000000000000000000000000060408051614cf1816105ca565b602781527f416464726573733a206c6f772d6c6576656c2064656c65676174652063616c6c60208201520152602081519101845af4614d2e612dbd565b916152df565b505f614cb5565b614d4481614d8c565b6001600160a01b0381167fbc7cd75a20ee27fd9adebab32041f755214dbc6bffa90cc0225b39da2e5c2d3b5f80a2815115801590614d8457614cbd575050565b506001614cb5565b803b1561042e576001600160a01b037f360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc91166001600160a01b0319825416179055565b614dd983836152ae565b6005819592951015612d8057159384614e97575b508315614e11575b50505015614dff57565b60405163938a182160e01b8152600490fd5b5f929350908291604051614e498161391b6020820194630b135d3f60e11b998a8752602484015260406044840152606483019061124f565b51915afa90614e56612dbd565b82614e89575b82614e6c575b50505f8080614df5565b614e8191925060208082518301019101613987565b145f80614e62565b915060208251101591614e5c565b6001600160a01b0383811691161493505f614ded565b905f806001600160a01b03614f049416927f5361666545524332303a206c6f772d6c6576656c2063616c6c206661696c65646020604051614eed81610578565b818152015260208151910182855af1614d2e612dbd565b8051908115918215614f1a575b50501561042e57565b819250906020918101031261042e5760200151614f36816119a2565b5f80614f11565b6044919260206001600160a01b0360405194858092636eb1769f60e11b8252306004830152808916602483015286165afa9283156135ac575f93614fc0575b508201809211612f805760405163095ea7b360e01b60208201526001600160a01b039093166024840152604483019190915261048e91906146b382606481016146a5565b614fda91935060203d602011611088576110798183610656565b915f614f7c565b906001600160a01b038092167f000000000000000000000000000000000000000000000000000000000000000090837f0000000000000000000000000000000000000000000000000000000000000000169361503e848685614f3d565b604094604051926332dd704760e21b84526020956004948781600481875afa9687156135ac5788915f9861526d575b506040516352b7631960e11b81529086166001600160a01b03811660048301529097909588916024918391165afa9586156135ac575f9661524e575b5095867f0000000000000000000000000000000000000000000000000000000000000000975b6150de57505050505050505050565b8681111561524857865b88156151a057843b1561042e578951634701287760e11b815287810182815263ffffffff7f0000000000000000000000000000000000000000000000000000000000000000166020820152604081018690526001600160a01b03881660608201525f6080820181905260a082018190526107d060c0830152919391908490819060e0010381838a5af19283156135ac576151879361518d575b506135d4565b806150cf565b8061379461519a926105b6565b5f615181565b89516337e9a82760e11b815287810182815263ffffffff7f0000000000000000000000000000000000000000000000000000000000000000166020820152604081018690526001600160a01b038816606082015290929084908490819060800103815f8a5af19283156135ac576151879361521b57506135d4565b61523a90853d8711615241575b6152328183610656565b81019061528e565b505f615181565b503d615228565b806150e8565b615266919650873d8911611088576110798183610656565b945f6150a9565b8691985061528790833d85116135a5576135978183610656565b979061506d565b9081602091031261042e575167ffffffffffffffff8116810361042e5790565b9060418151145f146152d65761122a91602082015190606060408401519301515f1a90615308565b50505f90600290565b90156152f9578151156152f0575090565b3b1561042e5790565b50805190811561042e57602001fd5b7f7fffffffffffffffffffffffffffffff5d576e7357a4501ddfe92f46681b20a08411615378576020935f9360ff60809460405194855216868401526040830152606082015282805260015afa156135ac575f516001600160a01b0381161561537057905f90565b505f90600190565b505050505f9060039056fea264697066735822122055ad2af729c797abdaca5785a9aa033a3c01eebb02e628fb93e9a77e28791a2964736f6c63430008170033"
}
diff --git a/deployments/worldchain/solcInputs/f6db5bcc09d996b0e542155af45c1220.json b/deployments/worldchain/solcInputs/f6db5bcc09d996b0e542155af45c1220.json
new file mode 100644
index 000000000..3d74813bd
--- /dev/null
+++ b/deployments/worldchain/solcInputs/f6db5bcc09d996b0e542155af45c1220.json
@@ -0,0 +1,168 @@
+{
+ "language": "Solidity",
+ "sources": {
+ "@eth-optimism/contracts/libraries/constants/Lib_PredeployAddresses.sol": {
+ "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.9;\n\n/**\n * @title Lib_PredeployAddresses\n */\nlibrary Lib_PredeployAddresses {\n address internal constant L2_TO_L1_MESSAGE_PASSER = 0x4200000000000000000000000000000000000000;\n address internal constant L1_MESSAGE_SENDER = 0x4200000000000000000000000000000000000001;\n address internal constant DEPLOYER_WHITELIST = 0x4200000000000000000000000000000000000002;\n address payable internal constant OVM_ETH = payable(0xDeadDeAddeAddEAddeadDEaDDEAdDeaDDeAD0000);\n address internal constant L2_CROSS_DOMAIN_MESSENGER =\n 0x4200000000000000000000000000000000000007;\n address internal constant LIB_ADDRESS_MANAGER = 0x4200000000000000000000000000000000000008;\n address internal constant PROXY_EOA = 0x4200000000000000000000000000000000000009;\n address internal constant L2_STANDARD_BRIDGE = 0x4200000000000000000000000000000000000010;\n address internal constant SEQUENCER_FEE_WALLET = 0x4200000000000000000000000000000000000011;\n address internal constant L2_STANDARD_TOKEN_FACTORY =\n 0x4200000000000000000000000000000000000012;\n address internal constant L1_BLOCK_NUMBER = 0x4200000000000000000000000000000000000013;\n}\n"
+ },
+ "@openzeppelin/contracts-upgradeable/crosschain/errorsUpgradeable.sol": {
+ "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.6.0) (crosschain/errors.sol)\n\npragma solidity ^0.8.4;\n\nerror NotCrossChainCall();\nerror InvalidCrossChainSender(address actual, address expected);\n"
+ },
+ "@openzeppelin/contracts-upgradeable/crosschain/optimism/LibOptimismUpgradeable.sol": {
+ "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.7.0) (crosschain/optimism/LibOptimism.sol)\n\npragma solidity ^0.8.4;\n\nimport {ICrossDomainMessengerUpgradeable as Optimism_Bridge} from \"../../vendor/optimism/ICrossDomainMessengerUpgradeable.sol\";\nimport \"../errorsUpgradeable.sol\";\n\n/**\n * @dev Primitives for cross-chain aware contracts for https://www.optimism.io/[Optimism].\n * See the https://community.optimism.io/docs/developers/bridge/messaging/#accessing-msg-sender[documentation]\n * for the functionality used here.\n */\nlibrary LibOptimismUpgradeable {\n /**\n * @dev Returns whether the current function call is the result of a\n * cross-chain message relayed by `messenger`.\n */\n function isCrossChain(address messenger) internal view returns (bool) {\n return msg.sender == messenger;\n }\n\n /**\n * @dev Returns the address of the sender that triggered the current\n * cross-chain message through `messenger`.\n *\n * NOTE: {isCrossChain} should be checked before trying to recover the\n * sender, as it will revert with `NotCrossChainCall` if the current\n * function call is not the result of a cross-chain message.\n */\n function crossChainSender(address messenger) internal view returns (address) {\n if (!isCrossChain(messenger)) revert NotCrossChainCall();\n\n return Optimism_Bridge(messenger).xDomainMessageSender();\n }\n}\n"
+ },
+ "@openzeppelin/contracts-upgradeable/interfaces/draft-IERC1822Upgradeable.sol": {
+ "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.5.0) (interfaces/draft-IERC1822.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @dev ERC1822: Universal Upgradeable Proxy Standard (UUPS) documents a method for upgradeability through a simplified\n * proxy whose upgrades are fully controlled by the current implementation.\n */\ninterface IERC1822ProxiableUpgradeable {\n /**\n * @dev Returns the storage slot that the proxiable contract assumes is being used to store the implementation\n * address.\n *\n * IMPORTANT: A proxy pointing at a proxiable contract should not be considered proxiable itself, because this risks\n * bricking a proxy that upgrades to it, by delegating to itself until out of gas. Thus it is critical that this\n * function revert if invoked through a proxy.\n */\n function proxiableUUID() external view returns (bytes32);\n}\n"
+ },
+ "@openzeppelin/contracts-upgradeable/interfaces/IERC1967Upgradeable.sol": {
+ "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (interfaces/IERC1967.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @dev ERC-1967: Proxy Storage Slots. This interface contains the events defined in the ERC.\n *\n * _Available since v4.8.3._\n */\ninterface IERC1967Upgradeable {\n /**\n * @dev Emitted when the implementation is upgraded.\n */\n event Upgraded(address indexed implementation);\n\n /**\n * @dev Emitted when the admin account has changed.\n */\n event AdminChanged(address previousAdmin, address newAdmin);\n\n /**\n * @dev Emitted when the beacon is changed.\n */\n event BeaconUpgraded(address indexed beacon);\n}\n"
+ },
+ "@openzeppelin/contracts-upgradeable/proxy/beacon/IBeaconUpgradeable.sol": {
+ "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts v4.4.1 (proxy/beacon/IBeacon.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @dev This is the interface that {BeaconProxy} expects of its beacon.\n */\ninterface IBeaconUpgradeable {\n /**\n * @dev Must return an address that can be used as a delegate call target.\n *\n * {BeaconProxy} will check that this address is a contract.\n */\n function implementation() external view returns (address);\n}\n"
+ },
+ "@openzeppelin/contracts-upgradeable/proxy/ERC1967/ERC1967UpgradeUpgradeable.sol": {
+ "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (proxy/ERC1967/ERC1967Upgrade.sol)\n\npragma solidity ^0.8.2;\n\nimport \"../beacon/IBeaconUpgradeable.sol\";\nimport \"../../interfaces/IERC1967Upgradeable.sol\";\nimport \"../../interfaces/draft-IERC1822Upgradeable.sol\";\nimport \"../../utils/AddressUpgradeable.sol\";\nimport \"../../utils/StorageSlotUpgradeable.sol\";\nimport {Initializable} from \"../utils/Initializable.sol\";\n\n/**\n * @dev This abstract contract provides getters and event emitting update functions for\n * https://eips.ethereum.org/EIPS/eip-1967[EIP1967] slots.\n *\n * _Available since v4.1._\n */\nabstract contract ERC1967UpgradeUpgradeable is Initializable, IERC1967Upgradeable {\n // This is the keccak-256 hash of \"eip1967.proxy.rollback\" subtracted by 1\n bytes32 private constant _ROLLBACK_SLOT = 0x4910fdfa16fed3260ed0e7147f7cc6da11a60208b5b9406d12a635614ffd9143;\n\n /**\n * @dev Storage slot with the address of the current implementation.\n * This is the keccak-256 hash of \"eip1967.proxy.implementation\" subtracted by 1, and is\n * validated in the constructor.\n */\n bytes32 internal constant _IMPLEMENTATION_SLOT = 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc;\n\n function __ERC1967Upgrade_init() internal onlyInitializing {\n }\n\n function __ERC1967Upgrade_init_unchained() internal onlyInitializing {\n }\n /**\n * @dev Returns the current implementation address.\n */\n function _getImplementation() internal view returns (address) {\n return StorageSlotUpgradeable.getAddressSlot(_IMPLEMENTATION_SLOT).value;\n }\n\n /**\n * @dev Stores a new address in the EIP1967 implementation slot.\n */\n function _setImplementation(address newImplementation) private {\n require(AddressUpgradeable.isContract(newImplementation), \"ERC1967: new implementation is not a contract\");\n StorageSlotUpgradeable.getAddressSlot(_IMPLEMENTATION_SLOT).value = newImplementation;\n }\n\n /**\n * @dev Perform implementation upgrade\n *\n * Emits an {Upgraded} event.\n */\n function _upgradeTo(address newImplementation) internal {\n _setImplementation(newImplementation);\n emit Upgraded(newImplementation);\n }\n\n /**\n * @dev Perform implementation upgrade with additional setup call.\n *\n * Emits an {Upgraded} event.\n */\n function _upgradeToAndCall(address newImplementation, bytes memory data, bool forceCall) internal {\n _upgradeTo(newImplementation);\n if (data.length > 0 || forceCall) {\n AddressUpgradeable.functionDelegateCall(newImplementation, data);\n }\n }\n\n /**\n * @dev Perform implementation upgrade with security checks for UUPS proxies, and additional setup call.\n *\n * Emits an {Upgraded} event.\n */\n function _upgradeToAndCallUUPS(address newImplementation, bytes memory data, bool forceCall) internal {\n // Upgrades from old implementations will perform a rollback test. This test requires the new\n // implementation to upgrade back to the old, non-ERC1822 compliant, implementation. Removing\n // this special case will break upgrade paths from old UUPS implementation to new ones.\n if (StorageSlotUpgradeable.getBooleanSlot(_ROLLBACK_SLOT).value) {\n _setImplementation(newImplementation);\n } else {\n try IERC1822ProxiableUpgradeable(newImplementation).proxiableUUID() returns (bytes32 slot) {\n require(slot == _IMPLEMENTATION_SLOT, \"ERC1967Upgrade: unsupported proxiableUUID\");\n } catch {\n revert(\"ERC1967Upgrade: new implementation is not UUPS\");\n }\n _upgradeToAndCall(newImplementation, data, forceCall);\n }\n }\n\n /**\n * @dev Storage slot with the admin of the contract.\n * This is the keccak-256 hash of \"eip1967.proxy.admin\" subtracted by 1, and is\n * validated in the constructor.\n */\n bytes32 internal constant _ADMIN_SLOT = 0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103;\n\n /**\n * @dev Returns the current admin.\n */\n function _getAdmin() internal view returns (address) {\n return StorageSlotUpgradeable.getAddressSlot(_ADMIN_SLOT).value;\n }\n\n /**\n * @dev Stores a new address in the EIP1967 admin slot.\n */\n function _setAdmin(address newAdmin) private {\n require(newAdmin != address(0), \"ERC1967: new admin is the zero address\");\n StorageSlotUpgradeable.getAddressSlot(_ADMIN_SLOT).value = newAdmin;\n }\n\n /**\n * @dev Changes the admin of the proxy.\n *\n * Emits an {AdminChanged} event.\n */\n function _changeAdmin(address newAdmin) internal {\n emit AdminChanged(_getAdmin(), newAdmin);\n _setAdmin(newAdmin);\n }\n\n /**\n * @dev The storage slot of the UpgradeableBeacon contract which defines the implementation for this proxy.\n * This is bytes32(uint256(keccak256('eip1967.proxy.beacon')) - 1)) and is validated in the constructor.\n */\n bytes32 internal constant _BEACON_SLOT = 0xa3f0ad74e5423aebfd80d3ef4346578335a9a72aeaee59ff6cb3582b35133d50;\n\n /**\n * @dev Returns the current beacon.\n */\n function _getBeacon() internal view returns (address) {\n return StorageSlotUpgradeable.getAddressSlot(_BEACON_SLOT).value;\n }\n\n /**\n * @dev Stores a new beacon in the EIP1967 beacon slot.\n */\n function _setBeacon(address newBeacon) private {\n require(AddressUpgradeable.isContract(newBeacon), \"ERC1967: new beacon is not a contract\");\n require(\n AddressUpgradeable.isContract(IBeaconUpgradeable(newBeacon).implementation()),\n \"ERC1967: beacon implementation is not a contract\"\n );\n StorageSlotUpgradeable.getAddressSlot(_BEACON_SLOT).value = newBeacon;\n }\n\n /**\n * @dev Perform beacon upgrade with additional setup call. Note: This upgrades the address of the beacon, it does\n * not upgrade the implementation contained in the beacon (see {UpgradeableBeacon-_setImplementation} for that).\n *\n * Emits a {BeaconUpgraded} event.\n */\n function _upgradeBeaconToAndCall(address newBeacon, bytes memory data, bool forceCall) internal {\n _setBeacon(newBeacon);\n emit BeaconUpgraded(newBeacon);\n if (data.length > 0 || forceCall) {\n AddressUpgradeable.functionDelegateCall(IBeaconUpgradeable(newBeacon).implementation(), data);\n }\n }\n\n /**\n * @dev This empty reserved space is put in place to allow future versions to add new\n * variables without shifting down storage in the inheritance chain.\n * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps\n */\n uint256[50] private __gap;\n}\n"
+ },
+ "@openzeppelin/contracts-upgradeable/proxy/utils/Initializable.sol": {
+ "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (proxy/utils/Initializable.sol)\n\npragma solidity ^0.8.2;\n\nimport \"../../utils/AddressUpgradeable.sol\";\n\n/**\n * @dev This is a base contract to aid in writing upgradeable contracts, or any kind of contract that will be deployed\n * behind a proxy. Since proxied contracts do not make use of a constructor, it's common to move constructor logic to an\n * external initializer function, usually called `initialize`. It then becomes necessary to protect this initializer\n * function so it can only be called once. The {initializer} modifier provided by this contract will have this effect.\n *\n * The initialization functions use a version number. Once a version number is used, it is consumed and cannot be\n * reused. This mechanism prevents re-execution of each \"step\" but allows the creation of new initialization steps in\n * case an upgrade adds a module that needs to be initialized.\n *\n * For example:\n *\n * [.hljs-theme-light.nopadding]\n * ```solidity\n * contract MyToken is ERC20Upgradeable {\n * function initialize() initializer public {\n * __ERC20_init(\"MyToken\", \"MTK\");\n * }\n * }\n *\n * contract MyTokenV2 is MyToken, ERC20PermitUpgradeable {\n * function initializeV2() reinitializer(2) public {\n * __ERC20Permit_init(\"MyToken\");\n * }\n * }\n * ```\n *\n * TIP: To avoid leaving the proxy in an uninitialized state, the initializer function should be called as early as\n * possible by providing the encoded function call as the `_data` argument to {ERC1967Proxy-constructor}.\n *\n * CAUTION: When used with inheritance, manual care must be taken to not invoke a parent initializer twice, or to ensure\n * that all initializers are idempotent. This is not verified automatically as constructors are by Solidity.\n *\n * [CAUTION]\n * ====\n * Avoid leaving a contract uninitialized.\n *\n * An uninitialized contract can be taken over by an attacker. This applies to both a proxy and its implementation\n * contract, which may impact the proxy. To prevent the implementation contract from being used, you should invoke\n * the {_disableInitializers} function in the constructor to automatically lock it when it is deployed:\n *\n * [.hljs-theme-light.nopadding]\n * ```\n * /// @custom:oz-upgrades-unsafe-allow constructor\n * constructor() {\n * _disableInitializers();\n * }\n * ```\n * ====\n */\nabstract contract Initializable {\n /**\n * @dev Indicates that the contract has been initialized.\n * @custom:oz-retyped-from bool\n */\n uint8 private _initialized;\n\n /**\n * @dev Indicates that the contract is in the process of being initialized.\n */\n bool private _initializing;\n\n /**\n * @dev Triggered when the contract has been initialized or reinitialized.\n */\n event Initialized(uint8 version);\n\n /**\n * @dev A modifier that defines a protected initializer function that can be invoked at most once. In its scope,\n * `onlyInitializing` functions can be used to initialize parent contracts.\n *\n * Similar to `reinitializer(1)`, except that functions marked with `initializer` can be nested in the context of a\n * constructor.\n *\n * Emits an {Initialized} event.\n */\n modifier initializer() {\n bool isTopLevelCall = !_initializing;\n require(\n (isTopLevelCall && _initialized < 1) || (!AddressUpgradeable.isContract(address(this)) && _initialized == 1),\n \"Initializable: contract is already initialized\"\n );\n _initialized = 1;\n if (isTopLevelCall) {\n _initializing = true;\n }\n _;\n if (isTopLevelCall) {\n _initializing = false;\n emit Initialized(1);\n }\n }\n\n /**\n * @dev A modifier that defines a protected reinitializer function that can be invoked at most once, and only if the\n * contract hasn't been initialized to a greater version before. In its scope, `onlyInitializing` functions can be\n * used to initialize parent contracts.\n *\n * A reinitializer may be used after the original initialization step. This is essential to configure modules that\n * are added through upgrades and that require initialization.\n *\n * When `version` is 1, this modifier is similar to `initializer`, except that functions marked with `reinitializer`\n * cannot be nested. If one is invoked in the context of another, execution will revert.\n *\n * Note that versions can jump in increments greater than 1; this implies that if multiple reinitializers coexist in\n * a contract, executing them in the right order is up to the developer or operator.\n *\n * WARNING: setting the version to 255 will prevent any future reinitialization.\n *\n * Emits an {Initialized} event.\n */\n modifier reinitializer(uint8 version) {\n require(!_initializing && _initialized < version, \"Initializable: contract is already initialized\");\n _initialized = version;\n _initializing = true;\n _;\n _initializing = false;\n emit Initialized(version);\n }\n\n /**\n * @dev Modifier to protect an initialization function so that it can only be invoked by functions with the\n * {initializer} and {reinitializer} modifiers, directly or indirectly.\n */\n modifier onlyInitializing() {\n require(_initializing, \"Initializable: contract is not initializing\");\n _;\n }\n\n /**\n * @dev Locks the contract, preventing any future reinitialization. This cannot be part of an initializer call.\n * Calling this in the constructor of a contract will prevent that contract from being initialized or reinitialized\n * to any version. It is recommended to use this to lock implementation contracts that are designed to be called\n * through proxies.\n *\n * Emits an {Initialized} event the first time it is successfully executed.\n */\n function _disableInitializers() internal virtual {\n require(!_initializing, \"Initializable: contract is initializing\");\n if (_initialized != type(uint8).max) {\n _initialized = type(uint8).max;\n emit Initialized(type(uint8).max);\n }\n }\n\n /**\n * @dev Returns the highest version that has been initialized. See {reinitializer}.\n */\n function _getInitializedVersion() internal view returns (uint8) {\n return _initialized;\n }\n\n /**\n * @dev Returns `true` if the contract is currently initializing. See {onlyInitializing}.\n */\n function _isInitializing() internal view returns (bool) {\n return _initializing;\n }\n}\n"
+ },
+ "@openzeppelin/contracts-upgradeable/proxy/utils/UUPSUpgradeable.sol": {
+ "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (proxy/utils/UUPSUpgradeable.sol)\n\npragma solidity ^0.8.0;\n\nimport \"../../interfaces/draft-IERC1822Upgradeable.sol\";\nimport \"../ERC1967/ERC1967UpgradeUpgradeable.sol\";\nimport {Initializable} from \"./Initializable.sol\";\n\n/**\n * @dev An upgradeability mechanism designed for UUPS proxies. The functions included here can perform an upgrade of an\n * {ERC1967Proxy}, when this contract is set as the implementation behind such a proxy.\n *\n * A security mechanism ensures that an upgrade does not turn off upgradeability accidentally, although this risk is\n * reinstated if the upgrade retains upgradeability but removes the security mechanism, e.g. by replacing\n * `UUPSUpgradeable` with a custom implementation of upgrades.\n *\n * The {_authorizeUpgrade} function must be overridden to include access restriction to the upgrade mechanism.\n *\n * _Available since v4.1._\n */\nabstract contract UUPSUpgradeable is Initializable, IERC1822ProxiableUpgradeable, ERC1967UpgradeUpgradeable {\n /// @custom:oz-upgrades-unsafe-allow state-variable-immutable state-variable-assignment\n address private immutable __self = address(this);\n\n /**\n * @dev Check that the execution is being performed through a delegatecall call and that the execution context is\n * a proxy contract with an implementation (as defined in ERC1967) pointing to self. This should only be the case\n * for UUPS and transparent proxies that are using the current contract as their implementation. Execution of a\n * function through ERC1167 minimal proxies (clones) would not normally pass this test, but is not guaranteed to\n * fail.\n */\n modifier onlyProxy() {\n require(address(this) != __self, \"Function must be called through delegatecall\");\n require(_getImplementation() == __self, \"Function must be called through active proxy\");\n _;\n }\n\n /**\n * @dev Check that the execution is not being performed through a delegate call. This allows a function to be\n * callable on the implementing contract but not through proxies.\n */\n modifier notDelegated() {\n require(address(this) == __self, \"UUPSUpgradeable: must not be called through delegatecall\");\n _;\n }\n\n function __UUPSUpgradeable_init() internal onlyInitializing {\n }\n\n function __UUPSUpgradeable_init_unchained() internal onlyInitializing {\n }\n /**\n * @dev Implementation of the ERC1822 {proxiableUUID} function. This returns the storage slot used by the\n * implementation. It is used to validate the implementation's compatibility when performing an upgrade.\n *\n * IMPORTANT: A proxy pointing at a proxiable contract should not be considered proxiable itself, because this risks\n * bricking a proxy that upgrades to it, by delegating to itself until out of gas. Thus it is critical that this\n * function revert if invoked through a proxy. This is guaranteed by the `notDelegated` modifier.\n */\n function proxiableUUID() external view virtual override notDelegated returns (bytes32) {\n return _IMPLEMENTATION_SLOT;\n }\n\n /**\n * @dev Upgrade the implementation of the proxy to `newImplementation`.\n *\n * Calls {_authorizeUpgrade}.\n *\n * Emits an {Upgraded} event.\n *\n * @custom:oz-upgrades-unsafe-allow-reachable delegatecall\n */\n function upgradeTo(address newImplementation) public virtual onlyProxy {\n _authorizeUpgrade(newImplementation);\n _upgradeToAndCallUUPS(newImplementation, new bytes(0), false);\n }\n\n /**\n * @dev Upgrade the implementation of the proxy to `newImplementation`, and subsequently execute the function call\n * encoded in `data`.\n *\n * Calls {_authorizeUpgrade}.\n *\n * Emits an {Upgraded} event.\n *\n * @custom:oz-upgrades-unsafe-allow-reachable delegatecall\n */\n function upgradeToAndCall(address newImplementation, bytes memory data) public payable virtual onlyProxy {\n _authorizeUpgrade(newImplementation);\n _upgradeToAndCallUUPS(newImplementation, data, true);\n }\n\n /**\n * @dev Function that should revert when `msg.sender` is not authorized to upgrade the contract. Called by\n * {upgradeTo} and {upgradeToAndCall}.\n *\n * Normally, this function will use an xref:access.adoc[access control] modifier such as {Ownable-onlyOwner}.\n *\n * ```solidity\n * function _authorizeUpgrade(address) internal override onlyOwner {}\n * ```\n */\n function _authorizeUpgrade(address newImplementation) internal virtual;\n\n /**\n * @dev This empty reserved space is put in place to allow future versions to add new\n * variables without shifting down storage in the inheritance chain.\n * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps\n */\n uint256[50] private __gap;\n}\n"
+ },
+ "@openzeppelin/contracts-upgradeable/security/ReentrancyGuardUpgradeable.sol": {
+ "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (security/ReentrancyGuard.sol)\n\npragma solidity ^0.8.0;\nimport {Initializable} from \"../proxy/utils/Initializable.sol\";\n\n/**\n * @dev Contract module that helps prevent reentrant calls to a function.\n *\n * Inheriting from `ReentrancyGuard` will make the {nonReentrant} modifier\n * available, which can be applied to functions to make sure there are no nested\n * (reentrant) calls to them.\n *\n * Note that because there is a single `nonReentrant` guard, functions marked as\n * `nonReentrant` may not call one another. This can be worked around by making\n * those functions `private`, and then adding `external` `nonReentrant` entry\n * points to them.\n *\n * TIP: If you would like to learn more about reentrancy and alternative ways\n * to protect against it, check out our blog post\n * https://blog.openzeppelin.com/reentrancy-after-istanbul/[Reentrancy After Istanbul].\n */\nabstract contract ReentrancyGuardUpgradeable is Initializable {\n // Booleans are more expensive than uint256 or any type that takes up a full\n // word because each write operation emits an extra SLOAD to first read the\n // slot's contents, replace the bits taken up by the boolean, and then write\n // back. This is the compiler's defense against contract upgrades and\n // pointer aliasing, and it cannot be disabled.\n\n // The values being non-zero value makes deployment a bit more expensive,\n // but in exchange the refund on every call to nonReentrant will be lower in\n // amount. Since refunds are capped to a percentage of the total\n // transaction's gas, it is best to keep them low in cases like this one, to\n // increase the likelihood of the full refund coming into effect.\n uint256 private constant _NOT_ENTERED = 1;\n uint256 private constant _ENTERED = 2;\n\n uint256 private _status;\n\n function __ReentrancyGuard_init() internal onlyInitializing {\n __ReentrancyGuard_init_unchained();\n }\n\n function __ReentrancyGuard_init_unchained() internal onlyInitializing {\n _status = _NOT_ENTERED;\n }\n\n /**\n * @dev Prevents a contract from calling itself, directly or indirectly.\n * Calling a `nonReentrant` function from another `nonReentrant`\n * function is not supported. It is possible to prevent this from happening\n * by making the `nonReentrant` function external, and making it call a\n * `private` function that does the actual work.\n */\n modifier nonReentrant() {\n _nonReentrantBefore();\n _;\n _nonReentrantAfter();\n }\n\n function _nonReentrantBefore() private {\n // On the first call to nonReentrant, _status will be _NOT_ENTERED\n require(_status != _ENTERED, \"ReentrancyGuard: reentrant call\");\n\n // Any calls to nonReentrant after this point will fail\n _status = _ENTERED;\n }\n\n function _nonReentrantAfter() private {\n // By storing the original value once again, a refund is triggered (see\n // https://eips.ethereum.org/EIPS/eip-2200)\n _status = _NOT_ENTERED;\n }\n\n /**\n * @dev Returns true if the reentrancy guard is currently set to \"entered\", which indicates there is a\n * `nonReentrant` function in the call stack.\n */\n function _reentrancyGuardEntered() internal view returns (bool) {\n return _status == _ENTERED;\n }\n\n /**\n * @dev This empty reserved space is put in place to allow future versions to add new\n * variables without shifting down storage in the inheritance chain.\n * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps\n */\n uint256[49] private __gap;\n}\n"
+ },
+ "@openzeppelin/contracts-upgradeable/token/ERC20/extensions/IERC20PermitUpgradeable.sol": {
+ "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.4) (token/ERC20/extensions/IERC20Permit.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @dev Interface of the ERC20 Permit extension allowing approvals to be made via signatures, as defined in\n * https://eips.ethereum.org/EIPS/eip-2612[EIP-2612].\n *\n * Adds the {permit} method, which can be used to change an account's ERC20 allowance (see {IERC20-allowance}) by\n * presenting a message signed by the account. By not relying on {IERC20-approve}, the token holder account doesn't\n * need to send a transaction, and thus is not required to hold Ether at all.\n *\n * ==== Security Considerations\n *\n * There are two important considerations concerning the use of `permit`. The first is that a valid permit signature\n * expresses an allowance, and it should not be assumed to convey additional meaning. In particular, it should not be\n * considered as an intention to spend the allowance in any specific way. The second is that because permits have\n * built-in replay protection and can be submitted by anyone, they can be frontrun. A protocol that uses permits should\n * take this into consideration and allow a `permit` call to fail. Combining these two aspects, a pattern that may be\n * generally recommended is:\n *\n * ```solidity\n * function doThingWithPermit(..., uint256 value, uint256 deadline, uint8 v, bytes32 r, bytes32 s) public {\n * try token.permit(msg.sender, address(this), value, deadline, v, r, s) {} catch {}\n * doThing(..., value);\n * }\n *\n * function doThing(..., uint256 value) public {\n * token.safeTransferFrom(msg.sender, address(this), value);\n * ...\n * }\n * ```\n *\n * Observe that: 1) `msg.sender` is used as the owner, leaving no ambiguity as to the signer intent, and 2) the use of\n * `try/catch` allows the permit to fail and makes the code tolerant to frontrunning. (See also\n * {SafeERC20-safeTransferFrom}).\n *\n * Additionally, note that smart contract wallets (such as Argent or Safe) are not able to produce permit signatures, so\n * contracts should have entry points that don't rely on permit.\n */\ninterface IERC20PermitUpgradeable {\n /**\n * @dev Sets `value` as the allowance of `spender` over ``owner``'s tokens,\n * given ``owner``'s signed approval.\n *\n * IMPORTANT: The same issues {IERC20-approve} has related to transaction\n * ordering also apply here.\n *\n * Emits an {Approval} event.\n *\n * Requirements:\n *\n * - `spender` cannot be the zero address.\n * - `deadline` must be a timestamp in the future.\n * - `v`, `r` and `s` must be a valid `secp256k1` signature from `owner`\n * over the EIP712-formatted function arguments.\n * - the signature must use ``owner``'s current nonce (see {nonces}).\n *\n * For more information on the signature format, see the\n * https://eips.ethereum.org/EIPS/eip-2612#specification[relevant EIP\n * section].\n *\n * CAUTION: See Security Considerations above.\n */\n function permit(\n address owner,\n address spender,\n uint256 value,\n uint256 deadline,\n uint8 v,\n bytes32 r,\n bytes32 s\n ) external;\n\n /**\n * @dev Returns the current nonce for `owner`. This value must be\n * included whenever a signature is generated for {permit}.\n *\n * Every successful call to {permit} increases ``owner``'s nonce by one. This\n * prevents a signature from being used multiple times.\n */\n function nonces(address owner) external view returns (uint256);\n\n /**\n * @dev Returns the domain separator used in the encoding of the signature for {permit}, as defined by {EIP712}.\n */\n // solhint-disable-next-line func-name-mixedcase\n function DOMAIN_SEPARATOR() external view returns (bytes32);\n}\n"
+ },
+ "@openzeppelin/contracts-upgradeable/token/ERC20/IERC20Upgradeable.sol": {
+ "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (token/ERC20/IERC20.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @dev Interface of the ERC20 standard as defined in the EIP.\n */\ninterface IERC20Upgradeable {\n /**\n * @dev Emitted when `value` tokens are moved from one account (`from`) to\n * another (`to`).\n *\n * Note that `value` may be zero.\n */\n event Transfer(address indexed from, address indexed to, uint256 value);\n\n /**\n * @dev Emitted when the allowance of a `spender` for an `owner` is set by\n * a call to {approve}. `value` is the new allowance.\n */\n event Approval(address indexed owner, address indexed spender, uint256 value);\n\n /**\n * @dev Returns the amount of tokens in existence.\n */\n function totalSupply() external view returns (uint256);\n\n /**\n * @dev Returns the amount of tokens owned by `account`.\n */\n function balanceOf(address account) external view returns (uint256);\n\n /**\n * @dev Moves `amount` tokens from the caller's account to `to`.\n *\n * Returns a boolean value indicating whether the operation succeeded.\n *\n * Emits a {Transfer} event.\n */\n function transfer(address to, uint256 amount) external returns (bool);\n\n /**\n * @dev Returns the remaining number of tokens that `spender` will be\n * allowed to spend on behalf of `owner` through {transferFrom}. This is\n * zero by default.\n *\n * This value changes when {approve} or {transferFrom} are called.\n */\n function allowance(address owner, address spender) external view returns (uint256);\n\n /**\n * @dev Sets `amount` as the allowance of `spender` over the caller's tokens.\n *\n * Returns a boolean value indicating whether the operation succeeded.\n *\n * IMPORTANT: Beware that changing an allowance with this method brings the risk\n * that someone may use both the old and the new allowance by unfortunate\n * transaction ordering. One possible solution to mitigate this race\n * condition is to first reduce the spender's allowance to 0 and set the\n * desired value afterwards:\n * https://github.com/ethereum/EIPs/issues/20#issuecomment-263524729\n *\n * Emits an {Approval} event.\n */\n function approve(address spender, uint256 amount) external returns (bool);\n\n /**\n * @dev Moves `amount` tokens from `from` to `to` using the\n * allowance mechanism. `amount` is then deducted from the caller's\n * allowance.\n *\n * Returns a boolean value indicating whether the operation succeeded.\n *\n * Emits a {Transfer} event.\n */\n function transferFrom(address from, address to, uint256 amount) external returns (bool);\n}\n"
+ },
+ "@openzeppelin/contracts-upgradeable/token/ERC20/utils/SafeERC20Upgradeable.sol": {
+ "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.3) (token/ERC20/utils/SafeERC20.sol)\n\npragma solidity ^0.8.0;\n\nimport \"../IERC20Upgradeable.sol\";\nimport \"../extensions/IERC20PermitUpgradeable.sol\";\nimport \"../../../utils/AddressUpgradeable.sol\";\n\n/**\n * @title SafeERC20\n * @dev Wrappers around ERC20 operations that throw on failure (when the token\n * contract returns false). Tokens that return no value (and instead revert or\n * throw on failure) are also supported, non-reverting calls are assumed to be\n * successful.\n * To use this library you can add a `using SafeERC20 for IERC20;` statement to your contract,\n * which allows you to call the safe operations as `token.safeTransfer(...)`, etc.\n */\nlibrary SafeERC20Upgradeable {\n using AddressUpgradeable for address;\n\n /**\n * @dev Transfer `value` amount of `token` from the calling contract to `to`. If `token` returns no value,\n * non-reverting calls are assumed to be successful.\n */\n function safeTransfer(IERC20Upgradeable token, address to, uint256 value) internal {\n _callOptionalReturn(token, abi.encodeWithSelector(token.transfer.selector, to, value));\n }\n\n /**\n * @dev Transfer `value` amount of `token` from `from` to `to`, spending the approval given by `from` to the\n * calling contract. If `token` returns no value, non-reverting calls are assumed to be successful.\n */\n function safeTransferFrom(IERC20Upgradeable token, address from, address to, uint256 value) internal {\n _callOptionalReturn(token, abi.encodeWithSelector(token.transferFrom.selector, from, to, value));\n }\n\n /**\n * @dev Deprecated. This function has issues similar to the ones found in\n * {IERC20-approve}, and its usage is discouraged.\n *\n * Whenever possible, use {safeIncreaseAllowance} and\n * {safeDecreaseAllowance} instead.\n */\n function safeApprove(IERC20Upgradeable token, address spender, uint256 value) internal {\n // safeApprove should only be called when setting an initial allowance,\n // or when resetting it to zero. To increase and decrease it, use\n // 'safeIncreaseAllowance' and 'safeDecreaseAllowance'\n require(\n (value == 0) || (token.allowance(address(this), spender) == 0),\n \"SafeERC20: approve from non-zero to non-zero allowance\"\n );\n _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, value));\n }\n\n /**\n * @dev Increase the calling contract's allowance toward `spender` by `value`. If `token` returns no value,\n * non-reverting calls are assumed to be successful.\n */\n function safeIncreaseAllowance(IERC20Upgradeable token, address spender, uint256 value) internal {\n uint256 oldAllowance = token.allowance(address(this), spender);\n _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, oldAllowance + value));\n }\n\n /**\n * @dev Decrease the calling contract's allowance toward `spender` by `value`. If `token` returns no value,\n * non-reverting calls are assumed to be successful.\n */\n function safeDecreaseAllowance(IERC20Upgradeable token, address spender, uint256 value) internal {\n unchecked {\n uint256 oldAllowance = token.allowance(address(this), spender);\n require(oldAllowance >= value, \"SafeERC20: decreased allowance below zero\");\n _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, oldAllowance - value));\n }\n }\n\n /**\n * @dev Set the calling contract's allowance toward `spender` to `value`. If `token` returns no value,\n * non-reverting calls are assumed to be successful. Meant to be used with tokens that require the approval\n * to be set to zero before setting it to a non-zero value, such as USDT.\n */\n function forceApprove(IERC20Upgradeable token, address spender, uint256 value) internal {\n bytes memory approvalCall = abi.encodeWithSelector(token.approve.selector, spender, value);\n\n if (!_callOptionalReturnBool(token, approvalCall)) {\n _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, 0));\n _callOptionalReturn(token, approvalCall);\n }\n }\n\n /**\n * @dev Use a ERC-2612 signature to set the `owner` approval toward `spender` on `token`.\n * Revert on invalid signature.\n */\n function safePermit(\n IERC20PermitUpgradeable token,\n address owner,\n address spender,\n uint256 value,\n uint256 deadline,\n uint8 v,\n bytes32 r,\n bytes32 s\n ) internal {\n uint256 nonceBefore = token.nonces(owner);\n token.permit(owner, spender, value, deadline, v, r, s);\n uint256 nonceAfter = token.nonces(owner);\n require(nonceAfter == nonceBefore + 1, \"SafeERC20: permit did not succeed\");\n }\n\n /**\n * @dev Imitates a Solidity high-level call (i.e. a regular function call to a contract), relaxing the requirement\n * on the return value: the return value is optional (but if data is returned, it must not be false).\n * @param token The token targeted by the call.\n * @param data The call data (encoded using abi.encode or one of its variants).\n */\n function _callOptionalReturn(IERC20Upgradeable token, bytes memory data) private {\n // We need to perform a low level call here, to bypass Solidity's return data size checking mechanism, since\n // we're implementing it ourselves. We use {Address-functionCall} to perform this call, which verifies that\n // the target address contains contract code and also asserts for success in the low-level call.\n\n bytes memory returndata = address(token).functionCall(data, \"SafeERC20: low-level call failed\");\n require(returndata.length == 0 || abi.decode(returndata, (bool)), \"SafeERC20: ERC20 operation did not succeed\");\n }\n\n /**\n * @dev Imitates a Solidity high-level call (i.e. a regular function call to a contract), relaxing the requirement\n * on the return value: the return value is optional (but if data is returned, it must not be false).\n * @param token The token targeted by the call.\n * @param data The call data (encoded using abi.encode or one of its variants).\n *\n * This is a variant of {_callOptionalReturn} that silents catches all reverts and returns a bool instead.\n */\n function _callOptionalReturnBool(IERC20Upgradeable token, bytes memory data) private returns (bool) {\n // We need to perform a low level call here, to bypass Solidity's return data size checking mechanism, since\n // we're implementing it ourselves. We cannot use {Address-functionCall} here since this should return false\n // and not revert is the subcall reverts.\n\n (bool success, bytes memory returndata) = address(token).call(data);\n return\n success && (returndata.length == 0 || abi.decode(returndata, (bool))) && AddressUpgradeable.isContract(address(token));\n }\n}\n"
+ },
+ "@openzeppelin/contracts-upgradeable/utils/AddressUpgradeable.sol": {
+ "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (utils/Address.sol)\n\npragma solidity ^0.8.1;\n\n/**\n * @dev Collection of functions related to the address type\n */\nlibrary AddressUpgradeable {\n /**\n * @dev Returns true if `account` is a contract.\n *\n * [IMPORTANT]\n * ====\n * It is unsafe to assume that an address for which this function returns\n * false is an externally-owned account (EOA) and not a contract.\n *\n * Among others, `isContract` will return false for the following\n * types of addresses:\n *\n * - an externally-owned account\n * - a contract in construction\n * - an address where a contract will be created\n * - an address where a contract lived, but was destroyed\n *\n * Furthermore, `isContract` will also return true if the target contract within\n * the same transaction is already scheduled for destruction by `SELFDESTRUCT`,\n * which only has an effect at the end of a transaction.\n * ====\n *\n * [IMPORTANT]\n * ====\n * You shouldn't rely on `isContract` to protect against flash loan attacks!\n *\n * Preventing calls from contracts is highly discouraged. It breaks composability, breaks support for smart wallets\n * like Gnosis Safe, and does not provide security since it can be circumvented by calling from a contract\n * constructor.\n * ====\n */\n function isContract(address account) internal view returns (bool) {\n // This method relies on extcodesize/address.code.length, which returns 0\n // for contracts in construction, since the code is only stored at the end\n // of the constructor execution.\n\n return account.code.length > 0;\n }\n\n /**\n * @dev Replacement for Solidity's `transfer`: sends `amount` wei to\n * `recipient`, forwarding all available gas and reverting on errors.\n *\n * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost\n * of certain opcodes, possibly making contracts go over the 2300 gas limit\n * imposed by `transfer`, making them unable to receive funds via\n * `transfer`. {sendValue} removes this limitation.\n *\n * https://consensys.net/diligence/blog/2019/09/stop-using-soliditys-transfer-now/[Learn more].\n *\n * IMPORTANT: because control is transferred to `recipient`, care must be\n * taken to not create reentrancy vulnerabilities. Consider using\n * {ReentrancyGuard} or the\n * https://solidity.readthedocs.io/en/v0.8.0/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].\n */\n function sendValue(address payable recipient, uint256 amount) internal {\n require(address(this).balance >= amount, \"Address: insufficient balance\");\n\n (bool success, ) = recipient.call{value: amount}(\"\");\n require(success, \"Address: unable to send value, recipient may have reverted\");\n }\n\n /**\n * @dev Performs a Solidity function call using a low level `call`. A\n * plain `call` is an unsafe replacement for a function call: use this\n * function instead.\n *\n * If `target` reverts with a revert reason, it is bubbled up by this\n * function (like regular Solidity function calls).\n *\n * Returns the raw returned data. To convert to the expected return value,\n * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].\n *\n * Requirements:\n *\n * - `target` must be a contract.\n * - calling `target` with `data` must not revert.\n *\n * _Available since v3.1._\n */\n function functionCall(address target, bytes memory data) internal returns (bytes memory) {\n return functionCallWithValue(target, data, 0, \"Address: low-level call failed\");\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with\n * `errorMessage` as a fallback revert reason when `target` reverts.\n *\n * _Available since v3.1._\n */\n function functionCall(\n address target,\n bytes memory data,\n string memory errorMessage\n ) internal returns (bytes memory) {\n return functionCallWithValue(target, data, 0, errorMessage);\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\n * but also transferring `value` wei to `target`.\n *\n * Requirements:\n *\n * - the calling contract must have an ETH balance of at least `value`.\n * - the called Solidity function must be `payable`.\n *\n * _Available since v3.1._\n */\n function functionCallWithValue(address target, bytes memory data, uint256 value) internal returns (bytes memory) {\n return functionCallWithValue(target, data, value, \"Address: low-level call with value failed\");\n }\n\n /**\n * @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but\n * with `errorMessage` as a fallback revert reason when `target` reverts.\n *\n * _Available since v3.1._\n */\n function functionCallWithValue(\n address target,\n bytes memory data,\n uint256 value,\n string memory errorMessage\n ) internal returns (bytes memory) {\n require(address(this).balance >= value, \"Address: insufficient balance for call\");\n (bool success, bytes memory returndata) = target.call{value: value}(data);\n return verifyCallResultFromTarget(target, success, returndata, errorMessage);\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\n * but performing a static call.\n *\n * _Available since v3.3._\n */\n function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {\n return functionStaticCall(target, data, \"Address: low-level static call failed\");\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],\n * but performing a static call.\n *\n * _Available since v3.3._\n */\n function functionStaticCall(\n address target,\n bytes memory data,\n string memory errorMessage\n ) internal view returns (bytes memory) {\n (bool success, bytes memory returndata) = target.staticcall(data);\n return verifyCallResultFromTarget(target, success, returndata, errorMessage);\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\n * but performing a delegate call.\n *\n * _Available since v3.4._\n */\n function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) {\n return functionDelegateCall(target, data, \"Address: low-level delegate call failed\");\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],\n * but performing a delegate call.\n *\n * _Available since v3.4._\n */\n function functionDelegateCall(\n address target,\n bytes memory data,\n string memory errorMessage\n ) internal returns (bytes memory) {\n (bool success, bytes memory returndata) = target.delegatecall(data);\n return verifyCallResultFromTarget(target, success, returndata, errorMessage);\n }\n\n /**\n * @dev Tool to verify that a low level call to smart-contract was successful, and revert (either by bubbling\n * the revert reason or using the provided one) in case of unsuccessful call or if target was not a contract.\n *\n * _Available since v4.8._\n */\n function verifyCallResultFromTarget(\n address target,\n bool success,\n bytes memory returndata,\n string memory errorMessage\n ) internal view returns (bytes memory) {\n if (success) {\n if (returndata.length == 0) {\n // only check isContract if the call was successful and the return data is empty\n // otherwise we already know that it was a contract\n require(isContract(target), \"Address: call to non-contract\");\n }\n return returndata;\n } else {\n _revert(returndata, errorMessage);\n }\n }\n\n /**\n * @dev Tool to verify that a low level call was successful, and revert if it wasn't, either by bubbling the\n * revert reason or using the provided one.\n *\n * _Available since v4.3._\n */\n function verifyCallResult(\n bool success,\n bytes memory returndata,\n string memory errorMessage\n ) internal pure returns (bytes memory) {\n if (success) {\n return returndata;\n } else {\n _revert(returndata, errorMessage);\n }\n }\n\n function _revert(bytes memory returndata, string memory errorMessage) private pure {\n // Look for revert reason and bubble it up if present\n if (returndata.length > 0) {\n // The easiest way to bubble the revert reason is using memory via assembly\n /// @solidity memory-safe-assembly\n assembly {\n let returndata_size := mload(returndata)\n revert(add(32, returndata), returndata_size)\n }\n } else {\n revert(errorMessage);\n }\n }\n}\n"
+ },
+ "@openzeppelin/contracts-upgradeable/utils/cryptography/ECDSAUpgradeable.sol": {
+ "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (utils/cryptography/ECDSA.sol)\n\npragma solidity ^0.8.0;\n\nimport \"../StringsUpgradeable.sol\";\n\n/**\n * @dev Elliptic Curve Digital Signature Algorithm (ECDSA) operations.\n *\n * These functions can be used to verify that a message was signed by the holder\n * of the private keys of a given address.\n */\nlibrary ECDSAUpgradeable {\n enum RecoverError {\n NoError,\n InvalidSignature,\n InvalidSignatureLength,\n InvalidSignatureS,\n InvalidSignatureV // Deprecated in v4.8\n }\n\n function _throwError(RecoverError error) private pure {\n if (error == RecoverError.NoError) {\n return; // no error: do nothing\n } else if (error == RecoverError.InvalidSignature) {\n revert(\"ECDSA: invalid signature\");\n } else if (error == RecoverError.InvalidSignatureLength) {\n revert(\"ECDSA: invalid signature length\");\n } else if (error == RecoverError.InvalidSignatureS) {\n revert(\"ECDSA: invalid signature 's' value\");\n }\n }\n\n /**\n * @dev Returns the address that signed a hashed message (`hash`) with\n * `signature` or error string. This address can then be used for verification purposes.\n *\n * The `ecrecover` EVM opcode allows for malleable (non-unique) signatures:\n * this function rejects them by requiring the `s` value to be in the lower\n * half order, and the `v` value to be either 27 or 28.\n *\n * IMPORTANT: `hash` _must_ be the result of a hash operation for the\n * verification to be secure: it is possible to craft signatures that\n * recover to arbitrary addresses for non-hashed data. A safe way to ensure\n * this is by receiving a hash of the original message (which may otherwise\n * be too long), and then calling {toEthSignedMessageHash} on it.\n *\n * Documentation for signature generation:\n * - with https://web3js.readthedocs.io/en/v1.3.4/web3-eth-accounts.html#sign[Web3.js]\n * - with https://docs.ethers.io/v5/api/signer/#Signer-signMessage[ethers]\n *\n * _Available since v4.3._\n */\n function tryRecover(bytes32 hash, bytes memory signature) internal pure returns (address, RecoverError) {\n if (signature.length == 65) {\n bytes32 r;\n bytes32 s;\n uint8 v;\n // ecrecover takes the signature parameters, and the only way to get them\n // currently is to use assembly.\n /// @solidity memory-safe-assembly\n assembly {\n r := mload(add(signature, 0x20))\n s := mload(add(signature, 0x40))\n v := byte(0, mload(add(signature, 0x60)))\n }\n return tryRecover(hash, v, r, s);\n } else {\n return (address(0), RecoverError.InvalidSignatureLength);\n }\n }\n\n /**\n * @dev Returns the address that signed a hashed message (`hash`) with\n * `signature`. This address can then be used for verification purposes.\n *\n * The `ecrecover` EVM opcode allows for malleable (non-unique) signatures:\n * this function rejects them by requiring the `s` value to be in the lower\n * half order, and the `v` value to be either 27 or 28.\n *\n * IMPORTANT: `hash` _must_ be the result of a hash operation for the\n * verification to be secure: it is possible to craft signatures that\n * recover to arbitrary addresses for non-hashed data. A safe way to ensure\n * this is by receiving a hash of the original message (which may otherwise\n * be too long), and then calling {toEthSignedMessageHash} on it.\n */\n function recover(bytes32 hash, bytes memory signature) internal pure returns (address) {\n (address recovered, RecoverError error) = tryRecover(hash, signature);\n _throwError(error);\n return recovered;\n }\n\n /**\n * @dev Overload of {ECDSA-tryRecover} that receives the `r` and `vs` short-signature fields separately.\n *\n * See https://eips.ethereum.org/EIPS/eip-2098[EIP-2098 short signatures]\n *\n * _Available since v4.3._\n */\n function tryRecover(bytes32 hash, bytes32 r, bytes32 vs) internal pure returns (address, RecoverError) {\n bytes32 s = vs & bytes32(0x7fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff);\n uint8 v = uint8((uint256(vs) >> 255) + 27);\n return tryRecover(hash, v, r, s);\n }\n\n /**\n * @dev Overload of {ECDSA-recover} that receives the `r and `vs` short-signature fields separately.\n *\n * _Available since v4.2._\n */\n function recover(bytes32 hash, bytes32 r, bytes32 vs) internal pure returns (address) {\n (address recovered, RecoverError error) = tryRecover(hash, r, vs);\n _throwError(error);\n return recovered;\n }\n\n /**\n * @dev Overload of {ECDSA-tryRecover} that receives the `v`,\n * `r` and `s` signature fields separately.\n *\n * _Available since v4.3._\n */\n function tryRecover(bytes32 hash, uint8 v, bytes32 r, bytes32 s) internal pure returns (address, RecoverError) {\n // EIP-2 still allows signature malleability for ecrecover(). Remove this possibility and make the signature\n // unique. Appendix F in the Ethereum Yellow paper (https://ethereum.github.io/yellowpaper/paper.pdf), defines\n // the valid range for s in (301): 0 < s < secp256k1n ÷ 2 + 1, and for v in (302): v ∈ {27, 28}. Most\n // signatures from current libraries generate a unique signature with an s-value in the lower half order.\n //\n // If your library generates malleable signatures, such as s-values in the upper range, calculate a new s-value\n // with 0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFEBAAEDCE6AF48A03BBFD25E8CD0364141 - s1 and flip v from 27 to 28 or\n // vice versa. If your library also generates signatures with 0/1 for v instead 27/28, add 27 to v to accept\n // these malleable signatures as well.\n if (uint256(s) > 0x7FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF5D576E7357A4501DDFE92F46681B20A0) {\n return (address(0), RecoverError.InvalidSignatureS);\n }\n\n // If the signature is valid (and not malleable), return the signer address\n address signer = ecrecover(hash, v, r, s);\n if (signer == address(0)) {\n return (address(0), RecoverError.InvalidSignature);\n }\n\n return (signer, RecoverError.NoError);\n }\n\n /**\n * @dev Overload of {ECDSA-recover} that receives the `v`,\n * `r` and `s` signature fields separately.\n */\n function recover(bytes32 hash, uint8 v, bytes32 r, bytes32 s) internal pure returns (address) {\n (address recovered, RecoverError error) = tryRecover(hash, v, r, s);\n _throwError(error);\n return recovered;\n }\n\n /**\n * @dev Returns an Ethereum Signed Message, created from a `hash`. This\n * produces hash corresponding to the one signed with the\n * https://eth.wiki/json-rpc/API#eth_sign[`eth_sign`]\n * JSON-RPC method as part of EIP-191.\n *\n * See {recover}.\n */\n function toEthSignedMessageHash(bytes32 hash) internal pure returns (bytes32 message) {\n // 32 is the length in bytes of hash,\n // enforced by the type signature above\n /// @solidity memory-safe-assembly\n assembly {\n mstore(0x00, \"\\x19Ethereum Signed Message:\\n32\")\n mstore(0x1c, hash)\n message := keccak256(0x00, 0x3c)\n }\n }\n\n /**\n * @dev Returns an Ethereum Signed Message, created from `s`. This\n * produces hash corresponding to the one signed with the\n * https://eth.wiki/json-rpc/API#eth_sign[`eth_sign`]\n * JSON-RPC method as part of EIP-191.\n *\n * See {recover}.\n */\n function toEthSignedMessageHash(bytes memory s) internal pure returns (bytes32) {\n return keccak256(abi.encodePacked(\"\\x19Ethereum Signed Message:\\n\", StringsUpgradeable.toString(s.length), s));\n }\n\n /**\n * @dev Returns an Ethereum Signed Typed Data, created from a\n * `domainSeparator` and a `structHash`. This produces hash corresponding\n * to the one signed with the\n * https://eips.ethereum.org/EIPS/eip-712[`eth_signTypedData`]\n * JSON-RPC method as part of EIP-712.\n *\n * See {recover}.\n */\n function toTypedDataHash(bytes32 domainSeparator, bytes32 structHash) internal pure returns (bytes32 data) {\n /// @solidity memory-safe-assembly\n assembly {\n let ptr := mload(0x40)\n mstore(ptr, \"\\x19\\x01\")\n mstore(add(ptr, 0x02), domainSeparator)\n mstore(add(ptr, 0x22), structHash)\n data := keccak256(ptr, 0x42)\n }\n }\n\n /**\n * @dev Returns an Ethereum Signed Data with intended validator, created from a\n * `validator` and `data` according to the version 0 of EIP-191.\n *\n * See {recover}.\n */\n function toDataWithIntendedValidatorHash(address validator, bytes memory data) internal pure returns (bytes32) {\n return keccak256(abi.encodePacked(\"\\x19\\x00\", validator, data));\n }\n}\n"
+ },
+ "@openzeppelin/contracts-upgradeable/utils/math/MathUpgradeable.sol": {
+ "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (utils/math/Math.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @dev Standard math utilities missing in the Solidity language.\n */\nlibrary MathUpgradeable {\n enum Rounding {\n Down, // Toward negative infinity\n Up, // Toward infinity\n Zero // Toward zero\n }\n\n /**\n * @dev Returns the largest of two numbers.\n */\n function max(uint256 a, uint256 b) internal pure returns (uint256) {\n return a > b ? a : b;\n }\n\n /**\n * @dev Returns the smallest of two numbers.\n */\n function min(uint256 a, uint256 b) internal pure returns (uint256) {\n return a < b ? a : b;\n }\n\n /**\n * @dev Returns the average of two numbers. The result is rounded towards\n * zero.\n */\n function average(uint256 a, uint256 b) internal pure returns (uint256) {\n // (a + b) / 2 can overflow.\n return (a & b) + (a ^ b) / 2;\n }\n\n /**\n * @dev Returns the ceiling of the division of two numbers.\n *\n * This differs from standard division with `/` in that it rounds up instead\n * of rounding down.\n */\n function ceilDiv(uint256 a, uint256 b) internal pure returns (uint256) {\n // (a + b - 1) / b can overflow on addition, so we distribute.\n return a == 0 ? 0 : (a - 1) / b + 1;\n }\n\n /**\n * @notice Calculates floor(x * y / denominator) with full precision. Throws if result overflows a uint256 or denominator == 0\n * @dev Original credit to Remco Bloemen under MIT license (https://xn--2-umb.com/21/muldiv)\n * with further edits by Uniswap Labs also under MIT license.\n */\n function mulDiv(uint256 x, uint256 y, uint256 denominator) internal pure returns (uint256 result) {\n unchecked {\n // 512-bit multiply [prod1 prod0] = x * y. Compute the product mod 2^256 and mod 2^256 - 1, then use\n // use the Chinese Remainder Theorem to reconstruct the 512 bit result. The result is stored in two 256\n // variables such that product = prod1 * 2^256 + prod0.\n uint256 prod0; // Least significant 256 bits of the product\n uint256 prod1; // Most significant 256 bits of the product\n assembly {\n let mm := mulmod(x, y, not(0))\n prod0 := mul(x, y)\n prod1 := sub(sub(mm, prod0), lt(mm, prod0))\n }\n\n // Handle non-overflow cases, 256 by 256 division.\n if (prod1 == 0) {\n // Solidity will revert if denominator == 0, unlike the div opcode on its own.\n // The surrounding unchecked block does not change this fact.\n // See https://docs.soliditylang.org/en/latest/control-structures.html#checked-or-unchecked-arithmetic.\n return prod0 / denominator;\n }\n\n // Make sure the result is less than 2^256. Also prevents denominator == 0.\n require(denominator > prod1, \"Math: mulDiv overflow\");\n\n ///////////////////////////////////////////////\n // 512 by 256 division.\n ///////////////////////////////////////////////\n\n // Make division exact by subtracting the remainder from [prod1 prod0].\n uint256 remainder;\n assembly {\n // Compute remainder using mulmod.\n remainder := mulmod(x, y, denominator)\n\n // Subtract 256 bit number from 512 bit number.\n prod1 := sub(prod1, gt(remainder, prod0))\n prod0 := sub(prod0, remainder)\n }\n\n // Factor powers of two out of denominator and compute largest power of two divisor of denominator. Always >= 1.\n // See https://cs.stackexchange.com/q/138556/92363.\n\n // Does not overflow because the denominator cannot be zero at this stage in the function.\n uint256 twos = denominator & (~denominator + 1);\n assembly {\n // Divide denominator by twos.\n denominator := div(denominator, twos)\n\n // Divide [prod1 prod0] by twos.\n prod0 := div(prod0, twos)\n\n // Flip twos such that it is 2^256 / twos. If twos is zero, then it becomes one.\n twos := add(div(sub(0, twos), twos), 1)\n }\n\n // Shift in bits from prod1 into prod0.\n prod0 |= prod1 * twos;\n\n // Invert denominator mod 2^256. Now that denominator is an odd number, it has an inverse modulo 2^256 such\n // that denominator * inv = 1 mod 2^256. Compute the inverse by starting with a seed that is correct for\n // four bits. That is, denominator * inv = 1 mod 2^4.\n uint256 inverse = (3 * denominator) ^ 2;\n\n // Use the Newton-Raphson iteration to improve the precision. Thanks to Hensel's lifting lemma, this also works\n // in modular arithmetic, doubling the correct bits in each step.\n inverse *= 2 - denominator * inverse; // inverse mod 2^8\n inverse *= 2 - denominator * inverse; // inverse mod 2^16\n inverse *= 2 - denominator * inverse; // inverse mod 2^32\n inverse *= 2 - denominator * inverse; // inverse mod 2^64\n inverse *= 2 - denominator * inverse; // inverse mod 2^128\n inverse *= 2 - denominator * inverse; // inverse mod 2^256\n\n // Because the division is now exact we can divide by multiplying with the modular inverse of denominator.\n // This will give us the correct result modulo 2^256. Since the preconditions guarantee that the outcome is\n // less than 2^256, this is the final result. We don't need to compute the high bits of the result and prod1\n // is no longer required.\n result = prod0 * inverse;\n return result;\n }\n }\n\n /**\n * @notice Calculates x * y / denominator with full precision, following the selected rounding direction.\n */\n function mulDiv(uint256 x, uint256 y, uint256 denominator, Rounding rounding) internal pure returns (uint256) {\n uint256 result = mulDiv(x, y, denominator);\n if (rounding == Rounding.Up && mulmod(x, y, denominator) > 0) {\n result += 1;\n }\n return result;\n }\n\n /**\n * @dev Returns the square root of a number. If the number is not a perfect square, the value is rounded down.\n *\n * Inspired by Henry S. Warren, Jr.'s \"Hacker's Delight\" (Chapter 11).\n */\n function sqrt(uint256 a) internal pure returns (uint256) {\n if (a == 0) {\n return 0;\n }\n\n // For our first guess, we get the biggest power of 2 which is smaller than the square root of the target.\n //\n // We know that the \"msb\" (most significant bit) of our target number `a` is a power of 2 such that we have\n // `msb(a) <= a < 2*msb(a)`. This value can be written `msb(a)=2**k` with `k=log2(a)`.\n //\n // This can be rewritten `2**log2(a) <= a < 2**(log2(a) + 1)`\n // → `sqrt(2**k) <= sqrt(a) < sqrt(2**(k+1))`\n // → `2**(k/2) <= sqrt(a) < 2**((k+1)/2) <= 2**(k/2 + 1)`\n //\n // Consequently, `2**(log2(a) / 2)` is a good first approximation of `sqrt(a)` with at least 1 correct bit.\n uint256 result = 1 << (log2(a) >> 1);\n\n // At this point `result` is an estimation with one bit of precision. We know the true value is a uint128,\n // since it is the square root of a uint256. Newton's method converges quadratically (precision doubles at\n // every iteration). We thus need at most 7 iteration to turn our partial result with one bit of precision\n // into the expected uint128 result.\n unchecked {\n result = (result + a / result) >> 1;\n result = (result + a / result) >> 1;\n result = (result + a / result) >> 1;\n result = (result + a / result) >> 1;\n result = (result + a / result) >> 1;\n result = (result + a / result) >> 1;\n result = (result + a / result) >> 1;\n return min(result, a / result);\n }\n }\n\n /**\n * @notice Calculates sqrt(a), following the selected rounding direction.\n */\n function sqrt(uint256 a, Rounding rounding) internal pure returns (uint256) {\n unchecked {\n uint256 result = sqrt(a);\n return result + (rounding == Rounding.Up && result * result < a ? 1 : 0);\n }\n }\n\n /**\n * @dev Return the log in base 2, rounded down, of a positive value.\n * Returns 0 if given 0.\n */\n function log2(uint256 value) internal pure returns (uint256) {\n uint256 result = 0;\n unchecked {\n if (value >> 128 > 0) {\n value >>= 128;\n result += 128;\n }\n if (value >> 64 > 0) {\n value >>= 64;\n result += 64;\n }\n if (value >> 32 > 0) {\n value >>= 32;\n result += 32;\n }\n if (value >> 16 > 0) {\n value >>= 16;\n result += 16;\n }\n if (value >> 8 > 0) {\n value >>= 8;\n result += 8;\n }\n if (value >> 4 > 0) {\n value >>= 4;\n result += 4;\n }\n if (value >> 2 > 0) {\n value >>= 2;\n result += 2;\n }\n if (value >> 1 > 0) {\n result += 1;\n }\n }\n return result;\n }\n\n /**\n * @dev Return the log in base 2, following the selected rounding direction, of a positive value.\n * Returns 0 if given 0.\n */\n function log2(uint256 value, Rounding rounding) internal pure returns (uint256) {\n unchecked {\n uint256 result = log2(value);\n return result + (rounding == Rounding.Up && 1 << result < value ? 1 : 0);\n }\n }\n\n /**\n * @dev Return the log in base 10, rounded down, of a positive value.\n * Returns 0 if given 0.\n */\n function log10(uint256 value) internal pure returns (uint256) {\n uint256 result = 0;\n unchecked {\n if (value >= 10 ** 64) {\n value /= 10 ** 64;\n result += 64;\n }\n if (value >= 10 ** 32) {\n value /= 10 ** 32;\n result += 32;\n }\n if (value >= 10 ** 16) {\n value /= 10 ** 16;\n result += 16;\n }\n if (value >= 10 ** 8) {\n value /= 10 ** 8;\n result += 8;\n }\n if (value >= 10 ** 4) {\n value /= 10 ** 4;\n result += 4;\n }\n if (value >= 10 ** 2) {\n value /= 10 ** 2;\n result += 2;\n }\n if (value >= 10 ** 1) {\n result += 1;\n }\n }\n return result;\n }\n\n /**\n * @dev Return the log in base 10, following the selected rounding direction, of a positive value.\n * Returns 0 if given 0.\n */\n function log10(uint256 value, Rounding rounding) internal pure returns (uint256) {\n unchecked {\n uint256 result = log10(value);\n return result + (rounding == Rounding.Up && 10 ** result < value ? 1 : 0);\n }\n }\n\n /**\n * @dev Return the log in base 256, rounded down, of a positive value.\n * Returns 0 if given 0.\n *\n * Adding one to the result gives the number of pairs of hex symbols needed to represent `value` as a hex string.\n */\n function log256(uint256 value) internal pure returns (uint256) {\n uint256 result = 0;\n unchecked {\n if (value >> 128 > 0) {\n value >>= 128;\n result += 16;\n }\n if (value >> 64 > 0) {\n value >>= 64;\n result += 8;\n }\n if (value >> 32 > 0) {\n value >>= 32;\n result += 4;\n }\n if (value >> 16 > 0) {\n value >>= 16;\n result += 2;\n }\n if (value >> 8 > 0) {\n result += 1;\n }\n }\n return result;\n }\n\n /**\n * @dev Return the log in base 256, following the selected rounding direction, of a positive value.\n * Returns 0 if given 0.\n */\n function log256(uint256 value, Rounding rounding) internal pure returns (uint256) {\n unchecked {\n uint256 result = log256(value);\n return result + (rounding == Rounding.Up && 1 << (result << 3) < value ? 1 : 0);\n }\n }\n}\n"
+ },
+ "@openzeppelin/contracts-upgradeable/utils/math/SignedMathUpgradeable.sol": {
+ "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.8.0) (utils/math/SignedMath.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @dev Standard signed math utilities missing in the Solidity language.\n */\nlibrary SignedMathUpgradeable {\n /**\n * @dev Returns the largest of two signed numbers.\n */\n function max(int256 a, int256 b) internal pure returns (int256) {\n return a > b ? a : b;\n }\n\n /**\n * @dev Returns the smallest of two signed numbers.\n */\n function min(int256 a, int256 b) internal pure returns (int256) {\n return a < b ? a : b;\n }\n\n /**\n * @dev Returns the average of two signed numbers without overflow.\n * The result is rounded towards zero.\n */\n function average(int256 a, int256 b) internal pure returns (int256) {\n // Formula from the book \"Hacker's Delight\"\n int256 x = (a & b) + ((a ^ b) >> 1);\n return x + (int256(uint256(x) >> 255) & (a ^ b));\n }\n\n /**\n * @dev Returns the absolute unsigned value of a signed value.\n */\n function abs(int256 n) internal pure returns (uint256) {\n unchecked {\n // must be unchecked in order to support `n = type(int256).min`\n return uint256(n >= 0 ? n : -n);\n }\n }\n}\n"
+ },
+ "@openzeppelin/contracts-upgradeable/utils/StorageSlotUpgradeable.sol": {
+ "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (utils/StorageSlot.sol)\n// This file was procedurally generated from scripts/generate/templates/StorageSlot.js.\n\npragma solidity ^0.8.0;\n\n/**\n * @dev Library for reading and writing primitive types to specific storage slots.\n *\n * Storage slots are often used to avoid storage conflict when dealing with upgradeable contracts.\n * This library helps with reading and writing to such slots without the need for inline assembly.\n *\n * The functions in this library return Slot structs that contain a `value` member that can be used to read or write.\n *\n * Example usage to set ERC1967 implementation slot:\n * ```solidity\n * contract ERC1967 {\n * bytes32 internal constant _IMPLEMENTATION_SLOT = 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc;\n *\n * function _getImplementation() internal view returns (address) {\n * return StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value;\n * }\n *\n * function _setImplementation(address newImplementation) internal {\n * require(Address.isContract(newImplementation), \"ERC1967: new implementation is not a contract\");\n * StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value = newImplementation;\n * }\n * }\n * ```\n *\n * _Available since v4.1 for `address`, `bool`, `bytes32`, `uint256`._\n * _Available since v4.9 for `string`, `bytes`._\n */\nlibrary StorageSlotUpgradeable {\n struct AddressSlot {\n address value;\n }\n\n struct BooleanSlot {\n bool value;\n }\n\n struct Bytes32Slot {\n bytes32 value;\n }\n\n struct Uint256Slot {\n uint256 value;\n }\n\n struct StringSlot {\n string value;\n }\n\n struct BytesSlot {\n bytes value;\n }\n\n /**\n * @dev Returns an `AddressSlot` with member `value` located at `slot`.\n */\n function getAddressSlot(bytes32 slot) internal pure returns (AddressSlot storage r) {\n /// @solidity memory-safe-assembly\n assembly {\n r.slot := slot\n }\n }\n\n /**\n * @dev Returns an `BooleanSlot` with member `value` located at `slot`.\n */\n function getBooleanSlot(bytes32 slot) internal pure returns (BooleanSlot storage r) {\n /// @solidity memory-safe-assembly\n assembly {\n r.slot := slot\n }\n }\n\n /**\n * @dev Returns an `Bytes32Slot` with member `value` located at `slot`.\n */\n function getBytes32Slot(bytes32 slot) internal pure returns (Bytes32Slot storage r) {\n /// @solidity memory-safe-assembly\n assembly {\n r.slot := slot\n }\n }\n\n /**\n * @dev Returns an `Uint256Slot` with member `value` located at `slot`.\n */\n function getUint256Slot(bytes32 slot) internal pure returns (Uint256Slot storage r) {\n /// @solidity memory-safe-assembly\n assembly {\n r.slot := slot\n }\n }\n\n /**\n * @dev Returns an `StringSlot` with member `value` located at `slot`.\n */\n function getStringSlot(bytes32 slot) internal pure returns (StringSlot storage r) {\n /// @solidity memory-safe-assembly\n assembly {\n r.slot := slot\n }\n }\n\n /**\n * @dev Returns an `StringSlot` representation of the string storage pointer `store`.\n */\n function getStringSlot(string storage store) internal pure returns (StringSlot storage r) {\n /// @solidity memory-safe-assembly\n assembly {\n r.slot := store.slot\n }\n }\n\n /**\n * @dev Returns an `BytesSlot` with member `value` located at `slot`.\n */\n function getBytesSlot(bytes32 slot) internal pure returns (BytesSlot storage r) {\n /// @solidity memory-safe-assembly\n assembly {\n r.slot := slot\n }\n }\n\n /**\n * @dev Returns an `BytesSlot` representation of the bytes storage pointer `store`.\n */\n function getBytesSlot(bytes storage store) internal pure returns (BytesSlot storage r) {\n /// @solidity memory-safe-assembly\n assembly {\n r.slot := store.slot\n }\n }\n}\n"
+ },
+ "@openzeppelin/contracts-upgradeable/utils/StringsUpgradeable.sol": {
+ "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (utils/Strings.sol)\n\npragma solidity ^0.8.0;\n\nimport \"./math/MathUpgradeable.sol\";\nimport \"./math/SignedMathUpgradeable.sol\";\n\n/**\n * @dev String operations.\n */\nlibrary StringsUpgradeable {\n bytes16 private constant _SYMBOLS = \"0123456789abcdef\";\n uint8 private constant _ADDRESS_LENGTH = 20;\n\n /**\n * @dev Converts a `uint256` to its ASCII `string` decimal representation.\n */\n function toString(uint256 value) internal pure returns (string memory) {\n unchecked {\n uint256 length = MathUpgradeable.log10(value) + 1;\n string memory buffer = new string(length);\n uint256 ptr;\n /// @solidity memory-safe-assembly\n assembly {\n ptr := add(buffer, add(32, length))\n }\n while (true) {\n ptr--;\n /// @solidity memory-safe-assembly\n assembly {\n mstore8(ptr, byte(mod(value, 10), _SYMBOLS))\n }\n value /= 10;\n if (value == 0) break;\n }\n return buffer;\n }\n }\n\n /**\n * @dev Converts a `int256` to its ASCII `string` decimal representation.\n */\n function toString(int256 value) internal pure returns (string memory) {\n return string(abi.encodePacked(value < 0 ? \"-\" : \"\", toString(SignedMathUpgradeable.abs(value))));\n }\n\n /**\n * @dev Converts a `uint256` to its ASCII `string` hexadecimal representation.\n */\n function toHexString(uint256 value) internal pure returns (string memory) {\n unchecked {\n return toHexString(value, MathUpgradeable.log256(value) + 1);\n }\n }\n\n /**\n * @dev Converts a `uint256` to its ASCII `string` hexadecimal representation with fixed length.\n */\n function toHexString(uint256 value, uint256 length) internal pure returns (string memory) {\n bytes memory buffer = new bytes(2 * length + 2);\n buffer[0] = \"0\";\n buffer[1] = \"x\";\n for (uint256 i = 2 * length + 1; i > 1; --i) {\n buffer[i] = _SYMBOLS[value & 0xf];\n value >>= 4;\n }\n require(value == 0, \"Strings: hex length insufficient\");\n return string(buffer);\n }\n\n /**\n * @dev Converts an `address` with fixed length of 20 bytes to its not checksummed ASCII `string` hexadecimal representation.\n */\n function toHexString(address addr) internal pure returns (string memory) {\n return toHexString(uint256(uint160(addr)), _ADDRESS_LENGTH);\n }\n\n /**\n * @dev Returns true if the two strings are equal.\n */\n function equal(string memory a, string memory b) internal pure returns (bool) {\n return keccak256(bytes(a)) == keccak256(bytes(b));\n }\n}\n"
+ },
+ "@openzeppelin/contracts-upgradeable/vendor/optimism/ICrossDomainMessengerUpgradeable.sol": {
+ "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (vendor/optimism/ICrossDomainMessenger.sol)\npragma solidity >0.5.0 <0.9.0;\n\n/**\n * @title ICrossDomainMessenger\n */\ninterface ICrossDomainMessengerUpgradeable {\n /**********\n * Events *\n **********/\n\n event SentMessage(address indexed target, address sender, bytes message, uint256 messageNonce, uint256 gasLimit);\n event RelayedMessage(bytes32 indexed msgHash);\n event FailedRelayedMessage(bytes32 indexed msgHash);\n\n /*************\n * Variables *\n *************/\n\n function xDomainMessageSender() external view returns (address);\n\n /********************\n * Public Functions *\n ********************/\n\n /**\n * Sends a cross domain message to the target messenger.\n * @param _target Target contract address.\n * @param _message Message to send to the target.\n * @param _gasLimit Gas limit for the provided message.\n */\n function sendMessage(address _target, bytes calldata _message, uint32 _gasLimit) external;\n}\n"
+ },
+ "@openzeppelin/contracts/interfaces/IERC1271.sol": {
+ "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts v4.4.1 (interfaces/IERC1271.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @dev Interface of the ERC1271 standard signature validation method for\n * contracts as defined in https://eips.ethereum.org/EIPS/eip-1271[ERC-1271].\n *\n * _Available since v4.1._\n */\ninterface IERC1271 {\n /**\n * @dev Should return whether the signature provided is valid for the provided data\n * @param hash Hash of the data to be signed\n * @param signature Signature byte array associated with _data\n */\n function isValidSignature(bytes32 hash, bytes memory signature) external view returns (bytes4 magicValue);\n}\n"
+ },
+ "@openzeppelin/contracts/token/ERC20/extensions/IERC20Permit.sol": {
+ "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.4) (token/ERC20/extensions/IERC20Permit.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @dev Interface of the ERC20 Permit extension allowing approvals to be made via signatures, as defined in\n * https://eips.ethereum.org/EIPS/eip-2612[EIP-2612].\n *\n * Adds the {permit} method, which can be used to change an account's ERC20 allowance (see {IERC20-allowance}) by\n * presenting a message signed by the account. By not relying on {IERC20-approve}, the token holder account doesn't\n * need to send a transaction, and thus is not required to hold Ether at all.\n *\n * ==== Security Considerations\n *\n * There are two important considerations concerning the use of `permit`. The first is that a valid permit signature\n * expresses an allowance, and it should not be assumed to convey additional meaning. In particular, it should not be\n * considered as an intention to spend the allowance in any specific way. The second is that because permits have\n * built-in replay protection and can be submitted by anyone, they can be frontrun. A protocol that uses permits should\n * take this into consideration and allow a `permit` call to fail. Combining these two aspects, a pattern that may be\n * generally recommended is:\n *\n * ```solidity\n * function doThingWithPermit(..., uint256 value, uint256 deadline, uint8 v, bytes32 r, bytes32 s) public {\n * try token.permit(msg.sender, address(this), value, deadline, v, r, s) {} catch {}\n * doThing(..., value);\n * }\n *\n * function doThing(..., uint256 value) public {\n * token.safeTransferFrom(msg.sender, address(this), value);\n * ...\n * }\n * ```\n *\n * Observe that: 1) `msg.sender` is used as the owner, leaving no ambiguity as to the signer intent, and 2) the use of\n * `try/catch` allows the permit to fail and makes the code tolerant to frontrunning. (See also\n * {SafeERC20-safeTransferFrom}).\n *\n * Additionally, note that smart contract wallets (such as Argent or Safe) are not able to produce permit signatures, so\n * contracts should have entry points that don't rely on permit.\n */\ninterface IERC20Permit {\n /**\n * @dev Sets `value` as the allowance of `spender` over ``owner``'s tokens,\n * given ``owner``'s signed approval.\n *\n * IMPORTANT: The same issues {IERC20-approve} has related to transaction\n * ordering also apply here.\n *\n * Emits an {Approval} event.\n *\n * Requirements:\n *\n * - `spender` cannot be the zero address.\n * - `deadline` must be a timestamp in the future.\n * - `v`, `r` and `s` must be a valid `secp256k1` signature from `owner`\n * over the EIP712-formatted function arguments.\n * - the signature must use ``owner``'s current nonce (see {nonces}).\n *\n * For more information on the signature format, see the\n * https://eips.ethereum.org/EIPS/eip-2612#specification[relevant EIP\n * section].\n *\n * CAUTION: See Security Considerations above.\n */\n function permit(\n address owner,\n address spender,\n uint256 value,\n uint256 deadline,\n uint8 v,\n bytes32 r,\n bytes32 s\n ) external;\n\n /**\n * @dev Returns the current nonce for `owner`. This value must be\n * included whenever a signature is generated for {permit}.\n *\n * Every successful call to {permit} increases ``owner``'s nonce by one. This\n * prevents a signature from being used multiple times.\n */\n function nonces(address owner) external view returns (uint256);\n\n /**\n * @dev Returns the domain separator used in the encoding of the signature for {permit}, as defined by {EIP712}.\n */\n // solhint-disable-next-line func-name-mixedcase\n function DOMAIN_SEPARATOR() external view returns (bytes32);\n}\n"
+ },
+ "@openzeppelin/contracts/token/ERC20/IERC20.sol": {
+ "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (token/ERC20/IERC20.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @dev Interface of the ERC20 standard as defined in the EIP.\n */\ninterface IERC20 {\n /**\n * @dev Emitted when `value` tokens are moved from one account (`from`) to\n * another (`to`).\n *\n * Note that `value` may be zero.\n */\n event Transfer(address indexed from, address indexed to, uint256 value);\n\n /**\n * @dev Emitted when the allowance of a `spender` for an `owner` is set by\n * a call to {approve}. `value` is the new allowance.\n */\n event Approval(address indexed owner, address indexed spender, uint256 value);\n\n /**\n * @dev Returns the amount of tokens in existence.\n */\n function totalSupply() external view returns (uint256);\n\n /**\n * @dev Returns the amount of tokens owned by `account`.\n */\n function balanceOf(address account) external view returns (uint256);\n\n /**\n * @dev Moves `amount` tokens from the caller's account to `to`.\n *\n * Returns a boolean value indicating whether the operation succeeded.\n *\n * Emits a {Transfer} event.\n */\n function transfer(address to, uint256 amount) external returns (bool);\n\n /**\n * @dev Returns the remaining number of tokens that `spender` will be\n * allowed to spend on behalf of `owner` through {transferFrom}. This is\n * zero by default.\n *\n * This value changes when {approve} or {transferFrom} are called.\n */\n function allowance(address owner, address spender) external view returns (uint256);\n\n /**\n * @dev Sets `amount` as the allowance of `spender` over the caller's tokens.\n *\n * Returns a boolean value indicating whether the operation succeeded.\n *\n * IMPORTANT: Beware that changing an allowance with this method brings the risk\n * that someone may use both the old and the new allowance by unfortunate\n * transaction ordering. One possible solution to mitigate this race\n * condition is to first reduce the spender's allowance to 0 and set the\n * desired value afterwards:\n * https://github.com/ethereum/EIPs/issues/20#issuecomment-263524729\n *\n * Emits an {Approval} event.\n */\n function approve(address spender, uint256 amount) external returns (bool);\n\n /**\n * @dev Moves `amount` tokens from `from` to `to` using the\n * allowance mechanism. `amount` is then deducted from the caller's\n * allowance.\n *\n * Returns a boolean value indicating whether the operation succeeded.\n *\n * Emits a {Transfer} event.\n */\n function transferFrom(address from, address to, uint256 amount) external returns (bool);\n}\n"
+ },
+ "@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol": {
+ "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.3) (token/ERC20/utils/SafeERC20.sol)\n\npragma solidity ^0.8.0;\n\nimport \"../IERC20.sol\";\nimport \"../extensions/IERC20Permit.sol\";\nimport \"../../../utils/Address.sol\";\n\n/**\n * @title SafeERC20\n * @dev Wrappers around ERC20 operations that throw on failure (when the token\n * contract returns false). Tokens that return no value (and instead revert or\n * throw on failure) are also supported, non-reverting calls are assumed to be\n * successful.\n * To use this library you can add a `using SafeERC20 for IERC20;` statement to your contract,\n * which allows you to call the safe operations as `token.safeTransfer(...)`, etc.\n */\nlibrary SafeERC20 {\n using Address for address;\n\n /**\n * @dev Transfer `value` amount of `token` from the calling contract to `to`. If `token` returns no value,\n * non-reverting calls are assumed to be successful.\n */\n function safeTransfer(IERC20 token, address to, uint256 value) internal {\n _callOptionalReturn(token, abi.encodeWithSelector(token.transfer.selector, to, value));\n }\n\n /**\n * @dev Transfer `value` amount of `token` from `from` to `to`, spending the approval given by `from` to the\n * calling contract. If `token` returns no value, non-reverting calls are assumed to be successful.\n */\n function safeTransferFrom(IERC20 token, address from, address to, uint256 value) internal {\n _callOptionalReturn(token, abi.encodeWithSelector(token.transferFrom.selector, from, to, value));\n }\n\n /**\n * @dev Deprecated. This function has issues similar to the ones found in\n * {IERC20-approve}, and its usage is discouraged.\n *\n * Whenever possible, use {safeIncreaseAllowance} and\n * {safeDecreaseAllowance} instead.\n */\n function safeApprove(IERC20 token, address spender, uint256 value) internal {\n // safeApprove should only be called when setting an initial allowance,\n // or when resetting it to zero. To increase and decrease it, use\n // 'safeIncreaseAllowance' and 'safeDecreaseAllowance'\n require(\n (value == 0) || (token.allowance(address(this), spender) == 0),\n \"SafeERC20: approve from non-zero to non-zero allowance\"\n );\n _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, value));\n }\n\n /**\n * @dev Increase the calling contract's allowance toward `spender` by `value`. If `token` returns no value,\n * non-reverting calls are assumed to be successful.\n */\n function safeIncreaseAllowance(IERC20 token, address spender, uint256 value) internal {\n uint256 oldAllowance = token.allowance(address(this), spender);\n _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, oldAllowance + value));\n }\n\n /**\n * @dev Decrease the calling contract's allowance toward `spender` by `value`. If `token` returns no value,\n * non-reverting calls are assumed to be successful.\n */\n function safeDecreaseAllowance(IERC20 token, address spender, uint256 value) internal {\n unchecked {\n uint256 oldAllowance = token.allowance(address(this), spender);\n require(oldAllowance >= value, \"SafeERC20: decreased allowance below zero\");\n _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, oldAllowance - value));\n }\n }\n\n /**\n * @dev Set the calling contract's allowance toward `spender` to `value`. If `token` returns no value,\n * non-reverting calls are assumed to be successful. Meant to be used with tokens that require the approval\n * to be set to zero before setting it to a non-zero value, such as USDT.\n */\n function forceApprove(IERC20 token, address spender, uint256 value) internal {\n bytes memory approvalCall = abi.encodeWithSelector(token.approve.selector, spender, value);\n\n if (!_callOptionalReturnBool(token, approvalCall)) {\n _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, 0));\n _callOptionalReturn(token, approvalCall);\n }\n }\n\n /**\n * @dev Use a ERC-2612 signature to set the `owner` approval toward `spender` on `token`.\n * Revert on invalid signature.\n */\n function safePermit(\n IERC20Permit token,\n address owner,\n address spender,\n uint256 value,\n uint256 deadline,\n uint8 v,\n bytes32 r,\n bytes32 s\n ) internal {\n uint256 nonceBefore = token.nonces(owner);\n token.permit(owner, spender, value, deadline, v, r, s);\n uint256 nonceAfter = token.nonces(owner);\n require(nonceAfter == nonceBefore + 1, \"SafeERC20: permit did not succeed\");\n }\n\n /**\n * @dev Imitates a Solidity high-level call (i.e. a regular function call to a contract), relaxing the requirement\n * on the return value: the return value is optional (but if data is returned, it must not be false).\n * @param token The token targeted by the call.\n * @param data The call data (encoded using abi.encode or one of its variants).\n */\n function _callOptionalReturn(IERC20 token, bytes memory data) private {\n // We need to perform a low level call here, to bypass Solidity's return data size checking mechanism, since\n // we're implementing it ourselves. We use {Address-functionCall} to perform this call, which verifies that\n // the target address contains contract code and also asserts for success in the low-level call.\n\n bytes memory returndata = address(token).functionCall(data, \"SafeERC20: low-level call failed\");\n require(returndata.length == 0 || abi.decode(returndata, (bool)), \"SafeERC20: ERC20 operation did not succeed\");\n }\n\n /**\n * @dev Imitates a Solidity high-level call (i.e. a regular function call to a contract), relaxing the requirement\n * on the return value: the return value is optional (but if data is returned, it must not be false).\n * @param token The token targeted by the call.\n * @param data The call data (encoded using abi.encode or one of its variants).\n *\n * This is a variant of {_callOptionalReturn} that silents catches all reverts and returns a bool instead.\n */\n function _callOptionalReturnBool(IERC20 token, bytes memory data) private returns (bool) {\n // We need to perform a low level call here, to bypass Solidity's return data size checking mechanism, since\n // we're implementing it ourselves. We cannot use {Address-functionCall} here since this should return false\n // and not revert is the subcall reverts.\n\n (bool success, bytes memory returndata) = address(token).call(data);\n return\n success && (returndata.length == 0 || abi.decode(returndata, (bool))) && Address.isContract(address(token));\n }\n}\n"
+ },
+ "@openzeppelin/contracts/utils/Address.sol": {
+ "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (utils/Address.sol)\n\npragma solidity ^0.8.1;\n\n/**\n * @dev Collection of functions related to the address type\n */\nlibrary Address {\n /**\n * @dev Returns true if `account` is a contract.\n *\n * [IMPORTANT]\n * ====\n * It is unsafe to assume that an address for which this function returns\n * false is an externally-owned account (EOA) and not a contract.\n *\n * Among others, `isContract` will return false for the following\n * types of addresses:\n *\n * - an externally-owned account\n * - a contract in construction\n * - an address where a contract will be created\n * - an address where a contract lived, but was destroyed\n *\n * Furthermore, `isContract` will also return true if the target contract within\n * the same transaction is already scheduled for destruction by `SELFDESTRUCT`,\n * which only has an effect at the end of a transaction.\n * ====\n *\n * [IMPORTANT]\n * ====\n * You shouldn't rely on `isContract` to protect against flash loan attacks!\n *\n * Preventing calls from contracts is highly discouraged. It breaks composability, breaks support for smart wallets\n * like Gnosis Safe, and does not provide security since it can be circumvented by calling from a contract\n * constructor.\n * ====\n */\n function isContract(address account) internal view returns (bool) {\n // This method relies on extcodesize/address.code.length, which returns 0\n // for contracts in construction, since the code is only stored at the end\n // of the constructor execution.\n\n return account.code.length > 0;\n }\n\n /**\n * @dev Replacement for Solidity's `transfer`: sends `amount` wei to\n * `recipient`, forwarding all available gas and reverting on errors.\n *\n * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost\n * of certain opcodes, possibly making contracts go over the 2300 gas limit\n * imposed by `transfer`, making them unable to receive funds via\n * `transfer`. {sendValue} removes this limitation.\n *\n * https://consensys.net/diligence/blog/2019/09/stop-using-soliditys-transfer-now/[Learn more].\n *\n * IMPORTANT: because control is transferred to `recipient`, care must be\n * taken to not create reentrancy vulnerabilities. Consider using\n * {ReentrancyGuard} or the\n * https://solidity.readthedocs.io/en/v0.8.0/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].\n */\n function sendValue(address payable recipient, uint256 amount) internal {\n require(address(this).balance >= amount, \"Address: insufficient balance\");\n\n (bool success, ) = recipient.call{value: amount}(\"\");\n require(success, \"Address: unable to send value, recipient may have reverted\");\n }\n\n /**\n * @dev Performs a Solidity function call using a low level `call`. A\n * plain `call` is an unsafe replacement for a function call: use this\n * function instead.\n *\n * If `target` reverts with a revert reason, it is bubbled up by this\n * function (like regular Solidity function calls).\n *\n * Returns the raw returned data. To convert to the expected return value,\n * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].\n *\n * Requirements:\n *\n * - `target` must be a contract.\n * - calling `target` with `data` must not revert.\n *\n * _Available since v3.1._\n */\n function functionCall(address target, bytes memory data) internal returns (bytes memory) {\n return functionCallWithValue(target, data, 0, \"Address: low-level call failed\");\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with\n * `errorMessage` as a fallback revert reason when `target` reverts.\n *\n * _Available since v3.1._\n */\n function functionCall(\n address target,\n bytes memory data,\n string memory errorMessage\n ) internal returns (bytes memory) {\n return functionCallWithValue(target, data, 0, errorMessage);\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\n * but also transferring `value` wei to `target`.\n *\n * Requirements:\n *\n * - the calling contract must have an ETH balance of at least `value`.\n * - the called Solidity function must be `payable`.\n *\n * _Available since v3.1._\n */\n function functionCallWithValue(address target, bytes memory data, uint256 value) internal returns (bytes memory) {\n return functionCallWithValue(target, data, value, \"Address: low-level call with value failed\");\n }\n\n /**\n * @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but\n * with `errorMessage` as a fallback revert reason when `target` reverts.\n *\n * _Available since v3.1._\n */\n function functionCallWithValue(\n address target,\n bytes memory data,\n uint256 value,\n string memory errorMessage\n ) internal returns (bytes memory) {\n require(address(this).balance >= value, \"Address: insufficient balance for call\");\n (bool success, bytes memory returndata) = target.call{value: value}(data);\n return verifyCallResultFromTarget(target, success, returndata, errorMessage);\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\n * but performing a static call.\n *\n * _Available since v3.3._\n */\n function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {\n return functionStaticCall(target, data, \"Address: low-level static call failed\");\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],\n * but performing a static call.\n *\n * _Available since v3.3._\n */\n function functionStaticCall(\n address target,\n bytes memory data,\n string memory errorMessage\n ) internal view returns (bytes memory) {\n (bool success, bytes memory returndata) = target.staticcall(data);\n return verifyCallResultFromTarget(target, success, returndata, errorMessage);\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\n * but performing a delegate call.\n *\n * _Available since v3.4._\n */\n function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) {\n return functionDelegateCall(target, data, \"Address: low-level delegate call failed\");\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],\n * but performing a delegate call.\n *\n * _Available since v3.4._\n */\n function functionDelegateCall(\n address target,\n bytes memory data,\n string memory errorMessage\n ) internal returns (bytes memory) {\n (bool success, bytes memory returndata) = target.delegatecall(data);\n return verifyCallResultFromTarget(target, success, returndata, errorMessage);\n }\n\n /**\n * @dev Tool to verify that a low level call to smart-contract was successful, and revert (either by bubbling\n * the revert reason or using the provided one) in case of unsuccessful call or if target was not a contract.\n *\n * _Available since v4.8._\n */\n function verifyCallResultFromTarget(\n address target,\n bool success,\n bytes memory returndata,\n string memory errorMessage\n ) internal view returns (bytes memory) {\n if (success) {\n if (returndata.length == 0) {\n // only check isContract if the call was successful and the return data is empty\n // otherwise we already know that it was a contract\n require(isContract(target), \"Address: call to non-contract\");\n }\n return returndata;\n } else {\n _revert(returndata, errorMessage);\n }\n }\n\n /**\n * @dev Tool to verify that a low level call was successful, and revert if it wasn't, either by bubbling the\n * revert reason or using the provided one.\n *\n * _Available since v4.3._\n */\n function verifyCallResult(\n bool success,\n bytes memory returndata,\n string memory errorMessage\n ) internal pure returns (bytes memory) {\n if (success) {\n return returndata;\n } else {\n _revert(returndata, errorMessage);\n }\n }\n\n function _revert(bytes memory returndata, string memory errorMessage) private pure {\n // Look for revert reason and bubble it up if present\n if (returndata.length > 0) {\n // The easiest way to bubble the revert reason is using memory via assembly\n /// @solidity memory-safe-assembly\n assembly {\n let returndata_size := mload(returndata)\n revert(add(32, returndata), returndata_size)\n }\n } else {\n revert(errorMessage);\n }\n }\n}\n"
+ },
+ "@openzeppelin/contracts/utils/cryptography/ECDSA.sol": {
+ "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (utils/cryptography/ECDSA.sol)\n\npragma solidity ^0.8.0;\n\nimport \"../Strings.sol\";\n\n/**\n * @dev Elliptic Curve Digital Signature Algorithm (ECDSA) operations.\n *\n * These functions can be used to verify that a message was signed by the holder\n * of the private keys of a given address.\n */\nlibrary ECDSA {\n enum RecoverError {\n NoError,\n InvalidSignature,\n InvalidSignatureLength,\n InvalidSignatureS,\n InvalidSignatureV // Deprecated in v4.8\n }\n\n function _throwError(RecoverError error) private pure {\n if (error == RecoverError.NoError) {\n return; // no error: do nothing\n } else if (error == RecoverError.InvalidSignature) {\n revert(\"ECDSA: invalid signature\");\n } else if (error == RecoverError.InvalidSignatureLength) {\n revert(\"ECDSA: invalid signature length\");\n } else if (error == RecoverError.InvalidSignatureS) {\n revert(\"ECDSA: invalid signature 's' value\");\n }\n }\n\n /**\n * @dev Returns the address that signed a hashed message (`hash`) with\n * `signature` or error string. This address can then be used for verification purposes.\n *\n * The `ecrecover` EVM opcode allows for malleable (non-unique) signatures:\n * this function rejects them by requiring the `s` value to be in the lower\n * half order, and the `v` value to be either 27 or 28.\n *\n * IMPORTANT: `hash` _must_ be the result of a hash operation for the\n * verification to be secure: it is possible to craft signatures that\n * recover to arbitrary addresses for non-hashed data. A safe way to ensure\n * this is by receiving a hash of the original message (which may otherwise\n * be too long), and then calling {toEthSignedMessageHash} on it.\n *\n * Documentation for signature generation:\n * - with https://web3js.readthedocs.io/en/v1.3.4/web3-eth-accounts.html#sign[Web3.js]\n * - with https://docs.ethers.io/v5/api/signer/#Signer-signMessage[ethers]\n *\n * _Available since v4.3._\n */\n function tryRecover(bytes32 hash, bytes memory signature) internal pure returns (address, RecoverError) {\n if (signature.length == 65) {\n bytes32 r;\n bytes32 s;\n uint8 v;\n // ecrecover takes the signature parameters, and the only way to get them\n // currently is to use assembly.\n /// @solidity memory-safe-assembly\n assembly {\n r := mload(add(signature, 0x20))\n s := mload(add(signature, 0x40))\n v := byte(0, mload(add(signature, 0x60)))\n }\n return tryRecover(hash, v, r, s);\n } else {\n return (address(0), RecoverError.InvalidSignatureLength);\n }\n }\n\n /**\n * @dev Returns the address that signed a hashed message (`hash`) with\n * `signature`. This address can then be used for verification purposes.\n *\n * The `ecrecover` EVM opcode allows for malleable (non-unique) signatures:\n * this function rejects them by requiring the `s` value to be in the lower\n * half order, and the `v` value to be either 27 or 28.\n *\n * IMPORTANT: `hash` _must_ be the result of a hash operation for the\n * verification to be secure: it is possible to craft signatures that\n * recover to arbitrary addresses for non-hashed data. A safe way to ensure\n * this is by receiving a hash of the original message (which may otherwise\n * be too long), and then calling {toEthSignedMessageHash} on it.\n */\n function recover(bytes32 hash, bytes memory signature) internal pure returns (address) {\n (address recovered, RecoverError error) = tryRecover(hash, signature);\n _throwError(error);\n return recovered;\n }\n\n /**\n * @dev Overload of {ECDSA-tryRecover} that receives the `r` and `vs` short-signature fields separately.\n *\n * See https://eips.ethereum.org/EIPS/eip-2098[EIP-2098 short signatures]\n *\n * _Available since v4.3._\n */\n function tryRecover(bytes32 hash, bytes32 r, bytes32 vs) internal pure returns (address, RecoverError) {\n bytes32 s = vs & bytes32(0x7fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff);\n uint8 v = uint8((uint256(vs) >> 255) + 27);\n return tryRecover(hash, v, r, s);\n }\n\n /**\n * @dev Overload of {ECDSA-recover} that receives the `r and `vs` short-signature fields separately.\n *\n * _Available since v4.2._\n */\n function recover(bytes32 hash, bytes32 r, bytes32 vs) internal pure returns (address) {\n (address recovered, RecoverError error) = tryRecover(hash, r, vs);\n _throwError(error);\n return recovered;\n }\n\n /**\n * @dev Overload of {ECDSA-tryRecover} that receives the `v`,\n * `r` and `s` signature fields separately.\n *\n * _Available since v4.3._\n */\n function tryRecover(bytes32 hash, uint8 v, bytes32 r, bytes32 s) internal pure returns (address, RecoverError) {\n // EIP-2 still allows signature malleability for ecrecover(). Remove this possibility and make the signature\n // unique. Appendix F in the Ethereum Yellow paper (https://ethereum.github.io/yellowpaper/paper.pdf), defines\n // the valid range for s in (301): 0 < s < secp256k1n ÷ 2 + 1, and for v in (302): v ∈ {27, 28}. Most\n // signatures from current libraries generate a unique signature with an s-value in the lower half order.\n //\n // If your library generates malleable signatures, such as s-values in the upper range, calculate a new s-value\n // with 0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFEBAAEDCE6AF48A03BBFD25E8CD0364141 - s1 and flip v from 27 to 28 or\n // vice versa. If your library also generates signatures with 0/1 for v instead 27/28, add 27 to v to accept\n // these malleable signatures as well.\n if (uint256(s) > 0x7FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF5D576E7357A4501DDFE92F46681B20A0) {\n return (address(0), RecoverError.InvalidSignatureS);\n }\n\n // If the signature is valid (and not malleable), return the signer address\n address signer = ecrecover(hash, v, r, s);\n if (signer == address(0)) {\n return (address(0), RecoverError.InvalidSignature);\n }\n\n return (signer, RecoverError.NoError);\n }\n\n /**\n * @dev Overload of {ECDSA-recover} that receives the `v`,\n * `r` and `s` signature fields separately.\n */\n function recover(bytes32 hash, uint8 v, bytes32 r, bytes32 s) internal pure returns (address) {\n (address recovered, RecoverError error) = tryRecover(hash, v, r, s);\n _throwError(error);\n return recovered;\n }\n\n /**\n * @dev Returns an Ethereum Signed Message, created from a `hash`. This\n * produces hash corresponding to the one signed with the\n * https://eth.wiki/json-rpc/API#eth_sign[`eth_sign`]\n * JSON-RPC method as part of EIP-191.\n *\n * See {recover}.\n */\n function toEthSignedMessageHash(bytes32 hash) internal pure returns (bytes32 message) {\n // 32 is the length in bytes of hash,\n // enforced by the type signature above\n /// @solidity memory-safe-assembly\n assembly {\n mstore(0x00, \"\\x19Ethereum Signed Message:\\n32\")\n mstore(0x1c, hash)\n message := keccak256(0x00, 0x3c)\n }\n }\n\n /**\n * @dev Returns an Ethereum Signed Message, created from `s`. This\n * produces hash corresponding to the one signed with the\n * https://eth.wiki/json-rpc/API#eth_sign[`eth_sign`]\n * JSON-RPC method as part of EIP-191.\n *\n * See {recover}.\n */\n function toEthSignedMessageHash(bytes memory s) internal pure returns (bytes32) {\n return keccak256(abi.encodePacked(\"\\x19Ethereum Signed Message:\\n\", Strings.toString(s.length), s));\n }\n\n /**\n * @dev Returns an Ethereum Signed Typed Data, created from a\n * `domainSeparator` and a `structHash`. This produces hash corresponding\n * to the one signed with the\n * https://eips.ethereum.org/EIPS/eip-712[`eth_signTypedData`]\n * JSON-RPC method as part of EIP-712.\n *\n * See {recover}.\n */\n function toTypedDataHash(bytes32 domainSeparator, bytes32 structHash) internal pure returns (bytes32 data) {\n /// @solidity memory-safe-assembly\n assembly {\n let ptr := mload(0x40)\n mstore(ptr, \"\\x19\\x01\")\n mstore(add(ptr, 0x02), domainSeparator)\n mstore(add(ptr, 0x22), structHash)\n data := keccak256(ptr, 0x42)\n }\n }\n\n /**\n * @dev Returns an Ethereum Signed Data with intended validator, created from a\n * `validator` and `data` according to the version 0 of EIP-191.\n *\n * See {recover}.\n */\n function toDataWithIntendedValidatorHash(address validator, bytes memory data) internal pure returns (bytes32) {\n return keccak256(abi.encodePacked(\"\\x19\\x00\", validator, data));\n }\n}\n"
+ },
+ "@openzeppelin/contracts/utils/cryptography/MerkleProof.sol": {
+ "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.2) (utils/cryptography/MerkleProof.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @dev These functions deal with verification of Merkle Tree proofs.\n *\n * The tree and the proofs can be generated using our\n * https://github.com/OpenZeppelin/merkle-tree[JavaScript library].\n * You will find a quickstart guide in the readme.\n *\n * WARNING: You should avoid using leaf values that are 64 bytes long prior to\n * hashing, or use a hash function other than keccak256 for hashing leaves.\n * This is because the concatenation of a sorted pair of internal nodes in\n * the merkle tree could be reinterpreted as a leaf value.\n * OpenZeppelin's JavaScript library generates merkle trees that are safe\n * against this attack out of the box.\n */\nlibrary MerkleProof {\n /**\n * @dev Returns true if a `leaf` can be proved to be a part of a Merkle tree\n * defined by `root`. For this, a `proof` must be provided, containing\n * sibling hashes on the branch from the leaf to the root of the tree. Each\n * pair of leaves and each pair of pre-images are assumed to be sorted.\n */\n function verify(bytes32[] memory proof, bytes32 root, bytes32 leaf) internal pure returns (bool) {\n return processProof(proof, leaf) == root;\n }\n\n /**\n * @dev Calldata version of {verify}\n *\n * _Available since v4.7._\n */\n function verifyCalldata(bytes32[] calldata proof, bytes32 root, bytes32 leaf) internal pure returns (bool) {\n return processProofCalldata(proof, leaf) == root;\n }\n\n /**\n * @dev Returns the rebuilt hash obtained by traversing a Merkle tree up\n * from `leaf` using `proof`. A `proof` is valid if and only if the rebuilt\n * hash matches the root of the tree. When processing the proof, the pairs\n * of leafs & pre-images are assumed to be sorted.\n *\n * _Available since v4.4._\n */\n function processProof(bytes32[] memory proof, bytes32 leaf) internal pure returns (bytes32) {\n bytes32 computedHash = leaf;\n for (uint256 i = 0; i < proof.length; i++) {\n computedHash = _hashPair(computedHash, proof[i]);\n }\n return computedHash;\n }\n\n /**\n * @dev Calldata version of {processProof}\n *\n * _Available since v4.7._\n */\n function processProofCalldata(bytes32[] calldata proof, bytes32 leaf) internal pure returns (bytes32) {\n bytes32 computedHash = leaf;\n for (uint256 i = 0; i < proof.length; i++) {\n computedHash = _hashPair(computedHash, proof[i]);\n }\n return computedHash;\n }\n\n /**\n * @dev Returns true if the `leaves` can be simultaneously proven to be a part of a merkle tree defined by\n * `root`, according to `proof` and `proofFlags` as described in {processMultiProof}.\n *\n * CAUTION: Not all merkle trees admit multiproofs. See {processMultiProof} for details.\n *\n * _Available since v4.7._\n */\n function multiProofVerify(\n bytes32[] memory proof,\n bool[] memory proofFlags,\n bytes32 root,\n bytes32[] memory leaves\n ) internal pure returns (bool) {\n return processMultiProof(proof, proofFlags, leaves) == root;\n }\n\n /**\n * @dev Calldata version of {multiProofVerify}\n *\n * CAUTION: Not all merkle trees admit multiproofs. See {processMultiProof} for details.\n *\n * _Available since v4.7._\n */\n function multiProofVerifyCalldata(\n bytes32[] calldata proof,\n bool[] calldata proofFlags,\n bytes32 root,\n bytes32[] memory leaves\n ) internal pure returns (bool) {\n return processMultiProofCalldata(proof, proofFlags, leaves) == root;\n }\n\n /**\n * @dev Returns the root of a tree reconstructed from `leaves` and sibling nodes in `proof`. The reconstruction\n * proceeds by incrementally reconstructing all inner nodes by combining a leaf/inner node with either another\n * leaf/inner node or a proof sibling node, depending on whether each `proofFlags` item is true or false\n * respectively.\n *\n * CAUTION: Not all merkle trees admit multiproofs. To use multiproofs, it is sufficient to ensure that: 1) the tree\n * is complete (but not necessarily perfect), 2) the leaves to be proven are in the opposite order they are in the\n * tree (i.e., as seen from right to left starting at the deepest layer and continuing at the next layer).\n *\n * _Available since v4.7._\n */\n function processMultiProof(\n bytes32[] memory proof,\n bool[] memory proofFlags,\n bytes32[] memory leaves\n ) internal pure returns (bytes32 merkleRoot) {\n // This function rebuilds the root hash by traversing the tree up from the leaves. The root is rebuilt by\n // consuming and producing values on a queue. The queue starts with the `leaves` array, then goes onto the\n // `hashes` array. At the end of the process, the last hash in the `hashes` array should contain the root of\n // the merkle tree.\n uint256 leavesLen = leaves.length;\n uint256 proofLen = proof.length;\n uint256 totalHashes = proofFlags.length;\n\n // Check proof validity.\n require(leavesLen + proofLen - 1 == totalHashes, \"MerkleProof: invalid multiproof\");\n\n // The xxxPos values are \"pointers\" to the next value to consume in each array. All accesses are done using\n // `xxx[xxxPos++]`, which return the current value and increment the pointer, thus mimicking a queue's \"pop\".\n bytes32[] memory hashes = new bytes32[](totalHashes);\n uint256 leafPos = 0;\n uint256 hashPos = 0;\n uint256 proofPos = 0;\n // At each step, we compute the next hash using two values:\n // - a value from the \"main queue\". If not all leaves have been consumed, we get the next leaf, otherwise we\n // get the next hash.\n // - depending on the flag, either another value from the \"main queue\" (merging branches) or an element from the\n // `proof` array.\n for (uint256 i = 0; i < totalHashes; i++) {\n bytes32 a = leafPos < leavesLen ? leaves[leafPos++] : hashes[hashPos++];\n bytes32 b = proofFlags[i]\n ? (leafPos < leavesLen ? leaves[leafPos++] : hashes[hashPos++])\n : proof[proofPos++];\n hashes[i] = _hashPair(a, b);\n }\n\n if (totalHashes > 0) {\n require(proofPos == proofLen, \"MerkleProof: invalid multiproof\");\n unchecked {\n return hashes[totalHashes - 1];\n }\n } else if (leavesLen > 0) {\n return leaves[0];\n } else {\n return proof[0];\n }\n }\n\n /**\n * @dev Calldata version of {processMultiProof}.\n *\n * CAUTION: Not all merkle trees admit multiproofs. See {processMultiProof} for details.\n *\n * _Available since v4.7._\n */\n function processMultiProofCalldata(\n bytes32[] calldata proof,\n bool[] calldata proofFlags,\n bytes32[] memory leaves\n ) internal pure returns (bytes32 merkleRoot) {\n // This function rebuilds the root hash by traversing the tree up from the leaves. The root is rebuilt by\n // consuming and producing values on a queue. The queue starts with the `leaves` array, then goes onto the\n // `hashes` array. At the end of the process, the last hash in the `hashes` array should contain the root of\n // the merkle tree.\n uint256 leavesLen = leaves.length;\n uint256 proofLen = proof.length;\n uint256 totalHashes = proofFlags.length;\n\n // Check proof validity.\n require(leavesLen + proofLen - 1 == totalHashes, \"MerkleProof: invalid multiproof\");\n\n // The xxxPos values are \"pointers\" to the next value to consume in each array. All accesses are done using\n // `xxx[xxxPos++]`, which return the current value and increment the pointer, thus mimicking a queue's \"pop\".\n bytes32[] memory hashes = new bytes32[](totalHashes);\n uint256 leafPos = 0;\n uint256 hashPos = 0;\n uint256 proofPos = 0;\n // At each step, we compute the next hash using two values:\n // - a value from the \"main queue\". If not all leaves have been consumed, we get the next leaf, otherwise we\n // get the next hash.\n // - depending on the flag, either another value from the \"main queue\" (merging branches) or an element from the\n // `proof` array.\n for (uint256 i = 0; i < totalHashes; i++) {\n bytes32 a = leafPos < leavesLen ? leaves[leafPos++] : hashes[hashPos++];\n bytes32 b = proofFlags[i]\n ? (leafPos < leavesLen ? leaves[leafPos++] : hashes[hashPos++])\n : proof[proofPos++];\n hashes[i] = _hashPair(a, b);\n }\n\n if (totalHashes > 0) {\n require(proofPos == proofLen, \"MerkleProof: invalid multiproof\");\n unchecked {\n return hashes[totalHashes - 1];\n }\n } else if (leavesLen > 0) {\n return leaves[0];\n } else {\n return proof[0];\n }\n }\n\n function _hashPair(bytes32 a, bytes32 b) private pure returns (bytes32) {\n return a < b ? _efficientHash(a, b) : _efficientHash(b, a);\n }\n\n function _efficientHash(bytes32 a, bytes32 b) private pure returns (bytes32 value) {\n /// @solidity memory-safe-assembly\n assembly {\n mstore(0x00, a)\n mstore(0x20, b)\n value := keccak256(0x00, 0x40)\n }\n }\n}\n"
+ },
+ "@openzeppelin/contracts/utils/cryptography/SignatureChecker.sol": {
+ "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (utils/cryptography/SignatureChecker.sol)\n\npragma solidity ^0.8.0;\n\nimport \"./ECDSA.sol\";\nimport \"../../interfaces/IERC1271.sol\";\n\n/**\n * @dev Signature verification helper that can be used instead of `ECDSA.recover` to seamlessly support both ECDSA\n * signatures from externally owned accounts (EOAs) as well as ERC1271 signatures from smart contract wallets like\n * Argent and Gnosis Safe.\n *\n * _Available since v4.1._\n */\nlibrary SignatureChecker {\n /**\n * @dev Checks if a signature is valid for a given signer and data hash. If the signer is a smart contract, the\n * signature is validated against that smart contract using ERC1271, otherwise it's validated using `ECDSA.recover`.\n *\n * NOTE: Unlike ECDSA signatures, contract signatures are revocable, and the outcome of this function can thus\n * change through time. It could return true at block N and false at block N+1 (or the opposite).\n */\n function isValidSignatureNow(address signer, bytes32 hash, bytes memory signature) internal view returns (bool) {\n (address recovered, ECDSA.RecoverError error) = ECDSA.tryRecover(hash, signature);\n return\n (error == ECDSA.RecoverError.NoError && recovered == signer) ||\n isValidERC1271SignatureNow(signer, hash, signature);\n }\n\n /**\n * @dev Checks if a signature is valid for a given signer and data hash. The signature is validated\n * against the signer smart contract using ERC1271.\n *\n * NOTE: Unlike ECDSA signatures, contract signatures are revocable, and the outcome of this function can thus\n * change through time. It could return true at block N and false at block N+1 (or the opposite).\n */\n function isValidERC1271SignatureNow(\n address signer,\n bytes32 hash,\n bytes memory signature\n ) internal view returns (bool) {\n (bool success, bytes memory result) = signer.staticcall(\n abi.encodeWithSelector(IERC1271.isValidSignature.selector, hash, signature)\n );\n return (success &&\n result.length >= 32 &&\n abi.decode(result, (bytes32)) == bytes32(IERC1271.isValidSignature.selector));\n }\n}\n"
+ },
+ "@openzeppelin/contracts/utils/math/Math.sol": {
+ "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (utils/math/Math.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @dev Standard math utilities missing in the Solidity language.\n */\nlibrary Math {\n enum Rounding {\n Down, // Toward negative infinity\n Up, // Toward infinity\n Zero // Toward zero\n }\n\n /**\n * @dev Returns the largest of two numbers.\n */\n function max(uint256 a, uint256 b) internal pure returns (uint256) {\n return a > b ? a : b;\n }\n\n /**\n * @dev Returns the smallest of two numbers.\n */\n function min(uint256 a, uint256 b) internal pure returns (uint256) {\n return a < b ? a : b;\n }\n\n /**\n * @dev Returns the average of two numbers. The result is rounded towards\n * zero.\n */\n function average(uint256 a, uint256 b) internal pure returns (uint256) {\n // (a + b) / 2 can overflow.\n return (a & b) + (a ^ b) / 2;\n }\n\n /**\n * @dev Returns the ceiling of the division of two numbers.\n *\n * This differs from standard division with `/` in that it rounds up instead\n * of rounding down.\n */\n function ceilDiv(uint256 a, uint256 b) internal pure returns (uint256) {\n // (a + b - 1) / b can overflow on addition, so we distribute.\n return a == 0 ? 0 : (a - 1) / b + 1;\n }\n\n /**\n * @notice Calculates floor(x * y / denominator) with full precision. Throws if result overflows a uint256 or denominator == 0\n * @dev Original credit to Remco Bloemen under MIT license (https://xn--2-umb.com/21/muldiv)\n * with further edits by Uniswap Labs also under MIT license.\n */\n function mulDiv(uint256 x, uint256 y, uint256 denominator) internal pure returns (uint256 result) {\n unchecked {\n // 512-bit multiply [prod1 prod0] = x * y. Compute the product mod 2^256 and mod 2^256 - 1, then use\n // use the Chinese Remainder Theorem to reconstruct the 512 bit result. The result is stored in two 256\n // variables such that product = prod1 * 2^256 + prod0.\n uint256 prod0; // Least significant 256 bits of the product\n uint256 prod1; // Most significant 256 bits of the product\n assembly {\n let mm := mulmod(x, y, not(0))\n prod0 := mul(x, y)\n prod1 := sub(sub(mm, prod0), lt(mm, prod0))\n }\n\n // Handle non-overflow cases, 256 by 256 division.\n if (prod1 == 0) {\n // Solidity will revert if denominator == 0, unlike the div opcode on its own.\n // The surrounding unchecked block does not change this fact.\n // See https://docs.soliditylang.org/en/latest/control-structures.html#checked-or-unchecked-arithmetic.\n return prod0 / denominator;\n }\n\n // Make sure the result is less than 2^256. Also prevents denominator == 0.\n require(denominator > prod1, \"Math: mulDiv overflow\");\n\n ///////////////////////////////////////////////\n // 512 by 256 division.\n ///////////////////////////////////////////////\n\n // Make division exact by subtracting the remainder from [prod1 prod0].\n uint256 remainder;\n assembly {\n // Compute remainder using mulmod.\n remainder := mulmod(x, y, denominator)\n\n // Subtract 256 bit number from 512 bit number.\n prod1 := sub(prod1, gt(remainder, prod0))\n prod0 := sub(prod0, remainder)\n }\n\n // Factor powers of two out of denominator and compute largest power of two divisor of denominator. Always >= 1.\n // See https://cs.stackexchange.com/q/138556/92363.\n\n // Does not overflow because the denominator cannot be zero at this stage in the function.\n uint256 twos = denominator & (~denominator + 1);\n assembly {\n // Divide denominator by twos.\n denominator := div(denominator, twos)\n\n // Divide [prod1 prod0] by twos.\n prod0 := div(prod0, twos)\n\n // Flip twos such that it is 2^256 / twos. If twos is zero, then it becomes one.\n twos := add(div(sub(0, twos), twos), 1)\n }\n\n // Shift in bits from prod1 into prod0.\n prod0 |= prod1 * twos;\n\n // Invert denominator mod 2^256. Now that denominator is an odd number, it has an inverse modulo 2^256 such\n // that denominator * inv = 1 mod 2^256. Compute the inverse by starting with a seed that is correct for\n // four bits. That is, denominator * inv = 1 mod 2^4.\n uint256 inverse = (3 * denominator) ^ 2;\n\n // Use the Newton-Raphson iteration to improve the precision. Thanks to Hensel's lifting lemma, this also works\n // in modular arithmetic, doubling the correct bits in each step.\n inverse *= 2 - denominator * inverse; // inverse mod 2^8\n inverse *= 2 - denominator * inverse; // inverse mod 2^16\n inverse *= 2 - denominator * inverse; // inverse mod 2^32\n inverse *= 2 - denominator * inverse; // inverse mod 2^64\n inverse *= 2 - denominator * inverse; // inverse mod 2^128\n inverse *= 2 - denominator * inverse; // inverse mod 2^256\n\n // Because the division is now exact we can divide by multiplying with the modular inverse of denominator.\n // This will give us the correct result modulo 2^256. Since the preconditions guarantee that the outcome is\n // less than 2^256, this is the final result. We don't need to compute the high bits of the result and prod1\n // is no longer required.\n result = prod0 * inverse;\n return result;\n }\n }\n\n /**\n * @notice Calculates x * y / denominator with full precision, following the selected rounding direction.\n */\n function mulDiv(uint256 x, uint256 y, uint256 denominator, Rounding rounding) internal pure returns (uint256) {\n uint256 result = mulDiv(x, y, denominator);\n if (rounding == Rounding.Up && mulmod(x, y, denominator) > 0) {\n result += 1;\n }\n return result;\n }\n\n /**\n * @dev Returns the square root of a number. If the number is not a perfect square, the value is rounded down.\n *\n * Inspired by Henry S. Warren, Jr.'s \"Hacker's Delight\" (Chapter 11).\n */\n function sqrt(uint256 a) internal pure returns (uint256) {\n if (a == 0) {\n return 0;\n }\n\n // For our first guess, we get the biggest power of 2 which is smaller than the square root of the target.\n //\n // We know that the \"msb\" (most significant bit) of our target number `a` is a power of 2 such that we have\n // `msb(a) <= a < 2*msb(a)`. This value can be written `msb(a)=2**k` with `k=log2(a)`.\n //\n // This can be rewritten `2**log2(a) <= a < 2**(log2(a) + 1)`\n // → `sqrt(2**k) <= sqrt(a) < sqrt(2**(k+1))`\n // → `2**(k/2) <= sqrt(a) < 2**((k+1)/2) <= 2**(k/2 + 1)`\n //\n // Consequently, `2**(log2(a) / 2)` is a good first approximation of `sqrt(a)` with at least 1 correct bit.\n uint256 result = 1 << (log2(a) >> 1);\n\n // At this point `result` is an estimation with one bit of precision. We know the true value is a uint128,\n // since it is the square root of a uint256. Newton's method converges quadratically (precision doubles at\n // every iteration). We thus need at most 7 iteration to turn our partial result with one bit of precision\n // into the expected uint128 result.\n unchecked {\n result = (result + a / result) >> 1;\n result = (result + a / result) >> 1;\n result = (result + a / result) >> 1;\n result = (result + a / result) >> 1;\n result = (result + a / result) >> 1;\n result = (result + a / result) >> 1;\n result = (result + a / result) >> 1;\n return min(result, a / result);\n }\n }\n\n /**\n * @notice Calculates sqrt(a), following the selected rounding direction.\n */\n function sqrt(uint256 a, Rounding rounding) internal pure returns (uint256) {\n unchecked {\n uint256 result = sqrt(a);\n return result + (rounding == Rounding.Up && result * result < a ? 1 : 0);\n }\n }\n\n /**\n * @dev Return the log in base 2, rounded down, of a positive value.\n * Returns 0 if given 0.\n */\n function log2(uint256 value) internal pure returns (uint256) {\n uint256 result = 0;\n unchecked {\n if (value >> 128 > 0) {\n value >>= 128;\n result += 128;\n }\n if (value >> 64 > 0) {\n value >>= 64;\n result += 64;\n }\n if (value >> 32 > 0) {\n value >>= 32;\n result += 32;\n }\n if (value >> 16 > 0) {\n value >>= 16;\n result += 16;\n }\n if (value >> 8 > 0) {\n value >>= 8;\n result += 8;\n }\n if (value >> 4 > 0) {\n value >>= 4;\n result += 4;\n }\n if (value >> 2 > 0) {\n value >>= 2;\n result += 2;\n }\n if (value >> 1 > 0) {\n result += 1;\n }\n }\n return result;\n }\n\n /**\n * @dev Return the log in base 2, following the selected rounding direction, of a positive value.\n * Returns 0 if given 0.\n */\n function log2(uint256 value, Rounding rounding) internal pure returns (uint256) {\n unchecked {\n uint256 result = log2(value);\n return result + (rounding == Rounding.Up && 1 << result < value ? 1 : 0);\n }\n }\n\n /**\n * @dev Return the log in base 10, rounded down, of a positive value.\n * Returns 0 if given 0.\n */\n function log10(uint256 value) internal pure returns (uint256) {\n uint256 result = 0;\n unchecked {\n if (value >= 10 ** 64) {\n value /= 10 ** 64;\n result += 64;\n }\n if (value >= 10 ** 32) {\n value /= 10 ** 32;\n result += 32;\n }\n if (value >= 10 ** 16) {\n value /= 10 ** 16;\n result += 16;\n }\n if (value >= 10 ** 8) {\n value /= 10 ** 8;\n result += 8;\n }\n if (value >= 10 ** 4) {\n value /= 10 ** 4;\n result += 4;\n }\n if (value >= 10 ** 2) {\n value /= 10 ** 2;\n result += 2;\n }\n if (value >= 10 ** 1) {\n result += 1;\n }\n }\n return result;\n }\n\n /**\n * @dev Return the log in base 10, following the selected rounding direction, of a positive value.\n * Returns 0 if given 0.\n */\n function log10(uint256 value, Rounding rounding) internal pure returns (uint256) {\n unchecked {\n uint256 result = log10(value);\n return result + (rounding == Rounding.Up && 10 ** result < value ? 1 : 0);\n }\n }\n\n /**\n * @dev Return the log in base 256, rounded down, of a positive value.\n * Returns 0 if given 0.\n *\n * Adding one to the result gives the number of pairs of hex symbols needed to represent `value` as a hex string.\n */\n function log256(uint256 value) internal pure returns (uint256) {\n uint256 result = 0;\n unchecked {\n if (value >> 128 > 0) {\n value >>= 128;\n result += 16;\n }\n if (value >> 64 > 0) {\n value >>= 64;\n result += 8;\n }\n if (value >> 32 > 0) {\n value >>= 32;\n result += 4;\n }\n if (value >> 16 > 0) {\n value >>= 16;\n result += 2;\n }\n if (value >> 8 > 0) {\n result += 1;\n }\n }\n return result;\n }\n\n /**\n * @dev Return the log in base 256, following the selected rounding direction, of a positive value.\n * Returns 0 if given 0.\n */\n function log256(uint256 value, Rounding rounding) internal pure returns (uint256) {\n unchecked {\n uint256 result = log256(value);\n return result + (rounding == Rounding.Up && 1 << (result << 3) < value ? 1 : 0);\n }\n }\n}\n"
+ },
+ "@openzeppelin/contracts/utils/math/SignedMath.sol": {
+ "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.8.0) (utils/math/SignedMath.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @dev Standard signed math utilities missing in the Solidity language.\n */\nlibrary SignedMath {\n /**\n * @dev Returns the largest of two signed numbers.\n */\n function max(int256 a, int256 b) internal pure returns (int256) {\n return a > b ? a : b;\n }\n\n /**\n * @dev Returns the smallest of two signed numbers.\n */\n function min(int256 a, int256 b) internal pure returns (int256) {\n return a < b ? a : b;\n }\n\n /**\n * @dev Returns the average of two signed numbers without overflow.\n * The result is rounded towards zero.\n */\n function average(int256 a, int256 b) internal pure returns (int256) {\n // Formula from the book \"Hacker's Delight\"\n int256 x = (a & b) + ((a ^ b) >> 1);\n return x + (int256(uint256(x) >> 255) & (a ^ b));\n }\n\n /**\n * @dev Returns the absolute unsigned value of a signed value.\n */\n function abs(int256 n) internal pure returns (uint256) {\n unchecked {\n // must be unchecked in order to support `n = type(int256).min`\n return uint256(n >= 0 ? n : -n);\n }\n }\n}\n"
+ },
+ "@openzeppelin/contracts/utils/Strings.sol": {
+ "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (utils/Strings.sol)\n\npragma solidity ^0.8.0;\n\nimport \"./math/Math.sol\";\nimport \"./math/SignedMath.sol\";\n\n/**\n * @dev String operations.\n */\nlibrary Strings {\n bytes16 private constant _SYMBOLS = \"0123456789abcdef\";\n uint8 private constant _ADDRESS_LENGTH = 20;\n\n /**\n * @dev Converts a `uint256` to its ASCII `string` decimal representation.\n */\n function toString(uint256 value) internal pure returns (string memory) {\n unchecked {\n uint256 length = Math.log10(value) + 1;\n string memory buffer = new string(length);\n uint256 ptr;\n /// @solidity memory-safe-assembly\n assembly {\n ptr := add(buffer, add(32, length))\n }\n while (true) {\n ptr--;\n /// @solidity memory-safe-assembly\n assembly {\n mstore8(ptr, byte(mod(value, 10), _SYMBOLS))\n }\n value /= 10;\n if (value == 0) break;\n }\n return buffer;\n }\n }\n\n /**\n * @dev Converts a `int256` to its ASCII `string` decimal representation.\n */\n function toString(int256 value) internal pure returns (string memory) {\n return string(abi.encodePacked(value < 0 ? \"-\" : \"\", toString(SignedMath.abs(value))));\n }\n\n /**\n * @dev Converts a `uint256` to its ASCII `string` hexadecimal representation.\n */\n function toHexString(uint256 value) internal pure returns (string memory) {\n unchecked {\n return toHexString(value, Math.log256(value) + 1);\n }\n }\n\n /**\n * @dev Converts a `uint256` to its ASCII `string` hexadecimal representation with fixed length.\n */\n function toHexString(uint256 value, uint256 length) internal pure returns (string memory) {\n bytes memory buffer = new bytes(2 * length + 2);\n buffer[0] = \"0\";\n buffer[1] = \"x\";\n for (uint256 i = 2 * length + 1; i > 1; --i) {\n buffer[i] = _SYMBOLS[value & 0xf];\n value >>= 4;\n }\n require(value == 0, \"Strings: hex length insufficient\");\n return string(buffer);\n }\n\n /**\n * @dev Converts an `address` with fixed length of 20 bytes to its not checksummed ASCII `string` hexadecimal representation.\n */\n function toHexString(address addr) internal pure returns (string memory) {\n return toHexString(uint256(uint160(addr)), _ADDRESS_LENGTH);\n }\n\n /**\n * @dev Returns true if the two strings are equal.\n */\n function equal(string memory a, string memory b) internal pure returns (bool) {\n return keccak256(bytes(a)) == keccak256(bytes(b));\n }\n}\n"
+ },
+ "contracts/erc7683/ERC7683.sol": {
+ "content": "// SPDX-License-Identifier: GPL-3.0-or-later\npragma solidity ^0.8.0;\n\n/// @title GaslessCrossChainOrder CrossChainOrder type\n/// @notice Standard order struct to be signed by users, disseminated to fillers, and submitted to origin settler contracts\nstruct GaslessCrossChainOrder {\n /// @dev The contract address that the order is meant to be settled by.\n /// Fillers send this order to this contract address on the origin chain\n address originSettler;\n /// @dev The address of the user who is initiating the swap,\n /// whose input tokens will be taken and escrowed\n address user;\n /// @dev Nonce to be used as replay protection for the order\n uint256 nonce;\n /// @dev The chainId of the origin chain\n uint256 originChainId;\n /// @dev The timestamp by which the order must be opened\n uint32 openDeadline;\n /// @dev The timestamp by which the order must be filled on the destination chain\n uint32 fillDeadline;\n /// @dev Type identifier for the order data. This is an EIP-712 typehash.\n bytes32 orderDataType;\n /// @dev Arbitrary implementation-specific data\n /// Can be used to define tokens, amounts, destination chains, fees, settlement parameters,\n /// or any other order-type specific information\n bytes orderData;\n}\n\n/// @title OnchainCrossChainOrder CrossChainOrder type\n/// @notice Standard order struct for user-opened orders, where the user is the msg.sender.\nstruct OnchainCrossChainOrder {\n /// @dev The timestamp by which the order must be filled on the destination chain\n uint32 fillDeadline;\n /// @dev Type identifier for the order data. This is an EIP-712 typehash.\n bytes32 orderDataType;\n /// @dev Arbitrary implementation-specific data\n /// Can be used to define tokens, amounts, destination chains, fees, settlement parameters,\n /// or any other order-type specific information\n bytes orderData;\n}\n\n/// @title ResolvedCrossChainOrder type\n/// @notice An implementation-generic representation of an order intended for filler consumption\n/// @dev Defines all requirements for filling an order by unbundling the implementation-specific orderData.\n/// @dev Intended to improve integration generalization by allowing fillers to compute the exact input and output information of any order\nstruct ResolvedCrossChainOrder {\n /// @dev The address of the user who is initiating the transfer\n address user;\n /// @dev The chainId of the origin chain\n uint256 originChainId;\n /// @dev The timestamp by which the order must be opened\n uint32 openDeadline;\n /// @dev The timestamp by which the order must be filled on the destination chain(s)\n uint32 fillDeadline;\n /// @dev The unique identifier for this order within this settlement system\n bytes32 orderId;\n /// @dev The max outputs that the filler will send. It's possible the actual amount depends on the state of the destination\n /// chain (destination dutch auction, for instance), so these outputs should be considered a cap on filler liabilities.\n Output[] maxSpent;\n /// @dev The minimum outputs that must to be given to the filler as part of order settlement. Similar to maxSpent, it's possible\n /// that special order types may not be able to guarantee the exact amount at open time, so this should be considered\n /// a floor on filler receipts.\n Output[] minReceived;\n /// @dev Each instruction in this array is parameterizes a single leg of the fill. This provides the filler with the information\n /// necessary to perform the fill on the destination(s).\n FillInstruction[] fillInstructions;\n}\n\n/// @notice Tokens that must be receive for a valid order fulfillment\nstruct Output {\n /// @dev The address of the ERC20 token on the destination chain\n /// @dev address(0) used as a sentinel for the native token\n bytes32 token;\n /// @dev The amount of the token to be sent\n uint256 amount;\n /// @dev The address to receive the output tokens\n bytes32 recipient;\n /// @dev The destination chain for this output\n uint256 chainId;\n}\n\n/// @title FillInstruction type\n/// @notice Instructions to parameterize each leg of the fill\n/// @dev Provides all the origin-generated information required to produce a valid fill leg\nstruct FillInstruction {\n /// @dev The contract address that the order is meant to be settled by\n uint64 destinationChainId;\n /// @dev The contract address that the order is meant to be filled on\n bytes32 destinationSettler;\n /// @dev The data generated on the origin chain needed by the destinationSettler to process the fill\n bytes originData;\n}\n\n/// @title IOriginSettler\n/// @notice Standard interface for settlement contracts on the origin chain\ninterface IOriginSettler {\n /// @notice Signals that an order has been opened\n /// @param orderId a unique order identifier within this settlement system\n /// @param resolvedOrder resolved order that would be returned by resolve if called instead of Open\n event Open(bytes32 indexed orderId, ResolvedCrossChainOrder resolvedOrder);\n\n /// @notice Opens a gasless cross-chain order on behalf of a user.\n /// @dev To be called by the filler.\n /// @dev This method must emit the Open event\n /// @param order The GaslessCrossChainOrder definition\n /// @param signature The user's signature over the order\n /// @param originFillerData Any filler-defined data required by the settler\n function openFor(\n GaslessCrossChainOrder calldata order,\n bytes calldata signature,\n bytes calldata originFillerData\n ) external;\n\n /// @notice Opens a cross-chain order\n /// @dev To be called by the user\n /// @dev This method must emit the Open event\n /// @param order The OnchainCrossChainOrder definition\n function open(OnchainCrossChainOrder calldata order) external;\n\n /// @notice Resolves a specific GaslessCrossChainOrder into a generic ResolvedCrossChainOrder\n /// @dev Intended to improve standardized integration of various order types and settlement contracts\n /// @param order The GaslessCrossChainOrder definition\n /// @param originFillerData Any filler-defined data required by the settler\n /// @return ResolvedCrossChainOrder hydrated order data including the inputs and outputs of the order\n function resolveFor(GaslessCrossChainOrder calldata order, bytes calldata originFillerData)\n external\n view\n returns (ResolvedCrossChainOrder memory);\n\n /// @notice Resolves a specific OnchainCrossChainOrder into a generic ResolvedCrossChainOrder\n /// @dev Intended to improve standardized integration of various order types and settlement contracts\n /// @param order The OnchainCrossChainOrder definition\n /// @return ResolvedCrossChainOrder hydrated order data including the inputs and outputs of the order\n function resolve(OnchainCrossChainOrder calldata order) external view returns (ResolvedCrossChainOrder memory);\n}\n\n/// @title IDestinationSettler\n/// @notice Standard interface for settlement contracts on the destination chain\ninterface IDestinationSettler {\n /// @notice Fills a single leg of a particular order on the destination chain\n /// @param orderId Unique order identifier for this order\n /// @param originData Data emitted on the origin to parameterize the fill\n /// @param fillerData Data provided by the filler to inform the fill or express their preferences\n function fill(\n bytes32 orderId,\n bytes calldata originData,\n bytes calldata fillerData\n ) external;\n}\n"
+ },
+ "contracts/erc7683/ERC7683Permit2Lib.sol": {
+ "content": "// SPDX-License-Identifier: UNLICENSED\npragma solidity ^0.8.0;\n\nimport \"../external/interfaces/IPermit2.sol\";\nimport { GaslessCrossChainOrder } from \"./ERC7683.sol\";\n\n// Data unique to every CrossChainOrder settled on Across\nstruct AcrossOrderData {\n address inputToken;\n uint256 inputAmount;\n address outputToken;\n uint256 outputAmount;\n uint256 destinationChainId;\n bytes32 recipient;\n address exclusiveRelayer;\n /// @notice User needs to be careful not to re-use a deposit nonce when depositing into Across otherwise the\n /// user risks their deposit being unfillable. See @across/contracts/SpokePool.sol#unsafeDeposit() for\n /// more details on this situation.\n uint256 depositNonce;\n uint32 exclusivityPeriod;\n bytes message;\n}\n\nstruct AcrossOriginFillerData {\n address exclusiveRelayer;\n}\n\nstruct AcrossDestinationFillerData {\n uint256 repaymentChainId;\n}\n\nbytes constant ACROSS_ORDER_DATA_TYPE = abi.encodePacked(\n \"AcrossOrderData(\",\n \"address inputToken,\",\n \"uint256 inputAmount,\",\n \"address outputToken,\",\n \"uint256 outputAmount,\",\n \"uint256 destinationChainId,\",\n \"bytes32 recipient,\",\n \"address exclusiveRelayer,\"\n \"uint256 depositNonce,\",\n \"uint32 exclusivityPeriod,\",\n \"bytes message)\"\n);\n\nbytes32 constant ACROSS_ORDER_DATA_TYPE_HASH = keccak256(ACROSS_ORDER_DATA_TYPE);\n\n/**\n * @notice ERC7683Permit2Lib knows how to process a particular type of external Permit2Order so that it can be used in Across.\n * @dev This library is responsible for definining the ERC712 type strings/hashes and performing hashes on the types.\n * @custom:security-contact bugs@across.to\n */\nlibrary ERC7683Permit2Lib {\n bytes internal constant GASLESS_CROSS_CHAIN_ORDER_TYPE =\n abi.encodePacked(\n \"GaslessCrossChainOrder(\",\n \"address originSettler,\",\n \"address user,\",\n \"uint256 nonce,\",\n \"uint256 originChainId,\",\n \"uint32 openDeadline,\",\n \"uint32 fillDeadline,\",\n \"bytes32 orderDataType,\",\n \"AcrossOrderData orderData)\"\n );\n\n bytes internal constant GASLESS_CROSS_CHAIN_ORDER_EIP712_TYPE =\n abi.encodePacked(GASLESS_CROSS_CHAIN_ORDER_TYPE, ACROSS_ORDER_DATA_TYPE);\n bytes32 internal constant GASLESS_CROSS_CHAIN_ORDER_TYPE_HASH = keccak256(GASLESS_CROSS_CHAIN_ORDER_EIP712_TYPE);\n\n string private constant TOKEN_PERMISSIONS_TYPE = \"TokenPermissions(address token,uint256 amount)\";\n string internal constant PERMIT2_ORDER_TYPE =\n string(\n abi.encodePacked(\n \"GaslessCrossChainOrder witness)\",\n ACROSS_ORDER_DATA_TYPE,\n GASLESS_CROSS_CHAIN_ORDER_TYPE,\n TOKEN_PERMISSIONS_TYPE\n )\n );\n\n // Hashes an order to get an order hash. Needed for permit2.\n function hashOrder(GaslessCrossChainOrder memory order, bytes32 orderDataHash) internal pure returns (bytes32) {\n return\n keccak256(\n abi.encode(\n GASLESS_CROSS_CHAIN_ORDER_TYPE_HASH,\n order.originSettler,\n order.user,\n order.nonce,\n order.originChainId,\n order.openDeadline,\n order.fillDeadline,\n order.orderDataType,\n orderDataHash\n )\n );\n }\n\n function hashOrderData(AcrossOrderData memory orderData) internal pure returns (bytes32) {\n return\n keccak256(\n abi.encode(\n ACROSS_ORDER_DATA_TYPE_HASH,\n orderData.inputToken,\n orderData.inputAmount,\n orderData.outputToken,\n orderData.outputAmount,\n orderData.destinationChainId,\n orderData.recipient,\n orderData.exclusiveRelayer,\n orderData.depositNonce,\n orderData.exclusivityPeriod,\n keccak256(orderData.message)\n )\n );\n }\n}\n"
+ },
+ "contracts/external/interfaces/CCTPInterfaces.sol": {
+ "content": "/**\n * Copyright (C) 2015, 2016, 2017 Dapphub\n *\n * This program is free software: you can redistribute it and/or modify\n * it under the terms of the GNU General Public License as published by\n * the Free Software Foundation, either version 3 of the License, or\n * (at your option) any later version.\n *\n * This program is distributed in the hope that it will be useful,\n * but WITHOUT ANY WARRANTY; without even the implied warranty of\n * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the\n * GNU General Public License for more details.\n *\n * You should have received a copy of the GNU General Public License\n * along with this program. If not, see .\n */\n\n// SPDX-License-Identifier: GPL-3.0-or-later\npragma solidity ^0.8.0;\n\n/**\n * Imported as-is from commit 139d8d0ce3b5531d3c7ec284f89d946dfb720016 of:\n * * https://github.com/walkerq/evm-cctp-contracts/blob/139d8d0ce3b5531d3c7ec284f89d946dfb720016/src/TokenMessenger.sol\n * Changes applied post-import:\n * * Removed a majority of code from this contract and converted the needed function signatures in this interface.\n */\ninterface ITokenMessenger {\n /**\n * @notice Deposits and burns tokens from sender to be minted on destination domain.\n * Emits a `DepositForBurn` event.\n * @dev reverts if:\n * - given burnToken is not supported\n * - given destinationDomain has no TokenMessenger registered\n * - transferFrom() reverts. For example, if sender's burnToken balance or approved allowance\n * to this contract is less than `amount`.\n * - burn() reverts. For example, if `amount` is 0.\n * - MessageTransmitter returns false or reverts.\n * @param amount amount of tokens to burn\n * @param destinationDomain destination domain\n * @param mintRecipient address of mint recipient on destination domain\n * @param burnToken address of contract to burn deposited tokens, on local domain\n * @return _nonce unique nonce reserved by message\n */\n function depositForBurn(\n uint256 amount,\n uint32 destinationDomain,\n bytes32 mintRecipient,\n address burnToken\n ) external returns (uint64 _nonce);\n\n /**\n * @notice Minter responsible for minting and burning tokens on the local domain\n * @dev A TokenMessenger stores a TokenMinter contract which extends the TokenController contract.\n * https://github.com/circlefin/evm-cctp-contracts/blob/817397db0a12963accc08ff86065491577bbc0e5/src/TokenMessenger.sol#L110\n * @return minter Token Minter contract.\n */\n function localMinter() external view returns (ITokenMinter minter);\n}\n\n// Source: https://github.com/circlefin/evm-cctp-contracts/blob/63ab1f0ac06ce0793c0bbfbb8d09816bc211386d/src/v2/TokenMessengerV2.sol#L138C1-L166C15\ninterface ITokenMessengerV2 {\n /**\n * @notice Deposits and burns tokens from sender to be minted on destination domain.\n * Emits a `DepositForBurn` event.\n * @dev reverts if:\n * - given burnToken is not supported\n * - given destinationDomain has no TokenMessenger registered\n * - transferFrom() reverts. For example, if sender's burnToken balance or approved allowance\n * to this contract is less than `amount`.\n * - burn() reverts. For example, if `amount` is 0.\n * - maxFee is greater than or equal to `amount`.\n * - MessageTransmitterV2#sendMessage reverts.\n * @param amount amount of tokens to burn\n * @param destinationDomain destination domain to receive message on\n * @param mintRecipient address of mint recipient on destination domain\n * @param burnToken token to burn `amount` of, on local domain\n * @param destinationCaller authorized caller on the destination domain, as bytes32. If equal to bytes32(0),\n * any address can broadcast the message.\n * @param maxFee maximum fee to pay on the destination domain, specified in units of burnToken\n * @param minFinalityThreshold the minimum finality at which a burn message will be attested to.\n */\n function depositForBurn(\n uint256 amount,\n uint32 destinationDomain,\n bytes32 mintRecipient,\n address burnToken,\n bytes32 destinationCaller,\n uint256 maxFee,\n uint32 minFinalityThreshold\n ) external;\n}\n\n/**\n * A TokenMessenger stores a TokenMinter contract which extends the TokenController contract. The TokenController\n * contract has a burnLimitsPerMessage public mapping which can be queried to find the per-message burn limit\n * for a given token:\n * https://github.com/circlefin/evm-cctp-contracts/blob/817397db0a12963accc08ff86065491577bbc0e5/src/TokenMinter.sol#L33\n * https://github.com/circlefin/evm-cctp-contracts/blob/817397db0a12963accc08ff86065491577bbc0e5/src/roles/TokenController.sol#L69C40-L69C60\n *\n */\ninterface ITokenMinter {\n /**\n * @notice Supported burnable tokens on the local domain\n * local token (address) => maximum burn amounts per message\n * @param token address of token contract\n * @return burnLimit maximum burn amount per message for token\n */\n function burnLimitsPerMessage(address token) external view returns (uint256);\n}\n\n/**\n * IMessageTransmitter in CCTP inherits IRelayer and IReceiver, but here we only import sendMessage from IRelayer:\n * https://github.com/circlefin/evm-cctp-contracts/blob/377c9bd813fb86a42d900ae4003599d82aef635a/src/interfaces/IMessageTransmitter.sol#L25\n * https://github.com/circlefin/evm-cctp-contracts/blob/377c9bd813fb86a42d900ae4003599d82aef635a/src/interfaces/IRelayer.sol#L23-L35\n */\ninterface IMessageTransmitter {\n /**\n * @notice Sends an outgoing message from the source domain.\n * @dev Increment nonce, format the message, and emit `MessageSent` event with message information.\n * @param destinationDomain Domain of destination chain\n * @param recipient Address of message recipient on destination domain as bytes32\n * @param messageBody Raw bytes content of message\n * @return nonce reserved by message\n */\n function sendMessage(\n uint32 destinationDomain,\n bytes32 recipient,\n bytes calldata messageBody\n ) external returns (uint64);\n}\n"
+ },
+ "contracts/external/interfaces/IPermit2.sol": {
+ "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\ninterface IPermit2 {\n struct TokenPermissions {\n address token;\n uint256 amount;\n }\n\n struct PermitTransferFrom {\n TokenPermissions permitted;\n uint256 nonce;\n uint256 deadline;\n }\n\n struct SignatureTransferDetails {\n address to;\n uint256 requestedAmount;\n }\n\n function permitWitnessTransferFrom(\n PermitTransferFrom memory permit,\n SignatureTransferDetails calldata transferDetails,\n address owner,\n bytes32 witness,\n string calldata witnessTypeString,\n bytes calldata signature\n ) external;\n\n function transferFrom(\n address from,\n address to,\n uint160 amount,\n address token\n ) external;\n}\n"
+ },
+ "contracts/external/interfaces/WETH9Interface.sol": {
+ "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\n\n/**\n * @notice Interface for the WETH9 contract.\n */\ninterface WETH9Interface {\n /**\n * @notice Burn Wrapped Ether and receive native Ether.\n * @param wad Amount of WETH to unwrap and send to caller.\n */\n function withdraw(uint256 wad) external;\n\n /**\n * @notice Lock native Ether and mint Wrapped Ether ERC20\n * @dev msg.value is amount of Wrapped Ether to mint/Ether to lock.\n */\n function deposit() external payable;\n\n /**\n * @notice Get balance of WETH held by `guy`.\n * @param guy Address to get balance of.\n * @return wad Amount of WETH held by `guy`.\n */\n function balanceOf(address guy) external view returns (uint256 wad);\n\n /**\n * @notice Transfer `wad` of WETH from caller to `guy`.\n * @param guy Address to send WETH to.\n * @param wad Amount of WETH to send.\n * @return ok True if transfer succeeded.\n */\n function transfer(address guy, uint256 wad) external returns (bool);\n}\n"
+ },
+ "contracts/interfaces/HubPoolInterface.sol": {
+ "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport \"@openzeppelin/contracts/token/ERC20/IERC20.sol\";\n\n/**\n * @notice Concise list of functions in HubPool implementation.\n */\ninterface HubPoolInterface {\n // This leaf is meant to be decoded in the HubPool to rebalance tokens between HubPool and SpokePool.\n struct PoolRebalanceLeaf {\n // This is used to know which chain to send cross-chain transactions to (and which SpokePool to send to).\n uint256 chainId;\n // Total LP fee amount per token in this bundle, encompassing all associated bundled relays.\n uint256[] bundleLpFees;\n // Represents the amount to push to or pull from the SpokePool. If +, the pool pays the SpokePool. If negative\n // the SpokePool pays the HubPool. There can be arbitrarily complex rebalancing rules defined offchain. This\n // number is only nonzero when the rules indicate that a rebalancing action should occur. When a rebalance does\n // occur, runningBalances must be set to zero for this token and netSendAmounts should be set to the previous\n // runningBalances + relays - deposits in this bundle. If non-zero then it must be set on the SpokePool's\n // RelayerRefundLeaf amountToReturn as -1 * this value to show if funds are being sent from or to the SpokePool.\n int256[] netSendAmounts;\n // This is only here to be emitted in an event to track a running unpaid balance between the L2 pool and the L1\n // pool. A positive number indicates that the HubPool owes the SpokePool funds. A negative number indicates that\n // the SpokePool owes the HubPool funds. See the comment above for the dynamics of this and netSendAmounts.\n int256[] runningBalances;\n // Used by data worker to mark which leaves should relay roots to SpokePools, and to otherwise organize leaves.\n // For example, each leaf should contain all the rebalance information for a single chain, but in the case where\n // the list of l1Tokens is very large such that they all can't fit into a single leaf that can be executed under\n // the block gas limit, then the data worker can use this groupIndex to organize them. Any leaves with\n // a groupIndex equal to 0 will relay roots to the SpokePool, so the data worker should ensure that only one\n // leaf for a specific chainId should have a groupIndex equal to 0.\n uint256 groupIndex;\n // Used as the index in the bitmap to track whether this leaf has been executed or not.\n uint8 leafId;\n // The bundleLpFees, netSendAmounts, and runningBalances are required to be the same length. They are parallel\n // arrays for the given chainId and should be ordered by the l1Tokens field. All whitelisted tokens with nonzero\n // relays on this chain in this bundle in the order of whitelisting.\n address[] l1Tokens;\n }\n\n // A data worker can optimistically store several merkle roots on this contract by staking a bond and calling\n // proposeRootBundle. By staking a bond, the data worker is alleging that the merkle roots all contain valid leaves\n // that can be executed later to:\n // - Send funds from this contract to a SpokePool or vice versa\n // - Send funds from a SpokePool to Relayer as a refund for a relayed deposit\n // - Send funds from a SpokePool to a deposit recipient to fulfill a \"slow\" relay\n // Anyone can dispute this struct if the merkle roots contain invalid leaves before the\n // challengePeriodEndTimestamp. Once the expiration timestamp is passed, executeRootBundle to execute a leaf\n // from the poolRebalanceRoot on this contract and it will simultaneously publish the relayerRefundRoot and\n // slowRelayRoot to a SpokePool. The latter two roots, once published to the SpokePool, contain\n // leaves that can be executed on the SpokePool to pay relayers or recipients.\n struct RootBundle {\n // Contains leaves instructing this contract to send funds to SpokePools.\n bytes32 poolRebalanceRoot;\n // Relayer refund merkle root to be published to a SpokePool.\n bytes32 relayerRefundRoot;\n // Slow relay merkle root to be published to a SpokePool.\n bytes32 slowRelayRoot;\n // This is a 1D bitmap, with max size of 256 elements, limiting us to 256 chainsIds.\n uint256 claimedBitMap;\n // Proposer of this root bundle.\n address proposer;\n // Number of pool rebalance leaves to execute in the poolRebalanceRoot. After this number\n // of leaves are executed, a new root bundle can be proposed\n uint8 unclaimedPoolRebalanceLeafCount;\n // When root bundle challenge period passes and this root bundle becomes executable.\n uint32 challengePeriodEndTimestamp;\n }\n\n // Each whitelisted L1 token has an associated pooledToken struct that contains all information used to track the\n // cumulative LP positions and if this token is enabled for deposits.\n struct PooledToken {\n // LP token given to LPs of a specific L1 token.\n address lpToken;\n // True if accepting new LP's.\n bool isEnabled;\n // Timestamp of last LP fee update.\n uint32 lastLpFeeUpdate;\n // Number of LP funds sent via pool rebalances to SpokePools and are expected to be sent\n // back later.\n int256 utilizedReserves;\n // Number of LP funds held in contract less utilized reserves.\n uint256 liquidReserves;\n // Number of LP funds reserved to pay out to LPs as fees.\n uint256 undistributedLpFees;\n }\n\n // Helper contracts to facilitate cross chain actions between HubPool and SpokePool for a specific network.\n struct CrossChainContract {\n address adapter;\n address spokePool;\n }\n\n function setPaused(bool pause) external;\n\n function emergencyDeleteProposal() external;\n\n function relaySpokePoolAdminFunction(uint256 chainId, bytes memory functionData) external;\n\n function setProtocolFeeCapture(address newProtocolFeeCaptureAddress, uint256 newProtocolFeeCapturePct) external;\n\n function setBond(IERC20 newBondToken, uint256 newBondAmount) external;\n\n function setLiveness(uint32 newLiveness) external;\n\n function setIdentifier(bytes32 newIdentifier) external;\n\n function setCrossChainContracts(\n uint256 l2ChainId,\n address adapter,\n address spokePool\n ) external;\n\n function enableL1TokenForLiquidityProvision(address l1Token) external;\n\n function disableL1TokenForLiquidityProvision(address l1Token) external;\n\n function addLiquidity(address l1Token, uint256 l1TokenAmount) external payable;\n\n function removeLiquidity(\n address l1Token,\n uint256 lpTokenAmount,\n bool sendEth\n ) external;\n\n function exchangeRateCurrent(address l1Token) external returns (uint256);\n\n function liquidityUtilizationCurrent(address l1Token) external returns (uint256);\n\n function liquidityUtilizationPostRelay(address l1Token, uint256 relayedAmount) external returns (uint256);\n\n function sync(address l1Token) external;\n\n function proposeRootBundle(\n uint256[] memory bundleEvaluationBlockNumbers,\n uint8 poolRebalanceLeafCount,\n bytes32 poolRebalanceRoot,\n bytes32 relayerRefundRoot,\n bytes32 slowRelayRoot\n ) external;\n\n function executeRootBundle(\n uint256 chainId,\n uint256 groupIndex,\n uint256[] memory bundleLpFees,\n int256[] memory netSendAmounts,\n int256[] memory runningBalances,\n uint8 leafId,\n address[] memory l1Tokens,\n bytes32[] memory proof\n ) external;\n\n function disputeRootBundle() external;\n\n function claimProtocolFeesCaptured(address l1Token) external;\n\n function setPoolRebalanceRoute(\n uint256 destinationChainId,\n address l1Token,\n address destinationToken\n ) external;\n\n function setDepositRoute(\n uint256 originChainId,\n uint256 destinationChainId,\n address originToken,\n bool depositsEnabled\n ) external;\n\n function poolRebalanceRoute(uint256 destinationChainId, address l1Token)\n external\n view\n returns (address destinationToken);\n\n function loadEthForL2Calls() external payable;\n}\n"
+ },
+ "contracts/interfaces/SpokePoolInterface.sol": {
+ "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\n/**\n * @notice Contains common data structures and functions used by all SpokePool implementations.\n */\ninterface SpokePoolInterface {\n // This leaf is meant to be decoded in the SpokePool to pay out successful relayers.\n struct RelayerRefundLeaf {\n // This is the amount to return to the HubPool. This occurs when there is a PoolRebalanceLeaf netSendAmount that\n // is negative. This is just the negative of this value.\n uint256 amountToReturn;\n // Used to verify that this is being executed on the correct destination chainId.\n uint256 chainId;\n // This array designates how much each of those addresses should be refunded.\n uint256[] refundAmounts;\n // Used as the index in the bitmap to track whether this leaf has been executed or not.\n uint32 leafId;\n // The associated L2TokenAddress that these claims apply to.\n address l2TokenAddress;\n // Must be same length as refundAmounts and designates each address that must be refunded.\n address[] refundAddresses;\n }\n\n // Stores collection of merkle roots that can be published to this contract from the HubPool, which are referenced\n // by \"data workers\" via inclusion proofs to execute leaves in the roots.\n struct RootBundle {\n // Merkle root of slow relays that were not fully filled and whose recipient is still owed funds from the LP pool.\n bytes32 slowRelayRoot;\n // Merkle root of relayer refunds for successful relays.\n bytes32 relayerRefundRoot;\n // This is a 2D bitmap tracking which leaves in the relayer refund root have been claimed, with max size of\n // 256x(2^248) leaves per root.\n mapping(uint256 => uint256) claimedBitmap;\n }\n\n function setCrossDomainAdmin(address newCrossDomainAdmin) external;\n\n function setWithdrawalRecipient(address newWithdrawalRecipient) external;\n\n function pauseDeposits(bool pause) external;\n\n function pauseFills(bool pause) external;\n\n function relayRootBundle(bytes32 relayerRefundRoot, bytes32 slowRelayRoot) external;\n\n function emergencyDeleteRootBundle(uint256 rootBundleId) external;\n\n function depositDeprecated_5947912356(\n address recipient,\n address originToken,\n uint256 amount,\n uint256 destinationChainId,\n int64 relayerFeePct,\n uint32 quoteTimestamp,\n bytes memory message,\n uint256 maxCount\n ) external payable;\n\n function depositFor(\n address depositor,\n address recipient,\n address originToken,\n uint256 amount,\n uint256 destinationChainId,\n int64 relayerFeePct,\n uint32 quoteTimestamp,\n bytes memory message,\n uint256 maxCount\n ) external payable;\n\n function executeRelayerRefundLeaf(\n uint32 rootBundleId,\n SpokePoolInterface.RelayerRefundLeaf memory relayerRefundLeaf,\n bytes32[] memory proof\n ) external payable;\n\n function chainId() external view returns (uint256);\n\n error NotEOA();\n error InvalidDepositorSignature();\n error InvalidRelayerFeePct();\n error MaxTransferSizeExceeded();\n error InvalidCrossDomainAdmin();\n error InvalidWithdrawalRecipient();\n error DepositsArePaused();\n error FillsArePaused();\n}\n"
+ },
+ "contracts/interfaces/SpokePoolMessageHandler.sol": {
+ "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\n// This interface is expected to be implemented by any contract that expects to receive messages from the SpokePool.\ninterface AcrossMessageHandler {\n function handleV3AcrossMessage(\n address tokenSent,\n uint256 amount,\n address relayer,\n bytes memory message\n ) external;\n}\n"
+ },
+ "contracts/interfaces/V3SpokePoolInterface.sol": {
+ "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\n// Contains structs and functions used by SpokePool contracts to facilitate universal settlement.\ninterface V3SpokePoolInterface {\n /**************************************\n * ENUMS *\n **************************************/\n\n // Fill status tracks on-chain state of deposit, uniquely identified by relayHash.\n enum FillStatus {\n Unfilled,\n RequestedSlowFill,\n Filled\n }\n // Fill type is emitted in the FilledRelay event to assist Dataworker with determining which types of\n // fills to refund (e.g. only fast fills) and whether a fast fill created a sow fill excess.\n enum FillType {\n FastFill,\n // Fast fills are normal fills that do not replace a slow fill request.\n ReplacedSlowFill,\n // Replaced slow fills are fast fills that replace a slow fill request. This type is used by the Dataworker\n // to know when to send excess funds from the SpokePool to the HubPool because they can no longer be used\n // for a slow fill execution.\n SlowFill\n }\n // Slow fills are requested via requestSlowFill and executed by executeSlowRelayLeaf after a bundle containing\n // the slow fill is validated.\n\n /**************************************\n * STRUCTS *\n **************************************/\n\n // This struct represents the data to fully specify a **unique** relay submitted on this chain.\n // This data is hashed with the chainId() and saved by the SpokePool to prevent collisions and protect against\n // replay attacks on other chains. If any portion of this data differs, the relay is considered to be\n // completely distinct.\n struct V3RelayData {\n // The bytes32 that made the deposit on the origin chain.\n bytes32 depositor;\n // The recipient bytes32 on the destination chain.\n bytes32 recipient;\n // This is the exclusive relayer who can fill the deposit before the exclusivity deadline.\n bytes32 exclusiveRelayer;\n // Token that is deposited on origin chain by depositor.\n bytes32 inputToken;\n // Token that is received on destination chain by recipient.\n bytes32 outputToken;\n // The amount of input token deposited by depositor.\n uint256 inputAmount;\n // The amount of output token to be received by recipient.\n uint256 outputAmount;\n // Origin chain id.\n uint256 originChainId;\n // The id uniquely identifying this deposit on the origin chain.\n uint256 depositId;\n // The timestamp on the destination chain after which this deposit can no longer be filled.\n uint32 fillDeadline;\n // The timestamp on the destination chain after which any relayer can fill the deposit.\n uint32 exclusivityDeadline;\n // Data that is forwarded to the recipient.\n bytes message;\n }\n\n // Same as V3RelayData but using addresses instead of bytes32 & depositId is uint32.\n // Will be deprecated in favor of V3RelayData in the future.\n struct V3RelayDataLegacy {\n address depositor;\n address recipient;\n address exclusiveRelayer;\n address inputToken;\n address outputToken;\n uint256 inputAmount;\n uint256 outputAmount;\n uint256 originChainId;\n uint32 depositId;\n uint32 fillDeadline;\n uint32 exclusivityDeadline;\n bytes message;\n }\n\n // Contains parameters passed in by someone who wants to execute a slow relay leaf.\n struct V3SlowFill {\n V3RelayData relayData;\n uint256 chainId;\n uint256 updatedOutputAmount;\n }\n\n // Contains information about a relay to be sent along with additional information that is not unique to the\n // relay itself but is required to know how to process the relay. For example, \"updatedX\" fields can be used\n // by the relayer to modify fields of the relay with the depositor's permission, and \"repaymentChainId\" is specified\n // by the relayer to determine where to take a relayer refund, but doesn't affect the uniqueness of the relay.\n struct V3RelayExecutionParams {\n V3RelayData relay;\n bytes32 relayHash;\n uint256 updatedOutputAmount;\n bytes32 updatedRecipient;\n bytes updatedMessage;\n uint256 repaymentChainId;\n }\n\n // Packs together parameters emitted in FilledRelay because there are too many emitted otherwise.\n // Similar to V3RelayExecutionParams, these parameters are not used to uniquely identify the deposit being\n // filled so they don't have to be unpacked by all clients.\n struct V3RelayExecutionEventInfo {\n bytes32 updatedRecipient;\n bytes32 updatedMessageHash;\n uint256 updatedOutputAmount;\n FillType fillType;\n }\n\n // Represents the parameters required for a V3 deposit operation in the SpokePool.\n struct DepositV3Params {\n bytes32 depositor;\n bytes32 recipient;\n bytes32 inputToken;\n bytes32 outputToken;\n uint256 inputAmount;\n uint256 outputAmount;\n uint256 destinationChainId;\n bytes32 exclusiveRelayer;\n uint256 depositId;\n uint32 quoteTimestamp;\n uint32 fillDeadline;\n uint32 exclusivityParameter;\n bytes message;\n }\n\n /**************************************\n * EVENTS *\n **************************************/\n\n event FundsDeposited(\n bytes32 inputToken,\n bytes32 outputToken,\n uint256 inputAmount,\n uint256 outputAmount,\n uint256 indexed destinationChainId,\n uint256 indexed depositId,\n uint32 quoteTimestamp,\n uint32 fillDeadline,\n uint32 exclusivityDeadline,\n bytes32 indexed depositor,\n bytes32 recipient,\n bytes32 exclusiveRelayer,\n bytes message\n );\n\n event RequestedSpeedUpDeposit(\n uint256 updatedOutputAmount,\n uint256 indexed depositId,\n bytes32 indexed depositor,\n bytes32 updatedRecipient,\n bytes updatedMessage,\n bytes depositorSignature\n );\n\n event FilledRelay(\n bytes32 inputToken,\n bytes32 outputToken,\n uint256 inputAmount,\n uint256 outputAmount,\n uint256 repaymentChainId,\n uint256 indexed originChainId,\n uint256 indexed depositId,\n uint32 fillDeadline,\n uint32 exclusivityDeadline,\n bytes32 exclusiveRelayer,\n bytes32 indexed relayer,\n bytes32 depositor,\n bytes32 recipient,\n bytes32 messageHash,\n V3RelayExecutionEventInfo relayExecutionInfo\n );\n\n event RequestedSlowFill(\n bytes32 inputToken,\n bytes32 outputToken,\n uint256 inputAmount,\n uint256 outputAmount,\n uint256 indexed originChainId,\n uint256 indexed depositId,\n uint32 fillDeadline,\n uint32 exclusivityDeadline,\n bytes32 exclusiveRelayer,\n bytes32 depositor,\n bytes32 recipient,\n bytes32 messageHash\n );\n\n event ClaimedRelayerRefund(\n bytes32 indexed l2TokenAddress,\n bytes32 indexed refundAddress,\n uint256 amount,\n address indexed caller\n );\n\n /**************************************\n * FUNCTIONS *\n **************************************/\n\n function deposit(\n bytes32 depositor,\n bytes32 recipient,\n bytes32 inputToken,\n bytes32 outputToken,\n uint256 inputAmount,\n uint256 outputAmount,\n uint256 destinationChainId,\n bytes32 exclusiveRelayer,\n uint32 quoteTimestamp,\n uint32 fillDeadline,\n uint32 exclusivityDeadline,\n bytes calldata message\n ) external payable;\n\n function depositV3(\n address depositor,\n address recipient,\n address inputToken,\n address outputToken,\n uint256 inputAmount,\n uint256 outputAmount,\n uint256 destinationChainId,\n address exclusiveRelayer,\n uint32 quoteTimestamp,\n uint32 fillDeadline,\n uint32 exclusivityDeadline,\n bytes calldata message\n ) external payable;\n\n function depositNow(\n bytes32 depositor,\n bytes32 recipient,\n bytes32 inputToken,\n bytes32 outputToken,\n uint256 inputAmount,\n uint256 outputAmount,\n uint256 destinationChainId,\n bytes32 exclusiveRelayer,\n uint32 fillDeadlineOffset,\n uint32 exclusivityDeadline,\n bytes calldata message\n ) external payable;\n\n function depositV3Now(\n address depositor,\n address recipient,\n address inputToken,\n address outputToken,\n uint256 inputAmount,\n uint256 outputAmount,\n uint256 destinationChainId,\n address exclusiveRelayer,\n uint32 fillDeadlineOffset,\n uint32 exclusivityDeadline,\n bytes calldata message\n ) external payable;\n\n function unsafeDeposit(\n bytes32 depositor,\n bytes32 recipient,\n bytes32 inputToken,\n bytes32 outputToken,\n uint256 inputAmount,\n uint256 outputAmount,\n uint256 destinationChainId,\n bytes32 exclusiveRelayer,\n uint256 depositNonce,\n uint32 quoteTimestamp,\n uint32 fillDeadline,\n uint32 exclusivityParameter,\n bytes calldata message\n ) external payable;\n\n function speedUpDeposit(\n bytes32 depositor,\n uint256 depositId,\n uint256 updatedOutputAmount,\n bytes32 updatedRecipient,\n bytes calldata updatedMessage,\n bytes calldata depositorSignature\n ) external;\n\n function speedUpV3Deposit(\n address depositor,\n uint256 depositId,\n uint256 updatedOutputAmount,\n address updatedRecipient,\n bytes calldata updatedMessage,\n bytes calldata depositorSignature\n ) external;\n\n function fillRelay(\n V3RelayData calldata relayData,\n uint256 repaymentChainId,\n bytes32 repaymentAddress\n ) external;\n\n function fillV3Relay(V3RelayDataLegacy calldata relayData, uint256 repaymentChainId) external;\n\n function fillRelayWithUpdatedDeposit(\n V3RelayData calldata relayData,\n uint256 repaymentChainId,\n bytes32 repaymentAddress,\n uint256 updatedOutputAmount,\n bytes32 updatedRecipient,\n bytes calldata updatedMessage,\n bytes calldata depositorSignature\n ) external;\n\n function requestSlowFill(V3RelayData calldata relayData) external;\n\n function executeSlowRelayLeaf(\n V3SlowFill calldata slowFillLeaf,\n uint32 rootBundleId,\n bytes32[] calldata proof\n ) external;\n\n function claimRelayerRefund(bytes32 l2TokenAddress, bytes32 refundAddress) external;\n\n /**************************************\n * ERRORS *\n **************************************/\n\n error DisabledRoute();\n error InvalidQuoteTimestamp();\n error InvalidFillDeadline();\n error InvalidExclusiveRelayer();\n error MsgValueDoesNotMatchInputAmount();\n error NotExclusiveRelayer();\n error NoSlowFillsInExclusivityWindow();\n error RelayFilled();\n error InvalidSlowFillRequest();\n error ExpiredFillDeadline();\n error InvalidMerkleProof();\n error InvalidChainId();\n error InvalidMerkleLeaf();\n error ClaimedMerkleLeaf();\n error InvalidPayoutAdjustmentPct();\n error WrongERC7683OrderId();\n error LowLevelCallFailed(bytes data);\n error InsufficientSpokePoolBalanceToExecuteLeaf();\n error NoRelayerRefundToClaim();\n\n /**************************************\n * LEGACY EVENTS *\n **************************************/\n\n // Note: these events are unused, but included in the ABI for ease of migration.\n event V3FundsDeposited(\n address inputToken,\n address outputToken,\n uint256 inputAmount,\n uint256 outputAmount,\n uint256 indexed destinationChainId,\n uint32 indexed depositId,\n uint32 quoteTimestamp,\n uint32 fillDeadline,\n uint32 exclusivityDeadline,\n address indexed depositor,\n address recipient,\n address exclusiveRelayer,\n bytes message\n );\n\n event RequestedSpeedUpV3Deposit(\n uint256 updatedOutputAmount,\n uint32 indexed depositId,\n address indexed depositor,\n address updatedRecipient,\n bytes updatedMessage,\n bytes depositorSignature\n );\n\n // Legacy struct only used to preserve the FilledV3Relay event definition.\n struct LegacyV3RelayExecutionEventInfo {\n address updatedRecipient;\n bytes updatedMessage;\n uint256 updatedOutputAmount;\n FillType fillType;\n }\n\n event FilledV3Relay(\n address inputToken,\n address outputToken,\n uint256 inputAmount,\n uint256 outputAmount,\n uint256 repaymentChainId,\n uint256 indexed originChainId,\n uint32 indexed depositId,\n uint32 fillDeadline,\n uint32 exclusivityDeadline,\n address exclusiveRelayer,\n address indexed relayer,\n address depositor,\n address recipient,\n bytes message,\n LegacyV3RelayExecutionEventInfo relayExecutionInfo\n );\n\n event RequestedV3SlowFill(\n address inputToken,\n address outputToken,\n uint256 inputAmount,\n uint256 outputAmount,\n uint256 indexed originChainId,\n uint32 indexed depositId,\n uint32 fillDeadline,\n uint32 exclusivityDeadline,\n address exclusiveRelayer,\n address depositor,\n address recipient,\n bytes message\n );\n}\n"
+ },
+ "contracts/libraries/AddressConverters.sol": {
+ "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\n\nlibrary Bytes32ToAddress {\n /**************************************\n * ERRORS *\n **************************************/\n error InvalidBytes32();\n\n function toAddress(bytes32 _bytes32) internal pure returns (address) {\n checkAddress(_bytes32);\n return address(uint160(uint256(_bytes32)));\n }\n\n function toAddressUnchecked(bytes32 _bytes32) internal pure returns (address) {\n return address(uint160(uint256(_bytes32)));\n }\n\n function checkAddress(bytes32 _bytes32) internal pure {\n if (uint256(_bytes32) >> 160 != 0) {\n revert InvalidBytes32();\n }\n }\n}\n\nlibrary AddressToBytes32 {\n function toBytes32(address _address) internal pure returns (bytes32) {\n return bytes32(uint256(uint160(_address)));\n }\n}\n"
+ },
+ "contracts/libraries/CircleCCTPAdapter.sol": {
+ "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\n\nimport \"@openzeppelin/contracts/token/ERC20/IERC20.sol\";\nimport \"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\";\nimport \"../external/interfaces/CCTPInterfaces.sol\";\nimport { AddressToBytes32 } from \"../libraries/AddressConverters.sol\";\n\nlibrary CircleDomainIds {\n uint32 public constant Ethereum = 0;\n uint32 public constant Optimism = 2;\n uint32 public constant Arbitrum = 3;\n uint32 public constant Solana = 5;\n uint32 public constant Base = 6;\n uint32 public constant Polygon = 7;\n uint32 public constant DoctorWho = 10;\n uint32 public constant Linea = 11;\n uint32 public constant UNINITIALIZED = type(uint32).max;\n}\n\n/**\n * @notice Facilitate bridging USDC via Circle's CCTP.\n * @dev This contract is intended to be inherited by other chain-specific adapters and spoke pools.\n * @custom:security-contact bugs@across.to\n */\nabstract contract CircleCCTPAdapter {\n using SafeERC20 for IERC20;\n using AddressToBytes32 for address;\n /**\n * @notice The domain ID that CCTP will transfer funds to.\n * @dev This identifier is assigned by Circle and is not related to a chain ID.\n * @dev Official domain list can be found here: https://developers.circle.com/stablecoins/docs/supported-domains\n */\n /// @custom:oz-upgrades-unsafe-allow state-variable-immutable\n\n uint32 public immutable recipientCircleDomainId;\n\n /**\n * @notice The official USDC contract address on this chain.\n * @dev Posted officially here: https://developers.circle.com/stablecoins/docs/usdc-on-main-networks\n */\n /// @custom:oz-upgrades-unsafe-allow state-variable-immutable\n IERC20 public immutable usdcToken;\n\n /**\n * @notice The official Circle CCTP token bridge contract endpoint.\n * @dev Posted officially here: https://developers.circle.com/stablecoins/docs/evm-smart-contracts\n */\n /// @custom:oz-upgrades-unsafe-allow state-variable-immutable\n ITokenMessenger public immutable cctpTokenMessenger;\n\n /**\n * @notice Indicates if the CCTP V2 TokenMessenger is being used.\n * @dev This is determined by checking if the feeRecipient() function exists and returns a non-zero address.\n */\n /// @custom:oz-upgrades-unsafe-allow state-variable-immutable\n bool public immutable cctpV2;\n\n /**\n * @notice intiailizes the CircleCCTPAdapter contract.\n * @param _usdcToken USDC address on the current chain.\n * @param _cctpTokenMessenger TokenMessenger contract to bridge via CCTP. If the zero address is passed, CCTP bridging will be disabled.\n * @param _recipientCircleDomainId The domain ID that CCTP will transfer funds to.\n */\n /// @custom:oz-upgrades-unsafe-allow constructor\n constructor(\n IERC20 _usdcToken,\n /// @dev This should ideally be an address but it's kept as an ITokenMessenger to avoid rippling changes to the\n /// constructors for every SpokePool/Adapter.\n ITokenMessenger _cctpTokenMessenger,\n uint32 _recipientCircleDomainId\n ) {\n usdcToken = _usdcToken;\n cctpTokenMessenger = _cctpTokenMessenger;\n recipientCircleDomainId = _recipientCircleDomainId;\n\n // Only the CCTP V2 TokenMessenger has a feeRecipient() function, so we use it to\n // figure out if we are using CCTP V2 or V1. `success` can be true even if the contract doesn't\n // implement feeRecipient but it has a fallback function so to be extra safe, we check the return value\n // of feeRecipient() as well.\n (bool success, bytes memory feeRecipient) = address(cctpTokenMessenger).staticcall(\n abi.encodeWithSignature(\"feeRecipient()\")\n );\n // In case of a call to nonexistent contract or a call to a contract with a fallback function which\n // doesn't return any data, feeRecipient can be empty so check its length.\n // Even with this check, it's possible that the contract has implemented a fallback function that returns\n // 32 bytes of data but its not actually the feeRecipient address. This is extremely low risk but worth\n // mentioning that the following check is not 100% safe.\n cctpV2 = (success &&\n feeRecipient.length == 32 &&\n address(uint160(uint256(bytes32(feeRecipient)))) != address(0));\n }\n\n /**\n * @notice Returns whether or not the CCTP bridge is enabled.\n * @dev If the CCTPTokenMessenger is the zero address, CCTP bridging is disabled.\n */\n function _isCCTPEnabled() internal view returns (bool) {\n return address(cctpTokenMessenger) != address(0);\n }\n\n /**\n * @notice Transfers USDC from the current domain to the given address on the new domain.\n * @dev This function will revert if the CCTP bridge is disabled. I.e. if the zero address is passed to the constructor for the cctpTokenMessenger.\n * @param to Address to receive USDC on the new domain.\n * @param amount Amount of USDC to transfer.\n */\n function _transferUsdc(address to, uint256 amount) internal {\n _transferUsdc(to.toBytes32(), amount);\n }\n\n /**\n * @notice Transfers USDC from the current domain to the given address on the new domain.\n * @dev This function will revert if the CCTP bridge is disabled. I.e. if the zero address is passed to the constructor for the cctpTokenMessenger.\n * @param to Address to receive USDC on the new domain represented as bytes32.\n * @param amount Amount of USDC to transfer.\n */\n function _transferUsdc(bytes32 to, uint256 amount) internal {\n // Only approve the exact amount to be transferred\n usdcToken.safeIncreaseAllowance(address(cctpTokenMessenger), amount);\n // Submit the amount to be transferred to bridge via the TokenMessenger.\n // If the amount to send exceeds the burn limit per message, then split the message into smaller parts.\n // @dev We do not care about casting cctpTokenMessenger to ITokenMessengerV2 since both V1 and V2\n // expose a localMinter() view function that returns either an ITokenMinterV1 or ITokenMinterV2. Regardless,\n // we only care about the burnLimitsPerMessage function which is available in both versions and performs\n // the same logic, therefore we purposefully do not re-cast the cctpTokenMessenger and cctpMinter\n // to the specific version.\n ITokenMinter cctpMinter = cctpTokenMessenger.localMinter();\n uint256 burnLimit = cctpMinter.burnLimitsPerMessage(address(usdcToken));\n uint256 remainingAmount = amount;\n while (remainingAmount > 0) {\n uint256 partAmount = remainingAmount > burnLimit ? burnLimit : remainingAmount;\n if (cctpV2) {\n // Uses the CCTP V2 \"standard transfer\" speed and\n // therefore pays no additional fee for the transfer to be sped up.\n ITokenMessengerV2(address(cctpTokenMessenger)).depositForBurn(\n partAmount,\n recipientCircleDomainId,\n to,\n address(usdcToken),\n // The following parameters are new in this function from V2 to V1, can read more here:\n // https://developers.circle.com/stablecoins/evm-smart-contracts\n bytes32(0), // destinationCaller is set to bytes32(0) to indicate that anyone can call\n // receiveMessage on the destination to finalize the transfer\n 0, // maxFee can be set to 0 for a \"standard transfer\"\n 2000 // minFinalityThreshold can be set to 2000 for a \"standard transfer\",\n // https://github.com/circlefin/evm-cctp-contracts/blob/63ab1f0ac06ce0793c0bbfbb8d09816bc211386d/src/v2/FinalityThresholds.sol#L21\n );\n } else {\n cctpTokenMessenger.depositForBurn(partAmount, recipientCircleDomainId, to, address(usdcToken));\n }\n remainingAmount -= partAmount;\n }\n }\n}\n"
+ },
+ "contracts/MerkleLib.sol": {
+ "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\n\nimport \"./interfaces/SpokePoolInterface.sol\";\nimport \"./interfaces/V3SpokePoolInterface.sol\";\nimport \"./interfaces/HubPoolInterface.sol\";\n\nimport \"@openzeppelin/contracts/utils/cryptography/MerkleProof.sol\";\n\n/**\n * @notice Library to help with merkle roots, proofs, and claims.\n * @custom:security-contact bugs@across.to\n */\nlibrary MerkleLib {\n /**\n * @notice Verifies that a repayment is contained within a merkle root.\n * @param root the merkle root.\n * @param rebalance the rebalance struct.\n * @param proof the merkle proof.\n * @return bool to signal if the pool rebalance proof correctly shows inclusion of the rebalance within the tree.\n */\n function verifyPoolRebalance(\n bytes32 root,\n HubPoolInterface.PoolRebalanceLeaf memory rebalance,\n bytes32[] memory proof\n ) internal pure returns (bool) {\n return MerkleProof.verify(proof, root, keccak256(abi.encode(rebalance)));\n }\n\n /**\n * @notice Verifies that a relayer refund is contained within a merkle root.\n * @param root the merkle root.\n * @param refund the refund struct.\n * @param proof the merkle proof.\n * @return bool to signal if the relayer refund proof correctly shows inclusion of the refund within the tree.\n */\n function verifyRelayerRefund(\n bytes32 root,\n SpokePoolInterface.RelayerRefundLeaf memory refund,\n bytes32[] memory proof\n ) internal pure returns (bool) {\n return MerkleProof.verify(proof, root, keccak256(abi.encode(refund)));\n }\n\n function verifyV3SlowRelayFulfillment(\n bytes32 root,\n V3SpokePoolInterface.V3SlowFill memory slowRelayFulfillment,\n bytes32[] memory proof\n ) internal pure returns (bool) {\n return MerkleProof.verify(proof, root, keccak256(abi.encode(slowRelayFulfillment)));\n }\n\n // The following functions are primarily copied from\n // https://github.com/Uniswap/merkle-distributor/blob/master/contracts/MerkleDistributor.sol with minor changes.\n\n /**\n * @notice Tests whether a claim is contained within a claimedBitMap mapping.\n * @param claimedBitMap a simple uint256 mapping in storage used as a bitmap.\n * @param index the index to check in the bitmap.\n * @return bool indicating if the index within the claimedBitMap has been marked as claimed.\n */\n function isClaimed(mapping(uint256 => uint256) storage claimedBitMap, uint256 index) internal view returns (bool) {\n uint256 claimedWordIndex = index / 256;\n uint256 claimedBitIndex = index % 256;\n uint256 claimedWord = claimedBitMap[claimedWordIndex];\n uint256 mask = (1 << claimedBitIndex);\n return claimedWord & mask == mask;\n }\n\n /**\n * @notice Marks an index in a claimedBitMap as claimed.\n * @param claimedBitMap a simple uint256 mapping in storage used as a bitmap.\n * @param index the index to mark in the bitmap.\n */\n function setClaimed(mapping(uint256 => uint256) storage claimedBitMap, uint256 index) internal {\n uint256 claimedWordIndex = index / 256;\n uint256 claimedBitIndex = index % 256;\n claimedBitMap[claimedWordIndex] = claimedBitMap[claimedWordIndex] | (1 << claimedBitIndex);\n }\n\n /**\n * @notice Tests whether a claim is contained within a 1D claimedBitMap mapping.\n * @param claimedBitMap a simple uint256 value, encoding a 1D bitmap.\n * @param index the index to check in the bitmap. Uint8 type enforces that index can't be > 255.\n * @return bool indicating if the index within the claimedBitMap has been marked as claimed.\n */\n function isClaimed1D(uint256 claimedBitMap, uint8 index) internal pure returns (bool) {\n uint256 mask = (1 << index);\n return claimedBitMap & mask == mask;\n }\n\n /**\n * @notice Marks an index in a claimedBitMap as claimed.\n * @param claimedBitMap a simple uint256 mapping in storage used as a bitmap. Uint8 type enforces that index\n * can't be > 255.\n * @param index the index to mark in the bitmap.\n * @return uint256 representing the modified input claimedBitMap with the index set to true.\n */\n function setClaimed1D(uint256 claimedBitMap, uint8 index) internal pure returns (uint256) {\n return claimedBitMap | (1 << index);\n }\n}\n"
+ },
+ "contracts/Ovm_SpokePool.sol": {
+ "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\n\nimport \"./SpokePool.sol\";\nimport \"./external/interfaces/WETH9Interface.sol\";\nimport \"./libraries/CircleCCTPAdapter.sol\";\n\nimport \"@openzeppelin/contracts-upgradeable/crosschain/optimism/LibOptimismUpgradeable.sol\";\nimport \"@eth-optimism/contracts/libraries/constants/Lib_PredeployAddresses.sol\";\n\n// https://github.com/ethereum-optimism/optimism/blob/bf51c4935261634120f31827c3910aa631f6bf9c/packages/contracts-bedrock/contracts/L2/L2StandardBridge.sol\ninterface IL2ERC20Bridge {\n function withdrawTo(\n address _l2Token,\n address _to,\n uint256 _amount,\n uint32 _minGasLimit,\n bytes calldata _extraData\n ) external payable;\n\n function bridgeERC20To(\n address _localToken,\n address _remoteToken,\n address _to,\n uint256 _amount,\n uint32 _minGasLimit,\n bytes calldata _extraData\n ) external;\n}\n\n/**\n * @notice OVM specific SpokePool. Uses OVM cross-domain-enabled logic to implement admin only access to functions. * Optimism, Base, and Boba each implement this spoke pool and set their chain specific contract addresses for l2Eth and l2Weth.\n * @custom:security-contact bugs@across.to\n */\ncontract Ovm_SpokePool is SpokePool, CircleCCTPAdapter {\n using SafeERC20 for IERC20;\n // \"l1Gas\" parameter used in call to bridge tokens from this contract back to L1 via IL2ERC20Bridge. Currently\n // unused by bridge but included for future compatibility.\n uint32 public l1Gas;\n\n // ETH is an ERC20 on OVM.\n address public l2Eth;\n\n // Address of the Optimism L2 messenger.\n address public constant MESSENGER = Lib_PredeployAddresses.L2_CROSS_DOMAIN_MESSENGER;\n // @dev This storage slot is reserved to replace the old messenger public variable that has now been\n // replaced by the above constant.\n address private __deprecated_messenger;\n\n // Stores alternative token bridges to use for L2 tokens that don't go over the standard bridge. This is needed\n // to support non-standard ERC20 tokens on Optimism, such as DAI which uses a custom bridge with the same\n // interface as the standard bridge.\n mapping(address => address) public tokenBridges;\n\n // Stores mapping of L2 tokens to L1 equivalent tokens. If a mapping is defined for a given L2 token, then\n // the mapped L1 token can be used in _bridgeTokensToHubPool which can then call bridgeERC20To, which\n // requires specfiying an L1 token.\n mapping(address => address) public remoteL1Tokens;\n\n event SetL1Gas(uint32 indexed newL1Gas);\n event SetL2TokenBridge(address indexed l2Token, address indexed tokenBridge);\n event SetRemoteL1Token(address indexed l2Token, address indexed l1Token);\n\n error NotCrossDomainAdmin();\n\n /// @custom:oz-upgrades-unsafe-allow constructor\n constructor(\n address _wrappedNativeTokenAddress,\n uint32 _depositQuoteTimeBuffer,\n uint32 _fillDeadlineBuffer,\n IERC20 _l2Usdc,\n ITokenMessenger _cctpTokenMessenger\n )\n SpokePool(_wrappedNativeTokenAddress, _depositQuoteTimeBuffer, _fillDeadlineBuffer)\n CircleCCTPAdapter(_l2Usdc, _cctpTokenMessenger, CircleDomainIds.Ethereum)\n {} // solhint-disable-line no-empty-blocks\n\n /**\n * @notice Construct the OVM SpokePool.\n * @param _initialDepositId Starting deposit ID. Set to 0 unless this is a re-deployment in order to mitigate\n * relay hash collisions.\n * @param _crossDomainAdmin Cross domain admin to set. Can be changed by admin.\n * @param _withdrawalRecipient Address which receives token withdrawals. Can be changed by admin. For Spoke Pools on L2, this will\n * likely be the hub pool.\n * @param _l2Eth Address of L2 ETH token. Usually should be Lib_PreeployAddresses.OVM_ETH but sometimes this can\n * be different, like with Boba which flips the WETH and OVM_ETH addresses.\n */\n function __OvmSpokePool_init(\n uint32 _initialDepositId,\n address _crossDomainAdmin,\n address _withdrawalRecipient,\n address _l2Eth\n ) public onlyInitializing {\n l1Gas = 5_000_000;\n __SpokePool_init(_initialDepositId, _crossDomainAdmin, _withdrawalRecipient);\n //slither-disable-next-line missing-zero-check\n l2Eth = _l2Eth;\n }\n\n /*******************************************\n * OPTIMISM-SPECIFIC ADMIN FUNCTIONS *\n *******************************************/\n\n /**\n * @notice Change L1 gas limit. Callable only by admin.\n * @param newl1Gas New L1 gas limit to set.\n */\n function setL1GasLimit(uint32 newl1Gas) public onlyAdmin nonReentrant {\n l1Gas = newl1Gas;\n emit SetL1Gas(newl1Gas);\n }\n\n function setRemoteL1Token(address l2Token, address l1Token) public onlyAdmin nonReentrant {\n remoteL1Tokens[l2Token] = l1Token;\n emit SetRemoteL1Token(l2Token, l1Token);\n }\n\n /**\n * @notice Set bridge contract for L2 token used to withdraw back to L1.\n * @dev If this mapping isn't set for an L2 token, then the standard bridge will be used to bridge this token.\n * @param tokenBridge Address of token bridge\n */\n function setTokenBridge(address l2Token, address tokenBridge) public onlyAdmin nonReentrant {\n tokenBridges[l2Token] = tokenBridge;\n emit SetL2TokenBridge(l2Token, tokenBridge);\n }\n\n /**************************************\n * INTERNAL FUNCTIONS *\n **************************************/\n\n /**\n * @notice Wraps any ETH into WETH before executing leaves. This is necessary because SpokePool receives\n * ETH over the canonical token bridge instead of WETH.\n */\n function _preExecuteLeafHook(address l2TokenAddress) internal override {\n if (l2TokenAddress == address(wrappedNativeToken)) _depositEthToWeth();\n }\n\n // Wrap any ETH owned by this contract so we can send expected L2 token to recipient. This is necessary because\n // this SpokePool will receive ETH from the canonical token bridge instead of WETH. Its not sufficient to execute\n // this logic inside a fallback method that executes when this contract receives ETH because ETH is an ERC20\n // on the OVM.\n function _depositEthToWeth() internal {\n //slither-disable-next-line arbitrary-send-eth\n if (address(this).balance > 0) wrappedNativeToken.deposit{ value: address(this).balance }();\n }\n\n function _bridgeTokensToHubPool(uint256 amountToReturn, address l2TokenAddress) internal virtual override {\n // If the token being bridged is WETH then we need to first unwrap it to ETH and then send ETH over the\n // canonical bridge. On Optimism, this is address 0xDeadDeAddeAddEAddeadDEaDDEAdDeaDDeAD0000.\n if (l2TokenAddress == address(wrappedNativeToken)) {\n WETH9Interface(l2TokenAddress).withdraw(amountToReturn); // Unwrap into ETH.\n l2TokenAddress = l2Eth; // Set the l2TokenAddress to ETH.\n IL2ERC20Bridge(Lib_PredeployAddresses.L2_STANDARD_BRIDGE).withdrawTo{ value: amountToReturn }(\n l2TokenAddress, // _l2Token. Address of the L2 token to bridge over.\n withdrawalRecipient, // _to. Withdraw, over the bridge, to the l1 pool contract.\n amountToReturn, // _amount.\n l1Gas, // _l1Gas. Unused, but included for potential forward compatibility considerations\n \"\" // _data. We don't need to send any data for the bridging action.\n );\n }\n // If the token is USDC && CCTP bridge is enabled, then bridge USDC via CCTP.\n else if (_isCCTPEnabled() && l2TokenAddress == address(usdcToken)) {\n _transferUsdc(withdrawalRecipient, amountToReturn);\n }\n // Note we'll default to withdrawTo instead of bridgeERC20To unless the remoteL1Tokens mapping is set for\n // the l2TokenAddress. withdrawTo should be used to bridge back non-native L2 tokens\n // (i.e. non-native L2 tokens have a canonical L1 token). If we should bridge \"native L2\" tokens then\n // we'd need to call bridgeERC20To and give allowance to the tokenBridge to spend l2Token from this contract.\n // Therefore for native tokens we should set ensure that remoteL1Tokens is set for the l2TokenAddress.\n else {\n IL2ERC20Bridge tokenBridge = IL2ERC20Bridge(\n tokenBridges[l2TokenAddress] == address(0)\n ? Lib_PredeployAddresses.L2_STANDARD_BRIDGE\n : tokenBridges[l2TokenAddress]\n );\n if (remoteL1Tokens[l2TokenAddress] != address(0)) {\n // If there is a mapping for this L2 token to an L1 token, then use the L1 token address and\n // call bridgeERC20To.\n IERC20(l2TokenAddress).safeIncreaseAllowance(address(tokenBridge), amountToReturn);\n address remoteL1Token = remoteL1Tokens[l2TokenAddress];\n tokenBridge.bridgeERC20To(\n l2TokenAddress, // _l2Token. Address of the L2 token to bridge over.\n remoteL1Token, // Remote token to be received on L1 side. If the\n // remoteL1Token on the other chain does not recognize the local token as the correct\n // pair token, the ERC20 bridge will fail and the tokens will be returned to sender on\n // this chain.\n withdrawalRecipient, // _to\n amountToReturn, // _amount\n l1Gas, // _l1Gas\n \"\" // _data\n );\n } else {\n tokenBridge.withdrawTo(\n l2TokenAddress, // _l2Token. Address of the L2 token to bridge over.\n withdrawalRecipient, // _to. Withdraw, over the bridge, to the l1 pool contract.\n amountToReturn, // _amount.\n l1Gas, // _l1Gas. Unused, but included for potential forward compatibility considerations\n \"\" // _data. We don't need to send any data for the bridging action.\n );\n }\n }\n }\n\n // Apply OVM-specific transformation to cross domain admin address on L1.\n function _requireAdminSender() internal view override {\n if (LibOptimismUpgradeable.crossChainSender(MESSENGER) != crossDomainAdmin) revert NotCrossDomainAdmin();\n }\n\n // Reserve storage slots for future versions of this base contract to add state variables without\n // affecting the storage layout of child contracts. Decrement the size of __gap whenever state variables\n // are added. This is at bottom of contract to make sure its always at the end of storage.\n uint256[999] private __gap;\n}\n"
+ },
+ "contracts/SpokePool.sol": {
+ "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\n\nimport \"./MerkleLib.sol\";\nimport \"./erc7683/ERC7683.sol\";\nimport \"./erc7683/ERC7683Permit2Lib.sol\";\nimport \"./external/interfaces/WETH9Interface.sol\";\nimport \"./interfaces/SpokePoolMessageHandler.sol\";\nimport \"./interfaces/SpokePoolInterface.sol\";\nimport \"./interfaces/V3SpokePoolInterface.sol\";\nimport \"./upgradeable/MultiCallerUpgradeable.sol\";\nimport \"./upgradeable/EIP712CrossChainUpgradeable.sol\";\nimport \"./upgradeable/AddressLibUpgradeable.sol\";\nimport \"./libraries/AddressConverters.sol\";\n\nimport \"@openzeppelin/contracts-upgradeable/token/ERC20/IERC20Upgradeable.sol\";\nimport \"@openzeppelin/contracts-upgradeable/token/ERC20/utils/SafeERC20Upgradeable.sol\";\nimport \"@openzeppelin/contracts/utils/cryptography/SignatureChecker.sol\";\nimport \"@openzeppelin/contracts-upgradeable/proxy/utils/UUPSUpgradeable.sol\";\nimport \"@openzeppelin/contracts-upgradeable/security/ReentrancyGuardUpgradeable.sol\";\nimport \"@openzeppelin/contracts/utils/math/SignedMath.sol\";\n\n/**\n * @title SpokePool\n * @notice Base contract deployed on source and destination chains enabling depositors to transfer assets from source to\n * destination. Deposit orders are fulfilled by off-chain relayers who also interact with this contract. Deposited\n * tokens are locked on the source chain and relayers send the recipient the desired token currency and amount\n * on the destination chain. Locked source chain tokens are later sent over the canonical token bridge to L1 HubPool.\n * Relayers are refunded with destination tokens out of this contract after another off-chain actor, a \"data worker\",\n * submits a proof that the relayer correctly submitted a relay on this SpokePool.\n * @custom:security-contact bugs@across.to\n */\nabstract contract SpokePool is\n V3SpokePoolInterface,\n SpokePoolInterface,\n UUPSUpgradeable,\n ReentrancyGuardUpgradeable,\n MultiCallerUpgradeable,\n EIP712CrossChainUpgradeable,\n IDestinationSettler\n{\n using SafeERC20Upgradeable for IERC20Upgradeable;\n using AddressLibUpgradeable for address;\n using Bytes32ToAddress for bytes32;\n using AddressToBytes32 for address;\n\n // Address of the L1 contract that acts as the owner of this SpokePool. This should normally be set to the HubPool\n // address. The crossDomainAdmin address is unused when the SpokePool is deployed to the same chain as the HubPool.\n address public crossDomainAdmin;\n\n // Address of the L1 contract that will send tokens to and receive tokens from this contract to fund relayer\n // refunds and slow relays.\n address public withdrawalRecipient;\n\n // Note: The following two storage variables prefixed with DEPRECATED used to be variables that could be set by\n // the cross-domain admin. Admins ended up not changing these in production, so to reduce\n // gas in deposit/fill functions, we are converting them to private variables to maintain the contract\n // storage layout and replacing them with immutable or constant variables, because retrieving a constant\n // value is cheaper than retrieving a storage variable. Please see out the immutable/constant variable section.\n WETH9Interface private DEPRECATED_wrappedNativeToken;\n uint32 private DEPRECATED_depositQuoteTimeBuffer;\n\n // `numberOfDeposits` acts as a counter to generate unique deposit identifiers for this spoke pool.\n // It is a uint32 that increments with each `depositV3` call. In the `FundsDeposited` event, it is\n // implicitly cast to uint256 by setting its most significant bits to 0, reducing the risk of ID collisions\n // with unsafe deposits. However, this variable's name could be improved (e.g., `depositNonceCounter`)\n // since it does not accurately reflect the total number of deposits, as `unsafeDeposit` can bypass this increment.\n uint32 public numberOfDeposits;\n\n // Whether deposits and fills are disabled.\n bool public pausedFills;\n bool public pausedDeposits;\n\n // This contract can store as many root bundles as the HubPool chooses to publish here.\n RootBundle[] public rootBundles;\n\n // Origin token to destination token routings can be turned on or off, which can enable or disable deposits.\n mapping(address => mapping(uint256 => bool)) private DEPRECATED_enabledDepositRoutes;\n\n // Each relay is associated with the hash of parameters that uniquely identify the original deposit and a relay\n // attempt for that deposit. The relay itself is just represented as the amount filled so far. The total amount to\n // relay, the fees, and the agents are all parameters included in the hash key.\n mapping(bytes32 => uint256) private DEPRECATED_relayFills;\n\n // Note: We will likely un-deprecate the fill and deposit counters to implement a better\n // dynamic LP fee mechanism but for now we'll deprecate it to reduce bytecode\n // in deposit/fill functions. These counters are designed to implement a fee mechanism that is based on a\n // canonical history of deposit and fill events and how they update a virtual running balance of liabilities and\n // assets, which then determines the LP fee charged to relays.\n\n // This keeps track of the worst-case liabilities due to fills.\n // It is never reset. Users should only rely on it to determine the worst-case increase in liabilities between\n // two points. This is used to provide frontrunning protection to ensure the relayer's assumptions about the state\n // upon which their expected repayments are based will not change before their transaction is mined.\n mapping(address => uint256) private DEPRECATED_fillCounter;\n\n // This keeps track of the total running deposits for each token. This allows depositors to protect themselves from\n // frontrunning that might change their worst-case quote.\n mapping(address => uint256) private DEPRECATED_depositCounter;\n\n // This tracks the number of identical refunds that have been requested.\n // The intention is to allow an off-chain system to know when this could be a duplicate and ensure that the other\n // requests are known and accounted for.\n mapping(bytes32 => uint256) private DEPRECATED_refundsRequested;\n\n // Mapping of V3 relay hashes to fill statuses. Distinguished from relayFills\n // to eliminate any chance of collision between pre and post V3 relay hashes.\n mapping(bytes32 => uint256) public fillStatuses;\n\n // Mapping of L2TokenAddress to relayer to outstanding refund amount. Used when a relayer repayment fails for some\n // reason (eg blacklist) to track their outstanding liability, thereby letting them claim it later.\n mapping(address => mapping(address => uint256)) public relayerRefund;\n\n /**************************************************************\n * CONSTANT/IMMUTABLE VARIABLES *\n **************************************************************/\n // Constant and immutable variables do not take up storage slots and are instead added to the contract bytecode\n // at compile time. The difference between them is that constant variables must be declared inline, meaning\n // that they cannot be changed in production without changing the contract code, while immutable variables\n // can be set in the constructor. Therefore we use the immutable keyword for variables that we might want to be\n // different for each child contract (one obvious example of this is the wrappedNativeToken) or that we might\n // want to update in the future like depositQuoteTimeBuffer. Constants are unlikely to ever be changed.\n\n // Address of wrappedNativeToken contract for this network. If an origin token matches this, then the caller can\n // optionally instruct this contract to wrap native tokens when depositing (ie ETH->WETH or MATIC->WMATIC).\n /// @custom:oz-upgrades-unsafe-allow state-variable-immutable\n WETH9Interface public immutable wrappedNativeToken;\n\n // Any deposit quote times greater than or less than this value to the current contract time is blocked. Forces\n // caller to use an approximately \"current\" realized fee.\n /// @custom:oz-upgrades-unsafe-allow state-variable-immutable\n uint32 public immutable depositQuoteTimeBuffer;\n\n // The fill deadline can only be set this far into the future from the timestamp of the deposit on this contract.\n /// @custom:oz-upgrades-unsafe-allow state-variable-immutable\n uint32 public immutable fillDeadlineBuffer;\n\n uint256 public constant MAX_TRANSFER_SIZE = 1e36;\n\n bytes32 public constant UPDATE_BYTES32_DEPOSIT_DETAILS_HASH =\n keccak256(\n \"UpdateDepositDetails(uint256 depositId,uint256 originChainId,uint256 updatedOutputAmount,bytes32 updatedRecipient,bytes updatedMessage)\"\n );\n // Default chain Id used to signify that no repayment is requested, for example when executing a slow fill.\n uint256 public constant EMPTY_REPAYMENT_CHAIN_ID = 0;\n // Default address used to signify that no relayer should be credited with a refund, for example\n // when executing a slow fill.\n bytes32 public constant EMPTY_RELAYER = bytes32(0);\n // This is the magic value that signals to the off-chain validator\n // that this deposit can never expire. A deposit with this fill deadline should always be eligible for a\n // slow fill, meaning that its output token and input token must be \"equivalent\". Therefore, this value is only\n // used as a fillDeadline in deposit(), a soon to be deprecated function that also hardcodes outputToken to\n // the zero address, which forces the off-chain validator to replace the output token with the equivalent\n // token for the input token. By using this magic value, off-chain validators do not have to keep\n // this event in their lookback window when querying for expired deposits.\n uint32 public constant INFINITE_FILL_DEADLINE = type(uint32).max;\n\n // One year in seconds. If `exclusivityParameter` is set to a value less than this, then the emitted\n // exclusivityDeadline in a deposit event will be set to the current time plus this value.\n uint32 public constant MAX_EXCLUSIVITY_PERIOD_SECONDS = 31_536_000;\n /****************************************\n * EVENTS *\n ****************************************/\n event SetXDomainAdmin(address indexed newAdmin);\n event SetWithdrawalRecipient(address indexed newWithdrawalRecipient);\n event EnabledDepositRoute(address indexed originToken, uint256 indexed destinationChainId, bool enabled);\n event RelayedRootBundle(\n uint32 indexed rootBundleId,\n bytes32 indexed relayerRefundRoot,\n bytes32 indexed slowRelayRoot\n );\n event ExecutedRelayerRefundRoot(\n uint256 amountToReturn,\n uint256 indexed chainId,\n uint256[] refundAmounts,\n uint32 indexed rootBundleId,\n uint32 indexed leafId,\n address l2TokenAddress,\n address[] refundAddresses,\n bool deferredRefunds,\n address caller\n );\n event TokensBridged(\n uint256 amountToReturn,\n uint256 indexed chainId,\n uint32 indexed leafId,\n bytes32 indexed l2TokenAddress,\n address caller\n );\n event EmergencyDeletedRootBundle(uint256 indexed rootBundleId);\n event PausedDeposits(bool isPaused);\n event PausedFills(bool isPaused);\n\n /**\n * @notice Construct the SpokePool. Normally, logic contracts used in upgradeable proxies shouldn't\n * have constructors since the following code will be executed within the logic contract's state, not the\n * proxy contract's state. However, if we restrict the constructor to setting only immutable variables, then\n * we are safe because immutable variables are included in the logic contract's bytecode rather than its storage.\n * @dev Do not leave an implementation contract uninitialized. An uninitialized implementation contract can be\n * taken over by an attacker, which may impact the proxy. To prevent the implementation contract from being\n * used, you should invoke the _disableInitializers function in the constructor to automatically lock it when\n * it is deployed:\n * @param _wrappedNativeTokenAddress wrappedNativeToken address for this network to set.\n * @param _depositQuoteTimeBuffer depositQuoteTimeBuffer to set. Quote timestamps can't be set more than this amount\n * into the past from the block time of the deposit.\n * @param _fillDeadlineBuffer fillDeadlineBuffer to set. Fill deadlines can't be set more than this amount\n * into the future from the block time of the deposit.\n */\n /// @custom:oz-upgrades-unsafe-allow constructor\n constructor(\n address _wrappedNativeTokenAddress,\n uint32 _depositQuoteTimeBuffer,\n uint32 _fillDeadlineBuffer\n ) {\n wrappedNativeToken = WETH9Interface(_wrappedNativeTokenAddress);\n depositQuoteTimeBuffer = _depositQuoteTimeBuffer;\n fillDeadlineBuffer = _fillDeadlineBuffer;\n _disableInitializers();\n }\n\n /**\n * @notice Construct the base SpokePool.\n * @param _initialDepositId Starting deposit ID. Set to 0 unless this is a re-deployment in order to mitigate\n * relay hash collisions.\n * @param _crossDomainAdmin Cross domain admin to set. Can be changed by admin.\n * @param _withdrawalRecipient Address which receives token withdrawals. Can be changed by admin. For Spoke Pools on L2, this will\n * likely be the hub pool.\n */\n function __SpokePool_init(\n uint32 _initialDepositId,\n address _crossDomainAdmin,\n address _withdrawalRecipient\n ) public onlyInitializing {\n numberOfDeposits = _initialDepositId;\n __EIP712_init(\"ACROSS-V2\", \"1.0.0\");\n __UUPSUpgradeable_init();\n __ReentrancyGuard_init();\n _setCrossDomainAdmin(_crossDomainAdmin);\n _setWithdrawalRecipient(_withdrawalRecipient);\n }\n\n /****************************************\n * MODIFIERS *\n ****************************************/\n\n /**\n * @dev Function that should revert when `msg.sender` is not authorized to upgrade the contract. Called by\n * {upgradeTo} and {upgradeToAndCall}.\n * @dev This should be set to cross domain admin for specific SpokePool.\n */\n modifier onlyAdmin() {\n _requireAdminSender();\n _;\n }\n\n modifier unpausedDeposits() {\n if (pausedDeposits) revert DepositsArePaused();\n _;\n }\n\n modifier unpausedFills() {\n if (pausedFills) revert FillsArePaused();\n _;\n }\n\n /**************************************\n * ADMIN FUNCTIONS *\n **************************************/\n\n // Allows cross domain admin to upgrade UUPS proxy implementation.\n function _authorizeUpgrade(address newImplementation) internal override onlyAdmin {}\n\n /**\n * @notice Pauses deposit-related functions. This is intended to be used if this contract is deprecated or when\n * something goes awry.\n * @dev Affects `deposit()` but not `speedUpDeposit()`, so that existing deposits can be sped up and still\n * relayed.\n * @param pause true if the call is meant to pause the system, false if the call is meant to unpause it.\n */\n function pauseDeposits(bool pause) public override onlyAdmin nonReentrant {\n pausedDeposits = pause;\n emit PausedDeposits(pause);\n }\n\n /**\n * @notice Pauses fill-related functions. This is intended to be used if this contract is deprecated or when\n * something goes awry.\n * @dev Affects fillRelayWithUpdatedDeposit() and fillRelay().\n * @param pause true if the call is meant to pause the system, false if the call is meant to unpause it.\n */\n function pauseFills(bool pause) public override onlyAdmin nonReentrant {\n pausedFills = pause;\n emit PausedFills(pause);\n }\n\n /**\n * @notice Change cross domain admin address. Callable by admin only.\n * @param newCrossDomainAdmin New cross domain admin.\n */\n function setCrossDomainAdmin(address newCrossDomainAdmin) public override onlyAdmin nonReentrant {\n _setCrossDomainAdmin(newCrossDomainAdmin);\n }\n\n /**\n * @notice Change L1 withdrawal recipient address. Callable by admin only.\n * @param newWithdrawalRecipient New withdrawal recipient address.\n */\n function setWithdrawalRecipient(address newWithdrawalRecipient) public override onlyAdmin nonReentrant {\n _setWithdrawalRecipient(newWithdrawalRecipient);\n }\n\n /**\n * @notice This method stores a new root bundle in this contract that can be executed to refund relayers, fulfill\n * slow relays, and send funds back to the HubPool on L1. This method can only be called by the admin and is\n * designed to be called as part of a cross-chain message from the HubPool's executeRootBundle method.\n * @param relayerRefundRoot Merkle root containing relayer refund leaves that can be individually executed via\n * executeRelayerRefundLeaf().\n * @param slowRelayRoot Merkle root containing slow relay fulfillment leaves that can be individually executed via\n * executeSlowRelayLeaf().\n */\n function relayRootBundle(bytes32 relayerRefundRoot, bytes32 slowRelayRoot) public override onlyAdmin nonReentrant {\n uint32 rootBundleId = uint32(rootBundles.length);\n RootBundle storage rootBundle = rootBundles.push();\n rootBundle.relayerRefundRoot = relayerRefundRoot;\n rootBundle.slowRelayRoot = slowRelayRoot;\n emit RelayedRootBundle(rootBundleId, relayerRefundRoot, slowRelayRoot);\n }\n\n /**\n * @notice This method is intended to only be used in emergencies where a bad root bundle has reached the\n * SpokePool.\n * @param rootBundleId Index of the root bundle that needs to be deleted. Note: this is intentionally a uint256\n * to ensure that a small input range doesn't limit which indices this method is able to reach.\n */\n function emergencyDeleteRootBundle(uint256 rootBundleId) public override onlyAdmin nonReentrant {\n // Deleting a struct containing a mapping does not delete the mapping in Solidity, therefore the bitmap's\n // data will still remain potentially leading to vulnerabilities down the line. The way around this would\n // be to iterate through every key in the mapping and resetting the value to 0, but this seems expensive and\n // would require a new list in storage to keep track of keys.\n //slither-disable-next-line mapping-deletion\n delete rootBundles[rootBundleId];\n emit EmergencyDeletedRootBundle(rootBundleId);\n }\n\n /**************************************\n * LEGACY DEPOSITOR FUNCTIONS *\n **************************************/\n\n /**\n * @dev DEPRECATION NOTICE: this function is deprecated and will be removed in the future.\n * Please use deposit (under DEPOSITOR FUNCTIONS below) or depositV3 instead.\n * @notice Called by user to bridge funds from origin to destination chain. Depositor will effectively lock\n * tokens in this contract and receive a destination token on the destination chain. The origin => destination\n * token mapping is stored on the L1 HubPool.\n * @notice The caller must first approve this contract to spend amount of originToken.\n * @notice The originToken => destinationChainId must be enabled.\n * @notice This method is payable because the caller is able to deposit native token if the originToken is\n * wrappedNativeToken and this function will handle wrapping the native token to wrappedNativeToken.\n * @dev Produces a FundsDeposited event with an infinite expiry, meaning that this deposit can never expire.\n * Moreover, the event's outputToken is set to 0x0 meaning that this deposit can always be slow filled.\n * @param recipient Address to receive funds at on destination chain.\n * @param originToken Token to lock into this contract to initiate deposit.\n * @param amount Amount of tokens to deposit. Will be amount of tokens to receive less fees.\n * @param destinationChainId Denotes network where user will receive funds from SpokePool by a relayer.\n * @param relayerFeePct % of deposit amount taken out to incentivize a fast relayer.\n * @param quoteTimestamp Timestamp used by relayers to compute this deposit's realizedLPFeePct which is paid\n * to LP pool on HubPool.\n * @param message Arbitrary data that can be used to pass additional information to the recipient along with the tokens.\n * Note: this is intended to be used to pass along instructions for how a contract should use or allocate the tokens.\n */\n function depositDeprecated_5947912356(\n address recipient,\n address originToken,\n uint256 amount,\n uint256 destinationChainId,\n int64 relayerFeePct,\n uint32 quoteTimestamp,\n bytes memory message,\n uint256 // maxCount. Deprecated.\n ) public payable nonReentrant unpausedDeposits {\n _deposit(\n msg.sender,\n recipient,\n originToken,\n amount,\n destinationChainId,\n relayerFeePct,\n quoteTimestamp,\n message\n );\n }\n\n /**\n * @dev DEPRECATION NOTICE: this function is deprecated and will be removed in the future.\n * Please use the other deposit or depositV3 instead.\n * @notice The only difference between depositFor and deposit is that the depositor address stored\n * in the relay hash can be overridden by the caller. This means that the passed in depositor\n * can speed up the deposit, which is useful if the deposit is taken from the end user to a middle layer\n * contract, like an aggregator or the SpokePoolVerifier, before calling deposit on this contract.\n * @notice The caller must first approve this contract to spend amount of originToken.\n * @notice The originToken => destinationChainId must be enabled.\n * @notice This method is payable because the caller is able to deposit native token if the originToken is\n * wrappedNativeToken and this function will handle wrapping the native token to wrappedNativeToken.\n * @param depositor Address who is credited for depositing funds on origin chain and can speed up the deposit.\n * @param recipient Address to receive funds at on destination chain.\n * @param originToken Token to lock into this contract to initiate deposit.\n * @param amount Amount of tokens to deposit. Will be amount of tokens to receive less fees.\n * @param destinationChainId Denotes network where user will receive funds from SpokePool by a relayer.\n * @param relayerFeePct % of deposit amount taken out to incentivize a fast relayer.\n * @param quoteTimestamp Timestamp used by relayers to compute this deposit's realizedLPFeePct which is paid\n * to LP pool on HubPool.\n * @param message Arbitrary data that can be used to pass additional information to the recipient along with the tokens.\n * Note: this is intended to be used to pass along instructions for how a contract should use or allocate the tokens.\n */\n function depositFor(\n address depositor,\n address recipient,\n address originToken,\n uint256 amount,\n uint256 destinationChainId,\n int64 relayerFeePct,\n uint32 quoteTimestamp,\n bytes memory message,\n uint256 // maxCount. Deprecated.\n ) public payable nonReentrant unpausedDeposits {\n _deposit(depositor, recipient, originToken, amount, destinationChainId, relayerFeePct, quoteTimestamp, message);\n }\n\n /********************************************\n * DEPOSITOR FUNCTIONS *\n ********************************************/\n\n /**\n * @notice Previously, this function allowed the caller to specify the exclusivityDeadline, otherwise known as the\n * as exact timestamp on the destination chain before which only the exclusiveRelayer could fill the deposit. Now,\n * the caller is expected to pass in a number that will be interpreted either as an offset or a fixed\n * timestamp depending on its value.\n * @notice Request to bridge input token cross chain to a destination chain and receive a specified amount\n * of output tokens. The fee paid to relayers and the system should be captured in the spread between output\n * amount and input amount when adjusted to be denominated in the input token. A relayer on the destination\n * chain will send outputAmount of outputTokens to the recipient and receive inputTokens on a repayment\n * chain of their choice. Therefore, the fee should account for destination fee transaction costs,\n * the relayer's opportunity cost of capital while they wait to be refunded following an optimistic challenge\n * window in the HubPool, and the system fee that they'll be charged.\n * @dev On the destination chain, the hash of the deposit data will be used to uniquely identify this deposit, so\n * modifying any params in it will result in a different hash and a different deposit. The hash will comprise\n * all parameters to this function along with this chain's chainId(). Relayers are only refunded for filling\n * deposits with deposit hashes that map exactly to the one emitted by this contract.\n * @param depositor The account credited with the deposit who can request to \"speed up\" this deposit by modifying\n * the output amount, recipient, and message.\n * @param recipient The account receiving funds on the destination chain. Can be an EOA or a contract. If\n * the output token is the wrapped native token for the chain, then the recipient will receive native token if\n * an EOA or wrapped native token if a contract.\n * @param inputToken The token pulled from the caller's account and locked into this contract to\n * initiate the deposit. The equivalent of this token on the relayer's repayment chain of choice will be sent\n * as a refund. If this is equal to the wrapped native token then the caller can optionally pass in native token as\n * msg.value, as long as msg.value = inputTokenAmount.\n * @param outputToken The token that the relayer will send to the recipient on the destination chain. Must be an\n * ERC20.\n * @param inputAmount The amount of input tokens to pull from the caller's account and lock into this contract.\n * This amount will be sent to the relayer on their repayment chain of choice as a refund following an optimistic\n * challenge window in the HubPool, less a system fee.\n * @param outputAmount The amount of output tokens that the relayer will send to the recipient on the destination.\n * @param destinationChainId The destination chain identifier. Must be enabled along with the input token\n * as a valid deposit route from this spoke pool or this transaction will revert.\n * @param exclusiveRelayer The relayer that will be exclusively allowed to fill this deposit before the\n * exclusivity deadline timestamp. This must be a valid, non-zero address if the exclusivity deadline is\n * greater than the current block.timestamp. If the exclusivity deadline is < currentTime, then this must be\n * address(0), and vice versa if this is address(0).\n * @param quoteTimestamp The HubPool timestamp that is used to determine the system fee paid by the depositor.\n * This must be set to some time between [currentTime - depositQuoteTimeBuffer, currentTime]\n * where currentTime is block.timestamp on this chain or this transaction will revert.\n * @param fillDeadline The deadline for the relayer to fill the deposit. After this destination chain timestamp,\n * the fill will revert on the destination chain. Must be set before currentTime + fillDeadlineBuffer, where\n * currentTime is block.timestamp on this chain or this transaction will revert.\n * @param exclusivityParameter This value is used to set the exclusivity deadline timestamp in the emitted deposit\n * event. Before this destination chain timestamp, only the exclusiveRelayer (if set to a non-zero address),\n * can fill this deposit. There are three ways to use this parameter:\n * 1. NO EXCLUSIVITY: If this value is set to 0, then a timestamp of 0 will be emitted,\n * meaning that there is no exclusivity period.\n * 2. OFFSET: If this value is less than MAX_EXCLUSIVITY_PERIOD_SECONDS, then add this value to\n * the block.timestamp to derive the exclusive relayer deadline. Note that using the parameter in this way\n * will expose the filler of the deposit to the risk that the block.timestamp of this event gets changed\n * due to a chain-reorg, which would also change the exclusivity timestamp.\n * 3. TIMESTAMP: Otherwise, set this value as the exclusivity deadline timestamp.\n * which is the deadline for the exclusiveRelayer to fill the deposit.\n * @param message The message to send to the recipient on the destination chain if the recipient is a contract.\n * If the message is not empty, the recipient contract must implement handleV3AcrossMessage() or the fill will revert.\n */\n function deposit(\n bytes32 depositor,\n bytes32 recipient,\n bytes32 inputToken,\n bytes32 outputToken,\n uint256 inputAmount,\n uint256 outputAmount,\n uint256 destinationChainId,\n bytes32 exclusiveRelayer,\n uint32 quoteTimestamp,\n uint32 fillDeadline,\n uint32 exclusivityParameter,\n bytes calldata message\n ) public payable override nonReentrant unpausedDeposits {\n // Increment the `numberOfDeposits` counter to ensure a unique deposit ID for this spoke pool.\n DepositV3Params memory params = DepositV3Params({\n depositor: depositor,\n recipient: recipient,\n inputToken: inputToken,\n outputToken: outputToken,\n inputAmount: inputAmount,\n outputAmount: outputAmount,\n destinationChainId: destinationChainId,\n exclusiveRelayer: exclusiveRelayer,\n depositId: numberOfDeposits++,\n quoteTimestamp: quoteTimestamp,\n fillDeadline: fillDeadline,\n exclusivityParameter: exclusivityParameter,\n message: message\n });\n _depositV3(params);\n }\n\n /**\n * @notice A version of `deposit` that accepts `address` types for backward compatibility.\n * This function allows bridging of input tokens cross-chain to a destination chain, receiving a specified amount of output tokens.\n * The relayer is refunded in input tokens on a repayment chain of their choice, minus system fees, after an optimistic challenge\n * window. The exclusivity period is specified as an offset from the current block timestamp.\n *\n * @dev This version mirrors the original `depositV3` function, but uses `address` types for `depositor`, `recipient`,\n * `inputToken`, `outputToken`, and `exclusiveRelayer` for compatibility with contracts using the `address` type.\n *\n * The key functionality and logic remain identical, ensuring interoperability across both versions.\n *\n * @param depositor The account credited with the deposit who can request to \"speed up\" this deposit by modifying\n * the output amount, recipient, and message.\n * @param recipient The account receiving funds on the destination chain. Can be an EOA or a contract. If\n * the output token is the wrapped native token for the chain, then the recipient will receive native token if\n * an EOA or wrapped native token if a contract.\n * @param inputToken The token pulled from the caller's account and locked into this contract to initiate the deposit.\n * The equivalent of this token on the relayer's repayment chain of choice will be sent as a refund. If this is equal\n * to the wrapped native token, the caller can optionally pass in native token as msg.value, provided msg.value = inputTokenAmount.\n * @param outputToken The token that the relayer will send to the recipient on the destination chain. Must be an ERC20.\n * @param inputAmount The amount of input tokens pulled from the caller's account and locked into this contract. This\n * amount will be sent to the relayer as a refund following an optimistic challenge window in the HubPool, less a system fee.\n * @param outputAmount The amount of output tokens that the relayer will send to the recipient on the destination.\n * @param destinationChainId The destination chain identifier. Must be enabled along with the input token as a valid\n * deposit route from this spoke pool or this transaction will revert.\n * @param exclusiveRelayer The relayer exclusively allowed to fill this deposit before the exclusivity deadline.\n * @param quoteTimestamp The HubPool timestamp that determines the system fee paid by the depositor. This must be set\n * between [currentTime - depositQuoteTimeBuffer, currentTime] where currentTime is block.timestamp on this chain.\n * @param fillDeadline The deadline for the relayer to fill the deposit. After this destination chain timestamp, the fill will\n * revert on the destination chain. Must be set before currentTime + fillDeadlineBuffer, where currentTime is block.timestamp\n * on this chain.\n * @param exclusivityParameter This value is used to set the exclusivity deadline timestamp in the emitted deposit\n * event. Before this destination chain timestamp, only the exclusiveRelayer (if set to a non-zero address),\n * can fill this deposit. There are three ways to use this parameter:\n * 1. NO EXCLUSIVITY: If this value is set to 0, then a timestamp of 0 will be emitted,\n * meaning that there is no exclusivity period.\n * 2. OFFSET: If this value is less than MAX_EXCLUSIVITY_PERIOD_SECONDS, then add this value to\n * the block.timestamp to derive the exclusive relayer deadline. Note that using the parameter in this way\n * will expose the filler of the deposit to the risk that the block.timestamp of this event gets changed\n * due to a chain-reorg, which would also change the exclusivity timestamp.\n * 3. TIMESTAMP: Otherwise, set this value as the exclusivity deadline timestamp.\n * which is the deadline for the exclusiveRelayer to fill the deposit.\n * @param message The message to send to the recipient on the destination chain if the recipient is a contract. If the\n * message is not empty, the recipient contract must implement `handleV3AcrossMessage()` or the fill will revert.\n */\n function depositV3(\n address depositor,\n address recipient,\n address inputToken,\n address outputToken,\n uint256 inputAmount,\n uint256 outputAmount,\n uint256 destinationChainId,\n address exclusiveRelayer,\n uint32 quoteTimestamp,\n uint32 fillDeadline,\n uint32 exclusivityParameter,\n bytes calldata message\n ) public payable override {\n deposit(\n depositor.toBytes32(),\n recipient.toBytes32(),\n inputToken.toBytes32(),\n outputToken.toBytes32(),\n inputAmount,\n outputAmount,\n destinationChainId,\n exclusiveRelayer.toBytes32(),\n quoteTimestamp,\n fillDeadline,\n exclusivityParameter,\n message\n );\n }\n\n /**\n * @notice See deposit for details. This function is identical to deposit except that it does not use the\n * global deposit ID counter as a deposit nonce, instead allowing the caller to pass in a deposit nonce. This\n * function is designed to be used by anyone who wants to pre-compute their resultant relay data hash, which\n * could be useful for filling a deposit faster and avoiding any risk of a relay hash unexpectedly changing\n * due to another deposit front-running this one and incrementing the global deposit ID counter.\n * @dev This is labeled \"unsafe\" because there is no guarantee that the depositId emitted in the resultant\n * FundsDeposited event is unique which means that the\n * corresponding fill might collide with an existing relay hash on the destination chain SpokePool,\n * which would make this deposit unfillable. In this case, the depositor would subsequently receive a refund\n * of `inputAmount` of `inputToken` on the origin chain after the fill deadline. Re-using a depositNonce is very\n * dangerous when combined with `speedUpDeposit`, as a speed up signature can be re-used for any deposits\n * with the same deposit ID.\n * @dev On the destination chain, the hash of the deposit data will be used to uniquely identify this deposit, so\n * modifying any params in it will result in a different hash and a different deposit. The hash will comprise\n * all parameters to this function along with this chain's chainId(). Relayers are only refunded for filling\n * deposits with deposit hashes that map exactly to the one emitted by this contract.\n * @param depositNonce The nonce that uniquely identifies this deposit. This function will combine this parameter\n * with the msg.sender address to create a unique uint256 depositNonce and ensure that the msg.sender cannot\n * use this function to front-run another depositor's unsafe deposit. This function guarantees that the resultant\n * deposit nonce will not collide with a safe uint256 deposit nonce whose 24 most significant bytes are always 0.\n * @param depositor See identically named parameter in depositV3() comments.\n * @param recipient See identically named parameter in depositV3() comments.\n * @param inputToken See identically named parameter in depositV3() comments.\n * @param outputToken See identically named parameter in depositV3() comments.\n * @param inputAmount See identically named parameter in depositV3() comments.\n * @param outputAmount See identically named parameter in depositV3() comments.\n * @param destinationChainId See identically named parameter in depositV3() comments.\n * @param exclusiveRelayer See identically named parameter in depositV3() comments.\n * @param quoteTimestamp See identically named parameter in depositV3() comments.\n * @param fillDeadline See identically named parameter in depositV3() comments.\n * @param exclusivityParameter See identically named parameter in depositV3() comments.\n * @param message See identically named parameter in depositV3() comments.\n */\n function unsafeDeposit(\n bytes32 depositor,\n bytes32 recipient,\n bytes32 inputToken,\n bytes32 outputToken,\n uint256 inputAmount,\n uint256 outputAmount,\n uint256 destinationChainId,\n bytes32 exclusiveRelayer,\n uint256 depositNonce,\n uint32 quoteTimestamp,\n uint32 fillDeadline,\n uint32 exclusivityParameter,\n bytes calldata message\n ) public payable nonReentrant unpausedDeposits {\n // @dev Create the uint256 deposit ID by concatenating the msg.sender and depositor address with the inputted\n // depositNonce parameter. The resultant 32 byte string will be hashed and then casted to an \"unsafe\"\n // uint256 deposit ID. The probability that the resultant ID collides with a \"safe\" deposit ID is\n // equal to the chance that the first 28 bytes of the hash are 0, which is too small for us to consider.\n\n uint256 depositId = getUnsafeDepositId(msg.sender, depositor, depositNonce);\n DepositV3Params memory params = DepositV3Params({\n depositor: depositor,\n recipient: recipient,\n inputToken: inputToken,\n outputToken: outputToken,\n inputAmount: inputAmount,\n outputAmount: outputAmount,\n destinationChainId: destinationChainId,\n exclusiveRelayer: exclusiveRelayer,\n depositId: depositId,\n quoteTimestamp: quoteTimestamp,\n fillDeadline: fillDeadline,\n exclusivityParameter: exclusivityParameter,\n message: message\n });\n _depositV3(params);\n }\n\n /**\n * @notice Submits deposit and sets quoteTimestamp to current Time. Sets fill and exclusivity\n * deadlines as offsets added to the current time. This function is designed to be called by users\n * such as Multisig contracts who do not have certainty when their transaction will mine.\n * @param depositor The account credited with the deposit who can request to \"speed up\" this deposit by modifying\n * the output amount, recipient, and message.\n * @param recipient The account receiving funds on the destination chain. Can be an EOA or a contract. If\n * the output token is the wrapped native token for the chain, then the recipient will receive native token if\n * an EOA or wrapped native token if a contract.\n * @param inputToken The token pulled from the caller's account and locked into this contract to\n * initiate the deposit. The equivalent of this token on the relayer's repayment chain of choice will be sent\n * as a refund. If this is equal to the wrapped native token then the caller can optionally pass in native token as\n * msg.value, as long as msg.value = inputTokenAmount.\n * @param outputToken The token that the relayer will send to the recipient on the destination chain. Must be an\n * ERC20.\n * @param inputAmount The amount of input tokens to pull from the caller's account and lock into this contract.\n * This amount will be sent to the relayer on their repayment chain of choice as a refund following an optimistic\n * challenge window in the HubPool, plus a system fee.\n * @param outputAmount The amount of output tokens that the relayer will send to the recipient on the destination.\n * @param destinationChainId The destination chain identifier. Must be enabled along with the input token\n * as a valid deposit route from this spoke pool or this transaction will revert.\n * @param exclusiveRelayer The relayer that will be exclusively allowed to fill this deposit before the\n * exclusivity deadline timestamp.\n * @param fillDeadlineOffset Added to the current time to set the fill deadline, which is the deadline for the\n * relayer to fill the deposit. After this destination chain timestamp, the fill will revert on the\n * destination chain.\n * @param exclusivityParameter See identically named parameter in deposit() comments.\n * @param message The message to send to the recipient on the destination chain if the recipient is a contract.\n * If the message is not empty, the recipient contract must implement handleV3AcrossMessage() or the fill will revert.\n */\n function depositNow(\n bytes32 depositor,\n bytes32 recipient,\n bytes32 inputToken,\n bytes32 outputToken,\n uint256 inputAmount,\n uint256 outputAmount,\n uint256 destinationChainId,\n bytes32 exclusiveRelayer,\n uint32 fillDeadlineOffset,\n uint32 exclusivityParameter,\n bytes calldata message\n ) external payable override {\n deposit(\n depositor,\n recipient,\n inputToken,\n outputToken,\n inputAmount,\n outputAmount,\n destinationChainId,\n exclusiveRelayer,\n uint32(getCurrentTime()),\n uint32(getCurrentTime()) + fillDeadlineOffset,\n exclusivityParameter,\n message\n );\n }\n\n /**\n * @notice A version of `depositNow` that supports addresses as input types for backward compatibility.\n * This function submits a deposit and sets `quoteTimestamp` to the current time. The `fill` and `exclusivity` deadlines\n * are set as offsets added to the current time. It is designed to be called by users, including Multisig contracts, who may\n * not have certainty when their transaction will be mined.\n *\n * @dev This version is identical to the original `depositV3Now` but uses `address` types for `depositor`, `recipient`,\n * `inputToken`, `outputToken`, and `exclusiveRelayer` to support compatibility with older systems.\n * It maintains the same logic and purpose, ensuring interoperability with both versions.\n *\n * @param depositor The account credited with the deposit, who can request to \"speed up\" this deposit by modifying\n * the output amount, recipient, and message.\n * @param recipient The account receiving funds on the destination chain. Can be an EOA or a contract. If\n * the output token is the wrapped native token for the chain, then the recipient will receive the native token if\n * an EOA or wrapped native token if a contract.\n * @param inputToken The token pulled from the caller's account and locked into this contract to initiate the deposit.\n * Equivalent tokens on the relayer's repayment chain will be sent as a refund. If this is the wrapped native token,\n * msg.value must equal inputTokenAmount when passed.\n * @param outputToken The token the relayer will send to the recipient on the destination chain. Must be an ERC20.\n * @param inputAmount The amount of input tokens pulled from the caller's account and locked into this contract.\n * This amount will be sent to the relayer as a refund following an optimistic challenge window in the HubPool, plus a system fee.\n * @param outputAmount The amount of output tokens the relayer will send to the recipient on the destination.\n * @param destinationChainId The destination chain identifier. Must be enabled with the input token as a valid deposit route\n * from this spoke pool, or the transaction will revert.\n * @param exclusiveRelayer The relayer exclusively allowed to fill the deposit before the exclusivity deadline.\n * @param fillDeadlineOffset Added to the current time to set the fill deadline. After this timestamp, fills on the\n * destination chain will revert.\n * @param exclusivityParameter See identically named parameter in deposit() comments.\n * @param message The message to send to the recipient on the destination chain. If the recipient is a contract, it must\n * implement `handleV3AcrossMessage()` if the message is not empty, or the fill will revert.\n */\n function depositV3Now(\n address depositor,\n address recipient,\n address inputToken,\n address outputToken,\n uint256 inputAmount,\n uint256 outputAmount,\n uint256 destinationChainId,\n address exclusiveRelayer,\n uint32 fillDeadlineOffset,\n uint32 exclusivityParameter,\n bytes calldata message\n ) external payable override {\n depositV3(\n depositor,\n recipient,\n inputToken,\n outputToken,\n inputAmount,\n outputAmount,\n destinationChainId,\n exclusiveRelayer,\n uint32(getCurrentTime()),\n uint32(getCurrentTime()) + fillDeadlineOffset,\n exclusivityParameter,\n message\n );\n }\n\n /**\n * @notice Depositor can use this function to signal to relayer to use updated output amount, recipient,\n * and/or message. The speed up signature uniquely identifies the speed up based only on\n * depositor, deposit ID and origin chain, so using this function in conjunction with unsafeDeposit is risky\n * due to the chance of repeating a deposit ID.\n * @dev the depositor and depositId must match the params in a FundsDeposited event that the depositor\n * wants to speed up. The relayer has the option but not the obligation to use this updated information\n * when filling the deposit via fillRelayWithUpdatedDeposit().\n * @param depositor Depositor that must sign the depositorSignature and was the original depositor.\n * @param depositId Deposit ID to speed up.\n * @param updatedOutputAmount New output amount to use for this deposit. Should be lower than previous value\n * otherwise relayer has no incentive to use this updated value.\n * @param updatedRecipient New recipient to use for this deposit. Can be modified if the recipient is a contract\n * that expects to receive a message from the relay and for some reason needs to be modified.\n * @param updatedMessage New message to use for this deposit. Can be modified if the recipient is a contract\n * that expects to receive a message from the relay and for some reason needs to be modified.\n * @param depositorSignature Signed EIP712 hashstruct containing the deposit ID. Should be signed by the depositor\n * account. If depositor is a contract, then should implement EIP1271 to sign as a contract. See\n * _verifyUpdateV3DepositMessage() for more details about how this signature should be constructed.\n */\n function speedUpDeposit(\n bytes32 depositor,\n uint256 depositId,\n uint256 updatedOutputAmount,\n bytes32 updatedRecipient,\n bytes calldata updatedMessage,\n bytes calldata depositorSignature\n ) public override nonReentrant {\n _verifyUpdateV3DepositMessage(\n depositor.toAddress(),\n depositId,\n chainId(),\n updatedOutputAmount,\n updatedRecipient,\n updatedMessage,\n depositorSignature,\n UPDATE_BYTES32_DEPOSIT_DETAILS_HASH\n );\n\n // Assuming the above checks passed, a relayer can take the signature and the updated deposit information\n // from the following event to submit a fill with updated relay data.\n emit RequestedSpeedUpDeposit(\n updatedOutputAmount,\n depositId,\n depositor,\n updatedRecipient,\n updatedMessage,\n depositorSignature\n );\n }\n\n /**\n * @notice A version of `speedUpDeposit` using `address` types for backward compatibility.\n * This function allows the depositor to signal to the relayer to use updated output amount, recipient, and/or message\n * when filling a deposit. This can be useful when the deposit needs to be modified after the original transaction has\n * been mined.\n *\n * @dev The `depositor` and `depositId` must match the parameters in a `FundsDeposited` event that the depositor wants to speed up.\n * The relayer is not obligated but has the option to use this updated information when filling the deposit using\n * `fillRelayWithUpdatedDeposit()`. This version uses `address` types for compatibility with systems relying on\n * `address`-based implementations.\n *\n * @param depositor The depositor that must sign the `depositorSignature` and was the original depositor.\n * @param depositId The deposit ID to speed up.\n * @param updatedOutputAmount The new output amount to use for this deposit. It should be lower than the previous value,\n * otherwise the relayer has no incentive to use this updated value.\n * @param updatedRecipient The new recipient for this deposit. Can be modified if the original recipient is a contract that\n * expects to receive a message from the relay and needs to be changed.\n * @param updatedMessage The new message for this deposit. Can be modified if the recipient is a contract that expects\n * to receive a message from the relay and needs to be updated.\n * @param depositorSignature The signed EIP712 hashstruct containing the deposit ID. Should be signed by the depositor account.\n * If the depositor is a contract, it should implement EIP1271 to sign as a contract. See `_verifyUpdateV3DepositMessage()`\n * for more details on how the signature should be constructed.\n */\n function speedUpV3Deposit(\n address depositor,\n uint256 depositId,\n uint256 updatedOutputAmount,\n address updatedRecipient,\n bytes calldata updatedMessage,\n bytes calldata depositorSignature\n ) public {\n _verifyUpdateV3DepositMessage(\n depositor,\n depositId,\n chainId(),\n updatedOutputAmount,\n updatedRecipient.toBytes32(),\n updatedMessage,\n depositorSignature,\n UPDATE_BYTES32_DEPOSIT_DETAILS_HASH\n );\n\n // Assuming the above checks passed, a relayer can take the signature and the updated deposit information\n // from the following event to submit a fill with updated relay data.\n emit RequestedSpeedUpDeposit(\n updatedOutputAmount,\n depositId,\n depositor.toBytes32(),\n updatedRecipient.toBytes32(),\n updatedMessage,\n depositorSignature\n );\n }\n\n /**************************************\n * RELAYER FUNCTIONS *\n **************************************/\n\n /**\n * @notice Fulfill request to bridge cross chain by sending specified output tokens to the recipient.\n * @dev The fee paid to relayers and the system should be captured in the spread between output\n * amount and input amount when adjusted to be denominated in the input token. A relayer on the destination\n * chain will send outputAmount of outputTokens to the recipient and receive inputTokens on a repayment\n * chain of their choice. Therefore, the fee should account for destination fee transaction costs, the\n * relayer's opportunity cost of capital while they wait to be refunded following an optimistic challenge\n * window in the HubPool, and a system fee charged to relayers.\n * @dev The hash of the relayData will be used to uniquely identify the deposit to fill, so\n * modifying any params in it will result in a different hash and a different deposit. The hash will comprise\n * all parameters passed to deposit() on the origin chain along with that chain's chainId(). This chain's\n * chainId() must therefore match the destinationChainId passed into deposit.\n * Relayers are only refunded for filling deposits with deposit hashes that map exactly to the one emitted by the\n * origin SpokePool therefore the relayer should not modify any params in relayData.\n * @dev Cannot fill more than once. Partial fills are not supported.\n * @param relayData struct containing all the data needed to identify the deposit to be filled. Should match\n * all the same-named parameters emitted in the origin chain FundsDeposited event.\n * - depositor: The account credited with the deposit who can request to \"speed up\" this deposit by modifying\n * the output amount, recipient, and message.\n * - recipient The account receiving funds on this chain. Can be an EOA or a contract. If\n * the output token is the wrapped native token for the chain, then the recipient will receive native token if\n * an EOA or wrapped native token if a contract.\n * - inputToken: The token pulled from the caller's account to initiate the deposit. The equivalent of this\n * token on the repayment chain will be sent as a refund to the caller.\n * - outputToken The token that the caller will send to the recipient on the destination chain. Must be an\n * ERC20.\n * - inputAmount: This amount, less a system fee, will be sent to the caller on their repayment chain of choice as a refund\n * following an optimistic challenge window in the HubPool.\n * - outputAmount: The amount of output tokens that the caller will send to the recipient.\n * - originChainId: The origin chain identifier.\n * - exclusiveRelayer The relayer that will be exclusively allowed to fill this deposit before the\n * exclusivity deadline timestamp.\n * - fillDeadline The deadline for the caller to fill the deposit. After this timestamp,\n * the fill will revert on the destination chain.\n * - exclusivityDeadline: The deadline for the exclusive relayer to fill the deposit. After this\n * timestamp, anyone can fill this deposit. Note that if this value was set in deposit by adding an offset\n * to the deposit's block.timestamp, there is re-org risk for the caller of this method because the event's\n * block.timestamp can change. Read the comments in `deposit` about the `exclusivityParameter` for more details.\n * - message The message to send to the recipient if the recipient is a contract that implements a\n * handleV3AcrossMessage() public function\n * @param repaymentChainId Chain of SpokePool where relayer wants to be refunded after the challenge window has\n * passed. Will receive inputAmount of the equivalent token to inputToken on the repayment chain.\n * @param repaymentAddress Address the relayer wants to be receive their refund at.\n */\n function fillRelay(\n V3RelayData memory relayData,\n uint256 repaymentChainId,\n bytes32 repaymentAddress\n ) public override nonReentrant unpausedFills {\n // Exclusivity deadline is inclusive and is the latest timestamp that the exclusive relayer has sole right\n // to fill the relay.\n if (\n _fillIsExclusive(relayData.exclusivityDeadline, uint32(getCurrentTime())) &&\n relayData.exclusiveRelayer.toAddress() != msg.sender\n ) {\n revert NotExclusiveRelayer();\n }\n\n V3RelayExecutionParams memory relayExecution = V3RelayExecutionParams({\n relay: relayData,\n relayHash: getV3RelayHash(relayData),\n updatedOutputAmount: relayData.outputAmount,\n updatedRecipient: relayData.recipient,\n updatedMessage: relayData.message,\n repaymentChainId: repaymentChainId\n });\n\n _fillRelayV3(relayExecution, repaymentAddress, false);\n }\n\n // Exposes the same function as fillRelay but with a legacy V3RelayData struct that takes in address types. Inner\n // function fillV3Relay() applies reentrancy & non-paused checks.\n function fillV3Relay(V3RelayDataLegacy calldata relayData, uint256 repaymentChainId) public override {\n // Convert V3RelayDataLegacy to V3RelayData using the .toBytes32() method.\n V3RelayData memory convertedRelayData = V3RelayData({\n depositor: relayData.depositor.toBytes32(),\n recipient: relayData.recipient.toBytes32(),\n exclusiveRelayer: relayData.exclusiveRelayer.toBytes32(),\n inputToken: relayData.inputToken.toBytes32(),\n outputToken: relayData.outputToken.toBytes32(),\n inputAmount: relayData.inputAmount,\n outputAmount: relayData.outputAmount,\n originChainId: relayData.originChainId,\n depositId: relayData.depositId,\n fillDeadline: relayData.fillDeadline,\n exclusivityDeadline: relayData.exclusivityDeadline,\n message: relayData.message\n });\n\n fillRelay(convertedRelayData, repaymentChainId, msg.sender.toBytes32());\n }\n\n /**\n * @notice Identical to fillV3Relay except that the relayer wants to use a depositor's updated output amount,\n * recipient, and/or message. The relayer should only use this function if they can supply a message signed\n * by the depositor that contains the fill's matching deposit ID along with updated relay parameters.\n * If the signature can be verified, then this function will emit a FilledV3Event that will be used by\n * the system for refund verification purposes. In other words, this function is an alternative way to fill a\n * a deposit than fillV3Relay.\n * @dev Subject to same exclusivity deadline rules as fillV3Relay().\n * @param relayData struct containing all the data needed to identify the deposit to be filled. See fillV3Relay().\n * @param repaymentChainId Chain of SpokePool where relayer wants to be refunded after the challenge window has\n * passed. See fillV3Relay().\n * @param repaymentAddress Address the relayer wants to be receive their refund at.\n * @param updatedOutputAmount New output amount to use for this deposit.\n * @param updatedRecipient New recipient to use for this deposit.\n * @param updatedMessage New message to use for this deposit.\n * @param depositorSignature Signed EIP712 hashstruct containing the deposit ID. Should be signed by the depositor\n * account.\n */\n function fillRelayWithUpdatedDeposit(\n V3RelayData calldata relayData,\n uint256 repaymentChainId,\n bytes32 repaymentAddress,\n uint256 updatedOutputAmount,\n bytes32 updatedRecipient,\n bytes calldata updatedMessage,\n bytes calldata depositorSignature\n ) public override nonReentrant unpausedFills {\n // Exclusivity deadline is inclusive and is the latest timestamp that the exclusive relayer has sole right\n // to fill the relay.\n if (\n _fillIsExclusive(relayData.exclusivityDeadline, uint32(getCurrentTime())) &&\n relayData.exclusiveRelayer.toAddress() != msg.sender\n ) {\n revert NotExclusiveRelayer();\n }\n\n V3RelayExecutionParams memory relayExecution = V3RelayExecutionParams({\n relay: relayData,\n relayHash: getV3RelayHash(relayData),\n updatedOutputAmount: updatedOutputAmount,\n updatedRecipient: updatedRecipient,\n updatedMessage: updatedMessage,\n repaymentChainId: repaymentChainId\n });\n\n _verifyUpdateV3DepositMessage(\n relayData.depositor.toAddress(),\n relayData.depositId,\n relayData.originChainId,\n updatedOutputAmount,\n updatedRecipient,\n updatedMessage,\n depositorSignature,\n UPDATE_BYTES32_DEPOSIT_DETAILS_HASH\n );\n\n _fillRelayV3(relayExecution, repaymentAddress, false);\n }\n\n /**\n * @notice Request Across to send LP funds to this contract to fulfill a slow fill relay\n * for a deposit in the next bundle.\n * @dev Slow fills are not possible unless the input and output tokens are \"equivalent\", i.e.\n * they route to the same L1 token via PoolRebalanceRoutes.\n * @dev Slow fills are created by inserting slow fill objects into a merkle tree that is included\n * in the next HubPool \"root bundle\". Once the optimistic challenge window has passed, the HubPool\n * will relay the slow root to this chain via relayRootBundle(). Once the slow root is relayed,\n * the slow fill can be executed by anyone who calls executeSlowRelayLeaf().\n * @dev Cannot request a slow fill if the fill deadline has passed.\n * @dev Cannot request a slow fill if the relay has already been filled or a slow fill has already been requested.\n * @param relayData struct containing all the data needed to identify the deposit that should be\n * slow filled. If any of the params are missing or different from the origin chain deposit,\n * then Across will not include a slow fill for the intended deposit.\n */\n function requestSlowFill(V3RelayData calldata relayData) public override nonReentrant unpausedFills {\n uint32 currentTime = uint32(getCurrentTime());\n // If a depositor has set an exclusivity deadline, then only the exclusive relayer should be able to\n // fast fill within this deadline. Moreover, the depositor should expect to get *fast* filled within\n // this deadline, not slow filled. As a simplifying assumption, we will not allow slow fills to be requested\n // during this exclusivity period.\n if (_fillIsExclusive(relayData.exclusivityDeadline, currentTime)) {\n revert NoSlowFillsInExclusivityWindow();\n }\n if (relayData.fillDeadline < currentTime) revert ExpiredFillDeadline();\n\n bytes32 relayHash = getV3RelayHash(relayData);\n if (fillStatuses[relayHash] != uint256(FillStatus.Unfilled)) revert InvalidSlowFillRequest();\n fillStatuses[relayHash] = uint256(FillStatus.RequestedSlowFill);\n\n emit RequestedSlowFill(\n relayData.inputToken,\n relayData.outputToken,\n relayData.inputAmount,\n relayData.outputAmount,\n relayData.originChainId,\n relayData.depositId,\n relayData.fillDeadline,\n relayData.exclusivityDeadline,\n relayData.exclusiveRelayer,\n relayData.depositor,\n relayData.recipient,\n _hashNonEmptyMessage(relayData.message)\n );\n }\n\n /**\n * @notice Fills a single leg of a particular order on the destination chain\n * @dev ERC-7683 fill function.\n * @param orderId Unique order identifier for this order\n * @param originData Data emitted on the origin to parameterize the fill\n * @param fillerData Data provided by the filler to inform the fill or express their preferences\n */\n function fill(\n bytes32 orderId,\n bytes calldata originData,\n bytes calldata fillerData\n ) external {\n if (keccak256(abi.encode(originData, chainId())) != orderId) {\n revert WrongERC7683OrderId();\n }\n\n // Ensure that the call is not malformed. If the call is malformed, abi.decode will fail.\n V3SpokePoolInterface.V3RelayData memory relayData = abi.decode(originData, (V3SpokePoolInterface.V3RelayData));\n AcrossDestinationFillerData memory destinationFillerData = abi.decode(\n fillerData,\n (AcrossDestinationFillerData)\n );\n\n // Must do a delegatecall because the function requires the inputs to be calldata.\n (bool success, bytes memory data) = address(this).delegatecall(\n abi.encodeCall(\n V3SpokePoolInterface.fillRelay,\n (relayData, destinationFillerData.repaymentChainId, msg.sender.toBytes32())\n )\n );\n if (!success) {\n revert LowLevelCallFailed(data);\n }\n }\n\n /**************************************\n * DATA WORKER FUNCTIONS *\n **************************************/\n\n /**\n * @notice Executes a slow relay leaf stored as part of a root bundle relayed by the HubPool.\n * @dev Executing a slow fill leaf is equivalent to filling the relayData so this function cannot be used to\n * double fill a recipient. The relayData that is filled is included in the slowFillLeaf and is hashed\n * like any other fill sent through a fill method.\n * @dev There is no relayer credited with filling this relay since funds are sent directly out of this contract.\n * @param slowFillLeaf Contains all data necessary to uniquely identify a relay for this chain. This struct is\n * hashed and included in a merkle root that is relayed to all spoke pools.\n * - relayData: struct containing all the data needed to identify the original deposit to be slow filled.\n * - chainId: chain identifier where slow fill leaf should be executed. If this doesn't match this chain's\n * chainId, then this function will revert.\n * - updatedOutputAmount: Amount to be sent to recipient out of this contract's balance. Can be set differently\n * from relayData.outputAmount to charge a different fee because this deposit was \"slow\" filled. Usually,\n * this will be set higher to reimburse the recipient for waiting for the slow fill.\n * @param rootBundleId Unique ID of root bundle containing slow relay root that this leaf is contained in.\n * @param proof Inclusion proof for this leaf in slow relay root in root bundle.\n */\n function executeSlowRelayLeaf(\n V3SlowFill calldata slowFillLeaf,\n uint32 rootBundleId,\n bytes32[] calldata proof\n ) public override nonReentrant {\n V3RelayData memory relayData = slowFillLeaf.relayData;\n\n _preExecuteLeafHook(relayData.outputToken.toAddress());\n\n // @TODO In the future consider allowing way for slow fill leaf to be created with updated\n // deposit params like outputAmount, message and recipient.\n V3RelayExecutionParams memory relayExecution = V3RelayExecutionParams({\n relay: relayData,\n relayHash: getV3RelayHash(relayData),\n updatedOutputAmount: slowFillLeaf.updatedOutputAmount,\n updatedRecipient: relayData.recipient,\n updatedMessage: relayData.message,\n repaymentChainId: EMPTY_REPAYMENT_CHAIN_ID // Repayment not relevant for slow fills.\n });\n\n _verifyV3SlowFill(relayExecution, rootBundleId, proof);\n\n // - No relayer to refund for slow fill executions.\n _fillRelayV3(relayExecution, EMPTY_RELAYER, true);\n }\n\n /**\n * @notice Executes a relayer refund leaf stored as part of a root bundle. Will send the relayer the amount they\n * sent to the recipient plus a relayer fee.\n * @param rootBundleId Unique ID of root bundle containing relayer refund root that this leaf is contained in.\n * @param relayerRefundLeaf Contains all data necessary to reconstruct leaf contained in root bundle and to\n * refund relayer. This data structure is explained in detail in the SpokePoolInterface.\n * @param proof Inclusion proof for this leaf in relayer refund root in root bundle.\n */\n function executeRelayerRefundLeaf(\n uint32 rootBundleId,\n SpokePoolInterface.RelayerRefundLeaf memory relayerRefundLeaf,\n bytes32[] memory proof\n ) public payable virtual override nonReentrant {\n _preExecuteLeafHook(relayerRefundLeaf.l2TokenAddress);\n\n if (relayerRefundLeaf.chainId != chainId()) revert InvalidChainId();\n\n RootBundle storage rootBundle = rootBundles[rootBundleId];\n\n // Check that proof proves that relayerRefundLeaf is contained within the relayer refund root.\n // Note: This should revert if the relayerRefundRoot is uninitialized.\n if (!MerkleLib.verifyRelayerRefund(rootBundle.relayerRefundRoot, relayerRefundLeaf, proof)) {\n revert InvalidMerkleProof();\n }\n\n _setClaimedLeaf(rootBundleId, relayerRefundLeaf.leafId);\n\n bool deferredRefunds = _distributeRelayerRefunds(\n relayerRefundLeaf.chainId,\n relayerRefundLeaf.amountToReturn,\n relayerRefundLeaf.refundAmounts,\n relayerRefundLeaf.leafId,\n relayerRefundLeaf.l2TokenAddress,\n relayerRefundLeaf.refundAddresses\n );\n\n emit ExecutedRelayerRefundRoot(\n relayerRefundLeaf.amountToReturn,\n relayerRefundLeaf.chainId,\n relayerRefundLeaf.refundAmounts,\n rootBundleId,\n relayerRefundLeaf.leafId,\n relayerRefundLeaf.l2TokenAddress,\n relayerRefundLeaf.refundAddresses,\n deferredRefunds,\n msg.sender\n );\n }\n\n /**\n * @notice Enables a relayer to claim outstanding repayments. Should virtually never be used, unless for some reason\n * relayer repayment transfer fails for reasons such as token transfer reverts due to blacklisting. In this case,\n * the relayer can still call this method and claim the tokens to a new address.\n * @param l2TokenAddress Address of the L2 token to claim refunds for.\n * @param refundAddress Address to send the refund to.\n */\n function claimRelayerRefund(bytes32 l2TokenAddress, bytes32 refundAddress) external {\n uint256 refund = relayerRefund[l2TokenAddress.toAddress()][msg.sender];\n if (refund == 0) revert NoRelayerRefundToClaim();\n relayerRefund[l2TokenAddress.toAddress()][msg.sender] = 0;\n IERC20Upgradeable(l2TokenAddress.toAddress()).safeTransfer(refundAddress.toAddress(), refund);\n\n emit ClaimedRelayerRefund(l2TokenAddress, refundAddress, refund, msg.sender);\n }\n\n /**************************************\n * VIEW FUNCTIONS *\n **************************************/\n\n /**\n * @notice Returns chain ID for this network.\n * @dev Some L2s like ZKSync don't support the CHAIN_ID opcode so we allow the implementer to override this.\n */\n function chainId() public view virtual override returns (uint256) {\n return block.chainid;\n }\n\n /**\n * @notice Gets the current time.\n * @return uint for the current timestamp.\n */\n function getCurrentTime() public view virtual returns (uint256) {\n return block.timestamp; // solhint-disable-line not-rely-on-time\n }\n\n /**\n * @notice Returns the deposit ID for an unsafe deposit. This function is used to compute the deposit ID\n * in unsafeDeposit and is provided as a convenience.\n * @dev msgSender and depositor are both used as inputs to allow passthrough depositors to create unique\n * deposit hash spaces for unique depositors.\n * @param msgSender The caller of the transaction used as input to produce the deposit ID.\n * @param depositor The depositor address used as input to produce the deposit ID.\n * @param depositNonce The nonce used as input to produce the deposit ID.\n * @return The deposit ID for the unsafe deposit.\n */\n function getUnsafeDepositId(\n address msgSender,\n bytes32 depositor,\n uint256 depositNonce\n ) public pure returns (uint256) {\n return uint256(keccak256(abi.encodePacked(msgSender, depositor, depositNonce)));\n }\n\n function getRelayerRefund(address l2TokenAddress, address refundAddress) public view returns (uint256) {\n return relayerRefund[l2TokenAddress][refundAddress];\n }\n\n function getV3RelayHash(V3RelayData memory relayData) public view returns (bytes32) {\n return keccak256(abi.encode(relayData, chainId()));\n }\n\n /**************************************\n * INTERNAL FUNCTIONS *\n **************************************/\n\n function _depositV3(DepositV3Params memory params) internal {\n // Verify depositor is a valid EVM address.\n params.depositor.checkAddress();\n\n // Require that quoteTimestamp has a maximum age so that depositors pay an LP fee based on recent HubPool usage.\n // It is assumed that cross-chain timestamps are normally loosely in-sync, but clock drift can occur. If the\n // SpokePool time stalls or lags significantly, it is still possible to make deposits by setting quoteTimestamp\n // within the configured buffer. The owner should pause deposits/fills if this is undesirable.\n // This will underflow if quoteTimestamp is more than depositQuoteTimeBuffer;\n // this is safe but will throw an unintuitive error.\n\n // slither-disable-next-line timestamp\n uint256 currentTime = getCurrentTime();\n if (currentTime < params.quoteTimestamp || currentTime - params.quoteTimestamp > depositQuoteTimeBuffer)\n revert InvalidQuoteTimestamp();\n\n // fillDeadline is relative to the destination chain.\n // Don’t allow fillDeadline to be more than several bundles into the future.\n // This limits the maximum required lookback for dataworker and relayer instances.\n if (params.fillDeadline > currentTime + fillDeadlineBuffer) revert InvalidFillDeadline();\n\n // There are three cases for setting the exclusivity deadline using the exclusivity parameter:\n // 1. If this parameter is 0, then there is no exclusivity period and emit 0 for the deadline. This\n // means that fillers of this deposit do not have to worry about the block.timestamp of this event changing\n // due to re-orgs when filling this deposit.\n // 2. If the exclusivity parameter is less than or equal to MAX_EXCLUSIVITY_PERIOD_SECONDS, then the exclusivity\n // deadline is set to the block.timestamp of this event plus the exclusivity parameter. This means that the\n // filler of this deposit assumes re-org risk when filling this deposit because the block.timestamp of this\n // event affects the exclusivity deadline.\n // 3. Otherwise, interpret this parameter as a timestamp and emit it as the exclusivity deadline. This means\n // that the filler of this deposit will not assume re-org risk related to the block.timestamp of this\n // event changing.\n uint32 exclusivityDeadline = params.exclusivityParameter;\n if (exclusivityDeadline > 0) {\n if (exclusivityDeadline <= MAX_EXCLUSIVITY_PERIOD_SECONDS) {\n exclusivityDeadline += uint32(currentTime);\n }\n\n // As a safety measure, prevent caller from inadvertently locking funds during exclusivity period\n // by forcing them to specify an exclusive relayer.\n if (params.exclusiveRelayer == bytes32(0)) revert InvalidExclusiveRelayer();\n }\n\n // If the address of the origin token is a wrappedNativeToken contract and there is a msg.value with the\n // transaction then the user is sending the native token. In this case, the native token should be\n // wrapped.\n if (params.inputToken == address(wrappedNativeToken).toBytes32() && msg.value > 0) {\n if (msg.value != params.inputAmount) revert MsgValueDoesNotMatchInputAmount();\n wrappedNativeToken.deposit{ value: msg.value }();\n // Else, it is a normal ERC20. In this case pull the token from the caller as per normal.\n // Note: this includes the case where the L2 caller has WETH (already wrapped ETH) and wants to bridge them.\n // In this case the msg.value will be set to 0, indicating a \"normal\" ERC20 bridging action.\n } else {\n // msg.value should be 0 if input token isn't the wrapped native token.\n if (msg.value != 0) revert MsgValueDoesNotMatchInputAmount();\n IERC20Upgradeable(params.inputToken.toAddress()).safeTransferFrom(\n msg.sender,\n address(this),\n params.inputAmount\n );\n }\n\n emit FundsDeposited(\n params.inputToken,\n params.outputToken,\n params.inputAmount,\n params.outputAmount,\n params.destinationChainId,\n params.depositId,\n params.quoteTimestamp,\n params.fillDeadline,\n exclusivityDeadline,\n params.depositor,\n params.recipient,\n params.exclusiveRelayer,\n params.message\n );\n }\n\n function _deposit(\n address depositor,\n address recipient,\n address originToken,\n uint256 amount,\n uint256 destinationChainId,\n int64 relayerFeePct,\n uint32 quoteTimestamp,\n bytes memory message\n ) internal {\n // We limit the relay fees to prevent the user spending all their funds on fees.\n if (SignedMath.abs(relayerFeePct) >= 0.5e18) revert InvalidRelayerFeePct();\n if (amount > MAX_TRANSFER_SIZE) revert MaxTransferSizeExceeded();\n\n // Require that quoteTimestamp has a maximum age so that depositors pay an LP fee based on recent HubPool usage.\n // It is assumed that cross-chain timestamps are normally loosely in-sync, but clock drift can occur. If the\n // SpokePool time stalls or lags significantly, it is still possible to make deposits by setting quoteTimestamp\n // within the configured buffer. The owner should pause deposits if this is undesirable. This will underflow if\n // quoteTimestamp is more than depositQuoteTimeBuffer; this is safe but will throw an unintuitive error.\n\n // slither-disable-next-line timestamp\n if (getCurrentTime() - quoteTimestamp > depositQuoteTimeBuffer) revert InvalidQuoteTimestamp();\n\n // Increment count of deposits so that deposit ID for this spoke pool is unique.\n uint32 newDepositId = numberOfDeposits++;\n\n // If the address of the origin token is a wrappedNativeToken contract and there is a msg.value with the\n // transaction then the user is sending ETH. In this case, the ETH should be deposited to wrappedNativeToken.\n if (originToken == address(wrappedNativeToken) && msg.value > 0) {\n if (msg.value != amount) revert MsgValueDoesNotMatchInputAmount();\n wrappedNativeToken.deposit{ value: msg.value }();\n // Else, it is a normal ERC20. In this case pull the token from the user's wallet as per normal.\n // Note: this includes the case where the L2 user has WETH (already wrapped ETH) and wants to bridge them.\n // In this case the msg.value will be set to 0, indicating a \"normal\" ERC20 bridging action.\n } else {\n IERC20Upgradeable(originToken).safeTransferFrom(msg.sender, address(this), amount);\n }\n\n emit FundsDeposited(\n originToken.toBytes32(), // inputToken\n bytes32(0), // outputToken. Setting this to 0x0 means that the outputToken should be assumed to be the\n // canonical token for the destination chain matching the inputToken. Therefore, this deposit\n // can always be slow filled.\n // - setting token to 0x0 will signal to off-chain validator that the \"equivalent\"\n // token as the inputToken for the destination chain should be replaced here.\n amount, // inputAmount\n _computeAmountPostFees(amount, relayerFeePct), // outputAmount\n // - output amount will be the deposit amount less relayerFeePct, which should now be set\n // equal to realizedLpFeePct + gasFeePct + capitalCostFeePct where (gasFeePct + capitalCostFeePct)\n // is equal to the old usage of `relayerFeePct`.\n destinationChainId,\n newDepositId,\n quoteTimestamp,\n INFINITE_FILL_DEADLINE, // fillDeadline. Default to infinite expiry because\n // expired deposits refunds could be a breaking change for existing users of this function.\n 0, // exclusivityDeadline. Setting this to 0 along with the exclusiveRelayer to 0x0 means that there\n // is no exclusive deadline\n depositor.toBytes32(),\n recipient.toBytes32(),\n bytes32(0), // exclusiveRelayer. Setting this to 0x0 will signal to off-chain validator that there\n // is no exclusive relayer.\n message\n );\n }\n\n function _distributeRelayerRefunds(\n uint256 _chainId,\n uint256 amountToReturn,\n uint256[] memory refundAmounts,\n uint32 leafId,\n address l2TokenAddress,\n address[] memory refundAddresses\n ) internal returns (bool deferredRefunds) {\n uint256 numRefunds = refundAmounts.length;\n if (refundAddresses.length != numRefunds) revert InvalidMerkleLeaf();\n\n if (numRefunds > 0) {\n uint256 spokeStartBalance = IERC20Upgradeable(l2TokenAddress).balanceOf(address(this));\n uint256 totalRefundedAmount = 0; // Track the total amount refunded.\n\n // Send each relayer refund address the associated refundAmount for the L2 token address.\n // Note: Even if the L2 token is not enabled on this spoke pool, we should still refund relayers.\n for (uint256 i = 0; i < numRefunds; ++i) {\n if (refundAmounts[i] > 0) {\n totalRefundedAmount += refundAmounts[i];\n\n // Only if the total refunded amount exceeds the spoke starting balance, should we revert. This\n // ensures that bundles are atomic, if we have sufficient balance to refund all relayers and\n // prevents can only re-pay some of the relayers.\n if (totalRefundedAmount > spokeStartBalance) revert InsufficientSpokePoolBalanceToExecuteLeaf();\n\n bool success = _noRevertTransfer(l2TokenAddress, refundAddresses[i], refundAmounts[i]);\n\n // If the transfer failed then track a deferred transfer for the relayer. Given this function would\n // have reverted if there was insufficient balance, this will only happen if the transfer call\n // reverts. This will only occur if the underlying transfer method on the l2Token reverts due to\n // recipient blacklisting or other related modifications to the l2Token.transfer method.\n if (!success) {\n relayerRefund[l2TokenAddress][refundAddresses[i]] += refundAmounts[i];\n deferredRefunds = true;\n }\n }\n }\n }\n // If leaf's amountToReturn is positive, then send L2 --> L1 message to bridge tokens back via\n // chain-specific bridging method.\n if (amountToReturn > 0) {\n _bridgeTokensToHubPool(amountToReturn, l2TokenAddress);\n\n emit TokensBridged(amountToReturn, _chainId, leafId, l2TokenAddress.toBytes32(), msg.sender);\n }\n }\n\n // Re-implementation of OZ _callOptionalReturnBool to use private logic. Function executes a transfer and returns a\n // bool indicating if the external call was successful, rather than reverting. Original method:\n // https://github.com/OpenZeppelin/openzeppelin-contracts/blob/28aed34dc5e025e61ea0390c18cac875bfde1a78/contracts/token/ERC20/utils/SafeERC20.sol#L188\n function _noRevertTransfer(\n address token,\n address to,\n uint256 amount\n ) internal returns (bool) {\n bool success;\n uint256 returnSize;\n uint256 returnValue;\n bytes memory data = abi.encodeCall(IERC20Upgradeable.transfer, (to, amount));\n assembly {\n success := call(gas(), token, 0, add(data, 0x20), mload(data), 0, 0x20)\n returnSize := returndatasize()\n returnValue := mload(0)\n }\n return success && (returnSize == 0 ? address(token).code.length > 0 : returnValue == 1);\n }\n\n function _setCrossDomainAdmin(address newCrossDomainAdmin) internal {\n if (newCrossDomainAdmin == address(0)) revert InvalidCrossDomainAdmin();\n crossDomainAdmin = newCrossDomainAdmin;\n emit SetXDomainAdmin(newCrossDomainAdmin);\n }\n\n function _setWithdrawalRecipient(address newWithdrawalRecipient) internal {\n if (newWithdrawalRecipient == address(0)) revert InvalidWithdrawalRecipient();\n withdrawalRecipient = newWithdrawalRecipient;\n emit SetWithdrawalRecipient(newWithdrawalRecipient);\n }\n\n function _preExecuteLeafHook(address) internal virtual {\n // This method by default is a no-op. Different child spoke pools might want to execute functionality here\n // such as wrapping any native tokens owned by the contract into wrapped tokens before proceeding with\n // executing the leaf.\n }\n\n // Should be overriden by implementing contract depending on how L2 handles sending tokens to L1.\n function _bridgeTokensToHubPool(uint256 amountToReturn, address l2TokenAddress) internal virtual;\n\n function _setClaimedLeaf(uint32 rootBundleId, uint32 leafId) internal {\n RootBundle storage rootBundle = rootBundles[rootBundleId];\n\n // Verify the leafId in the leaf has not yet been claimed.\n if (MerkleLib.isClaimed(rootBundle.claimedBitmap, leafId)) revert ClaimedMerkleLeaf();\n\n // Set leaf as claimed in bitmap. This is passed by reference to the storage rootBundle.\n MerkleLib.setClaimed(rootBundle.claimedBitmap, leafId);\n }\n\n function _verifyUpdateV3DepositMessage(\n address depositor,\n uint256 depositId,\n uint256 originChainId,\n uint256 updatedOutputAmount,\n bytes32 updatedRecipient,\n bytes memory updatedMessage,\n bytes memory depositorSignature,\n bytes32 hashType\n ) internal view {\n // A depositor can request to modify an un-relayed deposit by signing a hash containing the updated\n // details and information uniquely identifying the deposit to relay. This information ensures\n // that this signature cannot be re-used for other deposits.\n bytes32 expectedTypedDataV4Hash = _hashTypedDataV4(\n keccak256(\n abi.encode(\n hashType,\n depositId,\n originChainId,\n updatedOutputAmount,\n updatedRecipient,\n keccak256(updatedMessage)\n )\n ),\n originChainId\n );\n _verifyDepositorSignature(depositor, expectedTypedDataV4Hash, depositorSignature);\n }\n\n // This function is isolated and made virtual to allow different L2's to implement chain specific recovery of\n // signers from signatures because some L2s might not support ecrecover. To be safe, consider always reverting\n // this function for L2s where ecrecover is different from how it works on Ethereum, otherwise there is the\n // potential to forge a signature from the depositor using a different private key than the original depositor's.\n function _verifyDepositorSignature(\n address depositor,\n bytes32 ethSignedMessageHash,\n bytes memory depositorSignature\n ) internal view virtual {\n // Note:\n // - We don't need to worry about re-entrancy from a contract deployed at the depositor address since the method\n // `SignatureChecker.isValidSignatureNow` is a view method. Re-entrancy can happen, but it cannot affect state.\n // - EIP-1271 signatures are supported. This means that a signature valid now, may not be valid later and vice-versa.\n // - For an EIP-1271 signature to work, the depositor contract address must map to a deployed contract on the destination\n // chain that can validate the signature.\n // - Regular signatures from an EOA are also supported.\n bool isValid = SignatureChecker.isValidSignatureNow(depositor, ethSignedMessageHash, depositorSignature);\n if (!isValid) revert InvalidDepositorSignature();\n }\n\n function _verifyV3SlowFill(\n V3RelayExecutionParams memory relayExecution,\n uint32 rootBundleId,\n bytes32[] memory proof\n ) internal view {\n V3SlowFill memory slowFill = V3SlowFill({\n relayData: relayExecution.relay,\n chainId: chainId(),\n updatedOutputAmount: relayExecution.updatedOutputAmount\n });\n\n if (!MerkleLib.verifyV3SlowRelayFulfillment(rootBundles[rootBundleId].slowRelayRoot, slowFill, proof)) {\n revert InvalidMerkleProof();\n }\n }\n\n function _computeAmountPostFees(uint256 amount, int256 feesPct) private pure returns (uint256) {\n return (amount * uint256(int256(1e18) - feesPct)) / 1e18;\n }\n\n // Unwraps ETH and does a transfer to a recipient address. If the recipient is a smart contract then sends wrappedNativeToken.\n function _unwrapwrappedNativeTokenTo(address payable to, uint256 amount) internal {\n if (address(to).isContract()) {\n IERC20Upgradeable(address(wrappedNativeToken)).safeTransfer(to, amount);\n } else {\n wrappedNativeToken.withdraw(amount);\n AddressLibUpgradeable.sendValue(to, amount);\n }\n }\n\n // @param relayer: relayer who is actually credited as filling this deposit. Can be different from\n // exclusiveRelayer if passed exclusivityDeadline or if slow fill.\n function _fillRelayV3(\n V3RelayExecutionParams memory relayExecution,\n bytes32 relayer,\n bool isSlowFill\n ) internal {\n V3RelayData memory relayData = relayExecution.relay;\n\n if (relayData.fillDeadline < getCurrentTime()) revert ExpiredFillDeadline();\n\n bytes32 relayHash = relayExecution.relayHash;\n\n // If a slow fill for this fill was requested then the relayFills value for this hash will be\n // FillStatus.RequestedSlowFill. Therefore, if this is the status, then this fast fill\n // will be replacing the slow fill. If this is a slow fill execution, then the following variable\n // is trivially true. We'll emit this value in the FilledRelay\n // event to assist the Dataworker in knowing when to return funds back to the HubPool that can no longer\n // be used for a slow fill execution.\n FillType fillType = isSlowFill\n ? FillType.SlowFill // The following is true if this is a fast fill that was sent after a slow fill request.\n : (\n fillStatuses[relayExecution.relayHash] == uint256(FillStatus.RequestedSlowFill)\n ? FillType.ReplacedSlowFill\n : FillType.FastFill\n );\n\n // @dev This function doesn't support partial fills. Therefore, we associate the relay hash with\n // an enum tracking its fill status. All filled relays, whether slow or fast fills, are set to the Filled\n // status. However, we also use this slot to track whether this fill had a slow fill requested. Therefore\n // we can include a bool in the FilledRelay event making it easy for the dataworker to compute if this\n // fill was a fast fill that replaced a slow fill and therefore this SpokePool has excess funds that it\n // needs to send back to the HubPool.\n if (fillStatuses[relayHash] == uint256(FillStatus.Filled)) revert RelayFilled();\n fillStatuses[relayHash] = uint256(FillStatus.Filled);\n\n // @dev Before returning early, emit events to assist the dataworker in being able to know which fills were\n // successful.\n emit FilledRelay(\n relayData.inputToken,\n relayData.outputToken,\n relayData.inputAmount,\n relayData.outputAmount,\n relayExecution.repaymentChainId,\n relayData.originChainId,\n relayData.depositId,\n relayData.fillDeadline,\n relayData.exclusivityDeadline,\n relayData.exclusiveRelayer,\n relayer,\n relayData.depositor,\n relayData.recipient,\n _hashNonEmptyMessage(relayData.message),\n V3RelayExecutionEventInfo({\n updatedRecipient: relayExecution.updatedRecipient,\n updatedMessageHash: _hashNonEmptyMessage(relayExecution.updatedMessage),\n updatedOutputAmount: relayExecution.updatedOutputAmount,\n fillType: fillType\n })\n );\n\n address outputToken = relayData.outputToken.toAddress();\n uint256 amountToSend = relayExecution.updatedOutputAmount;\n address recipientToSend = relayExecution.updatedRecipient.toAddress();\n // If relay token is wrappedNativeToken then unwrap and send native token.\n // Stack too deep.\n if (relayData.outputToken.toAddress() == address(wrappedNativeToken)) {\n // Note: useContractFunds is True if we want to send funds to the recipient directly out of this contract,\n // otherwise we expect the caller to send funds to the recipient. If useContractFunds is True and the\n // recipient wants wrappedNativeToken, then we can assume that wrappedNativeToken is already in the\n // contract, otherwise we'll need the user to send wrappedNativeToken to this contract. Regardless, we'll\n // need to unwrap it to native token before sending to the user.\n if (!isSlowFill) IERC20Upgradeable(outputToken).safeTransferFrom(msg.sender, address(this), amountToSend);\n _unwrapwrappedNativeTokenTo(payable(recipientToSend), amountToSend);\n // Else, this is a normal ERC20 token. Send to recipient.\n } else {\n // Note: Similar to note above, send token directly from the contract to the user in the slow relay case.\n if (!isSlowFill) IERC20Upgradeable(outputToken).safeTransferFrom(msg.sender, recipientToSend, amountToSend);\n else IERC20Upgradeable(outputToken).safeTransfer(recipientToSend, amountToSend);\n }\n\n bytes memory updatedMessage = relayExecution.updatedMessage;\n if (updatedMessage.length > 0 && recipientToSend.isContract()) {\n AcrossMessageHandler(recipientToSend).handleV3AcrossMessage(\n outputToken,\n amountToSend,\n msg.sender,\n updatedMessage\n );\n }\n }\n\n // Determine whether the exclusivityDeadline implies active exclusivity.\n function _fillIsExclusive(uint32 exclusivityDeadline, uint32 currentTime) internal pure returns (bool) {\n return exclusivityDeadline >= currentTime;\n }\n\n // Helper for emitting message hash. For easier easier human readability we return bytes32(0) for empty message.\n function _hashNonEmptyMessage(bytes memory message) internal pure returns (bytes32) {\n if (message.length == 0) return bytes32(0);\n else return keccak256(message);\n }\n\n // Implementing contract needs to override this to ensure that only the appropriate cross chain admin can execute\n // certain admin functions. For L2 contracts, the cross chain admin refers to some L1 address or contract, and for\n // L1, this would just be the same admin of the HubPool.\n function _requireAdminSender() internal virtual;\n\n // Added to enable the this contract to receive native token (ETH). Used when unwrapping wrappedNativeToken.\n receive() external payable {}\n\n // Reserve storage slots for future versions of this base contract to add state variables without\n // affecting the storage layout of child contracts. Decrement the size of __gap whenever state variables\n // are added. This is at bottom of contract to make sure it's always at the end of storage.\n uint256[998] private __gap;\n}\n"
+ },
+ "contracts/upgradeable/AddressLibUpgradeable.sol": {
+ "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (utils/Address.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @title AddressUpgradeable\n * @dev Collection of functions related to the address type\n * @notice Logic is 100% copied from \"@openzeppelin/contracts-upgradeable/contracts/utils/AddressUpgradeable.sol\" but one\n * comment is added to clarify why we allow delegatecall() in this contract, which is typically unsafe for use in\n * upgradeable implementation contracts.\n * @dev See https://docs.openzeppelin.com/upgrades-plugins/1.x/faq#delegatecall-selfdestruct for more details.\n * @custom:security-contact bugs@across.to\n */\nlibrary AddressLibUpgradeable {\n /**\n * @dev Returns true if `account` is a contract.\n *\n * [IMPORTANT]\n * ====\n * It is unsafe to assume that an address for which this function returns\n * false is an externally-owned account (EOA) and not a contract.\n *\n * Among others, `isContract` will return false for the following\n * types of addresses:\n *\n * - an externally-owned account\n * - a contract in construction\n * - an address where a contract will be created\n * - an address where a contract lived, but was destroyed\n *\n * Furthermore, `isContract` will also return true if the target contract within\n * the same transaction is already scheduled for destruction by `SELFDESTRUCT`,\n * which only has an effect at the end of a transaction.\n * ====\n *\n * [IMPORTANT]\n * ====\n * You shouldn't rely on `isContract` to protect against flash loan attacks!\n *\n * Preventing calls from contracts is highly discouraged. It breaks composability, breaks support for smart wallets\n * like Gnosis Safe, and does not provide security since it can be circumvented by calling from a contract\n * constructor.\n * ====\n */\n function isContract(address account) internal view returns (bool) {\n // This method relies on extcodesize/address.code.length, which returns 0\n // for contracts in construction, since the code is only stored at the end\n // of the constructor execution.\n\n return account.code.length > 0;\n }\n\n /**\n * @dev Replacement for Solidity's `transfer`: sends `amount` wei to\n * `recipient`, forwarding all available gas and reverting on errors.\n *\n * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost\n * of certain opcodes, possibly making contracts go over the 2300 gas limit\n * imposed by `transfer`, making them unable to receive funds via\n * `transfer`. {sendValue} removes this limitation.\n *\n * https://consensys.net/diligence/blog/2019/09/stop-using-soliditys-transfer-now/[Learn more].\n *\n * IMPORTANT: because control is transferred to `recipient`, care must be\n * taken to not create reentrancy vulnerabilities. Consider using\n * {ReentrancyGuard} or the\n * https://solidity.readthedocs.io/en/v0.8.0/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].\n */\n function sendValue(address payable recipient, uint256 amount) internal {\n require(address(this).balance >= amount, \"Address: insufficient balance\");\n\n (bool success, ) = recipient.call{ value: amount }(\"\");\n require(success, \"Address: unable to send value, recipient may have reverted\");\n }\n\n /**\n * @dev Performs a Solidity function call using a low level `call`. A\n * plain `call` is an unsafe replacement for a function call: use this\n * function instead.\n *\n * If `target` reverts with a revert reason, it is bubbled up by this\n * function (like regular Solidity function calls).\n *\n * Returns the raw returned data. To convert to the expected return value,\n * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].\n *\n * Requirements:\n *\n * - `target` must be a contract.\n * - calling `target` with `data` must not revert.\n *\n * _Available since v3.1._\n */\n function functionCall(address target, bytes memory data) internal returns (bytes memory) {\n return functionCallWithValue(target, data, 0, \"Address: low-level call failed\");\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with\n * `errorMessage` as a fallback revert reason when `target` reverts.\n *\n * _Available since v3.1._\n */\n function functionCall(\n address target,\n bytes memory data,\n string memory errorMessage\n ) internal returns (bytes memory) {\n return functionCallWithValue(target, data, 0, errorMessage);\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\n * but also transferring `value` wei to `target`.\n *\n * Requirements:\n *\n * - the calling contract must have an ETH balance of at least `value`.\n * - the called Solidity function must be `payable`.\n *\n * _Available since v3.1._\n */\n function functionCallWithValue(\n address target,\n bytes memory data,\n uint256 value\n ) internal returns (bytes memory) {\n return functionCallWithValue(target, data, value, \"Address: low-level call with value failed\");\n }\n\n /**\n * @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but\n * with `errorMessage` as a fallback revert reason when `target` reverts.\n *\n * _Available since v3.1._\n */\n function functionCallWithValue(\n address target,\n bytes memory data,\n uint256 value,\n string memory errorMessage\n ) internal returns (bytes memory) {\n require(address(this).balance >= value, \"Address: insufficient balance for call\");\n (bool success, bytes memory returndata) = target.call{ value: value }(data);\n return verifyCallResultFromTarget(target, success, returndata, errorMessage);\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\n * but performing a static call.\n *\n * _Available since v3.3._\n */\n function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {\n return functionStaticCall(target, data, \"Address: low-level static call failed\");\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],\n * but performing a static call.\n *\n * _Available since v3.3._\n */\n function functionStaticCall(\n address target,\n bytes memory data,\n string memory errorMessage\n ) internal view returns (bytes memory) {\n (bool success, bytes memory returndata) = target.staticcall(data);\n return verifyCallResultFromTarget(target, success, returndata, errorMessage);\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\n * but performing a delegate call.\n *\n * _Available since v3.4._\n */\n function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) {\n return functionDelegateCall(target, data, \"Address: low-level delegate call failed\");\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],\n * but performing a delegate call.\n *\n * _Available since v3.4._\n */\n function functionDelegateCall(\n address target,\n bytes memory data,\n string memory errorMessage\n ) internal returns (bytes memory) {\n /// @custom:oz-upgrades-unsafe-allow delegatecall\n (bool success, bytes memory returndata) = target.delegatecall(data);\n return verifyCallResultFromTarget(target, success, returndata, errorMessage);\n }\n\n /**\n * @dev Tool to verify that a low level call to smart-contract was successful, and revert (either by bubbling\n * the revert reason or using the provided one) in case of unsuccessful call or if target was not a contract.\n *\n * _Available since v4.8._\n */\n function verifyCallResultFromTarget(\n address target,\n bool success,\n bytes memory returndata,\n string memory errorMessage\n ) internal view returns (bytes memory) {\n if (success) {\n if (returndata.length == 0) {\n // only check isContract if the call was successful and the return data is empty\n // otherwise we already know that it was a contract\n require(isContract(target), \"Address: call to non-contract\");\n }\n return returndata;\n } else {\n _revert(returndata, errorMessage);\n }\n }\n\n /**\n * @dev Tool to verify that a low level call was successful, and revert if it wasn't, either by bubbling the\n * revert reason or using the provided one.\n *\n * _Available since v4.3._\n */\n function verifyCallResult(\n bool success,\n bytes memory returndata,\n string memory errorMessage\n ) internal pure returns (bytes memory) {\n if (success) {\n return returndata;\n } else {\n _revert(returndata, errorMessage);\n }\n }\n\n function _revert(bytes memory returndata, string memory errorMessage) private pure {\n // Look for revert reason and bubble it up if present\n if (returndata.length > 0) {\n // The easiest way to bubble the revert reason is using memory via assembly\n /// @solidity memory-safe-assembly\n assembly {\n let returndata_size := mload(returndata)\n revert(add(32, returndata), returndata_size)\n }\n } else {\n revert(errorMessage);\n }\n }\n}\n"
+ },
+ "contracts/upgradeable/EIP712CrossChainUpgradeable.sol": {
+ "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\n\nimport \"@openzeppelin/contracts-upgradeable/utils/cryptography/ECDSAUpgradeable.sol\";\nimport \"@openzeppelin/contracts-upgradeable/proxy/utils/Initializable.sol\";\n\n/**\n * @dev https://eips.ethereum.org/EIPS/eip-712[EIP 712] is a standard for hashing and signing of typed structured data.\n *\n * This contract is based on OpenZeppelin's implementation:\n * https://github.com/OpenZeppelin/openzeppelin-contracts-upgradeable/blob/master/contracts/utils/cryptography/EIP712Upgradeable.sol\n *\n * NOTE: Modified version that allows to build a domain separator that relies on a different chain id than the chain this\n * contract is deployed to. An example use case we want to support is:\n * - User A signs a message on chain with id = 1\n * - User B executes a method by verifying user A's EIP-712 compliant signature on a chain with id != 1\n * @custom:security-contact bugs@across.to\n */\nabstract contract EIP712CrossChainUpgradeable is Initializable {\n /* solhint-disable var-name-mixedcase */\n bytes32 private _HASHED_NAME;\n bytes32 private _HASHED_VERSION;\n bytes32 private constant _TYPE_HASH = keccak256(\"EIP712Domain(string name,string version,uint256 chainId)\");\n\n /* solhint-enable var-name-mixedcase */\n\n /**\n * @dev Initializes the domain separator and parameter caches.\n *\n * The meaning of `name` and `version` is specified in\n * https://eips.ethereum.org/EIPS/eip-712#definition-of-domainseparator[EIP 712]:\n *\n * - `name`: the user readable name of the signing domain, i.e. the name of the DApp or the protocol.\n * - `version`: the current major version of the signing domain.\n *\n * NOTE: These parameters cannot be changed except through a xref:learn::upgrading-smart-contracts.adoc[smart\n * contract upgrade].\n */\n function __EIP712_init(string memory name, string memory version) internal onlyInitializing {\n __EIP712_init_unchained(name, version);\n }\n\n function __EIP712_init_unchained(string memory name, string memory version) internal onlyInitializing {\n bytes32 hashedName = keccak256(bytes(name));\n bytes32 hashedVersion = keccak256(bytes(version));\n _HASHED_NAME = hashedName;\n _HASHED_VERSION = hashedVersion;\n }\n\n /**\n * @dev Returns the domain separator depending on the `originChainId`.\n * @param originChainId Chain id of network where message originates from.\n * @return bytes32 EIP-712-compliant domain separator.\n */\n function _domainSeparatorV4(uint256 originChainId) internal view returns (bytes32) {\n return keccak256(abi.encode(_TYPE_HASH, _HASHED_NAME, _HASHED_VERSION, originChainId));\n }\n\n /**\n * @dev Given an already https://eips.ethereum.org/EIPS/eip-712#definition-of-hashstruct[hashed struct], this\n * function returns the hash of the fully encoded EIP712 message for this domain.\n *\n * This hash can be used together with {ECDSA-recover} to obtain the signer of a message. For example:\n *\n * ```solidity\n * bytes32 structHash = keccak256(abi.encode(\n * keccak256(\"Mail(address to,string contents)\"),\n * mailTo,\n * keccak256(bytes(mailContents))\n * ));\n * bytes32 digest = _hashTypedDataV4(structHash, originChainId);\n * address signer = ECDSA.recover(digest, signature);\n * ```\n * @param structHash Hashed struct as defined in https://eips.ethereum.org/EIPS/eip-712#definition-of-hashstruct.\n * @param originChainId Chain id of network where message originates from.\n * @return bytes32 Hash digest that is recoverable via `EDCSA.recover`.\n */\n function _hashTypedDataV4(bytes32 structHash, uint256 originChainId) internal view virtual returns (bytes32) {\n return ECDSAUpgradeable.toTypedDataHash(_domainSeparatorV4(originChainId), structHash);\n }\n\n // Reserve storage slots for future versions of this base contract to add state variables without\n // affecting the storage layout of child contracts. Decrement the size of __gap whenever state variables\n // are added. This is at bottom of contract to make sure it's always at the end of storage.\n uint256[1000] private __gap;\n}\n"
+ },
+ "contracts/upgradeable/MultiCallerUpgradeable.sol": {
+ "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\n\n/**\n * @title MultiCallerUpgradeable\n * @notice Logic is 100% copied from \"@uma/core/contracts/common/implementation/MultiCaller.sol\" but one\n * comment is added to clarify why we allow delegatecall() in this contract, which is typically unsafe for use in\n * upgradeable implementation contracts.\n * @dev See https://docs.openzeppelin.com/upgrades-plugins/1.x/faq#delegatecall-selfdestruct for more details.\n * @custom:security-contact bugs@across.to\n */\ncontract MultiCallerUpgradeable {\n struct Result {\n bool success;\n bytes returnData;\n }\n\n function _validateMulticallData(bytes[] calldata data) internal virtual {\n // no-op\n }\n\n function multicall(bytes[] calldata data) external returns (bytes[] memory results) {\n _validateMulticallData(data);\n\n uint256 dataLength = data.length;\n results = new bytes[](dataLength);\n\n //slither-disable-start calls-loop\n for (uint256 i = 0; i < dataLength; ++i) {\n // Typically, implementation contracts used in the upgradeable proxy pattern shouldn't call `delegatecall`\n // because it could allow a malicious actor to call this implementation contract directly (rather than\n // through a proxy contract) and then selfdestruct() the contract, thereby freezing the upgradeable\n // proxy. However, since we're only delegatecall-ing into this contract, then we can consider this\n // use of delegatecall() safe.\n\n //slither-disable-start low-level-calls\n /// @custom:oz-upgrades-unsafe-allow delegatecall\n (bool success, bytes memory result) = address(this).delegatecall(data[i]);\n //slither-disable-end low-level-calls\n\n if (!success) {\n // Next 5 lines from https://ethereum.stackexchange.com/a/83577\n if (result.length < 68) revert();\n //slither-disable-next-line assembly\n assembly {\n result := add(result, 0x04)\n }\n revert(abi.decode(result, (string)));\n }\n\n results[i] = result;\n }\n //slither-disable-end calls-loop\n }\n\n function tryMulticall(bytes[] calldata data) external returns (Result[] memory results) {\n _validateMulticallData(data);\n\n uint256 dataLength = data.length;\n results = new Result[](dataLength);\n\n //slither-disable-start calls-loop\n for (uint256 i = 0; i < dataLength; ++i) {\n // The delegatecall here is safe for the same reasons outlined in the first multicall function.\n Result memory result = results[i];\n //slither-disable-start low-level-calls\n /// @custom:oz-upgrades-unsafe-allow delegatecall\n (result.success, result.returnData) = address(this).delegatecall(data[i]);\n //slither-disable-end low-level-calls\n }\n //slither-disable-end calls-loop\n }\n\n // Reserve storage slots for future versions of this base contract to add state variables without\n // affecting the storage layout of child contracts. Decrement the size of __gap whenever state variables\n // are added. This is at bottom of contract to make sure its always at the end of storage.\n uint256[1000] private __gap;\n}\n"
+ },
+ "contracts/WorldChain_SpokePool.sol": {
+ "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\nimport \"@eth-optimism/contracts/libraries/constants/Lib_PredeployAddresses.sol\";\n\nimport \"./Ovm_SpokePool.sol\";\nimport \"./external/interfaces/CCTPInterfaces.sol\";\n\n/**\n * @notice World Chain Spoke pool.\n * @custom:security-contact bugs@across.to\n */\ncontract WorldChain_SpokePool is Ovm_SpokePool {\n using SafeERC20 for IERC20;\n\n /// @custom:oz-upgrades-unsafe-allow constructor\n constructor(\n address _wrappedNativeTokenAddress,\n uint32 _depositQuoteTimeBuffer,\n uint32 _fillDeadlineBuffer,\n IERC20 _l2Usdc,\n ITokenMessenger _cctpTokenMessenger\n )\n Ovm_SpokePool(\n _wrappedNativeTokenAddress,\n _depositQuoteTimeBuffer,\n _fillDeadlineBuffer,\n _l2Usdc,\n _cctpTokenMessenger\n )\n {} // solhint-disable-line no-empty-blocks\n\n /**\n * @notice Construct the OVM SpokePool.\n * @param _initialDepositId Starting deposit ID. Set to 0 unless this is a re-deployment in order to mitigate\n * relay hash collisions.\n * @param _crossDomainAdmin Cross domain admin to set. Can be changed by admin.\n * @param _withdrawalRecipient Address which receives token withdrawals. Can be changed by admin. For Spoke Pools on L2,\n * this will likely be the hub pool.\n */\n function initialize(\n uint32 _initialDepositId,\n address _crossDomainAdmin,\n address _withdrawalRecipient\n ) public initializer {\n __OvmSpokePool_init(_initialDepositId, _crossDomainAdmin, _withdrawalRecipient, Lib_PredeployAddresses.OVM_ETH);\n }\n}\n"
+ }
+ },
+ "settings": {
+ "optimizer": {
+ "enabled": true,
+ "runs": 800
+ },
+ "viaIR": true,
+ "debug": {
+ "revertStrings": "strip"
+ },
+ "outputSelection": {
+ "*": {
+ "*": ["abi", "evm.bytecode", "evm.deployedBytecode", "evm.methodIdentifiers", "metadata"],
+ "": ["ast"]
+ }
+ }
+ }
+}
diff --git a/package.json b/package.json
index db6897370..c65838af1 100644
--- a/package.json
+++ b/package.json
@@ -46,7 +46,7 @@
"pre-commit-hook": "sh scripts/preCommitHook.sh"
},
"dependencies": {
- "@across-protocol/constants": "^3.1.66",
+ "@across-protocol/constants": "^3.1.68",
"@coral-xyz/anchor": "^0.31.1",
"@defi-wonderland/smock": "^2.3.4",
"@eth-optimism/contracts": "^0.5.40",
diff --git a/yarn.lock b/yarn.lock
index e680c2a94..def7984c8 100644
--- a/yarn.lock
+++ b/yarn.lock
@@ -2,10 +2,10 @@
# yarn lockfile v1
-"@across-protocol/constants@^3.1.66":
- version "3.1.66"
- resolved "https://registry.yarnpkg.com/@across-protocol/constants/-/constants-3.1.66.tgz#952964fe1ae98ac8bd928655d81a20744da8dbe7"
- integrity sha512-PP0445MLMnFWFzCvpXZQHD4n3DBJIQoIt3RSENNjCOJbkxDd4pqqDOAwN/BWv1jS6kLhKt6/U2poHRGJ4UPPXg==
+"@across-protocol/constants@^3.1.68":
+ version "3.1.68"
+ resolved "https://registry.yarnpkg.com/@across-protocol/constants/-/constants-3.1.68.tgz#2a58b091b3f717394ee8025b20ee89022da849d8"
+ integrity sha512-f/o4i323HxwT/4h32xZdxKLwN3xXoAaxcd/xwP0tfAc/+X4/a+1qJ5Mfx+U2IwDkSheiSyqRYF3z5oYPnax3mg==
"@across-protocol/contracts@^0.1.4":
version "0.1.4"
From 64da4f2d129fee4bc28c70304e0b26e7e4110357 Mon Sep 17 00:00:00 2001
From: Paul <108695806+pxrl@users.noreply.github.com>
Date: Tue, 3 Jun 2025 21:59:57 +0000
Subject: [PATCH 2/6] Drop redundant artefacts
---
deployments/mainnet/WorldChain_Adapter.json | 60 ++--
.../dc324d2c58d7b0ed46f2033874127662.json | 316 ------------------
2 files changed, 20 insertions(+), 356 deletions(-)
delete mode 100644 deployments/mainnet/solcInputs/dc324d2c58d7b0ed46f2033874127662.json
diff --git a/deployments/mainnet/WorldChain_Adapter.json b/deployments/mainnet/WorldChain_Adapter.json
index 68bc16915..cd20d3bf4 100644
--- a/deployments/mainnet/WorldChain_Adapter.json
+++ b/deployments/mainnet/WorldChain_Adapter.json
@@ -1,5 +1,5 @@
{
- "address": "0xf64819Ef8b755341B2A759268A21AF64bc9Fe616",
+ "address": "0x8eBebfc894047bEE213A561b8792fCa71241731f",
"abi": [
{
"inputs": [
@@ -22,11 +22,6 @@
"internalType": "contract IERC20",
"name": "_l1Usdc",
"type": "address"
- },
- {
- "internalType": "contract ITokenMessenger",
- "name": "_cctpTokenMessenger",
- "type": "address"
}
],
"stateMutability": "nonpayable",
@@ -147,19 +142,6 @@
"stateMutability": "view",
"type": "function"
},
- {
- "inputs": [],
- "name": "cctpV2",
- "outputs": [
- {
- "internalType": "bool",
- "name": "",
- "type": "bool"
- }
- ],
- "stateMutability": "view",
- "type": "function"
- },
{
"inputs": [],
"name": "recipientCircleDomainId",
@@ -233,19 +215,19 @@
"type": "function"
}
],
- "transactionHash": "0x303cb020c0e7a8eabc479f54af6bb1e00cd003ed5d1de09a9aba46ef93bfb516",
+ "transactionHash": "0x4b2782119d99b4f0d6b5dc0c3c77a405aa9edf61117ff002697d6507077adb41",
"receipt": {
"to": null,
"from": "0x9A8f92a830A5cB89a3816e3D267CB7791c16b04D",
- "contractAddress": "0xf64819Ef8b755341B2A759268A21AF64bc9Fe616",
- "transactionIndex": 162,
- "gasUsed": "974428",
+ "contractAddress": "0x8eBebfc894047bEE213A561b8792fCa71241731f",
+ "transactionIndex": 87,
+ "gasUsed": "977772",
"logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
- "blockHash": "0x5752e3e45f554c17b4b6948450943663add8cca558d748a7cee78b79da719c3d",
- "transactionHash": "0x303cb020c0e7a8eabc479f54af6bb1e00cd003ed5d1de09a9aba46ef93bfb516",
+ "blockHash": "0xb6ba820b1b4225350949fc8342034f5574bfc98680e9a4c11f2263136dda779e",
+ "transactionHash": "0x4b2782119d99b4f0d6b5dc0c3c77a405aa9edf61117ff002697d6507077adb41",
"logs": [],
- "blockNumber": 22625859,
- "cumulativeGasUsed": "15734174",
+ "blockNumber": 20921874,
+ "cumulativeGasUsed": "8766064",
"status": 1,
"byzantium": true
},
@@ -253,14 +235,13 @@
"0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
"0xf931a81D18B1766d15695ffc7c1920a62b7e710a",
"0x470458C91978D2d929704489Ad730DC3E3001113",
- "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
- "0x28b5a0e9C621a5BadaA536219b3a228C8168cf5d"
+ "0x0000000000000000000000000000000000000000"
],
- "numDeployments": 3,
- "solcInputHash": "dc324d2c58d7b0ed46f2033874127662",
- "metadata": "{\"compiler\":{\"version\":\"0.8.23+commit.f704f362\"},\"language\":\"Solidity\",\"output\":{\"abi\":[{\"inputs\":[{\"internalType\":\"contract WETH9Interface\",\"name\":\"_l1Weth\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"_crossDomainMessenger\",\"type\":\"address\"},{\"internalType\":\"contract IL1StandardBridge\",\"name\":\"_l1StandardBridge\",\"type\":\"address\"},{\"internalType\":\"contract IERC20\",\"name\":\"_l1Usdc\",\"type\":\"address\"},{\"internalType\":\"contract ITokenMessenger\",\"name\":\"_cctpTokenMessenger\",\"type\":\"address\"}],\"stateMutability\":\"nonpayable\",\"type\":\"constructor\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address\",\"name\":\"target\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"}],\"name\":\"MessageRelayed\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address\",\"name\":\"l1Token\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"l2Token\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"amount\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"to\",\"type\":\"address\"}],\"name\":\"TokensRelayed\",\"type\":\"event\"},{\"inputs\":[],\"name\":\"L1_STANDARD_BRIDGE\",\"outputs\":[{\"internalType\":\"contract IL1StandardBridge\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"L1_WETH\",\"outputs\":[{\"internalType\":\"contract WETH9Interface\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"L2_GAS_LIMIT\",\"outputs\":[{\"internalType\":\"uint32\",\"name\":\"\",\"type\":\"uint32\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"MESSENGER\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"cctpTokenMessenger\",\"outputs\":[{\"internalType\":\"contract ITokenMessenger\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"cctpV2\",\"outputs\":[{\"internalType\":\"bool\",\"name\":\"\",\"type\":\"bool\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"recipientCircleDomainId\",\"outputs\":[{\"internalType\":\"uint32\",\"name\":\"\",\"type\":\"uint32\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"target\",\"type\":\"address\"},{\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"}],\"name\":\"relayMessage\",\"outputs\":[],\"stateMutability\":\"payable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"l1Token\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"l2Token\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"amount\",\"type\":\"uint256\"},{\"internalType\":\"address\",\"name\":\"to\",\"type\":\"address\"}],\"name\":\"relayTokens\",\"outputs\":[],\"stateMutability\":\"payable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"usdcToken\",\"outputs\":[{\"internalType\":\"contract IERC20\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"}],\"devdoc\":{\"custom:security-contact\":\"bugs@across.to\",\"details\":\"Public functions calling external contracts do not guard against reentrancy because they are expected to be called via delegatecall, which will execute this contract's logic within the context of the originating contract. For example, the HubPool will delegatecall these functions, therefore its only necessary that the HubPool's methods that call this contract's logic guard against reentrancy.\",\"kind\":\"dev\",\"methods\":{\"constructor\":{\"params\":{\"_cctpTokenMessenger\":\"TokenMessenger contract to bridge via CCTP.\",\"_crossDomainMessenger\":\"XDomainMessenger Doctor Who system contract.\",\"_l1StandardBridge\":\"Standard bridge contract.\",\"_l1Usdc\":\"USDC address on L1.\",\"_l1Weth\":\"WETH address on L1.\"}},\"relayMessage(address,bytes)\":{\"params\":{\"message\":\"Data to send to target.\",\"target\":\"Contract on Doctor Who that will receive message.\"}},\"relayTokens(address,address,uint256,address)\":{\"params\":{\"amount\":\"Amount of L1 tokens to deposit and L2 tokens to receive.\",\"l1Token\":\"L1 token to deposit.\",\"l2Token\":\"L2 token to receive.\",\"to\":\"Bridge recipient.\"}}},\"version\":1},\"userdoc\":{\"kind\":\"user\",\"methods\":{\"constructor\":{\"notice\":\"Constructs new Adapter.\"},\"relayMessage(address,bytes)\":{\"notice\":\"Send cross-chain message to target on Doctor Who.\"},\"relayTokens(address,address,uint256,address)\":{\"notice\":\"Bridge tokens to Doctor Who.\"}},\"notice\":\"Contract containing logic to send messages from L1 to Doctor Who. This is a modified version of the Optimism adapter that excludes the custom bridging logic.\",\"version\":1}},\"settings\":{\"compilationTarget\":{\"contracts/chain-adapters/WorldChain_Adapter.sol\":\"WorldChain_Adapter\"},\"debug\":{\"revertStrings\":\"strip\"},\"evmVersion\":\"shanghai\",\"libraries\":{},\"metadata\":{\"bytecodeHash\":\"ipfs\",\"useLiteralContent\":true},\"optimizer\":{\"enabled\":true,\"runs\":1000000},\"remappings\":[],\"viaIR\":true},\"sources\":{\"@eth-optimism/contracts/L1/messaging/IL1ERC20Bridge.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity >0.5.0 <0.9.0;\\n\\n/**\\n * @title IL1ERC20Bridge\\n */\\ninterface IL1ERC20Bridge {\\n /**********\\n * Events *\\n **********/\\n\\n event ERC20DepositInitiated(\\n address indexed _l1Token,\\n address indexed _l2Token,\\n address indexed _from,\\n address _to,\\n uint256 _amount,\\n bytes _data\\n );\\n\\n event ERC20WithdrawalFinalized(\\n address indexed _l1Token,\\n address indexed _l2Token,\\n address indexed _from,\\n address _to,\\n uint256 _amount,\\n bytes _data\\n );\\n\\n /********************\\n * Public Functions *\\n ********************/\\n\\n /**\\n * @dev get the address of the corresponding L2 bridge contract.\\n * @return Address of the corresponding L2 bridge contract.\\n */\\n function l2TokenBridge() external returns (address);\\n\\n /**\\n * @dev deposit an amount of the ERC20 to the caller's balance on L2.\\n * @param _l1Token Address of the L1 ERC20 we are depositing\\n * @param _l2Token Address of the L1 respective L2 ERC20\\n * @param _amount Amount of the ERC20 to deposit\\n * @param _l2Gas Gas limit required to complete the deposit on L2.\\n * @param _data Optional data to forward to L2. This data is provided\\n * solely as a convenience for external contracts. Aside from enforcing a maximum\\n * length, these contracts provide no guarantees about its content.\\n */\\n function depositERC20(\\n address _l1Token,\\n address _l2Token,\\n uint256 _amount,\\n uint32 _l2Gas,\\n bytes calldata _data\\n ) external;\\n\\n /**\\n * @dev deposit an amount of ERC20 to a recipient's balance on L2.\\n * @param _l1Token Address of the L1 ERC20 we are depositing\\n * @param _l2Token Address of the L1 respective L2 ERC20\\n * @param _to L2 address to credit the withdrawal to.\\n * @param _amount Amount of the ERC20 to deposit.\\n * @param _l2Gas Gas limit required to complete the deposit on L2.\\n * @param _data Optional data to forward to L2. This data is provided\\n * solely as a convenience for external contracts. Aside from enforcing a maximum\\n * length, these contracts provide no guarantees about its content.\\n */\\n function depositERC20To(\\n address _l1Token,\\n address _l2Token,\\n address _to,\\n uint256 _amount,\\n uint32 _l2Gas,\\n bytes calldata _data\\n ) external;\\n\\n /*************************\\n * Cross-chain Functions *\\n *************************/\\n\\n /**\\n * @dev Complete a withdrawal from L2 to L1, and credit funds to the recipient's balance of the\\n * L1 ERC20 token.\\n * This call will fail if the initialized withdrawal from L2 has not been finalized.\\n *\\n * @param _l1Token Address of L1 token to finalizeWithdrawal for.\\n * @param _l2Token Address of L2 token where withdrawal was initiated.\\n * @param _from L2 address initiating the transfer.\\n * @param _to L1 address to credit the withdrawal to.\\n * @param _amount Amount of the ERC20 to deposit.\\n * @param _data Data provided by the sender on L2. This data is provided\\n * solely as a convenience for external contracts. Aside from enforcing a maximum\\n * length, these contracts provide no guarantees about its content.\\n */\\n function finalizeERC20Withdrawal(\\n address _l1Token,\\n address _l2Token,\\n address _from,\\n address _to,\\n uint256 _amount,\\n bytes calldata _data\\n ) external;\\n}\\n\",\"keccak256\":\"0x69f831896dcbb6bef4f2d6c8be6cd1bf352f5910074d3ce973b9f8e0a4f4c1dd\",\"license\":\"MIT\"},\"@eth-optimism/contracts/L1/messaging/IL1StandardBridge.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity >0.5.0 <0.9.0;\\n\\nimport \\\"./IL1ERC20Bridge.sol\\\";\\n\\n/**\\n * @title IL1StandardBridge\\n */\\ninterface IL1StandardBridge is IL1ERC20Bridge {\\n /**********\\n * Events *\\n **********/\\n event ETHDepositInitiated(\\n address indexed _from,\\n address indexed _to,\\n uint256 _amount,\\n bytes _data\\n );\\n\\n event ETHWithdrawalFinalized(\\n address indexed _from,\\n address indexed _to,\\n uint256 _amount,\\n bytes _data\\n );\\n\\n /********************\\n * Public Functions *\\n ********************/\\n\\n /**\\n * @dev Deposit an amount of the ETH to the caller's balance on L2.\\n * @param _l2Gas Gas limit required to complete the deposit on L2.\\n * @param _data Optional data to forward to L2. This data is provided\\n * solely as a convenience for external contracts. Aside from enforcing a maximum\\n * length, these contracts provide no guarantees about its content.\\n */\\n function depositETH(uint32 _l2Gas, bytes calldata _data) external payable;\\n\\n /**\\n * @dev Deposit an amount of ETH to a recipient's balance on L2.\\n * @param _to L2 address to credit the withdrawal to.\\n * @param _l2Gas Gas limit required to complete the deposit on L2.\\n * @param _data Optional data to forward to L2. This data is provided\\n * solely as a convenience for external contracts. Aside from enforcing a maximum\\n * length, these contracts provide no guarantees about its content.\\n */\\n function depositETHTo(\\n address _to,\\n uint32 _l2Gas,\\n bytes calldata _data\\n ) external payable;\\n\\n /*************************\\n * Cross-chain Functions *\\n *************************/\\n\\n /**\\n * @dev Complete a withdrawal from L2 to L1, and credit funds to the recipient's balance of the\\n * L1 ETH token. Since only the xDomainMessenger can call this function, it will never be called\\n * before the withdrawal is finalized.\\n * @param _from L2 address initiating the transfer.\\n * @param _to L1 address to credit the withdrawal to.\\n * @param _amount Amount of the ERC20 to deposit.\\n * @param _data Optional data to forward to L2. This data is provided\\n * solely as a convenience for external contracts. Aside from enforcing a maximum\\n * length, these contracts provide no guarantees about its content.\\n */\\n function finalizeETHWithdrawal(\\n address _from,\\n address _to,\\n uint256 _amount,\\n bytes calldata _data\\n ) external;\\n}\\n\",\"keccak256\":\"0x3d511f1bcea86aa88a9c41798926ea75b5b3f455c0377e63223a123a9e714ddc\",\"license\":\"MIT\"},\"@eth-optimism/contracts/libraries/bridge/ICrossDomainMessenger.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity >0.5.0 <0.9.0;\\n\\n/**\\n * @title ICrossDomainMessenger\\n */\\ninterface ICrossDomainMessenger {\\n /**********\\n * Events *\\n **********/\\n\\n event SentMessage(\\n address indexed target,\\n address sender,\\n bytes message,\\n uint256 messageNonce,\\n uint256 gasLimit\\n );\\n event RelayedMessage(bytes32 indexed msgHash);\\n event FailedRelayedMessage(bytes32 indexed msgHash);\\n\\n /*************\\n * Variables *\\n *************/\\n\\n function xDomainMessageSender() external view returns (address);\\n\\n /********************\\n * Public Functions *\\n ********************/\\n\\n /**\\n * Sends a cross domain message to the target messenger.\\n * @param _target Target contract address.\\n * @param _message Message to send to the target.\\n * @param _gasLimit Gas limit for the provided message.\\n */\\n function sendMessage(\\n address _target,\\n bytes calldata _message,\\n uint32 _gasLimit\\n ) external;\\n}\\n\",\"keccak256\":\"0x8f29ae23021345a20ccac7b5edb3fc38268aef943b65adc8a32e74b80bf1833a\",\"license\":\"MIT\"},\"@openzeppelin/contracts/token/ERC20/IERC20.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v4.9.0) (token/ERC20/IERC20.sol)\\n\\npragma solidity ^0.8.0;\\n\\n/**\\n * @dev Interface of the ERC20 standard as defined in the EIP.\\n */\\ninterface IERC20 {\\n /**\\n * @dev Emitted when `value` tokens are moved from one account (`from`) to\\n * another (`to`).\\n *\\n * Note that `value` may be zero.\\n */\\n event Transfer(address indexed from, address indexed to, uint256 value);\\n\\n /**\\n * @dev Emitted when the allowance of a `spender` for an `owner` is set by\\n * a call to {approve}. `value` is the new allowance.\\n */\\n event Approval(address indexed owner, address indexed spender, uint256 value);\\n\\n /**\\n * @dev Returns the amount of tokens in existence.\\n */\\n function totalSupply() external view returns (uint256);\\n\\n /**\\n * @dev Returns the amount of tokens owned by `account`.\\n */\\n function balanceOf(address account) external view returns (uint256);\\n\\n /**\\n * @dev Moves `amount` tokens from the caller's account to `to`.\\n *\\n * Returns a boolean value indicating whether the operation succeeded.\\n *\\n * Emits a {Transfer} event.\\n */\\n function transfer(address to, uint256 amount) external returns (bool);\\n\\n /**\\n * @dev Returns the remaining number of tokens that `spender` will be\\n * allowed to spend on behalf of `owner` through {transferFrom}. This is\\n * zero by default.\\n *\\n * This value changes when {approve} or {transferFrom} are called.\\n */\\n function allowance(address owner, address spender) external view returns (uint256);\\n\\n /**\\n * @dev Sets `amount` as the allowance of `spender` over the caller's tokens.\\n *\\n * Returns a boolean value indicating whether the operation succeeded.\\n *\\n * IMPORTANT: Beware that changing an allowance with this method brings the risk\\n * that someone may use both the old and the new allowance by unfortunate\\n * transaction ordering. One possible solution to mitigate this race\\n * condition is to first reduce the spender's allowance to 0 and set the\\n * desired value afterwards:\\n * https://github.com/ethereum/EIPs/issues/20#issuecomment-263524729\\n *\\n * Emits an {Approval} event.\\n */\\n function approve(address spender, uint256 amount) external returns (bool);\\n\\n /**\\n * @dev Moves `amount` tokens from `from` to `to` using the\\n * allowance mechanism. `amount` is then deducted from the caller's\\n * allowance.\\n *\\n * Returns a boolean value indicating whether the operation succeeded.\\n *\\n * Emits a {Transfer} event.\\n */\\n function transferFrom(address from, address to, uint256 amount) external returns (bool);\\n}\\n\",\"keccak256\":\"0x287b55befed2961a7eabd7d7b1b2839cbca8a5b80ef8dcbb25ed3d4c2002c305\",\"license\":\"MIT\"},\"@openzeppelin/contracts/token/ERC20/extensions/IERC20Permit.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v4.9.4) (token/ERC20/extensions/IERC20Permit.sol)\\n\\npragma solidity ^0.8.0;\\n\\n/**\\n * @dev Interface of the ERC20 Permit extension allowing approvals to be made via signatures, as defined in\\n * https://eips.ethereum.org/EIPS/eip-2612[EIP-2612].\\n *\\n * Adds the {permit} method, which can be used to change an account's ERC20 allowance (see {IERC20-allowance}) by\\n * presenting a message signed by the account. By not relying on {IERC20-approve}, the token holder account doesn't\\n * need to send a transaction, and thus is not required to hold Ether at all.\\n *\\n * ==== Security Considerations\\n *\\n * There are two important considerations concerning the use of `permit`. The first is that a valid permit signature\\n * expresses an allowance, and it should not be assumed to convey additional meaning. In particular, it should not be\\n * considered as an intention to spend the allowance in any specific way. The second is that because permits have\\n * built-in replay protection and can be submitted by anyone, they can be frontrun. A protocol that uses permits should\\n * take this into consideration and allow a `permit` call to fail. Combining these two aspects, a pattern that may be\\n * generally recommended is:\\n *\\n * ```solidity\\n * function doThingWithPermit(..., uint256 value, uint256 deadline, uint8 v, bytes32 r, bytes32 s) public {\\n * try token.permit(msg.sender, address(this), value, deadline, v, r, s) {} catch {}\\n * doThing(..., value);\\n * }\\n *\\n * function doThing(..., uint256 value) public {\\n * token.safeTransferFrom(msg.sender, address(this), value);\\n * ...\\n * }\\n * ```\\n *\\n * Observe that: 1) `msg.sender` is used as the owner, leaving no ambiguity as to the signer intent, and 2) the use of\\n * `try/catch` allows the permit to fail and makes the code tolerant to frontrunning. (See also\\n * {SafeERC20-safeTransferFrom}).\\n *\\n * Additionally, note that smart contract wallets (such as Argent or Safe) are not able to produce permit signatures, so\\n * contracts should have entry points that don't rely on permit.\\n */\\ninterface IERC20Permit {\\n /**\\n * @dev Sets `value` as the allowance of `spender` over ``owner``'s tokens,\\n * given ``owner``'s signed approval.\\n *\\n * IMPORTANT: The same issues {IERC20-approve} has related to transaction\\n * ordering also apply here.\\n *\\n * Emits an {Approval} event.\\n *\\n * Requirements:\\n *\\n * - `spender` cannot be the zero address.\\n * - `deadline` must be a timestamp in the future.\\n * - `v`, `r` and `s` must be a valid `secp256k1` signature from `owner`\\n * over the EIP712-formatted function arguments.\\n * - the signature must use ``owner``'s current nonce (see {nonces}).\\n *\\n * For more information on the signature format, see the\\n * https://eips.ethereum.org/EIPS/eip-2612#specification[relevant EIP\\n * section].\\n *\\n * CAUTION: See Security Considerations above.\\n */\\n function permit(\\n address owner,\\n address spender,\\n uint256 value,\\n uint256 deadline,\\n uint8 v,\\n bytes32 r,\\n bytes32 s\\n ) external;\\n\\n /**\\n * @dev Returns the current nonce for `owner`. This value must be\\n * included whenever a signature is generated for {permit}.\\n *\\n * Every successful call to {permit} increases ``owner``'s nonce by one. This\\n * prevents a signature from being used multiple times.\\n */\\n function nonces(address owner) external view returns (uint256);\\n\\n /**\\n * @dev Returns the domain separator used in the encoding of the signature for {permit}, as defined by {EIP712}.\\n */\\n // solhint-disable-next-line func-name-mixedcase\\n function DOMAIN_SEPARATOR() external view returns (bytes32);\\n}\\n\",\"keccak256\":\"0xb264c03a3442eb37a68ad620cefd1182766b58bee6cec40343480392d6b14d69\",\"license\":\"MIT\"},\"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v4.9.3) (token/ERC20/utils/SafeERC20.sol)\\n\\npragma solidity ^0.8.0;\\n\\nimport \\\"../IERC20.sol\\\";\\nimport \\\"../extensions/IERC20Permit.sol\\\";\\nimport \\\"../../../utils/Address.sol\\\";\\n\\n/**\\n * @title SafeERC20\\n * @dev Wrappers around ERC20 operations that throw on failure (when the token\\n * contract returns false). Tokens that return no value (and instead revert or\\n * throw on failure) are also supported, non-reverting calls are assumed to be\\n * successful.\\n * To use this library you can add a `using SafeERC20 for IERC20;` statement to your contract,\\n * which allows you to call the safe operations as `token.safeTransfer(...)`, etc.\\n */\\nlibrary SafeERC20 {\\n using Address for address;\\n\\n /**\\n * @dev Transfer `value` amount of `token` from the calling contract to `to`. If `token` returns no value,\\n * non-reverting calls are assumed to be successful.\\n */\\n function safeTransfer(IERC20 token, address to, uint256 value) internal {\\n _callOptionalReturn(token, abi.encodeWithSelector(token.transfer.selector, to, value));\\n }\\n\\n /**\\n * @dev Transfer `value` amount of `token` from `from` to `to`, spending the approval given by `from` to the\\n * calling contract. If `token` returns no value, non-reverting calls are assumed to be successful.\\n */\\n function safeTransferFrom(IERC20 token, address from, address to, uint256 value) internal {\\n _callOptionalReturn(token, abi.encodeWithSelector(token.transferFrom.selector, from, to, value));\\n }\\n\\n /**\\n * @dev Deprecated. This function has issues similar to the ones found in\\n * {IERC20-approve}, and its usage is discouraged.\\n *\\n * Whenever possible, use {safeIncreaseAllowance} and\\n * {safeDecreaseAllowance} instead.\\n */\\n function safeApprove(IERC20 token, address spender, uint256 value) internal {\\n // safeApprove should only be called when setting an initial allowance,\\n // or when resetting it to zero. To increase and decrease it, use\\n // 'safeIncreaseAllowance' and 'safeDecreaseAllowance'\\n require(\\n (value == 0) || (token.allowance(address(this), spender) == 0),\\n \\\"SafeERC20: approve from non-zero to non-zero allowance\\\"\\n );\\n _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, value));\\n }\\n\\n /**\\n * @dev Increase the calling contract's allowance toward `spender` by `value`. If `token` returns no value,\\n * non-reverting calls are assumed to be successful.\\n */\\n function safeIncreaseAllowance(IERC20 token, address spender, uint256 value) internal {\\n uint256 oldAllowance = token.allowance(address(this), spender);\\n _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, oldAllowance + value));\\n }\\n\\n /**\\n * @dev Decrease the calling contract's allowance toward `spender` by `value`. If `token` returns no value,\\n * non-reverting calls are assumed to be successful.\\n */\\n function safeDecreaseAllowance(IERC20 token, address spender, uint256 value) internal {\\n unchecked {\\n uint256 oldAllowance = token.allowance(address(this), spender);\\n require(oldAllowance >= value, \\\"SafeERC20: decreased allowance below zero\\\");\\n _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, oldAllowance - value));\\n }\\n }\\n\\n /**\\n * @dev Set the calling contract's allowance toward `spender` to `value`. If `token` returns no value,\\n * non-reverting calls are assumed to be successful. Meant to be used with tokens that require the approval\\n * to be set to zero before setting it to a non-zero value, such as USDT.\\n */\\n function forceApprove(IERC20 token, address spender, uint256 value) internal {\\n bytes memory approvalCall = abi.encodeWithSelector(token.approve.selector, spender, value);\\n\\n if (!_callOptionalReturnBool(token, approvalCall)) {\\n _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, 0));\\n _callOptionalReturn(token, approvalCall);\\n }\\n }\\n\\n /**\\n * @dev Use a ERC-2612 signature to set the `owner` approval toward `spender` on `token`.\\n * Revert on invalid signature.\\n */\\n function safePermit(\\n IERC20Permit token,\\n address owner,\\n address spender,\\n uint256 value,\\n uint256 deadline,\\n uint8 v,\\n bytes32 r,\\n bytes32 s\\n ) internal {\\n uint256 nonceBefore = token.nonces(owner);\\n token.permit(owner, spender, value, deadline, v, r, s);\\n uint256 nonceAfter = token.nonces(owner);\\n require(nonceAfter == nonceBefore + 1, \\\"SafeERC20: permit did not succeed\\\");\\n }\\n\\n /**\\n * @dev Imitates a Solidity high-level call (i.e. a regular function call to a contract), relaxing the requirement\\n * on the return value: the return value is optional (but if data is returned, it must not be false).\\n * @param token The token targeted by the call.\\n * @param data The call data (encoded using abi.encode or one of its variants).\\n */\\n function _callOptionalReturn(IERC20 token, bytes memory data) private {\\n // We need to perform a low level call here, to bypass Solidity's return data size checking mechanism, since\\n // we're implementing it ourselves. We use {Address-functionCall} to perform this call, which verifies that\\n // the target address contains contract code and also asserts for success in the low-level call.\\n\\n bytes memory returndata = address(token).functionCall(data, \\\"SafeERC20: low-level call failed\\\");\\n require(returndata.length == 0 || abi.decode(returndata, (bool)), \\\"SafeERC20: ERC20 operation did not succeed\\\");\\n }\\n\\n /**\\n * @dev Imitates a Solidity high-level call (i.e. a regular function call to a contract), relaxing the requirement\\n * on the return value: the return value is optional (but if data is returned, it must not be false).\\n * @param token The token targeted by the call.\\n * @param data The call data (encoded using abi.encode or one of its variants).\\n *\\n * This is a variant of {_callOptionalReturn} that silents catches all reverts and returns a bool instead.\\n */\\n function _callOptionalReturnBool(IERC20 token, bytes memory data) private returns (bool) {\\n // We need to perform a low level call here, to bypass Solidity's return data size checking mechanism, since\\n // we're implementing it ourselves. We cannot use {Address-functionCall} here since this should return false\\n // and not revert is the subcall reverts.\\n\\n (bool success, bytes memory returndata) = address(token).call(data);\\n return\\n success && (returndata.length == 0 || abi.decode(returndata, (bool))) && Address.isContract(address(token));\\n }\\n}\\n\",\"keccak256\":\"0xabefac93435967b4d36a4fabcbdbb918d1f0b7ae3c3d85bc30923b326c927ed1\",\"license\":\"MIT\"},\"@openzeppelin/contracts/utils/Address.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v4.9.0) (utils/Address.sol)\\n\\npragma solidity ^0.8.1;\\n\\n/**\\n * @dev Collection of functions related to the address type\\n */\\nlibrary Address {\\n /**\\n * @dev Returns true if `account` is a contract.\\n *\\n * [IMPORTANT]\\n * ====\\n * It is unsafe to assume that an address for which this function returns\\n * false is an externally-owned account (EOA) and not a contract.\\n *\\n * Among others, `isContract` will return false for the following\\n * types of addresses:\\n *\\n * - an externally-owned account\\n * - a contract in construction\\n * - an address where a contract will be created\\n * - an address where a contract lived, but was destroyed\\n *\\n * Furthermore, `isContract` will also return true if the target contract within\\n * the same transaction is already scheduled for destruction by `SELFDESTRUCT`,\\n * which only has an effect at the end of a transaction.\\n * ====\\n *\\n * [IMPORTANT]\\n * ====\\n * You shouldn't rely on `isContract` to protect against flash loan attacks!\\n *\\n * Preventing calls from contracts is highly discouraged. It breaks composability, breaks support for smart wallets\\n * like Gnosis Safe, and does not provide security since it can be circumvented by calling from a contract\\n * constructor.\\n * ====\\n */\\n function isContract(address account) internal view returns (bool) {\\n // This method relies on extcodesize/address.code.length, which returns 0\\n // for contracts in construction, since the code is only stored at the end\\n // of the constructor execution.\\n\\n return account.code.length > 0;\\n }\\n\\n /**\\n * @dev Replacement for Solidity's `transfer`: sends `amount` wei to\\n * `recipient`, forwarding all available gas and reverting on errors.\\n *\\n * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost\\n * of certain opcodes, possibly making contracts go over the 2300 gas limit\\n * imposed by `transfer`, making them unable to receive funds via\\n * `transfer`. {sendValue} removes this limitation.\\n *\\n * https://consensys.net/diligence/blog/2019/09/stop-using-soliditys-transfer-now/[Learn more].\\n *\\n * IMPORTANT: because control is transferred to `recipient`, care must be\\n * taken to not create reentrancy vulnerabilities. Consider using\\n * {ReentrancyGuard} or the\\n * https://solidity.readthedocs.io/en/v0.8.0/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].\\n */\\n function sendValue(address payable recipient, uint256 amount) internal {\\n require(address(this).balance >= amount, \\\"Address: insufficient balance\\\");\\n\\n (bool success, ) = recipient.call{value: amount}(\\\"\\\");\\n require(success, \\\"Address: unable to send value, recipient may have reverted\\\");\\n }\\n\\n /**\\n * @dev Performs a Solidity function call using a low level `call`. A\\n * plain `call` is an unsafe replacement for a function call: use this\\n * function instead.\\n *\\n * If `target` reverts with a revert reason, it is bubbled up by this\\n * function (like regular Solidity function calls).\\n *\\n * Returns the raw returned data. To convert to the expected return value,\\n * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].\\n *\\n * Requirements:\\n *\\n * - `target` must be a contract.\\n * - calling `target` with `data` must not revert.\\n *\\n * _Available since v3.1._\\n */\\n function functionCall(address target, bytes memory data) internal returns (bytes memory) {\\n return functionCallWithValue(target, data, 0, \\\"Address: low-level call failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with\\n * `errorMessage` as a fallback revert reason when `target` reverts.\\n *\\n * _Available since v3.1._\\n */\\n function functionCall(\\n address target,\\n bytes memory data,\\n string memory errorMessage\\n ) internal returns (bytes memory) {\\n return functionCallWithValue(target, data, 0, errorMessage);\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\\n * but also transferring `value` wei to `target`.\\n *\\n * Requirements:\\n *\\n * - the calling contract must have an ETH balance of at least `value`.\\n * - the called Solidity function must be `payable`.\\n *\\n * _Available since v3.1._\\n */\\n function functionCallWithValue(address target, bytes memory data, uint256 value) internal returns (bytes memory) {\\n return functionCallWithValue(target, data, value, \\\"Address: low-level call with value failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but\\n * with `errorMessage` as a fallback revert reason when `target` reverts.\\n *\\n * _Available since v3.1._\\n */\\n function functionCallWithValue(\\n address target,\\n bytes memory data,\\n uint256 value,\\n string memory errorMessage\\n ) internal returns (bytes memory) {\\n require(address(this).balance >= value, \\\"Address: insufficient balance for call\\\");\\n (bool success, bytes memory returndata) = target.call{value: value}(data);\\n return verifyCallResultFromTarget(target, success, returndata, errorMessage);\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\\n * but performing a static call.\\n *\\n * _Available since v3.3._\\n */\\n function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {\\n return functionStaticCall(target, data, \\\"Address: low-level static call failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],\\n * but performing a static call.\\n *\\n * _Available since v3.3._\\n */\\n function functionStaticCall(\\n address target,\\n bytes memory data,\\n string memory errorMessage\\n ) internal view returns (bytes memory) {\\n (bool success, bytes memory returndata) = target.staticcall(data);\\n return verifyCallResultFromTarget(target, success, returndata, errorMessage);\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\\n * but performing a delegate call.\\n *\\n * _Available since v3.4._\\n */\\n function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) {\\n return functionDelegateCall(target, data, \\\"Address: low-level delegate call failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],\\n * but performing a delegate call.\\n *\\n * _Available since v3.4._\\n */\\n function functionDelegateCall(\\n address target,\\n bytes memory data,\\n string memory errorMessage\\n ) internal returns (bytes memory) {\\n (bool success, bytes memory returndata) = target.delegatecall(data);\\n return verifyCallResultFromTarget(target, success, returndata, errorMessage);\\n }\\n\\n /**\\n * @dev Tool to verify that a low level call to smart-contract was successful, and revert (either by bubbling\\n * the revert reason or using the provided one) in case of unsuccessful call or if target was not a contract.\\n *\\n * _Available since v4.8._\\n */\\n function verifyCallResultFromTarget(\\n address target,\\n bool success,\\n bytes memory returndata,\\n string memory errorMessage\\n ) internal view returns (bytes memory) {\\n if (success) {\\n if (returndata.length == 0) {\\n // only check isContract if the call was successful and the return data is empty\\n // otherwise we already know that it was a contract\\n require(isContract(target), \\\"Address: call to non-contract\\\");\\n }\\n return returndata;\\n } else {\\n _revert(returndata, errorMessage);\\n }\\n }\\n\\n /**\\n * @dev Tool to verify that a low level call was successful, and revert if it wasn't, either by bubbling the\\n * revert reason or using the provided one.\\n *\\n * _Available since v4.3._\\n */\\n function verifyCallResult(\\n bool success,\\n bytes memory returndata,\\n string memory errorMessage\\n ) internal pure returns (bytes memory) {\\n if (success) {\\n return returndata;\\n } else {\\n _revert(returndata, errorMessage);\\n }\\n }\\n\\n function _revert(bytes memory returndata, string memory errorMessage) private pure {\\n // Look for revert reason and bubble it up if present\\n if (returndata.length > 0) {\\n // The easiest way to bubble the revert reason is using memory via assembly\\n /// @solidity memory-safe-assembly\\n assembly {\\n let returndata_size := mload(returndata)\\n revert(add(32, returndata), returndata_size)\\n }\\n } else {\\n revert(errorMessage);\\n }\\n }\\n}\\n\",\"keccak256\":\"0x006dd67219697fe68d7fbfdea512e7c4cb64a43565ed86171d67e844982da6fa\",\"license\":\"MIT\"},\"contracts/chain-adapters/CrossDomainEnabled.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity ^0.8.0;\\n\\n/* Interface Imports */\\nimport { ICrossDomainMessenger } from \\\"@eth-optimism/contracts/libraries/bridge/ICrossDomainMessenger.sol\\\";\\n\\n/**\\n * @title CrossDomainEnabled\\n * @custom:security-contact bugs@across.to\\n * @dev Helper contract for contracts performing cross-domain communications between L1 and Optimism.\\n * @dev This modifies the eth-optimism/CrossDomainEnabled contract only by changing state variables to be\\n * immutable for use in contracts like the Optimism_Adapter which use delegateCall().\\n */\\ncontract CrossDomainEnabled {\\n // Messenger contract used to send and recieve messages from the other domain.\\n address public immutable MESSENGER;\\n\\n /**\\n * @param _messenger Address of the CrossDomainMessenger on the current layer.\\n */\\n constructor(address _messenger) {\\n MESSENGER = _messenger;\\n }\\n\\n /**\\n * Gets the messenger, usually from storage. This function is exposed in case a child contract\\n * needs to override.\\n * @return The address of the cross-domain messenger contract which should be used.\\n */\\n function getCrossDomainMessenger() internal virtual returns (ICrossDomainMessenger) {\\n return ICrossDomainMessenger(MESSENGER);\\n }\\n\\n /**\\n * Sends a message to an account on another domain\\n * @param _crossDomainTarget The intended recipient on the destination domain\\n * @param _gasLimit The gasLimit for the receipt of the message on the target domain.\\n * @param _message The data to send to the target (usually calldata to a function with\\n * onlyFromCrossDomainAccount())\\n */\\n function sendCrossDomainMessage(\\n address _crossDomainTarget,\\n uint32 _gasLimit,\\n bytes calldata _message\\n ) internal {\\n // slither-disable-next-line reentrancy-events, reentrancy-benign\\n getCrossDomainMessenger().sendMessage(_crossDomainTarget, _message, _gasLimit);\\n }\\n}\\n\",\"keccak256\":\"0xb4705bab7468a6a7a6f3c635df73ca18215d5c78986dd336ab500fd75c63789f\",\"license\":\"MIT\"},\"contracts/chain-adapters/WorldChain_Adapter.sol\":{\"content\":\"// SPDX-License-Identifier: BUSL-1.1\\npragma solidity ^0.8.0;\\n\\nimport \\\"./interfaces/AdapterInterface.sol\\\";\\nimport \\\"../external/interfaces/WETH9Interface.sol\\\";\\n\\n// @dev Use local modified CrossDomainEnabled contract instead of one exported by eth-optimism because we need\\n// this contract's state variables to be `immutable` because of the delegateCall call.\\nimport \\\"./CrossDomainEnabled.sol\\\";\\nimport \\\"@eth-optimism/contracts/L1/messaging/IL1StandardBridge.sol\\\";\\n\\nimport \\\"@openzeppelin/contracts/token/ERC20/IERC20.sol\\\";\\nimport \\\"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\\\";\\n\\nimport \\\"../libraries/CircleCCTPAdapter.sol\\\";\\nimport \\\"../external/interfaces/CCTPInterfaces.sol\\\";\\n\\n/**\\n * @notice Contract containing logic to send messages from L1 to Doctor Who. This is a modified version of the Optimism adapter\\n * that excludes the custom bridging logic.\\n * @custom:security-contact bugs@across.to\\n * @dev Public functions calling external contracts do not guard against reentrancy because they are expected to be\\n * called via delegatecall, which will execute this contract's logic within the context of the originating contract.\\n * For example, the HubPool will delegatecall these functions, therefore its only necessary that the HubPool's methods\\n * that call this contract's logic guard against reentrancy.\\n */\\n\\n// solhint-disable-next-line contract-name-camelcase\\ncontract WorldChain_Adapter is CrossDomainEnabled, AdapterInterface, CircleCCTPAdapter {\\n using SafeERC20 for IERC20;\\n uint32 public constant L2_GAS_LIMIT = 200_000;\\n\\n WETH9Interface public immutable L1_WETH;\\n\\n IL1StandardBridge public immutable L1_STANDARD_BRIDGE;\\n\\n /**\\n * @notice Constructs new Adapter.\\n * @param _l1Weth WETH address on L1.\\n * @param _crossDomainMessenger XDomainMessenger Doctor Who system contract.\\n * @param _l1StandardBridge Standard bridge contract.\\n * @param _l1Usdc USDC address on L1.\\n * @param _cctpTokenMessenger TokenMessenger contract to bridge via CCTP.\\n */\\n constructor(\\n WETH9Interface _l1Weth,\\n address _crossDomainMessenger,\\n IL1StandardBridge _l1StandardBridge,\\n IERC20 _l1Usdc,\\n ITokenMessenger _cctpTokenMessenger\\n )\\n CrossDomainEnabled(_crossDomainMessenger)\\n CircleCCTPAdapter(_l1Usdc, _cctpTokenMessenger, CircleDomainIds.WorldChain)\\n {\\n L1_WETH = _l1Weth;\\n L1_STANDARD_BRIDGE = _l1StandardBridge;\\n }\\n\\n /**\\n * @notice Send cross-chain message to target on Doctor Who.\\n * @param target Contract on Doctor Who that will receive message.\\n * @param message Data to send to target.\\n */\\n function relayMessage(address target, bytes calldata message) external payable override {\\n sendCrossDomainMessage(target, L2_GAS_LIMIT, message);\\n emit MessageRelayed(target, message);\\n }\\n\\n /**\\n * @notice Bridge tokens to Doctor Who.\\n * @param l1Token L1 token to deposit.\\n * @param l2Token L2 token to receive.\\n * @param amount Amount of L1 tokens to deposit and L2 tokens to receive.\\n * @param to Bridge recipient.\\n */\\n function relayTokens(\\n address l1Token,\\n address l2Token,\\n uint256 amount,\\n address to\\n ) external payable override {\\n // If the l1Token is weth then unwrap it to ETH then send the ETH to the standard bridge.\\n if (l1Token == address(L1_WETH)) {\\n L1_WETH.withdraw(amount);\\n L1_STANDARD_BRIDGE.depositETHTo{ value: amount }(to, L2_GAS_LIMIT, \\\"\\\");\\n }\\n // Check if this token is USDC, which requires a custom bridge via CCTP.\\n else if (_isCCTPEnabled() && l1Token == address(usdcToken)) {\\n _transferUsdc(to, amount);\\n } else {\\n IL1StandardBridge _l1StandardBridge = L1_STANDARD_BRIDGE;\\n\\n IERC20(l1Token).safeIncreaseAllowance(address(_l1StandardBridge), amount);\\n _l1StandardBridge.depositERC20To(l1Token, l2Token, to, amount, L2_GAS_LIMIT, \\\"\\\");\\n }\\n emit TokensRelayed(l1Token, l2Token, amount, to);\\n }\\n}\\n\",\"keccak256\":\"0xb540e0410bbd00db5eca3e51d5af22cbeaeaca88dfc18da8e1667c2c5ee4e12d\",\"license\":\"BUSL-1.1\"},\"contracts/chain-adapters/interfaces/AdapterInterface.sol\":{\"content\":\"// SPDX-License-Identifier: BUSL-1.1\\npragma solidity ^0.8.0;\\n\\n/**\\n * @notice Sends cross chain messages and tokens to contracts on a specific L2 network.\\n * This interface is implemented by an adapter contract that is deployed on L1.\\n */\\n\\ninterface AdapterInterface {\\n event MessageRelayed(address target, bytes message);\\n\\n event TokensRelayed(address l1Token, address l2Token, uint256 amount, address to);\\n\\n /**\\n * @notice Send message to `target` on L2.\\n * @dev This method is marked payable because relaying the message might require a fee\\n * to be paid by the sender to forward the message to L2. However, it will not send msg.value\\n * to the target contract on L2.\\n * @param target L2 address to send message to.\\n * @param message Message to send to `target`.\\n */\\n function relayMessage(address target, bytes calldata message) external payable;\\n\\n /**\\n * @notice Send `amount` of `l1Token` to `to` on L2. `l2Token` is the L2 address equivalent of `l1Token`.\\n * @dev This method is marked payable because relaying the message might require a fee\\n * to be paid by the sender to forward the message to L2. However, it will not send msg.value\\n * to the target contract on L2.\\n * @param l1Token L1 token to bridge.\\n * @param l2Token L2 token to receive.\\n * @param amount Amount of `l1Token` to bridge.\\n * @param to Bridge recipient.\\n */\\n function relayTokens(\\n address l1Token,\\n address l2Token,\\n uint256 amount,\\n address to\\n ) external payable;\\n}\\n\",\"keccak256\":\"0x1d52fcb8b10dc7f260345918c1a90d496a4c9f774402cbd5ebde881b8fed6d50\",\"license\":\"BUSL-1.1\"},\"contracts/external/interfaces/CCTPInterfaces.sol\":{\"content\":\"/**\\n * Copyright (C) 2015, 2016, 2017 Dapphub\\n *\\n * This program is free software: you can redistribute it and/or modify\\n * it under the terms of the GNU General Public License as published by\\n * the Free Software Foundation, either version 3 of the License, or\\n * (at your option) any later version.\\n *\\n * This program is distributed in the hope that it will be useful,\\n * but WITHOUT ANY WARRANTY; without even the implied warranty of\\n * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the\\n * GNU General Public License for more details.\\n *\\n * You should have received a copy of the GNU General Public License\\n * along with this program. If not, see .\\n */\\n\\n// SPDX-License-Identifier: GPL-3.0-or-later\\npragma solidity ^0.8.0;\\n\\n/**\\n * Imported as-is from commit 139d8d0ce3b5531d3c7ec284f89d946dfb720016 of:\\n * * https://github.com/walkerq/evm-cctp-contracts/blob/139d8d0ce3b5531d3c7ec284f89d946dfb720016/src/TokenMessenger.sol\\n * Changes applied post-import:\\n * * Removed a majority of code from this contract and converted the needed function signatures in this interface.\\n */\\ninterface ITokenMessenger {\\n /**\\n * @notice Deposits and burns tokens from sender to be minted on destination domain.\\n * Emits a `DepositForBurn` event.\\n * @dev reverts if:\\n * - given burnToken is not supported\\n * - given destinationDomain has no TokenMessenger registered\\n * - transferFrom() reverts. For example, if sender's burnToken balance or approved allowance\\n * to this contract is less than `amount`.\\n * - burn() reverts. For example, if `amount` is 0.\\n * - MessageTransmitter returns false or reverts.\\n * @param amount amount of tokens to burn\\n * @param destinationDomain destination domain\\n * @param mintRecipient address of mint recipient on destination domain\\n * @param burnToken address of contract to burn deposited tokens, on local domain\\n * @return _nonce unique nonce reserved by message\\n */\\n function depositForBurn(\\n uint256 amount,\\n uint32 destinationDomain,\\n bytes32 mintRecipient,\\n address burnToken\\n ) external returns (uint64 _nonce);\\n\\n /**\\n * @notice Minter responsible for minting and burning tokens on the local domain\\n * @dev A TokenMessenger stores a TokenMinter contract which extends the TokenController contract.\\n * https://github.com/circlefin/evm-cctp-contracts/blob/817397db0a12963accc08ff86065491577bbc0e5/src/TokenMessenger.sol#L110\\n * @return minter Token Minter contract.\\n */\\n function localMinter() external view returns (ITokenMinter minter);\\n}\\n\\n// Source: https://github.com/circlefin/evm-cctp-contracts/blob/63ab1f0ac06ce0793c0bbfbb8d09816bc211386d/src/v2/TokenMessengerV2.sol#L138C1-L166C15\\ninterface ITokenMessengerV2 {\\n /**\\n * @notice Deposits and burns tokens from sender to be minted on destination domain.\\n * Emits a `DepositForBurn` event.\\n * @dev reverts if:\\n * - given burnToken is not supported\\n * - given destinationDomain has no TokenMessenger registered\\n * - transferFrom() reverts. For example, if sender's burnToken balance or approved allowance\\n * to this contract is less than `amount`.\\n * - burn() reverts. For example, if `amount` is 0.\\n * - maxFee is greater than or equal to `amount`.\\n * - MessageTransmitterV2#sendMessage reverts.\\n * @param amount amount of tokens to burn\\n * @param destinationDomain destination domain to receive message on\\n * @param mintRecipient address of mint recipient on destination domain\\n * @param burnToken token to burn `amount` of, on local domain\\n * @param destinationCaller authorized caller on the destination domain, as bytes32. If equal to bytes32(0),\\n * any address can broadcast the message.\\n * @param maxFee maximum fee to pay on the destination domain, specified in units of burnToken\\n * @param minFinalityThreshold the minimum finality at which a burn message will be attested to.\\n */\\n function depositForBurn(\\n uint256 amount,\\n uint32 destinationDomain,\\n bytes32 mintRecipient,\\n address burnToken,\\n bytes32 destinationCaller,\\n uint256 maxFee,\\n uint32 minFinalityThreshold\\n ) external;\\n}\\n\\n/**\\n * A TokenMessenger stores a TokenMinter contract which extends the TokenController contract. The TokenController\\n * contract has a burnLimitsPerMessage public mapping which can be queried to find the per-message burn limit\\n * for a given token:\\n * https://github.com/circlefin/evm-cctp-contracts/blob/817397db0a12963accc08ff86065491577bbc0e5/src/TokenMinter.sol#L33\\n * https://github.com/circlefin/evm-cctp-contracts/blob/817397db0a12963accc08ff86065491577bbc0e5/src/roles/TokenController.sol#L69C40-L69C60\\n *\\n */\\ninterface ITokenMinter {\\n /**\\n * @notice Supported burnable tokens on the local domain\\n * local token (address) => maximum burn amounts per message\\n * @param token address of token contract\\n * @return burnLimit maximum burn amount per message for token\\n */\\n function burnLimitsPerMessage(address token) external view returns (uint256);\\n}\\n\\n/**\\n * IMessageTransmitter in CCTP inherits IRelayer and IReceiver, but here we only import sendMessage from IRelayer:\\n * https://github.com/circlefin/evm-cctp-contracts/blob/377c9bd813fb86a42d900ae4003599d82aef635a/src/interfaces/IMessageTransmitter.sol#L25\\n * https://github.com/circlefin/evm-cctp-contracts/blob/377c9bd813fb86a42d900ae4003599d82aef635a/src/interfaces/IRelayer.sol#L23-L35\\n */\\ninterface IMessageTransmitter {\\n /**\\n * @notice Sends an outgoing message from the source domain.\\n * @dev Increment nonce, format the message, and emit `MessageSent` event with message information.\\n * @param destinationDomain Domain of destination chain\\n * @param recipient Address of message recipient on destination domain as bytes32\\n * @param messageBody Raw bytes content of message\\n * @return nonce reserved by message\\n */\\n function sendMessage(\\n uint32 destinationDomain,\\n bytes32 recipient,\\n bytes calldata messageBody\\n ) external returns (uint64);\\n}\\n\",\"keccak256\":\"0x69059bd91cdb9bea59242c543a167e38a9f3a7788687d4194f68420a956c7608\",\"license\":\"GPL-3.0-or-later\"},\"contracts/external/interfaces/WETH9Interface.sol\":{\"content\":\"// SPDX-License-Identifier: BUSL-1.1\\npragma solidity ^0.8.0;\\n\\n/**\\n * @notice Interface for the WETH9 contract.\\n */\\ninterface WETH9Interface {\\n /**\\n * @notice Burn Wrapped Ether and receive native Ether.\\n * @param wad Amount of WETH to unwrap and send to caller.\\n */\\n function withdraw(uint256 wad) external;\\n\\n /**\\n * @notice Lock native Ether and mint Wrapped Ether ERC20\\n * @dev msg.value is amount of Wrapped Ether to mint/Ether to lock.\\n */\\n function deposit() external payable;\\n\\n /**\\n * @notice Get balance of WETH held by `guy`.\\n * @param guy Address to get balance of.\\n * @return wad Amount of WETH held by `guy`.\\n */\\n function balanceOf(address guy) external view returns (uint256 wad);\\n\\n /**\\n * @notice Transfer `wad` of WETH from caller to `guy`.\\n * @param guy Address to send WETH to.\\n * @param wad Amount of WETH to send.\\n * @return ok True if transfer succeeded.\\n */\\n function transfer(address guy, uint256 wad) external returns (bool);\\n}\\n\",\"keccak256\":\"0x3f7892554ec7f54681fdd3cc18a41346c246c9c1afba016c52990ef77741f718\",\"license\":\"BUSL-1.1\"},\"contracts/libraries/AddressConverters.sol\":{\"content\":\"// SPDX-License-Identifier: BUSL-1.1\\npragma solidity ^0.8.0;\\n\\nlibrary Bytes32ToAddress {\\n /**************************************\\n * ERRORS *\\n **************************************/\\n error InvalidBytes32();\\n\\n function toAddress(bytes32 _bytes32) internal pure returns (address) {\\n checkAddress(_bytes32);\\n return address(uint160(uint256(_bytes32)));\\n }\\n\\n function toAddressUnchecked(bytes32 _bytes32) internal pure returns (address) {\\n return address(uint160(uint256(_bytes32)));\\n }\\n\\n function checkAddress(bytes32 _bytes32) internal pure {\\n if (uint256(_bytes32) >> 160 != 0) {\\n revert InvalidBytes32();\\n }\\n }\\n}\\n\\nlibrary AddressToBytes32 {\\n function toBytes32(address _address) internal pure returns (bytes32) {\\n return bytes32(uint256(uint160(_address)));\\n }\\n}\\n\",\"keccak256\":\"0x378f28bb4a17a5c47457cb9341086b2140f7faf6c048f702d3528166f0d74453\",\"license\":\"BUSL-1.1\"},\"contracts/libraries/CircleCCTPAdapter.sol\":{\"content\":\"// SPDX-License-Identifier: BUSL-1.1\\npragma solidity ^0.8.0;\\n\\nimport \\\"@openzeppelin/contracts/token/ERC20/IERC20.sol\\\";\\nimport \\\"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\\\";\\nimport \\\"../external/interfaces/CCTPInterfaces.sol\\\";\\nimport { AddressToBytes32 } from \\\"../libraries/AddressConverters.sol\\\";\\n\\nlibrary CircleDomainIds {\\n uint32 public constant Ethereum = 0;\\n uint32 public constant Optimism = 2;\\n uint32 public constant Arbitrum = 3;\\n uint32 public constant Solana = 5;\\n uint32 public constant Base = 6;\\n uint32 public constant Polygon = 7;\\n uint32 public constant DoctorWho = 10;\\n uint32 public constant Linea = 11;\\n uint32 public constant WorldChain = 14;\\n uint32 public constant UNINITIALIZED = type(uint32).max;\\n}\\n\\n/**\\n * @notice Facilitate bridging USDC via Circle's CCTP.\\n * @dev This contract is intended to be inherited by other chain-specific adapters and spoke pools.\\n * @custom:security-contact bugs@across.to\\n */\\nabstract contract CircleCCTPAdapter {\\n using SafeERC20 for IERC20;\\n using AddressToBytes32 for address;\\n /**\\n * @notice The domain ID that CCTP will transfer funds to.\\n * @dev This identifier is assigned by Circle and is not related to a chain ID.\\n * @dev Official domain list can be found here: https://developers.circle.com/stablecoins/docs/supported-domains\\n */\\n /// @custom:oz-upgrades-unsafe-allow state-variable-immutable\\n\\n uint32 public immutable recipientCircleDomainId;\\n\\n /**\\n * @notice The official USDC contract address on this chain.\\n * @dev Posted officially here: https://developers.circle.com/stablecoins/docs/usdc-on-main-networks\\n */\\n /// @custom:oz-upgrades-unsafe-allow state-variable-immutable\\n IERC20 public immutable usdcToken;\\n\\n /**\\n * @notice The official Circle CCTP token bridge contract endpoint.\\n * @dev Posted officially here: https://developers.circle.com/stablecoins/docs/evm-smart-contracts\\n */\\n /// @custom:oz-upgrades-unsafe-allow state-variable-immutable\\n ITokenMessenger public immutable cctpTokenMessenger;\\n\\n /**\\n * @notice Indicates if the CCTP V2 TokenMessenger is being used.\\n * @dev This is determined by checking if the feeRecipient() function exists and returns a non-zero address.\\n */\\n /// @custom:oz-upgrades-unsafe-allow state-variable-immutable\\n bool public immutable cctpV2;\\n\\n /**\\n * @notice intiailizes the CircleCCTPAdapter contract.\\n * @param _usdcToken USDC address on the current chain.\\n * @param _cctpTokenMessenger TokenMessenger contract to bridge via CCTP. If the zero address is passed, CCTP bridging will be disabled.\\n * @param _recipientCircleDomainId The domain ID that CCTP will transfer funds to.\\n */\\n /// @custom:oz-upgrades-unsafe-allow constructor\\n constructor(\\n IERC20 _usdcToken,\\n /// @dev This should ideally be an address but it's kept as an ITokenMessenger to avoid rippling changes to the\\n /// constructors for every SpokePool/Adapter.\\n ITokenMessenger _cctpTokenMessenger,\\n uint32 _recipientCircleDomainId\\n ) {\\n usdcToken = _usdcToken;\\n cctpTokenMessenger = _cctpTokenMessenger;\\n recipientCircleDomainId = _recipientCircleDomainId;\\n\\n // Only the CCTP V2 TokenMessenger has a feeRecipient() function, so we use it to\\n // figure out if we are using CCTP V2 or V1. `success` can be true even if the contract doesn't\\n // implement feeRecipient but it has a fallback function so to be extra safe, we check the return value\\n // of feeRecipient() as well.\\n (bool success, bytes memory feeRecipient) = address(cctpTokenMessenger).staticcall(\\n abi.encodeWithSignature(\\\"feeRecipient()\\\")\\n );\\n // In case of a call to nonexistent contract or a call to a contract with a fallback function which\\n // doesn't return any data, feeRecipient can be empty so check its length.\\n // Even with this check, it's possible that the contract has implemented a fallback function that returns\\n // 32 bytes of data but its not actually the feeRecipient address. This is extremely low risk but worth\\n // mentioning that the following check is not 100% safe.\\n cctpV2 = (success &&\\n feeRecipient.length == 32 &&\\n address(uint160(uint256(bytes32(feeRecipient)))) != address(0));\\n }\\n\\n /**\\n * @notice Returns whether or not the CCTP bridge is enabled.\\n * @dev If the CCTPTokenMessenger is the zero address, CCTP bridging is disabled.\\n */\\n function _isCCTPEnabled() internal view returns (bool) {\\n return address(cctpTokenMessenger) != address(0);\\n }\\n\\n /**\\n * @notice Transfers USDC from the current domain to the given address on the new domain.\\n * @dev This function will revert if the CCTP bridge is disabled. I.e. if the zero address is passed to the constructor for the cctpTokenMessenger.\\n * @param to Address to receive USDC on the new domain.\\n * @param amount Amount of USDC to transfer.\\n */\\n function _transferUsdc(address to, uint256 amount) internal {\\n _transferUsdc(to.toBytes32(), amount);\\n }\\n\\n /**\\n * @notice Transfers USDC from the current domain to the given address on the new domain.\\n * @dev This function will revert if the CCTP bridge is disabled. I.e. if the zero address is passed to the constructor for the cctpTokenMessenger.\\n * @param to Address to receive USDC on the new domain represented as bytes32.\\n * @param amount Amount of USDC to transfer.\\n */\\n function _transferUsdc(bytes32 to, uint256 amount) internal {\\n // Only approve the exact amount to be transferred\\n usdcToken.safeIncreaseAllowance(address(cctpTokenMessenger), amount);\\n // Submit the amount to be transferred to bridge via the TokenMessenger.\\n // If the amount to send exceeds the burn limit per message, then split the message into smaller parts.\\n // @dev We do not care about casting cctpTokenMessenger to ITokenMessengerV2 since both V1 and V2\\n // expose a localMinter() view function that returns either an ITokenMinterV1 or ITokenMinterV2. Regardless,\\n // we only care about the burnLimitsPerMessage function which is available in both versions and performs\\n // the same logic, therefore we purposefully do not re-cast the cctpTokenMessenger and cctpMinter\\n // to the specific version.\\n ITokenMinter cctpMinter = cctpTokenMessenger.localMinter();\\n uint256 burnLimit = cctpMinter.burnLimitsPerMessage(address(usdcToken));\\n uint256 remainingAmount = amount;\\n while (remainingAmount > 0) {\\n uint256 partAmount = remainingAmount > burnLimit ? burnLimit : remainingAmount;\\n if (cctpV2) {\\n // Uses the CCTP V2 \\\"standard transfer\\\" speed and\\n // therefore pays no additional fee for the transfer to be sped up.\\n ITokenMessengerV2(address(cctpTokenMessenger)).depositForBurn(\\n partAmount,\\n recipientCircleDomainId,\\n to,\\n address(usdcToken),\\n // The following parameters are new in this function from V2 to V1, can read more here:\\n // https://developers.circle.com/stablecoins/evm-smart-contracts\\n bytes32(0), // destinationCaller is set to bytes32(0) to indicate that anyone can call\\n // receiveMessage on the destination to finalize the transfer\\n 0, // maxFee can be set to 0 for a \\\"standard transfer\\\"\\n 2000 // minFinalityThreshold can be set to 2000 for a \\\"standard transfer\\\",\\n // https://github.com/circlefin/evm-cctp-contracts/blob/63ab1f0ac06ce0793c0bbfbb8d09816bc211386d/src/v2/FinalityThresholds.sol#L21\\n );\\n } else {\\n cctpTokenMessenger.depositForBurn(partAmount, recipientCircleDomainId, to, address(usdcToken));\\n }\\n remainingAmount -= partAmount;\\n }\\n }\\n}\\n\",\"keccak256\":\"0x1798b17c205de3c414d4f5fc81cded9e52a1f39a936ba43154d48f1b30c84ac9\",\"license\":\"BUSL-1.1\"}},\"version\":1}",
- "bytecode": "0x61016060409080825234620002345760a081620012d9803803809162000026828562000238565b833981010312620002345780516001600160a01b039290919083831683036200023457602093848301518181168103620002345782840151938285168503620002345760608101519083821682036200023457608001519083821692838303620002345760805260c05260e052600e60a052825163011a412160e61b878201908152600482526001600160401b0392828601918483118484101762000216575f938493885251915afa953d156200022a573d9182116200021657835191620000f8601f8201601f191683018462000238565b82523d5f8284013e5b866200020a575b86620001d5575b505050610100938452610120928352610140918252519161107c93846200025d853960805184818161011401526102c9015260a051848181610383015281816107bc01526108c5015260c0518481816105fd01528181610b3c0152610c89015260e05184818161025a015281816105ce015281816106250152818161067b015281816107620152818161080e0152610904015251838181610323015261073b0152518281816104480152610c1d0152518181816104c101528181610a170152610baf0152f35b909192955080825192015191818110620001f9575b5050161515925f80806200010f565b5f19910360031b1b165f80620001ea565b81518114965062000108565b634e487b7160e01b5f52604160045260245ffd5b6060915062000101565b5f80fd5b601f909101601f19168101906001600160401b03821190821017620002165760405256fe6080806040526004361015610012575f80fd5b5f905f3560e01c90816311eac85514610c41575080631efd482a14610bd357806335a2db6a14610b6557806352c8c75c146103e35780635e743ef7146103a75780636e40098314610348578063775c0d03146102ed578063927ede2d1461027e5780639748cf7c1461020f5763e6eb8ade1461008c575f80fd5b60407ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffc36011261020c576100be610cad565b6024359067ffffffffffffffff908183116101f957366023840112156101f95782600401359182116101f957602483019260248336920101116101f9578373ffffffffffffffffffffffffffffffffffffffff807f00000000000000000000000000000000000000000000000000000000000000001692833b156102085782906040519283917f3dbb202b000000000000000000000000000000000000000000000000000000008352169485600483015260606024830152818381610187606482018b8d610d52565b62030d40604483015203925af180156101fd576101e5575b50506101df7f9e6c52944e331ba6270e7fe4cea2a4086bae8f7a27e1cdba07f416806f5d0ac4936040519384938452604060208501526040840191610d52565b0390a180f35b6101ee90610cd0565b6101f957835f61019f565b8380fd5b6040513d84823e3d90fd5b8280fd5b80fd5b503461020c57807ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffc36011261020c57602060405173ffffffffffffffffffffffffffffffffffffffff7f0000000000000000000000000000000000000000000000000000000000000000168152f35b503461020c57807ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffc36011261020c57602060405173ffffffffffffffffffffffffffffffffffffffff7f0000000000000000000000000000000000000000000000000000000000000000168152f35b503461020c57807ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffc36011261020c5760206040517f000000000000000000000000000000000000000000000000000000000000000015158152f35b503461020c57807ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffc36011261020c57602060405163ffffffff7f0000000000000000000000000000000000000000000000000000000000000000168152f35b503461020c57807ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffc36011261020c57602060405162030d408152f35b5060807ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffc3601126109b857610416610cad565b6024359073ffffffffffffffffffffffffffffffffffffffff80831683036109b8576064359281841684036109b857847f0000000000000000000000000000000000000000000000000000000000000000831684841681036105c657803b156105ae578180916024604051809481937f2e1a7d4d00000000000000000000000000000000000000000000000000000000835260443560048401525af180156101fd576105b2575b50827f000000000000000000000000000000000000000000000000000000000000000016803b156105ae5781608491604051928380927f9a2ac6d5000000000000000000000000000000000000000000000000000000008252888b16600483015262030d40602483015260606044830152846064830152604435905af180156101fd57610590575b5050907fd7e09655439c3932e55857df3220186e5a7f0980825f20691c2b35d941dee75b9381608094935b81604051951685521660208401526044356040840152166060820152a180f35b61059d9094939294610cd0565b6105aa579091845f610545565b8480fd5b5080fd5b6105bb90610cd0565b6105aa57845f6104bd565b5050819293917f000000000000000000000000000000000000000000000000000000000000000016151580610b38575b15610a14577f000000000000000000000000000000000000000000000000000000000000000061064b604435857f00000000000000000000000000000000000000000000000000000000000000001683610d90565b604051907fcb75c11c000000000000000000000000000000000000000000000000000000008252602082600481887f0000000000000000000000000000000000000000000000000000000000000000165afa80156109c457859288916109cf575b506020906024604051809581937fa56ec6320000000000000000000000000000000000000000000000000000000083528187166004840152165afa9182156109c457879261098c575b50604435805b61072f57505050917fd7e09655439c3932e55857df3220186e5a7f0980825f20691c2b35d941dee75b939181608094610570565b8281111561098657825b7f00000000000000000000000000000000000000000000000000000000000000001561089257867f0000000000000000000000000000000000000000000000000000000000000000163b1561088e57886040517f8e0250ee00000000000000000000000000000000000000000000000000000000815282600482015263ffffffff7f0000000000000000000000000000000000000000000000000000000000000000166024820152888816604482015288851660648201528160848201528160a48201526107d060c4820152818160e481838d7f0000000000000000000000000000000000000000000000000000000000000000165af180156101fd5761087a575b50505b810390811161084d57806106fb565b6024887f4e487b710000000000000000000000000000000000000000000000000000000081526011600452fd5b61088390610cd0565b61088e57885f61083b565b8880fd5b6040517f6fd3504e00000000000000000000000000000000000000000000000000000000815281600482015263ffffffff7f0000000000000000000000000000000000000000000000000000000000000000166024820152878716604482015287841660648201526020816084818d8c7f0000000000000000000000000000000000000000000000000000000000000000165af1801561097b57610937575b5061083e565b6020813d602011610973575b8161095060209383610d11565b8101031261096f575167ffffffffffffffff81160361088e575f610931565b8980fd5b3d9150610943565b6040513d8c823e3d90fd5b80610739565b9091506020813d6020116109bc575b816109a860209383610d11565b810103126109b85751905f6106f5565b5f80fd5b3d915061099b565b6040513d89823e3d90fd5b919250506020813d602011610a0c575b816109ec60209383610d11565b81010312610a085751908482168203610a0857849160206106ac565b8680fd5b3d91506109df565b827f000000000000000000000000000000000000000000000000000000000000000016610a4660443582868816610d90565b803b156109b8575f809160e4604051809481937f838b2520000000000000000000000000000000000000000000000000000000008352898b16600484015289881660248401528989166044840152604435606484015262030d40608484015260c060a48401528160c48401525af18015610b2d57610aed575b50917fd7e09655439c3932e55857df3220186e5a7f0980825f20691c2b35d941dee75b939181608094610570565b60809391955091610b1f7fd7e09655439c3932e55857df3220186e5a7f0980825f20691c2b35d941dee75b9593610cd0565b815f96925093509193610abf565b6040513d5f823e3d90fd5b50827f000000000000000000000000000000000000000000000000000000000000000016838516146105f6565b346109b8575f7ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffc3601126109b857602060405173ffffffffffffffffffffffffffffffffffffffff7f0000000000000000000000000000000000000000000000000000000000000000168152f35b346109b8575f7ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffc3601126109b857602060405173ffffffffffffffffffffffffffffffffffffffff7f0000000000000000000000000000000000000000000000000000000000000000168152f35b346109b8575f7ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffc3601126109b85760209073ffffffffffffffffffffffffffffffffffffffff7f0000000000000000000000000000000000000000000000000000000000000000168152f35b6004359073ffffffffffffffffffffffffffffffffffffffff821682036109b857565b67ffffffffffffffff8111610ce457604052565b7f4e487b71000000000000000000000000000000000000000000000000000000005f52604160045260245ffd5b90601f7fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe0910116810190811067ffffffffffffffff821117610ce457604052565b601f82602094937fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe093818652868601375f8582860101520116010190565b9291909273ffffffffffffffffffffffffffffffffffffffff809116604051917fdd62ed3e000000000000000000000000000000000000000000000000000000008352306004840152602495169182868201526020938482604481865afa918215610b2d575f92610fee575b508101809111610fc25760405190848201937f095ea7b3000000000000000000000000000000000000000000000000000000008552878301526044820152604481526080810167ffffffffffffffff9382821085831117610f965760c083019282841086851117610f6a57865f94938594604052527f5361666545524332303a206c6f772d6c6576656c2063616c6c206661696c656460a0820152519082855af1903d15610f59573d928311610f2d57610ef59394955060405192610ee8867fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe0601f8401160185610d11565b83523d5f8685013e61101d565b8051918215918215610f0d575b50509050156109b857565b8092508193810103126109b857015180151581036109b857805f80610f02565b857f4e487b71000000000000000000000000000000000000000000000000000000005f5260416004525ffd5b9150610ef59293945060609161101d565b887f4e487b71000000000000000000000000000000000000000000000000000000005f5260416004525ffd5b877f4e487b71000000000000000000000000000000000000000000000000000000005f5260416004525ffd5b857f4e487b71000000000000000000000000000000000000000000000000000000005f5260116004525ffd5b9091508481813d8311611016575b6110068183610d11565b810103126109b85751905f610dfc565b503d610ffc565b90156110375781511561102e575090565b3b156109b85790565b5080519081156109b857602001fdfea26469706673582212205169ea9c27d7ec34300ba04b9ac84f01797bd0d394c238dc623de9c35d11e57c64736f6c63430008170033",
- "deployedBytecode": "0x6080806040526004361015610012575f80fd5b5f905f3560e01c90816311eac85514610c41575080631efd482a14610bd357806335a2db6a14610b6557806352c8c75c146103e35780635e743ef7146103a75780636e40098314610348578063775c0d03146102ed578063927ede2d1461027e5780639748cf7c1461020f5763e6eb8ade1461008c575f80fd5b60407ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffc36011261020c576100be610cad565b6024359067ffffffffffffffff908183116101f957366023840112156101f95782600401359182116101f957602483019260248336920101116101f9578373ffffffffffffffffffffffffffffffffffffffff807f00000000000000000000000000000000000000000000000000000000000000001692833b156102085782906040519283917f3dbb202b000000000000000000000000000000000000000000000000000000008352169485600483015260606024830152818381610187606482018b8d610d52565b62030d40604483015203925af180156101fd576101e5575b50506101df7f9e6c52944e331ba6270e7fe4cea2a4086bae8f7a27e1cdba07f416806f5d0ac4936040519384938452604060208501526040840191610d52565b0390a180f35b6101ee90610cd0565b6101f957835f61019f565b8380fd5b6040513d84823e3d90fd5b8280fd5b80fd5b503461020c57807ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffc36011261020c57602060405173ffffffffffffffffffffffffffffffffffffffff7f0000000000000000000000000000000000000000000000000000000000000000168152f35b503461020c57807ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffc36011261020c57602060405173ffffffffffffffffffffffffffffffffffffffff7f0000000000000000000000000000000000000000000000000000000000000000168152f35b503461020c57807ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffc36011261020c5760206040517f000000000000000000000000000000000000000000000000000000000000000015158152f35b503461020c57807ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffc36011261020c57602060405163ffffffff7f0000000000000000000000000000000000000000000000000000000000000000168152f35b503461020c57807ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffc36011261020c57602060405162030d408152f35b5060807ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffc3601126109b857610416610cad565b6024359073ffffffffffffffffffffffffffffffffffffffff80831683036109b8576064359281841684036109b857847f0000000000000000000000000000000000000000000000000000000000000000831684841681036105c657803b156105ae578180916024604051809481937f2e1a7d4d00000000000000000000000000000000000000000000000000000000835260443560048401525af180156101fd576105b2575b50827f000000000000000000000000000000000000000000000000000000000000000016803b156105ae5781608491604051928380927f9a2ac6d5000000000000000000000000000000000000000000000000000000008252888b16600483015262030d40602483015260606044830152846064830152604435905af180156101fd57610590575b5050907fd7e09655439c3932e55857df3220186e5a7f0980825f20691c2b35d941dee75b9381608094935b81604051951685521660208401526044356040840152166060820152a180f35b61059d9094939294610cd0565b6105aa579091845f610545565b8480fd5b5080fd5b6105bb90610cd0565b6105aa57845f6104bd565b5050819293917f000000000000000000000000000000000000000000000000000000000000000016151580610b38575b15610a14577f000000000000000000000000000000000000000000000000000000000000000061064b604435857f00000000000000000000000000000000000000000000000000000000000000001683610d90565b604051907fcb75c11c000000000000000000000000000000000000000000000000000000008252602082600481887f0000000000000000000000000000000000000000000000000000000000000000165afa80156109c457859288916109cf575b506020906024604051809581937fa56ec6320000000000000000000000000000000000000000000000000000000083528187166004840152165afa9182156109c457879261098c575b50604435805b61072f57505050917fd7e09655439c3932e55857df3220186e5a7f0980825f20691c2b35d941dee75b939181608094610570565b8281111561098657825b7f00000000000000000000000000000000000000000000000000000000000000001561089257867f0000000000000000000000000000000000000000000000000000000000000000163b1561088e57886040517f8e0250ee00000000000000000000000000000000000000000000000000000000815282600482015263ffffffff7f0000000000000000000000000000000000000000000000000000000000000000166024820152888816604482015288851660648201528160848201528160a48201526107d060c4820152818160e481838d7f0000000000000000000000000000000000000000000000000000000000000000165af180156101fd5761087a575b50505b810390811161084d57806106fb565b6024887f4e487b710000000000000000000000000000000000000000000000000000000081526011600452fd5b61088390610cd0565b61088e57885f61083b565b8880fd5b6040517f6fd3504e00000000000000000000000000000000000000000000000000000000815281600482015263ffffffff7f0000000000000000000000000000000000000000000000000000000000000000166024820152878716604482015287841660648201526020816084818d8c7f0000000000000000000000000000000000000000000000000000000000000000165af1801561097b57610937575b5061083e565b6020813d602011610973575b8161095060209383610d11565b8101031261096f575167ffffffffffffffff81160361088e575f610931565b8980fd5b3d9150610943565b6040513d8c823e3d90fd5b80610739565b9091506020813d6020116109bc575b816109a860209383610d11565b810103126109b85751905f6106f5565b5f80fd5b3d915061099b565b6040513d89823e3d90fd5b919250506020813d602011610a0c575b816109ec60209383610d11565b81010312610a085751908482168203610a0857849160206106ac565b8680fd5b3d91506109df565b827f000000000000000000000000000000000000000000000000000000000000000016610a4660443582868816610d90565b803b156109b8575f809160e4604051809481937f838b2520000000000000000000000000000000000000000000000000000000008352898b16600484015289881660248401528989166044840152604435606484015262030d40608484015260c060a48401528160c48401525af18015610b2d57610aed575b50917fd7e09655439c3932e55857df3220186e5a7f0980825f20691c2b35d941dee75b939181608094610570565b60809391955091610b1f7fd7e09655439c3932e55857df3220186e5a7f0980825f20691c2b35d941dee75b9593610cd0565b815f96925093509193610abf565b6040513d5f823e3d90fd5b50827f000000000000000000000000000000000000000000000000000000000000000016838516146105f6565b346109b8575f7ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffc3601126109b857602060405173ffffffffffffffffffffffffffffffffffffffff7f0000000000000000000000000000000000000000000000000000000000000000168152f35b346109b8575f7ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffc3601126109b857602060405173ffffffffffffffffffffffffffffffffffffffff7f0000000000000000000000000000000000000000000000000000000000000000168152f35b346109b8575f7ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffc3601126109b85760209073ffffffffffffffffffffffffffffffffffffffff7f0000000000000000000000000000000000000000000000000000000000000000168152f35b6004359073ffffffffffffffffffffffffffffffffffffffff821682036109b857565b67ffffffffffffffff8111610ce457604052565b7f4e487b71000000000000000000000000000000000000000000000000000000005f52604160045260245ffd5b90601f7fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe0910116810190811067ffffffffffffffff821117610ce457604052565b601f82602094937fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe093818652868601375f8582860101520116010190565b9291909273ffffffffffffffffffffffffffffffffffffffff809116604051917fdd62ed3e000000000000000000000000000000000000000000000000000000008352306004840152602495169182868201526020938482604481865afa918215610b2d575f92610fee575b508101809111610fc25760405190848201937f095ea7b3000000000000000000000000000000000000000000000000000000008552878301526044820152604481526080810167ffffffffffffffff9382821085831117610f965760c083019282841086851117610f6a57865f94938594604052527f5361666545524332303a206c6f772d6c6576656c2063616c6c206661696c656460a0820152519082855af1903d15610f59573d928311610f2d57610ef59394955060405192610ee8867fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe0601f8401160185610d11565b83523d5f8685013e61101d565b8051918215918215610f0d575b50509050156109b857565b8092508193810103126109b857015180151581036109b857805f80610f02565b857f4e487b71000000000000000000000000000000000000000000000000000000005f5260416004525ffd5b9150610ef59293945060609161101d565b887f4e487b71000000000000000000000000000000000000000000000000000000005f5260416004525ffd5b877f4e487b71000000000000000000000000000000000000000000000000000000005f5260416004525ffd5b857f4e487b71000000000000000000000000000000000000000000000000000000005f5260116004525ffd5b9091508481813d8311611016575b6110068183610d11565b810103126109b85751905f610dfc565b503d610ffc565b90156110375781511561102e575090565b3b156109b85790565b5080519081156109b857602001fdfea26469706673582212205169ea9c27d7ec34300ba04b9ac84f01797bd0d394c238dc623de9c35d11e57c64736f6c63430008170033",
+ "numDeployments": 1,
+ "solcInputHash": "99d1a1f8a9ec609c6ba2c28b0402f384",
+ "metadata": "{\"compiler\":{\"version\":\"0.8.23+commit.f704f362\"},\"language\":\"Solidity\",\"output\":{\"abi\":[{\"inputs\":[{\"internalType\":\"contract WETH9Interface\",\"name\":\"_l1Weth\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"_crossDomainMessenger\",\"type\":\"address\"},{\"internalType\":\"contract IL1StandardBridge\",\"name\":\"_l1StandardBridge\",\"type\":\"address\"},{\"internalType\":\"contract IERC20\",\"name\":\"_l1Usdc\",\"type\":\"address\"}],\"stateMutability\":\"nonpayable\",\"type\":\"constructor\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address\",\"name\":\"target\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"}],\"name\":\"MessageRelayed\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address\",\"name\":\"l1Token\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"l2Token\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"amount\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"to\",\"type\":\"address\"}],\"name\":\"TokensRelayed\",\"type\":\"event\"},{\"inputs\":[],\"name\":\"L1_STANDARD_BRIDGE\",\"outputs\":[{\"internalType\":\"contract IL1StandardBridge\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"L1_WETH\",\"outputs\":[{\"internalType\":\"contract WETH9Interface\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"L2_GAS_LIMIT\",\"outputs\":[{\"internalType\":\"uint32\",\"name\":\"\",\"type\":\"uint32\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"MESSENGER\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"cctpTokenMessenger\",\"outputs\":[{\"internalType\":\"contract ITokenMessenger\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"recipientCircleDomainId\",\"outputs\":[{\"internalType\":\"uint32\",\"name\":\"\",\"type\":\"uint32\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"target\",\"type\":\"address\"},{\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"}],\"name\":\"relayMessage\",\"outputs\":[],\"stateMutability\":\"payable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"l1Token\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"l2Token\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"amount\",\"type\":\"uint256\"},{\"internalType\":\"address\",\"name\":\"to\",\"type\":\"address\"}],\"name\":\"relayTokens\",\"outputs\":[],\"stateMutability\":\"payable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"usdcToken\",\"outputs\":[{\"internalType\":\"contract IERC20\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"}],\"devdoc\":{\"custom:security-contact\":\"bugs@across.to\",\"details\":\"Public functions calling external contracts do not guard against reentrancy because they are expected to be called via delegatecall, which will execute this contract's logic within the context of the originating contract. For example, the HubPool will delegatecall these functions, therefore its only necessary that the HubPool's methods that call this contract's logic guard against reentrancy.\",\"kind\":\"dev\",\"methods\":{\"constructor\":{\"params\":{\"_crossDomainMessenger\":\"XDomainMessenger World Chain system contract.\",\"_l1StandardBridge\":\"Standard bridge contract.\",\"_l1Usdc\":\"USDC address on L1.\",\"_l1Weth\":\"WETH address on L1.\"}},\"relayMessage(address,bytes)\":{\"params\":{\"message\":\"Data to send to target.\",\"target\":\"Contract on World Chain that will receive message.\"}},\"relayTokens(address,address,uint256,address)\":{\"params\":{\"amount\":\"Amount of L1 tokens to deposit and L2 tokens to receive.\",\"l1Token\":\"L1 token to deposit.\",\"l2Token\":\"L2 token to receive.\",\"to\":\"Bridge recipient.\"}}},\"version\":1},\"userdoc\":{\"kind\":\"user\",\"methods\":{\"constructor\":{\"notice\":\"Constructs new Adapter.\"},\"relayMessage(address,bytes)\":{\"notice\":\"Send cross-chain message to target on World Chain.\"},\"relayTokens(address,address,uint256,address)\":{\"notice\":\"Bridge tokens to World Chain.\"}},\"notice\":\"Contract containing logic to send messages from L1 to World Chain. This is a clone of the Base/Mode adapter\",\"version\":1}},\"settings\":{\"compilationTarget\":{\"contracts/chain-adapters/WorldChain_Adapter.sol\":\"WorldChain_Adapter\"},\"debug\":{\"revertStrings\":\"strip\"},\"evmVersion\":\"shanghai\",\"libraries\":{},\"metadata\":{\"bytecodeHash\":\"ipfs\",\"useLiteralContent\":true},\"optimizer\":{\"enabled\":true,\"runs\":1000000},\"remappings\":[],\"viaIR\":true},\"sources\":{\"@eth-optimism/contracts/L1/messaging/IL1ERC20Bridge.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity >0.5.0 <0.9.0;\\n\\n/**\\n * @title IL1ERC20Bridge\\n */\\ninterface IL1ERC20Bridge {\\n /**********\\n * Events *\\n **********/\\n\\n event ERC20DepositInitiated(\\n address indexed _l1Token,\\n address indexed _l2Token,\\n address indexed _from,\\n address _to,\\n uint256 _amount,\\n bytes _data\\n );\\n\\n event ERC20WithdrawalFinalized(\\n address indexed _l1Token,\\n address indexed _l2Token,\\n address indexed _from,\\n address _to,\\n uint256 _amount,\\n bytes _data\\n );\\n\\n /********************\\n * Public Functions *\\n ********************/\\n\\n /**\\n * @dev get the address of the corresponding L2 bridge contract.\\n * @return Address of the corresponding L2 bridge contract.\\n */\\n function l2TokenBridge() external returns (address);\\n\\n /**\\n * @dev deposit an amount of the ERC20 to the caller's balance on L2.\\n * @param _l1Token Address of the L1 ERC20 we are depositing\\n * @param _l2Token Address of the L1 respective L2 ERC20\\n * @param _amount Amount of the ERC20 to deposit\\n * @param _l2Gas Gas limit required to complete the deposit on L2.\\n * @param _data Optional data to forward to L2. This data is provided\\n * solely as a convenience for external contracts. Aside from enforcing a maximum\\n * length, these contracts provide no guarantees about its content.\\n */\\n function depositERC20(\\n address _l1Token,\\n address _l2Token,\\n uint256 _amount,\\n uint32 _l2Gas,\\n bytes calldata _data\\n ) external;\\n\\n /**\\n * @dev deposit an amount of ERC20 to a recipient's balance on L2.\\n * @param _l1Token Address of the L1 ERC20 we are depositing\\n * @param _l2Token Address of the L1 respective L2 ERC20\\n * @param _to L2 address to credit the withdrawal to.\\n * @param _amount Amount of the ERC20 to deposit.\\n * @param _l2Gas Gas limit required to complete the deposit on L2.\\n * @param _data Optional data to forward to L2. This data is provided\\n * solely as a convenience for external contracts. Aside from enforcing a maximum\\n * length, these contracts provide no guarantees about its content.\\n */\\n function depositERC20To(\\n address _l1Token,\\n address _l2Token,\\n address _to,\\n uint256 _amount,\\n uint32 _l2Gas,\\n bytes calldata _data\\n ) external;\\n\\n /*************************\\n * Cross-chain Functions *\\n *************************/\\n\\n /**\\n * @dev Complete a withdrawal from L2 to L1, and credit funds to the recipient's balance of the\\n * L1 ERC20 token.\\n * This call will fail if the initialized withdrawal from L2 has not been finalized.\\n *\\n * @param _l1Token Address of L1 token to finalizeWithdrawal for.\\n * @param _l2Token Address of L2 token where withdrawal was initiated.\\n * @param _from L2 address initiating the transfer.\\n * @param _to L1 address to credit the withdrawal to.\\n * @param _amount Amount of the ERC20 to deposit.\\n * @param _data Data provided by the sender on L2. This data is provided\\n * solely as a convenience for external contracts. Aside from enforcing a maximum\\n * length, these contracts provide no guarantees about its content.\\n */\\n function finalizeERC20Withdrawal(\\n address _l1Token,\\n address _l2Token,\\n address _from,\\n address _to,\\n uint256 _amount,\\n bytes calldata _data\\n ) external;\\n}\\n\",\"keccak256\":\"0x69f831896dcbb6bef4f2d6c8be6cd1bf352f5910074d3ce973b9f8e0a4f4c1dd\",\"license\":\"MIT\"},\"@eth-optimism/contracts/L1/messaging/IL1StandardBridge.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity >0.5.0 <0.9.0;\\n\\nimport \\\"./IL1ERC20Bridge.sol\\\";\\n\\n/**\\n * @title IL1StandardBridge\\n */\\ninterface IL1StandardBridge is IL1ERC20Bridge {\\n /**********\\n * Events *\\n **********/\\n event ETHDepositInitiated(\\n address indexed _from,\\n address indexed _to,\\n uint256 _amount,\\n bytes _data\\n );\\n\\n event ETHWithdrawalFinalized(\\n address indexed _from,\\n address indexed _to,\\n uint256 _amount,\\n bytes _data\\n );\\n\\n /********************\\n * Public Functions *\\n ********************/\\n\\n /**\\n * @dev Deposit an amount of the ETH to the caller's balance on L2.\\n * @param _l2Gas Gas limit required to complete the deposit on L2.\\n * @param _data Optional data to forward to L2. This data is provided\\n * solely as a convenience for external contracts. Aside from enforcing a maximum\\n * length, these contracts provide no guarantees about its content.\\n */\\n function depositETH(uint32 _l2Gas, bytes calldata _data) external payable;\\n\\n /**\\n * @dev Deposit an amount of ETH to a recipient's balance on L2.\\n * @param _to L2 address to credit the withdrawal to.\\n * @param _l2Gas Gas limit required to complete the deposit on L2.\\n * @param _data Optional data to forward to L2. This data is provided\\n * solely as a convenience for external contracts. Aside from enforcing a maximum\\n * length, these contracts provide no guarantees about its content.\\n */\\n function depositETHTo(\\n address _to,\\n uint32 _l2Gas,\\n bytes calldata _data\\n ) external payable;\\n\\n /*************************\\n * Cross-chain Functions *\\n *************************/\\n\\n /**\\n * @dev Complete a withdrawal from L2 to L1, and credit funds to the recipient's balance of the\\n * L1 ETH token. Since only the xDomainMessenger can call this function, it will never be called\\n * before the withdrawal is finalized.\\n * @param _from L2 address initiating the transfer.\\n * @param _to L1 address to credit the withdrawal to.\\n * @param _amount Amount of the ERC20 to deposit.\\n * @param _data Optional data to forward to L2. This data is provided\\n * solely as a convenience for external contracts. Aside from enforcing a maximum\\n * length, these contracts provide no guarantees about its content.\\n */\\n function finalizeETHWithdrawal(\\n address _from,\\n address _to,\\n uint256 _amount,\\n bytes calldata _data\\n ) external;\\n}\\n\",\"keccak256\":\"0x3d511f1bcea86aa88a9c41798926ea75b5b3f455c0377e63223a123a9e714ddc\",\"license\":\"MIT\"},\"@eth-optimism/contracts/libraries/bridge/ICrossDomainMessenger.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity >0.5.0 <0.9.0;\\n\\n/**\\n * @title ICrossDomainMessenger\\n */\\ninterface ICrossDomainMessenger {\\n /**********\\n * Events *\\n **********/\\n\\n event SentMessage(\\n address indexed target,\\n address sender,\\n bytes message,\\n uint256 messageNonce,\\n uint256 gasLimit\\n );\\n event RelayedMessage(bytes32 indexed msgHash);\\n event FailedRelayedMessage(bytes32 indexed msgHash);\\n\\n /*************\\n * Variables *\\n *************/\\n\\n function xDomainMessageSender() external view returns (address);\\n\\n /********************\\n * Public Functions *\\n ********************/\\n\\n /**\\n * Sends a cross domain message to the target messenger.\\n * @param _target Target contract address.\\n * @param _message Message to send to the target.\\n * @param _gasLimit Gas limit for the provided message.\\n */\\n function sendMessage(\\n address _target,\\n bytes calldata _message,\\n uint32 _gasLimit\\n ) external;\\n}\\n\",\"keccak256\":\"0x8f29ae23021345a20ccac7b5edb3fc38268aef943b65adc8a32e74b80bf1833a\",\"license\":\"MIT\"},\"@openzeppelin/contracts/token/ERC20/IERC20.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v4.9.0) (token/ERC20/IERC20.sol)\\n\\npragma solidity ^0.8.0;\\n\\n/**\\n * @dev Interface of the ERC20 standard as defined in the EIP.\\n */\\ninterface IERC20 {\\n /**\\n * @dev Emitted when `value` tokens are moved from one account (`from`) to\\n * another (`to`).\\n *\\n * Note that `value` may be zero.\\n */\\n event Transfer(address indexed from, address indexed to, uint256 value);\\n\\n /**\\n * @dev Emitted when the allowance of a `spender` for an `owner` is set by\\n * a call to {approve}. `value` is the new allowance.\\n */\\n event Approval(address indexed owner, address indexed spender, uint256 value);\\n\\n /**\\n * @dev Returns the amount of tokens in existence.\\n */\\n function totalSupply() external view returns (uint256);\\n\\n /**\\n * @dev Returns the amount of tokens owned by `account`.\\n */\\n function balanceOf(address account) external view returns (uint256);\\n\\n /**\\n * @dev Moves `amount` tokens from the caller's account to `to`.\\n *\\n * Returns a boolean value indicating whether the operation succeeded.\\n *\\n * Emits a {Transfer} event.\\n */\\n function transfer(address to, uint256 amount) external returns (bool);\\n\\n /**\\n * @dev Returns the remaining number of tokens that `spender` will be\\n * allowed to spend on behalf of `owner` through {transferFrom}. This is\\n * zero by default.\\n *\\n * This value changes when {approve} or {transferFrom} are called.\\n */\\n function allowance(address owner, address spender) external view returns (uint256);\\n\\n /**\\n * @dev Sets `amount` as the allowance of `spender` over the caller's tokens.\\n *\\n * Returns a boolean value indicating whether the operation succeeded.\\n *\\n * IMPORTANT: Beware that changing an allowance with this method brings the risk\\n * that someone may use both the old and the new allowance by unfortunate\\n * transaction ordering. One possible solution to mitigate this race\\n * condition is to first reduce the spender's allowance to 0 and set the\\n * desired value afterwards:\\n * https://github.com/ethereum/EIPs/issues/20#issuecomment-263524729\\n *\\n * Emits an {Approval} event.\\n */\\n function approve(address spender, uint256 amount) external returns (bool);\\n\\n /**\\n * @dev Moves `amount` tokens from `from` to `to` using the\\n * allowance mechanism. `amount` is then deducted from the caller's\\n * allowance.\\n *\\n * Returns a boolean value indicating whether the operation succeeded.\\n *\\n * Emits a {Transfer} event.\\n */\\n function transferFrom(address from, address to, uint256 amount) external returns (bool);\\n}\\n\",\"keccak256\":\"0x287b55befed2961a7eabd7d7b1b2839cbca8a5b80ef8dcbb25ed3d4c2002c305\",\"license\":\"MIT\"},\"@openzeppelin/contracts/token/ERC20/extensions/IERC20Permit.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v4.9.4) (token/ERC20/extensions/IERC20Permit.sol)\\n\\npragma solidity ^0.8.0;\\n\\n/**\\n * @dev Interface of the ERC20 Permit extension allowing approvals to be made via signatures, as defined in\\n * https://eips.ethereum.org/EIPS/eip-2612[EIP-2612].\\n *\\n * Adds the {permit} method, which can be used to change an account's ERC20 allowance (see {IERC20-allowance}) by\\n * presenting a message signed by the account. By not relying on {IERC20-approve}, the token holder account doesn't\\n * need to send a transaction, and thus is not required to hold Ether at all.\\n *\\n * ==== Security Considerations\\n *\\n * There are two important considerations concerning the use of `permit`. The first is that a valid permit signature\\n * expresses an allowance, and it should not be assumed to convey additional meaning. In particular, it should not be\\n * considered as an intention to spend the allowance in any specific way. The second is that because permits have\\n * built-in replay protection and can be submitted by anyone, they can be frontrun. A protocol that uses permits should\\n * take this into consideration and allow a `permit` call to fail. Combining these two aspects, a pattern that may be\\n * generally recommended is:\\n *\\n * ```solidity\\n * function doThingWithPermit(..., uint256 value, uint256 deadline, uint8 v, bytes32 r, bytes32 s) public {\\n * try token.permit(msg.sender, address(this), value, deadline, v, r, s) {} catch {}\\n * doThing(..., value);\\n * }\\n *\\n * function doThing(..., uint256 value) public {\\n * token.safeTransferFrom(msg.sender, address(this), value);\\n * ...\\n * }\\n * ```\\n *\\n * Observe that: 1) `msg.sender` is used as the owner, leaving no ambiguity as to the signer intent, and 2) the use of\\n * `try/catch` allows the permit to fail and makes the code tolerant to frontrunning. (See also\\n * {SafeERC20-safeTransferFrom}).\\n *\\n * Additionally, note that smart contract wallets (such as Argent or Safe) are not able to produce permit signatures, so\\n * contracts should have entry points that don't rely on permit.\\n */\\ninterface IERC20Permit {\\n /**\\n * @dev Sets `value` as the allowance of `spender` over ``owner``'s tokens,\\n * given ``owner``'s signed approval.\\n *\\n * IMPORTANT: The same issues {IERC20-approve} has related to transaction\\n * ordering also apply here.\\n *\\n * Emits an {Approval} event.\\n *\\n * Requirements:\\n *\\n * - `spender` cannot be the zero address.\\n * - `deadline` must be a timestamp in the future.\\n * - `v`, `r` and `s` must be a valid `secp256k1` signature from `owner`\\n * over the EIP712-formatted function arguments.\\n * - the signature must use ``owner``'s current nonce (see {nonces}).\\n *\\n * For more information on the signature format, see the\\n * https://eips.ethereum.org/EIPS/eip-2612#specification[relevant EIP\\n * section].\\n *\\n * CAUTION: See Security Considerations above.\\n */\\n function permit(\\n address owner,\\n address spender,\\n uint256 value,\\n uint256 deadline,\\n uint8 v,\\n bytes32 r,\\n bytes32 s\\n ) external;\\n\\n /**\\n * @dev Returns the current nonce for `owner`. This value must be\\n * included whenever a signature is generated for {permit}.\\n *\\n * Every successful call to {permit} increases ``owner``'s nonce by one. This\\n * prevents a signature from being used multiple times.\\n */\\n function nonces(address owner) external view returns (uint256);\\n\\n /**\\n * @dev Returns the domain separator used in the encoding of the signature for {permit}, as defined by {EIP712}.\\n */\\n // solhint-disable-next-line func-name-mixedcase\\n function DOMAIN_SEPARATOR() external view returns (bytes32);\\n}\\n\",\"keccak256\":\"0xb264c03a3442eb37a68ad620cefd1182766b58bee6cec40343480392d6b14d69\",\"license\":\"MIT\"},\"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v4.9.3) (token/ERC20/utils/SafeERC20.sol)\\n\\npragma solidity ^0.8.0;\\n\\nimport \\\"../IERC20.sol\\\";\\nimport \\\"../extensions/IERC20Permit.sol\\\";\\nimport \\\"../../../utils/Address.sol\\\";\\n\\n/**\\n * @title SafeERC20\\n * @dev Wrappers around ERC20 operations that throw on failure (when the token\\n * contract returns false). Tokens that return no value (and instead revert or\\n * throw on failure) are also supported, non-reverting calls are assumed to be\\n * successful.\\n * To use this library you can add a `using SafeERC20 for IERC20;` statement to your contract,\\n * which allows you to call the safe operations as `token.safeTransfer(...)`, etc.\\n */\\nlibrary SafeERC20 {\\n using Address for address;\\n\\n /**\\n * @dev Transfer `value` amount of `token` from the calling contract to `to`. If `token` returns no value,\\n * non-reverting calls are assumed to be successful.\\n */\\n function safeTransfer(IERC20 token, address to, uint256 value) internal {\\n _callOptionalReturn(token, abi.encodeWithSelector(token.transfer.selector, to, value));\\n }\\n\\n /**\\n * @dev Transfer `value` amount of `token` from `from` to `to`, spending the approval given by `from` to the\\n * calling contract. If `token` returns no value, non-reverting calls are assumed to be successful.\\n */\\n function safeTransferFrom(IERC20 token, address from, address to, uint256 value) internal {\\n _callOptionalReturn(token, abi.encodeWithSelector(token.transferFrom.selector, from, to, value));\\n }\\n\\n /**\\n * @dev Deprecated. This function has issues similar to the ones found in\\n * {IERC20-approve}, and its usage is discouraged.\\n *\\n * Whenever possible, use {safeIncreaseAllowance} and\\n * {safeDecreaseAllowance} instead.\\n */\\n function safeApprove(IERC20 token, address spender, uint256 value) internal {\\n // safeApprove should only be called when setting an initial allowance,\\n // or when resetting it to zero. To increase and decrease it, use\\n // 'safeIncreaseAllowance' and 'safeDecreaseAllowance'\\n require(\\n (value == 0) || (token.allowance(address(this), spender) == 0),\\n \\\"SafeERC20: approve from non-zero to non-zero allowance\\\"\\n );\\n _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, value));\\n }\\n\\n /**\\n * @dev Increase the calling contract's allowance toward `spender` by `value`. If `token` returns no value,\\n * non-reverting calls are assumed to be successful.\\n */\\n function safeIncreaseAllowance(IERC20 token, address spender, uint256 value) internal {\\n uint256 oldAllowance = token.allowance(address(this), spender);\\n _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, oldAllowance + value));\\n }\\n\\n /**\\n * @dev Decrease the calling contract's allowance toward `spender` by `value`. If `token` returns no value,\\n * non-reverting calls are assumed to be successful.\\n */\\n function safeDecreaseAllowance(IERC20 token, address spender, uint256 value) internal {\\n unchecked {\\n uint256 oldAllowance = token.allowance(address(this), spender);\\n require(oldAllowance >= value, \\\"SafeERC20: decreased allowance below zero\\\");\\n _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, oldAllowance - value));\\n }\\n }\\n\\n /**\\n * @dev Set the calling contract's allowance toward `spender` to `value`. If `token` returns no value,\\n * non-reverting calls are assumed to be successful. Meant to be used with tokens that require the approval\\n * to be set to zero before setting it to a non-zero value, such as USDT.\\n */\\n function forceApprove(IERC20 token, address spender, uint256 value) internal {\\n bytes memory approvalCall = abi.encodeWithSelector(token.approve.selector, spender, value);\\n\\n if (!_callOptionalReturnBool(token, approvalCall)) {\\n _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, 0));\\n _callOptionalReturn(token, approvalCall);\\n }\\n }\\n\\n /**\\n * @dev Use a ERC-2612 signature to set the `owner` approval toward `spender` on `token`.\\n * Revert on invalid signature.\\n */\\n function safePermit(\\n IERC20Permit token,\\n address owner,\\n address spender,\\n uint256 value,\\n uint256 deadline,\\n uint8 v,\\n bytes32 r,\\n bytes32 s\\n ) internal {\\n uint256 nonceBefore = token.nonces(owner);\\n token.permit(owner, spender, value, deadline, v, r, s);\\n uint256 nonceAfter = token.nonces(owner);\\n require(nonceAfter == nonceBefore + 1, \\\"SafeERC20: permit did not succeed\\\");\\n }\\n\\n /**\\n * @dev Imitates a Solidity high-level call (i.e. a regular function call to a contract), relaxing the requirement\\n * on the return value: the return value is optional (but if data is returned, it must not be false).\\n * @param token The token targeted by the call.\\n * @param data The call data (encoded using abi.encode or one of its variants).\\n */\\n function _callOptionalReturn(IERC20 token, bytes memory data) private {\\n // We need to perform a low level call here, to bypass Solidity's return data size checking mechanism, since\\n // we're implementing it ourselves. We use {Address-functionCall} to perform this call, which verifies that\\n // the target address contains contract code and also asserts for success in the low-level call.\\n\\n bytes memory returndata = address(token).functionCall(data, \\\"SafeERC20: low-level call failed\\\");\\n require(returndata.length == 0 || abi.decode(returndata, (bool)), \\\"SafeERC20: ERC20 operation did not succeed\\\");\\n }\\n\\n /**\\n * @dev Imitates a Solidity high-level call (i.e. a regular function call to a contract), relaxing the requirement\\n * on the return value: the return value is optional (but if data is returned, it must not be false).\\n * @param token The token targeted by the call.\\n * @param data The call data (encoded using abi.encode or one of its variants).\\n *\\n * This is a variant of {_callOptionalReturn} that silents catches all reverts and returns a bool instead.\\n */\\n function _callOptionalReturnBool(IERC20 token, bytes memory data) private returns (bool) {\\n // We need to perform a low level call here, to bypass Solidity's return data size checking mechanism, since\\n // we're implementing it ourselves. We cannot use {Address-functionCall} here since this should return false\\n // and not revert is the subcall reverts.\\n\\n (bool success, bytes memory returndata) = address(token).call(data);\\n return\\n success && (returndata.length == 0 || abi.decode(returndata, (bool))) && Address.isContract(address(token));\\n }\\n}\\n\",\"keccak256\":\"0xabefac93435967b4d36a4fabcbdbb918d1f0b7ae3c3d85bc30923b326c927ed1\",\"license\":\"MIT\"},\"@openzeppelin/contracts/utils/Address.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v4.9.0) (utils/Address.sol)\\n\\npragma solidity ^0.8.1;\\n\\n/**\\n * @dev Collection of functions related to the address type\\n */\\nlibrary Address {\\n /**\\n * @dev Returns true if `account` is a contract.\\n *\\n * [IMPORTANT]\\n * ====\\n * It is unsafe to assume that an address for which this function returns\\n * false is an externally-owned account (EOA) and not a contract.\\n *\\n * Among others, `isContract` will return false for the following\\n * types of addresses:\\n *\\n * - an externally-owned account\\n * - a contract in construction\\n * - an address where a contract will be created\\n * - an address where a contract lived, but was destroyed\\n *\\n * Furthermore, `isContract` will also return true if the target contract within\\n * the same transaction is already scheduled for destruction by `SELFDESTRUCT`,\\n * which only has an effect at the end of a transaction.\\n * ====\\n *\\n * [IMPORTANT]\\n * ====\\n * You shouldn't rely on `isContract` to protect against flash loan attacks!\\n *\\n * Preventing calls from contracts is highly discouraged. It breaks composability, breaks support for smart wallets\\n * like Gnosis Safe, and does not provide security since it can be circumvented by calling from a contract\\n * constructor.\\n * ====\\n */\\n function isContract(address account) internal view returns (bool) {\\n // This method relies on extcodesize/address.code.length, which returns 0\\n // for contracts in construction, since the code is only stored at the end\\n // of the constructor execution.\\n\\n return account.code.length > 0;\\n }\\n\\n /**\\n * @dev Replacement for Solidity's `transfer`: sends `amount` wei to\\n * `recipient`, forwarding all available gas and reverting on errors.\\n *\\n * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost\\n * of certain opcodes, possibly making contracts go over the 2300 gas limit\\n * imposed by `transfer`, making them unable to receive funds via\\n * `transfer`. {sendValue} removes this limitation.\\n *\\n * https://consensys.net/diligence/blog/2019/09/stop-using-soliditys-transfer-now/[Learn more].\\n *\\n * IMPORTANT: because control is transferred to `recipient`, care must be\\n * taken to not create reentrancy vulnerabilities. Consider using\\n * {ReentrancyGuard} or the\\n * https://solidity.readthedocs.io/en/v0.8.0/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].\\n */\\n function sendValue(address payable recipient, uint256 amount) internal {\\n require(address(this).balance >= amount, \\\"Address: insufficient balance\\\");\\n\\n (bool success, ) = recipient.call{value: amount}(\\\"\\\");\\n require(success, \\\"Address: unable to send value, recipient may have reverted\\\");\\n }\\n\\n /**\\n * @dev Performs a Solidity function call using a low level `call`. A\\n * plain `call` is an unsafe replacement for a function call: use this\\n * function instead.\\n *\\n * If `target` reverts with a revert reason, it is bubbled up by this\\n * function (like regular Solidity function calls).\\n *\\n * Returns the raw returned data. To convert to the expected return value,\\n * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].\\n *\\n * Requirements:\\n *\\n * - `target` must be a contract.\\n * - calling `target` with `data` must not revert.\\n *\\n * _Available since v3.1._\\n */\\n function functionCall(address target, bytes memory data) internal returns (bytes memory) {\\n return functionCallWithValue(target, data, 0, \\\"Address: low-level call failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with\\n * `errorMessage` as a fallback revert reason when `target` reverts.\\n *\\n * _Available since v3.1._\\n */\\n function functionCall(\\n address target,\\n bytes memory data,\\n string memory errorMessage\\n ) internal returns (bytes memory) {\\n return functionCallWithValue(target, data, 0, errorMessage);\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\\n * but also transferring `value` wei to `target`.\\n *\\n * Requirements:\\n *\\n * - the calling contract must have an ETH balance of at least `value`.\\n * - the called Solidity function must be `payable`.\\n *\\n * _Available since v3.1._\\n */\\n function functionCallWithValue(address target, bytes memory data, uint256 value) internal returns (bytes memory) {\\n return functionCallWithValue(target, data, value, \\\"Address: low-level call with value failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but\\n * with `errorMessage` as a fallback revert reason when `target` reverts.\\n *\\n * _Available since v3.1._\\n */\\n function functionCallWithValue(\\n address target,\\n bytes memory data,\\n uint256 value,\\n string memory errorMessage\\n ) internal returns (bytes memory) {\\n require(address(this).balance >= value, \\\"Address: insufficient balance for call\\\");\\n (bool success, bytes memory returndata) = target.call{value: value}(data);\\n return verifyCallResultFromTarget(target, success, returndata, errorMessage);\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\\n * but performing a static call.\\n *\\n * _Available since v3.3._\\n */\\n function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {\\n return functionStaticCall(target, data, \\\"Address: low-level static call failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],\\n * but performing a static call.\\n *\\n * _Available since v3.3._\\n */\\n function functionStaticCall(\\n address target,\\n bytes memory data,\\n string memory errorMessage\\n ) internal view returns (bytes memory) {\\n (bool success, bytes memory returndata) = target.staticcall(data);\\n return verifyCallResultFromTarget(target, success, returndata, errorMessage);\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\\n * but performing a delegate call.\\n *\\n * _Available since v3.4._\\n */\\n function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) {\\n return functionDelegateCall(target, data, \\\"Address: low-level delegate call failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],\\n * but performing a delegate call.\\n *\\n * _Available since v3.4._\\n */\\n function functionDelegateCall(\\n address target,\\n bytes memory data,\\n string memory errorMessage\\n ) internal returns (bytes memory) {\\n (bool success, bytes memory returndata) = target.delegatecall(data);\\n return verifyCallResultFromTarget(target, success, returndata, errorMessage);\\n }\\n\\n /**\\n * @dev Tool to verify that a low level call to smart-contract was successful, and revert (either by bubbling\\n * the revert reason or using the provided one) in case of unsuccessful call or if target was not a contract.\\n *\\n * _Available since v4.8._\\n */\\n function verifyCallResultFromTarget(\\n address target,\\n bool success,\\n bytes memory returndata,\\n string memory errorMessage\\n ) internal view returns (bytes memory) {\\n if (success) {\\n if (returndata.length == 0) {\\n // only check isContract if the call was successful and the return data is empty\\n // otherwise we already know that it was a contract\\n require(isContract(target), \\\"Address: call to non-contract\\\");\\n }\\n return returndata;\\n } else {\\n _revert(returndata, errorMessage);\\n }\\n }\\n\\n /**\\n * @dev Tool to verify that a low level call was successful, and revert if it wasn't, either by bubbling the\\n * revert reason or using the provided one.\\n *\\n * _Available since v4.3._\\n */\\n function verifyCallResult(\\n bool success,\\n bytes memory returndata,\\n string memory errorMessage\\n ) internal pure returns (bytes memory) {\\n if (success) {\\n return returndata;\\n } else {\\n _revert(returndata, errorMessage);\\n }\\n }\\n\\n function _revert(bytes memory returndata, string memory errorMessage) private pure {\\n // Look for revert reason and bubble it up if present\\n if (returndata.length > 0) {\\n // The easiest way to bubble the revert reason is using memory via assembly\\n /// @solidity memory-safe-assembly\\n assembly {\\n let returndata_size := mload(returndata)\\n revert(add(32, returndata), returndata_size)\\n }\\n } else {\\n revert(errorMessage);\\n }\\n }\\n}\\n\",\"keccak256\":\"0x006dd67219697fe68d7fbfdea512e7c4cb64a43565ed86171d67e844982da6fa\",\"license\":\"MIT\"},\"contracts/chain-adapters/CrossDomainEnabled.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity ^0.8.0;\\n\\n/* Interface Imports */\\nimport { ICrossDomainMessenger } from \\\"@eth-optimism/contracts/libraries/bridge/ICrossDomainMessenger.sol\\\";\\n\\n/**\\n * @title CrossDomainEnabled\\n * @custom:security-contact bugs@across.to\\n * @dev Helper contract for contracts performing cross-domain communications between L1 and Optimism.\\n * @dev This modifies the eth-optimism/CrossDomainEnabled contract only by changing state variables to be\\n * immutable for use in contracts like the Optimism_Adapter which use delegateCall().\\n */\\ncontract CrossDomainEnabled {\\n // Messenger contract used to send and recieve messages from the other domain.\\n address public immutable MESSENGER;\\n\\n /**\\n * @param _messenger Address of the CrossDomainMessenger on the current layer.\\n */\\n constructor(address _messenger) {\\n MESSENGER = _messenger;\\n }\\n\\n /**\\n * Gets the messenger, usually from storage. This function is exposed in case a child contract\\n * needs to override.\\n * @return The address of the cross-domain messenger contract which should be used.\\n */\\n function getCrossDomainMessenger() internal virtual returns (ICrossDomainMessenger) {\\n return ICrossDomainMessenger(MESSENGER);\\n }\\n\\n /**\\n * Sends a message to an account on another domain\\n * @param _crossDomainTarget The intended recipient on the destination domain\\n * @param _gasLimit The gasLimit for the receipt of the message on the target domain.\\n * @param _message The data to send to the target (usually calldata to a function with\\n * onlyFromCrossDomainAccount())\\n */\\n function sendCrossDomainMessage(\\n address _crossDomainTarget,\\n uint32 _gasLimit,\\n bytes calldata _message\\n ) internal {\\n // slither-disable-next-line reentrancy-events, reentrancy-benign\\n getCrossDomainMessenger().sendMessage(_crossDomainTarget, _message, _gasLimit);\\n }\\n}\\n\",\"keccak256\":\"0xb4705bab7468a6a7a6f3c635df73ca18215d5c78986dd336ab500fd75c63789f\",\"license\":\"MIT\"},\"contracts/chain-adapters/WorldChain_Adapter.sol\":{\"content\":\"// SPDX-License-Identifier: BUSL-1.1\\npragma solidity ^0.8.0;\\n\\nimport \\\"./interfaces/AdapterInterface.sol\\\";\\nimport \\\"../external/interfaces/WETH9Interface.sol\\\";\\n\\n// @dev Use local modified CrossDomainEnabled contract instead of one exported by eth-optimism because we need\\n// this contract's state variables to be `immutable` because of the delegateCall call.\\nimport \\\"./CrossDomainEnabled.sol\\\";\\nimport \\\"@eth-optimism/contracts/L1/messaging/IL1StandardBridge.sol\\\";\\n\\nimport \\\"@openzeppelin/contracts/token/ERC20/IERC20.sol\\\";\\nimport \\\"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\\\";\\n\\nimport \\\"../libraries/CircleCCTPAdapter.sol\\\";\\nimport \\\"../external/interfaces/CCTPInterfaces.sol\\\";\\n\\n/**\\n * @notice Contract containing logic to send messages from L1 to World Chain. This is a clone of the Base/Mode adapter\\n * @dev Public functions calling external contracts do not guard against reentrancy because they are expected to be\\n * called via delegatecall, which will execute this contract's logic within the context of the originating contract.\\n * For example, the HubPool will delegatecall these functions, therefore its only necessary that the HubPool's methods\\n * that call this contract's logic guard against reentrancy.\\n * @custom:security-contact bugs@across.to\\n */\\n\\n// solhint-disable-next-line contract-name-camelcase\\ncontract WorldChain_Adapter is CrossDomainEnabled, AdapterInterface, CircleCCTPAdapter {\\n using SafeERC20 for IERC20;\\n uint32 public constant L2_GAS_LIMIT = 200_000;\\n\\n WETH9Interface public immutable L1_WETH;\\n\\n IL1StandardBridge public immutable L1_STANDARD_BRIDGE;\\n\\n /**\\n * @notice Constructs new Adapter.\\n * @param _l1Weth WETH address on L1.\\n * @param _crossDomainMessenger XDomainMessenger World Chain system contract.\\n * @param _l1StandardBridge Standard bridge contract.\\n * @param _l1Usdc USDC address on L1.\\n */\\n constructor(\\n WETH9Interface _l1Weth,\\n address _crossDomainMessenger,\\n IL1StandardBridge _l1StandardBridge,\\n IERC20 _l1Usdc\\n )\\n CrossDomainEnabled(_crossDomainMessenger)\\n CircleCCTPAdapter(\\n _l1Usdc,\\n // Hardcode cctp messenger to 0x0 to disable CCTP bridging.\\n ITokenMessenger(address(0)),\\n CircleDomainIds.UNINTIALIZED\\n )\\n {\\n L1_WETH = _l1Weth;\\n L1_STANDARD_BRIDGE = _l1StandardBridge;\\n }\\n\\n /**\\n * @notice Send cross-chain message to target on World Chain.\\n * @param target Contract on World Chain that will receive message.\\n * @param message Data to send to target.\\n */\\n function relayMessage(address target, bytes calldata message) external payable override {\\n sendCrossDomainMessage(target, L2_GAS_LIMIT, message);\\n emit MessageRelayed(target, message);\\n }\\n\\n /**\\n * @notice Bridge tokens to World Chain.\\n * @param l1Token L1 token to deposit.\\n * @param l2Token L2 token to receive.\\n * @param amount Amount of L1 tokens to deposit and L2 tokens to receive.\\n * @param to Bridge recipient.\\n */\\n function relayTokens(\\n address l1Token,\\n address l2Token,\\n uint256 amount,\\n address to\\n ) external payable override {\\n // If the l1Token is weth then unwrap it to ETH then send the ETH to the standard bridge.\\n if (l1Token == address(L1_WETH)) {\\n L1_WETH.withdraw(amount);\\n L1_STANDARD_BRIDGE.depositETHTo{ value: amount }(to, L2_GAS_LIMIT, \\\"\\\");\\n }\\n // Check if this token is USDC, which requires a custom bridge via CCTP.\\n else if (_isCCTPEnabled() && l1Token == address(usdcToken)) {\\n _transferUsdc(to, amount);\\n } else {\\n IL1StandardBridge _l1StandardBridge = L1_STANDARD_BRIDGE;\\n\\n IERC20(l1Token).safeIncreaseAllowance(address(_l1StandardBridge), amount);\\n _l1StandardBridge.depositERC20To(l1Token, l2Token, to, amount, L2_GAS_LIMIT, \\\"\\\");\\n }\\n emit TokensRelayed(l1Token, l2Token, amount, to);\\n }\\n}\\n\",\"keccak256\":\"0x567edccdee74b7e8e273a2d66e1f0121c777df349f79adc88483163242b59f77\",\"license\":\"BUSL-1.1\"},\"contracts/chain-adapters/interfaces/AdapterInterface.sol\":{\"content\":\"// SPDX-License-Identifier: BUSL-1.1\\npragma solidity ^0.8.0;\\n\\n/**\\n * @notice Sends cross chain messages and tokens to contracts on a specific L2 network.\\n * This interface is implemented by an adapter contract that is deployed on L1.\\n */\\n\\ninterface AdapterInterface {\\n event MessageRelayed(address target, bytes message);\\n\\n event TokensRelayed(address l1Token, address l2Token, uint256 amount, address to);\\n\\n /**\\n * @notice Send message to `target` on L2.\\n * @dev This method is marked payable because relaying the message might require a fee\\n * to be paid by the sender to forward the message to L2. However, it will not send msg.value\\n * to the target contract on L2.\\n * @param target L2 address to send message to.\\n * @param message Message to send to `target`.\\n */\\n function relayMessage(address target, bytes calldata message) external payable;\\n\\n /**\\n * @notice Send `amount` of `l1Token` to `to` on L2. `l2Token` is the L2 address equivalent of `l1Token`.\\n * @dev This method is marked payable because relaying the message might require a fee\\n * to be paid by the sender to forward the message to L2. However, it will not send msg.value\\n * to the target contract on L2.\\n * @param l1Token L1 token to bridge.\\n * @param l2Token L2 token to receive.\\n * @param amount Amount of `l1Token` to bridge.\\n * @param to Bridge recipient.\\n */\\n function relayTokens(\\n address l1Token,\\n address l2Token,\\n uint256 amount,\\n address to\\n ) external payable;\\n}\\n\",\"keccak256\":\"0x1d52fcb8b10dc7f260345918c1a90d496a4c9f774402cbd5ebde881b8fed6d50\",\"license\":\"BUSL-1.1\"},\"contracts/external/interfaces/CCTPInterfaces.sol\":{\"content\":\"/**\\n * Copyright (C) 2015, 2016, 2017 Dapphub\\n *\\n * This program is free software: you can redistribute it and/or modify\\n * it under the terms of the GNU General Public License as published by\\n * the Free Software Foundation, either version 3 of the License, or\\n * (at your option) any later version.\\n *\\n * This program is distributed in the hope that it will be useful,\\n * but WITHOUT ANY WARRANTY; without even the implied warranty of\\n * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the\\n * GNU General Public License for more details.\\n *\\n * You should have received a copy of the GNU General Public License\\n * along with this program. If not, see .\\n */\\n\\n// SPDX-License-Identifier: GPL-3.0-or-later\\npragma solidity ^0.8.0;\\n\\n/**\\n * Imported as-is from commit 139d8d0ce3b5531d3c7ec284f89d946dfb720016 of:\\n * * https://github.com/walkerq/evm-cctp-contracts/blob/139d8d0ce3b5531d3c7ec284f89d946dfb720016/src/TokenMessenger.sol\\n * Changes applied post-import:\\n * * Removed a majority of code from this contract and converted the needed function signatures in this interface.\\n */\\ninterface ITokenMessenger {\\n /**\\n * @notice Deposits and burns tokens from sender to be minted on destination domain.\\n * Emits a `DepositForBurn` event.\\n * @dev reverts if:\\n * - given burnToken is not supported\\n * - given destinationDomain has no TokenMessenger registered\\n * - transferFrom() reverts. For example, if sender's burnToken balance or approved allowance\\n * to this contract is less than `amount`.\\n * - burn() reverts. For example, if `amount` is 0.\\n * - MessageTransmitter returns false or reverts.\\n * @param amount amount of tokens to burn\\n * @param destinationDomain destination domain\\n * @param mintRecipient address of mint recipient on destination domain\\n * @param burnToken address of contract to burn deposited tokens, on local domain\\n * @return _nonce unique nonce reserved by message\\n */\\n function depositForBurn(\\n uint256 amount,\\n uint32 destinationDomain,\\n bytes32 mintRecipient,\\n address burnToken\\n ) external returns (uint64 _nonce);\\n\\n /**\\n * @notice Minter responsible for minting and burning tokens on the local domain\\n * @dev A TokenMessenger stores a TokenMinter contract which extends the TokenController contract.\\n * https://github.com/circlefin/evm-cctp-contracts/blob/817397db0a12963accc08ff86065491577bbc0e5/src/TokenMessenger.sol#L110\\n * @return minter Token Minter contract.\\n */\\n function localMinter() external view returns (ITokenMinter minter);\\n}\\n\\n/**\\n * A TokenMessenger stores a TokenMinter contract which extends the TokenController contract. The TokenController\\n * contract has a burnLimitsPerMessage public mapping which can be queried to find the per-message burn limit\\n * for a given token:\\n * https://github.com/circlefin/evm-cctp-contracts/blob/817397db0a12963accc08ff86065491577bbc0e5/src/TokenMinter.sol#L33\\n * https://github.com/circlefin/evm-cctp-contracts/blob/817397db0a12963accc08ff86065491577bbc0e5/src/roles/TokenController.sol#L69C40-L69C60\\n *\\n */\\ninterface ITokenMinter {\\n /**\\n * @notice Supported burnable tokens on the local domain\\n * local token (address) => maximum burn amounts per message\\n * @param token address of token contract\\n * @return burnLimit maximum burn amount per message for token\\n */\\n function burnLimitsPerMessage(address token) external view returns (uint256);\\n}\\n\",\"keccak256\":\"0x9d6606bb3b0c52bcdbe834d4bc2cb97db6bfd2a906178598f5891d662d0450bd\",\"license\":\"GPL-3.0-or-later\"},\"contracts/external/interfaces/WETH9Interface.sol\":{\"content\":\"// SPDX-License-Identifier: BUSL-1.1\\npragma solidity ^0.8.0;\\n\\n/**\\n * @notice Interface for the WETH9 contract.\\n */\\ninterface WETH9Interface {\\n /**\\n * @notice Burn Wrapped Ether and receive native Ether.\\n * @param wad Amount of WETH to unwrap and send to caller.\\n */\\n function withdraw(uint256 wad) external;\\n\\n /**\\n * @notice Lock native Ether and mint Wrapped Ether ERC20\\n * @dev msg.value is amount of Wrapped Ether to mint/Ether to lock.\\n */\\n function deposit() external payable;\\n\\n /**\\n * @notice Get balance of WETH held by `guy`.\\n * @param guy Address to get balance of.\\n * @return wad Amount of WETH held by `guy`.\\n */\\n function balanceOf(address guy) external view returns (uint256 wad);\\n\\n /**\\n * @notice Transfer `wad` of WETH from caller to `guy`.\\n * @param guy Address to send WETH to.\\n * @param wad Amount of WETH to send.\\n * @return ok True if transfer succeeded.\\n */\\n function transfer(address guy, uint256 wad) external returns (bool);\\n}\\n\",\"keccak256\":\"0x3f7892554ec7f54681fdd3cc18a41346c246c9c1afba016c52990ef77741f718\",\"license\":\"BUSL-1.1\"},\"contracts/libraries/CircleCCTPAdapter.sol\":{\"content\":\"// SPDX-License-Identifier: BUSL-1.1\\npragma solidity ^0.8.0;\\n\\nimport \\\"@openzeppelin/contracts/token/ERC20/IERC20.sol\\\";\\nimport \\\"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\\\";\\nimport \\\"../external/interfaces/CCTPInterfaces.sol\\\";\\n\\nlibrary CircleDomainIds {\\n uint32 public constant Ethereum = 0;\\n uint32 public constant Optimism = 2;\\n uint32 public constant Arbitrum = 3;\\n uint32 public constant Base = 6;\\n uint32 public constant Polygon = 7;\\n // Use this value for placeholder purposes only for adapters that extend this adapter but haven't yet been\\n // assigned a domain ID by Circle.\\n uint32 public constant UNINTIALIZED = type(uint32).max;\\n}\\n\\n/**\\n * @notice Facilitate bridging USDC via Circle's CCTP.\\n * @dev This contract is intended to be inherited by other chain-specific adapters and spoke pools.\\n * @custom:security-contact bugs@across.to\\n */\\nabstract contract CircleCCTPAdapter {\\n using SafeERC20 for IERC20;\\n\\n /**\\n * @notice The domain ID that CCTP will transfer funds to.\\n * @dev This identifier is assigned by Circle and is not related to a chain ID.\\n * @dev Official domain list can be found here: https://developers.circle.com/stablecoins/docs/supported-domains\\n */\\n /// @custom:oz-upgrades-unsafe-allow state-variable-immutable\\n uint32 public immutable recipientCircleDomainId;\\n\\n /**\\n * @notice The official USDC contract address on this chain.\\n * @dev Posted officially here: https://developers.circle.com/stablecoins/docs/usdc-on-main-networks\\n */\\n /// @custom:oz-upgrades-unsafe-allow state-variable-immutable\\n IERC20 public immutable usdcToken;\\n\\n /**\\n * @notice The official Circle CCTP token bridge contract endpoint.\\n * @dev Posted officially here: https://developers.circle.com/stablecoins/docs/evm-smart-contracts\\n */\\n /// @custom:oz-upgrades-unsafe-allow state-variable-immutable\\n ITokenMessenger public immutable cctpTokenMessenger;\\n\\n /**\\n * @notice intiailizes the CircleCCTPAdapter contract.\\n * @param _usdcToken USDC address on the current chain.\\n * @param _cctpTokenMessenger TokenMessenger contract to bridge via CCTP. If the zero address is passed, CCTP bridging will be disabled.\\n * @param _recipientCircleDomainId The domain ID that CCTP will transfer funds to.\\n */\\n /// @custom:oz-upgrades-unsafe-allow constructor\\n constructor(\\n IERC20 _usdcToken,\\n ITokenMessenger _cctpTokenMessenger,\\n uint32 _recipientCircleDomainId\\n ) {\\n usdcToken = _usdcToken;\\n cctpTokenMessenger = _cctpTokenMessenger;\\n recipientCircleDomainId = _recipientCircleDomainId;\\n }\\n\\n /**\\n * @notice converts address to bytes32 (alignment preserving cast.)\\n * @param addr the address to convert to bytes32\\n * @dev Sourced from the official CCTP repo: https://github.com/walkerq/evm-cctp-contracts/blob/139d8d0ce3b5531d3c7ec284f89d946dfb720016/src/messages/Message.sol#L142C1-L148C6\\n */\\n function _addressToBytes32(address addr) internal pure returns (bytes32) {\\n return bytes32(uint256(uint160(addr)));\\n }\\n\\n /**\\n * @notice Returns whether or not the CCTP bridge is enabled.\\n * @dev If the CCTPTokenMessenger is the zero address, CCTP bridging is disabled.\\n */\\n function _isCCTPEnabled() internal view returns (bool) {\\n return address(cctpTokenMessenger) != address(0);\\n }\\n\\n /**\\n * @notice Transfers USDC from the current domain to the given address on the new domain.\\n * @dev This function will revert if the CCTP bridge is disabled. I.e. if the zero address is passed to the constructor for the cctpTokenMessenger.\\n * @param to Address to receive USDC on the new domain.\\n * @param amount Amount of USDC to transfer.\\n */\\n function _transferUsdc(address to, uint256 amount) internal {\\n // Only approve the exact amount to be transferred\\n usdcToken.safeIncreaseAllowance(address(cctpTokenMessenger), amount);\\n // Submit the amount to be transferred to bridged via the TokenMessenger.\\n // If the amount to send exceeds the burn limit per message, then split the message into smaller parts.\\n ITokenMinter cctpMinter = cctpTokenMessenger.localMinter();\\n uint256 burnLimit = cctpMinter.burnLimitsPerMessage(address(usdcToken));\\n uint256 remainingAmount = amount;\\n bytes32 recipient = _addressToBytes32(to);\\n while (remainingAmount > 0) {\\n uint256 partAmount = remainingAmount > burnLimit ? burnLimit : remainingAmount;\\n cctpTokenMessenger.depositForBurn(partAmount, recipientCircleDomainId, recipient, address(usdcToken));\\n remainingAmount -= partAmount;\\n }\\n }\\n}\\n\",\"keccak256\":\"0x04481a0fe0c4a39c047d485a1f7563b737417fadb6cb42ceb4d0b286493d8124\",\"license\":\"BUSL-1.1\"}},\"version\":1}",
+ "bytecode": "0x6101403461012a57601f61120c38819003918201601f19168301916001600160401b0383118484101761012e5780849260809460405283398101031261012a578051906001600160a01b03808316830361012a576020820151818116810361012a57604083015192828416840361012a5760600151918216820361012a5760805260c0525f60e05263ffffffff60a052610100918252610120908152604051906110c99283610143843960805183818161010901526102be015260a05183818161031d0152610751015260c05183818161061a01528181610b750152610cd6015260e05183818161024f015281816105eb01528181610656015281816106bf01526108570152518281816104090152610c6a0152518181816104ab015281816109c60152610bfc0152f35b5f80fd5b634e487b7160e01b5f52604160045260245ffdfe6080806040526004361015610012575f80fd5b5f905f3560e01c90816311eac85514610c8e575080631efd482a14610c2057806335a2db6a14610bb257806352c8c75c1461037d5780635e743ef7146103415780636e400983146102e2578063927ede2d146102735780639748cf7c146102045763e6eb8ade14610081575f80fd5b60407ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffc360112610201576100b3610cfa565b6024359067ffffffffffffffff908183116101ee57366023840112156101ee5782600401359182116101ee57602483019260248336920101116101ee578373ffffffffffffffffffffffffffffffffffffffff807f00000000000000000000000000000000000000000000000000000000000000001692833b156101fd5782906040519283917f3dbb202b00000000000000000000000000000000000000000000000000000000835216948560048301526060602483015281838161017c606482018b8d610d9f565b62030d40604483015203925af180156101f2576101da575b50506101d47f9e6c52944e331ba6270e7fe4cea2a4086bae8f7a27e1cdba07f416806f5d0ac4936040519384938452604060208501526040840191610d9f565b0390a180f35b6101e390610d1d565b6101ee57835f610194565b8380fd5b6040513d84823e3d90fd5b8280fd5b80fd5b503461020157807ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffc36011261020157602060405173ffffffffffffffffffffffffffffffffffffffff7f0000000000000000000000000000000000000000000000000000000000000000168152f35b503461020157807ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffc36011261020157602060405173ffffffffffffffffffffffffffffffffffffffff7f0000000000000000000000000000000000000000000000000000000000000000168152f35b503461020157807ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffc36011261020157602060405163ffffffff7f0000000000000000000000000000000000000000000000000000000000000000168152f35b503461020157807ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffc36011261020157602060405162030d408152f35b5060807ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffc360112610944576103b0610cfa565b60243573ffffffffffffffffffffffffffffffffffffffff81168103610944576064359073ffffffffffffffffffffffffffffffffffffffff82168203610944578373ffffffffffffffffffffffffffffffffffffffff7f0000000000000000000000000000000000000000000000000000000000000000168073ffffffffffffffffffffffffffffffffffffffff8616145f146105d257803b156105ba578180916024604051809481937f2e1a7d4d00000000000000000000000000000000000000000000000000000000835260443560048401525af180156101f2576105be575b5073ffffffffffffffffffffffffffffffffffffffff7f000000000000000000000000000000000000000000000000000000000000000016803b156105ba5781608491604051928380927f9a2ac6d500000000000000000000000000000000000000000000000000000000825273ffffffffffffffffffffffffffffffffffffffff8916600483015262030d40602483015260606044830152846064830152604435905af180156101f2576105a2575b50509173ffffffffffffffffffffffffffffffffffffffff608092817fd7e09655439c3932e55857df3220186e5a7f0980825f20691c2b35d941dee75b955b81604051951685521660208401526044356040840152166060820152a180f35b6105ae90949294610d1d565b6101ee5791835f610543565b5080fd5b6105c790610d1d565b6101ee57835f610493565b505073ffffffffffffffffffffffffffffffffffffffff7f000000000000000000000000000000000000000000000000000000000000000016151580610b5d575b156109af577f000000000000000000000000000000000000000000000000000000000000000061067c60443573ffffffffffffffffffffffffffffffffffffffff7f00000000000000000000000000000000000000000000000000000000000000001683610ddd565b6040517fcb75c11c00000000000000000000000000000000000000000000000000000000815260208160048173ffffffffffffffffffffffffffffffffffffffff7f0000000000000000000000000000000000000000000000000000000000000000165afa90811561095057869161095b575b50602073ffffffffffffffffffffffffffffffffffffffff916024604051809481937fa56ec6320000000000000000000000000000000000000000000000000000000083528188166004840152165afa90811561095057869161091a575b50907f000000000000000000000000000000000000000000000000000000000000000063ffffffff1690604435805b6107c557505050509173ffffffffffffffffffffffffffffffffffffffff608092817fd7e09655439c3932e55857df3220186e5a7f0980825f20691c2b35d941dee75b95610582565b8381111561091457835b6040517f6fd3504e00000000000000000000000000000000000000000000000000000000815281600482015284602482015273ffffffffffffffffffffffffffffffffffffffff8816604482015273ffffffffffffffffffffffffffffffffffffffff841660648201526020816084818d73ffffffffffffffffffffffffffffffffffffffff7f0000000000000000000000000000000000000000000000000000000000000000165af18015610909576108c1575b508103908111610894578061077c565b6024887f4e487b710000000000000000000000000000000000000000000000000000000081526011600452fd5b6020813d602011610901575b816108da60209383610d5e565b810103126108fd575167ffffffffffffffff8116036108f9575f610884565b8880fd5b8980fd5b3d91506108cd565b6040513d8c823e3d90fd5b806107cf565b90506020813d602011610948575b8161093560209383610d5e565b8101031261094457515f61074d565b5f80fd5b3d9150610928565b6040513d88823e3d90fd5b90506020813d6020116109a7575b8161097660209383610d5e565b810103126109a3575173ffffffffffffffffffffffffffffffffffffffff811681036109a35760206106ef565b8580fd5b3d9150610969565b73ffffffffffffffffffffffffffffffffffffffff7f000000000000000000000000000000000000000000000000000000000000000016610a096044358273ffffffffffffffffffffffffffffffffffffffff8716610ddd565b803b15610944575f809160e4604051809481937f838b252000000000000000000000000000000000000000000000000000000000835273ffffffffffffffffffffffffffffffffffffffff8a16600484015273ffffffffffffffffffffffffffffffffffffffff8816602484015273ffffffffffffffffffffffffffffffffffffffff89166044840152604435606484015262030d40608484015260c060a48401528160c48401525af18015610b5257610b00575b509173ffffffffffffffffffffffffffffffffffffffff608092817fd7e09655439c3932e55857df3220186e5a7f0980825f20691c2b35d941dee75b95610582565b7fd7e09655439c3932e55857df3220186e5a7f0980825f20691c2b35d941dee75b93919450608092610b4673ffffffffffffffffffffffffffffffffffffffff92610d1d565b5f959294509250610abe565b6040513d5f823e3d90fd5b5073ffffffffffffffffffffffffffffffffffffffff7f00000000000000000000000000000000000000000000000000000000000000001673ffffffffffffffffffffffffffffffffffffffff841614610613565b34610944575f7ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffc36011261094457602060405173ffffffffffffffffffffffffffffffffffffffff7f0000000000000000000000000000000000000000000000000000000000000000168152f35b34610944575f7ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffc36011261094457602060405173ffffffffffffffffffffffffffffffffffffffff7f0000000000000000000000000000000000000000000000000000000000000000168152f35b34610944575f7ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffc3601126109445760209073ffffffffffffffffffffffffffffffffffffffff7f0000000000000000000000000000000000000000000000000000000000000000168152f35b6004359073ffffffffffffffffffffffffffffffffffffffff8216820361094457565b67ffffffffffffffff8111610d3157604052565b7f4e487b71000000000000000000000000000000000000000000000000000000005f52604160045260245ffd5b90601f7fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe0910116810190811067ffffffffffffffff821117610d3157604052565b601f82602094937fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe093818652868601375f8582860101520116010190565b9291909273ffffffffffffffffffffffffffffffffffffffff809116604051917fdd62ed3e000000000000000000000000000000000000000000000000000000008352306004840152602495169182868201526020938482604481865afa918215610b52575f9261103b575b50810180911161100f5760405190848201937f095ea7b3000000000000000000000000000000000000000000000000000000008552878301526044820152604481526080810167ffffffffffffffff9382821085831117610fe35760c083019282841086851117610fb757865f94938594604052527f5361666545524332303a206c6f772d6c6576656c2063616c6c206661696c656460a0820152519082855af1903d15610fa6573d928311610f7a57610f429394955060405192610f35867fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe0601f8401160185610d5e565b83523d5f8685013e61106a565b8051918215918215610f5a575b505090501561094457565b809250819381010312610944570151801515810361094457805f80610f4f565b857f4e487b71000000000000000000000000000000000000000000000000000000005f5260416004525ffd5b9150610f429293945060609161106a565b887f4e487b71000000000000000000000000000000000000000000000000000000005f5260416004525ffd5b877f4e487b71000000000000000000000000000000000000000000000000000000005f5260416004525ffd5b857f4e487b71000000000000000000000000000000000000000000000000000000005f5260116004525ffd5b9091508481813d8311611063575b6110538183610d5e565b810103126109445751905f610e49565b503d611049565b90156110845781511561107b575090565b3b156109445790565b50805190811561094457602001fdfea264697066735822122042611080eed14bdd9ceb7063618bca3deb8c206010dc935a7de83e2b1e5eb8f164736f6c63430008170033",
+ "deployedBytecode": "0x6080806040526004361015610012575f80fd5b5f905f3560e01c90816311eac85514610c8e575080631efd482a14610c2057806335a2db6a14610bb257806352c8c75c1461037d5780635e743ef7146103415780636e400983146102e2578063927ede2d146102735780639748cf7c146102045763e6eb8ade14610081575f80fd5b60407ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffc360112610201576100b3610cfa565b6024359067ffffffffffffffff908183116101ee57366023840112156101ee5782600401359182116101ee57602483019260248336920101116101ee578373ffffffffffffffffffffffffffffffffffffffff807f00000000000000000000000000000000000000000000000000000000000000001692833b156101fd5782906040519283917f3dbb202b00000000000000000000000000000000000000000000000000000000835216948560048301526060602483015281838161017c606482018b8d610d9f565b62030d40604483015203925af180156101f2576101da575b50506101d47f9e6c52944e331ba6270e7fe4cea2a4086bae8f7a27e1cdba07f416806f5d0ac4936040519384938452604060208501526040840191610d9f565b0390a180f35b6101e390610d1d565b6101ee57835f610194565b8380fd5b6040513d84823e3d90fd5b8280fd5b80fd5b503461020157807ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffc36011261020157602060405173ffffffffffffffffffffffffffffffffffffffff7f0000000000000000000000000000000000000000000000000000000000000000168152f35b503461020157807ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffc36011261020157602060405173ffffffffffffffffffffffffffffffffffffffff7f0000000000000000000000000000000000000000000000000000000000000000168152f35b503461020157807ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffc36011261020157602060405163ffffffff7f0000000000000000000000000000000000000000000000000000000000000000168152f35b503461020157807ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffc36011261020157602060405162030d408152f35b5060807ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffc360112610944576103b0610cfa565b60243573ffffffffffffffffffffffffffffffffffffffff81168103610944576064359073ffffffffffffffffffffffffffffffffffffffff82168203610944578373ffffffffffffffffffffffffffffffffffffffff7f0000000000000000000000000000000000000000000000000000000000000000168073ffffffffffffffffffffffffffffffffffffffff8616145f146105d257803b156105ba578180916024604051809481937f2e1a7d4d00000000000000000000000000000000000000000000000000000000835260443560048401525af180156101f2576105be575b5073ffffffffffffffffffffffffffffffffffffffff7f000000000000000000000000000000000000000000000000000000000000000016803b156105ba5781608491604051928380927f9a2ac6d500000000000000000000000000000000000000000000000000000000825273ffffffffffffffffffffffffffffffffffffffff8916600483015262030d40602483015260606044830152846064830152604435905af180156101f2576105a2575b50509173ffffffffffffffffffffffffffffffffffffffff608092817fd7e09655439c3932e55857df3220186e5a7f0980825f20691c2b35d941dee75b955b81604051951685521660208401526044356040840152166060820152a180f35b6105ae90949294610d1d565b6101ee5791835f610543565b5080fd5b6105c790610d1d565b6101ee57835f610493565b505073ffffffffffffffffffffffffffffffffffffffff7f000000000000000000000000000000000000000000000000000000000000000016151580610b5d575b156109af577f000000000000000000000000000000000000000000000000000000000000000061067c60443573ffffffffffffffffffffffffffffffffffffffff7f00000000000000000000000000000000000000000000000000000000000000001683610ddd565b6040517fcb75c11c00000000000000000000000000000000000000000000000000000000815260208160048173ffffffffffffffffffffffffffffffffffffffff7f0000000000000000000000000000000000000000000000000000000000000000165afa90811561095057869161095b575b50602073ffffffffffffffffffffffffffffffffffffffff916024604051809481937fa56ec6320000000000000000000000000000000000000000000000000000000083528188166004840152165afa90811561095057869161091a575b50907f000000000000000000000000000000000000000000000000000000000000000063ffffffff1690604435805b6107c557505050509173ffffffffffffffffffffffffffffffffffffffff608092817fd7e09655439c3932e55857df3220186e5a7f0980825f20691c2b35d941dee75b95610582565b8381111561091457835b6040517f6fd3504e00000000000000000000000000000000000000000000000000000000815281600482015284602482015273ffffffffffffffffffffffffffffffffffffffff8816604482015273ffffffffffffffffffffffffffffffffffffffff841660648201526020816084818d73ffffffffffffffffffffffffffffffffffffffff7f0000000000000000000000000000000000000000000000000000000000000000165af18015610909576108c1575b508103908111610894578061077c565b6024887f4e487b710000000000000000000000000000000000000000000000000000000081526011600452fd5b6020813d602011610901575b816108da60209383610d5e565b810103126108fd575167ffffffffffffffff8116036108f9575f610884565b8880fd5b8980fd5b3d91506108cd565b6040513d8c823e3d90fd5b806107cf565b90506020813d602011610948575b8161093560209383610d5e565b8101031261094457515f61074d565b5f80fd5b3d9150610928565b6040513d88823e3d90fd5b90506020813d6020116109a7575b8161097660209383610d5e565b810103126109a3575173ffffffffffffffffffffffffffffffffffffffff811681036109a35760206106ef565b8580fd5b3d9150610969565b73ffffffffffffffffffffffffffffffffffffffff7f000000000000000000000000000000000000000000000000000000000000000016610a096044358273ffffffffffffffffffffffffffffffffffffffff8716610ddd565b803b15610944575f809160e4604051809481937f838b252000000000000000000000000000000000000000000000000000000000835273ffffffffffffffffffffffffffffffffffffffff8a16600484015273ffffffffffffffffffffffffffffffffffffffff8816602484015273ffffffffffffffffffffffffffffffffffffffff89166044840152604435606484015262030d40608484015260c060a48401528160c48401525af18015610b5257610b00575b509173ffffffffffffffffffffffffffffffffffffffff608092817fd7e09655439c3932e55857df3220186e5a7f0980825f20691c2b35d941dee75b95610582565b7fd7e09655439c3932e55857df3220186e5a7f0980825f20691c2b35d941dee75b93919450608092610b4673ffffffffffffffffffffffffffffffffffffffff92610d1d565b5f959294509250610abe565b6040513d5f823e3d90fd5b5073ffffffffffffffffffffffffffffffffffffffff7f00000000000000000000000000000000000000000000000000000000000000001673ffffffffffffffffffffffffffffffffffffffff841614610613565b34610944575f7ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffc36011261094457602060405173ffffffffffffffffffffffffffffffffffffffff7f0000000000000000000000000000000000000000000000000000000000000000168152f35b34610944575f7ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffc36011261094457602060405173ffffffffffffffffffffffffffffffffffffffff7f0000000000000000000000000000000000000000000000000000000000000000168152f35b34610944575f7ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffc3601126109445760209073ffffffffffffffffffffffffffffffffffffffff7f0000000000000000000000000000000000000000000000000000000000000000168152f35b6004359073ffffffffffffffffffffffffffffffffffffffff8216820361094457565b67ffffffffffffffff8111610d3157604052565b7f4e487b71000000000000000000000000000000000000000000000000000000005f52604160045260245ffd5b90601f7fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe0910116810190811067ffffffffffffffff821117610d3157604052565b601f82602094937fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe093818652868601375f8582860101520116010190565b9291909273ffffffffffffffffffffffffffffffffffffffff809116604051917fdd62ed3e000000000000000000000000000000000000000000000000000000008352306004840152602495169182868201526020938482604481865afa918215610b52575f9261103b575b50810180911161100f5760405190848201937f095ea7b3000000000000000000000000000000000000000000000000000000008552878301526044820152604481526080810167ffffffffffffffff9382821085831117610fe35760c083019282841086851117610fb757865f94938594604052527f5361666545524332303a206c6f772d6c6576656c2063616c6c206661696c656460a0820152519082855af1903d15610fa6573d928311610f7a57610f429394955060405192610f35867fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe0601f8401160185610d5e565b83523d5f8685013e61106a565b8051918215918215610f5a575b505090501561094457565b809250819381010312610944570151801515810361094457805f80610f4f565b857f4e487b71000000000000000000000000000000000000000000000000000000005f5260416004525ffd5b9150610f429293945060609161106a565b887f4e487b71000000000000000000000000000000000000000000000000000000005f5260416004525ffd5b877f4e487b71000000000000000000000000000000000000000000000000000000005f5260416004525ffd5b857f4e487b71000000000000000000000000000000000000000000000000000000005f5260116004525ffd5b9091508481813d8311611063575b6110538183610d5e565b810103126109445751905f610e49565b503d611049565b90156110845781511561107b575090565b3b156109445790565b50805190811561094457602001fdfea264697066735822122042611080eed14bdd9ceb7063618bca3deb8c206010dc935a7de83e2b1e5eb8f164736f6c63430008170033",
"devdoc": {
"custom:security-contact": "bugs@across.to",
"details": "Public functions calling external contracts do not guard against reentrancy because they are expected to be called via delegatecall, which will execute this contract's logic within the context of the originating contract. For example, the HubPool will delegatecall these functions, therefore its only necessary that the HubPool's methods that call this contract's logic guard against reentrancy.",
@@ -268,8 +249,7 @@
"methods": {
"constructor": {
"params": {
- "_cctpTokenMessenger": "TokenMessenger contract to bridge via CCTP.",
- "_crossDomainMessenger": "XDomainMessenger Doctor Who system contract.",
+ "_crossDomainMessenger": "XDomainMessenger World Chain system contract.",
"_l1StandardBridge": "Standard bridge contract.",
"_l1Usdc": "USDC address on L1.",
"_l1Weth": "WETH address on L1."
@@ -278,7 +258,7 @@
"relayMessage(address,bytes)": {
"params": {
"message": "Data to send to target.",
- "target": "Contract on Doctor Who that will receive message."
+ "target": "Contract on World Chain that will receive message."
}
},
"relayTokens(address,address,uint256,address)": {
@@ -299,13 +279,13 @@
"notice": "Constructs new Adapter."
},
"relayMessage(address,bytes)": {
- "notice": "Send cross-chain message to target on Doctor Who."
+ "notice": "Send cross-chain message to target on World Chain."
},
"relayTokens(address,address,uint256,address)": {
- "notice": "Bridge tokens to Doctor Who."
+ "notice": "Bridge tokens to World Chain."
}
},
- "notice": "Contract containing logic to send messages from L1 to Doctor Who. This is a modified version of the Optimism adapter that excludes the custom bridging logic.",
+ "notice": "Contract containing logic to send messages from L1 to World Chain. This is a clone of the Base/Mode adapter",
"version": 1
},
"storageLayout": {
diff --git a/deployments/mainnet/solcInputs/dc324d2c58d7b0ed46f2033874127662.json b/deployments/mainnet/solcInputs/dc324d2c58d7b0ed46f2033874127662.json
deleted file mode 100644
index 5b08322f8..000000000
--- a/deployments/mainnet/solcInputs/dc324d2c58d7b0ed46f2033874127662.json
+++ /dev/null
@@ -1,316 +0,0 @@
-{
- "language": "Solidity",
- "sources": {
- "@eth-optimism/contracts/L1/messaging/IL1ERC20Bridge.sol": {
- "content": "// SPDX-License-Identifier: MIT\npragma solidity >0.5.0 <0.9.0;\n\n/**\n * @title IL1ERC20Bridge\n */\ninterface IL1ERC20Bridge {\n /**********\n * Events *\n **********/\n\n event ERC20DepositInitiated(\n address indexed _l1Token,\n address indexed _l2Token,\n address indexed _from,\n address _to,\n uint256 _amount,\n bytes _data\n );\n\n event ERC20WithdrawalFinalized(\n address indexed _l1Token,\n address indexed _l2Token,\n address indexed _from,\n address _to,\n uint256 _amount,\n bytes _data\n );\n\n /********************\n * Public Functions *\n ********************/\n\n /**\n * @dev get the address of the corresponding L2 bridge contract.\n * @return Address of the corresponding L2 bridge contract.\n */\n function l2TokenBridge() external returns (address);\n\n /**\n * @dev deposit an amount of the ERC20 to the caller's balance on L2.\n * @param _l1Token Address of the L1 ERC20 we are depositing\n * @param _l2Token Address of the L1 respective L2 ERC20\n * @param _amount Amount of the ERC20 to deposit\n * @param _l2Gas Gas limit required to complete the deposit on L2.\n * @param _data Optional data to forward to L2. This data is provided\n * solely as a convenience for external contracts. Aside from enforcing a maximum\n * length, these contracts provide no guarantees about its content.\n */\n function depositERC20(\n address _l1Token,\n address _l2Token,\n uint256 _amount,\n uint32 _l2Gas,\n bytes calldata _data\n ) external;\n\n /**\n * @dev deposit an amount of ERC20 to a recipient's balance on L2.\n * @param _l1Token Address of the L1 ERC20 we are depositing\n * @param _l2Token Address of the L1 respective L2 ERC20\n * @param _to L2 address to credit the withdrawal to.\n * @param _amount Amount of the ERC20 to deposit.\n * @param _l2Gas Gas limit required to complete the deposit on L2.\n * @param _data Optional data to forward to L2. This data is provided\n * solely as a convenience for external contracts. Aside from enforcing a maximum\n * length, these contracts provide no guarantees about its content.\n */\n function depositERC20To(\n address _l1Token,\n address _l2Token,\n address _to,\n uint256 _amount,\n uint32 _l2Gas,\n bytes calldata _data\n ) external;\n\n /*************************\n * Cross-chain Functions *\n *************************/\n\n /**\n * @dev Complete a withdrawal from L2 to L1, and credit funds to the recipient's balance of the\n * L1 ERC20 token.\n * This call will fail if the initialized withdrawal from L2 has not been finalized.\n *\n * @param _l1Token Address of L1 token to finalizeWithdrawal for.\n * @param _l2Token Address of L2 token where withdrawal was initiated.\n * @param _from L2 address initiating the transfer.\n * @param _to L1 address to credit the withdrawal to.\n * @param _amount Amount of the ERC20 to deposit.\n * @param _data Data provided by the sender on L2. This data is provided\n * solely as a convenience for external contracts. Aside from enforcing a maximum\n * length, these contracts provide no guarantees about its content.\n */\n function finalizeERC20Withdrawal(\n address _l1Token,\n address _l2Token,\n address _from,\n address _to,\n uint256 _amount,\n bytes calldata _data\n ) external;\n}\n"
- },
- "@eth-optimism/contracts/L1/messaging/IL1StandardBridge.sol": {
- "content": "// SPDX-License-Identifier: MIT\npragma solidity >0.5.0 <0.9.0;\n\nimport \"./IL1ERC20Bridge.sol\";\n\n/**\n * @title IL1StandardBridge\n */\ninterface IL1StandardBridge is IL1ERC20Bridge {\n /**********\n * Events *\n **********/\n event ETHDepositInitiated(\n address indexed _from,\n address indexed _to,\n uint256 _amount,\n bytes _data\n );\n\n event ETHWithdrawalFinalized(\n address indexed _from,\n address indexed _to,\n uint256 _amount,\n bytes _data\n );\n\n /********************\n * Public Functions *\n ********************/\n\n /**\n * @dev Deposit an amount of the ETH to the caller's balance on L2.\n * @param _l2Gas Gas limit required to complete the deposit on L2.\n * @param _data Optional data to forward to L2. This data is provided\n * solely as a convenience for external contracts. Aside from enforcing a maximum\n * length, these contracts provide no guarantees about its content.\n */\n function depositETH(uint32 _l2Gas, bytes calldata _data) external payable;\n\n /**\n * @dev Deposit an amount of ETH to a recipient's balance on L2.\n * @param _to L2 address to credit the withdrawal to.\n * @param _l2Gas Gas limit required to complete the deposit on L2.\n * @param _data Optional data to forward to L2. This data is provided\n * solely as a convenience for external contracts. Aside from enforcing a maximum\n * length, these contracts provide no guarantees about its content.\n */\n function depositETHTo(\n address _to,\n uint32 _l2Gas,\n bytes calldata _data\n ) external payable;\n\n /*************************\n * Cross-chain Functions *\n *************************/\n\n /**\n * @dev Complete a withdrawal from L2 to L1, and credit funds to the recipient's balance of the\n * L1 ETH token. Since only the xDomainMessenger can call this function, it will never be called\n * before the withdrawal is finalized.\n * @param _from L2 address initiating the transfer.\n * @param _to L1 address to credit the withdrawal to.\n * @param _amount Amount of the ERC20 to deposit.\n * @param _data Optional data to forward to L2. This data is provided\n * solely as a convenience for external contracts. Aside from enforcing a maximum\n * length, these contracts provide no guarantees about its content.\n */\n function finalizeETHWithdrawal(\n address _from,\n address _to,\n uint256 _amount,\n bytes calldata _data\n ) external;\n}\n"
- },
- "@eth-optimism/contracts/libraries/bridge/ICrossDomainMessenger.sol": {
- "content": "// SPDX-License-Identifier: MIT\npragma solidity >0.5.0 <0.9.0;\n\n/**\n * @title ICrossDomainMessenger\n */\ninterface ICrossDomainMessenger {\n /**********\n * Events *\n **********/\n\n event SentMessage(\n address indexed target,\n address sender,\n bytes message,\n uint256 messageNonce,\n uint256 gasLimit\n );\n event RelayedMessage(bytes32 indexed msgHash);\n event FailedRelayedMessage(bytes32 indexed msgHash);\n\n /*************\n * Variables *\n *************/\n\n function xDomainMessageSender() external view returns (address);\n\n /********************\n * Public Functions *\n ********************/\n\n /**\n * Sends a cross domain message to the target messenger.\n * @param _target Target contract address.\n * @param _message Message to send to the target.\n * @param _gasLimit Gas limit for the provided message.\n */\n function sendMessage(\n address _target,\n bytes calldata _message,\n uint32 _gasLimit\n ) external;\n}\n"
- },
- "@eth-optimism/contracts/libraries/constants/Lib_PredeployAddresses.sol": {
- "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.9;\n\n/**\n * @title Lib_PredeployAddresses\n */\nlibrary Lib_PredeployAddresses {\n address internal constant L2_TO_L1_MESSAGE_PASSER = 0x4200000000000000000000000000000000000000;\n address internal constant L1_MESSAGE_SENDER = 0x4200000000000000000000000000000000000001;\n address internal constant DEPLOYER_WHITELIST = 0x4200000000000000000000000000000000000002;\n address payable internal constant OVM_ETH = payable(0xDeadDeAddeAddEAddeadDEaDDEAdDeaDDeAD0000);\n address internal constant L2_CROSS_DOMAIN_MESSENGER =\n 0x4200000000000000000000000000000000000007;\n address internal constant LIB_ADDRESS_MANAGER = 0x4200000000000000000000000000000000000008;\n address internal constant PROXY_EOA = 0x4200000000000000000000000000000000000009;\n address internal constant L2_STANDARD_BRIDGE = 0x4200000000000000000000000000000000000010;\n address internal constant SEQUENCER_FEE_WALLET = 0x4200000000000000000000000000000000000011;\n address internal constant L2_STANDARD_TOKEN_FACTORY =\n 0x4200000000000000000000000000000000000012;\n address internal constant L1_BLOCK_NUMBER = 0x4200000000000000000000000000000000000013;\n}\n"
- },
- "@openzeppelin/contracts-upgradeable/crosschain/errorsUpgradeable.sol": {
- "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.6.0) (crosschain/errors.sol)\n\npragma solidity ^0.8.4;\n\nerror NotCrossChainCall();\nerror InvalidCrossChainSender(address actual, address expected);\n"
- },
- "@openzeppelin/contracts-upgradeable/crosschain/optimism/LibOptimismUpgradeable.sol": {
- "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.7.0) (crosschain/optimism/LibOptimism.sol)\n\npragma solidity ^0.8.4;\n\nimport {ICrossDomainMessengerUpgradeable as Optimism_Bridge} from \"../../vendor/optimism/ICrossDomainMessengerUpgradeable.sol\";\nimport \"../errorsUpgradeable.sol\";\n\n/**\n * @dev Primitives for cross-chain aware contracts for https://www.optimism.io/[Optimism].\n * See the https://community.optimism.io/docs/developers/bridge/messaging/#accessing-msg-sender[documentation]\n * for the functionality used here.\n */\nlibrary LibOptimismUpgradeable {\n /**\n * @dev Returns whether the current function call is the result of a\n * cross-chain message relayed by `messenger`.\n */\n function isCrossChain(address messenger) internal view returns (bool) {\n return msg.sender == messenger;\n }\n\n /**\n * @dev Returns the address of the sender that triggered the current\n * cross-chain message through `messenger`.\n *\n * NOTE: {isCrossChain} should be checked before trying to recover the\n * sender, as it will revert with `NotCrossChainCall` if the current\n * function call is not the result of a cross-chain message.\n */\n function crossChainSender(address messenger) internal view returns (address) {\n if (!isCrossChain(messenger)) revert NotCrossChainCall();\n\n return Optimism_Bridge(messenger).xDomainMessageSender();\n }\n}\n"
- },
- "@openzeppelin/contracts-upgradeable/interfaces/draft-IERC1822Upgradeable.sol": {
- "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.5.0) (interfaces/draft-IERC1822.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @dev ERC1822: Universal Upgradeable Proxy Standard (UUPS) documents a method for upgradeability through a simplified\n * proxy whose upgrades are fully controlled by the current implementation.\n */\ninterface IERC1822ProxiableUpgradeable {\n /**\n * @dev Returns the storage slot that the proxiable contract assumes is being used to store the implementation\n * address.\n *\n * IMPORTANT: A proxy pointing at a proxiable contract should not be considered proxiable itself, because this risks\n * bricking a proxy that upgrades to it, by delegating to itself until out of gas. Thus it is critical that this\n * function revert if invoked through a proxy.\n */\n function proxiableUUID() external view returns (bytes32);\n}\n"
- },
- "@openzeppelin/contracts-upgradeable/interfaces/IERC1967Upgradeable.sol": {
- "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (interfaces/IERC1967.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @dev ERC-1967: Proxy Storage Slots. This interface contains the events defined in the ERC.\n *\n * _Available since v4.8.3._\n */\ninterface IERC1967Upgradeable {\n /**\n * @dev Emitted when the implementation is upgraded.\n */\n event Upgraded(address indexed implementation);\n\n /**\n * @dev Emitted when the admin account has changed.\n */\n event AdminChanged(address previousAdmin, address newAdmin);\n\n /**\n * @dev Emitted when the beacon is changed.\n */\n event BeaconUpgraded(address indexed beacon);\n}\n"
- },
- "@openzeppelin/contracts-upgradeable/proxy/beacon/IBeaconUpgradeable.sol": {
- "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts v4.4.1 (proxy/beacon/IBeacon.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @dev This is the interface that {BeaconProxy} expects of its beacon.\n */\ninterface IBeaconUpgradeable {\n /**\n * @dev Must return an address that can be used as a delegate call target.\n *\n * {BeaconProxy} will check that this address is a contract.\n */\n function implementation() external view returns (address);\n}\n"
- },
- "@openzeppelin/contracts-upgradeable/proxy/ERC1967/ERC1967UpgradeUpgradeable.sol": {
- "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (proxy/ERC1967/ERC1967Upgrade.sol)\n\npragma solidity ^0.8.2;\n\nimport \"../beacon/IBeaconUpgradeable.sol\";\nimport \"../../interfaces/IERC1967Upgradeable.sol\";\nimport \"../../interfaces/draft-IERC1822Upgradeable.sol\";\nimport \"../../utils/AddressUpgradeable.sol\";\nimport \"../../utils/StorageSlotUpgradeable.sol\";\nimport {Initializable} from \"../utils/Initializable.sol\";\n\n/**\n * @dev This abstract contract provides getters and event emitting update functions for\n * https://eips.ethereum.org/EIPS/eip-1967[EIP1967] slots.\n *\n * _Available since v4.1._\n */\nabstract contract ERC1967UpgradeUpgradeable is Initializable, IERC1967Upgradeable {\n // This is the keccak-256 hash of \"eip1967.proxy.rollback\" subtracted by 1\n bytes32 private constant _ROLLBACK_SLOT = 0x4910fdfa16fed3260ed0e7147f7cc6da11a60208b5b9406d12a635614ffd9143;\n\n /**\n * @dev Storage slot with the address of the current implementation.\n * This is the keccak-256 hash of \"eip1967.proxy.implementation\" subtracted by 1, and is\n * validated in the constructor.\n */\n bytes32 internal constant _IMPLEMENTATION_SLOT = 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc;\n\n function __ERC1967Upgrade_init() internal onlyInitializing {\n }\n\n function __ERC1967Upgrade_init_unchained() internal onlyInitializing {\n }\n /**\n * @dev Returns the current implementation address.\n */\n function _getImplementation() internal view returns (address) {\n return StorageSlotUpgradeable.getAddressSlot(_IMPLEMENTATION_SLOT).value;\n }\n\n /**\n * @dev Stores a new address in the EIP1967 implementation slot.\n */\n function _setImplementation(address newImplementation) private {\n require(AddressUpgradeable.isContract(newImplementation), \"ERC1967: new implementation is not a contract\");\n StorageSlotUpgradeable.getAddressSlot(_IMPLEMENTATION_SLOT).value = newImplementation;\n }\n\n /**\n * @dev Perform implementation upgrade\n *\n * Emits an {Upgraded} event.\n */\n function _upgradeTo(address newImplementation) internal {\n _setImplementation(newImplementation);\n emit Upgraded(newImplementation);\n }\n\n /**\n * @dev Perform implementation upgrade with additional setup call.\n *\n * Emits an {Upgraded} event.\n */\n function _upgradeToAndCall(address newImplementation, bytes memory data, bool forceCall) internal {\n _upgradeTo(newImplementation);\n if (data.length > 0 || forceCall) {\n AddressUpgradeable.functionDelegateCall(newImplementation, data);\n }\n }\n\n /**\n * @dev Perform implementation upgrade with security checks for UUPS proxies, and additional setup call.\n *\n * Emits an {Upgraded} event.\n */\n function _upgradeToAndCallUUPS(address newImplementation, bytes memory data, bool forceCall) internal {\n // Upgrades from old implementations will perform a rollback test. This test requires the new\n // implementation to upgrade back to the old, non-ERC1822 compliant, implementation. Removing\n // this special case will break upgrade paths from old UUPS implementation to new ones.\n if (StorageSlotUpgradeable.getBooleanSlot(_ROLLBACK_SLOT).value) {\n _setImplementation(newImplementation);\n } else {\n try IERC1822ProxiableUpgradeable(newImplementation).proxiableUUID() returns (bytes32 slot) {\n require(slot == _IMPLEMENTATION_SLOT, \"ERC1967Upgrade: unsupported proxiableUUID\");\n } catch {\n revert(\"ERC1967Upgrade: new implementation is not UUPS\");\n }\n _upgradeToAndCall(newImplementation, data, forceCall);\n }\n }\n\n /**\n * @dev Storage slot with the admin of the contract.\n * This is the keccak-256 hash of \"eip1967.proxy.admin\" subtracted by 1, and is\n * validated in the constructor.\n */\n bytes32 internal constant _ADMIN_SLOT = 0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103;\n\n /**\n * @dev Returns the current admin.\n */\n function _getAdmin() internal view returns (address) {\n return StorageSlotUpgradeable.getAddressSlot(_ADMIN_SLOT).value;\n }\n\n /**\n * @dev Stores a new address in the EIP1967 admin slot.\n */\n function _setAdmin(address newAdmin) private {\n require(newAdmin != address(0), \"ERC1967: new admin is the zero address\");\n StorageSlotUpgradeable.getAddressSlot(_ADMIN_SLOT).value = newAdmin;\n }\n\n /**\n * @dev Changes the admin of the proxy.\n *\n * Emits an {AdminChanged} event.\n */\n function _changeAdmin(address newAdmin) internal {\n emit AdminChanged(_getAdmin(), newAdmin);\n _setAdmin(newAdmin);\n }\n\n /**\n * @dev The storage slot of the UpgradeableBeacon contract which defines the implementation for this proxy.\n * This is bytes32(uint256(keccak256('eip1967.proxy.beacon')) - 1)) and is validated in the constructor.\n */\n bytes32 internal constant _BEACON_SLOT = 0xa3f0ad74e5423aebfd80d3ef4346578335a9a72aeaee59ff6cb3582b35133d50;\n\n /**\n * @dev Returns the current beacon.\n */\n function _getBeacon() internal view returns (address) {\n return StorageSlotUpgradeable.getAddressSlot(_BEACON_SLOT).value;\n }\n\n /**\n * @dev Stores a new beacon in the EIP1967 beacon slot.\n */\n function _setBeacon(address newBeacon) private {\n require(AddressUpgradeable.isContract(newBeacon), \"ERC1967: new beacon is not a contract\");\n require(\n AddressUpgradeable.isContract(IBeaconUpgradeable(newBeacon).implementation()),\n \"ERC1967: beacon implementation is not a contract\"\n );\n StorageSlotUpgradeable.getAddressSlot(_BEACON_SLOT).value = newBeacon;\n }\n\n /**\n * @dev Perform beacon upgrade with additional setup call. Note: This upgrades the address of the beacon, it does\n * not upgrade the implementation contained in the beacon (see {UpgradeableBeacon-_setImplementation} for that).\n *\n * Emits a {BeaconUpgraded} event.\n */\n function _upgradeBeaconToAndCall(address newBeacon, bytes memory data, bool forceCall) internal {\n _setBeacon(newBeacon);\n emit BeaconUpgraded(newBeacon);\n if (data.length > 0 || forceCall) {\n AddressUpgradeable.functionDelegateCall(IBeaconUpgradeable(newBeacon).implementation(), data);\n }\n }\n\n /**\n * @dev This empty reserved space is put in place to allow future versions to add new\n * variables without shifting down storage in the inheritance chain.\n * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps\n */\n uint256[50] private __gap;\n}\n"
- },
- "@openzeppelin/contracts-upgradeable/proxy/utils/Initializable.sol": {
- "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (proxy/utils/Initializable.sol)\n\npragma solidity ^0.8.2;\n\nimport \"../../utils/AddressUpgradeable.sol\";\n\n/**\n * @dev This is a base contract to aid in writing upgradeable contracts, or any kind of contract that will be deployed\n * behind a proxy. Since proxied contracts do not make use of a constructor, it's common to move constructor logic to an\n * external initializer function, usually called `initialize`. It then becomes necessary to protect this initializer\n * function so it can only be called once. The {initializer} modifier provided by this contract will have this effect.\n *\n * The initialization functions use a version number. Once a version number is used, it is consumed and cannot be\n * reused. This mechanism prevents re-execution of each \"step\" but allows the creation of new initialization steps in\n * case an upgrade adds a module that needs to be initialized.\n *\n * For example:\n *\n * [.hljs-theme-light.nopadding]\n * ```solidity\n * contract MyToken is ERC20Upgradeable {\n * function initialize() initializer public {\n * __ERC20_init(\"MyToken\", \"MTK\");\n * }\n * }\n *\n * contract MyTokenV2 is MyToken, ERC20PermitUpgradeable {\n * function initializeV2() reinitializer(2) public {\n * __ERC20Permit_init(\"MyToken\");\n * }\n * }\n * ```\n *\n * TIP: To avoid leaving the proxy in an uninitialized state, the initializer function should be called as early as\n * possible by providing the encoded function call as the `_data` argument to {ERC1967Proxy-constructor}.\n *\n * CAUTION: When used with inheritance, manual care must be taken to not invoke a parent initializer twice, or to ensure\n * that all initializers are idempotent. This is not verified automatically as constructors are by Solidity.\n *\n * [CAUTION]\n * ====\n * Avoid leaving a contract uninitialized.\n *\n * An uninitialized contract can be taken over by an attacker. This applies to both a proxy and its implementation\n * contract, which may impact the proxy. To prevent the implementation contract from being used, you should invoke\n * the {_disableInitializers} function in the constructor to automatically lock it when it is deployed:\n *\n * [.hljs-theme-light.nopadding]\n * ```\n * /// @custom:oz-upgrades-unsafe-allow constructor\n * constructor() {\n * _disableInitializers();\n * }\n * ```\n * ====\n */\nabstract contract Initializable {\n /**\n * @dev Indicates that the contract has been initialized.\n * @custom:oz-retyped-from bool\n */\n uint8 private _initialized;\n\n /**\n * @dev Indicates that the contract is in the process of being initialized.\n */\n bool private _initializing;\n\n /**\n * @dev Triggered when the contract has been initialized or reinitialized.\n */\n event Initialized(uint8 version);\n\n /**\n * @dev A modifier that defines a protected initializer function that can be invoked at most once. In its scope,\n * `onlyInitializing` functions can be used to initialize parent contracts.\n *\n * Similar to `reinitializer(1)`, except that functions marked with `initializer` can be nested in the context of a\n * constructor.\n *\n * Emits an {Initialized} event.\n */\n modifier initializer() {\n bool isTopLevelCall = !_initializing;\n require(\n (isTopLevelCall && _initialized < 1) || (!AddressUpgradeable.isContract(address(this)) && _initialized == 1),\n \"Initializable: contract is already initialized\"\n );\n _initialized = 1;\n if (isTopLevelCall) {\n _initializing = true;\n }\n _;\n if (isTopLevelCall) {\n _initializing = false;\n emit Initialized(1);\n }\n }\n\n /**\n * @dev A modifier that defines a protected reinitializer function that can be invoked at most once, and only if the\n * contract hasn't been initialized to a greater version before. In its scope, `onlyInitializing` functions can be\n * used to initialize parent contracts.\n *\n * A reinitializer may be used after the original initialization step. This is essential to configure modules that\n * are added through upgrades and that require initialization.\n *\n * When `version` is 1, this modifier is similar to `initializer`, except that functions marked with `reinitializer`\n * cannot be nested. If one is invoked in the context of another, execution will revert.\n *\n * Note that versions can jump in increments greater than 1; this implies that if multiple reinitializers coexist in\n * a contract, executing them in the right order is up to the developer or operator.\n *\n * WARNING: setting the version to 255 will prevent any future reinitialization.\n *\n * Emits an {Initialized} event.\n */\n modifier reinitializer(uint8 version) {\n require(!_initializing && _initialized < version, \"Initializable: contract is already initialized\");\n _initialized = version;\n _initializing = true;\n _;\n _initializing = false;\n emit Initialized(version);\n }\n\n /**\n * @dev Modifier to protect an initialization function so that it can only be invoked by functions with the\n * {initializer} and {reinitializer} modifiers, directly or indirectly.\n */\n modifier onlyInitializing() {\n require(_initializing, \"Initializable: contract is not initializing\");\n _;\n }\n\n /**\n * @dev Locks the contract, preventing any future reinitialization. This cannot be part of an initializer call.\n * Calling this in the constructor of a contract will prevent that contract from being initialized or reinitialized\n * to any version. It is recommended to use this to lock implementation contracts that are designed to be called\n * through proxies.\n *\n * Emits an {Initialized} event the first time it is successfully executed.\n */\n function _disableInitializers() internal virtual {\n require(!_initializing, \"Initializable: contract is initializing\");\n if (_initialized != type(uint8).max) {\n _initialized = type(uint8).max;\n emit Initialized(type(uint8).max);\n }\n }\n\n /**\n * @dev Returns the highest version that has been initialized. See {reinitializer}.\n */\n function _getInitializedVersion() internal view returns (uint8) {\n return _initialized;\n }\n\n /**\n * @dev Returns `true` if the contract is currently initializing. See {onlyInitializing}.\n */\n function _isInitializing() internal view returns (bool) {\n return _initializing;\n }\n}\n"
- },
- "@openzeppelin/contracts-upgradeable/proxy/utils/UUPSUpgradeable.sol": {
- "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (proxy/utils/UUPSUpgradeable.sol)\n\npragma solidity ^0.8.0;\n\nimport \"../../interfaces/draft-IERC1822Upgradeable.sol\";\nimport \"../ERC1967/ERC1967UpgradeUpgradeable.sol\";\nimport {Initializable} from \"./Initializable.sol\";\n\n/**\n * @dev An upgradeability mechanism designed for UUPS proxies. The functions included here can perform an upgrade of an\n * {ERC1967Proxy}, when this contract is set as the implementation behind such a proxy.\n *\n * A security mechanism ensures that an upgrade does not turn off upgradeability accidentally, although this risk is\n * reinstated if the upgrade retains upgradeability but removes the security mechanism, e.g. by replacing\n * `UUPSUpgradeable` with a custom implementation of upgrades.\n *\n * The {_authorizeUpgrade} function must be overridden to include access restriction to the upgrade mechanism.\n *\n * _Available since v4.1._\n */\nabstract contract UUPSUpgradeable is Initializable, IERC1822ProxiableUpgradeable, ERC1967UpgradeUpgradeable {\n /// @custom:oz-upgrades-unsafe-allow state-variable-immutable state-variable-assignment\n address private immutable __self = address(this);\n\n /**\n * @dev Check that the execution is being performed through a delegatecall call and that the execution context is\n * a proxy contract with an implementation (as defined in ERC1967) pointing to self. This should only be the case\n * for UUPS and transparent proxies that are using the current contract as their implementation. Execution of a\n * function through ERC1167 minimal proxies (clones) would not normally pass this test, but is not guaranteed to\n * fail.\n */\n modifier onlyProxy() {\n require(address(this) != __self, \"Function must be called through delegatecall\");\n require(_getImplementation() == __self, \"Function must be called through active proxy\");\n _;\n }\n\n /**\n * @dev Check that the execution is not being performed through a delegate call. This allows a function to be\n * callable on the implementing contract but not through proxies.\n */\n modifier notDelegated() {\n require(address(this) == __self, \"UUPSUpgradeable: must not be called through delegatecall\");\n _;\n }\n\n function __UUPSUpgradeable_init() internal onlyInitializing {\n }\n\n function __UUPSUpgradeable_init_unchained() internal onlyInitializing {\n }\n /**\n * @dev Implementation of the ERC1822 {proxiableUUID} function. This returns the storage slot used by the\n * implementation. It is used to validate the implementation's compatibility when performing an upgrade.\n *\n * IMPORTANT: A proxy pointing at a proxiable contract should not be considered proxiable itself, because this risks\n * bricking a proxy that upgrades to it, by delegating to itself until out of gas. Thus it is critical that this\n * function revert if invoked through a proxy. This is guaranteed by the `notDelegated` modifier.\n */\n function proxiableUUID() external view virtual override notDelegated returns (bytes32) {\n return _IMPLEMENTATION_SLOT;\n }\n\n /**\n * @dev Upgrade the implementation of the proxy to `newImplementation`.\n *\n * Calls {_authorizeUpgrade}.\n *\n * Emits an {Upgraded} event.\n *\n * @custom:oz-upgrades-unsafe-allow-reachable delegatecall\n */\n function upgradeTo(address newImplementation) public virtual onlyProxy {\n _authorizeUpgrade(newImplementation);\n _upgradeToAndCallUUPS(newImplementation, new bytes(0), false);\n }\n\n /**\n * @dev Upgrade the implementation of the proxy to `newImplementation`, and subsequently execute the function call\n * encoded in `data`.\n *\n * Calls {_authorizeUpgrade}.\n *\n * Emits an {Upgraded} event.\n *\n * @custom:oz-upgrades-unsafe-allow-reachable delegatecall\n */\n function upgradeToAndCall(address newImplementation, bytes memory data) public payable virtual onlyProxy {\n _authorizeUpgrade(newImplementation);\n _upgradeToAndCallUUPS(newImplementation, data, true);\n }\n\n /**\n * @dev Function that should revert when `msg.sender` is not authorized to upgrade the contract. Called by\n * {upgradeTo} and {upgradeToAndCall}.\n *\n * Normally, this function will use an xref:access.adoc[access control] modifier such as {Ownable-onlyOwner}.\n *\n * ```solidity\n * function _authorizeUpgrade(address) internal override onlyOwner {}\n * ```\n */\n function _authorizeUpgrade(address newImplementation) internal virtual;\n\n /**\n * @dev This empty reserved space is put in place to allow future versions to add new\n * variables without shifting down storage in the inheritance chain.\n * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps\n */\n uint256[50] private __gap;\n}\n"
- },
- "@openzeppelin/contracts-upgradeable/security/ReentrancyGuardUpgradeable.sol": {
- "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (security/ReentrancyGuard.sol)\n\npragma solidity ^0.8.0;\nimport {Initializable} from \"../proxy/utils/Initializable.sol\";\n\n/**\n * @dev Contract module that helps prevent reentrant calls to a function.\n *\n * Inheriting from `ReentrancyGuard` will make the {nonReentrant} modifier\n * available, which can be applied to functions to make sure there are no nested\n * (reentrant) calls to them.\n *\n * Note that because there is a single `nonReentrant` guard, functions marked as\n * `nonReentrant` may not call one another. This can be worked around by making\n * those functions `private`, and then adding `external` `nonReentrant` entry\n * points to them.\n *\n * TIP: If you would like to learn more about reentrancy and alternative ways\n * to protect against it, check out our blog post\n * https://blog.openzeppelin.com/reentrancy-after-istanbul/[Reentrancy After Istanbul].\n */\nabstract contract ReentrancyGuardUpgradeable is Initializable {\n // Booleans are more expensive than uint256 or any type that takes up a full\n // word because each write operation emits an extra SLOAD to first read the\n // slot's contents, replace the bits taken up by the boolean, and then write\n // back. This is the compiler's defense against contract upgrades and\n // pointer aliasing, and it cannot be disabled.\n\n // The values being non-zero value makes deployment a bit more expensive,\n // but in exchange the refund on every call to nonReentrant will be lower in\n // amount. Since refunds are capped to a percentage of the total\n // transaction's gas, it is best to keep them low in cases like this one, to\n // increase the likelihood of the full refund coming into effect.\n uint256 private constant _NOT_ENTERED = 1;\n uint256 private constant _ENTERED = 2;\n\n uint256 private _status;\n\n function __ReentrancyGuard_init() internal onlyInitializing {\n __ReentrancyGuard_init_unchained();\n }\n\n function __ReentrancyGuard_init_unchained() internal onlyInitializing {\n _status = _NOT_ENTERED;\n }\n\n /**\n * @dev Prevents a contract from calling itself, directly or indirectly.\n * Calling a `nonReentrant` function from another `nonReentrant`\n * function is not supported. It is possible to prevent this from happening\n * by making the `nonReentrant` function external, and making it call a\n * `private` function that does the actual work.\n */\n modifier nonReentrant() {\n _nonReentrantBefore();\n _;\n _nonReentrantAfter();\n }\n\n function _nonReentrantBefore() private {\n // On the first call to nonReentrant, _status will be _NOT_ENTERED\n require(_status != _ENTERED, \"ReentrancyGuard: reentrant call\");\n\n // Any calls to nonReentrant after this point will fail\n _status = _ENTERED;\n }\n\n function _nonReentrantAfter() private {\n // By storing the original value once again, a refund is triggered (see\n // https://eips.ethereum.org/EIPS/eip-2200)\n _status = _NOT_ENTERED;\n }\n\n /**\n * @dev Returns true if the reentrancy guard is currently set to \"entered\", which indicates there is a\n * `nonReentrant` function in the call stack.\n */\n function _reentrancyGuardEntered() internal view returns (bool) {\n return _status == _ENTERED;\n }\n\n /**\n * @dev This empty reserved space is put in place to allow future versions to add new\n * variables without shifting down storage in the inheritance chain.\n * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps\n */\n uint256[49] private __gap;\n}\n"
- },
- "@openzeppelin/contracts-upgradeable/token/ERC20/extensions/IERC20PermitUpgradeable.sol": {
- "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.4) (token/ERC20/extensions/IERC20Permit.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @dev Interface of the ERC20 Permit extension allowing approvals to be made via signatures, as defined in\n * https://eips.ethereum.org/EIPS/eip-2612[EIP-2612].\n *\n * Adds the {permit} method, which can be used to change an account's ERC20 allowance (see {IERC20-allowance}) by\n * presenting a message signed by the account. By not relying on {IERC20-approve}, the token holder account doesn't\n * need to send a transaction, and thus is not required to hold Ether at all.\n *\n * ==== Security Considerations\n *\n * There are two important considerations concerning the use of `permit`. The first is that a valid permit signature\n * expresses an allowance, and it should not be assumed to convey additional meaning. In particular, it should not be\n * considered as an intention to spend the allowance in any specific way. The second is that because permits have\n * built-in replay protection and can be submitted by anyone, they can be frontrun. A protocol that uses permits should\n * take this into consideration and allow a `permit` call to fail. Combining these two aspects, a pattern that may be\n * generally recommended is:\n *\n * ```solidity\n * function doThingWithPermit(..., uint256 value, uint256 deadline, uint8 v, bytes32 r, bytes32 s) public {\n * try token.permit(msg.sender, address(this), value, deadline, v, r, s) {} catch {}\n * doThing(..., value);\n * }\n *\n * function doThing(..., uint256 value) public {\n * token.safeTransferFrom(msg.sender, address(this), value);\n * ...\n * }\n * ```\n *\n * Observe that: 1) `msg.sender` is used as the owner, leaving no ambiguity as to the signer intent, and 2) the use of\n * `try/catch` allows the permit to fail and makes the code tolerant to frontrunning. (See also\n * {SafeERC20-safeTransferFrom}).\n *\n * Additionally, note that smart contract wallets (such as Argent or Safe) are not able to produce permit signatures, so\n * contracts should have entry points that don't rely on permit.\n */\ninterface IERC20PermitUpgradeable {\n /**\n * @dev Sets `value` as the allowance of `spender` over ``owner``'s tokens,\n * given ``owner``'s signed approval.\n *\n * IMPORTANT: The same issues {IERC20-approve} has related to transaction\n * ordering also apply here.\n *\n * Emits an {Approval} event.\n *\n * Requirements:\n *\n * - `spender` cannot be the zero address.\n * - `deadline` must be a timestamp in the future.\n * - `v`, `r` and `s` must be a valid `secp256k1` signature from `owner`\n * over the EIP712-formatted function arguments.\n * - the signature must use ``owner``'s current nonce (see {nonces}).\n *\n * For more information on the signature format, see the\n * https://eips.ethereum.org/EIPS/eip-2612#specification[relevant EIP\n * section].\n *\n * CAUTION: See Security Considerations above.\n */\n function permit(\n address owner,\n address spender,\n uint256 value,\n uint256 deadline,\n uint8 v,\n bytes32 r,\n bytes32 s\n ) external;\n\n /**\n * @dev Returns the current nonce for `owner`. This value must be\n * included whenever a signature is generated for {permit}.\n *\n * Every successful call to {permit} increases ``owner``'s nonce by one. This\n * prevents a signature from being used multiple times.\n */\n function nonces(address owner) external view returns (uint256);\n\n /**\n * @dev Returns the domain separator used in the encoding of the signature for {permit}, as defined by {EIP712}.\n */\n // solhint-disable-next-line func-name-mixedcase\n function DOMAIN_SEPARATOR() external view returns (bytes32);\n}\n"
- },
- "@openzeppelin/contracts-upgradeable/token/ERC20/IERC20Upgradeable.sol": {
- "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (token/ERC20/IERC20.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @dev Interface of the ERC20 standard as defined in the EIP.\n */\ninterface IERC20Upgradeable {\n /**\n * @dev Emitted when `value` tokens are moved from one account (`from`) to\n * another (`to`).\n *\n * Note that `value` may be zero.\n */\n event Transfer(address indexed from, address indexed to, uint256 value);\n\n /**\n * @dev Emitted when the allowance of a `spender` for an `owner` is set by\n * a call to {approve}. `value` is the new allowance.\n */\n event Approval(address indexed owner, address indexed spender, uint256 value);\n\n /**\n * @dev Returns the amount of tokens in existence.\n */\n function totalSupply() external view returns (uint256);\n\n /**\n * @dev Returns the amount of tokens owned by `account`.\n */\n function balanceOf(address account) external view returns (uint256);\n\n /**\n * @dev Moves `amount` tokens from the caller's account to `to`.\n *\n * Returns a boolean value indicating whether the operation succeeded.\n *\n * Emits a {Transfer} event.\n */\n function transfer(address to, uint256 amount) external returns (bool);\n\n /**\n * @dev Returns the remaining number of tokens that `spender` will be\n * allowed to spend on behalf of `owner` through {transferFrom}. This is\n * zero by default.\n *\n * This value changes when {approve} or {transferFrom} are called.\n */\n function allowance(address owner, address spender) external view returns (uint256);\n\n /**\n * @dev Sets `amount` as the allowance of `spender` over the caller's tokens.\n *\n * Returns a boolean value indicating whether the operation succeeded.\n *\n * IMPORTANT: Beware that changing an allowance with this method brings the risk\n * that someone may use both the old and the new allowance by unfortunate\n * transaction ordering. One possible solution to mitigate this race\n * condition is to first reduce the spender's allowance to 0 and set the\n * desired value afterwards:\n * https://github.com/ethereum/EIPs/issues/20#issuecomment-263524729\n *\n * Emits an {Approval} event.\n */\n function approve(address spender, uint256 amount) external returns (bool);\n\n /**\n * @dev Moves `amount` tokens from `from` to `to` using the\n * allowance mechanism. `amount` is then deducted from the caller's\n * allowance.\n *\n * Returns a boolean value indicating whether the operation succeeded.\n *\n * Emits a {Transfer} event.\n */\n function transferFrom(address from, address to, uint256 amount) external returns (bool);\n}\n"
- },
- "@openzeppelin/contracts-upgradeable/token/ERC20/utils/SafeERC20Upgradeable.sol": {
- "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.3) (token/ERC20/utils/SafeERC20.sol)\n\npragma solidity ^0.8.0;\n\nimport \"../IERC20Upgradeable.sol\";\nimport \"../extensions/IERC20PermitUpgradeable.sol\";\nimport \"../../../utils/AddressUpgradeable.sol\";\n\n/**\n * @title SafeERC20\n * @dev Wrappers around ERC20 operations that throw on failure (when the token\n * contract returns false). Tokens that return no value (and instead revert or\n * throw on failure) are also supported, non-reverting calls are assumed to be\n * successful.\n * To use this library you can add a `using SafeERC20 for IERC20;` statement to your contract,\n * which allows you to call the safe operations as `token.safeTransfer(...)`, etc.\n */\nlibrary SafeERC20Upgradeable {\n using AddressUpgradeable for address;\n\n /**\n * @dev Transfer `value` amount of `token` from the calling contract to `to`. If `token` returns no value,\n * non-reverting calls are assumed to be successful.\n */\n function safeTransfer(IERC20Upgradeable token, address to, uint256 value) internal {\n _callOptionalReturn(token, abi.encodeWithSelector(token.transfer.selector, to, value));\n }\n\n /**\n * @dev Transfer `value` amount of `token` from `from` to `to`, spending the approval given by `from` to the\n * calling contract. If `token` returns no value, non-reverting calls are assumed to be successful.\n */\n function safeTransferFrom(IERC20Upgradeable token, address from, address to, uint256 value) internal {\n _callOptionalReturn(token, abi.encodeWithSelector(token.transferFrom.selector, from, to, value));\n }\n\n /**\n * @dev Deprecated. This function has issues similar to the ones found in\n * {IERC20-approve}, and its usage is discouraged.\n *\n * Whenever possible, use {safeIncreaseAllowance} and\n * {safeDecreaseAllowance} instead.\n */\n function safeApprove(IERC20Upgradeable token, address spender, uint256 value) internal {\n // safeApprove should only be called when setting an initial allowance,\n // or when resetting it to zero. To increase and decrease it, use\n // 'safeIncreaseAllowance' and 'safeDecreaseAllowance'\n require(\n (value == 0) || (token.allowance(address(this), spender) == 0),\n \"SafeERC20: approve from non-zero to non-zero allowance\"\n );\n _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, value));\n }\n\n /**\n * @dev Increase the calling contract's allowance toward `spender` by `value`. If `token` returns no value,\n * non-reverting calls are assumed to be successful.\n */\n function safeIncreaseAllowance(IERC20Upgradeable token, address spender, uint256 value) internal {\n uint256 oldAllowance = token.allowance(address(this), spender);\n _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, oldAllowance + value));\n }\n\n /**\n * @dev Decrease the calling contract's allowance toward `spender` by `value`. If `token` returns no value,\n * non-reverting calls are assumed to be successful.\n */\n function safeDecreaseAllowance(IERC20Upgradeable token, address spender, uint256 value) internal {\n unchecked {\n uint256 oldAllowance = token.allowance(address(this), spender);\n require(oldAllowance >= value, \"SafeERC20: decreased allowance below zero\");\n _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, oldAllowance - value));\n }\n }\n\n /**\n * @dev Set the calling contract's allowance toward `spender` to `value`. If `token` returns no value,\n * non-reverting calls are assumed to be successful. Meant to be used with tokens that require the approval\n * to be set to zero before setting it to a non-zero value, such as USDT.\n */\n function forceApprove(IERC20Upgradeable token, address spender, uint256 value) internal {\n bytes memory approvalCall = abi.encodeWithSelector(token.approve.selector, spender, value);\n\n if (!_callOptionalReturnBool(token, approvalCall)) {\n _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, 0));\n _callOptionalReturn(token, approvalCall);\n }\n }\n\n /**\n * @dev Use a ERC-2612 signature to set the `owner` approval toward `spender` on `token`.\n * Revert on invalid signature.\n */\n function safePermit(\n IERC20PermitUpgradeable token,\n address owner,\n address spender,\n uint256 value,\n uint256 deadline,\n uint8 v,\n bytes32 r,\n bytes32 s\n ) internal {\n uint256 nonceBefore = token.nonces(owner);\n token.permit(owner, spender, value, deadline, v, r, s);\n uint256 nonceAfter = token.nonces(owner);\n require(nonceAfter == nonceBefore + 1, \"SafeERC20: permit did not succeed\");\n }\n\n /**\n * @dev Imitates a Solidity high-level call (i.e. a regular function call to a contract), relaxing the requirement\n * on the return value: the return value is optional (but if data is returned, it must not be false).\n * @param token The token targeted by the call.\n * @param data The call data (encoded using abi.encode or one of its variants).\n */\n function _callOptionalReturn(IERC20Upgradeable token, bytes memory data) private {\n // We need to perform a low level call here, to bypass Solidity's return data size checking mechanism, since\n // we're implementing it ourselves. We use {Address-functionCall} to perform this call, which verifies that\n // the target address contains contract code and also asserts for success in the low-level call.\n\n bytes memory returndata = address(token).functionCall(data, \"SafeERC20: low-level call failed\");\n require(returndata.length == 0 || abi.decode(returndata, (bool)), \"SafeERC20: ERC20 operation did not succeed\");\n }\n\n /**\n * @dev Imitates a Solidity high-level call (i.e. a regular function call to a contract), relaxing the requirement\n * on the return value: the return value is optional (but if data is returned, it must not be false).\n * @param token The token targeted by the call.\n * @param data The call data (encoded using abi.encode or one of its variants).\n *\n * This is a variant of {_callOptionalReturn} that silents catches all reverts and returns a bool instead.\n */\n function _callOptionalReturnBool(IERC20Upgradeable token, bytes memory data) private returns (bool) {\n // We need to perform a low level call here, to bypass Solidity's return data size checking mechanism, since\n // we're implementing it ourselves. We cannot use {Address-functionCall} here since this should return false\n // and not revert is the subcall reverts.\n\n (bool success, bytes memory returndata) = address(token).call(data);\n return\n success && (returndata.length == 0 || abi.decode(returndata, (bool))) && AddressUpgradeable.isContract(address(token));\n }\n}\n"
- },
- "@openzeppelin/contracts-upgradeable/utils/AddressUpgradeable.sol": {
- "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (utils/Address.sol)\n\npragma solidity ^0.8.1;\n\n/**\n * @dev Collection of functions related to the address type\n */\nlibrary AddressUpgradeable {\n /**\n * @dev Returns true if `account` is a contract.\n *\n * [IMPORTANT]\n * ====\n * It is unsafe to assume that an address for which this function returns\n * false is an externally-owned account (EOA) and not a contract.\n *\n * Among others, `isContract` will return false for the following\n * types of addresses:\n *\n * - an externally-owned account\n * - a contract in construction\n * - an address where a contract will be created\n * - an address where a contract lived, but was destroyed\n *\n * Furthermore, `isContract` will also return true if the target contract within\n * the same transaction is already scheduled for destruction by `SELFDESTRUCT`,\n * which only has an effect at the end of a transaction.\n * ====\n *\n * [IMPORTANT]\n * ====\n * You shouldn't rely on `isContract` to protect against flash loan attacks!\n *\n * Preventing calls from contracts is highly discouraged. It breaks composability, breaks support for smart wallets\n * like Gnosis Safe, and does not provide security since it can be circumvented by calling from a contract\n * constructor.\n * ====\n */\n function isContract(address account) internal view returns (bool) {\n // This method relies on extcodesize/address.code.length, which returns 0\n // for contracts in construction, since the code is only stored at the end\n // of the constructor execution.\n\n return account.code.length > 0;\n }\n\n /**\n * @dev Replacement for Solidity's `transfer`: sends `amount` wei to\n * `recipient`, forwarding all available gas and reverting on errors.\n *\n * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost\n * of certain opcodes, possibly making contracts go over the 2300 gas limit\n * imposed by `transfer`, making them unable to receive funds via\n * `transfer`. {sendValue} removes this limitation.\n *\n * https://consensys.net/diligence/blog/2019/09/stop-using-soliditys-transfer-now/[Learn more].\n *\n * IMPORTANT: because control is transferred to `recipient`, care must be\n * taken to not create reentrancy vulnerabilities. Consider using\n * {ReentrancyGuard} or the\n * https://solidity.readthedocs.io/en/v0.8.0/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].\n */\n function sendValue(address payable recipient, uint256 amount) internal {\n require(address(this).balance >= amount, \"Address: insufficient balance\");\n\n (bool success, ) = recipient.call{value: amount}(\"\");\n require(success, \"Address: unable to send value, recipient may have reverted\");\n }\n\n /**\n * @dev Performs a Solidity function call using a low level `call`. A\n * plain `call` is an unsafe replacement for a function call: use this\n * function instead.\n *\n * If `target` reverts with a revert reason, it is bubbled up by this\n * function (like regular Solidity function calls).\n *\n * Returns the raw returned data. To convert to the expected return value,\n * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].\n *\n * Requirements:\n *\n * - `target` must be a contract.\n * - calling `target` with `data` must not revert.\n *\n * _Available since v3.1._\n */\n function functionCall(address target, bytes memory data) internal returns (bytes memory) {\n return functionCallWithValue(target, data, 0, \"Address: low-level call failed\");\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with\n * `errorMessage` as a fallback revert reason when `target` reverts.\n *\n * _Available since v3.1._\n */\n function functionCall(\n address target,\n bytes memory data,\n string memory errorMessage\n ) internal returns (bytes memory) {\n return functionCallWithValue(target, data, 0, errorMessage);\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\n * but also transferring `value` wei to `target`.\n *\n * Requirements:\n *\n * - the calling contract must have an ETH balance of at least `value`.\n * - the called Solidity function must be `payable`.\n *\n * _Available since v3.1._\n */\n function functionCallWithValue(address target, bytes memory data, uint256 value) internal returns (bytes memory) {\n return functionCallWithValue(target, data, value, \"Address: low-level call with value failed\");\n }\n\n /**\n * @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but\n * with `errorMessage` as a fallback revert reason when `target` reverts.\n *\n * _Available since v3.1._\n */\n function functionCallWithValue(\n address target,\n bytes memory data,\n uint256 value,\n string memory errorMessage\n ) internal returns (bytes memory) {\n require(address(this).balance >= value, \"Address: insufficient balance for call\");\n (bool success, bytes memory returndata) = target.call{value: value}(data);\n return verifyCallResultFromTarget(target, success, returndata, errorMessage);\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\n * but performing a static call.\n *\n * _Available since v3.3._\n */\n function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {\n return functionStaticCall(target, data, \"Address: low-level static call failed\");\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],\n * but performing a static call.\n *\n * _Available since v3.3._\n */\n function functionStaticCall(\n address target,\n bytes memory data,\n string memory errorMessage\n ) internal view returns (bytes memory) {\n (bool success, bytes memory returndata) = target.staticcall(data);\n return verifyCallResultFromTarget(target, success, returndata, errorMessage);\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\n * but performing a delegate call.\n *\n * _Available since v3.4._\n */\n function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) {\n return functionDelegateCall(target, data, \"Address: low-level delegate call failed\");\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],\n * but performing a delegate call.\n *\n * _Available since v3.4._\n */\n function functionDelegateCall(\n address target,\n bytes memory data,\n string memory errorMessage\n ) internal returns (bytes memory) {\n (bool success, bytes memory returndata) = target.delegatecall(data);\n return verifyCallResultFromTarget(target, success, returndata, errorMessage);\n }\n\n /**\n * @dev Tool to verify that a low level call to smart-contract was successful, and revert (either by bubbling\n * the revert reason or using the provided one) in case of unsuccessful call or if target was not a contract.\n *\n * _Available since v4.8._\n */\n function verifyCallResultFromTarget(\n address target,\n bool success,\n bytes memory returndata,\n string memory errorMessage\n ) internal view returns (bytes memory) {\n if (success) {\n if (returndata.length == 0) {\n // only check isContract if the call was successful and the return data is empty\n // otherwise we already know that it was a contract\n require(isContract(target), \"Address: call to non-contract\");\n }\n return returndata;\n } else {\n _revert(returndata, errorMessage);\n }\n }\n\n /**\n * @dev Tool to verify that a low level call was successful, and revert if it wasn't, either by bubbling the\n * revert reason or using the provided one.\n *\n * _Available since v4.3._\n */\n function verifyCallResult(\n bool success,\n bytes memory returndata,\n string memory errorMessage\n ) internal pure returns (bytes memory) {\n if (success) {\n return returndata;\n } else {\n _revert(returndata, errorMessage);\n }\n }\n\n function _revert(bytes memory returndata, string memory errorMessage) private pure {\n // Look for revert reason and bubble it up if present\n if (returndata.length > 0) {\n // The easiest way to bubble the revert reason is using memory via assembly\n /// @solidity memory-safe-assembly\n assembly {\n let returndata_size := mload(returndata)\n revert(add(32, returndata), returndata_size)\n }\n } else {\n revert(errorMessage);\n }\n }\n}\n"
- },
- "@openzeppelin/contracts-upgradeable/utils/cryptography/ECDSAUpgradeable.sol": {
- "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (utils/cryptography/ECDSA.sol)\n\npragma solidity ^0.8.0;\n\nimport \"../StringsUpgradeable.sol\";\n\n/**\n * @dev Elliptic Curve Digital Signature Algorithm (ECDSA) operations.\n *\n * These functions can be used to verify that a message was signed by the holder\n * of the private keys of a given address.\n */\nlibrary ECDSAUpgradeable {\n enum RecoverError {\n NoError,\n InvalidSignature,\n InvalidSignatureLength,\n InvalidSignatureS,\n InvalidSignatureV // Deprecated in v4.8\n }\n\n function _throwError(RecoverError error) private pure {\n if (error == RecoverError.NoError) {\n return; // no error: do nothing\n } else if (error == RecoverError.InvalidSignature) {\n revert(\"ECDSA: invalid signature\");\n } else if (error == RecoverError.InvalidSignatureLength) {\n revert(\"ECDSA: invalid signature length\");\n } else if (error == RecoverError.InvalidSignatureS) {\n revert(\"ECDSA: invalid signature 's' value\");\n }\n }\n\n /**\n * @dev Returns the address that signed a hashed message (`hash`) with\n * `signature` or error string. This address can then be used for verification purposes.\n *\n * The `ecrecover` EVM opcode allows for malleable (non-unique) signatures:\n * this function rejects them by requiring the `s` value to be in the lower\n * half order, and the `v` value to be either 27 or 28.\n *\n * IMPORTANT: `hash` _must_ be the result of a hash operation for the\n * verification to be secure: it is possible to craft signatures that\n * recover to arbitrary addresses for non-hashed data. A safe way to ensure\n * this is by receiving a hash of the original message (which may otherwise\n * be too long), and then calling {toEthSignedMessageHash} on it.\n *\n * Documentation for signature generation:\n * - with https://web3js.readthedocs.io/en/v1.3.4/web3-eth-accounts.html#sign[Web3.js]\n * - with https://docs.ethers.io/v5/api/signer/#Signer-signMessage[ethers]\n *\n * _Available since v4.3._\n */\n function tryRecover(bytes32 hash, bytes memory signature) internal pure returns (address, RecoverError) {\n if (signature.length == 65) {\n bytes32 r;\n bytes32 s;\n uint8 v;\n // ecrecover takes the signature parameters, and the only way to get them\n // currently is to use assembly.\n /// @solidity memory-safe-assembly\n assembly {\n r := mload(add(signature, 0x20))\n s := mload(add(signature, 0x40))\n v := byte(0, mload(add(signature, 0x60)))\n }\n return tryRecover(hash, v, r, s);\n } else {\n return (address(0), RecoverError.InvalidSignatureLength);\n }\n }\n\n /**\n * @dev Returns the address that signed a hashed message (`hash`) with\n * `signature`. This address can then be used for verification purposes.\n *\n * The `ecrecover` EVM opcode allows for malleable (non-unique) signatures:\n * this function rejects them by requiring the `s` value to be in the lower\n * half order, and the `v` value to be either 27 or 28.\n *\n * IMPORTANT: `hash` _must_ be the result of a hash operation for the\n * verification to be secure: it is possible to craft signatures that\n * recover to arbitrary addresses for non-hashed data. A safe way to ensure\n * this is by receiving a hash of the original message (which may otherwise\n * be too long), and then calling {toEthSignedMessageHash} on it.\n */\n function recover(bytes32 hash, bytes memory signature) internal pure returns (address) {\n (address recovered, RecoverError error) = tryRecover(hash, signature);\n _throwError(error);\n return recovered;\n }\n\n /**\n * @dev Overload of {ECDSA-tryRecover} that receives the `r` and `vs` short-signature fields separately.\n *\n * See https://eips.ethereum.org/EIPS/eip-2098[EIP-2098 short signatures]\n *\n * _Available since v4.3._\n */\n function tryRecover(bytes32 hash, bytes32 r, bytes32 vs) internal pure returns (address, RecoverError) {\n bytes32 s = vs & bytes32(0x7fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff);\n uint8 v = uint8((uint256(vs) >> 255) + 27);\n return tryRecover(hash, v, r, s);\n }\n\n /**\n * @dev Overload of {ECDSA-recover} that receives the `r and `vs` short-signature fields separately.\n *\n * _Available since v4.2._\n */\n function recover(bytes32 hash, bytes32 r, bytes32 vs) internal pure returns (address) {\n (address recovered, RecoverError error) = tryRecover(hash, r, vs);\n _throwError(error);\n return recovered;\n }\n\n /**\n * @dev Overload of {ECDSA-tryRecover} that receives the `v`,\n * `r` and `s` signature fields separately.\n *\n * _Available since v4.3._\n */\n function tryRecover(bytes32 hash, uint8 v, bytes32 r, bytes32 s) internal pure returns (address, RecoverError) {\n // EIP-2 still allows signature malleability for ecrecover(). Remove this possibility and make the signature\n // unique. Appendix F in the Ethereum Yellow paper (https://ethereum.github.io/yellowpaper/paper.pdf), defines\n // the valid range for s in (301): 0 < s < secp256k1n ÷ 2 + 1, and for v in (302): v ∈ {27, 28}. Most\n // signatures from current libraries generate a unique signature with an s-value in the lower half order.\n //\n // If your library generates malleable signatures, such as s-values in the upper range, calculate a new s-value\n // with 0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFEBAAEDCE6AF48A03BBFD25E8CD0364141 - s1 and flip v from 27 to 28 or\n // vice versa. If your library also generates signatures with 0/1 for v instead 27/28, add 27 to v to accept\n // these malleable signatures as well.\n if (uint256(s) > 0x7FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF5D576E7357A4501DDFE92F46681B20A0) {\n return (address(0), RecoverError.InvalidSignatureS);\n }\n\n // If the signature is valid (and not malleable), return the signer address\n address signer = ecrecover(hash, v, r, s);\n if (signer == address(0)) {\n return (address(0), RecoverError.InvalidSignature);\n }\n\n return (signer, RecoverError.NoError);\n }\n\n /**\n * @dev Overload of {ECDSA-recover} that receives the `v`,\n * `r` and `s` signature fields separately.\n */\n function recover(bytes32 hash, uint8 v, bytes32 r, bytes32 s) internal pure returns (address) {\n (address recovered, RecoverError error) = tryRecover(hash, v, r, s);\n _throwError(error);\n return recovered;\n }\n\n /**\n * @dev Returns an Ethereum Signed Message, created from a `hash`. This\n * produces hash corresponding to the one signed with the\n * https://eth.wiki/json-rpc/API#eth_sign[`eth_sign`]\n * JSON-RPC method as part of EIP-191.\n *\n * See {recover}.\n */\n function toEthSignedMessageHash(bytes32 hash) internal pure returns (bytes32 message) {\n // 32 is the length in bytes of hash,\n // enforced by the type signature above\n /// @solidity memory-safe-assembly\n assembly {\n mstore(0x00, \"\\x19Ethereum Signed Message:\\n32\")\n mstore(0x1c, hash)\n message := keccak256(0x00, 0x3c)\n }\n }\n\n /**\n * @dev Returns an Ethereum Signed Message, created from `s`. This\n * produces hash corresponding to the one signed with the\n * https://eth.wiki/json-rpc/API#eth_sign[`eth_sign`]\n * JSON-RPC method as part of EIP-191.\n *\n * See {recover}.\n */\n function toEthSignedMessageHash(bytes memory s) internal pure returns (bytes32) {\n return keccak256(abi.encodePacked(\"\\x19Ethereum Signed Message:\\n\", StringsUpgradeable.toString(s.length), s));\n }\n\n /**\n * @dev Returns an Ethereum Signed Typed Data, created from a\n * `domainSeparator` and a `structHash`. This produces hash corresponding\n * to the one signed with the\n * https://eips.ethereum.org/EIPS/eip-712[`eth_signTypedData`]\n * JSON-RPC method as part of EIP-712.\n *\n * See {recover}.\n */\n function toTypedDataHash(bytes32 domainSeparator, bytes32 structHash) internal pure returns (bytes32 data) {\n /// @solidity memory-safe-assembly\n assembly {\n let ptr := mload(0x40)\n mstore(ptr, \"\\x19\\x01\")\n mstore(add(ptr, 0x02), domainSeparator)\n mstore(add(ptr, 0x22), structHash)\n data := keccak256(ptr, 0x42)\n }\n }\n\n /**\n * @dev Returns an Ethereum Signed Data with intended validator, created from a\n * `validator` and `data` according to the version 0 of EIP-191.\n *\n * See {recover}.\n */\n function toDataWithIntendedValidatorHash(address validator, bytes memory data) internal pure returns (bytes32) {\n return keccak256(abi.encodePacked(\"\\x19\\x00\", validator, data));\n }\n}\n"
- },
- "@openzeppelin/contracts-upgradeable/utils/math/MathUpgradeable.sol": {
- "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (utils/math/Math.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @dev Standard math utilities missing in the Solidity language.\n */\nlibrary MathUpgradeable {\n enum Rounding {\n Down, // Toward negative infinity\n Up, // Toward infinity\n Zero // Toward zero\n }\n\n /**\n * @dev Returns the largest of two numbers.\n */\n function max(uint256 a, uint256 b) internal pure returns (uint256) {\n return a > b ? a : b;\n }\n\n /**\n * @dev Returns the smallest of two numbers.\n */\n function min(uint256 a, uint256 b) internal pure returns (uint256) {\n return a < b ? a : b;\n }\n\n /**\n * @dev Returns the average of two numbers. The result is rounded towards\n * zero.\n */\n function average(uint256 a, uint256 b) internal pure returns (uint256) {\n // (a + b) / 2 can overflow.\n return (a & b) + (a ^ b) / 2;\n }\n\n /**\n * @dev Returns the ceiling of the division of two numbers.\n *\n * This differs from standard division with `/` in that it rounds up instead\n * of rounding down.\n */\n function ceilDiv(uint256 a, uint256 b) internal pure returns (uint256) {\n // (a + b - 1) / b can overflow on addition, so we distribute.\n return a == 0 ? 0 : (a - 1) / b + 1;\n }\n\n /**\n * @notice Calculates floor(x * y / denominator) with full precision. Throws if result overflows a uint256 or denominator == 0\n * @dev Original credit to Remco Bloemen under MIT license (https://xn--2-umb.com/21/muldiv)\n * with further edits by Uniswap Labs also under MIT license.\n */\n function mulDiv(uint256 x, uint256 y, uint256 denominator) internal pure returns (uint256 result) {\n unchecked {\n // 512-bit multiply [prod1 prod0] = x * y. Compute the product mod 2^256 and mod 2^256 - 1, then use\n // use the Chinese Remainder Theorem to reconstruct the 512 bit result. The result is stored in two 256\n // variables such that product = prod1 * 2^256 + prod0.\n uint256 prod0; // Least significant 256 bits of the product\n uint256 prod1; // Most significant 256 bits of the product\n assembly {\n let mm := mulmod(x, y, not(0))\n prod0 := mul(x, y)\n prod1 := sub(sub(mm, prod0), lt(mm, prod0))\n }\n\n // Handle non-overflow cases, 256 by 256 division.\n if (prod1 == 0) {\n // Solidity will revert if denominator == 0, unlike the div opcode on its own.\n // The surrounding unchecked block does not change this fact.\n // See https://docs.soliditylang.org/en/latest/control-structures.html#checked-or-unchecked-arithmetic.\n return prod0 / denominator;\n }\n\n // Make sure the result is less than 2^256. Also prevents denominator == 0.\n require(denominator > prod1, \"Math: mulDiv overflow\");\n\n ///////////////////////////////////////////////\n // 512 by 256 division.\n ///////////////////////////////////////////////\n\n // Make division exact by subtracting the remainder from [prod1 prod0].\n uint256 remainder;\n assembly {\n // Compute remainder using mulmod.\n remainder := mulmod(x, y, denominator)\n\n // Subtract 256 bit number from 512 bit number.\n prod1 := sub(prod1, gt(remainder, prod0))\n prod0 := sub(prod0, remainder)\n }\n\n // Factor powers of two out of denominator and compute largest power of two divisor of denominator. Always >= 1.\n // See https://cs.stackexchange.com/q/138556/92363.\n\n // Does not overflow because the denominator cannot be zero at this stage in the function.\n uint256 twos = denominator & (~denominator + 1);\n assembly {\n // Divide denominator by twos.\n denominator := div(denominator, twos)\n\n // Divide [prod1 prod0] by twos.\n prod0 := div(prod0, twos)\n\n // Flip twos such that it is 2^256 / twos. If twos is zero, then it becomes one.\n twos := add(div(sub(0, twos), twos), 1)\n }\n\n // Shift in bits from prod1 into prod0.\n prod0 |= prod1 * twos;\n\n // Invert denominator mod 2^256. Now that denominator is an odd number, it has an inverse modulo 2^256 such\n // that denominator * inv = 1 mod 2^256. Compute the inverse by starting with a seed that is correct for\n // four bits. That is, denominator * inv = 1 mod 2^4.\n uint256 inverse = (3 * denominator) ^ 2;\n\n // Use the Newton-Raphson iteration to improve the precision. Thanks to Hensel's lifting lemma, this also works\n // in modular arithmetic, doubling the correct bits in each step.\n inverse *= 2 - denominator * inverse; // inverse mod 2^8\n inverse *= 2 - denominator * inverse; // inverse mod 2^16\n inverse *= 2 - denominator * inverse; // inverse mod 2^32\n inverse *= 2 - denominator * inverse; // inverse mod 2^64\n inverse *= 2 - denominator * inverse; // inverse mod 2^128\n inverse *= 2 - denominator * inverse; // inverse mod 2^256\n\n // Because the division is now exact we can divide by multiplying with the modular inverse of denominator.\n // This will give us the correct result modulo 2^256. Since the preconditions guarantee that the outcome is\n // less than 2^256, this is the final result. We don't need to compute the high bits of the result and prod1\n // is no longer required.\n result = prod0 * inverse;\n return result;\n }\n }\n\n /**\n * @notice Calculates x * y / denominator with full precision, following the selected rounding direction.\n */\n function mulDiv(uint256 x, uint256 y, uint256 denominator, Rounding rounding) internal pure returns (uint256) {\n uint256 result = mulDiv(x, y, denominator);\n if (rounding == Rounding.Up && mulmod(x, y, denominator) > 0) {\n result += 1;\n }\n return result;\n }\n\n /**\n * @dev Returns the square root of a number. If the number is not a perfect square, the value is rounded down.\n *\n * Inspired by Henry S. Warren, Jr.'s \"Hacker's Delight\" (Chapter 11).\n */\n function sqrt(uint256 a) internal pure returns (uint256) {\n if (a == 0) {\n return 0;\n }\n\n // For our first guess, we get the biggest power of 2 which is smaller than the square root of the target.\n //\n // We know that the \"msb\" (most significant bit) of our target number `a` is a power of 2 such that we have\n // `msb(a) <= a < 2*msb(a)`. This value can be written `msb(a)=2**k` with `k=log2(a)`.\n //\n // This can be rewritten `2**log2(a) <= a < 2**(log2(a) + 1)`\n // → `sqrt(2**k) <= sqrt(a) < sqrt(2**(k+1))`\n // → `2**(k/2) <= sqrt(a) < 2**((k+1)/2) <= 2**(k/2 + 1)`\n //\n // Consequently, `2**(log2(a) / 2)` is a good first approximation of `sqrt(a)` with at least 1 correct bit.\n uint256 result = 1 << (log2(a) >> 1);\n\n // At this point `result` is an estimation with one bit of precision. We know the true value is a uint128,\n // since it is the square root of a uint256. Newton's method converges quadratically (precision doubles at\n // every iteration). We thus need at most 7 iteration to turn our partial result with one bit of precision\n // into the expected uint128 result.\n unchecked {\n result = (result + a / result) >> 1;\n result = (result + a / result) >> 1;\n result = (result + a / result) >> 1;\n result = (result + a / result) >> 1;\n result = (result + a / result) >> 1;\n result = (result + a / result) >> 1;\n result = (result + a / result) >> 1;\n return min(result, a / result);\n }\n }\n\n /**\n * @notice Calculates sqrt(a), following the selected rounding direction.\n */\n function sqrt(uint256 a, Rounding rounding) internal pure returns (uint256) {\n unchecked {\n uint256 result = sqrt(a);\n return result + (rounding == Rounding.Up && result * result < a ? 1 : 0);\n }\n }\n\n /**\n * @dev Return the log in base 2, rounded down, of a positive value.\n * Returns 0 if given 0.\n */\n function log2(uint256 value) internal pure returns (uint256) {\n uint256 result = 0;\n unchecked {\n if (value >> 128 > 0) {\n value >>= 128;\n result += 128;\n }\n if (value >> 64 > 0) {\n value >>= 64;\n result += 64;\n }\n if (value >> 32 > 0) {\n value >>= 32;\n result += 32;\n }\n if (value >> 16 > 0) {\n value >>= 16;\n result += 16;\n }\n if (value >> 8 > 0) {\n value >>= 8;\n result += 8;\n }\n if (value >> 4 > 0) {\n value >>= 4;\n result += 4;\n }\n if (value >> 2 > 0) {\n value >>= 2;\n result += 2;\n }\n if (value >> 1 > 0) {\n result += 1;\n }\n }\n return result;\n }\n\n /**\n * @dev Return the log in base 2, following the selected rounding direction, of a positive value.\n * Returns 0 if given 0.\n */\n function log2(uint256 value, Rounding rounding) internal pure returns (uint256) {\n unchecked {\n uint256 result = log2(value);\n return result + (rounding == Rounding.Up && 1 << result < value ? 1 : 0);\n }\n }\n\n /**\n * @dev Return the log in base 10, rounded down, of a positive value.\n * Returns 0 if given 0.\n */\n function log10(uint256 value) internal pure returns (uint256) {\n uint256 result = 0;\n unchecked {\n if (value >= 10 ** 64) {\n value /= 10 ** 64;\n result += 64;\n }\n if (value >= 10 ** 32) {\n value /= 10 ** 32;\n result += 32;\n }\n if (value >= 10 ** 16) {\n value /= 10 ** 16;\n result += 16;\n }\n if (value >= 10 ** 8) {\n value /= 10 ** 8;\n result += 8;\n }\n if (value >= 10 ** 4) {\n value /= 10 ** 4;\n result += 4;\n }\n if (value >= 10 ** 2) {\n value /= 10 ** 2;\n result += 2;\n }\n if (value >= 10 ** 1) {\n result += 1;\n }\n }\n return result;\n }\n\n /**\n * @dev Return the log in base 10, following the selected rounding direction, of a positive value.\n * Returns 0 if given 0.\n */\n function log10(uint256 value, Rounding rounding) internal pure returns (uint256) {\n unchecked {\n uint256 result = log10(value);\n return result + (rounding == Rounding.Up && 10 ** result < value ? 1 : 0);\n }\n }\n\n /**\n * @dev Return the log in base 256, rounded down, of a positive value.\n * Returns 0 if given 0.\n *\n * Adding one to the result gives the number of pairs of hex symbols needed to represent `value` as a hex string.\n */\n function log256(uint256 value) internal pure returns (uint256) {\n uint256 result = 0;\n unchecked {\n if (value >> 128 > 0) {\n value >>= 128;\n result += 16;\n }\n if (value >> 64 > 0) {\n value >>= 64;\n result += 8;\n }\n if (value >> 32 > 0) {\n value >>= 32;\n result += 4;\n }\n if (value >> 16 > 0) {\n value >>= 16;\n result += 2;\n }\n if (value >> 8 > 0) {\n result += 1;\n }\n }\n return result;\n }\n\n /**\n * @dev Return the log in base 256, following the selected rounding direction, of a positive value.\n * Returns 0 if given 0.\n */\n function log256(uint256 value, Rounding rounding) internal pure returns (uint256) {\n unchecked {\n uint256 result = log256(value);\n return result + (rounding == Rounding.Up && 1 << (result << 3) < value ? 1 : 0);\n }\n }\n}\n"
- },
- "@openzeppelin/contracts-upgradeable/utils/math/SignedMathUpgradeable.sol": {
- "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.8.0) (utils/math/SignedMath.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @dev Standard signed math utilities missing in the Solidity language.\n */\nlibrary SignedMathUpgradeable {\n /**\n * @dev Returns the largest of two signed numbers.\n */\n function max(int256 a, int256 b) internal pure returns (int256) {\n return a > b ? a : b;\n }\n\n /**\n * @dev Returns the smallest of two signed numbers.\n */\n function min(int256 a, int256 b) internal pure returns (int256) {\n return a < b ? a : b;\n }\n\n /**\n * @dev Returns the average of two signed numbers without overflow.\n * The result is rounded towards zero.\n */\n function average(int256 a, int256 b) internal pure returns (int256) {\n // Formula from the book \"Hacker's Delight\"\n int256 x = (a & b) + ((a ^ b) >> 1);\n return x + (int256(uint256(x) >> 255) & (a ^ b));\n }\n\n /**\n * @dev Returns the absolute unsigned value of a signed value.\n */\n function abs(int256 n) internal pure returns (uint256) {\n unchecked {\n // must be unchecked in order to support `n = type(int256).min`\n return uint256(n >= 0 ? n : -n);\n }\n }\n}\n"
- },
- "@openzeppelin/contracts-upgradeable/utils/StorageSlotUpgradeable.sol": {
- "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (utils/StorageSlot.sol)\n// This file was procedurally generated from scripts/generate/templates/StorageSlot.js.\n\npragma solidity ^0.8.0;\n\n/**\n * @dev Library for reading and writing primitive types to specific storage slots.\n *\n * Storage slots are often used to avoid storage conflict when dealing with upgradeable contracts.\n * This library helps with reading and writing to such slots without the need for inline assembly.\n *\n * The functions in this library return Slot structs that contain a `value` member that can be used to read or write.\n *\n * Example usage to set ERC1967 implementation slot:\n * ```solidity\n * contract ERC1967 {\n * bytes32 internal constant _IMPLEMENTATION_SLOT = 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc;\n *\n * function _getImplementation() internal view returns (address) {\n * return StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value;\n * }\n *\n * function _setImplementation(address newImplementation) internal {\n * require(Address.isContract(newImplementation), \"ERC1967: new implementation is not a contract\");\n * StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value = newImplementation;\n * }\n * }\n * ```\n *\n * _Available since v4.1 for `address`, `bool`, `bytes32`, `uint256`._\n * _Available since v4.9 for `string`, `bytes`._\n */\nlibrary StorageSlotUpgradeable {\n struct AddressSlot {\n address value;\n }\n\n struct BooleanSlot {\n bool value;\n }\n\n struct Bytes32Slot {\n bytes32 value;\n }\n\n struct Uint256Slot {\n uint256 value;\n }\n\n struct StringSlot {\n string value;\n }\n\n struct BytesSlot {\n bytes value;\n }\n\n /**\n * @dev Returns an `AddressSlot` with member `value` located at `slot`.\n */\n function getAddressSlot(bytes32 slot) internal pure returns (AddressSlot storage r) {\n /// @solidity memory-safe-assembly\n assembly {\n r.slot := slot\n }\n }\n\n /**\n * @dev Returns an `BooleanSlot` with member `value` located at `slot`.\n */\n function getBooleanSlot(bytes32 slot) internal pure returns (BooleanSlot storage r) {\n /// @solidity memory-safe-assembly\n assembly {\n r.slot := slot\n }\n }\n\n /**\n * @dev Returns an `Bytes32Slot` with member `value` located at `slot`.\n */\n function getBytes32Slot(bytes32 slot) internal pure returns (Bytes32Slot storage r) {\n /// @solidity memory-safe-assembly\n assembly {\n r.slot := slot\n }\n }\n\n /**\n * @dev Returns an `Uint256Slot` with member `value` located at `slot`.\n */\n function getUint256Slot(bytes32 slot) internal pure returns (Uint256Slot storage r) {\n /// @solidity memory-safe-assembly\n assembly {\n r.slot := slot\n }\n }\n\n /**\n * @dev Returns an `StringSlot` with member `value` located at `slot`.\n */\n function getStringSlot(bytes32 slot) internal pure returns (StringSlot storage r) {\n /// @solidity memory-safe-assembly\n assembly {\n r.slot := slot\n }\n }\n\n /**\n * @dev Returns an `StringSlot` representation of the string storage pointer `store`.\n */\n function getStringSlot(string storage store) internal pure returns (StringSlot storage r) {\n /// @solidity memory-safe-assembly\n assembly {\n r.slot := store.slot\n }\n }\n\n /**\n * @dev Returns an `BytesSlot` with member `value` located at `slot`.\n */\n function getBytesSlot(bytes32 slot) internal pure returns (BytesSlot storage r) {\n /// @solidity memory-safe-assembly\n assembly {\n r.slot := slot\n }\n }\n\n /**\n * @dev Returns an `BytesSlot` representation of the bytes storage pointer `store`.\n */\n function getBytesSlot(bytes storage store) internal pure returns (BytesSlot storage r) {\n /// @solidity memory-safe-assembly\n assembly {\n r.slot := store.slot\n }\n }\n}\n"
- },
- "@openzeppelin/contracts-upgradeable/utils/StringsUpgradeable.sol": {
- "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (utils/Strings.sol)\n\npragma solidity ^0.8.0;\n\nimport \"./math/MathUpgradeable.sol\";\nimport \"./math/SignedMathUpgradeable.sol\";\n\n/**\n * @dev String operations.\n */\nlibrary StringsUpgradeable {\n bytes16 private constant _SYMBOLS = \"0123456789abcdef\";\n uint8 private constant _ADDRESS_LENGTH = 20;\n\n /**\n * @dev Converts a `uint256` to its ASCII `string` decimal representation.\n */\n function toString(uint256 value) internal pure returns (string memory) {\n unchecked {\n uint256 length = MathUpgradeable.log10(value) + 1;\n string memory buffer = new string(length);\n uint256 ptr;\n /// @solidity memory-safe-assembly\n assembly {\n ptr := add(buffer, add(32, length))\n }\n while (true) {\n ptr--;\n /// @solidity memory-safe-assembly\n assembly {\n mstore8(ptr, byte(mod(value, 10), _SYMBOLS))\n }\n value /= 10;\n if (value == 0) break;\n }\n return buffer;\n }\n }\n\n /**\n * @dev Converts a `int256` to its ASCII `string` decimal representation.\n */\n function toString(int256 value) internal pure returns (string memory) {\n return string(abi.encodePacked(value < 0 ? \"-\" : \"\", toString(SignedMathUpgradeable.abs(value))));\n }\n\n /**\n * @dev Converts a `uint256` to its ASCII `string` hexadecimal representation.\n */\n function toHexString(uint256 value) internal pure returns (string memory) {\n unchecked {\n return toHexString(value, MathUpgradeable.log256(value) + 1);\n }\n }\n\n /**\n * @dev Converts a `uint256` to its ASCII `string` hexadecimal representation with fixed length.\n */\n function toHexString(uint256 value, uint256 length) internal pure returns (string memory) {\n bytes memory buffer = new bytes(2 * length + 2);\n buffer[0] = \"0\";\n buffer[1] = \"x\";\n for (uint256 i = 2 * length + 1; i > 1; --i) {\n buffer[i] = _SYMBOLS[value & 0xf];\n value >>= 4;\n }\n require(value == 0, \"Strings: hex length insufficient\");\n return string(buffer);\n }\n\n /**\n * @dev Converts an `address` with fixed length of 20 bytes to its not checksummed ASCII `string` hexadecimal representation.\n */\n function toHexString(address addr) internal pure returns (string memory) {\n return toHexString(uint256(uint160(addr)), _ADDRESS_LENGTH);\n }\n\n /**\n * @dev Returns true if the two strings are equal.\n */\n function equal(string memory a, string memory b) internal pure returns (bool) {\n return keccak256(bytes(a)) == keccak256(bytes(b));\n }\n}\n"
- },
- "@openzeppelin/contracts-upgradeable/vendor/optimism/ICrossDomainMessengerUpgradeable.sol": {
- "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (vendor/optimism/ICrossDomainMessenger.sol)\npragma solidity >0.5.0 <0.9.0;\n\n/**\n * @title ICrossDomainMessenger\n */\ninterface ICrossDomainMessengerUpgradeable {\n /**********\n * Events *\n **********/\n\n event SentMessage(address indexed target, address sender, bytes message, uint256 messageNonce, uint256 gasLimit);\n event RelayedMessage(bytes32 indexed msgHash);\n event FailedRelayedMessage(bytes32 indexed msgHash);\n\n /*************\n * Variables *\n *************/\n\n function xDomainMessageSender() external view returns (address);\n\n /********************\n * Public Functions *\n ********************/\n\n /**\n * Sends a cross domain message to the target messenger.\n * @param _target Target contract address.\n * @param _message Message to send to the target.\n * @param _gasLimit Gas limit for the provided message.\n */\n function sendMessage(address _target, bytes calldata _message, uint32 _gasLimit) external;\n}\n"
- },
- "@openzeppelin/contracts/interfaces/IERC1271.sol": {
- "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts v4.4.1 (interfaces/IERC1271.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @dev Interface of the ERC1271 standard signature validation method for\n * contracts as defined in https://eips.ethereum.org/EIPS/eip-1271[ERC-1271].\n *\n * _Available since v4.1._\n */\ninterface IERC1271 {\n /**\n * @dev Should return whether the signature provided is valid for the provided data\n * @param hash Hash of the data to be signed\n * @param signature Signature byte array associated with _data\n */\n function isValidSignature(bytes32 hash, bytes memory signature) external view returns (bytes4 magicValue);\n}\n"
- },
- "@openzeppelin/contracts/token/ERC20/extensions/IERC20Permit.sol": {
- "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.4) (token/ERC20/extensions/IERC20Permit.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @dev Interface of the ERC20 Permit extension allowing approvals to be made via signatures, as defined in\n * https://eips.ethereum.org/EIPS/eip-2612[EIP-2612].\n *\n * Adds the {permit} method, which can be used to change an account's ERC20 allowance (see {IERC20-allowance}) by\n * presenting a message signed by the account. By not relying on {IERC20-approve}, the token holder account doesn't\n * need to send a transaction, and thus is not required to hold Ether at all.\n *\n * ==== Security Considerations\n *\n * There are two important considerations concerning the use of `permit`. The first is that a valid permit signature\n * expresses an allowance, and it should not be assumed to convey additional meaning. In particular, it should not be\n * considered as an intention to spend the allowance in any specific way. The second is that because permits have\n * built-in replay protection and can be submitted by anyone, they can be frontrun. A protocol that uses permits should\n * take this into consideration and allow a `permit` call to fail. Combining these two aspects, a pattern that may be\n * generally recommended is:\n *\n * ```solidity\n * function doThingWithPermit(..., uint256 value, uint256 deadline, uint8 v, bytes32 r, bytes32 s) public {\n * try token.permit(msg.sender, address(this), value, deadline, v, r, s) {} catch {}\n * doThing(..., value);\n * }\n *\n * function doThing(..., uint256 value) public {\n * token.safeTransferFrom(msg.sender, address(this), value);\n * ...\n * }\n * ```\n *\n * Observe that: 1) `msg.sender` is used as the owner, leaving no ambiguity as to the signer intent, and 2) the use of\n * `try/catch` allows the permit to fail and makes the code tolerant to frontrunning. (See also\n * {SafeERC20-safeTransferFrom}).\n *\n * Additionally, note that smart contract wallets (such as Argent or Safe) are not able to produce permit signatures, so\n * contracts should have entry points that don't rely on permit.\n */\ninterface IERC20Permit {\n /**\n * @dev Sets `value` as the allowance of `spender` over ``owner``'s tokens,\n * given ``owner``'s signed approval.\n *\n * IMPORTANT: The same issues {IERC20-approve} has related to transaction\n * ordering also apply here.\n *\n * Emits an {Approval} event.\n *\n * Requirements:\n *\n * - `spender` cannot be the zero address.\n * - `deadline` must be a timestamp in the future.\n * - `v`, `r` and `s` must be a valid `secp256k1` signature from `owner`\n * over the EIP712-formatted function arguments.\n * - the signature must use ``owner``'s current nonce (see {nonces}).\n *\n * For more information on the signature format, see the\n * https://eips.ethereum.org/EIPS/eip-2612#specification[relevant EIP\n * section].\n *\n * CAUTION: See Security Considerations above.\n */\n function permit(\n address owner,\n address spender,\n uint256 value,\n uint256 deadline,\n uint8 v,\n bytes32 r,\n bytes32 s\n ) external;\n\n /**\n * @dev Returns the current nonce for `owner`. This value must be\n * included whenever a signature is generated for {permit}.\n *\n * Every successful call to {permit} increases ``owner``'s nonce by one. This\n * prevents a signature from being used multiple times.\n */\n function nonces(address owner) external view returns (uint256);\n\n /**\n * @dev Returns the domain separator used in the encoding of the signature for {permit}, as defined by {EIP712}.\n */\n // solhint-disable-next-line func-name-mixedcase\n function DOMAIN_SEPARATOR() external view returns (bytes32);\n}\n"
- },
- "@openzeppelin/contracts/token/ERC20/IERC20.sol": {
- "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (token/ERC20/IERC20.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @dev Interface of the ERC20 standard as defined in the EIP.\n */\ninterface IERC20 {\n /**\n * @dev Emitted when `value` tokens are moved from one account (`from`) to\n * another (`to`).\n *\n * Note that `value` may be zero.\n */\n event Transfer(address indexed from, address indexed to, uint256 value);\n\n /**\n * @dev Emitted when the allowance of a `spender` for an `owner` is set by\n * a call to {approve}. `value` is the new allowance.\n */\n event Approval(address indexed owner, address indexed spender, uint256 value);\n\n /**\n * @dev Returns the amount of tokens in existence.\n */\n function totalSupply() external view returns (uint256);\n\n /**\n * @dev Returns the amount of tokens owned by `account`.\n */\n function balanceOf(address account) external view returns (uint256);\n\n /**\n * @dev Moves `amount` tokens from the caller's account to `to`.\n *\n * Returns a boolean value indicating whether the operation succeeded.\n *\n * Emits a {Transfer} event.\n */\n function transfer(address to, uint256 amount) external returns (bool);\n\n /**\n * @dev Returns the remaining number of tokens that `spender` will be\n * allowed to spend on behalf of `owner` through {transferFrom}. This is\n * zero by default.\n *\n * This value changes when {approve} or {transferFrom} are called.\n */\n function allowance(address owner, address spender) external view returns (uint256);\n\n /**\n * @dev Sets `amount` as the allowance of `spender` over the caller's tokens.\n *\n * Returns a boolean value indicating whether the operation succeeded.\n *\n * IMPORTANT: Beware that changing an allowance with this method brings the risk\n * that someone may use both the old and the new allowance by unfortunate\n * transaction ordering. One possible solution to mitigate this race\n * condition is to first reduce the spender's allowance to 0 and set the\n * desired value afterwards:\n * https://github.com/ethereum/EIPs/issues/20#issuecomment-263524729\n *\n * Emits an {Approval} event.\n */\n function approve(address spender, uint256 amount) external returns (bool);\n\n /**\n * @dev Moves `amount` tokens from `from` to `to` using the\n * allowance mechanism. `amount` is then deducted from the caller's\n * allowance.\n *\n * Returns a boolean value indicating whether the operation succeeded.\n *\n * Emits a {Transfer} event.\n */\n function transferFrom(address from, address to, uint256 amount) external returns (bool);\n}\n"
- },
- "@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol": {
- "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.3) (token/ERC20/utils/SafeERC20.sol)\n\npragma solidity ^0.8.0;\n\nimport \"../IERC20.sol\";\nimport \"../extensions/IERC20Permit.sol\";\nimport \"../../../utils/Address.sol\";\n\n/**\n * @title SafeERC20\n * @dev Wrappers around ERC20 operations that throw on failure (when the token\n * contract returns false). Tokens that return no value (and instead revert or\n * throw on failure) are also supported, non-reverting calls are assumed to be\n * successful.\n * To use this library you can add a `using SafeERC20 for IERC20;` statement to your contract,\n * which allows you to call the safe operations as `token.safeTransfer(...)`, etc.\n */\nlibrary SafeERC20 {\n using Address for address;\n\n /**\n * @dev Transfer `value` amount of `token` from the calling contract to `to`. If `token` returns no value,\n * non-reverting calls are assumed to be successful.\n */\n function safeTransfer(IERC20 token, address to, uint256 value) internal {\n _callOptionalReturn(token, abi.encodeWithSelector(token.transfer.selector, to, value));\n }\n\n /**\n * @dev Transfer `value` amount of `token` from `from` to `to`, spending the approval given by `from` to the\n * calling contract. If `token` returns no value, non-reverting calls are assumed to be successful.\n */\n function safeTransferFrom(IERC20 token, address from, address to, uint256 value) internal {\n _callOptionalReturn(token, abi.encodeWithSelector(token.transferFrom.selector, from, to, value));\n }\n\n /**\n * @dev Deprecated. This function has issues similar to the ones found in\n * {IERC20-approve}, and its usage is discouraged.\n *\n * Whenever possible, use {safeIncreaseAllowance} and\n * {safeDecreaseAllowance} instead.\n */\n function safeApprove(IERC20 token, address spender, uint256 value) internal {\n // safeApprove should only be called when setting an initial allowance,\n // or when resetting it to zero. To increase and decrease it, use\n // 'safeIncreaseAllowance' and 'safeDecreaseAllowance'\n require(\n (value == 0) || (token.allowance(address(this), spender) == 0),\n \"SafeERC20: approve from non-zero to non-zero allowance\"\n );\n _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, value));\n }\n\n /**\n * @dev Increase the calling contract's allowance toward `spender` by `value`. If `token` returns no value,\n * non-reverting calls are assumed to be successful.\n */\n function safeIncreaseAllowance(IERC20 token, address spender, uint256 value) internal {\n uint256 oldAllowance = token.allowance(address(this), spender);\n _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, oldAllowance + value));\n }\n\n /**\n * @dev Decrease the calling contract's allowance toward `spender` by `value`. If `token` returns no value,\n * non-reverting calls are assumed to be successful.\n */\n function safeDecreaseAllowance(IERC20 token, address spender, uint256 value) internal {\n unchecked {\n uint256 oldAllowance = token.allowance(address(this), spender);\n require(oldAllowance >= value, \"SafeERC20: decreased allowance below zero\");\n _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, oldAllowance - value));\n }\n }\n\n /**\n * @dev Set the calling contract's allowance toward `spender` to `value`. If `token` returns no value,\n * non-reverting calls are assumed to be successful. Meant to be used with tokens that require the approval\n * to be set to zero before setting it to a non-zero value, such as USDT.\n */\n function forceApprove(IERC20 token, address spender, uint256 value) internal {\n bytes memory approvalCall = abi.encodeWithSelector(token.approve.selector, spender, value);\n\n if (!_callOptionalReturnBool(token, approvalCall)) {\n _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, 0));\n _callOptionalReturn(token, approvalCall);\n }\n }\n\n /**\n * @dev Use a ERC-2612 signature to set the `owner` approval toward `spender` on `token`.\n * Revert on invalid signature.\n */\n function safePermit(\n IERC20Permit token,\n address owner,\n address spender,\n uint256 value,\n uint256 deadline,\n uint8 v,\n bytes32 r,\n bytes32 s\n ) internal {\n uint256 nonceBefore = token.nonces(owner);\n token.permit(owner, spender, value, deadline, v, r, s);\n uint256 nonceAfter = token.nonces(owner);\n require(nonceAfter == nonceBefore + 1, \"SafeERC20: permit did not succeed\");\n }\n\n /**\n * @dev Imitates a Solidity high-level call (i.e. a regular function call to a contract), relaxing the requirement\n * on the return value: the return value is optional (but if data is returned, it must not be false).\n * @param token The token targeted by the call.\n * @param data The call data (encoded using abi.encode or one of its variants).\n */\n function _callOptionalReturn(IERC20 token, bytes memory data) private {\n // We need to perform a low level call here, to bypass Solidity's return data size checking mechanism, since\n // we're implementing it ourselves. We use {Address-functionCall} to perform this call, which verifies that\n // the target address contains contract code and also asserts for success in the low-level call.\n\n bytes memory returndata = address(token).functionCall(data, \"SafeERC20: low-level call failed\");\n require(returndata.length == 0 || abi.decode(returndata, (bool)), \"SafeERC20: ERC20 operation did not succeed\");\n }\n\n /**\n * @dev Imitates a Solidity high-level call (i.e. a regular function call to a contract), relaxing the requirement\n * on the return value: the return value is optional (but if data is returned, it must not be false).\n * @param token The token targeted by the call.\n * @param data The call data (encoded using abi.encode or one of its variants).\n *\n * This is a variant of {_callOptionalReturn} that silents catches all reverts and returns a bool instead.\n */\n function _callOptionalReturnBool(IERC20 token, bytes memory data) private returns (bool) {\n // We need to perform a low level call here, to bypass Solidity's return data size checking mechanism, since\n // we're implementing it ourselves. We cannot use {Address-functionCall} here since this should return false\n // and not revert is the subcall reverts.\n\n (bool success, bytes memory returndata) = address(token).call(data);\n return\n success && (returndata.length == 0 || abi.decode(returndata, (bool))) && Address.isContract(address(token));\n }\n}\n"
- },
- "@openzeppelin/contracts/utils/Address.sol": {
- "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (utils/Address.sol)\n\npragma solidity ^0.8.1;\n\n/**\n * @dev Collection of functions related to the address type\n */\nlibrary Address {\n /**\n * @dev Returns true if `account` is a contract.\n *\n * [IMPORTANT]\n * ====\n * It is unsafe to assume that an address for which this function returns\n * false is an externally-owned account (EOA) and not a contract.\n *\n * Among others, `isContract` will return false for the following\n * types of addresses:\n *\n * - an externally-owned account\n * - a contract in construction\n * - an address where a contract will be created\n * - an address where a contract lived, but was destroyed\n *\n * Furthermore, `isContract` will also return true if the target contract within\n * the same transaction is already scheduled for destruction by `SELFDESTRUCT`,\n * which only has an effect at the end of a transaction.\n * ====\n *\n * [IMPORTANT]\n * ====\n * You shouldn't rely on `isContract` to protect against flash loan attacks!\n *\n * Preventing calls from contracts is highly discouraged. It breaks composability, breaks support for smart wallets\n * like Gnosis Safe, and does not provide security since it can be circumvented by calling from a contract\n * constructor.\n * ====\n */\n function isContract(address account) internal view returns (bool) {\n // This method relies on extcodesize/address.code.length, which returns 0\n // for contracts in construction, since the code is only stored at the end\n // of the constructor execution.\n\n return account.code.length > 0;\n }\n\n /**\n * @dev Replacement for Solidity's `transfer`: sends `amount` wei to\n * `recipient`, forwarding all available gas and reverting on errors.\n *\n * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost\n * of certain opcodes, possibly making contracts go over the 2300 gas limit\n * imposed by `transfer`, making them unable to receive funds via\n * `transfer`. {sendValue} removes this limitation.\n *\n * https://consensys.net/diligence/blog/2019/09/stop-using-soliditys-transfer-now/[Learn more].\n *\n * IMPORTANT: because control is transferred to `recipient`, care must be\n * taken to not create reentrancy vulnerabilities. Consider using\n * {ReentrancyGuard} or the\n * https://solidity.readthedocs.io/en/v0.8.0/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].\n */\n function sendValue(address payable recipient, uint256 amount) internal {\n require(address(this).balance >= amount, \"Address: insufficient balance\");\n\n (bool success, ) = recipient.call{value: amount}(\"\");\n require(success, \"Address: unable to send value, recipient may have reverted\");\n }\n\n /**\n * @dev Performs a Solidity function call using a low level `call`. A\n * plain `call` is an unsafe replacement for a function call: use this\n * function instead.\n *\n * If `target` reverts with a revert reason, it is bubbled up by this\n * function (like regular Solidity function calls).\n *\n * Returns the raw returned data. To convert to the expected return value,\n * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].\n *\n * Requirements:\n *\n * - `target` must be a contract.\n * - calling `target` with `data` must not revert.\n *\n * _Available since v3.1._\n */\n function functionCall(address target, bytes memory data) internal returns (bytes memory) {\n return functionCallWithValue(target, data, 0, \"Address: low-level call failed\");\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with\n * `errorMessage` as a fallback revert reason when `target` reverts.\n *\n * _Available since v3.1._\n */\n function functionCall(\n address target,\n bytes memory data,\n string memory errorMessage\n ) internal returns (bytes memory) {\n return functionCallWithValue(target, data, 0, errorMessage);\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\n * but also transferring `value` wei to `target`.\n *\n * Requirements:\n *\n * - the calling contract must have an ETH balance of at least `value`.\n * - the called Solidity function must be `payable`.\n *\n * _Available since v3.1._\n */\n function functionCallWithValue(address target, bytes memory data, uint256 value) internal returns (bytes memory) {\n return functionCallWithValue(target, data, value, \"Address: low-level call with value failed\");\n }\n\n /**\n * @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but\n * with `errorMessage` as a fallback revert reason when `target` reverts.\n *\n * _Available since v3.1._\n */\n function functionCallWithValue(\n address target,\n bytes memory data,\n uint256 value,\n string memory errorMessage\n ) internal returns (bytes memory) {\n require(address(this).balance >= value, \"Address: insufficient balance for call\");\n (bool success, bytes memory returndata) = target.call{value: value}(data);\n return verifyCallResultFromTarget(target, success, returndata, errorMessage);\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\n * but performing a static call.\n *\n * _Available since v3.3._\n */\n function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {\n return functionStaticCall(target, data, \"Address: low-level static call failed\");\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],\n * but performing a static call.\n *\n * _Available since v3.3._\n */\n function functionStaticCall(\n address target,\n bytes memory data,\n string memory errorMessage\n ) internal view returns (bytes memory) {\n (bool success, bytes memory returndata) = target.staticcall(data);\n return verifyCallResultFromTarget(target, success, returndata, errorMessage);\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\n * but performing a delegate call.\n *\n * _Available since v3.4._\n */\n function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) {\n return functionDelegateCall(target, data, \"Address: low-level delegate call failed\");\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],\n * but performing a delegate call.\n *\n * _Available since v3.4._\n */\n function functionDelegateCall(\n address target,\n bytes memory data,\n string memory errorMessage\n ) internal returns (bytes memory) {\n (bool success, bytes memory returndata) = target.delegatecall(data);\n return verifyCallResultFromTarget(target, success, returndata, errorMessage);\n }\n\n /**\n * @dev Tool to verify that a low level call to smart-contract was successful, and revert (either by bubbling\n * the revert reason or using the provided one) in case of unsuccessful call or if target was not a contract.\n *\n * _Available since v4.8._\n */\n function verifyCallResultFromTarget(\n address target,\n bool success,\n bytes memory returndata,\n string memory errorMessage\n ) internal view returns (bytes memory) {\n if (success) {\n if (returndata.length == 0) {\n // only check isContract if the call was successful and the return data is empty\n // otherwise we already know that it was a contract\n require(isContract(target), \"Address: call to non-contract\");\n }\n return returndata;\n } else {\n _revert(returndata, errorMessage);\n }\n }\n\n /**\n * @dev Tool to verify that a low level call was successful, and revert if it wasn't, either by bubbling the\n * revert reason or using the provided one.\n *\n * _Available since v4.3._\n */\n function verifyCallResult(\n bool success,\n bytes memory returndata,\n string memory errorMessage\n ) internal pure returns (bytes memory) {\n if (success) {\n return returndata;\n } else {\n _revert(returndata, errorMessage);\n }\n }\n\n function _revert(bytes memory returndata, string memory errorMessage) private pure {\n // Look for revert reason and bubble it up if present\n if (returndata.length > 0) {\n // The easiest way to bubble the revert reason is using memory via assembly\n /// @solidity memory-safe-assembly\n assembly {\n let returndata_size := mload(returndata)\n revert(add(32, returndata), returndata_size)\n }\n } else {\n revert(errorMessage);\n }\n }\n}\n"
- },
- "@openzeppelin/contracts/utils/cryptography/ECDSA.sol": {
- "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (utils/cryptography/ECDSA.sol)\n\npragma solidity ^0.8.0;\n\nimport \"../Strings.sol\";\n\n/**\n * @dev Elliptic Curve Digital Signature Algorithm (ECDSA) operations.\n *\n * These functions can be used to verify that a message was signed by the holder\n * of the private keys of a given address.\n */\nlibrary ECDSA {\n enum RecoverError {\n NoError,\n InvalidSignature,\n InvalidSignatureLength,\n InvalidSignatureS,\n InvalidSignatureV // Deprecated in v4.8\n }\n\n function _throwError(RecoverError error) private pure {\n if (error == RecoverError.NoError) {\n return; // no error: do nothing\n } else if (error == RecoverError.InvalidSignature) {\n revert(\"ECDSA: invalid signature\");\n } else if (error == RecoverError.InvalidSignatureLength) {\n revert(\"ECDSA: invalid signature length\");\n } else if (error == RecoverError.InvalidSignatureS) {\n revert(\"ECDSA: invalid signature 's' value\");\n }\n }\n\n /**\n * @dev Returns the address that signed a hashed message (`hash`) with\n * `signature` or error string. This address can then be used for verification purposes.\n *\n * The `ecrecover` EVM opcode allows for malleable (non-unique) signatures:\n * this function rejects them by requiring the `s` value to be in the lower\n * half order, and the `v` value to be either 27 or 28.\n *\n * IMPORTANT: `hash` _must_ be the result of a hash operation for the\n * verification to be secure: it is possible to craft signatures that\n * recover to arbitrary addresses for non-hashed data. A safe way to ensure\n * this is by receiving a hash of the original message (which may otherwise\n * be too long), and then calling {toEthSignedMessageHash} on it.\n *\n * Documentation for signature generation:\n * - with https://web3js.readthedocs.io/en/v1.3.4/web3-eth-accounts.html#sign[Web3.js]\n * - with https://docs.ethers.io/v5/api/signer/#Signer-signMessage[ethers]\n *\n * _Available since v4.3._\n */\n function tryRecover(bytes32 hash, bytes memory signature) internal pure returns (address, RecoverError) {\n if (signature.length == 65) {\n bytes32 r;\n bytes32 s;\n uint8 v;\n // ecrecover takes the signature parameters, and the only way to get them\n // currently is to use assembly.\n /// @solidity memory-safe-assembly\n assembly {\n r := mload(add(signature, 0x20))\n s := mload(add(signature, 0x40))\n v := byte(0, mload(add(signature, 0x60)))\n }\n return tryRecover(hash, v, r, s);\n } else {\n return (address(0), RecoverError.InvalidSignatureLength);\n }\n }\n\n /**\n * @dev Returns the address that signed a hashed message (`hash`) with\n * `signature`. This address can then be used for verification purposes.\n *\n * The `ecrecover` EVM opcode allows for malleable (non-unique) signatures:\n * this function rejects them by requiring the `s` value to be in the lower\n * half order, and the `v` value to be either 27 or 28.\n *\n * IMPORTANT: `hash` _must_ be the result of a hash operation for the\n * verification to be secure: it is possible to craft signatures that\n * recover to arbitrary addresses for non-hashed data. A safe way to ensure\n * this is by receiving a hash of the original message (which may otherwise\n * be too long), and then calling {toEthSignedMessageHash} on it.\n */\n function recover(bytes32 hash, bytes memory signature) internal pure returns (address) {\n (address recovered, RecoverError error) = tryRecover(hash, signature);\n _throwError(error);\n return recovered;\n }\n\n /**\n * @dev Overload of {ECDSA-tryRecover} that receives the `r` and `vs` short-signature fields separately.\n *\n * See https://eips.ethereum.org/EIPS/eip-2098[EIP-2098 short signatures]\n *\n * _Available since v4.3._\n */\n function tryRecover(bytes32 hash, bytes32 r, bytes32 vs) internal pure returns (address, RecoverError) {\n bytes32 s = vs & bytes32(0x7fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff);\n uint8 v = uint8((uint256(vs) >> 255) + 27);\n return tryRecover(hash, v, r, s);\n }\n\n /**\n * @dev Overload of {ECDSA-recover} that receives the `r and `vs` short-signature fields separately.\n *\n * _Available since v4.2._\n */\n function recover(bytes32 hash, bytes32 r, bytes32 vs) internal pure returns (address) {\n (address recovered, RecoverError error) = tryRecover(hash, r, vs);\n _throwError(error);\n return recovered;\n }\n\n /**\n * @dev Overload of {ECDSA-tryRecover} that receives the `v`,\n * `r` and `s` signature fields separately.\n *\n * _Available since v4.3._\n */\n function tryRecover(bytes32 hash, uint8 v, bytes32 r, bytes32 s) internal pure returns (address, RecoverError) {\n // EIP-2 still allows signature malleability for ecrecover(). Remove this possibility and make the signature\n // unique. Appendix F in the Ethereum Yellow paper (https://ethereum.github.io/yellowpaper/paper.pdf), defines\n // the valid range for s in (301): 0 < s < secp256k1n ÷ 2 + 1, and for v in (302): v ∈ {27, 28}. Most\n // signatures from current libraries generate a unique signature with an s-value in the lower half order.\n //\n // If your library generates malleable signatures, such as s-values in the upper range, calculate a new s-value\n // with 0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFEBAAEDCE6AF48A03BBFD25E8CD0364141 - s1 and flip v from 27 to 28 or\n // vice versa. If your library also generates signatures with 0/1 for v instead 27/28, add 27 to v to accept\n // these malleable signatures as well.\n if (uint256(s) > 0x7FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF5D576E7357A4501DDFE92F46681B20A0) {\n return (address(0), RecoverError.InvalidSignatureS);\n }\n\n // If the signature is valid (and not malleable), return the signer address\n address signer = ecrecover(hash, v, r, s);\n if (signer == address(0)) {\n return (address(0), RecoverError.InvalidSignature);\n }\n\n return (signer, RecoverError.NoError);\n }\n\n /**\n * @dev Overload of {ECDSA-recover} that receives the `v`,\n * `r` and `s` signature fields separately.\n */\n function recover(bytes32 hash, uint8 v, bytes32 r, bytes32 s) internal pure returns (address) {\n (address recovered, RecoverError error) = tryRecover(hash, v, r, s);\n _throwError(error);\n return recovered;\n }\n\n /**\n * @dev Returns an Ethereum Signed Message, created from a `hash`. This\n * produces hash corresponding to the one signed with the\n * https://eth.wiki/json-rpc/API#eth_sign[`eth_sign`]\n * JSON-RPC method as part of EIP-191.\n *\n * See {recover}.\n */\n function toEthSignedMessageHash(bytes32 hash) internal pure returns (bytes32 message) {\n // 32 is the length in bytes of hash,\n // enforced by the type signature above\n /// @solidity memory-safe-assembly\n assembly {\n mstore(0x00, \"\\x19Ethereum Signed Message:\\n32\")\n mstore(0x1c, hash)\n message := keccak256(0x00, 0x3c)\n }\n }\n\n /**\n * @dev Returns an Ethereum Signed Message, created from `s`. This\n * produces hash corresponding to the one signed with the\n * https://eth.wiki/json-rpc/API#eth_sign[`eth_sign`]\n * JSON-RPC method as part of EIP-191.\n *\n * See {recover}.\n */\n function toEthSignedMessageHash(bytes memory s) internal pure returns (bytes32) {\n return keccak256(abi.encodePacked(\"\\x19Ethereum Signed Message:\\n\", Strings.toString(s.length), s));\n }\n\n /**\n * @dev Returns an Ethereum Signed Typed Data, created from a\n * `domainSeparator` and a `structHash`. This produces hash corresponding\n * to the one signed with the\n * https://eips.ethereum.org/EIPS/eip-712[`eth_signTypedData`]\n * JSON-RPC method as part of EIP-712.\n *\n * See {recover}.\n */\n function toTypedDataHash(bytes32 domainSeparator, bytes32 structHash) internal pure returns (bytes32 data) {\n /// @solidity memory-safe-assembly\n assembly {\n let ptr := mload(0x40)\n mstore(ptr, \"\\x19\\x01\")\n mstore(add(ptr, 0x02), domainSeparator)\n mstore(add(ptr, 0x22), structHash)\n data := keccak256(ptr, 0x42)\n }\n }\n\n /**\n * @dev Returns an Ethereum Signed Data with intended validator, created from a\n * `validator` and `data` according to the version 0 of EIP-191.\n *\n * See {recover}.\n */\n function toDataWithIntendedValidatorHash(address validator, bytes memory data) internal pure returns (bytes32) {\n return keccak256(abi.encodePacked(\"\\x19\\x00\", validator, data));\n }\n}\n"
- },
- "@openzeppelin/contracts/utils/cryptography/MerkleProof.sol": {
- "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.2) (utils/cryptography/MerkleProof.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @dev These functions deal with verification of Merkle Tree proofs.\n *\n * The tree and the proofs can be generated using our\n * https://github.com/OpenZeppelin/merkle-tree[JavaScript library].\n * You will find a quickstart guide in the readme.\n *\n * WARNING: You should avoid using leaf values that are 64 bytes long prior to\n * hashing, or use a hash function other than keccak256 for hashing leaves.\n * This is because the concatenation of a sorted pair of internal nodes in\n * the merkle tree could be reinterpreted as a leaf value.\n * OpenZeppelin's JavaScript library generates merkle trees that are safe\n * against this attack out of the box.\n */\nlibrary MerkleProof {\n /**\n * @dev Returns true if a `leaf` can be proved to be a part of a Merkle tree\n * defined by `root`. For this, a `proof` must be provided, containing\n * sibling hashes on the branch from the leaf to the root of the tree. Each\n * pair of leaves and each pair of pre-images are assumed to be sorted.\n */\n function verify(bytes32[] memory proof, bytes32 root, bytes32 leaf) internal pure returns (bool) {\n return processProof(proof, leaf) == root;\n }\n\n /**\n * @dev Calldata version of {verify}\n *\n * _Available since v4.7._\n */\n function verifyCalldata(bytes32[] calldata proof, bytes32 root, bytes32 leaf) internal pure returns (bool) {\n return processProofCalldata(proof, leaf) == root;\n }\n\n /**\n * @dev Returns the rebuilt hash obtained by traversing a Merkle tree up\n * from `leaf` using `proof`. A `proof` is valid if and only if the rebuilt\n * hash matches the root of the tree. When processing the proof, the pairs\n * of leafs & pre-images are assumed to be sorted.\n *\n * _Available since v4.4._\n */\n function processProof(bytes32[] memory proof, bytes32 leaf) internal pure returns (bytes32) {\n bytes32 computedHash = leaf;\n for (uint256 i = 0; i < proof.length; i++) {\n computedHash = _hashPair(computedHash, proof[i]);\n }\n return computedHash;\n }\n\n /**\n * @dev Calldata version of {processProof}\n *\n * _Available since v4.7._\n */\n function processProofCalldata(bytes32[] calldata proof, bytes32 leaf) internal pure returns (bytes32) {\n bytes32 computedHash = leaf;\n for (uint256 i = 0; i < proof.length; i++) {\n computedHash = _hashPair(computedHash, proof[i]);\n }\n return computedHash;\n }\n\n /**\n * @dev Returns true if the `leaves` can be simultaneously proven to be a part of a merkle tree defined by\n * `root`, according to `proof` and `proofFlags` as described in {processMultiProof}.\n *\n * CAUTION: Not all merkle trees admit multiproofs. See {processMultiProof} for details.\n *\n * _Available since v4.7._\n */\n function multiProofVerify(\n bytes32[] memory proof,\n bool[] memory proofFlags,\n bytes32 root,\n bytes32[] memory leaves\n ) internal pure returns (bool) {\n return processMultiProof(proof, proofFlags, leaves) == root;\n }\n\n /**\n * @dev Calldata version of {multiProofVerify}\n *\n * CAUTION: Not all merkle trees admit multiproofs. See {processMultiProof} for details.\n *\n * _Available since v4.7._\n */\n function multiProofVerifyCalldata(\n bytes32[] calldata proof,\n bool[] calldata proofFlags,\n bytes32 root,\n bytes32[] memory leaves\n ) internal pure returns (bool) {\n return processMultiProofCalldata(proof, proofFlags, leaves) == root;\n }\n\n /**\n * @dev Returns the root of a tree reconstructed from `leaves` and sibling nodes in `proof`. The reconstruction\n * proceeds by incrementally reconstructing all inner nodes by combining a leaf/inner node with either another\n * leaf/inner node or a proof sibling node, depending on whether each `proofFlags` item is true or false\n * respectively.\n *\n * CAUTION: Not all merkle trees admit multiproofs. To use multiproofs, it is sufficient to ensure that: 1) the tree\n * is complete (but not necessarily perfect), 2) the leaves to be proven are in the opposite order they are in the\n * tree (i.e., as seen from right to left starting at the deepest layer and continuing at the next layer).\n *\n * _Available since v4.7._\n */\n function processMultiProof(\n bytes32[] memory proof,\n bool[] memory proofFlags,\n bytes32[] memory leaves\n ) internal pure returns (bytes32 merkleRoot) {\n // This function rebuilds the root hash by traversing the tree up from the leaves. The root is rebuilt by\n // consuming and producing values on a queue. The queue starts with the `leaves` array, then goes onto the\n // `hashes` array. At the end of the process, the last hash in the `hashes` array should contain the root of\n // the merkle tree.\n uint256 leavesLen = leaves.length;\n uint256 proofLen = proof.length;\n uint256 totalHashes = proofFlags.length;\n\n // Check proof validity.\n require(leavesLen + proofLen - 1 == totalHashes, \"MerkleProof: invalid multiproof\");\n\n // The xxxPos values are \"pointers\" to the next value to consume in each array. All accesses are done using\n // `xxx[xxxPos++]`, which return the current value and increment the pointer, thus mimicking a queue's \"pop\".\n bytes32[] memory hashes = new bytes32[](totalHashes);\n uint256 leafPos = 0;\n uint256 hashPos = 0;\n uint256 proofPos = 0;\n // At each step, we compute the next hash using two values:\n // - a value from the \"main queue\". If not all leaves have been consumed, we get the next leaf, otherwise we\n // get the next hash.\n // - depending on the flag, either another value from the \"main queue\" (merging branches) or an element from the\n // `proof` array.\n for (uint256 i = 0; i < totalHashes; i++) {\n bytes32 a = leafPos < leavesLen ? leaves[leafPos++] : hashes[hashPos++];\n bytes32 b = proofFlags[i]\n ? (leafPos < leavesLen ? leaves[leafPos++] : hashes[hashPos++])\n : proof[proofPos++];\n hashes[i] = _hashPair(a, b);\n }\n\n if (totalHashes > 0) {\n require(proofPos == proofLen, \"MerkleProof: invalid multiproof\");\n unchecked {\n return hashes[totalHashes - 1];\n }\n } else if (leavesLen > 0) {\n return leaves[0];\n } else {\n return proof[0];\n }\n }\n\n /**\n * @dev Calldata version of {processMultiProof}.\n *\n * CAUTION: Not all merkle trees admit multiproofs. See {processMultiProof} for details.\n *\n * _Available since v4.7._\n */\n function processMultiProofCalldata(\n bytes32[] calldata proof,\n bool[] calldata proofFlags,\n bytes32[] memory leaves\n ) internal pure returns (bytes32 merkleRoot) {\n // This function rebuilds the root hash by traversing the tree up from the leaves. The root is rebuilt by\n // consuming and producing values on a queue. The queue starts with the `leaves` array, then goes onto the\n // `hashes` array. At the end of the process, the last hash in the `hashes` array should contain the root of\n // the merkle tree.\n uint256 leavesLen = leaves.length;\n uint256 proofLen = proof.length;\n uint256 totalHashes = proofFlags.length;\n\n // Check proof validity.\n require(leavesLen + proofLen - 1 == totalHashes, \"MerkleProof: invalid multiproof\");\n\n // The xxxPos values are \"pointers\" to the next value to consume in each array. All accesses are done using\n // `xxx[xxxPos++]`, which return the current value and increment the pointer, thus mimicking a queue's \"pop\".\n bytes32[] memory hashes = new bytes32[](totalHashes);\n uint256 leafPos = 0;\n uint256 hashPos = 0;\n uint256 proofPos = 0;\n // At each step, we compute the next hash using two values:\n // - a value from the \"main queue\". If not all leaves have been consumed, we get the next leaf, otherwise we\n // get the next hash.\n // - depending on the flag, either another value from the \"main queue\" (merging branches) or an element from the\n // `proof` array.\n for (uint256 i = 0; i < totalHashes; i++) {\n bytes32 a = leafPos < leavesLen ? leaves[leafPos++] : hashes[hashPos++];\n bytes32 b = proofFlags[i]\n ? (leafPos < leavesLen ? leaves[leafPos++] : hashes[hashPos++])\n : proof[proofPos++];\n hashes[i] = _hashPair(a, b);\n }\n\n if (totalHashes > 0) {\n require(proofPos == proofLen, \"MerkleProof: invalid multiproof\");\n unchecked {\n return hashes[totalHashes - 1];\n }\n } else if (leavesLen > 0) {\n return leaves[0];\n } else {\n return proof[0];\n }\n }\n\n function _hashPair(bytes32 a, bytes32 b) private pure returns (bytes32) {\n return a < b ? _efficientHash(a, b) : _efficientHash(b, a);\n }\n\n function _efficientHash(bytes32 a, bytes32 b) private pure returns (bytes32 value) {\n /// @solidity memory-safe-assembly\n assembly {\n mstore(0x00, a)\n mstore(0x20, b)\n value := keccak256(0x00, 0x40)\n }\n }\n}\n"
- },
- "@openzeppelin/contracts/utils/cryptography/SignatureChecker.sol": {
- "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (utils/cryptography/SignatureChecker.sol)\n\npragma solidity ^0.8.0;\n\nimport \"./ECDSA.sol\";\nimport \"../../interfaces/IERC1271.sol\";\n\n/**\n * @dev Signature verification helper that can be used instead of `ECDSA.recover` to seamlessly support both ECDSA\n * signatures from externally owned accounts (EOAs) as well as ERC1271 signatures from smart contract wallets like\n * Argent and Gnosis Safe.\n *\n * _Available since v4.1._\n */\nlibrary SignatureChecker {\n /**\n * @dev Checks if a signature is valid for a given signer and data hash. If the signer is a smart contract, the\n * signature is validated against that smart contract using ERC1271, otherwise it's validated using `ECDSA.recover`.\n *\n * NOTE: Unlike ECDSA signatures, contract signatures are revocable, and the outcome of this function can thus\n * change through time. It could return true at block N and false at block N+1 (or the opposite).\n */\n function isValidSignatureNow(address signer, bytes32 hash, bytes memory signature) internal view returns (bool) {\n (address recovered, ECDSA.RecoverError error) = ECDSA.tryRecover(hash, signature);\n return\n (error == ECDSA.RecoverError.NoError && recovered == signer) ||\n isValidERC1271SignatureNow(signer, hash, signature);\n }\n\n /**\n * @dev Checks if a signature is valid for a given signer and data hash. The signature is validated\n * against the signer smart contract using ERC1271.\n *\n * NOTE: Unlike ECDSA signatures, contract signatures are revocable, and the outcome of this function can thus\n * change through time. It could return true at block N and false at block N+1 (or the opposite).\n */\n function isValidERC1271SignatureNow(\n address signer,\n bytes32 hash,\n bytes memory signature\n ) internal view returns (bool) {\n (bool success, bytes memory result) = signer.staticcall(\n abi.encodeWithSelector(IERC1271.isValidSignature.selector, hash, signature)\n );\n return (success &&\n result.length >= 32 &&\n abi.decode(result, (bytes32)) == bytes32(IERC1271.isValidSignature.selector));\n }\n}\n"
- },
- "@openzeppelin/contracts/utils/math/Math.sol": {
- "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (utils/math/Math.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @dev Standard math utilities missing in the Solidity language.\n */\nlibrary Math {\n enum Rounding {\n Down, // Toward negative infinity\n Up, // Toward infinity\n Zero // Toward zero\n }\n\n /**\n * @dev Returns the largest of two numbers.\n */\n function max(uint256 a, uint256 b) internal pure returns (uint256) {\n return a > b ? a : b;\n }\n\n /**\n * @dev Returns the smallest of two numbers.\n */\n function min(uint256 a, uint256 b) internal pure returns (uint256) {\n return a < b ? a : b;\n }\n\n /**\n * @dev Returns the average of two numbers. The result is rounded towards\n * zero.\n */\n function average(uint256 a, uint256 b) internal pure returns (uint256) {\n // (a + b) / 2 can overflow.\n return (a & b) + (a ^ b) / 2;\n }\n\n /**\n * @dev Returns the ceiling of the division of two numbers.\n *\n * This differs from standard division with `/` in that it rounds up instead\n * of rounding down.\n */\n function ceilDiv(uint256 a, uint256 b) internal pure returns (uint256) {\n // (a + b - 1) / b can overflow on addition, so we distribute.\n return a == 0 ? 0 : (a - 1) / b + 1;\n }\n\n /**\n * @notice Calculates floor(x * y / denominator) with full precision. Throws if result overflows a uint256 or denominator == 0\n * @dev Original credit to Remco Bloemen under MIT license (https://xn--2-umb.com/21/muldiv)\n * with further edits by Uniswap Labs also under MIT license.\n */\n function mulDiv(uint256 x, uint256 y, uint256 denominator) internal pure returns (uint256 result) {\n unchecked {\n // 512-bit multiply [prod1 prod0] = x * y. Compute the product mod 2^256 and mod 2^256 - 1, then use\n // use the Chinese Remainder Theorem to reconstruct the 512 bit result. The result is stored in two 256\n // variables such that product = prod1 * 2^256 + prod0.\n uint256 prod0; // Least significant 256 bits of the product\n uint256 prod1; // Most significant 256 bits of the product\n assembly {\n let mm := mulmod(x, y, not(0))\n prod0 := mul(x, y)\n prod1 := sub(sub(mm, prod0), lt(mm, prod0))\n }\n\n // Handle non-overflow cases, 256 by 256 division.\n if (prod1 == 0) {\n // Solidity will revert if denominator == 0, unlike the div opcode on its own.\n // The surrounding unchecked block does not change this fact.\n // See https://docs.soliditylang.org/en/latest/control-structures.html#checked-or-unchecked-arithmetic.\n return prod0 / denominator;\n }\n\n // Make sure the result is less than 2^256. Also prevents denominator == 0.\n require(denominator > prod1, \"Math: mulDiv overflow\");\n\n ///////////////////////////////////////////////\n // 512 by 256 division.\n ///////////////////////////////////////////////\n\n // Make division exact by subtracting the remainder from [prod1 prod0].\n uint256 remainder;\n assembly {\n // Compute remainder using mulmod.\n remainder := mulmod(x, y, denominator)\n\n // Subtract 256 bit number from 512 bit number.\n prod1 := sub(prod1, gt(remainder, prod0))\n prod0 := sub(prod0, remainder)\n }\n\n // Factor powers of two out of denominator and compute largest power of two divisor of denominator. Always >= 1.\n // See https://cs.stackexchange.com/q/138556/92363.\n\n // Does not overflow because the denominator cannot be zero at this stage in the function.\n uint256 twos = denominator & (~denominator + 1);\n assembly {\n // Divide denominator by twos.\n denominator := div(denominator, twos)\n\n // Divide [prod1 prod0] by twos.\n prod0 := div(prod0, twos)\n\n // Flip twos such that it is 2^256 / twos. If twos is zero, then it becomes one.\n twos := add(div(sub(0, twos), twos), 1)\n }\n\n // Shift in bits from prod1 into prod0.\n prod0 |= prod1 * twos;\n\n // Invert denominator mod 2^256. Now that denominator is an odd number, it has an inverse modulo 2^256 such\n // that denominator * inv = 1 mod 2^256. Compute the inverse by starting with a seed that is correct for\n // four bits. That is, denominator * inv = 1 mod 2^4.\n uint256 inverse = (3 * denominator) ^ 2;\n\n // Use the Newton-Raphson iteration to improve the precision. Thanks to Hensel's lifting lemma, this also works\n // in modular arithmetic, doubling the correct bits in each step.\n inverse *= 2 - denominator * inverse; // inverse mod 2^8\n inverse *= 2 - denominator * inverse; // inverse mod 2^16\n inverse *= 2 - denominator * inverse; // inverse mod 2^32\n inverse *= 2 - denominator * inverse; // inverse mod 2^64\n inverse *= 2 - denominator * inverse; // inverse mod 2^128\n inverse *= 2 - denominator * inverse; // inverse mod 2^256\n\n // Because the division is now exact we can divide by multiplying with the modular inverse of denominator.\n // This will give us the correct result modulo 2^256. Since the preconditions guarantee that the outcome is\n // less than 2^256, this is the final result. We don't need to compute the high bits of the result and prod1\n // is no longer required.\n result = prod0 * inverse;\n return result;\n }\n }\n\n /**\n * @notice Calculates x * y / denominator with full precision, following the selected rounding direction.\n */\n function mulDiv(uint256 x, uint256 y, uint256 denominator, Rounding rounding) internal pure returns (uint256) {\n uint256 result = mulDiv(x, y, denominator);\n if (rounding == Rounding.Up && mulmod(x, y, denominator) > 0) {\n result += 1;\n }\n return result;\n }\n\n /**\n * @dev Returns the square root of a number. If the number is not a perfect square, the value is rounded down.\n *\n * Inspired by Henry S. Warren, Jr.'s \"Hacker's Delight\" (Chapter 11).\n */\n function sqrt(uint256 a) internal pure returns (uint256) {\n if (a == 0) {\n return 0;\n }\n\n // For our first guess, we get the biggest power of 2 which is smaller than the square root of the target.\n //\n // We know that the \"msb\" (most significant bit) of our target number `a` is a power of 2 such that we have\n // `msb(a) <= a < 2*msb(a)`. This value can be written `msb(a)=2**k` with `k=log2(a)`.\n //\n // This can be rewritten `2**log2(a) <= a < 2**(log2(a) + 1)`\n // → `sqrt(2**k) <= sqrt(a) < sqrt(2**(k+1))`\n // → `2**(k/2) <= sqrt(a) < 2**((k+1)/2) <= 2**(k/2 + 1)`\n //\n // Consequently, `2**(log2(a) / 2)` is a good first approximation of `sqrt(a)` with at least 1 correct bit.\n uint256 result = 1 << (log2(a) >> 1);\n\n // At this point `result` is an estimation with one bit of precision. We know the true value is a uint128,\n // since it is the square root of a uint256. Newton's method converges quadratically (precision doubles at\n // every iteration). We thus need at most 7 iteration to turn our partial result with one bit of precision\n // into the expected uint128 result.\n unchecked {\n result = (result + a / result) >> 1;\n result = (result + a / result) >> 1;\n result = (result + a / result) >> 1;\n result = (result + a / result) >> 1;\n result = (result + a / result) >> 1;\n result = (result + a / result) >> 1;\n result = (result + a / result) >> 1;\n return min(result, a / result);\n }\n }\n\n /**\n * @notice Calculates sqrt(a), following the selected rounding direction.\n */\n function sqrt(uint256 a, Rounding rounding) internal pure returns (uint256) {\n unchecked {\n uint256 result = sqrt(a);\n return result + (rounding == Rounding.Up && result * result < a ? 1 : 0);\n }\n }\n\n /**\n * @dev Return the log in base 2, rounded down, of a positive value.\n * Returns 0 if given 0.\n */\n function log2(uint256 value) internal pure returns (uint256) {\n uint256 result = 0;\n unchecked {\n if (value >> 128 > 0) {\n value >>= 128;\n result += 128;\n }\n if (value >> 64 > 0) {\n value >>= 64;\n result += 64;\n }\n if (value >> 32 > 0) {\n value >>= 32;\n result += 32;\n }\n if (value >> 16 > 0) {\n value >>= 16;\n result += 16;\n }\n if (value >> 8 > 0) {\n value >>= 8;\n result += 8;\n }\n if (value >> 4 > 0) {\n value >>= 4;\n result += 4;\n }\n if (value >> 2 > 0) {\n value >>= 2;\n result += 2;\n }\n if (value >> 1 > 0) {\n result += 1;\n }\n }\n return result;\n }\n\n /**\n * @dev Return the log in base 2, following the selected rounding direction, of a positive value.\n * Returns 0 if given 0.\n */\n function log2(uint256 value, Rounding rounding) internal pure returns (uint256) {\n unchecked {\n uint256 result = log2(value);\n return result + (rounding == Rounding.Up && 1 << result < value ? 1 : 0);\n }\n }\n\n /**\n * @dev Return the log in base 10, rounded down, of a positive value.\n * Returns 0 if given 0.\n */\n function log10(uint256 value) internal pure returns (uint256) {\n uint256 result = 0;\n unchecked {\n if (value >= 10 ** 64) {\n value /= 10 ** 64;\n result += 64;\n }\n if (value >= 10 ** 32) {\n value /= 10 ** 32;\n result += 32;\n }\n if (value >= 10 ** 16) {\n value /= 10 ** 16;\n result += 16;\n }\n if (value >= 10 ** 8) {\n value /= 10 ** 8;\n result += 8;\n }\n if (value >= 10 ** 4) {\n value /= 10 ** 4;\n result += 4;\n }\n if (value >= 10 ** 2) {\n value /= 10 ** 2;\n result += 2;\n }\n if (value >= 10 ** 1) {\n result += 1;\n }\n }\n return result;\n }\n\n /**\n * @dev Return the log in base 10, following the selected rounding direction, of a positive value.\n * Returns 0 if given 0.\n */\n function log10(uint256 value, Rounding rounding) internal pure returns (uint256) {\n unchecked {\n uint256 result = log10(value);\n return result + (rounding == Rounding.Up && 10 ** result < value ? 1 : 0);\n }\n }\n\n /**\n * @dev Return the log in base 256, rounded down, of a positive value.\n * Returns 0 if given 0.\n *\n * Adding one to the result gives the number of pairs of hex symbols needed to represent `value` as a hex string.\n */\n function log256(uint256 value) internal pure returns (uint256) {\n uint256 result = 0;\n unchecked {\n if (value >> 128 > 0) {\n value >>= 128;\n result += 16;\n }\n if (value >> 64 > 0) {\n value >>= 64;\n result += 8;\n }\n if (value >> 32 > 0) {\n value >>= 32;\n result += 4;\n }\n if (value >> 16 > 0) {\n value >>= 16;\n result += 2;\n }\n if (value >> 8 > 0) {\n result += 1;\n }\n }\n return result;\n }\n\n /**\n * @dev Return the log in base 256, following the selected rounding direction, of a positive value.\n * Returns 0 if given 0.\n */\n function log256(uint256 value, Rounding rounding) internal pure returns (uint256) {\n unchecked {\n uint256 result = log256(value);\n return result + (rounding == Rounding.Up && 1 << (result << 3) < value ? 1 : 0);\n }\n }\n}\n"
- },
- "@openzeppelin/contracts/utils/math/SignedMath.sol": {
- "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.8.0) (utils/math/SignedMath.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @dev Standard signed math utilities missing in the Solidity language.\n */\nlibrary SignedMath {\n /**\n * @dev Returns the largest of two signed numbers.\n */\n function max(int256 a, int256 b) internal pure returns (int256) {\n return a > b ? a : b;\n }\n\n /**\n * @dev Returns the smallest of two signed numbers.\n */\n function min(int256 a, int256 b) internal pure returns (int256) {\n return a < b ? a : b;\n }\n\n /**\n * @dev Returns the average of two signed numbers without overflow.\n * The result is rounded towards zero.\n */\n function average(int256 a, int256 b) internal pure returns (int256) {\n // Formula from the book \"Hacker's Delight\"\n int256 x = (a & b) + ((a ^ b) >> 1);\n return x + (int256(uint256(x) >> 255) & (a ^ b));\n }\n\n /**\n * @dev Returns the absolute unsigned value of a signed value.\n */\n function abs(int256 n) internal pure returns (uint256) {\n unchecked {\n // must be unchecked in order to support `n = type(int256).min`\n return uint256(n >= 0 ? n : -n);\n }\n }\n}\n"
- },
- "@openzeppelin/contracts/utils/Strings.sol": {
- "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (utils/Strings.sol)\n\npragma solidity ^0.8.0;\n\nimport \"./math/Math.sol\";\nimport \"./math/SignedMath.sol\";\n\n/**\n * @dev String operations.\n */\nlibrary Strings {\n bytes16 private constant _SYMBOLS = \"0123456789abcdef\";\n uint8 private constant _ADDRESS_LENGTH = 20;\n\n /**\n * @dev Converts a `uint256` to its ASCII `string` decimal representation.\n */\n function toString(uint256 value) internal pure returns (string memory) {\n unchecked {\n uint256 length = Math.log10(value) + 1;\n string memory buffer = new string(length);\n uint256 ptr;\n /// @solidity memory-safe-assembly\n assembly {\n ptr := add(buffer, add(32, length))\n }\n while (true) {\n ptr--;\n /// @solidity memory-safe-assembly\n assembly {\n mstore8(ptr, byte(mod(value, 10), _SYMBOLS))\n }\n value /= 10;\n if (value == 0) break;\n }\n return buffer;\n }\n }\n\n /**\n * @dev Converts a `int256` to its ASCII `string` decimal representation.\n */\n function toString(int256 value) internal pure returns (string memory) {\n return string(abi.encodePacked(value < 0 ? \"-\" : \"\", toString(SignedMath.abs(value))));\n }\n\n /**\n * @dev Converts a `uint256` to its ASCII `string` hexadecimal representation.\n */\n function toHexString(uint256 value) internal pure returns (string memory) {\n unchecked {\n return toHexString(value, Math.log256(value) + 1);\n }\n }\n\n /**\n * @dev Converts a `uint256` to its ASCII `string` hexadecimal representation with fixed length.\n */\n function toHexString(uint256 value, uint256 length) internal pure returns (string memory) {\n bytes memory buffer = new bytes(2 * length + 2);\n buffer[0] = \"0\";\n buffer[1] = \"x\";\n for (uint256 i = 2 * length + 1; i > 1; --i) {\n buffer[i] = _SYMBOLS[value & 0xf];\n value >>= 4;\n }\n require(value == 0, \"Strings: hex length insufficient\");\n return string(buffer);\n }\n\n /**\n * @dev Converts an `address` with fixed length of 20 bytes to its not checksummed ASCII `string` hexadecimal representation.\n */\n function toHexString(address addr) internal pure returns (string memory) {\n return toHexString(uint256(uint160(addr)), _ADDRESS_LENGTH);\n }\n\n /**\n * @dev Returns true if the two strings are equal.\n */\n function equal(string memory a, string memory b) internal pure returns (bool) {\n return keccak256(bytes(a)) == keccak256(bytes(b));\n }\n}\n"
- },
- "@uma/core/contracts/common/implementation/MultiCaller.sol": {
- "content": "// SPDX-License-Identifier: AGPL-3.0-only\npragma solidity ^0.8.0;\n\n// This contract is taken from Uniswap's multi call implementation (https://github.com/Uniswap/uniswap-v3-periphery/blob/main/contracts/base/Multicall.sol)\n// and was modified to be solidity 0.8 compatible. Additionally, the method was restricted to only work with msg.value\n// set to 0 to avoid any nasty attack vectors on function calls that use value sent with deposits.\n\n/// @title MultiCaller\n/// @notice Enables calling multiple methods in a single call to the contract\ncontract MultiCaller {\n function multicall(bytes[] calldata data) external returns (bytes[] memory results) {\n results = new bytes[](data.length);\n for (uint256 i = 0; i < data.length; i++) {\n (bool success, bytes memory result) = address(this).delegatecall(data[i]);\n\n if (!success) {\n // Next 5 lines from https://ethereum.stackexchange.com/a/83577\n if (result.length < 68) revert();\n assembly {\n result := add(result, 0x04)\n }\n revert(abi.decode(result, (string)));\n }\n\n results[i] = result;\n }\n }\n}\n"
- },
- "contracts/AlephZero_SpokePool.sol": {
- "content": "// SPDX-License-Identifier: BUSL-1.1\n\n// Arbitrum only supports v0.8.19\n// See https://docs.arbitrum.io/for-devs/concepts/differences-between-arbitrum-ethereum/solidity-support#differences-from-solidity-on-ethereum\npragma solidity ^0.8.19;\n\nimport \"./Arbitrum_SpokePool.sol\";\n\n/**\n * @notice AVM specific SpokePool. Uses AVM cross-domain-enabled logic to implement admin only access to functions.\n * @custom:security-contact bugs@across.to\n */\ncontract AlephZero_SpokePool is Arbitrum_SpokePool {\n /// @custom:oz-upgrades-unsafe-allow constructor\n constructor(\n address _wrappedNativeTokenAddress,\n uint32 _depositQuoteTimeBuffer,\n uint32 _fillDeadlineBuffer,\n IERC20 _l2Usdc,\n ITokenMessenger _cctpTokenMessenger\n )\n Arbitrum_SpokePool(\n _wrappedNativeTokenAddress,\n _depositQuoteTimeBuffer,\n _fillDeadlineBuffer,\n _l2Usdc,\n _cctpTokenMessenger\n )\n {} // solhint-disable-line no-empty-blocks\n}\n"
- },
- "contracts/Arbitrum_SpokePool.sol": {
- "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\n\nimport \"./SpokePool.sol\";\nimport \"./libraries/CircleCCTPAdapter.sol\";\nimport { CrossDomainAddressUtils } from \"./libraries/CrossDomainAddressUtils.sol\";\nimport { ArbitrumL2ERC20GatewayLike } from \"./interfaces/ArbitrumBridge.sol\";\n\n/**\n * @notice AVM specific SpokePool. Uses AVM cross-domain-enabled logic to implement admin only access to functions.\n * @custom:security-contact bugs@across.to\n */\ncontract Arbitrum_SpokePool is SpokePool, CircleCCTPAdapter {\n // Address of the Arbitrum L2 token gateway to send funds to L1.\n address public l2GatewayRouter;\n\n // Admin controlled mapping of arbitrum tokens to L1 counterpart. L1 counterpart addresses\n // are necessary params used when bridging tokens to L1.\n mapping(address => address) public whitelistedTokens;\n\n event SetL2GatewayRouter(address indexed newL2GatewayRouter);\n event WhitelistedTokens(address indexed l2Token, address indexed l1Token);\n\n /// @custom:oz-upgrades-unsafe-allow constructor\n constructor(\n address _wrappedNativeTokenAddress,\n uint32 _depositQuoteTimeBuffer,\n uint32 _fillDeadlineBuffer,\n IERC20 _l2Usdc,\n ITokenMessenger _cctpTokenMessenger\n )\n SpokePool(_wrappedNativeTokenAddress, _depositQuoteTimeBuffer, _fillDeadlineBuffer)\n CircleCCTPAdapter(_l2Usdc, _cctpTokenMessenger, CircleDomainIds.Ethereum)\n {} // solhint-disable-line no-empty-blocks\n\n /**\n * @notice Construct the AVM SpokePool.\n * @param _initialDepositId Starting deposit ID. Set to 0 unless this is a re-deployment in order to mitigate\n * relay hash collisions.\n * @param _l2GatewayRouter Address of L2 token gateway. Can be reset by admin.\n * @param _crossDomainAdmin Cross domain admin to set. Can be changed by admin.\n * @param _withdrawalRecipient Address which receives token withdrawals. Can be changed by admin. For Spoke Pools on L2, this will\n * likely be the hub pool.\n */\n function initialize(\n uint32 _initialDepositId,\n address _l2GatewayRouter,\n address _crossDomainAdmin,\n address _withdrawalRecipient\n ) public initializer {\n __SpokePool_init(_initialDepositId, _crossDomainAdmin, _withdrawalRecipient);\n _setL2GatewayRouter(_l2GatewayRouter);\n }\n\n modifier onlyFromCrossDomainAdmin() {\n require(msg.sender == CrossDomainAddressUtils.applyL1ToL2Alias(crossDomainAdmin), \"ONLY_COUNTERPART_GATEWAY\");\n _;\n }\n\n /********************************************************\n * ARBITRUM-SPECIFIC CROSS-CHAIN ADMIN FUNCTIONS *\n ********************************************************/\n\n /**\n * @notice Change L2 gateway router. Callable only by admin.\n * @param newL2GatewayRouter New L2 gateway router.\n */\n function setL2GatewayRouter(address newL2GatewayRouter) public onlyAdmin nonReentrant {\n _setL2GatewayRouter(newL2GatewayRouter);\n }\n\n /**\n * @notice Add L2 -> L1 token mapping. Callable only by admin.\n * @param l2Token Arbitrum token.\n * @param l1Token Ethereum version of l2Token.\n */\n function whitelistToken(address l2Token, address l1Token) public onlyAdmin nonReentrant {\n _whitelistToken(l2Token, l1Token);\n }\n\n /**************************************\n * INTERNAL FUNCTIONS *\n **************************************/\n\n function _bridgeTokensToHubPool(uint256 amountToReturn, address l2TokenAddress) internal override {\n // If the l2TokenAddress is UDSC, we need to use the CCTP bridge.\n if (_isCCTPEnabled() && l2TokenAddress == address(usdcToken)) {\n _transferUsdc(withdrawalRecipient, amountToReturn);\n } else {\n // Check that the Ethereum counterpart of the L2 token is stored on this contract.\n address ethereumTokenToBridge = whitelistedTokens[l2TokenAddress];\n require(ethereumTokenToBridge != address(0), \"Uninitialized mainnet token\");\n //slither-disable-next-line unused-return\n ArbitrumL2ERC20GatewayLike(l2GatewayRouter).outboundTransfer(\n ethereumTokenToBridge, // _l1Token. Address of the L1 token to bridge over.\n withdrawalRecipient, // _to. Withdraw, over the bridge, to the l1 hub pool contract.\n amountToReturn, // _amount.\n \"\" // _data. We don't need to send any data for the bridging action.\n );\n }\n }\n\n function _setL2GatewayRouter(address _l2GatewayRouter) internal {\n l2GatewayRouter = _l2GatewayRouter;\n emit SetL2GatewayRouter(l2GatewayRouter);\n }\n\n function _whitelistToken(address _l2Token, address _l1Token) internal {\n whitelistedTokens[_l2Token] = _l1Token;\n emit WhitelistedTokens(_l2Token, _l1Token);\n }\n\n // Apply AVM-specific transformation to cross domain admin address on L1.\n function _requireAdminSender() internal override onlyFromCrossDomainAdmin {}\n}\n"
- },
- "contracts/Boba_SpokePool.sol": {
- "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\n\nimport \"./Ovm_SpokePool.sol\";\n\n/**\n * @notice Boba Spoke pool. Note that the l2ETH and l2WETH are the opposite as that in Optimism.\n */\ncontract Boba_SpokePool is Ovm_SpokePool {\n /// @custom:oz-upgrades-unsafe-allow constructor\n constructor(\n address _wrappedNativeTokenAddress,\n uint32 _depositQuoteTimeBuffer,\n uint32 _fillDeadlineBuffer\n )\n Ovm_SpokePool(\n _wrappedNativeTokenAddress,\n _depositQuoteTimeBuffer,\n _fillDeadlineBuffer,\n IERC20(address(0)),\n ITokenMessenger(address(0))\n )\n {} // solhint-disable-line no-empty-blocks\n\n /**\n * @notice Construct the OVM Boba SpokePool.\n * @param _initialDepositId Starting deposit ID. Set to 0 unless this is a re-deployment in order to mitigate\n * relay hash collisions.\n * @param _crossDomainAdmin Cross domain admin to set. Can be changed by admin.\n * @param _withdrawalRecipient Address which receives token withdrawals. Can be changed by admin. For Spoke Pools on L2, this will\n * likely be the hub pool.\n */\n function initialize(\n uint32 _initialDepositId,\n address _crossDomainAdmin,\n address _withdrawalRecipient\n ) public initializer {\n __OvmSpokePool_init(\n _initialDepositId,\n _crossDomainAdmin,\n _withdrawalRecipient,\n 0x4200000000000000000000000000000000000006\n );\n }\n}\n"
- },
- "contracts/chain-adapters/Arbitrum_Adapter.sol": {
- "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\n\nimport \"./interfaces/AdapterInterface.sol\";\n\nimport \"@openzeppelin/contracts/token/ERC20/IERC20.sol\";\nimport \"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\";\nimport \"../external/interfaces/CCTPInterfaces.sol\";\nimport \"../libraries/CircleCCTPAdapter.sol\";\nimport { ArbitrumInboxLike as ArbitrumL1InboxLike, ArbitrumL1ERC20GatewayLike } from \"../interfaces/ArbitrumBridge.sol\";\n\n/**\n * @notice Contract containing logic to send messages from L1 to Arbitrum.\n * @dev Public functions calling external contracts do not guard against reentrancy because they are expected to be\n * called via delegatecall, which will execute this contract's logic within the context of the originating contract.\n * For example, the HubPool will delegatecall these functions, therefore its only necessary that the HubPool's methods\n * that call this contract's logic guard against reentrancy.\n */\n\n// solhint-disable-next-line contract-name-camelcase\ncontract Arbitrum_Adapter is AdapterInterface, CircleCCTPAdapter {\n using SafeERC20 for IERC20;\n\n // Amount of ETH allocated to pay for the base submission fee. The base submission fee is a parameter unique to\n // retryable transactions; the user is charged the base submission fee to cover the storage costs of keeping their\n // ticket’s calldata in the retry buffer. (current base submission fee is queryable via\n // ArbRetryableTx.getSubmissionPrice). ArbRetryableTicket precompile interface exists at L2 address\n // 0x000000000000000000000000000000000000006E.\n uint256 public constant L2_MAX_SUBMISSION_COST = 0.01e18;\n\n // L2 Gas price bid for immediate L2 execution attempt (queryable via standard eth*gasPrice RPC)\n uint256 public constant L2_GAS_PRICE = 5e9; // 5 gWei\n\n // Native token expected to be sent in L2 message. Should be 0 for only use case of this constant, which\n // includes is sending messages from L1 to L2.\n uint256 public constant L2_CALL_VALUE = 0;\n\n // Gas limit for L2 execution of a cross chain token transfer sent via the inbox.\n uint32 public constant RELAY_TOKENS_L2_GAS_LIMIT = 300_000;\n // Gas limit for L2 execution of a message sent via the inbox.\n uint32 public constant RELAY_MESSAGE_L2_GAS_LIMIT = 2_000_000;\n\n address public constant L1_DAI = 0x6B175474E89094C44Da98b954EedeAC495271d0F;\n\n // This address on L2 receives extra ETH that is left over after relaying a message via the inbox.\n address public immutable L2_REFUND_L2_ADDRESS;\n\n // Inbox system contract to send messages to Arbitrum. Token bridges use this to send tokens to L2.\n // https://github.com/OffchainLabs/nitro-contracts/blob/f7894d3a6d4035ba60f51a7f1334f0f2d4f02dce/src/bridge/Inbox.sol\n ArbitrumL1InboxLike public immutable L1_INBOX;\n\n // Router contract to send tokens to Arbitrum. Routes to correct gateway to bridge tokens. Internally this\n // contract calls the Inbox.\n // Generic gateway: https://github.com/OffchainLabs/token-bridge-contracts/blob/main/contracts/tokenbridge/ethereum/gateway/L1ArbitrumGateway.sol\n ArbitrumL1ERC20GatewayLike public immutable L1_ERC20_GATEWAY_ROUTER;\n\n /**\n * @notice Constructs new Adapter.\n * @param _l1ArbitrumInbox Inbox helper contract to send messages to Arbitrum.\n * @param _l1ERC20GatewayRouter ERC20 gateway router contract to send tokens to Arbitrum.\n * @param _l2RefundL2Address L2 address to receive gas refunds on after a message is relayed.\n * @param _l1Usdc USDC address on L1.\n * @param _cctpTokenMessenger TokenMessenger contract to bridge via CCTP.\n */\n constructor(\n ArbitrumL1InboxLike _l1ArbitrumInbox,\n ArbitrumL1ERC20GatewayLike _l1ERC20GatewayRouter,\n address _l2RefundL2Address,\n IERC20 _l1Usdc,\n ITokenMessenger _cctpTokenMessenger\n ) CircleCCTPAdapter(_l1Usdc, _cctpTokenMessenger, CircleDomainIds.Arbitrum) {\n L1_INBOX = _l1ArbitrumInbox;\n L1_ERC20_GATEWAY_ROUTER = _l1ERC20GatewayRouter;\n L2_REFUND_L2_ADDRESS = _l2RefundL2Address;\n }\n\n /**\n * @notice Send cross-chain message to target on Arbitrum.\n * @notice This contract must hold at least getL1CallValue() amount of ETH to send a message via the Inbox\n * successfully, or the message will get stuck.\n * @param target Contract on Arbitrum that will receive message.\n * @param message Data to send to target.\n */\n function relayMessage(address target, bytes memory message) external payable override {\n uint256 requiredL1CallValue = _contractHasSufficientEthBalance(RELAY_MESSAGE_L2_GAS_LIMIT);\n\n L1_INBOX.createRetryableTicket{ value: requiredL1CallValue }(\n target, // destAddr destination L2 contract address\n L2_CALL_VALUE, // l2CallValue call value for retryable L2 message\n L2_MAX_SUBMISSION_COST, // maxSubmissionCost Max gas deducted from user's L2 balance to cover base fee\n L2_REFUND_L2_ADDRESS, // excessFeeRefundAddress maxgas * gasprice - execution cost gets credited here on L2\n L2_REFUND_L2_ADDRESS, // callValueRefundAddress l2Callvalue gets credited here on L2 if retryable txn times out or gets cancelled\n RELAY_MESSAGE_L2_GAS_LIMIT, // maxGas Max gas deducted from user's L2 balance to cover L2 execution\n L2_GAS_PRICE, // gasPriceBid price bid for L2 execution\n message // data ABI encoded data of L2 message\n );\n\n emit MessageRelayed(target, message);\n }\n\n /**\n * @notice Bridge tokens to Arbitrum.\n * @notice This contract must hold at least getL1CallValue() amount of ETH to send a message via the Inbox\n * successfully, or the message will get stuck.\n * @param l1Token L1 token to deposit.\n * @param l2Token L2 token to receive.\n * @param amount Amount of L1 tokens to deposit and L2 tokens to receive.\n * @param to Bridge recipient.\n */\n function relayTokens(\n address l1Token,\n address l2Token, // l2Token is unused for Arbitrum.\n uint256 amount,\n address to\n ) external payable override {\n // Check if this token is USDC, which requires a custom bridge via CCTP.\n if (_isCCTPEnabled() && l1Token == address(usdcToken)) {\n _transferUsdc(to, amount);\n }\n // If not, we can use the Arbitrum gateway\n else {\n uint256 requiredL1CallValue = _contractHasSufficientEthBalance(RELAY_TOKENS_L2_GAS_LIMIT);\n\n // Approve the gateway, not the router, to spend the hub pool's balance. The gateway, which is different\n // per L1 token, will temporarily escrow the tokens to be bridged and pull them from this contract.\n address erc20Gateway = L1_ERC20_GATEWAY_ROUTER.getGateway(l1Token);\n IERC20(l1Token).safeIncreaseAllowance(erc20Gateway, amount);\n\n // `outboundTransfer` expects that the caller includes a bytes message as the last param that includes the\n // maxSubmissionCost to use when creating an L2 retryable ticket: https://github.com/OffchainLabs/arbitrum/blob/e98d14873dd77513b569771f47b5e05b72402c5e/packages/arb-bridge-peripherals/contracts/tokenbridge/ethereum/gateway/L1GatewayRouter.sol#L232\n bytes memory data = abi.encode(L2_MAX_SUBMISSION_COST, \"\");\n\n // Note: Legacy routers don't have the outboundTransferCustomRefund method, so default to using\n // outboundTransfer(). Legacy routers are used for the following tokens that are currently enabled:\n // - DAI: the implementation of `outboundTransfer` at the current DAI custom gateway\n // (https://etherscan.io/address/0xD3B5b60020504bc3489D6949d545893982BA3011#writeContract) sets the\n // sender as the refund address so the aliased HubPool should receive excess funds. Implementation here:\n // https://github.com/makerdao/arbitrum-dai-bridge/blob/11a80385e2622968069c34d401b3d54a59060e87/contracts/l1/L1DaiGateway.sol#L109\n if (l1Token == L1_DAI) {\n // This means that the excess ETH to pay for the L2 transaction will be sent to the aliased\n // contract address on L2, which we'd have to retrieve via a custom adapter, the Arbitrum_RescueAdapter.\n // To do so, in a single transaction: 1) setCrossChainContracts to Arbitrum_RescueAdapter, 2) relayMessage\n // with function data = abi.encode(amountToRescue), 3) setCrossChainContracts back to this adapter.\n L1_ERC20_GATEWAY_ROUTER.outboundTransfer{ value: requiredL1CallValue }(\n l1Token,\n to,\n amount,\n RELAY_TOKENS_L2_GAS_LIMIT,\n L2_GAS_PRICE,\n data\n );\n } else {\n L1_ERC20_GATEWAY_ROUTER.outboundTransferCustomRefund{ value: requiredL1CallValue }(\n l1Token,\n L2_REFUND_L2_ADDRESS,\n to,\n amount,\n RELAY_TOKENS_L2_GAS_LIMIT,\n L2_GAS_PRICE,\n data\n );\n }\n }\n emit TokensRelayed(l1Token, l2Token, amount, to);\n }\n\n /**\n * @notice Returns required amount of ETH to send a message via the Inbox.\n * @param l2GasLimit L2 gas limit for the message.\n * @return amount of ETH that this contract needs to hold in order for relayMessage to succeed.\n */\n function getL1CallValue(uint32 l2GasLimit) public pure returns (uint256) {\n return L2_MAX_SUBMISSION_COST + L2_GAS_PRICE * l2GasLimit;\n }\n\n function _contractHasSufficientEthBalance(uint32 l2GasLimit) internal view returns (uint256) {\n uint256 requiredL1CallValue = getL1CallValue(l2GasLimit);\n require(address(this).balance >= requiredL1CallValue, \"Insufficient ETH balance\");\n return requiredL1CallValue;\n }\n}\n"
- },
- "contracts/chain-adapters/Arbitrum_CustomGasToken_Adapter.sol": {
- "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\n\nimport { AdapterInterface } from \"./interfaces/AdapterInterface.sol\";\n\nimport { IERC20 } from \"@openzeppelin/contracts/token/ERC20/IERC20.sol\";\nimport { SafeERC20 } from \"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\";\nimport { ITokenMessenger as ICCTPTokenMessenger } from \"../external/interfaces/CCTPInterfaces.sol\";\nimport { CircleCCTPAdapter, CircleDomainIds } from \"../libraries/CircleCCTPAdapter.sol\";\nimport { ArbitrumERC20Bridge as ArbitrumL1ERC20Bridge, ArbitrumCustomGasTokenInbox as ArbitrumL1InboxLike, ArbitrumL1ERC20GatewayLike } from \"../interfaces/ArbitrumBridge.sol\";\n\n/**\n * @notice Interface for funder contract that this contract pulls from to pay for relayMessage()/relayTokens()\n * fees using a custom gas token.\n */\ninterface FunderInterface {\n /**\n * @notice Withdraws amount of token from funder contract to the caller.\n * @dev Can only be called by owner of Funder contract, which therefore must be\n * this contract.\n * @param token Token to withdraw.\n * @param amount Amount to withdraw.\n */\n function withdraw(IERC20 token, uint256 amount) external;\n}\n\n/**\n * @notice Contract containing logic to send messages from L1 to Arbitrum.\n * @dev Public functions calling external contracts do not guard against reentrancy because they are expected to be\n * called via delegatecall, which will execute this contract's logic within the context of the originating contract.\n * For example, the HubPool will delegatecall these functions, therefore its only necessary that the HubPool's methods\n * that call this contract's logic guard against reentrancy.\n * @dev This contract is very similar to Arbitrum_Adapter but it allows the caller to pay for submission\n * fees using a custom gas token. This is required to support certain Arbitrum orbit L2s and L3s.\n * @dev https://docs.arbitrum.io/launch-orbit-chain/how-tos/use-a-custom-gas-token\n */\n\n// solhint-disable-next-line contract-name-camelcase\ncontract Arbitrum_CustomGasToken_Adapter is AdapterInterface, CircleCCTPAdapter {\n using SafeERC20 for IERC20;\n\n // Amount of gas token allocated to pay for the base submission fee. The base submission fee is a parameter unique to\n // retryable transactions; the user is charged the base submission fee to cover the storage costs of keeping their\n // ticket’s calldata in the retry buffer. (current base submission fee is queryable via\n // ArbRetryableTx.getSubmissionPrice). ArbRetryableTicket precompile interface exists at L2 address\n // 0x000000000000000000000000000000000000006E.\n // The Arbitrum Inbox requires that this uses 18 decimal precision.\n uint256 public immutable L2_MAX_SUBMISSION_COST;\n\n // L2 Gas price bid for immediate L2 execution attempt (queryable via standard eth*gasPrice RPC)\n // The Arbitrum Inbox requires that this is specified in gWei (e.g. 1e9 = 1 gWei)\n uint256 public immutable L2_GAS_PRICE;\n\n // Native token expected to be sent in L2 message. Should be 0 for most use cases of this constant. This\n // constant is unused when sending the native gas token over the inbox since the inbox interprets `l2CallValue`\n // as the amount of the L2 native token to send.\n uint256 public constant L2_CALL_VALUE = 0;\n\n // Gas limit for L2 execution of a cross chain token transfer sent via the inbox.\n uint32 public constant RELAY_TOKENS_L2_GAS_LIMIT = 300_000;\n // Gas limit for L2 execution of a message sent via the inbox.\n uint32 public constant RELAY_MESSAGE_L2_GAS_LIMIT = 2_000_000;\n\n // The number of decimals of precision for the custom gas token. This is defined in the constructor and not dynamically fetched since decimals are\n // not part of the standard ERC20 interface.\n uint8 public immutable NATIVE_TOKEN_DECIMALS;\n\n // This address on L2 receives extra gas token that is left over after relaying a message via the inbox.\n address public immutable L2_REFUND_L2_ADDRESS;\n\n // Inbox system contract to send messages to Arbitrum. Token bridges use this to send tokens to L2.\n // https://github.com/OffchainLabs/nitro-contracts/blob/f7894d3a6d4035ba60f51a7f1334f0f2d4f02dce/src/bridge/Inbox.sol\n ArbitrumL1InboxLike public immutable L1_INBOX;\n\n // Router contract to send tokens to Arbitrum. Routes to correct gateway to bridge tokens. Internally this\n // contract calls the Inbox.\n // Generic gateway: https://github.com/OffchainLabs/token-bridge-contracts/blob/main/contracts/tokenbridge/ethereum/gateway/L1ArbitrumGateway.sol\n // Gateway used for communicating with chains that use custom gas tokens:\n // https://github.com/OffchainLabs/token-bridge-contracts/blob/main/contracts/tokenbridge/ethereum/gateway/L1ERC20Gateway.sol\n ArbitrumL1ERC20GatewayLike public immutable L1_ERC20_GATEWAY_ROUTER;\n\n // This token is used to pay for l1 to l2 messages if its configured by an Arbitrum orbit chain.\n IERC20 public immutable CUSTOM_GAS_TOKEN;\n\n // Contract that funds Inbox cross chain messages with the custom gas token.\n FunderInterface public immutable CUSTOM_GAS_TOKEN_FUNDER;\n\n error InvalidCustomGasToken();\n error InsufficientCustomGasToken();\n error InvalidNativeTokenDecimals();\n\n /**\n * @notice Constructs new Adapter.\n * @param _l1ArbitrumInbox Inbox helper contract to send messages to Arbitrum.\n * @param _l1ERC20GatewayRouter ERC20 gateway router contract to send tokens to Arbitrum.\n * @param _l2RefundL2Address L2 address to receive gas refunds on after a message is relayed.\n * @param _l1Usdc USDC address on L1.\n * @param _cctpTokenMessenger TokenMessenger contract to bridge via CCTP.\n * @param _cctpDomainId Circle CCTP domain identifier for the destination chain.\n * @param _nativeTokenDecimals Number of decimals corresponding to the L2's gas/fee token.\n * @param _customGasTokenFunder Contract that funds the custom gas token.\n * @param _l2MaxSubmissionCost Amount of gas token allocated to pay for the base submission fee. The base\n * submission fee is a parameter unique to Arbitrum retryable transactions. This value is hardcoded\n * and used for all messages sent by this adapter.\n * @param _l2GasPrice Gas price bid for L2 execution. Should be set conservatively high to avoid stuck messages.\n */\n constructor(\n ArbitrumL1InboxLike _l1ArbitrumInbox,\n ArbitrumL1ERC20GatewayLike _l1ERC20GatewayRouter,\n address _l2RefundL2Address,\n IERC20 _l1Usdc,\n ICCTPTokenMessenger _cctpTokenMessenger,\n uint32 _cctpDomainId,\n uint8 _nativeTokenDecimals,\n FunderInterface _customGasTokenFunder,\n uint256 _l2MaxSubmissionCost,\n uint256 _l2GasPrice\n ) CircleCCTPAdapter(_l1Usdc, _cctpTokenMessenger, _cctpDomainId) {\n L1_INBOX = _l1ArbitrumInbox;\n L1_ERC20_GATEWAY_ROUTER = _l1ERC20GatewayRouter;\n L2_REFUND_L2_ADDRESS = _l2RefundL2Address;\n CUSTOM_GAS_TOKEN = IERC20(L1_INBOX.bridge().nativeToken());\n if (address(CUSTOM_GAS_TOKEN) == address(0)) revert InvalidCustomGasToken();\n L2_MAX_SUBMISSION_COST = _l2MaxSubmissionCost;\n L2_GAS_PRICE = _l2GasPrice;\n CUSTOM_GAS_TOKEN_FUNDER = _customGasTokenFunder;\n if (_nativeTokenDecimals == 0) revert InvalidNativeTokenDecimals();\n NATIVE_TOKEN_DECIMALS = _nativeTokenDecimals;\n }\n\n /**\n * @notice Send cross-chain message to target on Arbitrum.\n * @notice This contract must hold at least getL1CallValue() amount of the custom gas token\n * to send a message via the Inbox successfully, or the message will get stuck.\n * @param target Contract on Arbitrum that will receive message.\n * @param message Data to send to target.\n */\n function relayMessage(address target, bytes memory message) external payable override {\n uint256 requiredL1TokenTotalFeeAmount = _pullCustomGas(RELAY_MESSAGE_L2_GAS_LIMIT);\n CUSTOM_GAS_TOKEN.safeIncreaseAllowance(address(L1_INBOX), requiredL1TokenTotalFeeAmount);\n L1_INBOX.createRetryableTicket(\n target, // destAddr destination L2 contract address\n L2_CALL_VALUE, // l2CallValue call value for retryable L2 message\n L2_MAX_SUBMISSION_COST, // maxSubmissionCost Max gas deducted from user's L2 balance to cover base fee\n L2_REFUND_L2_ADDRESS, // excessFeeRefundAddress maxgas * gasprice - execution cost gets credited here on L2\n L2_REFUND_L2_ADDRESS, // callValueRefundAddress l2Callvalue gets credited here on L2 if retryable txn times out or gets cancelled\n RELAY_MESSAGE_L2_GAS_LIMIT, // maxGas Max gas deducted from user's L2 balance to cover L2 execution\n L2_GAS_PRICE, // gasPriceBid price bid for L2 execution\n requiredL1TokenTotalFeeAmount, // tokenTotalFeeAmount amount of fees to be deposited in native token.\n // This should be in the precision of the custom gas token.\n message // data ABI encoded data of L2 message\n );\n emit MessageRelayed(target, message);\n }\n\n /**\n * @notice Bridge tokens to Arbitrum.\n * @notice This contract must hold at least getL1CallValue() amount of ETH or custom gas token\n * to send a message via the Inbox successfully, or the message will get stuck.\n * @param l1Token L1 token to deposit.\n * @param l2Token L2 token to receive.\n * @param amount Amount of L1 tokens to deposit and L2 tokens to receive.\n * @param to Bridge recipient.\n */\n function relayTokens(\n address l1Token,\n address l2Token, // l2Token is unused for Arbitrum.\n uint256 amount,\n address to\n ) external payable override {\n // Check if this token is USDC, which requires a custom bridge via CCTP.\n if (_isCCTPEnabled() && l1Token == address(usdcToken)) {\n _transferUsdc(to, amount);\n }\n // If not, we can use the Arbitrum gateway\n else {\n address erc20Gateway = L1_ERC20_GATEWAY_ROUTER.getGateway(l1Token);\n\n // If custom gas token, call special functions that handle paying with custom gas tokens.\n uint256 requiredL1TokenTotalFeeAmount = _pullCustomGas(RELAY_MESSAGE_L2_GAS_LIMIT);\n\n // Must use Inbox to bridge custom gas token.\n // Source: https://github.com/OffchainLabs/token-bridge-contracts/blob/5bdf33259d2d9ae52ddc69bc5a9cbc558c4c40c7/contracts/tokenbridge/ethereum/gateway/L1OrbitERC20Gateway.sol#L33\n if (l1Token == address(CUSTOM_GAS_TOKEN)) {\n // amount and requiredL1TokenTotalFeeAmount are in the precision of the custom gas token.\n uint256 amountToBridge = amount + requiredL1TokenTotalFeeAmount;\n CUSTOM_GAS_TOKEN.safeIncreaseAllowance(address(L1_INBOX), amountToBridge);\n // Both `l2CallValue` and `tokenTotalFeeAmount` are rounded in the conversion to/from native/18 decimals. `l2CallValue` is rounded down by the call to _fromNativeTo18Decimals()\n // in cases where the token's decimals exceeds 18, since we would rather round down and be forced to donate a small amount of the l2 token to the spoke pool to cover the roundoff\n // error than overshoot a transfer amount. `amountToBridge` is rounded up since we would rather overpay for gas and be refunded on l2 than underpay and risk stuck cross-chain messages.\n L1_INBOX.createRetryableTicket(\n to, // destAddr destination L2 contract address\n _fromNativeTo18Decimals(amount), // l2CallValue call value for retryable L2 message\n L2_MAX_SUBMISSION_COST, // maxSubmissionCost Max gas deducted from user's L2 balance to cover base fee\n L2_REFUND_L2_ADDRESS, // excessFeeRefundAddress maxgas * gasprice - execution cost gets credited here on L2\n L2_REFUND_L2_ADDRESS, // callValueRefundAddress l2Callvalue gets credited here on L2 if retryable txn times out or gets cancelled\n RELAY_MESSAGE_L2_GAS_LIMIT, // maxGas Max gas deducted from user's L2 balance to cover L2 execution\n L2_GAS_PRICE, // gasPriceBid price bid for L2 execution\n amountToBridge, // tokenTotalFeeAmount amount of fees to be deposited in native token.\n \"0x\" // data ABI encoded data of L2 message\n );\n } else {\n IERC20(l1Token).safeIncreaseAllowance(erc20Gateway, amount);\n CUSTOM_GAS_TOKEN.safeIncreaseAllowance(erc20Gateway, requiredL1TokenTotalFeeAmount);\n\n // To pay for gateway outbound transfer with custom gas token, encode the tokenTotalFeeAmount in the data field:\n // The data format should be (uint256 maxSubmissionCost, bytes extraData, uint256 tokenTotalFeeAmount).\n // Source: https://github.com/OffchainLabs/token-bridge-contracts/blob/5bdf33259d2d9ae52ddc69bc5a9cbc558c4c40c7/contracts/tokenbridge/ethereum/gateway/L1OrbitERC20Gateway.sol#L57\n bytes memory data = abi.encode(L2_MAX_SUBMISSION_COST, \"\", requiredL1TokenTotalFeeAmount);\n L1_ERC20_GATEWAY_ROUTER.outboundTransferCustomRefund(\n l1Token,\n L2_REFUND_L2_ADDRESS,\n to,\n amount,\n RELAY_TOKENS_L2_GAS_LIMIT,\n L2_GAS_PRICE,\n data\n );\n }\n }\n emit TokensRelayed(l1Token, l2Token, amount, to);\n }\n\n /**\n * @notice Returns required amount of gas token to send a message via the Inbox.\n * @dev Should return a value in the same precision as the gas token's precision.\n * @param l2GasLimit L2 gas limit for the message.\n * @return amount of gas token that this contract needs to hold in order for relayMessage to succeed.\n */\n function getL1CallValue(uint32 l2GasLimit) public view returns (uint256) {\n return _from18ToNativeDecimals(L2_MAX_SUBMISSION_COST + L2_GAS_PRICE * l2GasLimit);\n }\n\n function _pullCustomGas(uint32 l2GasLimit) internal returns (uint256) {\n uint256 requiredL1CallValue = getL1CallValue(l2GasLimit);\n CUSTOM_GAS_TOKEN_FUNDER.withdraw(CUSTOM_GAS_TOKEN, requiredL1CallValue);\n if (CUSTOM_GAS_TOKEN.balanceOf(address(this)) < requiredL1CallValue) revert InsufficientCustomGasToken();\n return requiredL1CallValue;\n }\n\n function _from18ToNativeDecimals(uint256 amount) internal view returns (uint256) {\n if (NATIVE_TOKEN_DECIMALS == 18) {\n return amount;\n } else if (NATIVE_TOKEN_DECIMALS < 18) {\n // Round up the division result so that the L1 call value is always sufficient to cover the submission fee.\n uint256 reductionFactor = 10**(18 - NATIVE_TOKEN_DECIMALS);\n uint256 divFloor = amount / reductionFactor;\n uint256 mod = amount % reductionFactor;\n if (mod != 0) {\n return divFloor + 1;\n } else {\n return divFloor;\n }\n } else {\n return amount * 10**(NATIVE_TOKEN_DECIMALS - 18);\n }\n }\n\n function _fromNativeTo18Decimals(uint256 amount) internal view returns (uint256) {\n if (NATIVE_TOKEN_DECIMALS == 18) {\n return amount;\n } else if (NATIVE_TOKEN_DECIMALS < 18) {\n return amount * 10**(18 - NATIVE_TOKEN_DECIMALS);\n } else {\n return amount / 10**(NATIVE_TOKEN_DECIMALS - 18);\n }\n }\n}\n"
- },
- "contracts/chain-adapters/Arbitrum_RescueAdapter.sol": {
- "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\n\nimport \"./interfaces/AdapterInterface.sol\";\nimport \"./Arbitrum_Adapter.sol\"; // Used to import `ArbitrumL1ERC20GatewayLike` and `ArbitrumL1InboxLike`\n\nimport \"@openzeppelin/contracts/token/ERC20/IERC20.sol\";\nimport \"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\";\n\n/**\n * @notice Meant to copy the Arbitrum_Adapter exactly in how it sends L1 --> L2 messages but is designed only to be\n * used by the owner of the HubPool to retrieve ETH held by its aliased address on L2. This ETH builds up because\n * `relayTokens` calls `l1ERC20GatewayRouter.outboundTransfer` which does not allow the caller to specify an L2 refund\n * address the same way that `l1Inbox.createRetryableTicket` does. This means that the alias address of the caller, the\n * HubPool in this case, receives ETH on L2. This Adapter can be used to send messages to Arbitrum specifically to send\n * transactions as if called by the aliased HubPool address.\n */\n\n// solhint-disable-next-line contract-name-camelcase\ncontract Arbitrum_RescueAdapter is AdapterInterface {\n using SafeERC20 for IERC20;\n\n // Amount of ETH allocated to pay for the base submission fee. The base submission fee is a parameter unique to\n // retryable transactions; the user is charged the base submission fee to cover the storage costs of keeping their\n // ticket’s calldata in the retry buffer. (current base submission fee is queryable via\n // ArbRetryableTx.getSubmissionPrice). ArbRetryableTicket precompile interface exists at L2 address\n // 0x000000000000000000000000000000000000006E.\n uint256 public immutable l2MaxSubmissionCost = 0.01e18;\n\n // L2 Gas price bid for immediate L2 execution attempt (queryable via standard eth*gasPrice RPC)\n uint256 public immutable l2GasPrice = 5e9; // 5 gWei\n\n // Gas limit for immediate L2 execution attempt (can be estimated via NodeInterface.estimateRetryableTicket).\n // NodeInterface precompile interface exists at L2 address 0x00000000000000000000000000000000000000C8\n uint32 public immutable l2GasLimit = 2_000_000;\n\n // This address on L2 receives extra ETH that is left over after relaying a message via the inbox.\n address public immutable l2RefundL2Address;\n\n // L1 HubPool address aliased on L2: https://github.com/OffchainLabs/arbitrum/blob/master/docs/L1_L2_Messages.md#address-aliasing\n address public immutable aliasedL2HubPoolAddress = 0xd297fA914353c44B2e33EBE05F21846f1048CFeB;\n\n ArbitrumL1InboxLike public immutable l1Inbox;\n\n /**\n * @notice Constructs new Adapter.\n * @param _l1ArbitrumInbox Inbox helper contract to send messages to Arbitrum.\n */\n constructor(ArbitrumL1InboxLike _l1ArbitrumInbox) {\n l1Inbox = _l1ArbitrumInbox;\n\n l2RefundL2Address = msg.sender;\n }\n\n /**\n * @notice Send cross-chain message to aliased hub pool address on Arbitrum.\n * @notice This contract must hold at least getL1CallValue() amount of ETH to send a message via the Inbox\n * successfully, or the message will get stuck.\n * @param message Data to send to aliased hub pool.\n */\n function relayMessage(address, bytes memory message) external payable override {\n uint256 valueToReturn = abi.decode(message, (uint256));\n\n uint256 requiredL1CallValue = _contractHasSufficientEthBalance();\n\n // In the rescue ETH setup, we send the transaction to the refund address, we provide a call value equal to the\n // amount we want to rescue, and we specify an empty calldata, since it's a simple ETH transfer.\n // Note: we use the unsafe version of createRetryableTicket because it doesn't require the msg.sender to pass\n // in arbTxCallValue in addition to maxSubmissionCost + maxGas * gasPriceBid.\n l1Inbox.unsafeCreateRetryableTicket{ value: requiredL1CallValue }(\n l2RefundL2Address, // destAddr destination L2 contract address\n valueToReturn, // l2CallValue call value for retryable L2 message\n l2MaxSubmissionCost, // maxSubmissionCost Max gas deducted from user's L2 balance to cover base fee\n l2RefundL2Address, // excessFeeRefundAddress maxgas * gasprice - execution cost gets credited here on L2\n l2RefundL2Address, // callValueRefundAddress l2Callvalue gets credited here on L2 if retryable txn times out or gets cancelled\n l2GasLimit, // maxGas Max gas deducted from user's L2 balance to cover L2 execution\n l2GasPrice, // gasPriceBid price bid for L2 execution\n \"\" // data ABI encoded data of L2 message\n );\n\n emit MessageRelayed(aliasedL2HubPoolAddress, \"\");\n }\n\n /**\n * @notice Should never be called.\n */\n function relayTokens(\n address,\n address,\n uint256,\n address\n ) external payable override {\n revert(\"useless function\");\n }\n\n /**\n * @notice Returns required amount of ETH to send a message via the Inbox.\n * @return amount of ETH that this contract needs to hold in order for relayMessage to succeed.\n */\n function getL1CallValue() public pure returns (uint256) {\n return l2MaxSubmissionCost + l2GasPrice * l2GasLimit;\n }\n\n function _contractHasSufficientEthBalance() internal view returns (uint256 requiredL1CallValue) {\n requiredL1CallValue = getL1CallValue();\n require(address(this).balance >= requiredL1CallValue, \"Insufficient ETH balance\");\n }\n}\n"
- },
- "contracts/chain-adapters/Arbitrum_SendTokensAdapter.sol": {
- "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\n\nimport \"./interfaces/AdapterInterface.sol\";\nimport { ArbitrumL1ERC20GatewayLike } from \"./Arbitrum_Adapter.sol\";\n\nimport \"@openzeppelin/contracts/token/ERC20/IERC20.sol\";\nimport \"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\";\n\n/**\n * @notice This adapter is built for emergencies to send funds from the Hub to a Spoke in the event that a spoke pool\n * received a duplicate root bundle relay, due to some replay issue.\n */\n// solhint-disable-next-line contract-name-camelcase\ncontract Arbitrum_SendTokensAdapter is AdapterInterface {\n using SafeERC20 for IERC20;\n\n uint256 public immutable l2MaxSubmissionCost = 0.01e18;\n uint256 public immutable l2GasPrice = 5e9;\n uint32 public constant RELAY_TOKENS_L2_GAS_LIMIT = 300_000;\n\n ArbitrumL1ERC20GatewayLike public immutable l1ERC20GatewayRouter;\n address public immutable l2RefundL2Address;\n\n /**\n * @notice Constructs new Adapter.\n * @param _l1ERC20GatewayRouter ERC20 gateway router contract to send tokens to Arbitrum.\n * @param _l2RefundL2Address L2 address to receive gas refunds on after a message is relayed.\n */\n constructor(ArbitrumL1ERC20GatewayLike _l1ERC20GatewayRouter, address _l2RefundL2Address) {\n l1ERC20GatewayRouter = _l1ERC20GatewayRouter;\n l2RefundL2Address = _l2RefundL2Address;\n }\n\n /**\n * @notice Send tokens to SpokePool. Enables HubPool admin to call relaySpokePoolAdminFunction that will trigger\n * this function.\n * @dev This performs similar logic to relayTokens in the normal Arbitrum_Adapter by sending tokens\n * the Arbitrum_SpokePool out of the HubPool.\n * @param message The encoded address of the ERC20 to send to the rescue address.\n */\n function relayMessage(address target, bytes memory message) external payable override {\n (address l1Token, uint256 amount) = abi.decode(message, (address, uint256));\n\n uint256 requiredL1CallValue = _contractHasSufficientEthBalance();\n\n // Approve the gateway, not the router, to spend the hub pool's balance. The gateway, which is different\n // per L1 token, will temporarily escrow the tokens to be bridged and pull them from this contract.\n address erc20Gateway = l1ERC20GatewayRouter.getGateway(l1Token);\n IERC20(l1Token).safeIncreaseAllowance(erc20Gateway, amount);\n\n // `outboundTransfer` expects that the caller includes a bytes message as the last param that includes the\n // maxSubmissionCost to use when creating an L2 retryable ticket: https://github.com/OffchainLabs/arbitrum/blob/e98d14873dd77513b569771f47b5e05b72402c5e/packages/arb-bridge-peripherals/contracts/tokenbridge/ethereum/gateway/L1GatewayRouter.sol#L232\n bytes memory data = abi.encode(l2MaxSubmissionCost, \"\");\n\n l1ERC20GatewayRouter.outboundTransferCustomRefund{ value: requiredL1CallValue }(\n l1Token,\n l2RefundL2Address,\n target,\n amount,\n RELAY_TOKENS_L2_GAS_LIMIT,\n l2GasPrice,\n data\n );\n\n // Purposefully not emitting any events so as not to confuse off-chain monitors that track this event.\n // emit TokensRelayed(l1Token, l2Token, amount, to);\n }\n\n /**\n * @notice Should never be called.\n */\n function relayTokens(\n address,\n address,\n uint256,\n address\n ) external payable override {\n revert(\"relayTokens disabled\");\n }\n\n /**\n * @notice Returns required amount of ETH to send a message via the Inbox.\n * @return amount of ETH that this contract needs to hold in order for relayMessage to succeed.\n */\n function getL1CallValue() public pure returns (uint256) {\n return l2MaxSubmissionCost + l2GasPrice * RELAY_TOKENS_L2_GAS_LIMIT;\n }\n\n function _contractHasSufficientEthBalance() internal view returns (uint256 requiredL1CallValue) {\n requiredL1CallValue = getL1CallValue();\n require(address(this).balance >= requiredL1CallValue, \"Insufficient ETH balance\");\n }\n}\n"
- },
- "contracts/chain-adapters/Base_Adapter.sol": {
- "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\n\nimport \"./interfaces/AdapterInterface.sol\";\nimport \"../external/interfaces/WETH9Interface.sol\";\n\n// @dev Use local modified CrossDomainEnabled contract instead of one exported by eth-optimism because we need\n// this contract's state variables to be `immutable` because of the delegateCall call.\nimport \"./CrossDomainEnabled.sol\";\nimport \"@eth-optimism/contracts/L1/messaging/IL1StandardBridge.sol\";\n\nimport \"@openzeppelin/contracts/token/ERC20/IERC20.sol\";\nimport \"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\";\n\nimport \"../libraries/CircleCCTPAdapter.sol\";\nimport \"../external/interfaces/CCTPInterfaces.sol\";\n\n/**\n * @notice Contract containing logic to send messages from L1 to Base. This is a modified version of the Optimism adapter\n * that excludes the custom bridging logic.\n * @custom:security-contact bugs@across.to\n * @dev Public functions calling external contracts do not guard against reentrancy because they are expected to be\n * called via delegatecall, which will execute this contract's logic within the context of the originating contract.\n * For example, the HubPool will delegatecall these functions, therefore its only necessary that the HubPool's methods\n * that call this contract's logic guard against reentrancy.\n */\n\n// solhint-disable-next-line contract-name-camelcase\ncontract Base_Adapter is CrossDomainEnabled, AdapterInterface, CircleCCTPAdapter {\n using SafeERC20 for IERC20;\n uint32 public constant L2_GAS_LIMIT = 200_000;\n\n WETH9Interface public immutable L1_WETH;\n\n IL1StandardBridge public immutable L1_STANDARD_BRIDGE;\n\n /**\n * @notice Constructs new Adapter.\n * @param _l1Weth WETH address on L1.\n * @param _crossDomainMessenger XDomainMessenger Base system contract.\n * @param _l1StandardBridge Standard bridge contract.\n * @param _l1Usdc USDC address on L1.\n * @param _cctpTokenMessenger TokenMessenger contract to bridge via CCTP.\n */\n constructor(\n WETH9Interface _l1Weth,\n address _crossDomainMessenger,\n IL1StandardBridge _l1StandardBridge,\n IERC20 _l1Usdc,\n ITokenMessenger _cctpTokenMessenger\n ) CrossDomainEnabled(_crossDomainMessenger) CircleCCTPAdapter(_l1Usdc, _cctpTokenMessenger, CircleDomainIds.Base) {\n L1_WETH = _l1Weth;\n L1_STANDARD_BRIDGE = _l1StandardBridge;\n }\n\n /**\n * @notice Send cross-chain message to target on Base.\n * @param target Contract on Base that will receive message.\n * @param message Data to send to target.\n */\n function relayMessage(address target, bytes calldata message) external payable override {\n sendCrossDomainMessage(target, L2_GAS_LIMIT, message);\n emit MessageRelayed(target, message);\n }\n\n /**\n * @notice Bridge tokens to Base.\n * @param l1Token L1 token to deposit.\n * @param l2Token L2 token to receive.\n * @param amount Amount of L1 tokens to deposit and L2 tokens to receive.\n * @param to Bridge recipient.\n */\n function relayTokens(\n address l1Token,\n address l2Token,\n uint256 amount,\n address to\n ) external payable override {\n // If the l1Token is weth then unwrap it to ETH then send the ETH to the standard bridge.\n if (l1Token == address(L1_WETH)) {\n L1_WETH.withdraw(amount);\n L1_STANDARD_BRIDGE.depositETHTo{ value: amount }(to, L2_GAS_LIMIT, \"\");\n }\n // Check if this token is USDC, which requires a custom bridge via CCTP.\n else if (_isCCTPEnabled() && l1Token == address(usdcToken)) {\n _transferUsdc(to, amount);\n } else {\n IL1StandardBridge _l1StandardBridge = L1_STANDARD_BRIDGE;\n\n IERC20(l1Token).safeIncreaseAllowance(address(_l1StandardBridge), amount);\n _l1StandardBridge.depositERC20To(l1Token, l2Token, to, amount, L2_GAS_LIMIT, \"\");\n }\n emit TokensRelayed(l1Token, l2Token, amount, to);\n }\n}\n"
- },
- "contracts/chain-adapters/Blast_Adapter.sol": {
- "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\n\nimport \"./interfaces/AdapterInterface.sol\";\nimport \"../external/interfaces/WETH9Interface.sol\";\n\n// @dev Use local modified CrossDomainEnabled contract instead of one exported by eth-optimism because we need\n// this contract's state variables to be `immutable` because of the delegateCall call.\nimport \"./CrossDomainEnabled.sol\";\nimport { IL1StandardBridge } from \"@eth-optimism/contracts/L1/messaging/IL1StandardBridge.sol\";\n\nimport \"@openzeppelin/contracts/token/ERC20/IERC20.sol\";\nimport \"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\";\n\nimport \"../libraries/CircleCCTPAdapter.sol\";\nimport \"../external/interfaces/CCTPInterfaces.sol\";\n\ninterface IL1ERC20Bridge {\n /// @notice Sends ERC20 tokens to a receiver's address on the other chain. Note that if the\n /// ERC20 token on the other chain does not recognize the local token as the correct\n /// pair token, the ERC20 bridge will fail and the tokens will be returned to sender on\n /// this chain.\n /// @param _localToken Address of the ERC20 on this chain.\n /// @param _remoteToken Address of the corresponding token on the remote chain.\n /// @param _to Address of the receiver.\n /// @param _amount Amount of local tokens to deposit.\n /// @param _minGasLimit Minimum amount of gas that the bridge can be relayed with.\n /// @param _extraData Extra data to be sent with the transaction. Note that the recipient will\n /// not be triggered with this data, but it will be emitted and can be used\n /// to identify the transaction.\n function bridgeERC20To(\n address _localToken,\n address _remoteToken,\n address _to,\n uint256 _amount,\n uint32 _minGasLimit,\n bytes calldata _extraData\n ) external;\n}\n\n/**\n * @notice Contract containing logic to send messages from L1 to Blast. This is a modified version of the Optimism adapter\n * that excludes the custom bridging logic. It differs from the Base Adapter in that it uses a special\n * Blast contract to bridge WETH and DAI, which are yielding rebasing tokens on L2, WETH and USDB.\n * @custom:security-contact bugs@across.to\n */\n\n// solhint-disable-next-line contract-name-camelcase\ncontract Blast_Adapter is CrossDomainEnabled, AdapterInterface, CircleCCTPAdapter {\n using SafeERC20 for IERC20;\n uint32 public immutable L2_GAS_LIMIT; // 200,000 is a reasonable default.\n\n WETH9Interface public immutable L1_WETH;\n\n IL1StandardBridge public immutable L1_STANDARD_BRIDGE; // 0x697402166Fbf2F22E970df8a6486Ef171dbfc524\n\n // Bridge used to get yielding version of ERC20's on L2.\n IL1ERC20Bridge public immutable L1_BLAST_BRIDGE; // 0x3a05E5d33d7Ab3864D53aaEc93c8301C1Fa49115 on mainnet.\n address public immutable L1_DAI; // 0x6B175474E89094C44Da98b954EedeAC495271d0F on mainnet.\n\n /**\n * @notice Constructs new Adapter.\n * @param _l1Weth WETH address on L1.\n * @param _crossDomainMessenger XDomainMessenger Blast system contract.\n * @param _l1StandardBridge Standard bridge contract.\n * @param _l1Usdc USDC address on L1.\n */\n constructor(\n WETH9Interface _l1Weth,\n address _crossDomainMessenger,\n IL1StandardBridge _l1StandardBridge,\n IERC20 _l1Usdc,\n IL1ERC20Bridge l1BlastBridge,\n address l1Dai,\n uint32 l2GasLimit\n )\n CrossDomainEnabled(_crossDomainMessenger)\n // Hardcode cctp messenger to 0x0 to disable CCTP bridging.\n CircleCCTPAdapter(_l1Usdc, ITokenMessenger(address(0)), CircleDomainIds.UNINITIALIZED)\n {\n L1_WETH = _l1Weth;\n L1_STANDARD_BRIDGE = _l1StandardBridge;\n L1_BLAST_BRIDGE = l1BlastBridge;\n L1_DAI = l1Dai;\n L2_GAS_LIMIT = l2GasLimit;\n }\n\n /**\n * @notice Send cross-chain message to target on Blast.\n * @param target Contract on Blast that will receive message.\n * @param message Data to send to target.\n */\n function relayMessage(address target, bytes calldata message) external payable override {\n sendCrossDomainMessage(target, L2_GAS_LIMIT, message);\n emit MessageRelayed(target, message);\n }\n\n /**\n * @notice Bridge tokens to Blast.\n * @param l1Token L1 token to deposit.\n * @param l2Token L2 token to receive.\n * @param amount Amount of L1 tokens to deposit and L2 tokens to receive.\n * @param to Bridge recipient.\n */\n function relayTokens(\n address l1Token,\n address l2Token,\n uint256 amount,\n address to\n ) external payable override {\n // If token can be bridged into yield-ing version of ERC20 on L2 side, then use Blast Bridge, otherwise\n // use standard bridge.\n\n // If the l1Token is weth then unwrap it to ETH then send the ETH to the standard bridge.\n if (l1Token == address(L1_WETH)) {\n L1_WETH.withdraw(amount);\n // @dev: we can use the standard or the blast bridge to deposit ETH here:\n L1_STANDARD_BRIDGE.depositETHTo{ value: amount }(to, L2_GAS_LIMIT, \"\");\n }\n // Check if this token is DAI, then use the L1 Blast Bridge\n else if (l1Token == L1_DAI) {\n IERC20(l1Token).safeIncreaseAllowance(address(L1_BLAST_BRIDGE), amount);\n L1_BLAST_BRIDGE.bridgeERC20To(l1Token, l2Token, to, amount, L2_GAS_LIMIT, \"\");\n } else {\n IL1StandardBridge _l1StandardBridge = L1_STANDARD_BRIDGE;\n\n IERC20(l1Token).safeIncreaseAllowance(address(_l1StandardBridge), amount);\n _l1StandardBridge.depositERC20To(l1Token, l2Token, to, amount, L2_GAS_LIMIT, \"\");\n }\n emit TokensRelayed(l1Token, l2Token, amount, to);\n }\n}\n"
- },
- "contracts/chain-adapters/CrossDomainEnabled.sol": {
- "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\n/* Interface Imports */\nimport { ICrossDomainMessenger } from \"@eth-optimism/contracts/libraries/bridge/ICrossDomainMessenger.sol\";\n\n/**\n * @title CrossDomainEnabled\n * @custom:security-contact bugs@across.to\n * @dev Helper contract for contracts performing cross-domain communications between L1 and Optimism.\n * @dev This modifies the eth-optimism/CrossDomainEnabled contract only by changing state variables to be\n * immutable for use in contracts like the Optimism_Adapter which use delegateCall().\n */\ncontract CrossDomainEnabled {\n // Messenger contract used to send and recieve messages from the other domain.\n address public immutable MESSENGER;\n\n /**\n * @param _messenger Address of the CrossDomainMessenger on the current layer.\n */\n constructor(address _messenger) {\n MESSENGER = _messenger;\n }\n\n /**\n * Gets the messenger, usually from storage. This function is exposed in case a child contract\n * needs to override.\n * @return The address of the cross-domain messenger contract which should be used.\n */\n function getCrossDomainMessenger() internal virtual returns (ICrossDomainMessenger) {\n return ICrossDomainMessenger(MESSENGER);\n }\n\n /**\n * Sends a message to an account on another domain\n * @param _crossDomainTarget The intended recipient on the destination domain\n * @param _gasLimit The gasLimit for the receipt of the message on the target domain.\n * @param _message The data to send to the target (usually calldata to a function with\n * onlyFromCrossDomainAccount())\n */\n function sendCrossDomainMessage(\n address _crossDomainTarget,\n uint32 _gasLimit,\n bytes calldata _message\n ) internal {\n // slither-disable-next-line reentrancy-events, reentrancy-benign\n getCrossDomainMessenger().sendMessage(_crossDomainTarget, _message, _gasLimit);\n }\n}\n"
- },
- "contracts/chain-adapters/DoctorWho_Adapter.sol": {
- "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\n\nimport \"./interfaces/AdapterInterface.sol\";\nimport \"../external/interfaces/WETH9Interface.sol\";\n\n// @dev Use local modified CrossDomainEnabled contract instead of one exported by eth-optimism because we need\n// this contract's state variables to be `immutable` because of the delegateCall call.\nimport \"./CrossDomainEnabled.sol\";\nimport \"@eth-optimism/contracts/L1/messaging/IL1StandardBridge.sol\";\n\nimport \"@openzeppelin/contracts/token/ERC20/IERC20.sol\";\nimport \"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\";\n\nimport \"../libraries/CircleCCTPAdapter.sol\";\nimport \"../external/interfaces/CCTPInterfaces.sol\";\n\n/**\n * @notice Contract containing logic to send messages from L1 to Doctor Who. This is a modified version of the Optimism adapter\n * that excludes the custom bridging logic.\n * @custom:security-contact bugs@across.to\n * @dev Public functions calling external contracts do not guard against reentrancy because they are expected to be\n * called via delegatecall, which will execute this contract's logic within the context of the originating contract.\n * For example, the HubPool will delegatecall these functions, therefore its only necessary that the HubPool's methods\n * that call this contract's logic guard against reentrancy.\n */\n\n// solhint-disable-next-line contract-name-camelcase\ncontract DoctorWho_Adapter is CrossDomainEnabled, AdapterInterface, CircleCCTPAdapter {\n using SafeERC20 for IERC20;\n uint32 public constant L2_GAS_LIMIT = 200_000;\n\n WETH9Interface public immutable L1_WETH;\n\n IL1StandardBridge public immutable L1_STANDARD_BRIDGE;\n\n /**\n * @notice Constructs new Adapter.\n * @param _l1Weth WETH address on L1.\n * @param _crossDomainMessenger XDomainMessenger Doctor Who system contract.\n * @param _l1StandardBridge Standard bridge contract.\n * @param _l1Usdc USDC address on L1.\n * @param _cctpTokenMessenger TokenMessenger contract to bridge via CCTP.\n */\n constructor(\n WETH9Interface _l1Weth,\n address _crossDomainMessenger,\n IL1StandardBridge _l1StandardBridge,\n IERC20 _l1Usdc,\n ITokenMessenger _cctpTokenMessenger\n )\n CrossDomainEnabled(_crossDomainMessenger)\n CircleCCTPAdapter(_l1Usdc, _cctpTokenMessenger, CircleDomainIds.DoctorWho)\n {\n L1_WETH = _l1Weth;\n L1_STANDARD_BRIDGE = _l1StandardBridge;\n }\n\n /**\n * @notice Send cross-chain message to target on Doctor Who.\n * @param target Contract on Doctor Who that will receive message.\n * @param message Data to send to target.\n */\n function relayMessage(address target, bytes calldata message) external payable override {\n sendCrossDomainMessage(target, L2_GAS_LIMIT, message);\n emit MessageRelayed(target, message);\n }\n\n /**\n * @notice Bridge tokens to Doctor Who.\n * @param l1Token L1 token to deposit.\n * @param l2Token L2 token to receive.\n * @param amount Amount of L1 tokens to deposit and L2 tokens to receive.\n * @param to Bridge recipient.\n */\n function relayTokens(\n address l1Token,\n address l2Token,\n uint256 amount,\n address to\n ) external payable override {\n // If the l1Token is weth then unwrap it to ETH then send the ETH to the standard bridge.\n if (l1Token == address(L1_WETH)) {\n L1_WETH.withdraw(amount);\n L1_STANDARD_BRIDGE.depositETHTo{ value: amount }(to, L2_GAS_LIMIT, \"\");\n }\n // Check if this token is USDC, which requires a custom bridge via CCTP.\n else if (_isCCTPEnabled() && l1Token == address(usdcToken)) {\n _transferUsdc(to, amount);\n } else {\n IL1StandardBridge _l1StandardBridge = L1_STANDARD_BRIDGE;\n\n IERC20(l1Token).safeIncreaseAllowance(address(_l1StandardBridge), amount);\n _l1StandardBridge.depositERC20To(l1Token, l2Token, to, amount, L2_GAS_LIMIT, \"\");\n }\n emit TokensRelayed(l1Token, l2Token, amount, to);\n }\n}\n"
- },
- "contracts/chain-adapters/interfaces/AdapterInterface.sol": {
- "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\n\n/**\n * @notice Sends cross chain messages and tokens to contracts on a specific L2 network.\n * This interface is implemented by an adapter contract that is deployed on L1.\n */\n\ninterface AdapterInterface {\n event MessageRelayed(address target, bytes message);\n\n event TokensRelayed(address l1Token, address l2Token, uint256 amount, address to);\n\n /**\n * @notice Send message to `target` on L2.\n * @dev This method is marked payable because relaying the message might require a fee\n * to be paid by the sender to forward the message to L2. However, it will not send msg.value\n * to the target contract on L2.\n * @param target L2 address to send message to.\n * @param message Message to send to `target`.\n */\n function relayMessage(address target, bytes calldata message) external payable;\n\n /**\n * @notice Send `amount` of `l1Token` to `to` on L2. `l2Token` is the L2 address equivalent of `l1Token`.\n * @dev This method is marked payable because relaying the message might require a fee\n * to be paid by the sender to forward the message to L2. However, it will not send msg.value\n * to the target contract on L2.\n * @param l1Token L1 token to bridge.\n * @param l2Token L2 token to receive.\n * @param amount Amount of `l1Token` to bridge.\n * @param to Bridge recipient.\n */\n function relayTokens(\n address l1Token,\n address l2Token,\n uint256 amount,\n address to\n ) external payable;\n}\n"
- },
- "contracts/chain-adapters/l2/Arbitrum_WithdrawalHelper.sol": {
- "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\n\nimport { IERC20 } from \"@openzeppelin/contracts/token/ERC20/IERC20.sol\";\nimport { SafeERC20 } from \"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\";\nimport { ArbitrumL2ERC20GatewayLike } from \"../../interfaces/ArbitrumBridge.sol\";\nimport { WithdrawalHelperBase } from \"./WithdrawalHelperBase.sol\";\nimport { ITokenMessenger } from \"../../external/interfaces/CCTPInterfaces.sol\";\nimport { WETH9Interface } from \"../../external/interfaces/WETH9Interface.sol\";\nimport { CrossDomainAddressUtils } from \"../../libraries/CrossDomainAddressUtils.sol\";\n\n/**\n * @title Arbitrum_WithdrawalHelper\n * @notice This contract interfaces with L2-L1 token bridges and withdraws tokens to a single address on L1.\n * @dev This contract should be deployed on Arbitrum L2s which only use CCTP or the canonical Arbitrum gateway router to withdraw tokens.\n * @custom:security-contact bugs@across.to\n */\ncontract Arbitrum_WithdrawalHelper is WithdrawalHelperBase {\n using SafeERC20 for IERC20;\n\n // Error which triggers when the supplied L1 token does not match the Arbitrum gateway router's expected L2 token.\n error InvalidTokenMapping();\n\n /*\n * @notice Constructs the Arbitrum_WithdrawalHelper.\n * @param _l2Usdc Address of native USDC on the L2.\n * @param _cctpTokenMessenger Address of the CCTP token messenger contract on L2.\n * @param _wrappedNativeToken Address of the wrapped native token contract on L2.\n * @param _destinationCircleDomainId Circle's assigned CCTP domain ID for the destination network. For Ethereum, this is 0.\n * @param _l2GatewayRouter Address of the Arbitrum l2 gateway router contract.\n * @param _tokenRecipient L1 Address which will unconditionally receive tokens withdrawn from this contract.\n */\n constructor(\n IERC20 _l2Usdc,\n ITokenMessenger _cctpTokenMessenger,\n WETH9Interface _wrappedNativeToken,\n uint32 _destinationCircleDomainId,\n address _l2GatewayRouter,\n address _tokenRecipient\n )\n WithdrawalHelperBase(\n _l2Usdc,\n _cctpTokenMessenger,\n _wrappedNativeToken,\n _destinationCircleDomainId,\n _l2GatewayRouter,\n _tokenRecipient\n )\n {}\n\n /**\n * @notice Initializes the withdrawal helper contract.\n * @param _crossDomainAdmin L1 address of the contract which may execute admin functions on this contract.\n */\n function initialize(address _crossDomainAdmin) public initializer {\n __WithdrawalHelper_init(_crossDomainAdmin);\n }\n\n /*\n * @notice Calls CCTP or the Arbitrum gateway router to withdraw tokens back to the TOKEN_RECIPIENT L1 address.\n * @param l1Token Address of the L1 token to receive.\n * @param l2Token Address of the L2 token to send back.\n * @param amountToReturn Amount of l2Token to send back.\n */\n function withdrawToken(\n address l1Token,\n address l2Token,\n uint256 amountToReturn\n ) public override {\n // If the l2TokenAddress is UDSC, we need to use the CCTP bridge.\n if (l2Token == address(usdcToken) && _isCCTPEnabled()) {\n _transferUsdc(TOKEN_RECIPIENT, amountToReturn);\n } else {\n if (l2Token == address(WRAPPED_NATIVE_TOKEN)) _wrapNativeToken();\n // Otherwise, we use the Arbitrum ERC20 Gateway router.\n ArbitrumL2ERC20GatewayLike tokenBridge = ArbitrumL2ERC20GatewayLike(L2_TOKEN_GATEWAY);\n // If the gateway router's expected L2 token address does not match then revert. This check does not actually\n // impact whether the bridge will succeed, since the ERC20 gateway router only requires the L1 token address, but\n // it is added here to potentially catch scenarios where there was a mistake in the calldata.\n if (tokenBridge.calculateL2TokenAddress(l1Token) != l2Token) revert InvalidTokenMapping();\n //slither-disable-next-line unused-return\n tokenBridge.outboundTransfer(\n l1Token, // _l1Token. Address of the L1 token to bridge over.\n TOKEN_RECIPIENT, // _to. Withdraw, over the bridge, to the recipient.\n amountToReturn, // _amount.\n \"\" // _data. We don't need to send any data for the bridging action.\n );\n }\n }\n\n function _requireAdminSender() internal view override {\n if (msg.sender != CrossDomainAddressUtils.applyL1ToL2Alias(crossDomainAdmin)) revert NotCrossDomainAdmin();\n }\n}\n"
- },
- "contracts/chain-adapters/l2/Ovm_WithdrawalHelper.sol": {
- "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\n\nimport { WithdrawalHelperBase } from \"./WithdrawalHelperBase.sol\";\nimport { IERC20 } from \"@openzeppelin/contracts/token/ERC20/IERC20.sol\";\nimport { SafeERC20 } from \"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\";\nimport { WETH9Interface } from \"../../external/interfaces/WETH9Interface.sol\";\nimport { ITokenMessenger } from \"../../external/interfaces/CCTPInterfaces.sol\";\nimport { Lib_PredeployAddresses } from \"@eth-optimism/contracts/libraries/constants/Lib_PredeployAddresses.sol\";\nimport { LibOptimismUpgradeable } from \"@openzeppelin/contracts-upgradeable/crosschain/optimism/LibOptimismUpgradeable.sol\";\nimport { IL2ERC20Bridge } from \"../../Ovm_SpokePool.sol\";\n\n/**\n * @notice Minimal interface for the Ovm_SpokePool contract. This interface is called to pull state from the network's\n * spoke pool contract to be used by this withdrawal adapter.\n */\ninterface IOvm_SpokePool {\n // Returns the address of the token bridge for the input l2 token.\n function tokenBridges(address token) external view returns (address);\n\n // Returns the address of the l1 token set in the spoke pool for the input l2 token.\n function remoteL1Tokens(address token) external view returns (address);\n\n // Returns the address for the representation of ETH on the l2.\n function l2Eth() external view returns (address);\n\n // Returns the amount of gas the contract allocates for a token withdrawal.\n function l1Gas() external view returns (uint32);\n}\n\n/**\n * @title Ovm_WithdrawalAdapter\n * @notice This contract interfaces with L2-L1 token bridges and withdraws tokens to a single address on L1.\n * @dev This contract should be deployed on OpStack L2s which both have a Ovm_SpokePool contract deployed to the L2\n * network AND only use token bridges defined in the Ovm_SpokePool. A notable exception to this requirement is Optimism,\n * which has a special SNX bridge (and thus this adapter will NOT work for Optimism).\n * @custom:security-contact bugs@across.to\n */\ncontract Ovm_WithdrawalHelper is WithdrawalHelperBase {\n using SafeERC20 for IERC20;\n\n // Address of the corresponding spoke pool on L2. This is to piggyback off of the spoke pool's supported\n // token routes/defined token bridges.\n IOvm_SpokePool public immutable spokePool;\n // Address of native ETH on the l2. For OpStack chains, this address is used to indicate a native ETH withdrawal.\n // In general, this address is 0xDeadDeAddeAddEAddeadDEaDDEAdDeaDDeAD0000.\n address public immutable l2Eth;\n // Address of the messenger contract on L2. This is by default defined in Lib_PredeployAddresses.\n address public constant MESSENGER = Lib_PredeployAddresses.L2_CROSS_DOMAIN_MESSENGER;\n\n /*\n * @notice Constructs the Ovm_WithdrawalAdapter.\n * @param _l2Usdc Address of native USDC on the L2.\n * @param _cctpTokenMessenger Address of the CCTP token messenger contract on L2.\n * @param _wrappedNativeToken Address of the wrapped native token contract on L2.\n * @param _destinationCircleDomainId Circle's assigned CCTP domain ID for the destination network. For Ethereum, this\n * is 0.\n * @param _l2Gateway Address of the Optimism ERC20 L2 standard bridge contract.\n * @param _tokenRecipient The L1 address which will unconditionally receive tokens from withdrawals by this contract.\n * @param _spokePool The contract address of the Ovm_SpokePool which is deployed on this L2 network.\n */\n constructor(\n IERC20 _l2Usdc,\n ITokenMessenger _cctpTokenMessenger,\n WETH9Interface _wrappedNativeToken,\n uint32 _destinationCircleDomainId,\n address _l2Gateway,\n address _tokenRecipient,\n IOvm_SpokePool _spokePool\n )\n WithdrawalHelperBase(\n _l2Usdc,\n _cctpTokenMessenger,\n _wrappedNativeToken,\n _destinationCircleDomainId,\n _l2Gateway,\n _tokenRecipient\n )\n {\n spokePool = _spokePool;\n\n // This address is immutable in the spoke pool so we query once and save its value locally.\n l2Eth = spokePool.l2Eth();\n }\n\n /**\n * @notice Initializes the withdrawal helper contract.\n * @param _crossDomainAdmin L1 address of the contract which can send root bundles/messages to this forwarder contract.\n */\n function initialize(address _crossDomainAdmin) public initializer {\n __WithdrawalHelper_init(_crossDomainAdmin);\n }\n\n /*\n * @notice Calls CCTP or the Optimism token gateway to withdraw tokens back to the recipient.\n * @param l2Token address of the l2Token to send back.\n * @param amountToReturn amount of l2Token to send back.\n * @dev The l1Token parameter is unused since we obtain the l1Token to receive by querying the state of the Ovm_SpokePool deployed\n * to this network.\n * @dev This function is a copy of the `_bridgeTokensToHubPool` function found on the Ovm_SpokePool contract here:\n * https://github.com/across-protocol/contracts/blob/65191dbcded95c8fe050e0f95eb7848e3784e61f/contracts/Ovm_SpokePool.sol#L148.\n * New lines of code correspond to instances where this contract queries state from the spoke pool, such as determining\n * the appropriate token bridge for the withdrawal or finding the remoteL1Token to withdraw.\n */\n function withdrawToken(\n address,\n address l2Token,\n uint256 amountToReturn\n ) public override {\n // Fetch the current l1Gas defined in the Ovm_SpokePool.\n uint32 l1Gas = spokePool.l1Gas();\n // If the token being bridged is WETH then we need to first unwrap it to ETH and then send ETH over the\n // canonical bridge. On Optimism, this is address 0xDeadDeAddeAddEAddeadDEaDDEAdDeaDDeAD0000.\n if (l2Token == address(WRAPPED_NATIVE_TOKEN)) {\n // Wrap the contract's balance of the native token if we are withdrawing the L2's native token. We need wrap the contract's balance\n // and then unwrap the amount to send to account for cases where `amountToReturn` is greater than the contract's native token balance\n // and wrapped native token balance, but less than their sum.\n _wrapNativeToken();\n WETH9Interface(l2Token).withdraw(amountToReturn); // Unwrap into ETH.\n l2Token = l2Eth; // Set the l2Token to ETH.\n IL2ERC20Bridge(Lib_PredeployAddresses.L2_STANDARD_BRIDGE).withdrawTo{ value: amountToReturn }(\n l2Token, // _l2Token. Address of the L2 token to bridge over.\n TOKEN_RECIPIENT, // _to. Withdraw, over the bridge, to the l1 pool contract.\n amountToReturn, // _amount.\n l1Gas, // _l1Gas. Unused, but included for potential forward compatibility considerations\n \"\" // _data. We don't need to send any data for the bridging action.\n );\n }\n // If the token is USDC && CCTP bridge is enabled, then bridge USDC via CCTP.\n else if (l2Token == address(usdcToken) && _isCCTPEnabled()) {\n _transferUsdc(TOKEN_RECIPIENT, amountToReturn);\n }\n // Note we'll default to withdrawTo instead of bridgeERC20To unless the remoteL1Tokens mapping is set for\n // the l2Token. withdrawTo should be used to bridge back non-native L2 tokens\n // (i.e. non-native L2 tokens have a canonical L1 token). If we should bridge \"native L2\" tokens then\n // we'd need to call bridgeERC20To and give allowance to the tokenBridge to spend l2Token from this contract.\n // Therefore for native tokens we should set ensure that remoteL1Tokens is set for the l2Token.\n else {\n IL2ERC20Bridge tokenBridge = IL2ERC20Bridge(\n spokePool.tokenBridges(l2Token) == address(0)\n ? Lib_PredeployAddresses.L2_STANDARD_BRIDGE\n : spokePool.tokenBridges(l2Token)\n );\n address remoteL1Token = spokePool.remoteL1Tokens(l2Token);\n if (remoteL1Token != address(0)) {\n // If there is a mapping for this L2 token to an L1 token, then use the L1 token address and\n // call bridgeERC20To.\n IERC20(l2Token).safeIncreaseAllowance(address(tokenBridge), amountToReturn);\n tokenBridge.bridgeERC20To(\n l2Token, // _l2Token. Address of the L2 token to bridge over.\n remoteL1Token, // Remote token to be received on L1 side. If the\n // remoteL1Token on the other chain does not recognize the local token as the correct\n // pair token, the ERC20 bridge will fail and the tokens will be returned to sender on\n // this chain.\n TOKEN_RECIPIENT, // _to\n amountToReturn, // _amount\n l1Gas, // _l1Gas\n \"\" // _data\n );\n } else {\n tokenBridge.withdrawTo(\n l2Token, // _l2Token. Address of the L2 token to bridge over.\n TOKEN_RECIPIENT, // _to. Withdraw, over the bridge, to the l1 pool contract.\n amountToReturn, // _amount.\n l1Gas, // _l1Gas. Unused, but included for potential forward compatibility considerations\n \"\" // _data. We don't need to send any data for the bridging action.\n );\n }\n }\n }\n\n function _requireAdminSender() internal view override {\n if (LibOptimismUpgradeable.crossChainSender(MESSENGER) != crossDomainAdmin) revert NotCrossDomainAdmin();\n }\n}\n"
- },
- "contracts/chain-adapters/l2/WithdrawalHelperBase.sol": {
- "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\n\nimport { IERC20 } from \"@openzeppelin/contracts/token/ERC20/IERC20.sol\";\nimport { MultiCaller } from \"@uma/core/contracts/common/implementation/MultiCaller.sol\";\nimport { CircleCCTPAdapter, ITokenMessenger, CircleDomainIds } from \"../../libraries/CircleCCTPAdapter.sol\";\nimport { WETH9Interface } from \"../../external/interfaces/WETH9Interface.sol\";\nimport { UUPSUpgradeable } from \"@openzeppelin/contracts-upgradeable/proxy/utils/UUPSUpgradeable.sol\";\n\n/**\n * @title WithdrawalHelperBase\n * @notice This contract contains general configurations for bridging tokens from an L2 to a single recipient on L1.\n * @dev This contract should be deployed on L2. It provides an interface to withdraw tokens to some address on L1. The only\n * function which must be implemented in contracts which inherit this contract is `withdrawToken`. It is up to that function\n * to determine which bridges to use for an input L2 token. Importantly, that function must also verify that the L2 to L1\n * token mapping is correct so that the bridge call itself can succeed.\n */\nabstract contract WithdrawalHelperBase is CircleCCTPAdapter, MultiCaller, UUPSUpgradeable {\n // The L2 address of the wrapped native token for this L2.\n WETH9Interface public immutable WRAPPED_NATIVE_TOKEN;\n // The L1 address which will unconditionally receive all withdrawals from this contract.\n address public immutable TOKEN_RECIPIENT;\n // The address of the primary or default token gateway/canonical bridge contract on L2.\n address public immutable L2_TOKEN_GATEWAY;\n // The address of the admin contract on L1,which will likely be the hub pool. As a last resort, this admin can rescue stuck tokens\n // on this withdrawal helper contract, similar to how it may send admin functions to spoke pools.\n address public crossDomainAdmin;\n\n event SetXDomainAdmin(address indexed _crossDomainAdmin);\n\n // Error which triggers when the cross domain admin was attempted to be set to the zero address.\n error InvalidCrossDomainAdmin();\n // Error which triggers when the caller of a protected function is not the cross domain admin.\n error NotCrossDomainAdmin();\n\n // Functions which contain this modifier should only be callable via a cross-chain call where the L1 msg.sender is the hub pool.\n modifier onlyAdmin() {\n _requireAdminSender();\n _;\n }\n\n /*\n * @notice Constructs a new withdrawal helper.\n * @param _l2Usdc Address of native USDC on the L2.\n * @param _cctpTokenMessenger Address of the CCTP token messenger contract on L2.\n * @param _wrappedNativeToken Address of the wrapped native token contract on L2.\n * @param _destinationCircleDomainId Circle's assigned CCTP domain ID for the destination network.\n * @param _l2TokenGateway Address of the network's l2 token gateway/bridge contract.\n * @param _tokenRecipient L1 address which will unconditionally receive all withdrawals originating from this contract.\n * @dev _disableInitializers() restricts anybody from initializing the implementation contract, which if not done,\n * may disrupt the proxy if another EOA were to initialize it.\n */\n constructor(\n IERC20 _l2Usdc,\n ITokenMessenger _cctpTokenMessenger,\n WETH9Interface _wrappedNativeToken,\n uint32 _destinationCircleDomainId,\n address _l2TokenGateway,\n address _tokenRecipient\n ) CircleCCTPAdapter(_l2Usdc, _cctpTokenMessenger, _destinationCircleDomainId) {\n L2_TOKEN_GATEWAY = _l2TokenGateway;\n TOKEN_RECIPIENT = _tokenRecipient;\n WRAPPED_NATIVE_TOKEN = _wrappedNativeToken;\n _disableInitializers();\n }\n\n /**\n * @notice Receives the native token from bridge contracts.\n * @dev When bridging from L3 to the L2's native token, OpStack bridges will send the \"unwrapped\"/native token to the recipient on L2\n * during withdrawals. This means that this contract must be able to accept value transfers.\n */\n receive() external payable {}\n\n /**\n * @notice Initializes the withdrawal helper contract.\n * @param _crossDomainAdmin L1 address of the contract which can send root bundles/messages to this forwarder contract.\n */\n function __WithdrawalHelper_init(address _crossDomainAdmin) public onlyInitializing {\n __UUPSUpgradeable_init();\n _setCrossDomainAdmin(_crossDomainAdmin);\n }\n\n /*\n * @notice Sets a new cross domain admin. The admin cannot be the zero address. The cross domain admin is the only address which may call\n * upgrade this contract.\n * @param _newCrossDomainAdmin L1 address of the new cross domain admin.\n */\n function _setCrossDomainAdmin(address _newCrossDomainAdmin) internal {\n if (_newCrossDomainAdmin == address(0)) revert InvalidCrossDomainAdmin();\n crossDomainAdmin = _newCrossDomainAdmin;\n emit SetXDomainAdmin(_newCrossDomainAdmin);\n }\n\n /*\n * @notice Withdraws a specified token to L1. This may be implemented uniquely for each L2, since each L2 has various\n * dependencies to withdraw a token, such as the token bridge to use, mappings for L1 and L2 tokens, and gas configurations.\n * Notably, withdrawals should always send token back to `TOKEN_RECIPIENT`.\n * @param l1Token Address of the l1Token to receive.\n * @param l2Token Address of the l2Token to send back.\n * @param amountToReturn Amount of l2Token to send back.\n * @dev Some networks do not require the L1/L2 token argument to withdraw tokens, while others enable contracts to derive the\n * L1/L2 given knowledge of only one of the addresses. Both arguments are provided to enable a flexible interface; however, due\n * to this, `withdrawToken` MUST account for situations where the L1/L2 token mapping is incorrect.\n */\n function withdrawToken(\n address l1Token,\n address l2Token,\n uint256 amountToReturn\n ) public virtual;\n\n /*\n * @notice Wraps the contract's entire balance of the native token.\n */\n function _wrapNativeToken() internal virtual {\n if (address(this).balance > 0) WRAPPED_NATIVE_TOKEN.deposit{ value: address(this).balance }();\n }\n\n /*\n * @notice Checks that the L1 msg.sender is the `crossDomainAdmin` address.\n * @dev This implementation must change on a per-chain basis, since each L2 network has their own method of deriving the L1 msg.sender.\n */\n function _requireAdminSender() internal virtual;\n\n /*\n * @notice Access control check for upgrading this proxy contract\n * @dev This requires that _requireAdminSender() is properly implemented on all contracts which inherit WithdrawalHelperBase.\n */\n function _authorizeUpgrade(address) internal override onlyAdmin {}\n\n // Reserve storage slots for future versions of this base contract to add state variables without\n // affecting the storage layout of child contracts. Decrement the size of __gap whenever state variables\n // are added. This is at bottom of contract to make sure it's always at the end of storage.\n uint256[1000] private __gap;\n}\n"
- },
- "contracts/chain-adapters/Linea_Adapter.sol": {
- "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\n\nimport \"./interfaces/AdapterInterface.sol\";\nimport \"../external/interfaces/WETH9Interface.sol\";\nimport \"../libraries/CircleCCTPAdapter.sol\";\n\nimport { IMessageService, ITokenBridge, IUSDCBridge } from \"../external/interfaces/LineaInterfaces.sol\";\n\nimport \"@openzeppelin/contracts/token/ERC20/IERC20.sol\";\nimport \"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\";\n\n/**\n * @notice Supports sending messages and tokens from L1 to Linea.\n * @custom:security-contact bugs@across.to\n */\n// solhint-disable-next-line contract-name-camelcase\ncontract Linea_Adapter is AdapterInterface, CircleCCTPAdapter {\n using SafeERC20 for IERC20;\n\n WETH9Interface public immutable L1_WETH;\n IMessageService public immutable L1_MESSAGE_SERVICE;\n ITokenBridge public immutable L1_TOKEN_BRIDGE;\n\n /**\n * @notice Constructs new Adapter.\n * @param _l1Weth WETH address on L1.\n * @param _l1MessageService Canonical message service contract on L1.\n * @param _l1TokenBridge Canonical token bridge contract on L1.\n */\n constructor(\n WETH9Interface _l1Weth,\n IMessageService _l1MessageService,\n ITokenBridge _l1TokenBridge,\n IERC20 _l1Usdc,\n ITokenMessenger _cctpTokenMessenger\n ) CircleCCTPAdapter(_l1Usdc, _cctpTokenMessenger, CircleDomainIds.Linea) {\n L1_WETH = _l1Weth;\n L1_MESSAGE_SERVICE = _l1MessageService;\n L1_TOKEN_BRIDGE = _l1TokenBridge;\n }\n\n /**\n * @notice Send cross-chain message to target on Linea.\n * @param target Contract on Linea that will receive message.\n * @param message Data to send to target.\n */\n function relayMessage(address target, bytes calldata message) external payable override {\n // Linea currently does not support auto-claiming of cross-chain messages that have\n // non-empty calldata. As we need to manually claim these messages, we can set the\n // message fees to 0.\n L1_MESSAGE_SERVICE.sendMessage(target, 0, message);\n emit MessageRelayed(target, message);\n }\n\n /**\n * @notice Bridge tokens to Linea.\n * @param l1Token L1 token to deposit.\n * @param l2Token L2 token to receive.\n * @param amount Amount of L1 tokens to deposit and L2 tokens to receive.\n * @param to Bridge recipient.\n */\n function relayTokens(\n address l1Token,\n address l2Token,\n uint256 amount,\n address to\n ) external payable override {\n if (l1Token == address(usdcToken) && _isCCTPEnabled()) {\n _transferUsdc(to, amount);\n }\n // If the l1Token is WETH then unwrap it to ETH then send the ETH directly\n // via the Canoncial Message Service.\n else if (l1Token == address(L1_WETH)) {\n L1_WETH.withdraw(amount);\n L1_MESSAGE_SERVICE.sendMessage{ value: amount }(to, 0, \"\");\n }\n // For other tokens, we can use the Canonical Token Bridge.\n else {\n IERC20(l1Token).safeIncreaseAllowance(address(L1_TOKEN_BRIDGE), amount);\n L1_TOKEN_BRIDGE.bridgeToken(l1Token, amount, to);\n }\n\n emit TokensRelayed(l1Token, l2Token, amount, to);\n }\n}\n"
- },
- "contracts/chain-adapters/Lisk_Adapter.sol": {
- "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\n\nimport \"./interfaces/AdapterInterface.sol\";\nimport \"../external/interfaces/WETH9Interface.sol\";\n\n// @dev Use local modified CrossDomainEnabled contract instead of one exported by eth-optimism because we need\n// this contract's state variables to be `immutable` because of the delegateCall call.\nimport \"./CrossDomainEnabled.sol\";\nimport \"@eth-optimism/contracts/L1/messaging/IL1StandardBridge.sol\";\n\nimport \"@openzeppelin/contracts/token/ERC20/IERC20.sol\";\nimport \"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\";\n\nimport \"../libraries/CircleCCTPAdapter.sol\";\nimport \"../external/interfaces/CCTPInterfaces.sol\";\n\n/**\n * @notice Contract containing logic to send messages from L1 to Lisk. This is a clone of the Base/Mode adapter\n * @dev Public functions calling external contracts do not guard against reentrancy because they are expected to be\n * called via delegatecall, which will execute this contract's logic within the context of the originating contract.\n * For example, the HubPool will delegatecall these functions, therefore its only necessary that the HubPool's methods\n * that call this contract's logic guard against reentrancy.\n * @custom:security-contact bugs@across.to\n */\n\n// solhint-disable-next-line contract-name-camelcase\ncontract Lisk_Adapter is CrossDomainEnabled, AdapterInterface, CircleCCTPAdapter {\n using SafeERC20 for IERC20;\n uint32 public constant L2_GAS_LIMIT = 200_000;\n\n WETH9Interface public immutable L1_WETH;\n\n IL1StandardBridge public immutable L1_STANDARD_BRIDGE;\n\n /**\n * @notice Constructs new Adapter.\n * @param _l1Weth WETH address on L1.\n * @param _crossDomainMessenger XDomainMessenger Lisk system contract.\n * @param _l1StandardBridge Standard bridge contract.\n * @param _l1Usdc USDC address on L1.\n */\n constructor(\n WETH9Interface _l1Weth,\n address _crossDomainMessenger,\n IL1StandardBridge _l1StandardBridge,\n IERC20 _l1Usdc\n )\n CrossDomainEnabled(_crossDomainMessenger)\n CircleCCTPAdapter(\n _l1Usdc,\n // Hardcode cctp messenger to 0x0 to disable CCTP bridging.\n ITokenMessenger(address(0)),\n CircleDomainIds.UNINITIALIZED\n )\n {\n L1_WETH = _l1Weth;\n L1_STANDARD_BRIDGE = _l1StandardBridge;\n }\n\n /**\n * @notice Send cross-chain message to target on Lisk.\n * @param target Contract on Lisk that will receive message.\n * @param message Data to send to target.\n */\n function relayMessage(address target, bytes calldata message) external payable override {\n sendCrossDomainMessage(target, L2_GAS_LIMIT, message);\n emit MessageRelayed(target, message);\n }\n\n /**\n * @notice Bridge tokens to Lisk.\n * @param l1Token L1 token to deposit.\n * @param l2Token L2 token to receive.\n * @param amount Amount of L1 tokens to deposit and L2 tokens to receive.\n * @param to Bridge recipient.\n */\n function relayTokens(\n address l1Token,\n address l2Token,\n uint256 amount,\n address to\n ) external payable override {\n // If the l1Token is weth then unwrap it to ETH then send the ETH to the standard bridge.\n if (l1Token == address(L1_WETH)) {\n L1_WETH.withdraw(amount);\n L1_STANDARD_BRIDGE.depositETHTo{ value: amount }(to, L2_GAS_LIMIT, \"\");\n }\n // Check if this token is USDC, which requires a custom bridge via CCTP.\n else if (_isCCTPEnabled() && l1Token == address(usdcToken)) {\n _transferUsdc(to, amount);\n } else {\n IL1StandardBridge _l1StandardBridge = L1_STANDARD_BRIDGE;\n\n IERC20(l1Token).safeIncreaseAllowance(address(_l1StandardBridge), amount);\n _l1StandardBridge.depositERC20To(l1Token, l2Token, to, amount, L2_GAS_LIMIT, \"\");\n }\n emit TokensRelayed(l1Token, l2Token, amount, to);\n }\n}\n"
- },
- "contracts/chain-adapters/Mode_Adapter.sol": {
- "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\n\nimport \"./interfaces/AdapterInterface.sol\";\nimport \"../external/interfaces/WETH9Interface.sol\";\n\n// @dev Use local modified CrossDomainEnabled contract instead of one exported by eth-optimism because we need\n// this contract's state variables to be `immutable` because of the delegateCall call.\nimport \"./CrossDomainEnabled.sol\";\nimport \"@eth-optimism/contracts/L1/messaging/IL1StandardBridge.sol\";\n\nimport \"@openzeppelin/contracts/token/ERC20/IERC20.sol\";\nimport \"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\";\n\nimport \"../libraries/CircleCCTPAdapter.sol\";\nimport \"../external/interfaces/CCTPInterfaces.sol\";\n\n/**\n * @notice Contract containing logic to send messages from L1 to Mode. This is a clone of the Base adapter\n * @dev Public functions calling external contracts do not guard against reentrancy because they are expected to be\n * called via delegatecall, which will execute this contract's logic within the context of the originating contract.\n * For example, the HubPool will delegatecall these functions, therefore its only necessary that the HubPool's methods\n * that call this contract's logic guard against reentrancy.\n * @custom:security-contact bugs@across.to\n */\n\n// solhint-disable-next-line contract-name-camelcase\ncontract Mode_Adapter is CrossDomainEnabled, AdapterInterface, CircleCCTPAdapter {\n using SafeERC20 for IERC20;\n uint32 public constant L2_GAS_LIMIT = 200_000;\n\n WETH9Interface public immutable L1_WETH;\n\n IL1StandardBridge public immutable L1_STANDARD_BRIDGE;\n\n /**\n * @notice Constructs new Adapter.\n * @param _l1Weth WETH address on L1.\n * @param _crossDomainMessenger XDomainMessenger Mode system contract.\n * @param _l1StandardBridge Standard bridge contract.\n * @param _l1Usdc USDC address on L1.\n */\n constructor(\n WETH9Interface _l1Weth,\n address _crossDomainMessenger,\n IL1StandardBridge _l1StandardBridge,\n IERC20 _l1Usdc\n )\n CrossDomainEnabled(_crossDomainMessenger)\n CircleCCTPAdapter(\n _l1Usdc,\n // Hardcode cctp messenger to 0x0 to disable CCTP bridging.\n ITokenMessenger(address(0)),\n CircleDomainIds.UNINITIALIZED\n )\n {\n L1_WETH = _l1Weth;\n L1_STANDARD_BRIDGE = _l1StandardBridge;\n }\n\n /**\n * @notice Send cross-chain message to target on Mode.\n * @param target Contract on Mode that will receive message.\n * @param message Data to send to target.\n */\n function relayMessage(address target, bytes calldata message) external payable override {\n sendCrossDomainMessage(target, L2_GAS_LIMIT, message);\n emit MessageRelayed(target, message);\n }\n\n /**\n * @notice Bridge tokens to Mode.\n * @param l1Token L1 token to deposit.\n * @param l2Token L2 token to receive.\n * @param amount Amount of L1 tokens to deposit and L2 tokens to receive.\n * @param to Bridge recipient.\n */\n function relayTokens(\n address l1Token,\n address l2Token,\n uint256 amount,\n address to\n ) external payable override {\n // If the l1Token is weth then unwrap it to ETH then send the ETH to the standard bridge.\n if (l1Token == address(L1_WETH)) {\n L1_WETH.withdraw(amount);\n L1_STANDARD_BRIDGE.depositETHTo{ value: amount }(to, L2_GAS_LIMIT, \"\");\n }\n // Check if this token is USDC, which requires a custom bridge via CCTP.\n else if (_isCCTPEnabled() && l1Token == address(usdcToken)) {\n _transferUsdc(to, amount);\n } else {\n IL1StandardBridge _l1StandardBridge = L1_STANDARD_BRIDGE;\n\n IERC20(l1Token).safeIncreaseAllowance(address(_l1StandardBridge), amount);\n _l1StandardBridge.depositERC20To(l1Token, l2Token, to, amount, L2_GAS_LIMIT, \"\");\n }\n emit TokensRelayed(l1Token, l2Token, amount, to);\n }\n}\n"
- },
- "contracts/chain-adapters/OP_Adapter.sol": {
- "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\n\nimport \"@eth-optimism/contracts/L1/messaging/IL1StandardBridge.sol\";\nimport \"@openzeppelin/contracts/token/ERC20/IERC20.sol\";\nimport \"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\";\n\nimport { CircleCCTPAdapter, CircleDomainIds } from \"../libraries/CircleCCTPAdapter.sol\";\nimport { ITokenMessenger } from \"../external/interfaces/CCTPInterfaces.sol\";\nimport { IOpUSDCBridgeAdapter } from \"../external/interfaces/IOpUSDCBridgeAdapter.sol\";\nimport { WETH9Interface } from \"../external/interfaces/WETH9Interface.sol\";\nimport { AdapterInterface } from \"./interfaces/AdapterInterface.sol\";\n\n// @dev Use local modified CrossDomainEnabled contract instead of one exported by eth-optimism because we need\n// this contract's state variables to be `immutable` because of the delegateCall call.\nimport { CrossDomainEnabled } from \"./CrossDomainEnabled.sol\";\n\n/**\n * @notice Contract containing logic to send messages from L1 to an OP stack chain.\n * @notice This adapter supports the OpUSDCBridgeAdapter interface for bridging into Circle Bridged USDC.\n * @dev Public functions calling external contracts do not guard against reentrancy because they are expected to be\n * called via delegatecall, which will execute this contract's logic within the context of the originating contract.\n * For example, the HubPool will delegatecall these functions, therefore its only necessary that the HubPool's methods\n * that call this contract's logic guard against reentrancy.\n * @custom:security-contact bugs@across.to\n */\n\n// solhint-disable-next-line contract-name-camelcase\ncontract OP_Adapter is CrossDomainEnabled, AdapterInterface, CircleCCTPAdapter {\n using SafeERC20 for IERC20;\n uint32 public constant L2_GAS_LIMIT = 200_000;\n\n WETH9Interface public immutable L1_WETH;\n\n IL1StandardBridge public immutable L1_STANDARD_BRIDGE;\n IOpUSDCBridgeAdapter public immutable L1_OP_USDC_BRIDGE;\n\n /**\n * @notice Constructs new Adapter.\n * @param _l1Weth WETH address on L1.\n * @param _crossDomainMessenger XDomainMessenger Desination chain system contract.\n * @param _l1StandardBridge Standard bridge contract.\n * @param _l1Usdc USDC address on L1.\n */\n constructor(\n WETH9Interface _l1Weth,\n IERC20 _l1Usdc,\n address _crossDomainMessenger,\n IL1StandardBridge _l1StandardBridge,\n IOpUSDCBridgeAdapter _l1USDCBridge\n )\n CrossDomainEnabled(_crossDomainMessenger)\n CircleCCTPAdapter(\n _l1Usdc,\n // Hardcode cctp messenger to 0x0 to disable CCTP bridging.\n ITokenMessenger(address(0)),\n CircleDomainIds.UNINITIALIZED\n )\n {\n L1_WETH = _l1Weth;\n L1_STANDARD_BRIDGE = _l1StandardBridge;\n L1_OP_USDC_BRIDGE = _l1USDCBridge;\n }\n\n /**\n * @notice Send cross-chain message to target on destination chain.\n * @param target Contract on destination chain that will receive message.\n * @param message Data to send to target.\n */\n function relayMessage(address target, bytes calldata message) external payable override {\n sendCrossDomainMessage(target, L2_GAS_LIMIT, message);\n emit MessageRelayed(target, message);\n }\n\n /**\n * @notice Bridge tokens to destination chain.\n * @param l1Token L1 token to deposit.\n * @param l2Token L2 token to receive.\n * @param amount Amount of L1 tokens to deposit and L2 tokens to receive.\n * @param to Bridge recipient.\n */\n function relayTokens(\n address l1Token,\n address l2Token,\n uint256 amount,\n address to\n ) external payable override {\n // If the l1Token is weth then unwrap it to ETH then send the ETH to the standard bridge.\n if (l1Token == address(L1_WETH)) {\n L1_WETH.withdraw(amount);\n L1_STANDARD_BRIDGE.depositETHTo{ value: amount }(to, L2_GAS_LIMIT, \"\");\n } else if (l1Token == address(usdcToken)) {\n if (_isCCTPEnabled()) {\n _transferUsdc(to, amount);\n } else {\n // Use the relevant OP USDC bridge to received bridged USDC on L2.\n IERC20(l1Token).safeIncreaseAllowance(address(L1_OP_USDC_BRIDGE), amount);\n L1_OP_USDC_BRIDGE.sendMessage(to, amount, L2_GAS_LIMIT);\n }\n } else {\n IERC20(l1Token).safeIncreaseAllowance(address(L1_STANDARD_BRIDGE), amount);\n L1_STANDARD_BRIDGE.depositERC20To(l1Token, l2Token, to, amount, L2_GAS_LIMIT, \"\");\n }\n emit TokensRelayed(l1Token, l2Token, amount, to);\n }\n}\n"
- },
- "contracts/chain-adapters/Optimism_Adapter.sol": {
- "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\n\nimport \"./interfaces/AdapterInterface.sol\";\nimport \"../external/interfaces/WETH9Interface.sol\";\nimport \"../libraries/CircleCCTPAdapter.sol\";\nimport \"../external/interfaces/CCTPInterfaces.sol\";\n\n// @dev Use local modified CrossDomainEnabled contract instead of one exported by eth-optimism because we need\n// this contract's state variables to be `immutable` because of the delegateCall call.\nimport \"./CrossDomainEnabled.sol\";\nimport \"@eth-optimism/contracts/L1/messaging/IL1StandardBridge.sol\";\n\nimport \"@openzeppelin/contracts/token/ERC20/IERC20.sol\";\nimport \"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\";\n\n/**\n * @notice Interface for Synthetix custom bridge to Optimism.\n */\ninterface SynthetixBridgeToOptimism is IL1StandardBridge {\n /**\n * @notice Send tokens to Optimism.\n * @param to Address to send tokens to on L2.\n * @param amount Amount of tokens to send.\n */\n function depositTo(address to, uint256 amount) external;\n}\n\n/**\n * @notice Contract containing logic to send messages from L1 to Optimism.\n * @dev Public functions calling external contracts do not guard against reentrancy because they are expected to be\n * called via delegatecall, which will execute this contract's logic within the context of the originating contract.\n * For example, the HubPool will delegatecall these functions, therefore it's only necessary that the HubPool's methods\n * that call this contract's logic guard against reentrancy.\n * @custom:security-contact bugs@across.to\n */\n\n// solhint-disable-next-line contract-name-camelcase\ncontract Optimism_Adapter is CrossDomainEnabled, AdapterInterface, CircleCCTPAdapter {\n using SafeERC20 for IERC20;\n uint32 public constant L2_GAS_LIMIT = 200_000;\n\n WETH9Interface public immutable L1_WETH;\n\n IL1StandardBridge public immutable L1_STANDARD_BRIDGE;\n\n // Optimism has the ability to support \"custom\" bridges. These bridges are not supported by the canonical bridge\n // and so we need to store the address of the custom token and the associated bridge. In the event we want to\n // support a new token that is not supported by Optimism, we can add a new custom bridge for it and re-deploy the\n // adapter. A full list of custom optimism tokens and their associated bridges can be found here:\n // https://github.com/ethereum-optimism/ethereum-optimism.github.io/blob/master/optimism.tokenlist.json\n address public constant DAI = 0x6B175474E89094C44Da98b954EedeAC495271d0F;\n address public constant DAI_OPTIMISM_BRIDGE = 0x10E6593CDda8c58a1d0f14C5164B376352a55f2F;\n address public constant SNX = 0xC011a73ee8576Fb46F5E1c5751cA3B9Fe0af2a6F;\n address public constant SNX_OPTIMISM_BRIDGE = 0x39Ea01a0298C315d149a490E34B59Dbf2EC7e48F;\n\n /**\n * @notice Constructs new Adapter.\n * @param _l1Weth WETH address on L1.\n * @param _crossDomainMessenger XDomainMessenger Optimism system contract.\n * @param _l1StandardBridge Standard bridge contract.\n * @param _l1Usdc USDC address on L1.\n * @param _cctpTokenMessenger TokenMessenger contract to bridge via CCTP.\n */\n constructor(\n WETH9Interface _l1Weth,\n address _crossDomainMessenger,\n IL1StandardBridge _l1StandardBridge,\n IERC20 _l1Usdc,\n ITokenMessenger _cctpTokenMessenger\n )\n CrossDomainEnabled(_crossDomainMessenger)\n CircleCCTPAdapter(_l1Usdc, _cctpTokenMessenger, CircleDomainIds.Optimism)\n {\n L1_WETH = _l1Weth;\n L1_STANDARD_BRIDGE = _l1StandardBridge;\n }\n\n /**\n * @notice Send cross-chain message to target on Optimism.\n * @param target Contract on Optimism that will receive message.\n * @param message Data to send to target.\n */\n function relayMessage(address target, bytes calldata message) external payable override {\n sendCrossDomainMessage(target, L2_GAS_LIMIT, message);\n emit MessageRelayed(target, message);\n }\n\n /**\n * @notice Bridge tokens to Optimism.\n * @param l1Token L1 token to deposit.\n * @param l2Token L2 token to receive.\n * @param amount Amount of L1 tokens to deposit and L2 tokens to receive.\n * @param to Bridge recipient.\n */\n function relayTokens(\n address l1Token,\n address l2Token,\n uint256 amount,\n address to\n ) external payable override {\n // If the l1Token is weth then unwrap it to ETH then send the ETH to the standard bridge.\n if (l1Token == address(L1_WETH)) {\n L1_WETH.withdraw(amount);\n L1_STANDARD_BRIDGE.depositETHTo{ value: amount }(to, L2_GAS_LIMIT, \"\");\n }\n // If the l1Token is USDC, then we send it to the CCTP bridge\n else if (_isCCTPEnabled() && l1Token == address(usdcToken)) {\n _transferUsdc(to, amount);\n } else {\n address bridgeToUse = address(L1_STANDARD_BRIDGE);\n\n // Check if the L1 token requires a custom bridge. If so, use that bridge over the standard bridge.\n if (l1Token == DAI) bridgeToUse = DAI_OPTIMISM_BRIDGE; // 1. DAI\n if (l1Token == SNX) bridgeToUse = SNX_OPTIMISM_BRIDGE; // 2. SNX\n\n IERC20(l1Token).safeIncreaseAllowance(bridgeToUse, amount);\n if (l1Token == SNX) SynthetixBridgeToOptimism(bridgeToUse).depositTo(to, amount);\n else IL1StandardBridge(bridgeToUse).depositERC20To(l1Token, l2Token, to, amount, L2_GAS_LIMIT, \"\");\n }\n emit TokensRelayed(l1Token, l2Token, amount, to);\n }\n}\n"
- },
- "contracts/chain-adapters/Polygon_Adapter.sol": {
- "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\n\nimport \"./interfaces/AdapterInterface.sol\";\nimport \"../external/interfaces/WETH9Interface.sol\";\n\nimport \"@openzeppelin/contracts/token/ERC20/IERC20.sol\";\nimport \"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\";\n\nimport \"../libraries/CircleCCTPAdapter.sol\";\nimport \"../external/interfaces/CCTPInterfaces.sol\";\n\n/**\n * @notice Send tokens to Polygon.\n */\ninterface IRootChainManager {\n /**\n * @notice Send msg.value of ETH to Polygon\n * @param user Recipient of ETH on Polygon.\n */\n function depositEtherFor(address user) external payable;\n\n /**\n * @notice Send ERC20 tokens to Polygon.\n * @param user Recipient of L2 equivalent tokens on Polygon.\n * @param rootToken L1 Address of token to send.\n * @param depositData Data to pass to L2 including amount of tokens to send. Should be abi.encode(amount).\n */\n function depositFor(\n address user,\n address rootToken,\n bytes calldata depositData\n ) external;\n}\n\n/**\n * @notice Send arbitrary messages to Polygon.\n */\ninterface IFxStateSender {\n /**\n * @notice Send arbitrary message to Polygon.\n * @param _receiver Address on Polygon to receive message.\n * @param _data Message to send to `_receiver` on Polygon.\n */\n function sendMessageToChild(address _receiver, bytes calldata _data) external;\n}\n\n/**\n * @notice Similar to RootChainManager, but for Matic (Plasma) bridge.\n */\ninterface DepositManager {\n /**\n * @notice Send tokens to Polygon. Only used to send MATIC in this Polygon_Adapter.\n * @param token L1 token to send. Should be MATIC.\n * @param user Recipient of L2 equivalent tokens on Polygon.\n * @param amount Amount of `token` to send.\n */\n function depositERC20ForUser(\n address token,\n address user,\n uint256 amount\n ) external;\n}\n\n/**\n * @notice Sends cross chain messages Polygon L2 network.\n * @dev Public functions calling external contracts do not guard against reentrancy because they are expected to be\n * called via delegatecall, which will execute this contract's logic within the context of the originating contract.\n * For example, the HubPool will delegatecall these functions, therefore its only necessary that the HubPool's methods\n * that call this contract's logic guard against reentrancy.\n * @custom:security-contact bugs@across.to\n */\n\n// solhint-disable-next-line contract-name-camelcase\ncontract Polygon_Adapter is AdapterInterface, CircleCCTPAdapter {\n using SafeERC20 for IERC20;\n IRootChainManager public immutable ROOT_CHAIN_MANAGER;\n IFxStateSender public immutable FX_STATE_SENDER;\n DepositManager public immutable DEPOSIT_MANAGER;\n address public immutable ERC20_PREDICATE;\n address public immutable L1_MATIC;\n WETH9Interface public immutable L1_WETH;\n\n /**\n * @notice Constructs new Adapter.\n * @param _rootChainManager RootChainManager Polygon system contract to deposit tokens over the PoS bridge.\n * @param _fxStateSender FxStateSender Polygon system contract to send arbitrary messages to L2.\n * @param _depositManager DepositManager Polygon system contract to deposit tokens over the Plasma bridge (Matic).\n * @param _erc20Predicate ERC20Predicate Polygon system contract to approve when depositing to the PoS bridge.\n * @param _l1Matic matic address on l1.\n * @param _l1Weth WETH address on L1.\n * @param _l1Usdc USDC address on L1.\n * @param _cctpTokenMessenger TokenMessenger contract to bridge via CCTP.\n */\n constructor(\n IRootChainManager _rootChainManager,\n IFxStateSender _fxStateSender,\n DepositManager _depositManager,\n address _erc20Predicate,\n address _l1Matic,\n WETH9Interface _l1Weth,\n IERC20 _l1Usdc,\n ITokenMessenger _cctpTokenMessenger\n ) CircleCCTPAdapter(_l1Usdc, _cctpTokenMessenger, CircleDomainIds.Polygon) {\n ROOT_CHAIN_MANAGER = _rootChainManager;\n FX_STATE_SENDER = _fxStateSender;\n DEPOSIT_MANAGER = _depositManager;\n ERC20_PREDICATE = _erc20Predicate;\n L1_MATIC = _l1Matic;\n L1_WETH = _l1Weth;\n }\n\n /**\n * @notice Send cross-chain message to target on Polygon.\n * @param target Contract on Polygon that will receive message.\n * @param message Data to send to target.\n */\n\n function relayMessage(address target, bytes calldata message) external payable override {\n FX_STATE_SENDER.sendMessageToChild(target, message);\n emit MessageRelayed(target, message);\n }\n\n /**\n * @notice Bridge tokens to Polygon.\n * @param l1Token L1 token to deposit.\n * @param l2Token L2 token to receive.\n * @param amount Amount of L1 tokens to deposit and L2 tokens to receive.\n * @param to Bridge recipient.\n */\n function relayTokens(\n address l1Token,\n address l2Token,\n uint256 amount,\n address to\n ) external payable override {\n // If the l1Token is weth then unwrap it to ETH then send the ETH to the standard bridge.\n if (l1Token == address(L1_WETH)) {\n L1_WETH.withdraw(amount);\n ROOT_CHAIN_MANAGER.depositEtherFor{ value: amount }(to);\n }\n // If the l1Token is USDC, then we send it to the CCTP bridge\n else if (_isCCTPEnabled() && l1Token == address(usdcToken)) {\n _transferUsdc(to, amount);\n } else if (l1Token == L1_MATIC) {\n IERC20(l1Token).safeIncreaseAllowance(address(DEPOSIT_MANAGER), amount);\n DEPOSIT_MANAGER.depositERC20ForUser(l1Token, to, amount);\n } else {\n IERC20(l1Token).safeIncreaseAllowance(ERC20_PREDICATE, amount);\n ROOT_CHAIN_MANAGER.depositFor(to, l1Token, abi.encode(amount));\n }\n emit TokensRelayed(l1Token, l2Token, amount, to);\n }\n}\n"
- },
- "contracts/chain-adapters/Redstone_Adapter.sol": {
- "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\n\nimport \"./interfaces/AdapterInterface.sol\";\nimport \"../external/interfaces/WETH9Interface.sol\";\n\n// @dev Use local modified CrossDomainEnabled contract instead of one exported by eth-optimism because we need\n// this contract's state variables to be `immutable` because of the delegateCall call.\nimport \"./CrossDomainEnabled.sol\";\nimport \"@eth-optimism/contracts/L1/messaging/IL1StandardBridge.sol\";\n\nimport \"@openzeppelin/contracts/token/ERC20/IERC20.sol\";\nimport \"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\";\n\nimport \"../libraries/CircleCCTPAdapter.sol\";\nimport \"../external/interfaces/CCTPInterfaces.sol\";\n\n/**\n * @notice Contract containing logic to send messages from L1 to Redstone. This is a clone of the Base/Mode adapter\n * @dev Public functions calling external contracts do not guard against reentrancy because they are expected to be\n * called via delegatecall, which will execute this contract's logic within the context of the originating contract.\n * For example, the HubPool will delegatecall these functions, therefore its only necessary that the HubPool's methods\n * that call this contract's logic guard against reentrancy.\n * @custom:security-contact bugs@across.to\n */\n\n// solhint-disable-next-line contract-name-camelcase\ncontract Redstone_Adapter is CrossDomainEnabled, AdapterInterface, CircleCCTPAdapter {\n using SafeERC20 for IERC20;\n uint32 public constant L2_GAS_LIMIT = 200_000;\n\n WETH9Interface public immutable L1_WETH;\n\n IL1StandardBridge public immutable L1_STANDARD_BRIDGE;\n\n /**\n * @notice Constructs new Adapter.\n * @param _l1Weth WETH address on L1.\n * @param _crossDomainMessenger XDomainMessenger Redstone system contract.\n * @param _l1StandardBridge Standard bridge contract.\n * @param _l1Usdc USDC address on L1.\n */\n constructor(\n WETH9Interface _l1Weth,\n address _crossDomainMessenger,\n IL1StandardBridge _l1StandardBridge,\n IERC20 _l1Usdc\n )\n CrossDomainEnabled(_crossDomainMessenger)\n CircleCCTPAdapter(\n _l1Usdc,\n // Hardcode cctp messenger to 0x0 to disable CCTP bridging.\n ITokenMessenger(address(0)),\n CircleDomainIds.UNINITIALIZED\n )\n {\n L1_WETH = _l1Weth;\n L1_STANDARD_BRIDGE = _l1StandardBridge;\n }\n\n /**\n * @notice Send cross-chain message to target on Redstone.\n * @param target Contract on Redstone that will receive message.\n * @param message Data to send to target.\n */\n function relayMessage(address target, bytes calldata message) external payable override {\n sendCrossDomainMessage(target, L2_GAS_LIMIT, message);\n emit MessageRelayed(target, message);\n }\n\n /**\n * @notice Bridge tokens to Redstone.\n * @param l1Token L1 token to deposit.\n * @param l2Token L2 token to receive.\n * @param amount Amount of L1 tokens to deposit and L2 tokens to receive.\n * @param to Bridge recipient.\n */\n function relayTokens(\n address l1Token,\n address l2Token,\n uint256 amount,\n address to\n ) external payable override {\n // If the l1Token is weth then unwrap it to ETH then send the ETH to the standard bridge.\n if (l1Token == address(L1_WETH)) {\n L1_WETH.withdraw(amount);\n L1_STANDARD_BRIDGE.depositETHTo{ value: amount }(to, L2_GAS_LIMIT, \"\");\n }\n // Check if this token is USDC, which requires a custom bridge via CCTP.\n else if (_isCCTPEnabled() && l1Token == address(usdcToken)) {\n _transferUsdc(to, amount);\n } else {\n IL1StandardBridge _l1StandardBridge = L1_STANDARD_BRIDGE;\n\n IERC20(l1Token).safeIncreaseAllowance(address(_l1StandardBridge), amount);\n _l1StandardBridge.depositERC20To(l1Token, l2Token, to, amount, L2_GAS_LIMIT, \"\");\n }\n emit TokensRelayed(l1Token, l2Token, amount, to);\n }\n}\n"
- },
- "contracts/chain-adapters/Solana_Adapter.sol": {
- "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\n\nimport { IMessageTransmitter, ITokenMessenger } from \"../external/interfaces/CCTPInterfaces.sol\";\nimport { SpokePoolInterface } from \"../interfaces/SpokePoolInterface.sol\";\nimport { AdapterInterface } from \"./interfaces/AdapterInterface.sol\";\nimport { CircleCCTPAdapter, CircleDomainIds } from \"../libraries/CircleCCTPAdapter.sol\";\nimport { Bytes32ToAddress } from \"../libraries/AddressConverters.sol\";\n\nimport { IERC20 } from \"@openzeppelin/contracts/token/ERC20/IERC20.sol\";\n\n/**\n * @notice Contract containing logic to send messages from L1 to Solana via CCTP.\n * @dev Public functions calling external contracts do not guard against reentrancy because they are expected to be\n * called via delegatecall, which will execute this contract's logic within the context of the originating contract.\n * For example, the HubPool will delegatecall these functions, therefore it's only necessary that the HubPool's methods\n * that call this contract's logic guard against reentrancy.\n * @custom:security-contact bugs@across.to\n */\n\n// solhint-disable-next-line contract-name-camelcase\ncontract Solana_Adapter is AdapterInterface, CircleCCTPAdapter {\n /**\n * @notice We use Bytes32ToAddress library to map a Solana address to an Ethereum address representation.\n * @dev The Ethereum address is derived from the Solana address by truncating it to its lowest 20 bytes. This same\n * conversion must be done by the HubPool owner when adding Solana spoke pool and setting the corresponding pool\n * rebalance and deposit routes.\n */\n using Bytes32ToAddress for bytes32;\n\n /**\n * @notice The official Circle CCTP MessageTransmitter contract endpoint.\n * @dev Posted officially here: https://developers.circle.com/stablecoins/docs/evm-smart-contracts\n */\n // solhint-disable-next-line immutable-vars-naming\n IMessageTransmitter public immutable cctpMessageTransmitter;\n\n // Solana spoke pool address, decoded from Base58 to bytes32.\n bytes32 public immutable SOLANA_SPOKE_POOL_BYTES32;\n\n // Solana spoke pool address, mapped to its EVM address representation.\n address public immutable SOLANA_SPOKE_POOL_ADDRESS;\n\n // USDC mint address on Solana, mapped to its EVM address representation.\n address public immutable SOLANA_USDC_ADDRESS;\n\n // USDC token address on Solana for the spoke pool (vault ATA), decoded from Base58 to bytes32.\n bytes32 public immutable SOLANA_SPOKE_POOL_USDC_VAULT;\n\n // Custom errors for constructor argument validation.\n error InvalidCctpTokenMessenger(address tokenMessenger);\n error InvalidCctpMessageTransmitter(address messageTransmitter);\n\n // Custom errors for relayMessage validation.\n error InvalidRelayMessageTarget(address target);\n\n // Custom errors for relayTokens validation.\n error InvalidL1Token(address l1Token);\n error InvalidL2Token(address l2Token);\n error InvalidAmount(uint256 amount);\n error InvalidTokenRecipient(address to);\n\n /**\n * @notice Constructs new Adapter.\n * @param _l1Usdc USDC address on L1.\n * @param _cctpTokenMessenger TokenMessenger contract to bridge tokens via CCTP.\n * @param _cctpMessageTransmitter MessageTransmitter contract to bridge messages via CCTP.\n * @param solanaSpokePool Solana spoke pool address, decoded from Base58 to bytes32.\n * @param solanaUsdc USDC mint address on Solana, decoded from Base58 to bytes32.\n * @param solanaSpokePoolUsdcVault USDC token address on Solana for the spoke pool, decoded from Base58 to bytes32.\n */\n constructor(\n IERC20 _l1Usdc,\n ITokenMessenger _cctpTokenMessenger,\n IMessageTransmitter _cctpMessageTransmitter,\n bytes32 solanaSpokePool,\n bytes32 solanaUsdc,\n bytes32 solanaSpokePoolUsdcVault\n ) CircleCCTPAdapter(_l1Usdc, _cctpTokenMessenger, CircleDomainIds.Solana) {\n // Solana adapter requires CCTP TokenMessenger and MessageTransmitter contracts to be set.\n if (address(_cctpTokenMessenger) == address(0)) {\n revert InvalidCctpTokenMessenger(address(_cctpTokenMessenger));\n }\n if (address(_cctpMessageTransmitter) == address(0)) {\n revert InvalidCctpMessageTransmitter(address(_cctpMessageTransmitter));\n }\n\n cctpMessageTransmitter = _cctpMessageTransmitter;\n\n SOLANA_SPOKE_POOL_BYTES32 = solanaSpokePool;\n SOLANA_SPOKE_POOL_ADDRESS = solanaSpokePool.toAddressUnchecked();\n\n SOLANA_USDC_ADDRESS = solanaUsdc.toAddressUnchecked();\n\n SOLANA_SPOKE_POOL_USDC_VAULT = solanaSpokePoolUsdcVault;\n }\n\n /**\n * @notice Send cross-chain message to target on Solana.\n * @dev Only allows sending messages to the Solana spoke pool.\n * @param target Program on Solana (translated as EVM address) that will receive message.\n * @param message Data to send to target.\n */\n function relayMessage(address target, bytes calldata message) external payable override {\n if (target != SOLANA_SPOKE_POOL_ADDRESS) {\n revert InvalidRelayMessageTarget(target);\n }\n cctpMessageTransmitter.sendMessage(CircleDomainIds.Solana, SOLANA_SPOKE_POOL_BYTES32, message);\n\n // TODO: consider if we need also to emit the translated message.\n emit MessageRelayed(target, message);\n }\n\n /**\n * @notice Bridge tokens to Solana.\n * @dev Only allows bridging USDC to Solana spoke pool.\n * @param l1Token L1 token to deposit.\n * @param l2Token L2 token to receive.\n * @param amount Amount of L1 tokens to deposit and L2 tokens to receive.\n * @param to Bridge recipient.\n */\n function relayTokens(\n address l1Token,\n address l2Token,\n uint256 amount,\n address to\n ) external payable override {\n if (l1Token != address(usdcToken)) {\n revert InvalidL1Token(l1Token);\n }\n if (l2Token != SOLANA_USDC_ADDRESS) {\n revert InvalidL2Token(l2Token);\n }\n if (amount > type(uint64).max) {\n revert InvalidAmount(amount);\n }\n if (to != SOLANA_SPOKE_POOL_ADDRESS) {\n revert InvalidTokenRecipient(to);\n }\n\n _transferUsdc(SOLANA_SPOKE_POOL_USDC_VAULT, amount);\n\n // TODO: consider if we need also to emit the translated addresses.\n emit TokensRelayed(l1Token, l2Token, amount, to);\n }\n}\n"
- },
- "contracts/chain-adapters/Universal_Adapter.sol": {
- "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\n\nimport \"./interfaces/AdapterInterface.sol\";\n\nimport \"../libraries/CircleCCTPAdapter.sol\";\nimport { SpokePoolInterface } from \"../interfaces/SpokePoolInterface.sol\";\nimport { HubPoolStore } from \"./utilities/HubPoolStore.sol\";\n\ninterface IOwnable {\n function owner() external view returns (address);\n}\n\n/**\n * @notice Stores data that can be relayed to L2 SpokePool using storage proof verification and light client contracts\n * on the L2 where the SpokePool is deployed. Designed to be used as a singleton contract that can be used to relay\n * messages to multiple SpokePools on different chains.\n * @dev This contract should NOT be reused to send messages to SpokePools that have the same address on different L2s.\n * @dev This contract can be redeployed to point to a new HubPoolStore if the data store gets corrupted and new data\n * can't get written to the store for some reason. The corresponding Universal_SpokePool contract will\n * also need to be redeployed to point to the new HubPoolStore.\n * @custom:security-contact bugs@across.to\n */\ncontract Universal_Adapter is AdapterInterface, CircleCCTPAdapter {\n /// @notice Contract that stores calldata to be relayed to L2 via storage proofs.\n HubPoolStore public immutable DATA_STORE;\n\n error NotImplemented();\n\n constructor(\n HubPoolStore _store,\n IERC20 _l1Usdc,\n ITokenMessenger _cctpTokenMessenger,\n uint32 _cctpDestinationDomainId\n ) CircleCCTPAdapter(_l1Usdc, _cctpTokenMessenger, _cctpDestinationDomainId) {\n DATA_STORE = _store;\n }\n\n /**\n * @notice Saves calldata in a simple storage contract whose state can be proven and relayed to L2.\n * @param target Contract on the destination that will receive the message. Unused if the message is created\n * by the HubPool admin.\n * @param message Data to send to target.\n */\n function relayMessage(address target, bytes calldata message) external payable override {\n // Admin messages are stored differently in the data store than non-admin messages, because admin\n // messages must only be sent to a single target on a specific L2 chain. Non-admin messages are sent\n // to any target on any L2 chain because the only type of an non-admin message is the result of a\n // HubPool.executeRootBundle() call which attempts to relay a relayRootBundle() call to all SpokePools using\n // this adapter. Therefore, non-admin messages are stored optimally in the data store\n // by only storing the message once and allowing any SpokePool target to read it via storage proofs.\n\n // We assume that the HubPool is delegatecall-ing into this function, therefore address(this) is the HubPool's\n // address. As a result, we can determine whether this message is an admin function based on the msg.sender.\n // If an admin sends a message that could have been relayed as a non-admin message (e.g. the admin\n // calls executeRootBundle()), then the message won't be stored optimally in the data store, but the\n // message can still be delivered to the target.\n bool isAdminSender = msg.sender == IOwnable(address(this)).owner();\n DATA_STORE.storeRelayMessageCalldata(target, message, isAdminSender);\n emit MessageRelayed(target, message);\n }\n\n /**\n * @notice Relays tokens from L1 to L2.\n * @dev This function only uses the CircleCCTPAdapter to relay USDC tokens to CCTP enabled L2 chains.\n * Relaying other tokens will cause this function to revert.\n * @param l1Token Address of the token on L1.\n * @param l2Token Address of the token on L2. Unused\n * @param amount Amount of tokens to relay.\n * @param to Address to receive the tokens on L2. Should be SpokePool address.\n */\n function relayTokens(\n address l1Token,\n address l2Token,\n uint256 amount,\n address to\n ) external payable override {\n if (_isCCTPEnabled() && l1Token == address(usdcToken)) {\n _transferUsdc(to, amount);\n } else {\n revert NotImplemented();\n }\n }\n}\n"
- },
- "contracts/chain-adapters/utilities/HubPoolStore.sol": {
- "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\n\nimport { HubPoolInterface } from \"../../interfaces/HubPoolInterface.sol\";\n\ninterface IHubPool {\n function rootBundleProposal() external view returns (HubPoolInterface.RootBundle memory);\n}\n\n/**\n * @notice Stores data that can be relayed to L2 SpokePool using storage proof verification and light client contracts\n * on the L2 where the SpokePool is deployed. Only the HubPool can store data to this contract. Each data to be\n * relayed is written to a unique slot key and that slot key's value can never be modified.\n * @dev Designed to be used with Universal_Adapter and Universal_SpokePool.\n * @dev This contract DOES NOT prevent replay attacks of storage proofs on the L2 spoke pool if the\n * UniversalStorageProof_Adapters using this contract are mapped to spokepools with the same address on different\n * L2 chains. See comment in storeRelayAdminFunctionCalldata() for more details.\n * @custom:security-contact bugs@across.to\n */\ncontract HubPoolStore {\n error NotHubPool();\n\n /// @notice Maps nonce to hash of calldata.\n mapping(uint256 => bytes32) public relayMessageCallData;\n\n /// @notice Counter to ensure that each relay admin function calldata is unique.\n uint256 private dataUuid;\n\n /// @notice Address of the HubPool contract, the only contract that can store data to this contract.\n address public immutable hubPool;\n\n /// @notice Event designed to be queried off chain and relayed to Universal SpokePool.\n event StoredCallData(address indexed target, bytes data, uint256 indexed nonce);\n\n modifier onlyHubPool() {\n if (msg.sender != hubPool) {\n revert NotHubPool();\n }\n _;\n }\n\n constructor(address _hubPool) {\n hubPool = _hubPool;\n }\n\n /**\n * @notice To be called by HubPool to store calldata that will be relayed\n * to the Universal_SpokePool via storage proofs.\n * @dev Only callable by the HubPool contract.\n * @param target Address of the contract on the destination that will receive the message. Unused if the\n * data is NOT an admin function and can be relayed to any target.\n * @param data Data to send to Universal SpokePool.\n * @param isAdminSender True if the data is an admin function call, false otherwise.\n */\n function storeRelayMessageCalldata(\n address target,\n bytes calldata data,\n bool isAdminSender\n ) external onlyHubPool {\n if (isAdminSender) {\n _storeData(target, dataUuid++, data);\n } else {\n _storeRelayMessageCalldataForAnyTarget(data);\n }\n }\n\n function _storeRelayMessageCalldataForAnyTarget(bytes calldata data) internal {\n // When the data can be sent to any target, we assume that the data contains a relayRootBundleCall as\n // constructed by an executeRootBundle() call, therefore this data will be identical for all spoke pools\n // in this bundle. We can use the current hub pool's challengePeriodEndTimestamp as the nonce for this data\n // so that all relayRootBundle calldata for this bundle gets stored to the same slot and we only write to\n // this slot once.\n _storeData(address(0), IHubPool(hubPool).rootBundleProposal().challengePeriodEndTimestamp, data);\n }\n\n function _storeData(\n address target,\n uint256 nonce,\n bytes calldata data\n ) internal {\n if (relayMessageCallData[nonce] != bytes32(0)) {\n // Data is already stored, do nothing.\n return;\n }\n relayMessageCallData[nonce] = keccak256(abi.encode(target, data));\n emit StoredCallData(target, data, nonce);\n }\n}\n"
- },
- "contracts/chain-adapters/WorldChain_Adapter.sol": {
- "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\n\nimport \"./interfaces/AdapterInterface.sol\";\nimport \"../external/interfaces/WETH9Interface.sol\";\n\n// @dev Use local modified CrossDomainEnabled contract instead of one exported by eth-optimism because we need\n// this contract's state variables to be `immutable` because of the delegateCall call.\nimport \"./CrossDomainEnabled.sol\";\nimport \"@eth-optimism/contracts/L1/messaging/IL1StandardBridge.sol\";\n\nimport \"@openzeppelin/contracts/token/ERC20/IERC20.sol\";\nimport \"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\";\n\nimport \"../libraries/CircleCCTPAdapter.sol\";\nimport \"../external/interfaces/CCTPInterfaces.sol\";\n\n/**\n * @notice Contract containing logic to send messages from L1 to Doctor Who. This is a modified version of the Optimism adapter\n * that excludes the custom bridging logic.\n * @custom:security-contact bugs@across.to\n * @dev Public functions calling external contracts do not guard against reentrancy because they are expected to be\n * called via delegatecall, which will execute this contract's logic within the context of the originating contract.\n * For example, the HubPool will delegatecall these functions, therefore its only necessary that the HubPool's methods\n * that call this contract's logic guard against reentrancy.\n */\n\n// solhint-disable-next-line contract-name-camelcase\ncontract WorldChain_Adapter is CrossDomainEnabled, AdapterInterface, CircleCCTPAdapter {\n using SafeERC20 for IERC20;\n uint32 public constant L2_GAS_LIMIT = 200_000;\n\n WETH9Interface public immutable L1_WETH;\n\n IL1StandardBridge public immutable L1_STANDARD_BRIDGE;\n\n /**\n * @notice Constructs new Adapter.\n * @param _l1Weth WETH address on L1.\n * @param _crossDomainMessenger XDomainMessenger Doctor Who system contract.\n * @param _l1StandardBridge Standard bridge contract.\n * @param _l1Usdc USDC address on L1.\n * @param _cctpTokenMessenger TokenMessenger contract to bridge via CCTP.\n */\n constructor(\n WETH9Interface _l1Weth,\n address _crossDomainMessenger,\n IL1StandardBridge _l1StandardBridge,\n IERC20 _l1Usdc,\n ITokenMessenger _cctpTokenMessenger\n )\n CrossDomainEnabled(_crossDomainMessenger)\n CircleCCTPAdapter(_l1Usdc, _cctpTokenMessenger, CircleDomainIds.WorldChain)\n {\n L1_WETH = _l1Weth;\n L1_STANDARD_BRIDGE = _l1StandardBridge;\n }\n\n /**\n * @notice Send cross-chain message to target on Doctor Who.\n * @param target Contract on Doctor Who that will receive message.\n * @param message Data to send to target.\n */\n function relayMessage(address target, bytes calldata message) external payable override {\n sendCrossDomainMessage(target, L2_GAS_LIMIT, message);\n emit MessageRelayed(target, message);\n }\n\n /**\n * @notice Bridge tokens to Doctor Who.\n * @param l1Token L1 token to deposit.\n * @param l2Token L2 token to receive.\n * @param amount Amount of L1 tokens to deposit and L2 tokens to receive.\n * @param to Bridge recipient.\n */\n function relayTokens(\n address l1Token,\n address l2Token,\n uint256 amount,\n address to\n ) external payable override {\n // If the l1Token is weth then unwrap it to ETH then send the ETH to the standard bridge.\n if (l1Token == address(L1_WETH)) {\n L1_WETH.withdraw(amount);\n L1_STANDARD_BRIDGE.depositETHTo{ value: amount }(to, L2_GAS_LIMIT, \"\");\n }\n // Check if this token is USDC, which requires a custom bridge via CCTP.\n else if (_isCCTPEnabled() && l1Token == address(usdcToken)) {\n _transferUsdc(to, amount);\n } else {\n IL1StandardBridge _l1StandardBridge = L1_STANDARD_BRIDGE;\n\n IERC20(l1Token).safeIncreaseAllowance(address(_l1StandardBridge), amount);\n _l1StandardBridge.depositERC20To(l1Token, l2Token, to, amount, L2_GAS_LIMIT, \"\");\n }\n emit TokensRelayed(l1Token, l2Token, amount, to);\n }\n}\n"
- },
- "contracts/chain-adapters/ZkStack_Adapter.sol": {
- "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\n\nimport \"./interfaces/AdapterInterface.sol\";\nimport \"../external/interfaces/WETH9Interface.sol\";\n\nimport \"@openzeppelin/contracts/token/ERC20/IERC20.sol\";\nimport \"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\";\nimport { BridgeHubInterface } from \"../interfaces/ZkStackBridgeHub.sol\";\nimport { CircleCCTPAdapter } from \"../libraries/CircleCCTPAdapter.sol\";\nimport { ITokenMessenger } from \"../external/interfaces/CCTPInterfaces.sol\";\n\n/**\n * @notice Contract containing logic to send messages from L1 to ZkStack with ETH as the gas token.\n * @dev Public functions calling external contracts do not guard against reentrancy because they are expected to be\n * called via delegatecall, which will execute this contract's logic within the context of the originating contract.\n * For example, the HubPool will delegatecall these functions, therefore its only necessary that the HubPool's methods\n * that call this contract's logic guard against reentrancy.\n * @custom:security-contact bugs@across.to\n */\n\n// solhint-disable-next-line contract-name-camelcase\ncontract ZkStack_Adapter is AdapterInterface, CircleCCTPAdapter {\n using SafeERC20 for IERC20;\n\n // The ZkSync bridgehub contract treats address(1) to represent ETH.\n address private constant ETH_TOKEN_ADDRESS = address(1);\n\n // We need to pay a base fee to the operator to include our L1 --> L2 transaction.\n // https://docs.zksync.io/build/developer-reference/l1-l2-interoperability#l1-to-l2-gas-estimation-for-transactions\n\n // Limit on L2 gas to spend.\n uint256 public immutable L2_GAS_LIMIT; // typically 2_000_000\n\n // How much gas is required to publish a byte of data from L1 to L2. 800 is the required value\n // as set here https://github.com/matter-labs/era-contracts/blob/6391c0d7bf6184d7f6718060e3991ba6f0efe4a7/ethereum/contracts/zksync/facets/Mailbox.sol#L226\n // Note, this value can change and will require an updated adapter.\n uint256 public immutable L1_GAS_TO_L2_GAS_PER_PUB_DATA_LIMIT; // Typically 800\n\n // This address receives any remaining fee after an L1 to L2 transaction completes.\n // If refund recipient = address(0) then L2 msg.sender is used, unless msg.sender is a contract then its address\n // gets aliased.\n address public immutable L2_REFUND_ADDRESS;\n\n // L2 chain id\n uint256 public immutable CHAIN_ID;\n\n // BridgeHub address\n BridgeHubInterface public immutable BRIDGE_HUB;\n\n // Set l1Weth at construction time to make testing easier.\n WETH9Interface public immutable L1_WETH;\n\n // USDC SharedBridge address, which is passed in on construction and used as the second bridge contract for USDC transfers.\n address public immutable USDC_SHARED_BRIDGE;\n\n // The maximum gas price a transaction sent to this adapter may have. This is set to prevent a block producer from setting an artificially high priority fee\n // when calling a hub pool message relay, which would otherwise cause a large amount of ETH to be sent to L2.\n uint256 private immutable MAX_TX_GASPRICE;\n\n error ETHGasTokenRequired();\n error TransactionFeeTooHigh();\n error InvalidBridgeConfig();\n\n /**\n * @notice Constructs new Adapter.\n * @notice Circle bridged & native USDC are optionally supported via configuration, but are mutually exclusive.\n * @param _chainId The target ZkStack network's chain ID.\n * @param _bridgeHub The bridge hub contract address for the ZkStack network.\n * @param _circleUSDC Circle USDC address on L1. If not set to address(0), then either the USDCSharedBridge\n * or CCTP token messenger must be set and will be used to bridge this token.\n * @param _usdcSharedBridge Address of the second bridge contract for USDC corresponding to the configured ZkStack network.\n * @param _cctpTokenMessenger address of the CCTP token messenger contract for the configured network.\n * @param _recipientCircleDomainId Circle domain ID for the destination network.\n * @param _l1Weth WETH address on L1.\n * @param _l2RefundAddress address that recieves excess gas refunds on L2.\n * @param _l2GasLimit The maximum amount of gas this contract is willing to pay to execute a transaction on L2.\n * @param _l1GasToL2GasPerPubDataLimit The exchange rate of l1 gas to l2 gas.\n * @param _maxTxGasprice The maximum effective gas price any transaction sent to this adapter may have.\n */\n constructor(\n uint256 _chainId,\n BridgeHubInterface _bridgeHub,\n IERC20 _circleUSDC,\n address _usdcSharedBridge,\n ITokenMessenger _cctpTokenMessenger,\n uint32 _recipientCircleDomainId,\n WETH9Interface _l1Weth,\n address _l2RefundAddress,\n uint256 _l2GasLimit,\n uint256 _l1GasToL2GasPerPubDataLimit,\n uint256 _maxTxGasprice\n ) CircleCCTPAdapter(_circleUSDC, _cctpTokenMessenger, _recipientCircleDomainId) {\n CHAIN_ID = _chainId;\n BRIDGE_HUB = _bridgeHub;\n L1_WETH = _l1Weth;\n L2_REFUND_ADDRESS = _l2RefundAddress;\n L2_GAS_LIMIT = _l2GasLimit;\n MAX_TX_GASPRICE = _maxTxGasprice;\n L1_GAS_TO_L2_GAS_PER_PUB_DATA_LIMIT = _l1GasToL2GasPerPubDataLimit;\n address zero = address(0);\n if (address(_circleUSDC) != zero) {\n bool zkUSDCBridgeDisabled = _usdcSharedBridge == zero;\n bool cctpUSDCBridgeDisabled = address(_cctpTokenMessenger) == zero;\n // Bridged and Native USDC are mutually exclusive.\n if (zkUSDCBridgeDisabled == cctpUSDCBridgeDisabled) {\n revert InvalidBridgeConfig();\n }\n }\n USDC_SHARED_BRIDGE = _usdcSharedBridge;\n address gasToken = BRIDGE_HUB.baseToken(CHAIN_ID);\n if (gasToken != ETH_TOKEN_ADDRESS) {\n revert ETHGasTokenRequired();\n }\n }\n\n /**\n * @notice Send cross-chain message to target on ZkStack.\n * @dev The HubPool must hold enough ETH to pay for the L2 txn.\n * @param target Contract on L2 that will receive message.\n * @param message Data to send to target.\n */\n function relayMessage(address target, bytes memory message) external payable override {\n uint256 txBaseCost = _computeETHTxCost(L2_GAS_LIMIT);\n\n BRIDGE_HUB.requestL2TransactionDirect{ value: txBaseCost }(\n BridgeHubInterface.L2TransactionRequestDirect({\n chainId: CHAIN_ID,\n mintValue: txBaseCost,\n l2Contract: target,\n l2Value: 0,\n l2Calldata: message,\n l2GasLimit: L2_GAS_LIMIT,\n l2GasPerPubdataByteLimit: L1_GAS_TO_L2_GAS_PER_PUB_DATA_LIMIT,\n factoryDeps: new bytes[](0),\n refundRecipient: L2_REFUND_ADDRESS\n })\n );\n\n emit MessageRelayed(target, message);\n }\n\n /**\n * @notice Bridge tokens to ZkStack.\n * @dev The HubPool must hold enough ETH to pay for the L2 txn.\n * @param l1Token L1 token to deposit.\n * @param l2Token L2 token to receive.\n * @param amount Amount of L1 tokens to deposit and L2 tokens to receive.\n * @param to Bridge recipient.\n */\n function relayTokens(\n address l1Token,\n address l2Token, // l2Token is unused.\n uint256 amount,\n address to\n ) external payable override {\n // A bypass proxy seems to no longer be needed to avoid deposit limits. The tracking of these limits seems to be deprecated.\n // See: https://github.com/matter-labs/era-contracts/blob/bce4b2d0f34bd87f1aaadd291772935afb1c3bd6/l1-contracts/contracts/bridge/L1ERC20Bridge.sol#L54-L55\n uint256 txBaseCost = _computeETHTxCost(L2_GAS_LIMIT);\n\n bytes32 txHash;\n if (l1Token == address(L1_WETH)) {\n // If the l1Token is WETH then unwrap it to ETH then send the ETH to the standard bridge along with the base\n // cost.\n L1_WETH.withdraw(amount);\n txHash = BRIDGE_HUB.requestL2TransactionDirect{ value: amount + txBaseCost }(\n BridgeHubInterface.L2TransactionRequestDirect({\n chainId: CHAIN_ID,\n mintValue: txBaseCost + amount,\n l2Contract: to,\n l2Value: amount,\n l2Calldata: \"\",\n l2GasLimit: L2_GAS_LIMIT,\n l2GasPerPubdataByteLimit: L1_GAS_TO_L2_GAS_PER_PUB_DATA_LIMIT,\n factoryDeps: new bytes[](0),\n refundRecipient: L2_REFUND_ADDRESS\n })\n );\n } else if (l1Token == address(usdcToken)) {\n // Either use CCTP or the custom shared bridge when bridging USDC.\n if (_isCCTPEnabled()) {\n _transferUsdc(to, amount);\n } else {\n IERC20(l1Token).forceApprove(USDC_SHARED_BRIDGE, amount);\n txHash = BRIDGE_HUB.requestL2TransactionTwoBridges(\n BridgeHubInterface.L2TransactionRequestTwoBridgesOuter({\n chainId: CHAIN_ID,\n mintValue: txBaseCost,\n l2Value: 0,\n l2GasLimit: L2_GAS_LIMIT,\n l2GasPerPubdataByteLimit: L1_GAS_TO_L2_GAS_PER_PUB_DATA_LIMIT,\n refundRecipient: L2_REFUND_ADDRESS,\n secondBridgeAddress: USDC_SHARED_BRIDGE,\n secondBridgeValue: 0,\n secondBridgeCalldata: _secondBridgeCalldata(to, l1Token, amount)\n })\n );\n }\n } else {\n // An standard bridged ERC20, separate from WETH and Circle Bridged/Native USDC.\n address sharedBridge = BRIDGE_HUB.sharedBridge();\n IERC20(l1Token).forceApprove(sharedBridge, amount);\n txHash = BRIDGE_HUB.requestL2TransactionTwoBridges{ value: txBaseCost }(\n BridgeHubInterface.L2TransactionRequestTwoBridgesOuter({\n chainId: CHAIN_ID,\n mintValue: txBaseCost,\n l2Value: 0,\n l2GasLimit: L2_GAS_LIMIT,\n l2GasPerPubdataByteLimit: L1_GAS_TO_L2_GAS_PER_PUB_DATA_LIMIT,\n refundRecipient: L2_REFUND_ADDRESS,\n secondBridgeAddress: sharedBridge,\n secondBridgeValue: 0,\n secondBridgeCalldata: _secondBridgeCalldata(to, l1Token, amount)\n })\n );\n }\n\n emit TokensRelayed(l1Token, l2Token, amount, to);\n }\n\n /**\n * @notice Computes the calldata for the \"second bridge\", which handles sending non native tokens.\n * @param l2Recipient recipient of the tokens.\n * @param l1Token the l1 address of the token. Note: ETH is encoded as address(1).\n * @param amount number of tokens to send.\n * @return abi encoded bytes.\n */\n function _secondBridgeCalldata(\n address l2Recipient,\n address l1Token,\n uint256 amount\n ) internal pure returns (bytes memory) {\n return abi.encode(l1Token, amount, l2Recipient);\n }\n\n /**\n * @notice For a given l2 gas limit, this computes the amount of ETH needed and\n * returns the amount.\n * @param l2GasLimit L2 gas limit for the message.\n * @return amount of ETH that this contract needs to provide in order for the l2 transaction to succeed.\n */\n function _computeETHTxCost(uint256 l2GasLimit) internal view returns (uint256) {\n if (tx.gasprice > MAX_TX_GASPRICE) revert TransactionFeeTooHigh();\n return BRIDGE_HUB.l2TransactionBaseCost(CHAIN_ID, tx.gasprice, l2GasLimit, L1_GAS_TO_L2_GAS_PER_PUB_DATA_LIMIT);\n }\n}\n"
- },
- "contracts/chain-adapters/ZkStack_CustomGasToken_Adapter.sol": {
- "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\n\nimport \"./interfaces/AdapterInterface.sol\";\nimport \"../external/interfaces/WETH9Interface.sol\";\n\nimport \"@openzeppelin/contracts/token/ERC20/IERC20.sol\";\nimport \"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\";\nimport { BridgeHubInterface } from \"../interfaces/ZkStackBridgeHub.sol\";\nimport { CircleCCTPAdapter } from \"../libraries/CircleCCTPAdapter.sol\";\nimport { ITokenMessenger } from \"../external/interfaces/CCTPInterfaces.sol\";\n\n/**\n * @notice Interface for funder contract that this contract pulls from to pay for relayMessage()/relayTokens()\n * fees using a custom gas token.\n */\ninterface FunderInterface {\n /**\n * @notice Withdraws amount of token from funder contract to the caller.\n * @dev Can only be called by owner of Funder contract, which therefore must be\n * this contract.\n * @param token Token to withdraw.\n * @param amount Amount to withdraw.\n */\n function withdraw(IERC20 token, uint256 amount) external;\n}\n\n/**\n * @notice Contract containing logic to send messages from L1 to ZkStack with a custom gas token.\n * @dev Public functions calling external contracts do not guard against reentrancy because they are expected to be\n * called via delegatecall, which will execute this contract's logic within the context of the originating contract.\n * For example, the HubPool will delegatecall these functions, therefore its only necessary that the HubPool's methods\n * that call this contract's logic guard against reentrancy.\n * @custom:security-contact bugs@across.to\n */\n\n// solhint-disable-next-line contract-name-camelcase\ncontract ZkStack_CustomGasToken_Adapter is AdapterInterface, CircleCCTPAdapter {\n using SafeERC20 for IERC20;\n\n // The ZkSync bridgehub contract treats address(1) to represent ETH.\n address private constant ETH_TOKEN_ADDRESS = address(1);\n\n // We need to pay a base fee to the operator to include our L1 --> L2 transaction.\n // https://docs.zksync.io/build/developer-reference/l1-l2-interoperability#l1-to-l2-gas-estimation-for-transactions\n\n // Limit on L2 gas to spend.\n uint256 public immutable L2_GAS_LIMIT; // typically 2_000_000\n\n // How much gas is required to publish a byte of data from L1 to L2. 800 is the required value\n // as set here https://github.com/matter-labs/era-contracts/blob/6391c0d7bf6184d7f6718060e3991ba6f0efe4a7/ethereum/contracts/zksync/facets/Mailbox.sol#L226\n // Note, this value can change and will require an updated adapter.\n uint256 public immutable L1_GAS_TO_L2_GAS_PER_PUB_DATA_LIMIT; // Typically 800\n\n // This address receives any remaining fee after an L1 to L2 transaction completes.\n // If refund recipient = address(0) then L2 msg.sender is used, unless msg.sender is a contract then its address\n // gets aliased.\n address public immutable L2_REFUND_ADDRESS;\n\n // L2 chain id\n uint256 public immutable CHAIN_ID;\n\n // BridgeHub address\n BridgeHubInterface public immutable BRIDGE_HUB;\n\n // Set l1Weth at construction time to make testing easier.\n WETH9Interface public immutable L1_WETH;\n\n // USDC SharedBridge address, which is passed in on construction and used as the second bridge contract for USDC transfers.\n address public immutable USDC_SHARED_BRIDGE;\n\n // Custom gas token address, which is read from the BridgeHub at construction.\n address public immutable CUSTOM_GAS_TOKEN;\n\n // Custom gas token funder\n FunderInterface public immutable CUSTOM_GAS_TOKEN_FUNDER;\n\n // The maximum gas price a transaction sent to this adapter may have. This is set to prevent a block producer from setting an artificially high priority fee\n // when calling a hub pool message relay, which would otherwise cause a large amount of the custom gas token to be sent to L2.\n uint256 private immutable MAX_TX_GASPRICE;\n\n error ETHGasTokenNotAllowed();\n error TransactionFeeTooHigh();\n error InvalidBridgeConfig();\n\n /**\n * @notice Constructs new Adapter.\n * @notice Circle bridged & native USDC are optionally supported via configuration, but are mutually exclusive.\n * @param _chainId The target ZkStack network's chain ID.\n * @param _bridgeHub The bridge hub contract address for the ZkStack network.\n * @param _circleUSDC Circle USDC address on L1. If not set to address(0), then either the USDCSharedBridge\n * or CCTP token messenger must be set and will be used to bridge this token.\n * @param _usdcSharedBridge Address of the second bridge contract for USDC corresponding to the configured ZkStack network.\n * @param _cctpTokenMessenger address of the CCTP token messenger contract for the configured network.\n * @param _recipientCircleDomainId Circle domain ID for the destination network.\n * @param _l1Weth WETH address on L1.\n * @param _l2RefundAddress address that recieves excess gas refunds on L2.\n * @param _customGasTokenFunder Contract on L1 which funds bridge fees with amounts in the custom gas token.\n * @param _l2GasLimit The maximum amount of gas this contract is willing to pay to execute a transaction on L2.\n * @param _l1GasToL2GasPerPubDataLimit The exchange rate of l1 gas to l2 gas.\n * @param _maxTxGasprice The maximum effective gas price any transaction sent to this adapter may have.\n */\n constructor(\n uint256 _chainId,\n BridgeHubInterface _bridgeHub,\n IERC20 _circleUSDC,\n address _usdcSharedBridge,\n ITokenMessenger _cctpTokenMessenger,\n uint32 _recipientCircleDomainId,\n WETH9Interface _l1Weth,\n address _l2RefundAddress,\n FunderInterface _customGasTokenFunder,\n uint256 _l2GasLimit,\n uint256 _l1GasToL2GasPerPubDataLimit,\n uint256 _maxTxGasprice\n ) CircleCCTPAdapter(_circleUSDC, _cctpTokenMessenger, _recipientCircleDomainId) {\n CHAIN_ID = _chainId;\n BRIDGE_HUB = _bridgeHub;\n L1_WETH = _l1Weth;\n L2_REFUND_ADDRESS = _l2RefundAddress;\n CUSTOM_GAS_TOKEN_FUNDER = _customGasTokenFunder;\n L2_GAS_LIMIT = _l2GasLimit;\n MAX_TX_GASPRICE = _maxTxGasprice;\n L1_GAS_TO_L2_GAS_PER_PUB_DATA_LIMIT = _l1GasToL2GasPerPubDataLimit;\n address zero = address(0);\n if (address(_circleUSDC) != zero) {\n bool zkUSDCBridgeDisabled = _usdcSharedBridge == zero;\n bool cctpUSDCBridgeDisabled = address(_cctpTokenMessenger) == zero;\n // Bridged and Native USDC are mutually exclusive.\n if (zkUSDCBridgeDisabled == cctpUSDCBridgeDisabled) {\n revert InvalidBridgeConfig();\n }\n }\n USDC_SHARED_BRIDGE = _usdcSharedBridge;\n CUSTOM_GAS_TOKEN = BRIDGE_HUB.baseToken(CHAIN_ID);\n if (CUSTOM_GAS_TOKEN == ETH_TOKEN_ADDRESS) {\n revert ETHGasTokenNotAllowed();\n }\n }\n\n /**\n * @notice Send cross-chain message to target on ZkStack.\n * @dev The CUSTOM_GAS_TOKEN_FUNDER must hold enough of the gas token to pay for the L2 txn.\n * @param target Contract on L2 that will receive message.\n * @param message Data to send to target.\n */\n function relayMessage(address target, bytes memory message) external payable override {\n uint256 txBaseCost = _pullCustomGas(L2_GAS_LIMIT);\n IERC20(CUSTOM_GAS_TOKEN).forceApprove(BRIDGE_HUB.sharedBridge(), txBaseCost);\n\n BRIDGE_HUB.requestL2TransactionDirect(\n BridgeHubInterface.L2TransactionRequestDirect({\n chainId: CHAIN_ID,\n mintValue: txBaseCost,\n l2Contract: target,\n l2Value: 0,\n l2Calldata: message,\n l2GasLimit: L2_GAS_LIMIT,\n l2GasPerPubdataByteLimit: L1_GAS_TO_L2_GAS_PER_PUB_DATA_LIMIT,\n factoryDeps: new bytes[](0),\n refundRecipient: L2_REFUND_ADDRESS\n })\n );\n\n emit MessageRelayed(target, message);\n }\n\n /**\n * @notice Bridge tokens to ZkStack.\n * @dev The CUSTOM_GAS_TOKEN_FUNDER must hold enough of the gas token to pay for the L2 txn.\n * @param l1Token L1 token to deposit.\n * @param l2Token L2 token to receive.\n * @param amount Amount of L1 tokens to deposit and L2 tokens to receive.\n * @param to Bridge recipient.\n */\n function relayTokens(\n address l1Token,\n address l2Token, // l2Token is unused.\n uint256 amount,\n address to\n ) external payable override {\n // The Hub Pool will always bridge via CCTP to a ZkStack network if CCTP is enabled for that network. Therefore, we can short-circuit ZkStack-specific logic\n // like pulling custom gas or getting the shared bridge address if CCTP is enabled and we are bridging USDC.\n if (l1Token == address(usdcToken) && _isCCTPEnabled()) {\n _transferUsdc(to, amount);\n emit TokensRelayed(l1Token, l2Token, amount, to);\n return;\n }\n // A bypass proxy seems to no longer be needed to avoid deposit limits. The tracking of these limits seems to be deprecated.\n // See: https://github.com/matter-labs/era-contracts/blob/bce4b2d0f34bd87f1aaadd291772935afb1c3bd6/l1-contracts/contracts/bridge/L1ERC20Bridge.sol#L54-L55\n uint256 txBaseCost = _pullCustomGas(L2_GAS_LIMIT);\n address sharedBridge = BRIDGE_HUB.sharedBridge();\n\n bytes32 txHash;\n if (l1Token == address(L1_WETH)) {\n // If the l1Token is WETH then unwrap it to ETH then send the ETH to the standard bridge along with the base\n // cost of custom gas tokens.\n L1_WETH.withdraw(amount);\n IERC20(CUSTOM_GAS_TOKEN).forceApprove(sharedBridge, txBaseCost);\n // Note: When bridging ETH with `L2TransactionRequestTwoBridgesOuter`, the second bridge must be 0 for the shared bridge call to not revert.\n // https://github.com/matter-labs/era-contracts/blob/aafee035db892689df3f7afe4b89fd6467a39313/l1-contracts/contracts/bridge/L1SharedBridge.sol#L328\n txHash = BRIDGE_HUB.requestL2TransactionTwoBridges{ value: amount }(\n BridgeHubInterface.L2TransactionRequestTwoBridgesOuter({\n chainId: CHAIN_ID,\n mintValue: txBaseCost,\n l2Value: 0,\n l2GasLimit: L2_GAS_LIMIT,\n l2GasPerPubdataByteLimit: L1_GAS_TO_L2_GAS_PER_PUB_DATA_LIMIT,\n refundRecipient: L2_REFUND_ADDRESS,\n secondBridgeAddress: sharedBridge,\n secondBridgeValue: amount,\n secondBridgeCalldata: _secondBridgeCalldata(to, ETH_TOKEN_ADDRESS, 0)\n })\n );\n } else if (l1Token == CUSTOM_GAS_TOKEN) {\n // The chain's custom gas token.\n IERC20(l1Token).forceApprove(sharedBridge, txBaseCost + amount);\n txHash = BRIDGE_HUB.requestL2TransactionDirect(\n BridgeHubInterface.L2TransactionRequestDirect({\n chainId: CHAIN_ID,\n mintValue: txBaseCost + amount,\n l2Contract: to,\n l2Value: amount,\n l2Calldata: \"\",\n l2GasLimit: L2_GAS_LIMIT,\n l2GasPerPubdataByteLimit: L1_GAS_TO_L2_GAS_PER_PUB_DATA_LIMIT,\n factoryDeps: new bytes[](0),\n refundRecipient: L2_REFUND_ADDRESS\n })\n );\n } else if (l1Token == address(usdcToken)) {\n // Since we already checked if we are bridging USDC via CCTP, if this conditional is hit, then we must be bridging USDC via the `USDC_SHARED_BRIDGE`.\n IERC20(CUSTOM_GAS_TOKEN).forceApprove(sharedBridge, txBaseCost);\n IERC20(l1Token).forceApprove(USDC_SHARED_BRIDGE, amount);\n txHash = BRIDGE_HUB.requestL2TransactionTwoBridges(\n BridgeHubInterface.L2TransactionRequestTwoBridgesOuter({\n chainId: CHAIN_ID,\n mintValue: txBaseCost,\n l2Value: 0,\n l2GasLimit: L2_GAS_LIMIT,\n l2GasPerPubdataByteLimit: L1_GAS_TO_L2_GAS_PER_PUB_DATA_LIMIT,\n refundRecipient: L2_REFUND_ADDRESS,\n secondBridgeAddress: USDC_SHARED_BRIDGE,\n secondBridgeValue: 0,\n secondBridgeCalldata: _secondBridgeCalldata(to, l1Token, amount)\n })\n );\n } else {\n // An standard bridged ERC20, separate from WETH and Circle Bridged/Native USDC.\n IERC20(CUSTOM_GAS_TOKEN).forceApprove(sharedBridge, txBaseCost);\n IERC20(l1Token).forceApprove(sharedBridge, amount);\n txHash = BRIDGE_HUB.requestL2TransactionTwoBridges(\n BridgeHubInterface.L2TransactionRequestTwoBridgesOuter({\n chainId: CHAIN_ID,\n mintValue: txBaseCost,\n l2Value: 0,\n l2GasLimit: L2_GAS_LIMIT,\n l2GasPerPubdataByteLimit: L1_GAS_TO_L2_GAS_PER_PUB_DATA_LIMIT,\n refundRecipient: L2_REFUND_ADDRESS,\n secondBridgeAddress: sharedBridge,\n secondBridgeValue: 0,\n secondBridgeCalldata: _secondBridgeCalldata(to, l1Token, amount)\n })\n );\n }\n\n emit TokensRelayed(l1Token, l2Token, amount, to);\n }\n\n /**\n * @notice Computes the calldata for the \"second bridge\", which handles sending non native tokens.\n * @param l2Recipient recipient of the tokens.\n * @param l1Token the l1 address of the token. Note: ETH is encoded as address(1).\n * @param amount number of tokens to send.\n * @return abi encoded bytes.\n */\n function _secondBridgeCalldata(\n address l2Recipient,\n address l1Token,\n uint256 amount\n ) internal pure returns (bytes memory) {\n return abi.encode(l1Token, amount, l2Recipient);\n }\n\n /**\n * @notice For a given l2 gas limit, this computes the amount of tokens needed, pulls them from the funder, and\n * returns the amount.\n * @dev Should return a value in the same precision as the gas token's precision.\n * @param l2GasLimit L2 gas limit for the message.\n * @return amount of gas token that this contract needs to provide in order for the l2 transaction to succeed.\n */\n function _pullCustomGas(uint256 l2GasLimit) internal returns (uint256) {\n if (tx.gasprice > MAX_TX_GASPRICE) revert TransactionFeeTooHigh();\n uint256 cost = BRIDGE_HUB.l2TransactionBaseCost(\n CHAIN_ID,\n tx.gasprice,\n l2GasLimit,\n L1_GAS_TO_L2_GAS_PER_PUB_DATA_LIMIT\n );\n CUSTOM_GAS_TOKEN_FUNDER.withdraw(IERC20(CUSTOM_GAS_TOKEN), cost);\n\n return cost;\n }\n}\n"
- },
- "contracts/chain-adapters/Zora_Adapter.sol": {
- "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\n\nimport \"./interfaces/AdapterInterface.sol\";\nimport \"../external/interfaces/WETH9Interface.sol\";\n\n// @dev Use local modified CrossDomainEnabled contract instead of one exported by eth-optimism because we need\n// this contract's state variables to be `immutable` because of the delegateCall call.\nimport \"./CrossDomainEnabled.sol\";\nimport \"@eth-optimism/contracts/L1/messaging/IL1StandardBridge.sol\";\n\nimport \"@openzeppelin/contracts/token/ERC20/IERC20.sol\";\nimport \"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\";\n\nimport \"../libraries/CircleCCTPAdapter.sol\";\nimport \"../external/interfaces/CCTPInterfaces.sol\";\n\n/**\n * @notice Contract containing logic to send messages from L1 to Zora. This is a clone of the Base/Mode adapter\n * @dev Public functions calling external contracts do not guard against reentrancy because they are expected to be\n * called via delegatecall, which will execute this contract's logic within the context of the originating contract.\n * For example, the HubPool will delegatecall these functions, therefore its only necessary that the HubPool's methods\n * that call this contract's logic guard against reentrancy.\n * @custom:security-contact bugs@across.to\n */\n\n// solhint-disable-next-line contract-name-camelcase\ncontract Zora_Adapter is CrossDomainEnabled, AdapterInterface, CircleCCTPAdapter {\n using SafeERC20 for IERC20;\n uint32 public constant L2_GAS_LIMIT = 200_000;\n\n WETH9Interface public immutable L1_WETH;\n\n IL1StandardBridge public immutable L1_STANDARD_BRIDGE;\n\n /**\n * @notice Constructs new Adapter.\n * @param _l1Weth WETH address on L1.\n * @param _crossDomainMessenger XDomainMessenger Zora system contract.\n * @param _l1StandardBridge Standard bridge contract.\n * @param _l1Usdc USDC address on L1.\n */\n constructor(\n WETH9Interface _l1Weth,\n address _crossDomainMessenger,\n IL1StandardBridge _l1StandardBridge,\n IERC20 _l1Usdc\n )\n CrossDomainEnabled(_crossDomainMessenger)\n CircleCCTPAdapter(\n _l1Usdc,\n // Hardcode cctp messenger to 0x0 to disable CCTP bridging.\n ITokenMessenger(address(0)),\n CircleDomainIds.UNINITIALIZED\n )\n {\n L1_WETH = _l1Weth;\n L1_STANDARD_BRIDGE = _l1StandardBridge;\n }\n\n /**\n * @notice Send cross-chain message to target on Zora.\n * @param target Contract on Zora that will receive message.\n * @param message Data to send to target.\n */\n function relayMessage(address target, bytes calldata message) external payable override {\n sendCrossDomainMessage(target, L2_GAS_LIMIT, message);\n emit MessageRelayed(target, message);\n }\n\n /**\n * @notice Bridge tokens to Zora.\n * @param l1Token L1 token to deposit.\n * @param l2Token L2 token to receive.\n * @param amount Amount of L1 tokens to deposit and L2 tokens to receive.\n * @param to Bridge recipient.\n */\n function relayTokens(\n address l1Token,\n address l2Token,\n uint256 amount,\n address to\n ) external payable override {\n // If the l1Token is weth then unwrap it to ETH then send the ETH to the standard bridge.\n if (l1Token == address(L1_WETH)) {\n L1_WETH.withdraw(amount);\n L1_STANDARD_BRIDGE.depositETHTo{ value: amount }(to, L2_GAS_LIMIT, \"\");\n }\n // Check if this token is USDC, which requires a custom bridge via CCTP.\n else if (_isCCTPEnabled() && l1Token == address(usdcToken)) {\n _transferUsdc(to, amount);\n } else {\n IL1StandardBridge _l1StandardBridge = L1_STANDARD_BRIDGE;\n\n IERC20(l1Token).safeIncreaseAllowance(address(_l1StandardBridge), amount);\n _l1StandardBridge.depositERC20To(l1Token, l2Token, to, amount, L2_GAS_LIMIT, \"\");\n }\n emit TokensRelayed(l1Token, l2Token, amount, to);\n }\n}\n"
- },
- "contracts/erc7683/ERC7683.sol": {
- "content": "// SPDX-License-Identifier: GPL-3.0-or-later\npragma solidity ^0.8.0;\n\n/// @title GaslessCrossChainOrder CrossChainOrder type\n/// @notice Standard order struct to be signed by users, disseminated to fillers, and submitted to origin settler contracts\nstruct GaslessCrossChainOrder {\n /// @dev The contract address that the order is meant to be settled by.\n /// Fillers send this order to this contract address on the origin chain\n address originSettler;\n /// @dev The address of the user who is initiating the swap,\n /// whose input tokens will be taken and escrowed\n address user;\n /// @dev Nonce to be used as replay protection for the order\n uint256 nonce;\n /// @dev The chainId of the origin chain\n uint256 originChainId;\n /// @dev The timestamp by which the order must be opened\n uint32 openDeadline;\n /// @dev The timestamp by which the order must be filled on the destination chain\n uint32 fillDeadline;\n /// @dev Type identifier for the order data. This is an EIP-712 typehash.\n bytes32 orderDataType;\n /// @dev Arbitrary implementation-specific data\n /// Can be used to define tokens, amounts, destination chains, fees, settlement parameters,\n /// or any other order-type specific information\n bytes orderData;\n}\n\n/// @title OnchainCrossChainOrder CrossChainOrder type\n/// @notice Standard order struct for user-opened orders, where the user is the msg.sender.\nstruct OnchainCrossChainOrder {\n /// @dev The timestamp by which the order must be filled on the destination chain\n uint32 fillDeadline;\n /// @dev Type identifier for the order data. This is an EIP-712 typehash.\n bytes32 orderDataType;\n /// @dev Arbitrary implementation-specific data\n /// Can be used to define tokens, amounts, destination chains, fees, settlement parameters,\n /// or any other order-type specific information\n bytes orderData;\n}\n\n/// @title ResolvedCrossChainOrder type\n/// @notice An implementation-generic representation of an order intended for filler consumption\n/// @dev Defines all requirements for filling an order by unbundling the implementation-specific orderData.\n/// @dev Intended to improve integration generalization by allowing fillers to compute the exact input and output information of any order\nstruct ResolvedCrossChainOrder {\n /// @dev The address of the user who is initiating the transfer\n address user;\n /// @dev The chainId of the origin chain\n uint256 originChainId;\n /// @dev The timestamp by which the order must be opened\n uint32 openDeadline;\n /// @dev The timestamp by which the order must be filled on the destination chain(s)\n uint32 fillDeadline;\n /// @dev The unique identifier for this order within this settlement system\n bytes32 orderId;\n /// @dev The max outputs that the filler will send. It's possible the actual amount depends on the state of the destination\n /// chain (destination dutch auction, for instance), so these outputs should be considered a cap on filler liabilities.\n Output[] maxSpent;\n /// @dev The minimum outputs that must to be given to the filler as part of order settlement. Similar to maxSpent, it's possible\n /// that special order types may not be able to guarantee the exact amount at open time, so this should be considered\n /// a floor on filler receipts.\n Output[] minReceived;\n /// @dev Each instruction in this array is parameterizes a single leg of the fill. This provides the filler with the information\n /// necessary to perform the fill on the destination(s).\n FillInstruction[] fillInstructions;\n}\n\n/// @notice Tokens that must be receive for a valid order fulfillment\nstruct Output {\n /// @dev The address of the ERC20 token on the destination chain\n /// @dev address(0) used as a sentinel for the native token\n bytes32 token;\n /// @dev The amount of the token to be sent\n uint256 amount;\n /// @dev The address to receive the output tokens\n bytes32 recipient;\n /// @dev The destination chain for this output\n uint256 chainId;\n}\n\n/// @title FillInstruction type\n/// @notice Instructions to parameterize each leg of the fill\n/// @dev Provides all the origin-generated information required to produce a valid fill leg\nstruct FillInstruction {\n /// @dev The contract address that the order is meant to be settled by\n uint64 destinationChainId;\n /// @dev The contract address that the order is meant to be filled on\n bytes32 destinationSettler;\n /// @dev The data generated on the origin chain needed by the destinationSettler to process the fill\n bytes originData;\n}\n\n/// @title IOriginSettler\n/// @notice Standard interface for settlement contracts on the origin chain\ninterface IOriginSettler {\n /// @notice Signals that an order has been opened\n /// @param orderId a unique order identifier within this settlement system\n /// @param resolvedOrder resolved order that would be returned by resolve if called instead of Open\n event Open(bytes32 indexed orderId, ResolvedCrossChainOrder resolvedOrder);\n\n /// @notice Opens a gasless cross-chain order on behalf of a user.\n /// @dev To be called by the filler.\n /// @dev This method must emit the Open event\n /// @param order The GaslessCrossChainOrder definition\n /// @param signature The user's signature over the order\n /// @param originFillerData Any filler-defined data required by the settler\n function openFor(\n GaslessCrossChainOrder calldata order,\n bytes calldata signature,\n bytes calldata originFillerData\n ) external;\n\n /// @notice Opens a cross-chain order\n /// @dev To be called by the user\n /// @dev This method must emit the Open event\n /// @param order The OnchainCrossChainOrder definition\n function open(OnchainCrossChainOrder calldata order) external;\n\n /// @notice Resolves a specific GaslessCrossChainOrder into a generic ResolvedCrossChainOrder\n /// @dev Intended to improve standardized integration of various order types and settlement contracts\n /// @param order The GaslessCrossChainOrder definition\n /// @param originFillerData Any filler-defined data required by the settler\n /// @return ResolvedCrossChainOrder hydrated order data including the inputs and outputs of the order\n function resolveFor(GaslessCrossChainOrder calldata order, bytes calldata originFillerData)\n external\n view\n returns (ResolvedCrossChainOrder memory);\n\n /// @notice Resolves a specific OnchainCrossChainOrder into a generic ResolvedCrossChainOrder\n /// @dev Intended to improve standardized integration of various order types and settlement contracts\n /// @param order The OnchainCrossChainOrder definition\n /// @return ResolvedCrossChainOrder hydrated order data including the inputs and outputs of the order\n function resolve(OnchainCrossChainOrder calldata order) external view returns (ResolvedCrossChainOrder memory);\n}\n\n/// @title IDestinationSettler\n/// @notice Standard interface for settlement contracts on the destination chain\ninterface IDestinationSettler {\n /// @notice Fills a single leg of a particular order on the destination chain\n /// @param orderId Unique order identifier for this order\n /// @param originData Data emitted on the origin to parameterize the fill\n /// @param fillerData Data provided by the filler to inform the fill or express their preferences\n function fill(\n bytes32 orderId,\n bytes calldata originData,\n bytes calldata fillerData\n ) external;\n}\n"
- },
- "contracts/erc7683/ERC7683Permit2Lib.sol": {
- "content": "// SPDX-License-Identifier: UNLICENSED\npragma solidity ^0.8.0;\n\nimport \"../external/interfaces/IPermit2.sol\";\nimport { GaslessCrossChainOrder } from \"./ERC7683.sol\";\n\n// Data unique to every CrossChainOrder settled on Across\nstruct AcrossOrderData {\n address inputToken;\n uint256 inputAmount;\n address outputToken;\n uint256 outputAmount;\n uint256 destinationChainId;\n bytes32 recipient;\n address exclusiveRelayer;\n /// @notice User needs to be careful not to re-use a deposit nonce when depositing into Across otherwise the\n /// user risks their deposit being unfillable. See @across/contracts/SpokePool.sol#unsafeDeposit() for\n /// more details on this situation.\n uint256 depositNonce;\n uint32 exclusivityPeriod;\n bytes message;\n}\n\nstruct AcrossOriginFillerData {\n address exclusiveRelayer;\n}\n\nstruct AcrossDestinationFillerData {\n uint256 repaymentChainId;\n}\n\nbytes constant ACROSS_ORDER_DATA_TYPE = abi.encodePacked(\n \"AcrossOrderData(\",\n \"address inputToken,\",\n \"uint256 inputAmount,\",\n \"address outputToken,\",\n \"uint256 outputAmount,\",\n \"uint256 destinationChainId,\",\n \"bytes32 recipient,\",\n \"address exclusiveRelayer,\"\n \"uint256 depositNonce,\",\n \"uint32 exclusivityPeriod,\",\n \"bytes message)\"\n);\n\nbytes32 constant ACROSS_ORDER_DATA_TYPE_HASH = keccak256(ACROSS_ORDER_DATA_TYPE);\n\n/**\n * @notice ERC7683Permit2Lib knows how to process a particular type of external Permit2Order so that it can be used in Across.\n * @dev This library is responsible for definining the ERC712 type strings/hashes and performing hashes on the types.\n * @custom:security-contact bugs@across.to\n */\nlibrary ERC7683Permit2Lib {\n bytes internal constant GASLESS_CROSS_CHAIN_ORDER_TYPE =\n abi.encodePacked(\n \"GaslessCrossChainOrder(\",\n \"address originSettler,\",\n \"address user,\",\n \"uint256 nonce,\",\n \"uint256 originChainId,\",\n \"uint32 openDeadline,\",\n \"uint32 fillDeadline,\",\n \"bytes32 orderDataType,\",\n \"AcrossOrderData orderData)\"\n );\n\n bytes internal constant GASLESS_CROSS_CHAIN_ORDER_EIP712_TYPE =\n abi.encodePacked(GASLESS_CROSS_CHAIN_ORDER_TYPE, ACROSS_ORDER_DATA_TYPE);\n bytes32 internal constant GASLESS_CROSS_CHAIN_ORDER_TYPE_HASH = keccak256(GASLESS_CROSS_CHAIN_ORDER_EIP712_TYPE);\n\n string private constant TOKEN_PERMISSIONS_TYPE = \"TokenPermissions(address token,uint256 amount)\";\n string internal constant PERMIT2_ORDER_TYPE =\n string(\n abi.encodePacked(\n \"GaslessCrossChainOrder witness)\",\n ACROSS_ORDER_DATA_TYPE,\n GASLESS_CROSS_CHAIN_ORDER_TYPE,\n TOKEN_PERMISSIONS_TYPE\n )\n );\n\n // Hashes an order to get an order hash. Needed for permit2.\n function hashOrder(GaslessCrossChainOrder memory order, bytes32 orderDataHash) internal pure returns (bytes32) {\n return\n keccak256(\n abi.encode(\n GASLESS_CROSS_CHAIN_ORDER_TYPE_HASH,\n order.originSettler,\n order.user,\n order.nonce,\n order.originChainId,\n order.openDeadline,\n order.fillDeadline,\n order.orderDataType,\n orderDataHash\n )\n );\n }\n\n function hashOrderData(AcrossOrderData memory orderData) internal pure returns (bytes32) {\n return\n keccak256(\n abi.encode(\n ACROSS_ORDER_DATA_TYPE_HASH,\n orderData.inputToken,\n orderData.inputAmount,\n orderData.outputToken,\n orderData.outputAmount,\n orderData.destinationChainId,\n orderData.recipient,\n orderData.exclusiveRelayer,\n orderData.depositNonce,\n orderData.exclusivityPeriod,\n keccak256(orderData.message)\n )\n );\n }\n}\n"
- },
- "contracts/external/interfaces/CCTPInterfaces.sol": {
- "content": "/**\n * Copyright (C) 2015, 2016, 2017 Dapphub\n *\n * This program is free software: you can redistribute it and/or modify\n * it under the terms of the GNU General Public License as published by\n * the Free Software Foundation, either version 3 of the License, or\n * (at your option) any later version.\n *\n * This program is distributed in the hope that it will be useful,\n * but WITHOUT ANY WARRANTY; without even the implied warranty of\n * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the\n * GNU General Public License for more details.\n *\n * You should have received a copy of the GNU General Public License\n * along with this program. If not, see .\n */\n\n// SPDX-License-Identifier: GPL-3.0-or-later\npragma solidity ^0.8.0;\n\n/**\n * Imported as-is from commit 139d8d0ce3b5531d3c7ec284f89d946dfb720016 of:\n * * https://github.com/walkerq/evm-cctp-contracts/blob/139d8d0ce3b5531d3c7ec284f89d946dfb720016/src/TokenMessenger.sol\n * Changes applied post-import:\n * * Removed a majority of code from this contract and converted the needed function signatures in this interface.\n */\ninterface ITokenMessenger {\n /**\n * @notice Deposits and burns tokens from sender to be minted on destination domain.\n * Emits a `DepositForBurn` event.\n * @dev reverts if:\n * - given burnToken is not supported\n * - given destinationDomain has no TokenMessenger registered\n * - transferFrom() reverts. For example, if sender's burnToken balance or approved allowance\n * to this contract is less than `amount`.\n * - burn() reverts. For example, if `amount` is 0.\n * - MessageTransmitter returns false or reverts.\n * @param amount amount of tokens to burn\n * @param destinationDomain destination domain\n * @param mintRecipient address of mint recipient on destination domain\n * @param burnToken address of contract to burn deposited tokens, on local domain\n * @return _nonce unique nonce reserved by message\n */\n function depositForBurn(\n uint256 amount,\n uint32 destinationDomain,\n bytes32 mintRecipient,\n address burnToken\n ) external returns (uint64 _nonce);\n\n /**\n * @notice Minter responsible for minting and burning tokens on the local domain\n * @dev A TokenMessenger stores a TokenMinter contract which extends the TokenController contract.\n * https://github.com/circlefin/evm-cctp-contracts/blob/817397db0a12963accc08ff86065491577bbc0e5/src/TokenMessenger.sol#L110\n * @return minter Token Minter contract.\n */\n function localMinter() external view returns (ITokenMinter minter);\n}\n\n// Source: https://github.com/circlefin/evm-cctp-contracts/blob/63ab1f0ac06ce0793c0bbfbb8d09816bc211386d/src/v2/TokenMessengerV2.sol#L138C1-L166C15\ninterface ITokenMessengerV2 {\n /**\n * @notice Deposits and burns tokens from sender to be minted on destination domain.\n * Emits a `DepositForBurn` event.\n * @dev reverts if:\n * - given burnToken is not supported\n * - given destinationDomain has no TokenMessenger registered\n * - transferFrom() reverts. For example, if sender's burnToken balance or approved allowance\n * to this contract is less than `amount`.\n * - burn() reverts. For example, if `amount` is 0.\n * - maxFee is greater than or equal to `amount`.\n * - MessageTransmitterV2#sendMessage reverts.\n * @param amount amount of tokens to burn\n * @param destinationDomain destination domain to receive message on\n * @param mintRecipient address of mint recipient on destination domain\n * @param burnToken token to burn `amount` of, on local domain\n * @param destinationCaller authorized caller on the destination domain, as bytes32. If equal to bytes32(0),\n * any address can broadcast the message.\n * @param maxFee maximum fee to pay on the destination domain, specified in units of burnToken\n * @param minFinalityThreshold the minimum finality at which a burn message will be attested to.\n */\n function depositForBurn(\n uint256 amount,\n uint32 destinationDomain,\n bytes32 mintRecipient,\n address burnToken,\n bytes32 destinationCaller,\n uint256 maxFee,\n uint32 minFinalityThreshold\n ) external;\n}\n\n/**\n * A TokenMessenger stores a TokenMinter contract which extends the TokenController contract. The TokenController\n * contract has a burnLimitsPerMessage public mapping which can be queried to find the per-message burn limit\n * for a given token:\n * https://github.com/circlefin/evm-cctp-contracts/blob/817397db0a12963accc08ff86065491577bbc0e5/src/TokenMinter.sol#L33\n * https://github.com/circlefin/evm-cctp-contracts/blob/817397db0a12963accc08ff86065491577bbc0e5/src/roles/TokenController.sol#L69C40-L69C60\n *\n */\ninterface ITokenMinter {\n /**\n * @notice Supported burnable tokens on the local domain\n * local token (address) => maximum burn amounts per message\n * @param token address of token contract\n * @return burnLimit maximum burn amount per message for token\n */\n function burnLimitsPerMessage(address token) external view returns (uint256);\n}\n\n/**\n * IMessageTransmitter in CCTP inherits IRelayer and IReceiver, but here we only import sendMessage from IRelayer:\n * https://github.com/circlefin/evm-cctp-contracts/blob/377c9bd813fb86a42d900ae4003599d82aef635a/src/interfaces/IMessageTransmitter.sol#L25\n * https://github.com/circlefin/evm-cctp-contracts/blob/377c9bd813fb86a42d900ae4003599d82aef635a/src/interfaces/IRelayer.sol#L23-L35\n */\ninterface IMessageTransmitter {\n /**\n * @notice Sends an outgoing message from the source domain.\n * @dev Increment nonce, format the message, and emit `MessageSent` event with message information.\n * @param destinationDomain Domain of destination chain\n * @param recipient Address of message recipient on destination domain as bytes32\n * @param messageBody Raw bytes content of message\n * @return nonce reserved by message\n */\n function sendMessage(\n uint32 destinationDomain,\n bytes32 recipient,\n bytes calldata messageBody\n ) external returns (uint64);\n}\n"
- },
- "contracts/external/interfaces/IOpUSDCBridgeAdapter.sol": {
- "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\n/**\n * Imported from https://github.com/defi-wonderland/opUSDC\n * https://github.com/defi-wonderland/opUSDC/blob/ef22e5731f1655bf5249b2160452cce9aa06ff3f/src/interfaces/IOpUSDCBridgeAdapter.sol#L198C1-L204C84\n */\ninterface IOpUSDCBridgeAdapter {\n /**\n * @notice Send tokens to another chain through the linked adapter\n * @param _to The target address on the destination chain\n * @param _amount The amount of tokens to send\n * @param _minGasLimit Minimum gas limit that the message can be executed with\n */\n function sendMessage(\n address _to,\n uint256 _amount,\n uint32 _minGasLimit\n ) external;\n}\n"
- },
- "contracts/external/interfaces/IPermit2.sol": {
- "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\ninterface IPermit2 {\n struct TokenPermissions {\n address token;\n uint256 amount;\n }\n\n struct PermitTransferFrom {\n TokenPermissions permitted;\n uint256 nonce;\n uint256 deadline;\n }\n\n struct SignatureTransferDetails {\n address to;\n uint256 requestedAmount;\n }\n\n function permitWitnessTransferFrom(\n PermitTransferFrom memory permit,\n SignatureTransferDetails calldata transferDetails,\n address owner,\n bytes32 witness,\n string calldata witnessTypeString,\n bytes calldata signature\n ) external;\n\n function transferFrom(\n address from,\n address to,\n uint160 amount,\n address token\n ) external;\n}\n"
- },
- "contracts/external/interfaces/LineaInterfaces.sol": {
- "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\n\n/**\n * @notice Interface of Linea's Canonical Message Service\n * See https://github.com/Consensys/linea-contracts/blob/3cf85529fd4539eb06ba998030c37e47f98c528a/contracts/interfaces/IMessageService.sol\n */\ninterface IMessageService {\n /**\n * @notice Sends a message for transporting from the given chain.\n * @dev This function should be called with a msg.value = _value + _fee. The fee will be paid on the destination chain.\n * @param _to The destination address on the destination chain.\n * @param _fee The message service fee on the origin chain.\n * @param _calldata The calldata used by the destination message service to call the destination contract.\n */\n function sendMessage(\n address _to,\n uint256 _fee,\n bytes calldata _calldata\n ) external payable;\n\n /**\n * @notice Returns the original sender of the message on the origin layer.\n */\n function sender() external view returns (address);\n\n /**\n * @notice Minimum fee to use when sending a message. Currently, only exists on L2MessageService.\n * See https://github.com/Consensys/linea-contracts/blob/3cf85529fd4539eb06ba998030c37e47f98c528a/contracts/messageService/l2/L2MessageService.sol#L37\n */\n function minimumFeeInWei() external view returns (uint256);\n}\n\n/**\n * @notice Interface of Linea's Canonical Token Bridge\n * See https://github.com/Consensys/linea-contracts/blob/3cf85529fd4539eb06ba998030c37e47f98c528a/contracts/tokenBridge/interfaces/ITokenBridge.sol\n */\ninterface ITokenBridge {\n /**\n * @notice This function is the single entry point to bridge tokens to the\n * other chain, both for native and already bridged tokens. You can use it\n * to bridge any ERC20. If the token is bridged for the first time an ERC20\n * (BridgedToken.sol) will be automatically deployed on the target chain.\n * @dev User should first allow the bridge to transfer tokens on his behalf.\n * Alternatively, you can use `bridgeTokenWithPermit` to do so in a single\n * transaction. If you want the transfer to be automatically executed on the\n * destination chain. You should send enough ETH to pay the postman fees.\n * Note that Linea can reserve some tokens (which use a dedicated bridge).\n * In this case, the token cannot be bridged. Linea can only reserve tokens\n * that have not been bridged yet.\n * Linea can pause the bridge for security reason. In this case new bridge\n * transaction would revert.\n * @param _token The address of the token to be bridged.\n * @param _amount The amount of the token to be bridged.\n * @param _recipient The address that will receive the tokens on the other chain.\n */\n function bridgeToken(\n address _token,\n uint256 _amount,\n address _recipient\n ) external payable;\n}\n\ninterface IUSDCBridge {\n function usdc() external view returns (address);\n\n /**\n * @dev Sends the sender's USDC from L1 to the recipient on L2, locks the USDC sent\n * in this contract and sends a message to the message bridge\n * contract to mint the equivalent USDC on L2\n * @param amount The amount of USDC to send\n * @param to The recipient's address to receive the funds\n */\n function depositTo(uint256 amount, address to) external payable;\n}\n"
- },
- "contracts/external/interfaces/WETH9Interface.sol": {
- "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\n\n/**\n * @notice Interface for the WETH9 contract.\n */\ninterface WETH9Interface {\n /**\n * @notice Burn Wrapped Ether and receive native Ether.\n * @param wad Amount of WETH to unwrap and send to caller.\n */\n function withdraw(uint256 wad) external;\n\n /**\n * @notice Lock native Ether and mint Wrapped Ether ERC20\n * @dev msg.value is amount of Wrapped Ether to mint/Ether to lock.\n */\n function deposit() external payable;\n\n /**\n * @notice Get balance of WETH held by `guy`.\n * @param guy Address to get balance of.\n * @return wad Amount of WETH held by `guy`.\n */\n function balanceOf(address guy) external view returns (uint256 wad);\n\n /**\n * @notice Transfer `wad` of WETH from caller to `guy`.\n * @param guy Address to send WETH to.\n * @param wad Amount of WETH to send.\n * @return ok True if transfer succeeded.\n */\n function transfer(address guy, uint256 wad) external returns (bool);\n}\n"
- },
- "contracts/interfaces/ArbitrumBridge.sol": {
- "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\n\n/**\n * @title Staging ground for incoming and outgoing messages\n * @notice Unlike the standard Eth bridge, native token bridge escrows the custom ERC20 token which is\n * used as native currency on upper layer.\n * @dev Fees are paid in this token. There are certain restrictions on the native token:\n * - The token can't be rebasing or have a transfer fee\n * - The token must only be transferrable via a call to the token address itself\n * - The token must only be able to set allowance via a call to the token address itself\n * - The token must not have a callback on transfer, and more generally a user must not be able to make a transfer to themselves revert\n * - The token must have a max of 2^256 - 1 wei total supply unscaled\n * - The token must have a max of 2^256 - 1 wei total supply when scaled to 18 decimals\n */\ninterface ArbitrumERC20Bridge {\n /**\n * @notice Returns token that is escrowed in bridge on the lower layer and minted on the upper layer as native currency.\n * @dev This function doesn't exist on the generic Bridge interface.\n * @return address of the native token.\n */\n function nativeToken() external view returns (address);\n\n /**\n * @dev number of decimals used by the native token\n * This is set on bridge initialization using nativeToken.decimals()\n * If the token does not have decimals() method, we assume it have 0 decimals\n */\n function nativeTokenDecimals() external view returns (uint8);\n}\n\n/**\n * @title Inbox for user and contract originated messages\n * @notice Messages created via this inbox are enqueued in the delayed accumulator\n * to await inclusion in the SequencerInbox\n */\ninterface ArbitrumInboxLike {\n /**\n * @dev we only use this function to check the native token used by the bridge, so we hardcode the interface\n * to return an ArbitrumERC20Bridge instead of a more generic Bridge interface.\n * @return address of the bridge.\n */\n function bridge() external view returns (ArbitrumERC20Bridge);\n\n /**\n * @notice Put a message in the inbox that can be reexecuted for some fixed amount of time if it reverts\n * @dev Gas limit and maxFeePerGas should not be set to 1 as that is used to trigger the RetryableData error\n * @dev Caller must set msg.value equal to at least `maxSubmissionCost + maxGas * gasPriceBid`.\n * all msg.value will deposited to callValueRefundAddress on the upper layer\n * @dev More details can be found here: https://developer.arbitrum.io/arbos/l1-to-l2-messaging\n * @param to destination contract address\n * @param callValue call value for retryable message\n * @param maxSubmissionCost Max gas deducted from user's (upper layer) balance to cover base submission fee\n * @param excessFeeRefundAddress gasLimit x maxFeePerGas - execution cost gets credited here on (upper layer) balance\n * @param callValueRefundAddress callvalue gets credited here on upper layer if retryable txn times out or gets cancelled\n * @param gasLimit Max gas deducted from user's upper layer balance to cover upper layer execution. Should not be set to 1 (magic value used to trigger the RetryableData error)\n * @param maxFeePerGas price bid for upper layer execution. Should not be set to 1 (magic value used to trigger the RetryableData error)\n * @param data ABI encoded data of message\n * @return unique message number of the retryable transaction\n */\n function createRetryableTicket(\n address to,\n uint256 callValue,\n uint256 maxSubmissionCost,\n address excessFeeRefundAddress,\n address callValueRefundAddress,\n uint256 gasLimit,\n uint256 maxFeePerGas,\n bytes calldata data\n ) external payable returns (uint256);\n\n /**\n * @notice Put a message in the source chain inbox that can be reexecuted for some fixed amount of time if it reverts\n * @dev Same as createRetryableTicket, but does not guarantee that submission will succeed by requiring the needed\n * funds come from the deposit alone, rather than falling back on the user's balance\n * @dev Advanced usage only (does not rewrite aliases for excessFeeRefundAddress and callValueRefundAddress).\n * createRetryableTicket method is the recommended standard.\n * @dev Gas limit and maxFeePerGas should not be set to 1 as that is used to trigger the RetryableData error\n * @param to destination contract address\n * @param callValue call value for retryable message\n * @param maxSubmissionCost Max gas deducted from user's source chain balance to cover base submission fee\n * @param excessFeeRefundAddress gasLimit x maxFeePerGas - execution cost gets credited here on source chain balance\n * @param callValueRefundAddress callvalue gets credited here on source chain if retryable txn times out or gets cancelled\n * @param gasLimit Max gas deducted from user's balance to cover execution. Should not be set to 1 (magic value used to trigger the RetryableData error)\n * @param maxFeePerGas price bid for execution. Should not be set to 1 (magic value used to trigger the RetryableData error)\n * @param data ABI encoded data of the message\n * @return unique message number of the retryable transaction\n */\n function unsafeCreateRetryableTicket(\n address to,\n uint256 callValue,\n uint256 maxSubmissionCost,\n address excessFeeRefundAddress,\n address callValueRefundAddress,\n uint256 gasLimit,\n uint256 maxFeePerGas,\n bytes calldata data\n ) external payable returns (uint256);\n}\n\n/**\n * @notice Interface which extends ArbitrumInboxLike with functions used to interact with bridges that use a custom gas token.\n */\ninterface ArbitrumCustomGasTokenInbox is ArbitrumInboxLike {\n /**\n * @notice Put a message in the inbox that can be reexecuted for some fixed amount of time if it reverts\n * @notice Overloads the `createRetryableTicket` function but is not payable, and should only be called when paying\n * for message using a custom gas token.\n * @dev all tokenTotalFeeAmount will be deposited to callValueRefundAddress on upper layer\n * @dev Gas limit and maxFeePerGas should not be set to 1 as that is used to trigger the RetryableData error\n * @dev In case of native token having non-18 decimals: tokenTotalFeeAmount is denominated in native token's decimals. All other value params - callValue, maxSubmissionCost and maxFeePerGas are denominated in child chain's native 18 decimals.\n * @param to destination contract address\n * @param callValue call value for retryable message\n * @param maxSubmissionCost Max gas deducted from user's upper layer balance to cover base submission fee\n * @param excessFeeRefundAddress the address which receives the difference between execution fee paid and the actual execution cost. In case this address is a contract, funds will be received in its alias on upper layer.\n * @param callValueRefundAddress callvalue gets credited here on upper layer if retryable txn times out or gets cancelled. In case this address is a contract, funds will be received in its alias on upper layer.\n * @param gasLimit Max gas deducted from user's balance to cover execution. Should not be set to 1 (magic value used to trigger the RetryableData error)\n * @param maxFeePerGas price bid for execution. Should not be set to 1 (magic value used to trigger the RetryableData error)\n * @param tokenTotalFeeAmount amount of fees to be deposited in native token to cover for retryable ticket cost\n * @param data ABI encoded data of message\n * @return unique message number of the retryable transaction\n */\n function createRetryableTicket(\n address to,\n uint256 callValue,\n uint256 maxSubmissionCost,\n address excessFeeRefundAddress,\n address callValueRefundAddress,\n uint256 gasLimit,\n uint256 maxFeePerGas,\n uint256 tokenTotalFeeAmount,\n bytes calldata data\n ) external returns (uint256);\n}\n\n/**\n * @notice Generic gateway contract for bridging standard ERC20s to/from Arbitrum-like networks.\n * @notice These function signatures are shared between the L1 and L2 gateway router contracts.\n */\ninterface ArbitrumL1ERC20GatewayLike {\n /**\n * @notice Deprecated in favor of outboundTransferCustomRefund but still used in custom bridges\n * like the DAI bridge.\n * @dev Refunded to aliased address of sender if sender has code on source chain, otherwise to to sender's EOA on destination chain.\n * @param _sourceToken address of ERC20\n * @param _to Account to be credited with the tokens at the destination (can be the user's account or a contract),\n * not subject to aliasing. This account, or its alias if it has code in the source chain, will also be able to\n * cancel the retryable ticket and receive callvalue refund\n * @param _amount Token Amount\n * @param _maxGas Max gas deducted from user's balance to cover execution\n * @param _gasPriceBid Gas price for execution\n * @param _data encoded data from router and user\n * @return res abi encoded inbox sequence number\n */\n function outboundTransfer(\n address _sourceToken,\n address _to,\n uint256 _amount,\n uint256 _maxGas,\n uint256 _gasPriceBid,\n bytes calldata _data\n ) external payable returns (bytes memory);\n\n /**\n * @notice get ERC20 gateway for token.\n * @param _token ERC20 address.\n * @return address of ERC20 gateway.\n */\n function getGateway(address _token) external view returns (address);\n\n /**\n * @notice Deposit ERC20 token from Ethereum into Arbitrum-like networks.\n * @dev Upper layer address alias will not be applied to the following types of addresses on lower layer:\n * - an externally-owned account\n * - a contract in construction\n * - an address where a contract will be created\n * - an address where a contract lived, but was destroyed\n * @param _sourceToken address of ERC20 on source chain.\n * @param _refundTo Account, or its alias if it has code on the source chain, to be credited with excess gas refund at destination\n * @param _to Account to be credited with the tokens in the L3 (can be the user's L3 account or a contract),\n * not subject to aliasing. This account, or its alias if it has code on the source chain, will also be able to\n * cancel the retryable ticket and receive callvalue refund\n * @param _amount Token Amount\n * @param _maxGas Max gas deducted from user's balance to cover execution\n * @param _gasPriceBid Gas price for execution\n * @param _data encoded data from router and user\n * @return res abi encoded inbox sequence number\n */\n function outboundTransferCustomRefund(\n address _sourceToken,\n address _refundTo,\n address _to,\n uint256 _amount,\n uint256 _maxGas,\n uint256 _gasPriceBid,\n bytes calldata _data\n ) external payable returns (bytes memory);\n}\n\ninterface ArbitrumL2ERC20GatewayLike {\n /**\n * @notice Fetches the l2 token address from the gateway router for the input l1 token address\n * @param _l1Erc20 address of the l1 token.\n */\n function calculateL2TokenAddress(address _l1Erc20) external view returns (address);\n\n /**\n * @notice Withdraws a specified amount of an l2 token to an l1 token.\n * @param _l1Token address of the token to withdraw on L1.\n * @param _to address on L1 which will receive the tokens upon withdrawal.\n * @param _amount amount of the token to withdraw.\n * @param _data encoded data to send to the gateway router.\n */\n function outboundTransfer(\n address _l1Token,\n address _to,\n uint256 _amount,\n bytes calldata _data\n ) external payable returns (bytes memory);\n}\n"
- },
- "contracts/interfaces/HubPoolInterface.sol": {
- "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport \"@openzeppelin/contracts/token/ERC20/IERC20.sol\";\n\n/**\n * @notice Concise list of functions in HubPool implementation.\n */\ninterface HubPoolInterface {\n // This leaf is meant to be decoded in the HubPool to rebalance tokens between HubPool and SpokePool.\n struct PoolRebalanceLeaf {\n // This is used to know which chain to send cross-chain transactions to (and which SpokePool to send to).\n uint256 chainId;\n // Total LP fee amount per token in this bundle, encompassing all associated bundled relays.\n uint256[] bundleLpFees;\n // Represents the amount to push to or pull from the SpokePool. If +, the pool pays the SpokePool. If negative\n // the SpokePool pays the HubPool. There can be arbitrarily complex rebalancing rules defined offchain. This\n // number is only nonzero when the rules indicate that a rebalancing action should occur. When a rebalance does\n // occur, runningBalances must be set to zero for this token and netSendAmounts should be set to the previous\n // runningBalances + relays - deposits in this bundle. If non-zero then it must be set on the SpokePool's\n // RelayerRefundLeaf amountToReturn as -1 * this value to show if funds are being sent from or to the SpokePool.\n int256[] netSendAmounts;\n // This is only here to be emitted in an event to track a running unpaid balance between the L2 pool and the L1\n // pool. A positive number indicates that the HubPool owes the SpokePool funds. A negative number indicates that\n // the SpokePool owes the HubPool funds. See the comment above for the dynamics of this and netSendAmounts.\n int256[] runningBalances;\n // Used by data worker to mark which leaves should relay roots to SpokePools, and to otherwise organize leaves.\n // For example, each leaf should contain all the rebalance information for a single chain, but in the case where\n // the list of l1Tokens is very large such that they all can't fit into a single leaf that can be executed under\n // the block gas limit, then the data worker can use this groupIndex to organize them. Any leaves with\n // a groupIndex equal to 0 will relay roots to the SpokePool, so the data worker should ensure that only one\n // leaf for a specific chainId should have a groupIndex equal to 0.\n uint256 groupIndex;\n // Used as the index in the bitmap to track whether this leaf has been executed or not.\n uint8 leafId;\n // The bundleLpFees, netSendAmounts, and runningBalances are required to be the same length. They are parallel\n // arrays for the given chainId and should be ordered by the l1Tokens field. All whitelisted tokens with nonzero\n // relays on this chain in this bundle in the order of whitelisting.\n address[] l1Tokens;\n }\n\n // A data worker can optimistically store several merkle roots on this contract by staking a bond and calling\n // proposeRootBundle. By staking a bond, the data worker is alleging that the merkle roots all contain valid leaves\n // that can be executed later to:\n // - Send funds from this contract to a SpokePool or vice versa\n // - Send funds from a SpokePool to Relayer as a refund for a relayed deposit\n // - Send funds from a SpokePool to a deposit recipient to fulfill a \"slow\" relay\n // Anyone can dispute this struct if the merkle roots contain invalid leaves before the\n // challengePeriodEndTimestamp. Once the expiration timestamp is passed, executeRootBundle to execute a leaf\n // from the poolRebalanceRoot on this contract and it will simultaneously publish the relayerRefundRoot and\n // slowRelayRoot to a SpokePool. The latter two roots, once published to the SpokePool, contain\n // leaves that can be executed on the SpokePool to pay relayers or recipients.\n struct RootBundle {\n // Contains leaves instructing this contract to send funds to SpokePools.\n bytes32 poolRebalanceRoot;\n // Relayer refund merkle root to be published to a SpokePool.\n bytes32 relayerRefundRoot;\n // Slow relay merkle root to be published to a SpokePool.\n bytes32 slowRelayRoot;\n // This is a 1D bitmap, with max size of 256 elements, limiting us to 256 chainsIds.\n uint256 claimedBitMap;\n // Proposer of this root bundle.\n address proposer;\n // Number of pool rebalance leaves to execute in the poolRebalanceRoot. After this number\n // of leaves are executed, a new root bundle can be proposed\n uint8 unclaimedPoolRebalanceLeafCount;\n // When root bundle challenge period passes and this root bundle becomes executable.\n uint32 challengePeriodEndTimestamp;\n }\n\n // Each whitelisted L1 token has an associated pooledToken struct that contains all information used to track the\n // cumulative LP positions and if this token is enabled for deposits.\n struct PooledToken {\n // LP token given to LPs of a specific L1 token.\n address lpToken;\n // True if accepting new LP's.\n bool isEnabled;\n // Timestamp of last LP fee update.\n uint32 lastLpFeeUpdate;\n // Number of LP funds sent via pool rebalances to SpokePools and are expected to be sent\n // back later.\n int256 utilizedReserves;\n // Number of LP funds held in contract less utilized reserves.\n uint256 liquidReserves;\n // Number of LP funds reserved to pay out to LPs as fees.\n uint256 undistributedLpFees;\n }\n\n // Helper contracts to facilitate cross chain actions between HubPool and SpokePool for a specific network.\n struct CrossChainContract {\n address adapter;\n address spokePool;\n }\n\n function setPaused(bool pause) external;\n\n function emergencyDeleteProposal() external;\n\n function relaySpokePoolAdminFunction(uint256 chainId, bytes memory functionData) external;\n\n function setProtocolFeeCapture(address newProtocolFeeCaptureAddress, uint256 newProtocolFeeCapturePct) external;\n\n function setBond(IERC20 newBondToken, uint256 newBondAmount) external;\n\n function setLiveness(uint32 newLiveness) external;\n\n function setIdentifier(bytes32 newIdentifier) external;\n\n function setCrossChainContracts(\n uint256 l2ChainId,\n address adapter,\n address spokePool\n ) external;\n\n function enableL1TokenForLiquidityProvision(address l1Token) external;\n\n function disableL1TokenForLiquidityProvision(address l1Token) external;\n\n function addLiquidity(address l1Token, uint256 l1TokenAmount) external payable;\n\n function removeLiquidity(\n address l1Token,\n uint256 lpTokenAmount,\n bool sendEth\n ) external;\n\n function exchangeRateCurrent(address l1Token) external returns (uint256);\n\n function liquidityUtilizationCurrent(address l1Token) external returns (uint256);\n\n function liquidityUtilizationPostRelay(address l1Token, uint256 relayedAmount) external returns (uint256);\n\n function sync(address l1Token) external;\n\n function proposeRootBundle(\n uint256[] memory bundleEvaluationBlockNumbers,\n uint8 poolRebalanceLeafCount,\n bytes32 poolRebalanceRoot,\n bytes32 relayerRefundRoot,\n bytes32 slowRelayRoot\n ) external;\n\n function executeRootBundle(\n uint256 chainId,\n uint256 groupIndex,\n uint256[] memory bundleLpFees,\n int256[] memory netSendAmounts,\n int256[] memory runningBalances,\n uint8 leafId,\n address[] memory l1Tokens,\n bytes32[] memory proof\n ) external;\n\n function disputeRootBundle() external;\n\n function claimProtocolFeesCaptured(address l1Token) external;\n\n function setPoolRebalanceRoute(\n uint256 destinationChainId,\n address l1Token,\n address destinationToken\n ) external;\n\n function setDepositRoute(\n uint256 originChainId,\n uint256 destinationChainId,\n address originToken,\n bool depositsEnabled\n ) external;\n\n function poolRebalanceRoute(uint256 destinationChainId, address l1Token)\n external\n view\n returns (address destinationToken);\n\n function loadEthForL2Calls() external payable;\n}\n"
- },
- "contracts/interfaces/SpokePoolInterface.sol": {
- "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\n/**\n * @notice Contains common data structures and functions used by all SpokePool implementations.\n */\ninterface SpokePoolInterface {\n // This leaf is meant to be decoded in the SpokePool to pay out successful relayers.\n struct RelayerRefundLeaf {\n // This is the amount to return to the HubPool. This occurs when there is a PoolRebalanceLeaf netSendAmount that\n // is negative. This is just the negative of this value.\n uint256 amountToReturn;\n // Used to verify that this is being executed on the correct destination chainId.\n uint256 chainId;\n // This array designates how much each of those addresses should be refunded.\n uint256[] refundAmounts;\n // Used as the index in the bitmap to track whether this leaf has been executed or not.\n uint32 leafId;\n // The associated L2TokenAddress that these claims apply to.\n address l2TokenAddress;\n // Must be same length as refundAmounts and designates each address that must be refunded.\n address[] refundAddresses;\n }\n\n // Stores collection of merkle roots that can be published to this contract from the HubPool, which are referenced\n // by \"data workers\" via inclusion proofs to execute leaves in the roots.\n struct RootBundle {\n // Merkle root of slow relays that were not fully filled and whose recipient is still owed funds from the LP pool.\n bytes32 slowRelayRoot;\n // Merkle root of relayer refunds for successful relays.\n bytes32 relayerRefundRoot;\n // This is a 2D bitmap tracking which leaves in the relayer refund root have been claimed, with max size of\n // 256x(2^248) leaves per root.\n mapping(uint256 => uint256) claimedBitmap;\n }\n\n function setCrossDomainAdmin(address newCrossDomainAdmin) external;\n\n function setWithdrawalRecipient(address newWithdrawalRecipient) external;\n\n function pauseDeposits(bool pause) external;\n\n function pauseFills(bool pause) external;\n\n function relayRootBundle(bytes32 relayerRefundRoot, bytes32 slowRelayRoot) external;\n\n function emergencyDeleteRootBundle(uint256 rootBundleId) external;\n\n function depositDeprecated_5947912356(\n address recipient,\n address originToken,\n uint256 amount,\n uint256 destinationChainId,\n int64 relayerFeePct,\n uint32 quoteTimestamp,\n bytes memory message,\n uint256 maxCount\n ) external payable;\n\n function depositFor(\n address depositor,\n address recipient,\n address originToken,\n uint256 amount,\n uint256 destinationChainId,\n int64 relayerFeePct,\n uint32 quoteTimestamp,\n bytes memory message,\n uint256 maxCount\n ) external payable;\n\n function executeRelayerRefundLeaf(\n uint32 rootBundleId,\n SpokePoolInterface.RelayerRefundLeaf memory relayerRefundLeaf,\n bytes32[] memory proof\n ) external payable;\n\n function chainId() external view returns (uint256);\n\n error NotEOA();\n error InvalidDepositorSignature();\n error InvalidRelayerFeePct();\n error MaxTransferSizeExceeded();\n error InvalidCrossDomainAdmin();\n error InvalidWithdrawalRecipient();\n error DepositsArePaused();\n error FillsArePaused();\n}\n"
- },
- "contracts/interfaces/SpokePoolMessageHandler.sol": {
- "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\n// This interface is expected to be implemented by any contract that expects to receive messages from the SpokePool.\ninterface AcrossMessageHandler {\n function handleV3AcrossMessage(\n address tokenSent,\n uint256 amount,\n address relayer,\n bytes memory message\n ) external;\n}\n"
- },
- "contracts/interfaces/V3SpokePoolInterface.sol": {
- "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\n// Contains structs and functions used by SpokePool contracts to facilitate universal settlement.\ninterface V3SpokePoolInterface {\n /**************************************\n * ENUMS *\n **************************************/\n\n // Fill status tracks on-chain state of deposit, uniquely identified by relayHash.\n enum FillStatus {\n Unfilled,\n RequestedSlowFill,\n Filled\n }\n // Fill type is emitted in the FilledRelay event to assist Dataworker with determining which types of\n // fills to refund (e.g. only fast fills) and whether a fast fill created a sow fill excess.\n enum FillType {\n FastFill,\n // Fast fills are normal fills that do not replace a slow fill request.\n ReplacedSlowFill,\n // Replaced slow fills are fast fills that replace a slow fill request. This type is used by the Dataworker\n // to know when to send excess funds from the SpokePool to the HubPool because they can no longer be used\n // for a slow fill execution.\n SlowFill\n }\n // Slow fills are requested via requestSlowFill and executed by executeSlowRelayLeaf after a bundle containing\n // the slow fill is validated.\n\n /**************************************\n * STRUCTS *\n **************************************/\n\n // This struct represents the data to fully specify a **unique** relay submitted on this chain.\n // This data is hashed with the chainId() and saved by the SpokePool to prevent collisions and protect against\n // replay attacks on other chains. If any portion of this data differs, the relay is considered to be\n // completely distinct.\n struct V3RelayData {\n // The bytes32 that made the deposit on the origin chain.\n bytes32 depositor;\n // The recipient bytes32 on the destination chain.\n bytes32 recipient;\n // This is the exclusive relayer who can fill the deposit before the exclusivity deadline.\n bytes32 exclusiveRelayer;\n // Token that is deposited on origin chain by depositor.\n bytes32 inputToken;\n // Token that is received on destination chain by recipient.\n bytes32 outputToken;\n // The amount of input token deposited by depositor.\n uint256 inputAmount;\n // The amount of output token to be received by recipient.\n uint256 outputAmount;\n // Origin chain id.\n uint256 originChainId;\n // The id uniquely identifying this deposit on the origin chain.\n uint256 depositId;\n // The timestamp on the destination chain after which this deposit can no longer be filled.\n uint32 fillDeadline;\n // The timestamp on the destination chain after which any relayer can fill the deposit.\n uint32 exclusivityDeadline;\n // Data that is forwarded to the recipient.\n bytes message;\n }\n\n // Same as V3RelayData but using addresses instead of bytes32 & depositId is uint32.\n // Will be deprecated in favor of V3RelayData in the future.\n struct V3RelayDataLegacy {\n address depositor;\n address recipient;\n address exclusiveRelayer;\n address inputToken;\n address outputToken;\n uint256 inputAmount;\n uint256 outputAmount;\n uint256 originChainId;\n uint32 depositId;\n uint32 fillDeadline;\n uint32 exclusivityDeadline;\n bytes message;\n }\n\n // Contains parameters passed in by someone who wants to execute a slow relay leaf.\n struct V3SlowFill {\n V3RelayData relayData;\n uint256 chainId;\n uint256 updatedOutputAmount;\n }\n\n // Contains information about a relay to be sent along with additional information that is not unique to the\n // relay itself but is required to know how to process the relay. For example, \"updatedX\" fields can be used\n // by the relayer to modify fields of the relay with the depositor's permission, and \"repaymentChainId\" is specified\n // by the relayer to determine where to take a relayer refund, but doesn't affect the uniqueness of the relay.\n struct V3RelayExecutionParams {\n V3RelayData relay;\n bytes32 relayHash;\n uint256 updatedOutputAmount;\n bytes32 updatedRecipient;\n bytes updatedMessage;\n uint256 repaymentChainId;\n }\n\n // Packs together parameters emitted in FilledRelay because there are too many emitted otherwise.\n // Similar to V3RelayExecutionParams, these parameters are not used to uniquely identify the deposit being\n // filled so they don't have to be unpacked by all clients.\n struct V3RelayExecutionEventInfo {\n bytes32 updatedRecipient;\n bytes32 updatedMessageHash;\n uint256 updatedOutputAmount;\n FillType fillType;\n }\n\n // Represents the parameters required for a V3 deposit operation in the SpokePool.\n struct DepositV3Params {\n bytes32 depositor;\n bytes32 recipient;\n bytes32 inputToken;\n bytes32 outputToken;\n uint256 inputAmount;\n uint256 outputAmount;\n uint256 destinationChainId;\n bytes32 exclusiveRelayer;\n uint256 depositId;\n uint32 quoteTimestamp;\n uint32 fillDeadline;\n uint32 exclusivityParameter;\n bytes message;\n }\n\n /**************************************\n * EVENTS *\n **************************************/\n\n event FundsDeposited(\n bytes32 inputToken,\n bytes32 outputToken,\n uint256 inputAmount,\n uint256 outputAmount,\n uint256 indexed destinationChainId,\n uint256 indexed depositId,\n uint32 quoteTimestamp,\n uint32 fillDeadline,\n uint32 exclusivityDeadline,\n bytes32 indexed depositor,\n bytes32 recipient,\n bytes32 exclusiveRelayer,\n bytes message\n );\n\n event RequestedSpeedUpDeposit(\n uint256 updatedOutputAmount,\n uint256 indexed depositId,\n bytes32 indexed depositor,\n bytes32 updatedRecipient,\n bytes updatedMessage,\n bytes depositorSignature\n );\n\n event FilledRelay(\n bytes32 inputToken,\n bytes32 outputToken,\n uint256 inputAmount,\n uint256 outputAmount,\n uint256 repaymentChainId,\n uint256 indexed originChainId,\n uint256 indexed depositId,\n uint32 fillDeadline,\n uint32 exclusivityDeadline,\n bytes32 exclusiveRelayer,\n bytes32 indexed relayer,\n bytes32 depositor,\n bytes32 recipient,\n bytes32 messageHash,\n V3RelayExecutionEventInfo relayExecutionInfo\n );\n\n event RequestedSlowFill(\n bytes32 inputToken,\n bytes32 outputToken,\n uint256 inputAmount,\n uint256 outputAmount,\n uint256 indexed originChainId,\n uint256 indexed depositId,\n uint32 fillDeadline,\n uint32 exclusivityDeadline,\n bytes32 exclusiveRelayer,\n bytes32 depositor,\n bytes32 recipient,\n bytes32 messageHash\n );\n\n event ClaimedRelayerRefund(\n bytes32 indexed l2TokenAddress,\n bytes32 indexed refundAddress,\n uint256 amount,\n address indexed caller\n );\n\n /**************************************\n * FUNCTIONS *\n **************************************/\n\n function deposit(\n bytes32 depositor,\n bytes32 recipient,\n bytes32 inputToken,\n bytes32 outputToken,\n uint256 inputAmount,\n uint256 outputAmount,\n uint256 destinationChainId,\n bytes32 exclusiveRelayer,\n uint32 quoteTimestamp,\n uint32 fillDeadline,\n uint32 exclusivityDeadline,\n bytes calldata message\n ) external payable;\n\n function depositV3(\n address depositor,\n address recipient,\n address inputToken,\n address outputToken,\n uint256 inputAmount,\n uint256 outputAmount,\n uint256 destinationChainId,\n address exclusiveRelayer,\n uint32 quoteTimestamp,\n uint32 fillDeadline,\n uint32 exclusivityDeadline,\n bytes calldata message\n ) external payable;\n\n function depositNow(\n bytes32 depositor,\n bytes32 recipient,\n bytes32 inputToken,\n bytes32 outputToken,\n uint256 inputAmount,\n uint256 outputAmount,\n uint256 destinationChainId,\n bytes32 exclusiveRelayer,\n uint32 fillDeadlineOffset,\n uint32 exclusivityDeadline,\n bytes calldata message\n ) external payable;\n\n function depositV3Now(\n address depositor,\n address recipient,\n address inputToken,\n address outputToken,\n uint256 inputAmount,\n uint256 outputAmount,\n uint256 destinationChainId,\n address exclusiveRelayer,\n uint32 fillDeadlineOffset,\n uint32 exclusivityDeadline,\n bytes calldata message\n ) external payable;\n\n function unsafeDeposit(\n bytes32 depositor,\n bytes32 recipient,\n bytes32 inputToken,\n bytes32 outputToken,\n uint256 inputAmount,\n uint256 outputAmount,\n uint256 destinationChainId,\n bytes32 exclusiveRelayer,\n uint256 depositNonce,\n uint32 quoteTimestamp,\n uint32 fillDeadline,\n uint32 exclusivityParameter,\n bytes calldata message\n ) external payable;\n\n function speedUpDeposit(\n bytes32 depositor,\n uint256 depositId,\n uint256 updatedOutputAmount,\n bytes32 updatedRecipient,\n bytes calldata updatedMessage,\n bytes calldata depositorSignature\n ) external;\n\n function speedUpV3Deposit(\n address depositor,\n uint256 depositId,\n uint256 updatedOutputAmount,\n address updatedRecipient,\n bytes calldata updatedMessage,\n bytes calldata depositorSignature\n ) external;\n\n function fillRelay(\n V3RelayData calldata relayData,\n uint256 repaymentChainId,\n bytes32 repaymentAddress\n ) external;\n\n function fillV3Relay(V3RelayDataLegacy calldata relayData, uint256 repaymentChainId) external;\n\n function fillRelayWithUpdatedDeposit(\n V3RelayData calldata relayData,\n uint256 repaymentChainId,\n bytes32 repaymentAddress,\n uint256 updatedOutputAmount,\n bytes32 updatedRecipient,\n bytes calldata updatedMessage,\n bytes calldata depositorSignature\n ) external;\n\n function requestSlowFill(V3RelayData calldata relayData) external;\n\n function executeSlowRelayLeaf(\n V3SlowFill calldata slowFillLeaf,\n uint32 rootBundleId,\n bytes32[] calldata proof\n ) external;\n\n function claimRelayerRefund(bytes32 l2TokenAddress, bytes32 refundAddress) external;\n\n /**************************************\n * ERRORS *\n **************************************/\n\n error DisabledRoute();\n error InvalidQuoteTimestamp();\n error InvalidFillDeadline();\n error InvalidExclusiveRelayer();\n error MsgValueDoesNotMatchInputAmount();\n error NotExclusiveRelayer();\n error NoSlowFillsInExclusivityWindow();\n error RelayFilled();\n error InvalidSlowFillRequest();\n error ExpiredFillDeadline();\n error InvalidMerkleProof();\n error InvalidChainId();\n error InvalidMerkleLeaf();\n error ClaimedMerkleLeaf();\n error InvalidPayoutAdjustmentPct();\n error WrongERC7683OrderId();\n error LowLevelCallFailed(bytes data);\n error InsufficientSpokePoolBalanceToExecuteLeaf();\n error NoRelayerRefundToClaim();\n\n /**************************************\n * LEGACY EVENTS *\n **************************************/\n\n // Note: these events are unused, but included in the ABI for ease of migration.\n event V3FundsDeposited(\n address inputToken,\n address outputToken,\n uint256 inputAmount,\n uint256 outputAmount,\n uint256 indexed destinationChainId,\n uint32 indexed depositId,\n uint32 quoteTimestamp,\n uint32 fillDeadline,\n uint32 exclusivityDeadline,\n address indexed depositor,\n address recipient,\n address exclusiveRelayer,\n bytes message\n );\n\n event RequestedSpeedUpV3Deposit(\n uint256 updatedOutputAmount,\n uint32 indexed depositId,\n address indexed depositor,\n address updatedRecipient,\n bytes updatedMessage,\n bytes depositorSignature\n );\n\n // Legacy struct only used to preserve the FilledV3Relay event definition.\n struct LegacyV3RelayExecutionEventInfo {\n address updatedRecipient;\n bytes updatedMessage;\n uint256 updatedOutputAmount;\n FillType fillType;\n }\n\n event FilledV3Relay(\n address inputToken,\n address outputToken,\n uint256 inputAmount,\n uint256 outputAmount,\n uint256 repaymentChainId,\n uint256 indexed originChainId,\n uint32 indexed depositId,\n uint32 fillDeadline,\n uint32 exclusivityDeadline,\n address exclusiveRelayer,\n address indexed relayer,\n address depositor,\n address recipient,\n bytes message,\n LegacyV3RelayExecutionEventInfo relayExecutionInfo\n );\n\n event RequestedV3SlowFill(\n address inputToken,\n address outputToken,\n uint256 inputAmount,\n uint256 outputAmount,\n uint256 indexed originChainId,\n uint32 indexed depositId,\n uint32 fillDeadline,\n uint32 exclusivityDeadline,\n address exclusiveRelayer,\n address depositor,\n address recipient,\n bytes message\n );\n}\n"
- },
- "contracts/interfaces/ZkStackBridgeHub.sol": {
- "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\n\n/**\n * @title BridgeHubInterface\n * @notice This interface is shared between ZkStack adapters. It is the main interaction point for bridging to ZkStack chains.\n */\ninterface BridgeHubInterface {\n struct L2TransactionRequestDirect {\n uint256 chainId;\n uint256 mintValue;\n address l2Contract;\n uint256 l2Value;\n bytes l2Calldata;\n uint256 l2GasLimit;\n uint256 l2GasPerPubdataByteLimit;\n bytes[] factoryDeps;\n address refundRecipient;\n }\n\n /**\n * @notice the mailbox is called directly after the sharedBridge received the deposit.\n * This assumes that either ether is the base token or the msg.sender has approved mintValue allowance for the\n * sharedBridge. This means this is not ideal for contract calls, as the contract would have to handle token\n * allowance of the base Token.\n * @param _request the direct request.\n */\n function requestL2TransactionDirect(L2TransactionRequestDirect calldata _request)\n external\n payable\n returns (bytes32 canonicalTxHash);\n\n struct L2TransactionRequestTwoBridgesOuter {\n uint256 chainId;\n uint256 mintValue;\n uint256 l2Value;\n uint256 l2GasLimit;\n uint256 l2GasPerPubdataByteLimit;\n address refundRecipient;\n address secondBridgeAddress;\n uint256 secondBridgeValue;\n bytes secondBridgeCalldata;\n }\n\n /**\n * @notice After depositing funds to the sharedBridge, the secondBridge is called to return the actual L2 message\n * which is sent to the Mailbox. This assumes that either ether is the base token or the msg.sender has approved\n * the sharedBridge with the mintValue, and also the necessary approvals are given for the second bridge. The logic\n * of this bridge is to allow easy depositing for bridges. Each contract that handles the users ERC20 tokens needs\n * approvals from the user, this contract allows the user to approve for each token only its respective bridge.\n * This function is great for contract calls to L2, the secondBridge can be any contract.\n * @param _request the two bridges request.\n */\n function requestL2TransactionTwoBridges(L2TransactionRequestTwoBridgesOuter calldata _request)\n external\n payable\n returns (bytes32 canonicalTxHash);\n\n /**\n * @notice Gets the shared bridge.\n * @dev The shared bridge manages ERC20 tokens.\n */\n function sharedBridge() external view returns (address);\n\n /**\n * @notice Gets the base token for a chain.\n * @dev Base token == native token.\n */\n function baseToken(uint256 _chainId) external view returns (address);\n\n /**\n * @notice Computes the base transaction cost for a transaction.\n * @param _chainId the chain the transaction is being sent to.\n * @param _gasPrice the l1 gas price at time of execution.\n * @param _l2GasLimit the gas limit for the l2 transaction.\n * @param _l2GasPerPubdataByteLimit configuration value that changes infrequently.\n */\n function l2TransactionBaseCost(\n uint256 _chainId,\n uint256 _gasPrice,\n uint256 _l2GasLimit,\n uint256 _l2GasPerPubdataByteLimit\n ) external view returns (uint256);\n}\n"
- },
- "contracts/Lens_SpokePool.sol": {
- "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\n\nimport \"./ZkSync_SpokePool.sol\";\n\n/**\n * @notice Lens specific SpokePool. Wrapper around the ZkSync_SpokePool contract.\n * @dev Resources for compiling and deploying contracts with hardhat: https://era.zksync.io/docs/tools/hardhat/hardhat-zksync-solc.html\n * @custom:security-contact bugs@across.to\n */\ncontract Lens_SpokePool is ZkSync_SpokePool {\n /// @custom:oz-upgrades-unsafe-allow constructor\n constructor(\n address _wrappedNativeTokenAddress,\n IERC20 _circleUSDC,\n ZkBridgeLike _zkUSDCBridge,\n ITokenMessenger _cctpTokenMessenger,\n uint32 _depositQuoteTimeBuffer,\n uint32 _fillDeadlineBuffer\n )\n ZkSync_SpokePool(\n _wrappedNativeTokenAddress,\n _circleUSDC,\n _zkUSDCBridge,\n _cctpTokenMessenger,\n _depositQuoteTimeBuffer,\n _fillDeadlineBuffer\n )\n {}\n}\n"
- },
- "contracts/libraries/AddressConverters.sol": {
- "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\n\nlibrary Bytes32ToAddress {\n /**************************************\n * ERRORS *\n **************************************/\n error InvalidBytes32();\n\n function toAddress(bytes32 _bytes32) internal pure returns (address) {\n checkAddress(_bytes32);\n return address(uint160(uint256(_bytes32)));\n }\n\n function toAddressUnchecked(bytes32 _bytes32) internal pure returns (address) {\n return address(uint160(uint256(_bytes32)));\n }\n\n function checkAddress(bytes32 _bytes32) internal pure {\n if (uint256(_bytes32) >> 160 != 0) {\n revert InvalidBytes32();\n }\n }\n}\n\nlibrary AddressToBytes32 {\n function toBytes32(address _address) internal pure returns (bytes32) {\n return bytes32(uint256(uint160(_address)));\n }\n}\n"
- },
- "contracts/libraries/CircleCCTPAdapter.sol": {
- "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\n\nimport \"@openzeppelin/contracts/token/ERC20/IERC20.sol\";\nimport \"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\";\nimport \"../external/interfaces/CCTPInterfaces.sol\";\nimport { AddressToBytes32 } from \"../libraries/AddressConverters.sol\";\n\nlibrary CircleDomainIds {\n uint32 public constant Ethereum = 0;\n uint32 public constant Optimism = 2;\n uint32 public constant Arbitrum = 3;\n uint32 public constant Solana = 5;\n uint32 public constant Base = 6;\n uint32 public constant Polygon = 7;\n uint32 public constant DoctorWho = 10;\n uint32 public constant Linea = 11;\n uint32 public constant WorldChain = 14;\n uint32 public constant UNINITIALIZED = type(uint32).max;\n}\n\n/**\n * @notice Facilitate bridging USDC via Circle's CCTP.\n * @dev This contract is intended to be inherited by other chain-specific adapters and spoke pools.\n * @custom:security-contact bugs@across.to\n */\nabstract contract CircleCCTPAdapter {\n using SafeERC20 for IERC20;\n using AddressToBytes32 for address;\n /**\n * @notice The domain ID that CCTP will transfer funds to.\n * @dev This identifier is assigned by Circle and is not related to a chain ID.\n * @dev Official domain list can be found here: https://developers.circle.com/stablecoins/docs/supported-domains\n */\n /// @custom:oz-upgrades-unsafe-allow state-variable-immutable\n\n uint32 public immutable recipientCircleDomainId;\n\n /**\n * @notice The official USDC contract address on this chain.\n * @dev Posted officially here: https://developers.circle.com/stablecoins/docs/usdc-on-main-networks\n */\n /// @custom:oz-upgrades-unsafe-allow state-variable-immutable\n IERC20 public immutable usdcToken;\n\n /**\n * @notice The official Circle CCTP token bridge contract endpoint.\n * @dev Posted officially here: https://developers.circle.com/stablecoins/docs/evm-smart-contracts\n */\n /// @custom:oz-upgrades-unsafe-allow state-variable-immutable\n ITokenMessenger public immutable cctpTokenMessenger;\n\n /**\n * @notice Indicates if the CCTP V2 TokenMessenger is being used.\n * @dev This is determined by checking if the feeRecipient() function exists and returns a non-zero address.\n */\n /// @custom:oz-upgrades-unsafe-allow state-variable-immutable\n bool public immutable cctpV2;\n\n /**\n * @notice intiailizes the CircleCCTPAdapter contract.\n * @param _usdcToken USDC address on the current chain.\n * @param _cctpTokenMessenger TokenMessenger contract to bridge via CCTP. If the zero address is passed, CCTP bridging will be disabled.\n * @param _recipientCircleDomainId The domain ID that CCTP will transfer funds to.\n */\n /// @custom:oz-upgrades-unsafe-allow constructor\n constructor(\n IERC20 _usdcToken,\n /// @dev This should ideally be an address but it's kept as an ITokenMessenger to avoid rippling changes to the\n /// constructors for every SpokePool/Adapter.\n ITokenMessenger _cctpTokenMessenger,\n uint32 _recipientCircleDomainId\n ) {\n usdcToken = _usdcToken;\n cctpTokenMessenger = _cctpTokenMessenger;\n recipientCircleDomainId = _recipientCircleDomainId;\n\n // Only the CCTP V2 TokenMessenger has a feeRecipient() function, so we use it to\n // figure out if we are using CCTP V2 or V1. `success` can be true even if the contract doesn't\n // implement feeRecipient but it has a fallback function so to be extra safe, we check the return value\n // of feeRecipient() as well.\n (bool success, bytes memory feeRecipient) = address(cctpTokenMessenger).staticcall(\n abi.encodeWithSignature(\"feeRecipient()\")\n );\n // In case of a call to nonexistent contract or a call to a contract with a fallback function which\n // doesn't return any data, feeRecipient can be empty so check its length.\n // Even with this check, it's possible that the contract has implemented a fallback function that returns\n // 32 bytes of data but its not actually the feeRecipient address. This is extremely low risk but worth\n // mentioning that the following check is not 100% safe.\n cctpV2 = (success &&\n feeRecipient.length == 32 &&\n address(uint160(uint256(bytes32(feeRecipient)))) != address(0));\n }\n\n /**\n * @notice Returns whether or not the CCTP bridge is enabled.\n * @dev If the CCTPTokenMessenger is the zero address, CCTP bridging is disabled.\n */\n function _isCCTPEnabled() internal view returns (bool) {\n return address(cctpTokenMessenger) != address(0);\n }\n\n /**\n * @notice Transfers USDC from the current domain to the given address on the new domain.\n * @dev This function will revert if the CCTP bridge is disabled. I.e. if the zero address is passed to the constructor for the cctpTokenMessenger.\n * @param to Address to receive USDC on the new domain.\n * @param amount Amount of USDC to transfer.\n */\n function _transferUsdc(address to, uint256 amount) internal {\n _transferUsdc(to.toBytes32(), amount);\n }\n\n /**\n * @notice Transfers USDC from the current domain to the given address on the new domain.\n * @dev This function will revert if the CCTP bridge is disabled. I.e. if the zero address is passed to the constructor for the cctpTokenMessenger.\n * @param to Address to receive USDC on the new domain represented as bytes32.\n * @param amount Amount of USDC to transfer.\n */\n function _transferUsdc(bytes32 to, uint256 amount) internal {\n // Only approve the exact amount to be transferred\n usdcToken.safeIncreaseAllowance(address(cctpTokenMessenger), amount);\n // Submit the amount to be transferred to bridge via the TokenMessenger.\n // If the amount to send exceeds the burn limit per message, then split the message into smaller parts.\n // @dev We do not care about casting cctpTokenMessenger to ITokenMessengerV2 since both V1 and V2\n // expose a localMinter() view function that returns either an ITokenMinterV1 or ITokenMinterV2. Regardless,\n // we only care about the burnLimitsPerMessage function which is available in both versions and performs\n // the same logic, therefore we purposefully do not re-cast the cctpTokenMessenger and cctpMinter\n // to the specific version.\n ITokenMinter cctpMinter = cctpTokenMessenger.localMinter();\n uint256 burnLimit = cctpMinter.burnLimitsPerMessage(address(usdcToken));\n uint256 remainingAmount = amount;\n while (remainingAmount > 0) {\n uint256 partAmount = remainingAmount > burnLimit ? burnLimit : remainingAmount;\n if (cctpV2) {\n // Uses the CCTP V2 \"standard transfer\" speed and\n // therefore pays no additional fee for the transfer to be sped up.\n ITokenMessengerV2(address(cctpTokenMessenger)).depositForBurn(\n partAmount,\n recipientCircleDomainId,\n to,\n address(usdcToken),\n // The following parameters are new in this function from V2 to V1, can read more here:\n // https://developers.circle.com/stablecoins/evm-smart-contracts\n bytes32(0), // destinationCaller is set to bytes32(0) to indicate that anyone can call\n // receiveMessage on the destination to finalize the transfer\n 0, // maxFee can be set to 0 for a \"standard transfer\"\n 2000 // minFinalityThreshold can be set to 2000 for a \"standard transfer\",\n // https://github.com/circlefin/evm-cctp-contracts/blob/63ab1f0ac06ce0793c0bbfbb8d09816bc211386d/src/v2/FinalityThresholds.sol#L21\n );\n } else {\n cctpTokenMessenger.depositForBurn(partAmount, recipientCircleDomainId, to, address(usdcToken));\n }\n remainingAmount -= partAmount;\n }\n }\n}\n"
- },
- "contracts/libraries/CrossDomainAddressUtils.sol": {
- "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\n\n/**\n * @title AddressUtils\n * @notice This library contains internal functions for manipulating addresses.\n */\nlibrary CrossDomainAddressUtils {\n // L1 addresses are transformed during l1->l2 calls.\n // This cannot be pulled directly from Arbitrum contracts because their contracts are not 0.8.X compatible and\n // this operation takes advantage of overflows, whose behavior changed in 0.8.0.\n function applyL1ToL2Alias(address l1Address) internal pure returns (address l2Address) {\n unchecked {\n l2Address = address(uint160(l1Address) + uint160(0x1111000000000000000000000000000000001111));\n }\n }\n}\n"
- },
- "contracts/Lockable.sol": {
- "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\n\n/**\n * @title A contract that provides modifiers to prevent reentrancy to state-changing and view-only methods. This contract\n * is inspired by https://github.com/OpenZeppelin/openzeppelin-contracts/blob/master/contracts/utils/ReentrancyGuard.sol\n * and https://github.com/balancer-labs/balancer-core/blob/master/contracts/BPool.sol.\n * @dev The reason why we use this local contract instead of importing from uma/contracts is because of the addition\n * of the internal method `functionCallStackOriginatesFromOutsideThisContract` which doesn't exist in the one exported\n * by uma/contracts.\n * @custom:security-contact bugs@across.to\n */\ncontract Lockable {\n bool internal _notEntered;\n\n constructor() {\n // Storing an initial non-zero value makes deployment a bit more expensive, but in exchange the refund on every\n // call to nonReentrant will be lower in amount. Since refunds are capped to a percentage of the total\n // transaction's gas, it is best to keep them low in cases like this one, to increase the likelihood of the full\n // refund coming into effect.\n _notEntered = true;\n }\n\n /**\n * @dev Prevents a contract from calling itself, directly or indirectly.\n * Calling a nonReentrant function from another nonReentrant function is not supported. It is possible to\n * prevent this from happening by making the nonReentrant function external, and making it call a private\n * function that does the actual state modification.\n */\n modifier nonReentrant() {\n _preEntranceCheck();\n _preEntranceSet();\n _;\n _postEntranceReset();\n }\n\n /**\n * @dev Designed to prevent a view-only method from being re-entered during a call to a nonReentrant() state-changing method.\n */\n modifier nonReentrantView() {\n _preEntranceCheck();\n _;\n }\n\n /**\n * @dev Returns true if the contract is currently in a non-entered state, meaning that the origination of the call\n * came from outside the contract. This is relevant with fallback/receive methods to see if the call came from ETH\n * being dropped onto the contract externally or due to ETH dropped on the contract from within a method in this\n * contract, such as unwrapping WETH to ETH within the contract.\n */\n function functionCallStackOriginatesFromOutsideThisContract() internal view returns (bool) {\n return _notEntered;\n }\n\n // Internal methods are used to avoid copying the require statement's bytecode to every nonReentrant() method.\n // On entry into a function, _preEntranceCheck() should always be called to check if the function is being\n // re-entered. Then, if the function modifies state, it should call _postEntranceSet(), perform its logic, and\n // then call _postEntranceReset().\n // View-only methods can simply call _preEntranceCheck() to make sure that it is not being re-entered.\n function _preEntranceCheck() internal view {\n // On the first call to nonReentrant, _notEntered will be true\n require(_notEntered, \"ReentrancyGuard: reentrant call\");\n }\n\n function _preEntranceSet() internal {\n // Any calls to nonReentrant after this point will fail\n _notEntered = false;\n }\n\n function _postEntranceReset() internal {\n // By storing the original value once again, a refund is triggered (see\n // https://eips.ethereum.org/EIPS/eip-2200)\n _notEntered = true;\n }\n}\n"
- },
- "contracts/MerkleLib.sol": {
- "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\n\nimport \"./interfaces/SpokePoolInterface.sol\";\nimport \"./interfaces/V3SpokePoolInterface.sol\";\nimport \"./interfaces/HubPoolInterface.sol\";\n\nimport \"@openzeppelin/contracts/utils/cryptography/MerkleProof.sol\";\n\n/**\n * @notice Library to help with merkle roots, proofs, and claims.\n * @custom:security-contact bugs@across.to\n */\nlibrary MerkleLib {\n /**\n * @notice Verifies that a repayment is contained within a merkle root.\n * @param root the merkle root.\n * @param rebalance the rebalance struct.\n * @param proof the merkle proof.\n * @return bool to signal if the pool rebalance proof correctly shows inclusion of the rebalance within the tree.\n */\n function verifyPoolRebalance(\n bytes32 root,\n HubPoolInterface.PoolRebalanceLeaf memory rebalance,\n bytes32[] memory proof\n ) internal pure returns (bool) {\n return MerkleProof.verify(proof, root, keccak256(abi.encode(rebalance)));\n }\n\n /**\n * @notice Verifies that a relayer refund is contained within a merkle root.\n * @param root the merkle root.\n * @param refund the refund struct.\n * @param proof the merkle proof.\n * @return bool to signal if the relayer refund proof correctly shows inclusion of the refund within the tree.\n */\n function verifyRelayerRefund(\n bytes32 root,\n SpokePoolInterface.RelayerRefundLeaf memory refund,\n bytes32[] memory proof\n ) internal pure returns (bool) {\n return MerkleProof.verify(proof, root, keccak256(abi.encode(refund)));\n }\n\n function verifyV3SlowRelayFulfillment(\n bytes32 root,\n V3SpokePoolInterface.V3SlowFill memory slowRelayFulfillment,\n bytes32[] memory proof\n ) internal pure returns (bool) {\n return MerkleProof.verify(proof, root, keccak256(abi.encode(slowRelayFulfillment)));\n }\n\n // The following functions are primarily copied from\n // https://github.com/Uniswap/merkle-distributor/blob/master/contracts/MerkleDistributor.sol with minor changes.\n\n /**\n * @notice Tests whether a claim is contained within a claimedBitMap mapping.\n * @param claimedBitMap a simple uint256 mapping in storage used as a bitmap.\n * @param index the index to check in the bitmap.\n * @return bool indicating if the index within the claimedBitMap has been marked as claimed.\n */\n function isClaimed(mapping(uint256 => uint256) storage claimedBitMap, uint256 index) internal view returns (bool) {\n uint256 claimedWordIndex = index / 256;\n uint256 claimedBitIndex = index % 256;\n uint256 claimedWord = claimedBitMap[claimedWordIndex];\n uint256 mask = (1 << claimedBitIndex);\n return claimedWord & mask == mask;\n }\n\n /**\n * @notice Marks an index in a claimedBitMap as claimed.\n * @param claimedBitMap a simple uint256 mapping in storage used as a bitmap.\n * @param index the index to mark in the bitmap.\n */\n function setClaimed(mapping(uint256 => uint256) storage claimedBitMap, uint256 index) internal {\n uint256 claimedWordIndex = index / 256;\n uint256 claimedBitIndex = index % 256;\n claimedBitMap[claimedWordIndex] = claimedBitMap[claimedWordIndex] | (1 << claimedBitIndex);\n }\n\n /**\n * @notice Tests whether a claim is contained within a 1D claimedBitMap mapping.\n * @param claimedBitMap a simple uint256 value, encoding a 1D bitmap.\n * @param index the index to check in the bitmap. Uint8 type enforces that index can't be > 255.\n * @return bool indicating if the index within the claimedBitMap has been marked as claimed.\n */\n function isClaimed1D(uint256 claimedBitMap, uint8 index) internal pure returns (bool) {\n uint256 mask = (1 << index);\n return claimedBitMap & mask == mask;\n }\n\n /**\n * @notice Marks an index in a claimedBitMap as claimed.\n * @param claimedBitMap a simple uint256 mapping in storage used as a bitmap. Uint8 type enforces that index\n * can't be > 255.\n * @param index the index to mark in the bitmap.\n * @return uint256 representing the modified input claimedBitMap with the index set to true.\n */\n function setClaimed1D(uint256 claimedBitMap, uint8 index) internal pure returns (uint256) {\n return claimedBitMap | (1 << index);\n }\n}\n"
- },
- "contracts/Ovm_SpokePool.sol": {
- "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\n\nimport \"./SpokePool.sol\";\nimport \"./external/interfaces/WETH9Interface.sol\";\nimport \"./libraries/CircleCCTPAdapter.sol\";\n\nimport \"@openzeppelin/contracts-upgradeable/crosschain/optimism/LibOptimismUpgradeable.sol\";\nimport \"@eth-optimism/contracts/libraries/constants/Lib_PredeployAddresses.sol\";\n\n// https://github.com/ethereum-optimism/optimism/blob/bf51c4935261634120f31827c3910aa631f6bf9c/packages/contracts-bedrock/contracts/L2/L2StandardBridge.sol\ninterface IL2ERC20Bridge {\n function withdrawTo(\n address _l2Token,\n address _to,\n uint256 _amount,\n uint32 _minGasLimit,\n bytes calldata _extraData\n ) external payable;\n\n function bridgeERC20To(\n address _localToken,\n address _remoteToken,\n address _to,\n uint256 _amount,\n uint32 _minGasLimit,\n bytes calldata _extraData\n ) external;\n}\n\n/**\n * @notice OVM specific SpokePool. Uses OVM cross-domain-enabled logic to implement admin only access to functions. * Optimism, Base, and Boba each implement this spoke pool and set their chain specific contract addresses for l2Eth and l2Weth.\n * @custom:security-contact bugs@across.to\n */\ncontract Ovm_SpokePool is SpokePool, CircleCCTPAdapter {\n using SafeERC20 for IERC20;\n // \"l1Gas\" parameter used in call to bridge tokens from this contract back to L1 via IL2ERC20Bridge. Currently\n // unused by bridge but included for future compatibility.\n uint32 public l1Gas;\n\n // ETH is an ERC20 on OVM.\n address public l2Eth;\n\n // Address of the Optimism L2 messenger.\n address public constant MESSENGER = Lib_PredeployAddresses.L2_CROSS_DOMAIN_MESSENGER;\n // @dev This storage slot is reserved to replace the old messenger public variable that has now been\n // replaced by the above constant.\n address private __deprecated_messenger;\n\n // Stores alternative token bridges to use for L2 tokens that don't go over the standard bridge. This is needed\n // to support non-standard ERC20 tokens on Optimism, such as DAI which uses a custom bridge with the same\n // interface as the standard bridge.\n mapping(address => address) public tokenBridges;\n\n // Stores mapping of L2 tokens to L1 equivalent tokens. If a mapping is defined for a given L2 token, then\n // the mapped L1 token can be used in _bridgeTokensToHubPool which can then call bridgeERC20To, which\n // requires specfiying an L1 token.\n mapping(address => address) public remoteL1Tokens;\n\n event SetL1Gas(uint32 indexed newL1Gas);\n event SetL2TokenBridge(address indexed l2Token, address indexed tokenBridge);\n event SetRemoteL1Token(address indexed l2Token, address indexed l1Token);\n\n error NotCrossDomainAdmin();\n\n /// @custom:oz-upgrades-unsafe-allow constructor\n constructor(\n address _wrappedNativeTokenAddress,\n uint32 _depositQuoteTimeBuffer,\n uint32 _fillDeadlineBuffer,\n IERC20 _l2Usdc,\n ITokenMessenger _cctpTokenMessenger\n )\n SpokePool(_wrappedNativeTokenAddress, _depositQuoteTimeBuffer, _fillDeadlineBuffer)\n CircleCCTPAdapter(_l2Usdc, _cctpTokenMessenger, CircleDomainIds.Ethereum)\n {} // solhint-disable-line no-empty-blocks\n\n /**\n * @notice Construct the OVM SpokePool.\n * @param _initialDepositId Starting deposit ID. Set to 0 unless this is a re-deployment in order to mitigate\n * relay hash collisions.\n * @param _crossDomainAdmin Cross domain admin to set. Can be changed by admin.\n * @param _withdrawalRecipient Address which receives token withdrawals. Can be changed by admin. For Spoke Pools on L2, this will\n * likely be the hub pool.\n * @param _l2Eth Address of L2 ETH token. Usually should be Lib_PreeployAddresses.OVM_ETH but sometimes this can\n * be different, like with Boba which flips the WETH and OVM_ETH addresses.\n */\n function __OvmSpokePool_init(\n uint32 _initialDepositId,\n address _crossDomainAdmin,\n address _withdrawalRecipient,\n address _l2Eth\n ) public onlyInitializing {\n l1Gas = 5_000_000;\n __SpokePool_init(_initialDepositId, _crossDomainAdmin, _withdrawalRecipient);\n //slither-disable-next-line missing-zero-check\n l2Eth = _l2Eth;\n }\n\n /*******************************************\n * OPTIMISM-SPECIFIC ADMIN FUNCTIONS *\n *******************************************/\n\n /**\n * @notice Change L1 gas limit. Callable only by admin.\n * @param newl1Gas New L1 gas limit to set.\n */\n function setL1GasLimit(uint32 newl1Gas) public onlyAdmin nonReentrant {\n l1Gas = newl1Gas;\n emit SetL1Gas(newl1Gas);\n }\n\n function setRemoteL1Token(address l2Token, address l1Token) public onlyAdmin nonReentrant {\n remoteL1Tokens[l2Token] = l1Token;\n emit SetRemoteL1Token(l2Token, l1Token);\n }\n\n /**\n * @notice Set bridge contract for L2 token used to withdraw back to L1.\n * @dev If this mapping isn't set for an L2 token, then the standard bridge will be used to bridge this token.\n * @param tokenBridge Address of token bridge\n */\n function setTokenBridge(address l2Token, address tokenBridge) public onlyAdmin nonReentrant {\n tokenBridges[l2Token] = tokenBridge;\n emit SetL2TokenBridge(l2Token, tokenBridge);\n }\n\n /**************************************\n * INTERNAL FUNCTIONS *\n **************************************/\n\n /**\n * @notice Wraps any ETH into WETH before executing leaves. This is necessary because SpokePool receives\n * ETH over the canonical token bridge instead of WETH.\n */\n function _preExecuteLeafHook(address l2TokenAddress) internal override {\n if (l2TokenAddress == address(wrappedNativeToken)) _depositEthToWeth();\n }\n\n // Wrap any ETH owned by this contract so we can send expected L2 token to recipient. This is necessary because\n // this SpokePool will receive ETH from the canonical token bridge instead of WETH. Its not sufficient to execute\n // this logic inside a fallback method that executes when this contract receives ETH because ETH is an ERC20\n // on the OVM.\n function _depositEthToWeth() internal {\n //slither-disable-next-line arbitrary-send-eth\n if (address(this).balance > 0) wrappedNativeToken.deposit{ value: address(this).balance }();\n }\n\n function _bridgeTokensToHubPool(uint256 amountToReturn, address l2TokenAddress) internal virtual override {\n // If the token being bridged is WETH then we need to first unwrap it to ETH and then send ETH over the\n // canonical bridge. On Optimism, this is address 0xDeadDeAddeAddEAddeadDEaDDEAdDeaDDeAD0000.\n if (l2TokenAddress == address(wrappedNativeToken)) {\n WETH9Interface(l2TokenAddress).withdraw(amountToReturn); // Unwrap into ETH.\n l2TokenAddress = l2Eth; // Set the l2TokenAddress to ETH.\n IL2ERC20Bridge(Lib_PredeployAddresses.L2_STANDARD_BRIDGE).withdrawTo{ value: amountToReturn }(\n l2TokenAddress, // _l2Token. Address of the L2 token to bridge over.\n withdrawalRecipient, // _to. Withdraw, over the bridge, to the l1 pool contract.\n amountToReturn, // _amount.\n l1Gas, // _l1Gas. Unused, but included for potential forward compatibility considerations\n \"\" // _data. We don't need to send any data for the bridging action.\n );\n }\n // If the token is USDC && CCTP bridge is enabled, then bridge USDC via CCTP.\n else if (_isCCTPEnabled() && l2TokenAddress == address(usdcToken)) {\n _transferUsdc(withdrawalRecipient, amountToReturn);\n }\n // Note we'll default to withdrawTo instead of bridgeERC20To unless the remoteL1Tokens mapping is set for\n // the l2TokenAddress. withdrawTo should be used to bridge back non-native L2 tokens\n // (i.e. non-native L2 tokens have a canonical L1 token). If we should bridge \"native L2\" tokens then\n // we'd need to call bridgeERC20To and give allowance to the tokenBridge to spend l2Token from this contract.\n // Therefore for native tokens we should set ensure that remoteL1Tokens is set for the l2TokenAddress.\n else {\n IL2ERC20Bridge tokenBridge = IL2ERC20Bridge(\n tokenBridges[l2TokenAddress] == address(0)\n ? Lib_PredeployAddresses.L2_STANDARD_BRIDGE\n : tokenBridges[l2TokenAddress]\n );\n if (remoteL1Tokens[l2TokenAddress] != address(0)) {\n // If there is a mapping for this L2 token to an L1 token, then use the L1 token address and\n // call bridgeERC20To.\n IERC20(l2TokenAddress).safeIncreaseAllowance(address(tokenBridge), amountToReturn);\n address remoteL1Token = remoteL1Tokens[l2TokenAddress];\n tokenBridge.bridgeERC20To(\n l2TokenAddress, // _l2Token. Address of the L2 token to bridge over.\n remoteL1Token, // Remote token to be received on L1 side. If the\n // remoteL1Token on the other chain does not recognize the local token as the correct\n // pair token, the ERC20 bridge will fail and the tokens will be returned to sender on\n // this chain.\n withdrawalRecipient, // _to\n amountToReturn, // _amount\n l1Gas, // _l1Gas\n \"\" // _data\n );\n } else {\n tokenBridge.withdrawTo(\n l2TokenAddress, // _l2Token. Address of the L2 token to bridge over.\n withdrawalRecipient, // _to. Withdraw, over the bridge, to the l1 pool contract.\n amountToReturn, // _amount.\n l1Gas, // _l1Gas. Unused, but included for potential forward compatibility considerations\n \"\" // _data. We don't need to send any data for the bridging action.\n );\n }\n }\n }\n\n // Apply OVM-specific transformation to cross domain admin address on L1.\n function _requireAdminSender() internal view override {\n if (LibOptimismUpgradeable.crossChainSender(MESSENGER) != crossDomainAdmin) revert NotCrossDomainAdmin();\n }\n\n // Reserve storage slots for future versions of this base contract to add state variables without\n // affecting the storage layout of child contracts. Decrement the size of __gap whenever state variables\n // are added. This is at bottom of contract to make sure its always at the end of storage.\n uint256[999] private __gap;\n}\n"
- },
- "contracts/Polygon_SpokePool.sol": {
- "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\n\nimport \"./SpokePool.sol\";\nimport \"./PolygonTokenBridger.sol\";\nimport \"./external/interfaces/WETH9Interface.sol\";\nimport \"./interfaces/SpokePoolInterface.sol\";\nimport \"./libraries/CircleCCTPAdapter.sol\";\n\n/**\n * @notice IFxMessageProcessor represents interface to process messages.\n */\ninterface IFxMessageProcessor {\n /**\n * @notice Called by FxChild upon receiving L1 message that targets this contract. Performs an additional check\n * that the L1 caller was the expected cross domain admin, and then delegate calls.\n * @notice Polygon bridge only executes this external function on the target Polygon contract when relaying\n * messages from L1, so all functions on this SpokePool are expected to originate via this call.\n * @dev stateId value isn't used because it isn't relevant for this method. It doesn't care what state sync\n * triggered this call.\n * @param rootMessageSender Original L1 sender of data.\n * @param data ABI encoded function call to execute on this contract.\n */\n function processMessageFromRoot(\n uint256 stateId,\n address rootMessageSender,\n bytes calldata data\n ) external;\n}\n\n/**\n * @notice Polygon specific SpokePool.\n * @custom:security-contact bugs@across.to\n */\ncontract Polygon_SpokePool is IFxMessageProcessor, SpokePool, CircleCCTPAdapter {\n using SafeERC20Upgradeable for PolygonIERC20Upgradeable;\n\n // Address of FxChild which sends and receives messages to and from L1.\n address public fxChild;\n\n // Contract deployed on L1 and L2 processes all cross-chain transfers between this contract and the HubPool.\n // Required because bridging tokens from Polygon to Ethereum has special constraints.\n PolygonTokenBridger public polygonTokenBridger;\n\n // Internal variable that only flips temporarily to true upon receiving messages from L1. Used to authenticate that\n // the caller is the fxChild AND that the fxChild called processMessageFromRoot\n bool private callValidated;\n\n error MulticallExecuteLeaf();\n\n event SetFxChild(address indexed newFxChild);\n event SetPolygonTokenBridger(address indexed polygonTokenBridger);\n event ReceivedMessageFromL1(address indexed caller, address indexed rootMessageSender);\n\n error CallValidatedAlreadySet();\n error CallValidatedNotSet();\n error DelegateCallFailed();\n error NotHubPool();\n error NotFxChild();\n\n // Note: validating calls this way ensures that strange calls coming from the fxChild won't be misinterpreted.\n // Put differently, just checking that msg.sender == fxChild is not sufficient.\n // All calls that have admin privileges must be fired from within the processMessageFromRoot method that's gone\n // through validation where the sender is checked and the root (mainnet) sender is also validated.\n // This modifier sets the callValidated variable so this condition can be checked in _requireAdminSender().\n modifier validateInternalCalls() {\n // Make sure callValidated is set to True only once at beginning of processMessageFromRoot, which prevents\n // processMessageFromRoot from being re-entered.\n if (callValidated) revert CallValidatedAlreadySet();\n\n // This sets a variable indicating that we're now inside a validated call.\n // Note: this is used by other methods to ensure that this call has been validated by this method and is not\n // spoofed. See comment for `_requireAdminSender` for more details.\n callValidated = true;\n\n _;\n\n // Reset callValidated to false to disallow admin calls after this method exits.\n callValidated = false;\n }\n\n /// @custom:oz-upgrades-unsafe-allow constructor\n constructor(\n address _wrappedNativeTokenAddress,\n uint32 _depositQuoteTimeBuffer,\n uint32 _fillDeadlineBuffer,\n IERC20 _l2Usdc,\n ITokenMessenger _cctpTokenMessenger\n )\n SpokePool(_wrappedNativeTokenAddress, _depositQuoteTimeBuffer, _fillDeadlineBuffer)\n CircleCCTPAdapter(_l2Usdc, _cctpTokenMessenger, CircleDomainIds.Ethereum)\n {} // solhint-disable-line no-empty-blocks\n\n /**\n * @notice Construct the Polygon SpokePool.\n * @param _initialDepositId Starting deposit ID. Set to 0 unless this is a re-deployment in order to mitigate\n * relay hash collisions.\n * @param _polygonTokenBridger Token routing contract that sends tokens from here to HubPool. Changeable by Admin.\n * @param _crossDomainAdmin Cross domain admin to set. Can be changed by admin.\n * @param _withdrawalRecipient Address which receives token withdrawals. Can be changed by admin. For Spoke Pools on L2, this will\n * likely be the hub pool.\n * @param _fxChild FxChild contract, changeable by Admin.\n */\n function initialize(\n uint32 _initialDepositId,\n PolygonTokenBridger _polygonTokenBridger,\n address _crossDomainAdmin,\n address _withdrawalRecipient,\n address _fxChild\n ) public initializer {\n callValidated = false;\n __SpokePool_init(_initialDepositId, _crossDomainAdmin, _withdrawalRecipient);\n _setPolygonTokenBridger(payable(_polygonTokenBridger));\n //slither-disable-next-line missing-zero-check\n _setFxChild(_fxChild);\n }\n\n /********************************************************\n * POLYGON-SPECIFIC CROSS-CHAIN ADMIN FUNCTIONS *\n ********************************************************/\n\n /**\n * @notice Change FxChild address. Callable only by admin via processMessageFromRoot.\n * @param newFxChild New FxChild.\n */\n function setFxChild(address newFxChild) public onlyAdmin nonReentrant {\n _setFxChild(newFxChild);\n }\n\n /**\n * @notice Change polygonTokenBridger address. Callable only by admin via processMessageFromRoot.\n * @param newPolygonTokenBridger New Polygon Token Bridger contract.\n */\n function setPolygonTokenBridger(address payable newPolygonTokenBridger) public onlyAdmin nonReentrant {\n _setPolygonTokenBridger(newPolygonTokenBridger);\n }\n\n /**\n * @notice Called by FxChild upon receiving L1 message that targets this contract. Performs an additional check\n * that the L1 caller was the expected cross domain admin, and then delegate calls.\n * @notice Polygon bridge only executes this external function on the target Polygon contract when relaying\n * messages from L1, so all functions on this SpokePool are expected to originate via this call.\n * @dev stateId value isn't used because it isn't relevant for this method. It doesn't care what state sync\n * triggered this call.\n * @param rootMessageSender Original L1 sender of data.\n * @param data ABI encoded function call to execute on this contract.\n */\n function processMessageFromRoot(\n uint256, /*stateId*/\n address rootMessageSender,\n bytes calldata data\n ) public validateInternalCalls {\n // Validation logic.\n if (msg.sender != fxChild) revert NotFxChild();\n if (rootMessageSender != crossDomainAdmin) revert NotHubPool();\n\n // This uses delegatecall to take the information in the message and process it as a function call on this contract.\n /// This is a safe delegatecall because its made to address(this) so there is no risk of delegating to a\n /// selfdestruct().\n //slither-disable-start low-level-calls\n /// @custom:oz-upgrades-unsafe-allow delegatecall\n (bool success, ) = address(this).delegatecall(data);\n //slither-disable-end low-level-calls\n if (!success) revert DelegateCallFailed();\n\n emit ReceivedMessageFromL1(msg.sender, rootMessageSender);\n }\n\n /**\n * @notice Allows the caller to trigger the wrapping of any unwrapped matic tokens.\n * @dev Unlike other ERC20 transfers, Matic transfers from L1 -> L2 bridging don't result in an L2 call into\n * the contract receiving the tokens, so wrapping must be done via a separate transaction. In other words,\n * we can't rely upon a `fallback()` method being triggered to wrap MATIC upon receiving it.\n */\n function wrap() public nonReentrant {\n _wrap();\n }\n\n /**\n * @notice Override multicall so that it cannot include executeRelayerRefundLeaf\n * as one of the calls combined with other public function calls and blocks nested multicalls in general, which\n * don't have any practical use case. We also block nested multicalls which could be used to bypass\n * this check and there are no practical use cases for nested multicalls.\n * @dev Multicalling a single transaction will always succeed.\n * @dev Multicalling execute functions without combining other public function calls will succeed.\n * @dev Nested multicalls will always fail.\n * @dev Multicalling public function calls without combining execute functions will succeed.\n */\n function _validateMulticallData(bytes[] calldata data) internal pure override {\n bool hasOtherPublicFunctionCall = false;\n bool hasExecutedLeafCall = false;\n for (uint256 i = 0; i < data.length; i++) {\n bytes4 selector = bytes4(data[i][:4]);\n if (selector == MultiCallerUpgradeable.multicall.selector) {\n revert MulticallExecuteLeaf();\n } else if (selector == SpokePoolInterface.executeRelayerRefundLeaf.selector) {\n if (hasOtherPublicFunctionCall) revert MulticallExecuteLeaf();\n hasExecutedLeafCall = true;\n } else {\n if (hasExecutedLeafCall) revert MulticallExecuteLeaf();\n hasOtherPublicFunctionCall = true;\n }\n }\n }\n\n /**\n * @notice This function can send an L2 to L1 message so we are extra cautious about preventing a griefing vector\n * whereby someone batches this call with a bunch of other calls and produces a very large L2 burn transaction.\n * This might make the L2 -> L1 message fail due to exceeding the L1 calldata limit.\n */\n\n function executeRelayerRefundLeaf(\n uint32 rootBundleId,\n SpokePoolInterface.RelayerRefundLeaf memory relayerRefundLeaf,\n bytes32[] memory proof\n ) public payable override {\n // AddressLibUpgradeable.isContract isn't a sufficient check because it checks the contract code size of\n // msg.sender which is 0 if called from a constructor function on msg.sender. This is why we check if\n // msg.sender is equal to tx.origin which is fine as long as Polygon supports the tx.origin opcode. We also\n // check if the msg.sender has delegated their code to a contract via EIP7702.\n // solhint-disable-next-line avoid-tx-origin\n if (relayerRefundLeaf.amountToReturn > 0 && (msg.sender != tx.origin || msg.sender.code.length > 0))\n revert NotEOA();\n super.executeRelayerRefundLeaf(rootBundleId, relayerRefundLeaf, proof);\n }\n\n /**************************************\n * INTERNAL FUNCTIONS *\n **************************************/\n\n function _setFxChild(address _fxChild) internal {\n //slither-disable-next-line missing-zero-check\n fxChild = _fxChild;\n emit SetFxChild(_fxChild);\n }\n\n function _setPolygonTokenBridger(address payable _polygonTokenBridger) internal {\n polygonTokenBridger = PolygonTokenBridger(_polygonTokenBridger);\n emit SetPolygonTokenBridger(address(_polygonTokenBridger));\n }\n\n function _preExecuteLeafHook(address) internal override {\n // Wraps MATIC --> WMATIC before distributing tokens from this contract.\n _wrap();\n }\n\n function _bridgeTokensToHubPool(uint256 amountToReturn, address l2TokenAddress) internal override {\n // WARNING: Withdrawing MATIC can result in the L1 PolygonTokenBridger.startExitWithBurntTokens() failing\n // due to a MAX_LOGS constraint imposed by the ERC20Predicate, so if this SpokePool will be used to withdraw\n // MATIC then additional constraints need to be imposed to limit the # of logs produed by the L2 withdrawal\n // transaction. Currently, MATIC is not a supported token in Across for this SpokePool.\n\n // If the token is USDC, we need to use the CCTP bridge to transfer it to the hub pool.\n if (_isCCTPEnabled() && l2TokenAddress == address(usdcToken)) {\n _transferUsdc(withdrawalRecipient, amountToReturn);\n } else {\n PolygonIERC20Upgradeable(l2TokenAddress).safeIncreaseAllowance(\n address(polygonTokenBridger),\n amountToReturn\n );\n // Note: WrappedNativeToken is WMATIC on matic, so this tells the tokenbridger that this is an unwrappable native token.\n polygonTokenBridger.send(PolygonIERC20Upgradeable(l2TokenAddress), amountToReturn);\n }\n }\n\n function _wrap() internal {\n uint256 balance = address(this).balance;\n //slither-disable-next-line arbitrary-send-eth\n if (balance > 0) wrappedNativeToken.deposit{ value: balance }();\n }\n\n // @dev: This contract will trigger admin functions internally via the `processMessageFromRoot`, which is why\n // the `callValidated` check is made below and why we use the `validateInternalCalls` modifier on\n // `processMessageFromRoot`. This prevents calling the admin functions from any other method besides\n // `processMessageFromRoot`.\n function _requireAdminSender() internal view override {\n if (!callValidated) revert CallValidatedNotSet();\n }\n}\n"
- },
- "contracts/PolygonTokenBridger.sol": {
- "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\n\nimport \"./Lockable.sol\";\nimport \"./external/interfaces/WETH9Interface.sol\";\n\nimport \"@openzeppelin/contracts-upgradeable/token/ERC20/IERC20Upgradeable.sol\";\nimport \"@openzeppelin/contracts-upgradeable/token/ERC20/utils/SafeERC20Upgradeable.sol\";\n\n// Polygon Registry contract that stores their addresses.\ninterface PolygonRegistry {\n function erc20Predicate() external returns (address);\n}\n\n// Polygon ERC20Predicate contract that handles Plasma exits (only used for Matic).\ninterface PolygonERC20Predicate {\n function startExitWithBurntTokens(bytes calldata data) external;\n}\n\n// ERC20s (on polygon) compatible with polygon's bridge have a withdraw method.\ninterface PolygonIERC20Upgradeable is IERC20Upgradeable {\n function withdraw(uint256 amount) external;\n}\n\ninterface MaticToken {\n function withdraw(uint256 amount) external payable;\n}\n\n/**\n * @notice Contract deployed on Ethereum and Polygon to facilitate token transfers from Polygon to the HubPool and back.\n * @dev Because Polygon only allows withdrawals from a particular address to go to that same address on mainnet, we need to\n * have some sort of contract that can guarantee identical addresses on Polygon and Ethereum. This contract is intended\n * to be completely immutable, so it's guaranteed that the contract on each side is configured identically as long as\n * it is created via create2. create2 is an alternative creation method that uses a different address determination\n * mechanism from normal create.\n * Normal create: address = hash(deployer_address, deployer_nonce)\n * create2: address = hash(0xFF, sender, salt, bytecode)\n * This ultimately allows create2 to generate deterministic addresses that don't depend on the transaction count of the\n * sender.\n * @custom:security-contact bugs@across.to\n */\ncontract PolygonTokenBridger is Lockable {\n using SafeERC20Upgradeable for PolygonIERC20Upgradeable;\n using SafeERC20Upgradeable for IERC20Upgradeable;\n\n // Gas token for Polygon.\n MaticToken public constant MATIC = MaticToken(0x0000000000000000000000000000000000001010);\n\n // Should be set to HubPool on Ethereum, or unused on Polygon.\n address public immutable destination;\n\n // Registry that stores L1 polygon addresses.\n PolygonRegistry public immutable l1PolygonRegistry;\n\n // WETH contract on Ethereum.\n WETH9Interface public immutable l1Weth;\n\n // Wrapped Matic on Polygon\n address public immutable l2WrappedMatic;\n\n // Chain id for the L1 that this contract is deployed on or communicates with.\n // For example: if this contract were meant to facilitate transfers from polygon to mainnet, this value would be\n // the mainnet chainId 1.\n uint256 public immutable l1ChainId;\n\n // Chain id for the L2 that this contract is deployed on or communicates with.\n // For example: if this contract were meant to facilitate transfers from polygon to mainnet, this value would be\n // the polygon chainId 137.\n uint256 public immutable l2ChainId;\n\n modifier onlyChainId(uint256 chainId) {\n _requireChainId(chainId);\n _;\n }\n\n /**\n * @notice Constructs Token Bridger contract.\n * @param _destination Where to send tokens to for this network.\n * @param _l1PolygonRegistry L1 registry that stores updated addresses of polygon contracts. This should always be\n * set to the L1 registry regardless if whether it's deployed on L2 or L1.\n * @param _l1Weth L1 WETH address.\n * @param _l2WrappedMatic L2 address of wrapped matic token.\n * @param _l1ChainId the chain id for the L1 in this environment.\n * @param _l2ChainId the chain id for the L2 in this environment.\n */\n constructor(\n address _destination,\n PolygonRegistry _l1PolygonRegistry,\n WETH9Interface _l1Weth,\n address _l2WrappedMatic,\n uint256 _l1ChainId,\n uint256 _l2ChainId\n ) {\n //slither-disable-next-line missing-zero-check\n destination = _destination;\n l1PolygonRegistry = _l1PolygonRegistry;\n l1Weth = _l1Weth;\n //slither-disable-next-line missing-zero-check\n l2WrappedMatic = _l2WrappedMatic;\n l1ChainId = _l1ChainId;\n l2ChainId = _l2ChainId;\n }\n\n /**\n * @notice Called by Polygon SpokePool to send tokens over bridge to contract with the same address as this.\n * @notice The caller of this function must approve this contract to spend amount of token.\n * @param token Token to bridge.\n * @param amount Amount to bridge.\n */\n function send(PolygonIERC20Upgradeable token, uint256 amount) public nonReentrant onlyChainId(l2ChainId) {\n token.safeTransferFrom(msg.sender, address(this), amount);\n\n // In the wMatic case, this unwraps. For other ERC20s, this is the burn/send action.\n token.withdraw(token.balanceOf(address(this)));\n\n // This takes the token that was withdrawn and calls withdraw on the \"native\" ERC20.\n if (address(token) == l2WrappedMatic) MATIC.withdraw{ value: address(this).balance }(address(this).balance);\n }\n\n /**\n * @notice Called by someone to send tokens to the destination, which should be set to the HubPool.\n * @param token Token to send to destination.\n */\n function retrieve(IERC20Upgradeable token) public nonReentrant onlyChainId(l1ChainId) {\n if (address(token) == address(l1Weth)) {\n // For WETH, there is a pre-deposit step to ensure any ETH that has been sent to the contract is captured.\n //slither-disable-next-line arbitrary-send-eth\n l1Weth.deposit{ value: address(this).balance }();\n }\n token.safeTransfer(destination, token.balanceOf(address(this)));\n }\n\n /**\n * @notice Called to initiate an l1 exit (withdrawal) of matic tokens that have been sent over the plasma bridge.\n * @param data the proof data to trigger the exit. Can be generated using the maticjs-plasma package.\n */\n function callExit(bytes memory data) public nonReentrant onlyChainId(l1ChainId) {\n PolygonERC20Predicate erc20Predicate = PolygonERC20Predicate(l1PolygonRegistry.erc20Predicate());\n erc20Predicate.startExitWithBurntTokens(data);\n }\n\n receive() external payable {\n // This method is empty to avoid any gas expendatures that might cause transfers to fail.\n // Note: the fact that there is _no_ code in this function means that matic can be erroneously transferred in\n // to the contract on the polygon side. These tokens would be locked indefinitely since the receive function\n // cannot be called on the polygon side. While this does have some downsides, the lack of any functionality\n // in this function means that it has no chance of running out of gas on transfers, which is a much more\n // important benefit. This just makes the matic token risk similar to that of ERC20s that are erroneously\n // sent to the contract.\n }\n\n function _requireChainId(uint256 chainId) internal view {\n require(block.chainid == chainId, \"Cannot run method on this chain\");\n }\n}\n"
- },
- "contracts/SpokePool.sol": {
- "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\n\nimport \"./MerkleLib.sol\";\nimport \"./erc7683/ERC7683.sol\";\nimport \"./erc7683/ERC7683Permit2Lib.sol\";\nimport \"./external/interfaces/WETH9Interface.sol\";\nimport \"./interfaces/SpokePoolMessageHandler.sol\";\nimport \"./interfaces/SpokePoolInterface.sol\";\nimport \"./interfaces/V3SpokePoolInterface.sol\";\nimport \"./upgradeable/MultiCallerUpgradeable.sol\";\nimport \"./upgradeable/EIP712CrossChainUpgradeable.sol\";\nimport \"./upgradeable/AddressLibUpgradeable.sol\";\nimport \"./libraries/AddressConverters.sol\";\n\nimport \"@openzeppelin/contracts-upgradeable/token/ERC20/IERC20Upgradeable.sol\";\nimport \"@openzeppelin/contracts-upgradeable/token/ERC20/utils/SafeERC20Upgradeable.sol\";\nimport \"@openzeppelin/contracts/utils/cryptography/SignatureChecker.sol\";\nimport \"@openzeppelin/contracts-upgradeable/proxy/utils/UUPSUpgradeable.sol\";\nimport \"@openzeppelin/contracts-upgradeable/security/ReentrancyGuardUpgradeable.sol\";\nimport \"@openzeppelin/contracts/utils/math/SignedMath.sol\";\n\n/**\n * @title SpokePool\n * @notice Base contract deployed on source and destination chains enabling depositors to transfer assets from source to\n * destination. Deposit orders are fulfilled by off-chain relayers who also interact with this contract. Deposited\n * tokens are locked on the source chain and relayers send the recipient the desired token currency and amount\n * on the destination chain. Locked source chain tokens are later sent over the canonical token bridge to L1 HubPool.\n * Relayers are refunded with destination tokens out of this contract after another off-chain actor, a \"data worker\",\n * submits a proof that the relayer correctly submitted a relay on this SpokePool.\n * @custom:security-contact bugs@across.to\n */\nabstract contract SpokePool is\n V3SpokePoolInterface,\n SpokePoolInterface,\n UUPSUpgradeable,\n ReentrancyGuardUpgradeable,\n MultiCallerUpgradeable,\n EIP712CrossChainUpgradeable,\n IDestinationSettler\n{\n using SafeERC20Upgradeable for IERC20Upgradeable;\n using AddressLibUpgradeable for address;\n using Bytes32ToAddress for bytes32;\n using AddressToBytes32 for address;\n\n // Address of the L1 contract that acts as the owner of this SpokePool. This should normally be set to the HubPool\n // address. The crossDomainAdmin address is unused when the SpokePool is deployed to the same chain as the HubPool.\n address public crossDomainAdmin;\n\n // Address of the L1 contract that will send tokens to and receive tokens from this contract to fund relayer\n // refunds and slow relays.\n address public withdrawalRecipient;\n\n // Note: The following two storage variables prefixed with DEPRECATED used to be variables that could be set by\n // the cross-domain admin. Admins ended up not changing these in production, so to reduce\n // gas in deposit/fill functions, we are converting them to private variables to maintain the contract\n // storage layout and replacing them with immutable or constant variables, because retrieving a constant\n // value is cheaper than retrieving a storage variable. Please see out the immutable/constant variable section.\n WETH9Interface private DEPRECATED_wrappedNativeToken;\n uint32 private DEPRECATED_depositQuoteTimeBuffer;\n\n // `numberOfDeposits` acts as a counter to generate unique deposit identifiers for this spoke pool.\n // It is a uint32 that increments with each `depositV3` call. In the `FundsDeposited` event, it is\n // implicitly cast to uint256 by setting its most significant bits to 0, reducing the risk of ID collisions\n // with unsafe deposits. However, this variable's name could be improved (e.g., `depositNonceCounter`)\n // since it does not accurately reflect the total number of deposits, as `unsafeDeposit` can bypass this increment.\n uint32 public numberOfDeposits;\n\n // Whether deposits and fills are disabled.\n bool public pausedFills;\n bool public pausedDeposits;\n\n // This contract can store as many root bundles as the HubPool chooses to publish here.\n RootBundle[] public rootBundles;\n\n // Origin token to destination token routings can be turned on or off, which can enable or disable deposits.\n mapping(address => mapping(uint256 => bool)) private DEPRECATED_enabledDepositRoutes;\n\n // Each relay is associated with the hash of parameters that uniquely identify the original deposit and a relay\n // attempt for that deposit. The relay itself is just represented as the amount filled so far. The total amount to\n // relay, the fees, and the agents are all parameters included in the hash key.\n mapping(bytes32 => uint256) private DEPRECATED_relayFills;\n\n // Note: We will likely un-deprecate the fill and deposit counters to implement a better\n // dynamic LP fee mechanism but for now we'll deprecate it to reduce bytecode\n // in deposit/fill functions. These counters are designed to implement a fee mechanism that is based on a\n // canonical history of deposit and fill events and how they update a virtual running balance of liabilities and\n // assets, which then determines the LP fee charged to relays.\n\n // This keeps track of the worst-case liabilities due to fills.\n // It is never reset. Users should only rely on it to determine the worst-case increase in liabilities between\n // two points. This is used to provide frontrunning protection to ensure the relayer's assumptions about the state\n // upon which their expected repayments are based will not change before their transaction is mined.\n mapping(address => uint256) private DEPRECATED_fillCounter;\n\n // This keeps track of the total running deposits for each token. This allows depositors to protect themselves from\n // frontrunning that might change their worst-case quote.\n mapping(address => uint256) private DEPRECATED_depositCounter;\n\n // This tracks the number of identical refunds that have been requested.\n // The intention is to allow an off-chain system to know when this could be a duplicate and ensure that the other\n // requests are known and accounted for.\n mapping(bytes32 => uint256) private DEPRECATED_refundsRequested;\n\n // Mapping of V3 relay hashes to fill statuses. Distinguished from relayFills\n // to eliminate any chance of collision between pre and post V3 relay hashes.\n mapping(bytes32 => uint256) public fillStatuses;\n\n // Mapping of L2TokenAddress to relayer to outstanding refund amount. Used when a relayer repayment fails for some\n // reason (eg blacklist) to track their outstanding liability, thereby letting them claim it later.\n mapping(address => mapping(address => uint256)) public relayerRefund;\n\n /**************************************************************\n * CONSTANT/IMMUTABLE VARIABLES *\n **************************************************************/\n // Constant and immutable variables do not take up storage slots and are instead added to the contract bytecode\n // at compile time. The difference between them is that constant variables must be declared inline, meaning\n // that they cannot be changed in production without changing the contract code, while immutable variables\n // can be set in the constructor. Therefore we use the immutable keyword for variables that we might want to be\n // different for each child contract (one obvious example of this is the wrappedNativeToken) or that we might\n // want to update in the future like depositQuoteTimeBuffer. Constants are unlikely to ever be changed.\n\n // Address of wrappedNativeToken contract for this network. If an origin token matches this, then the caller can\n // optionally instruct this contract to wrap native tokens when depositing (ie ETH->WETH or MATIC->WMATIC).\n /// @custom:oz-upgrades-unsafe-allow state-variable-immutable\n WETH9Interface public immutable wrappedNativeToken;\n\n // Any deposit quote times greater than or less than this value to the current contract time is blocked. Forces\n // caller to use an approximately \"current\" realized fee.\n /// @custom:oz-upgrades-unsafe-allow state-variable-immutable\n uint32 public immutable depositQuoteTimeBuffer;\n\n // The fill deadline can only be set this far into the future from the timestamp of the deposit on this contract.\n /// @custom:oz-upgrades-unsafe-allow state-variable-immutable\n uint32 public immutable fillDeadlineBuffer;\n\n uint256 public constant MAX_TRANSFER_SIZE = 1e36;\n\n bytes32 public constant UPDATE_BYTES32_DEPOSIT_DETAILS_HASH =\n keccak256(\n \"UpdateDepositDetails(uint256 depositId,uint256 originChainId,uint256 updatedOutputAmount,bytes32 updatedRecipient,bytes updatedMessage)\"\n );\n // Default chain Id used to signify that no repayment is requested, for example when executing a slow fill.\n uint256 public constant EMPTY_REPAYMENT_CHAIN_ID = 0;\n // Default address used to signify that no relayer should be credited with a refund, for example\n // when executing a slow fill.\n bytes32 public constant EMPTY_RELAYER = bytes32(0);\n // This is the magic value that signals to the off-chain validator\n // that this deposit can never expire. A deposit with this fill deadline should always be eligible for a\n // slow fill, meaning that its output token and input token must be \"equivalent\". Therefore, this value is only\n // used as a fillDeadline in deposit(), a soon to be deprecated function that also hardcodes outputToken to\n // the zero address, which forces the off-chain validator to replace the output token with the equivalent\n // token for the input token. By using this magic value, off-chain validators do not have to keep\n // this event in their lookback window when querying for expired deposits.\n uint32 public constant INFINITE_FILL_DEADLINE = type(uint32).max;\n\n // One year in seconds. If `exclusivityParameter` is set to a value less than this, then the emitted\n // exclusivityDeadline in a deposit event will be set to the current time plus this value.\n uint32 public constant MAX_EXCLUSIVITY_PERIOD_SECONDS = 31_536_000;\n /****************************************\n * EVENTS *\n ****************************************/\n event SetXDomainAdmin(address indexed newAdmin);\n event SetWithdrawalRecipient(address indexed newWithdrawalRecipient);\n event EnabledDepositRoute(address indexed originToken, uint256 indexed destinationChainId, bool enabled);\n event RelayedRootBundle(\n uint32 indexed rootBundleId,\n bytes32 indexed relayerRefundRoot,\n bytes32 indexed slowRelayRoot\n );\n event ExecutedRelayerRefundRoot(\n uint256 amountToReturn,\n uint256 indexed chainId,\n uint256[] refundAmounts,\n uint32 indexed rootBundleId,\n uint32 indexed leafId,\n address l2TokenAddress,\n address[] refundAddresses,\n bool deferredRefunds,\n address caller\n );\n event TokensBridged(\n uint256 amountToReturn,\n uint256 indexed chainId,\n uint32 indexed leafId,\n bytes32 indexed l2TokenAddress,\n address caller\n );\n event EmergencyDeletedRootBundle(uint256 indexed rootBundleId);\n event PausedDeposits(bool isPaused);\n event PausedFills(bool isPaused);\n\n /**\n * @notice Construct the SpokePool. Normally, logic contracts used in upgradeable proxies shouldn't\n * have constructors since the following code will be executed within the logic contract's state, not the\n * proxy contract's state. However, if we restrict the constructor to setting only immutable variables, then\n * we are safe because immutable variables are included in the logic contract's bytecode rather than its storage.\n * @dev Do not leave an implementation contract uninitialized. An uninitialized implementation contract can be\n * taken over by an attacker, which may impact the proxy. To prevent the implementation contract from being\n * used, you should invoke the _disableInitializers function in the constructor to automatically lock it when\n * it is deployed:\n * @param _wrappedNativeTokenAddress wrappedNativeToken address for this network to set.\n * @param _depositQuoteTimeBuffer depositQuoteTimeBuffer to set. Quote timestamps can't be set more than this amount\n * into the past from the block time of the deposit.\n * @param _fillDeadlineBuffer fillDeadlineBuffer to set. Fill deadlines can't be set more than this amount\n * into the future from the block time of the deposit.\n */\n /// @custom:oz-upgrades-unsafe-allow constructor\n constructor(\n address _wrappedNativeTokenAddress,\n uint32 _depositQuoteTimeBuffer,\n uint32 _fillDeadlineBuffer\n ) {\n wrappedNativeToken = WETH9Interface(_wrappedNativeTokenAddress);\n depositQuoteTimeBuffer = _depositQuoteTimeBuffer;\n fillDeadlineBuffer = _fillDeadlineBuffer;\n _disableInitializers();\n }\n\n /**\n * @notice Construct the base SpokePool.\n * @param _initialDepositId Starting deposit ID. Set to 0 unless this is a re-deployment in order to mitigate\n * relay hash collisions.\n * @param _crossDomainAdmin Cross domain admin to set. Can be changed by admin.\n * @param _withdrawalRecipient Address which receives token withdrawals. Can be changed by admin. For Spoke Pools on L2, this will\n * likely be the hub pool.\n */\n function __SpokePool_init(\n uint32 _initialDepositId,\n address _crossDomainAdmin,\n address _withdrawalRecipient\n ) public onlyInitializing {\n numberOfDeposits = _initialDepositId;\n __EIP712_init(\"ACROSS-V2\", \"1.0.0\");\n __UUPSUpgradeable_init();\n __ReentrancyGuard_init();\n _setCrossDomainAdmin(_crossDomainAdmin);\n _setWithdrawalRecipient(_withdrawalRecipient);\n }\n\n /****************************************\n * MODIFIERS *\n ****************************************/\n\n /**\n * @dev Function that should revert when `msg.sender` is not authorized to upgrade the contract. Called by\n * {upgradeTo} and {upgradeToAndCall}.\n * @dev This should be set to cross domain admin for specific SpokePool.\n */\n modifier onlyAdmin() {\n _requireAdminSender();\n _;\n }\n\n modifier unpausedDeposits() {\n if (pausedDeposits) revert DepositsArePaused();\n _;\n }\n\n modifier unpausedFills() {\n if (pausedFills) revert FillsArePaused();\n _;\n }\n\n /**************************************\n * ADMIN FUNCTIONS *\n **************************************/\n\n // Allows cross domain admin to upgrade UUPS proxy implementation.\n function _authorizeUpgrade(address newImplementation) internal override onlyAdmin {}\n\n /**\n * @notice Pauses deposit-related functions. This is intended to be used if this contract is deprecated or when\n * something goes awry.\n * @dev Affects `deposit()` but not `speedUpDeposit()`, so that existing deposits can be sped up and still\n * relayed.\n * @param pause true if the call is meant to pause the system, false if the call is meant to unpause it.\n */\n function pauseDeposits(bool pause) public override onlyAdmin nonReentrant {\n pausedDeposits = pause;\n emit PausedDeposits(pause);\n }\n\n /**\n * @notice Pauses fill-related functions. This is intended to be used if this contract is deprecated or when\n * something goes awry.\n * @dev Affects fillRelayWithUpdatedDeposit() and fillRelay().\n * @param pause true if the call is meant to pause the system, false if the call is meant to unpause it.\n */\n function pauseFills(bool pause) public override onlyAdmin nonReentrant {\n pausedFills = pause;\n emit PausedFills(pause);\n }\n\n /**\n * @notice Change cross domain admin address. Callable by admin only.\n * @param newCrossDomainAdmin New cross domain admin.\n */\n function setCrossDomainAdmin(address newCrossDomainAdmin) public override onlyAdmin nonReentrant {\n _setCrossDomainAdmin(newCrossDomainAdmin);\n }\n\n /**\n * @notice Change L1 withdrawal recipient address. Callable by admin only.\n * @param newWithdrawalRecipient New withdrawal recipient address.\n */\n function setWithdrawalRecipient(address newWithdrawalRecipient) public override onlyAdmin nonReentrant {\n _setWithdrawalRecipient(newWithdrawalRecipient);\n }\n\n /**\n * @notice This method stores a new root bundle in this contract that can be executed to refund relayers, fulfill\n * slow relays, and send funds back to the HubPool on L1. This method can only be called by the admin and is\n * designed to be called as part of a cross-chain message from the HubPool's executeRootBundle method.\n * @param relayerRefundRoot Merkle root containing relayer refund leaves that can be individually executed via\n * executeRelayerRefundLeaf().\n * @param slowRelayRoot Merkle root containing slow relay fulfillment leaves that can be individually executed via\n * executeSlowRelayLeaf().\n */\n function relayRootBundle(bytes32 relayerRefundRoot, bytes32 slowRelayRoot) public override onlyAdmin nonReentrant {\n uint32 rootBundleId = uint32(rootBundles.length);\n RootBundle storage rootBundle = rootBundles.push();\n rootBundle.relayerRefundRoot = relayerRefundRoot;\n rootBundle.slowRelayRoot = slowRelayRoot;\n emit RelayedRootBundle(rootBundleId, relayerRefundRoot, slowRelayRoot);\n }\n\n /**\n * @notice This method is intended to only be used in emergencies where a bad root bundle has reached the\n * SpokePool.\n * @param rootBundleId Index of the root bundle that needs to be deleted. Note: this is intentionally a uint256\n * to ensure that a small input range doesn't limit which indices this method is able to reach.\n */\n function emergencyDeleteRootBundle(uint256 rootBundleId) public override onlyAdmin nonReentrant {\n // Deleting a struct containing a mapping does not delete the mapping in Solidity, therefore the bitmap's\n // data will still remain potentially leading to vulnerabilities down the line. The way around this would\n // be to iterate through every key in the mapping and resetting the value to 0, but this seems expensive and\n // would require a new list in storage to keep track of keys.\n //slither-disable-next-line mapping-deletion\n delete rootBundles[rootBundleId];\n emit EmergencyDeletedRootBundle(rootBundleId);\n }\n\n /**************************************\n * LEGACY DEPOSITOR FUNCTIONS *\n **************************************/\n\n /**\n * @dev DEPRECATION NOTICE: this function is deprecated and will be removed in the future.\n * Please use deposit (under DEPOSITOR FUNCTIONS below) or depositV3 instead.\n * @notice Called by user to bridge funds from origin to destination chain. Depositor will effectively lock\n * tokens in this contract and receive a destination token on the destination chain. The origin => destination\n * token mapping is stored on the L1 HubPool.\n * @notice The caller must first approve this contract to spend amount of originToken.\n * @notice The originToken => destinationChainId must be enabled.\n * @notice This method is payable because the caller is able to deposit native token if the originToken is\n * wrappedNativeToken and this function will handle wrapping the native token to wrappedNativeToken.\n * @dev Produces a FundsDeposited event with an infinite expiry, meaning that this deposit can never expire.\n * Moreover, the event's outputToken is set to 0x0 meaning that this deposit can always be slow filled.\n * @param recipient Address to receive funds at on destination chain.\n * @param originToken Token to lock into this contract to initiate deposit.\n * @param amount Amount of tokens to deposit. Will be amount of tokens to receive less fees.\n * @param destinationChainId Denotes network where user will receive funds from SpokePool by a relayer.\n * @param relayerFeePct % of deposit amount taken out to incentivize a fast relayer.\n * @param quoteTimestamp Timestamp used by relayers to compute this deposit's realizedLPFeePct which is paid\n * to LP pool on HubPool.\n * @param message Arbitrary data that can be used to pass additional information to the recipient along with the tokens.\n * Note: this is intended to be used to pass along instructions for how a contract should use or allocate the tokens.\n */\n function depositDeprecated_5947912356(\n address recipient,\n address originToken,\n uint256 amount,\n uint256 destinationChainId,\n int64 relayerFeePct,\n uint32 quoteTimestamp,\n bytes memory message,\n uint256 // maxCount. Deprecated.\n ) public payable nonReentrant unpausedDeposits {\n _deposit(\n msg.sender,\n recipient,\n originToken,\n amount,\n destinationChainId,\n relayerFeePct,\n quoteTimestamp,\n message\n );\n }\n\n /**\n * @dev DEPRECATION NOTICE: this function is deprecated and will be removed in the future.\n * Please use the other deposit or depositV3 instead.\n * @notice The only difference between depositFor and deposit is that the depositor address stored\n * in the relay hash can be overridden by the caller. This means that the passed in depositor\n * can speed up the deposit, which is useful if the deposit is taken from the end user to a middle layer\n * contract, like an aggregator or the SpokePoolVerifier, before calling deposit on this contract.\n * @notice The caller must first approve this contract to spend amount of originToken.\n * @notice The originToken => destinationChainId must be enabled.\n * @notice This method is payable because the caller is able to deposit native token if the originToken is\n * wrappedNativeToken and this function will handle wrapping the native token to wrappedNativeToken.\n * @param depositor Address who is credited for depositing funds on origin chain and can speed up the deposit.\n * @param recipient Address to receive funds at on destination chain.\n * @param originToken Token to lock into this contract to initiate deposit.\n * @param amount Amount of tokens to deposit. Will be amount of tokens to receive less fees.\n * @param destinationChainId Denotes network where user will receive funds from SpokePool by a relayer.\n * @param relayerFeePct % of deposit amount taken out to incentivize a fast relayer.\n * @param quoteTimestamp Timestamp used by relayers to compute this deposit's realizedLPFeePct which is paid\n * to LP pool on HubPool.\n * @param message Arbitrary data that can be used to pass additional information to the recipient along with the tokens.\n * Note: this is intended to be used to pass along instructions for how a contract should use or allocate the tokens.\n */\n function depositFor(\n address depositor,\n address recipient,\n address originToken,\n uint256 amount,\n uint256 destinationChainId,\n int64 relayerFeePct,\n uint32 quoteTimestamp,\n bytes memory message,\n uint256 // maxCount. Deprecated.\n ) public payable nonReentrant unpausedDeposits {\n _deposit(depositor, recipient, originToken, amount, destinationChainId, relayerFeePct, quoteTimestamp, message);\n }\n\n /********************************************\n * DEPOSITOR FUNCTIONS *\n ********************************************/\n\n /**\n * @notice Previously, this function allowed the caller to specify the exclusivityDeadline, otherwise known as the\n * as exact timestamp on the destination chain before which only the exclusiveRelayer could fill the deposit. Now,\n * the caller is expected to pass in a number that will be interpreted either as an offset or a fixed\n * timestamp depending on its value.\n * @notice Request to bridge input token cross chain to a destination chain and receive a specified amount\n * of output tokens. The fee paid to relayers and the system should be captured in the spread between output\n * amount and input amount when adjusted to be denominated in the input token. A relayer on the destination\n * chain will send outputAmount of outputTokens to the recipient and receive inputTokens on a repayment\n * chain of their choice. Therefore, the fee should account for destination fee transaction costs,\n * the relayer's opportunity cost of capital while they wait to be refunded following an optimistic challenge\n * window in the HubPool, and the system fee that they'll be charged.\n * @dev On the destination chain, the hash of the deposit data will be used to uniquely identify this deposit, so\n * modifying any params in it will result in a different hash and a different deposit. The hash will comprise\n * all parameters to this function along with this chain's chainId(). Relayers are only refunded for filling\n * deposits with deposit hashes that map exactly to the one emitted by this contract.\n * @param depositor The account credited with the deposit who can request to \"speed up\" this deposit by modifying\n * the output amount, recipient, and message.\n * @param recipient The account receiving funds on the destination chain. Can be an EOA or a contract. If\n * the output token is the wrapped native token for the chain, then the recipient will receive native token if\n * an EOA or wrapped native token if a contract.\n * @param inputToken The token pulled from the caller's account and locked into this contract to\n * initiate the deposit. The equivalent of this token on the relayer's repayment chain of choice will be sent\n * as a refund. If this is equal to the wrapped native token then the caller can optionally pass in native token as\n * msg.value, as long as msg.value = inputTokenAmount.\n * @param outputToken The token that the relayer will send to the recipient on the destination chain. Must be an\n * ERC20.\n * @param inputAmount The amount of input tokens to pull from the caller's account and lock into this contract.\n * This amount will be sent to the relayer on their repayment chain of choice as a refund following an optimistic\n * challenge window in the HubPool, less a system fee.\n * @param outputAmount The amount of output tokens that the relayer will send to the recipient on the destination.\n * @param destinationChainId The destination chain identifier. Must be enabled along with the input token\n * as a valid deposit route from this spoke pool or this transaction will revert.\n * @param exclusiveRelayer The relayer that will be exclusively allowed to fill this deposit before the\n * exclusivity deadline timestamp. This must be a valid, non-zero address if the exclusivity deadline is\n * greater than the current block.timestamp. If the exclusivity deadline is < currentTime, then this must be\n * address(0), and vice versa if this is address(0).\n * @param quoteTimestamp The HubPool timestamp that is used to determine the system fee paid by the depositor.\n * This must be set to some time between [currentTime - depositQuoteTimeBuffer, currentTime]\n * where currentTime is block.timestamp on this chain or this transaction will revert.\n * @param fillDeadline The deadline for the relayer to fill the deposit. After this destination chain timestamp,\n * the fill will revert on the destination chain. Must be set before currentTime + fillDeadlineBuffer, where\n * currentTime is block.timestamp on this chain or this transaction will revert.\n * @param exclusivityParameter This value is used to set the exclusivity deadline timestamp in the emitted deposit\n * event. Before this destination chain timestamp, only the exclusiveRelayer (if set to a non-zero address),\n * can fill this deposit. There are three ways to use this parameter:\n * 1. NO EXCLUSIVITY: If this value is set to 0, then a timestamp of 0 will be emitted,\n * meaning that there is no exclusivity period.\n * 2. OFFSET: If this value is less than MAX_EXCLUSIVITY_PERIOD_SECONDS, then add this value to\n * the block.timestamp to derive the exclusive relayer deadline. Note that using the parameter in this way\n * will expose the filler of the deposit to the risk that the block.timestamp of this event gets changed\n * due to a chain-reorg, which would also change the exclusivity timestamp.\n * 3. TIMESTAMP: Otherwise, set this value as the exclusivity deadline timestamp.\n * which is the deadline for the exclusiveRelayer to fill the deposit.\n * @param message The message to send to the recipient on the destination chain if the recipient is a contract.\n * If the message is not empty, the recipient contract must implement handleV3AcrossMessage() or the fill will revert.\n */\n function deposit(\n bytes32 depositor,\n bytes32 recipient,\n bytes32 inputToken,\n bytes32 outputToken,\n uint256 inputAmount,\n uint256 outputAmount,\n uint256 destinationChainId,\n bytes32 exclusiveRelayer,\n uint32 quoteTimestamp,\n uint32 fillDeadline,\n uint32 exclusivityParameter,\n bytes calldata message\n ) public payable override nonReentrant unpausedDeposits {\n // Increment the `numberOfDeposits` counter to ensure a unique deposit ID for this spoke pool.\n DepositV3Params memory params = DepositV3Params({\n depositor: depositor,\n recipient: recipient,\n inputToken: inputToken,\n outputToken: outputToken,\n inputAmount: inputAmount,\n outputAmount: outputAmount,\n destinationChainId: destinationChainId,\n exclusiveRelayer: exclusiveRelayer,\n depositId: numberOfDeposits++,\n quoteTimestamp: quoteTimestamp,\n fillDeadline: fillDeadline,\n exclusivityParameter: exclusivityParameter,\n message: message\n });\n _depositV3(params);\n }\n\n /**\n * @notice A version of `deposit` that accepts `address` types for backward compatibility.\n * This function allows bridging of input tokens cross-chain to a destination chain, receiving a specified amount of output tokens.\n * The relayer is refunded in input tokens on a repayment chain of their choice, minus system fees, after an optimistic challenge\n * window. The exclusivity period is specified as an offset from the current block timestamp.\n *\n * @dev This version mirrors the original `depositV3` function, but uses `address` types for `depositor`, `recipient`,\n * `inputToken`, `outputToken`, and `exclusiveRelayer` for compatibility with contracts using the `address` type.\n *\n * The key functionality and logic remain identical, ensuring interoperability across both versions.\n *\n * @param depositor The account credited with the deposit who can request to \"speed up\" this deposit by modifying\n * the output amount, recipient, and message.\n * @param recipient The account receiving funds on the destination chain. Can be an EOA or a contract. If\n * the output token is the wrapped native token for the chain, then the recipient will receive native token if\n * an EOA or wrapped native token if a contract.\n * @param inputToken The token pulled from the caller's account and locked into this contract to initiate the deposit.\n * The equivalent of this token on the relayer's repayment chain of choice will be sent as a refund. If this is equal\n * to the wrapped native token, the caller can optionally pass in native token as msg.value, provided msg.value = inputTokenAmount.\n * @param outputToken The token that the relayer will send to the recipient on the destination chain. Must be an ERC20.\n * @param inputAmount The amount of input tokens pulled from the caller's account and locked into this contract. This\n * amount will be sent to the relayer as a refund following an optimistic challenge window in the HubPool, less a system fee.\n * @param outputAmount The amount of output tokens that the relayer will send to the recipient on the destination.\n * @param destinationChainId The destination chain identifier. Must be enabled along with the input token as a valid\n * deposit route from this spoke pool or this transaction will revert.\n * @param exclusiveRelayer The relayer exclusively allowed to fill this deposit before the exclusivity deadline.\n * @param quoteTimestamp The HubPool timestamp that determines the system fee paid by the depositor. This must be set\n * between [currentTime - depositQuoteTimeBuffer, currentTime] where currentTime is block.timestamp on this chain.\n * @param fillDeadline The deadline for the relayer to fill the deposit. After this destination chain timestamp, the fill will\n * revert on the destination chain. Must be set before currentTime + fillDeadlineBuffer, where currentTime is block.timestamp\n * on this chain.\n * @param exclusivityParameter This value is used to set the exclusivity deadline timestamp in the emitted deposit\n * event. Before this destination chain timestamp, only the exclusiveRelayer (if set to a non-zero address),\n * can fill this deposit. There are three ways to use this parameter:\n * 1. NO EXCLUSIVITY: If this value is set to 0, then a timestamp of 0 will be emitted,\n * meaning that there is no exclusivity period.\n * 2. OFFSET: If this value is less than MAX_EXCLUSIVITY_PERIOD_SECONDS, then add this value to\n * the block.timestamp to derive the exclusive relayer deadline. Note that using the parameter in this way\n * will expose the filler of the deposit to the risk that the block.timestamp of this event gets changed\n * due to a chain-reorg, which would also change the exclusivity timestamp.\n * 3. TIMESTAMP: Otherwise, set this value as the exclusivity deadline timestamp.\n * which is the deadline for the exclusiveRelayer to fill the deposit.\n * @param message The message to send to the recipient on the destination chain if the recipient is a contract. If the\n * message is not empty, the recipient contract must implement `handleV3AcrossMessage()` or the fill will revert.\n */\n function depositV3(\n address depositor,\n address recipient,\n address inputToken,\n address outputToken,\n uint256 inputAmount,\n uint256 outputAmount,\n uint256 destinationChainId,\n address exclusiveRelayer,\n uint32 quoteTimestamp,\n uint32 fillDeadline,\n uint32 exclusivityParameter,\n bytes calldata message\n ) public payable override {\n deposit(\n depositor.toBytes32(),\n recipient.toBytes32(),\n inputToken.toBytes32(),\n outputToken.toBytes32(),\n inputAmount,\n outputAmount,\n destinationChainId,\n exclusiveRelayer.toBytes32(),\n quoteTimestamp,\n fillDeadline,\n exclusivityParameter,\n message\n );\n }\n\n /**\n * @notice See deposit for details. This function is identical to deposit except that it does not use the\n * global deposit ID counter as a deposit nonce, instead allowing the caller to pass in a deposit nonce. This\n * function is designed to be used by anyone who wants to pre-compute their resultant relay data hash, which\n * could be useful for filling a deposit faster and avoiding any risk of a relay hash unexpectedly changing\n * due to another deposit front-running this one and incrementing the global deposit ID counter.\n * @dev This is labeled \"unsafe\" because there is no guarantee that the depositId emitted in the resultant\n * FundsDeposited event is unique which means that the\n * corresponding fill might collide with an existing relay hash on the destination chain SpokePool,\n * which would make this deposit unfillable. In this case, the depositor would subsequently receive a refund\n * of `inputAmount` of `inputToken` on the origin chain after the fill deadline. Re-using a depositNonce is very\n * dangerous when combined with `speedUpDeposit`, as a speed up signature can be re-used for any deposits\n * with the same deposit ID.\n * @dev On the destination chain, the hash of the deposit data will be used to uniquely identify this deposit, so\n * modifying any params in it will result in a different hash and a different deposit. The hash will comprise\n * all parameters to this function along with this chain's chainId(). Relayers are only refunded for filling\n * deposits with deposit hashes that map exactly to the one emitted by this contract.\n * @param depositNonce The nonce that uniquely identifies this deposit. This function will combine this parameter\n * with the msg.sender address to create a unique uint256 depositNonce and ensure that the msg.sender cannot\n * use this function to front-run another depositor's unsafe deposit. This function guarantees that the resultant\n * deposit nonce will not collide with a safe uint256 deposit nonce whose 24 most significant bytes are always 0.\n * @param depositor See identically named parameter in depositV3() comments.\n * @param recipient See identically named parameter in depositV3() comments.\n * @param inputToken See identically named parameter in depositV3() comments.\n * @param outputToken See identically named parameter in depositV3() comments.\n * @param inputAmount See identically named parameter in depositV3() comments.\n * @param outputAmount See identically named parameter in depositV3() comments.\n * @param destinationChainId See identically named parameter in depositV3() comments.\n * @param exclusiveRelayer See identically named parameter in depositV3() comments.\n * @param quoteTimestamp See identically named parameter in depositV3() comments.\n * @param fillDeadline See identically named parameter in depositV3() comments.\n * @param exclusivityParameter See identically named parameter in depositV3() comments.\n * @param message See identically named parameter in depositV3() comments.\n */\n function unsafeDeposit(\n bytes32 depositor,\n bytes32 recipient,\n bytes32 inputToken,\n bytes32 outputToken,\n uint256 inputAmount,\n uint256 outputAmount,\n uint256 destinationChainId,\n bytes32 exclusiveRelayer,\n uint256 depositNonce,\n uint32 quoteTimestamp,\n uint32 fillDeadline,\n uint32 exclusivityParameter,\n bytes calldata message\n ) public payable nonReentrant unpausedDeposits {\n // @dev Create the uint256 deposit ID by concatenating the msg.sender and depositor address with the inputted\n // depositNonce parameter. The resultant 32 byte string will be hashed and then casted to an \"unsafe\"\n // uint256 deposit ID. The probability that the resultant ID collides with a \"safe\" deposit ID is\n // equal to the chance that the first 28 bytes of the hash are 0, which is too small for us to consider.\n\n uint256 depositId = getUnsafeDepositId(msg.sender, depositor, depositNonce);\n DepositV3Params memory params = DepositV3Params({\n depositor: depositor,\n recipient: recipient,\n inputToken: inputToken,\n outputToken: outputToken,\n inputAmount: inputAmount,\n outputAmount: outputAmount,\n destinationChainId: destinationChainId,\n exclusiveRelayer: exclusiveRelayer,\n depositId: depositId,\n quoteTimestamp: quoteTimestamp,\n fillDeadline: fillDeadline,\n exclusivityParameter: exclusivityParameter,\n message: message\n });\n _depositV3(params);\n }\n\n /**\n * @notice Submits deposit and sets quoteTimestamp to current Time. Sets fill and exclusivity\n * deadlines as offsets added to the current time. This function is designed to be called by users\n * such as Multisig contracts who do not have certainty when their transaction will mine.\n * @param depositor The account credited with the deposit who can request to \"speed up\" this deposit by modifying\n * the output amount, recipient, and message.\n * @param recipient The account receiving funds on the destination chain. Can be an EOA or a contract. If\n * the output token is the wrapped native token for the chain, then the recipient will receive native token if\n * an EOA or wrapped native token if a contract.\n * @param inputToken The token pulled from the caller's account and locked into this contract to\n * initiate the deposit. The equivalent of this token on the relayer's repayment chain of choice will be sent\n * as a refund. If this is equal to the wrapped native token then the caller can optionally pass in native token as\n * msg.value, as long as msg.value = inputTokenAmount.\n * @param outputToken The token that the relayer will send to the recipient on the destination chain. Must be an\n * ERC20.\n * @param inputAmount The amount of input tokens to pull from the caller's account and lock into this contract.\n * This amount will be sent to the relayer on their repayment chain of choice as a refund following an optimistic\n * challenge window in the HubPool, plus a system fee.\n * @param outputAmount The amount of output tokens that the relayer will send to the recipient on the destination.\n * @param destinationChainId The destination chain identifier. Must be enabled along with the input token\n * as a valid deposit route from this spoke pool or this transaction will revert.\n * @param exclusiveRelayer The relayer that will be exclusively allowed to fill this deposit before the\n * exclusivity deadline timestamp.\n * @param fillDeadlineOffset Added to the current time to set the fill deadline, which is the deadline for the\n * relayer to fill the deposit. After this destination chain timestamp, the fill will revert on the\n * destination chain.\n * @param exclusivityParameter See identically named parameter in deposit() comments.\n * @param message The message to send to the recipient on the destination chain if the recipient is a contract.\n * If the message is not empty, the recipient contract must implement handleV3AcrossMessage() or the fill will revert.\n */\n function depositNow(\n bytes32 depositor,\n bytes32 recipient,\n bytes32 inputToken,\n bytes32 outputToken,\n uint256 inputAmount,\n uint256 outputAmount,\n uint256 destinationChainId,\n bytes32 exclusiveRelayer,\n uint32 fillDeadlineOffset,\n uint32 exclusivityParameter,\n bytes calldata message\n ) external payable override {\n deposit(\n depositor,\n recipient,\n inputToken,\n outputToken,\n inputAmount,\n outputAmount,\n destinationChainId,\n exclusiveRelayer,\n uint32(getCurrentTime()),\n uint32(getCurrentTime()) + fillDeadlineOffset,\n exclusivityParameter,\n message\n );\n }\n\n /**\n * @notice A version of `depositNow` that supports addresses as input types for backward compatibility.\n * This function submits a deposit and sets `quoteTimestamp` to the current time. The `fill` and `exclusivity` deadlines\n * are set as offsets added to the current time. It is designed to be called by users, including Multisig contracts, who may\n * not have certainty when their transaction will be mined.\n *\n * @dev This version is identical to the original `depositV3Now` but uses `address` types for `depositor`, `recipient`,\n * `inputToken`, `outputToken`, and `exclusiveRelayer` to support compatibility with older systems.\n * It maintains the same logic and purpose, ensuring interoperability with both versions.\n *\n * @param depositor The account credited with the deposit, who can request to \"speed up\" this deposit by modifying\n * the output amount, recipient, and message.\n * @param recipient The account receiving funds on the destination chain. Can be an EOA or a contract. If\n * the output token is the wrapped native token for the chain, then the recipient will receive the native token if\n * an EOA or wrapped native token if a contract.\n * @param inputToken The token pulled from the caller's account and locked into this contract to initiate the deposit.\n * Equivalent tokens on the relayer's repayment chain will be sent as a refund. If this is the wrapped native token,\n * msg.value must equal inputTokenAmount when passed.\n * @param outputToken The token the relayer will send to the recipient on the destination chain. Must be an ERC20.\n * @param inputAmount The amount of input tokens pulled from the caller's account and locked into this contract.\n * This amount will be sent to the relayer as a refund following an optimistic challenge window in the HubPool, plus a system fee.\n * @param outputAmount The amount of output tokens the relayer will send to the recipient on the destination.\n * @param destinationChainId The destination chain identifier. Must be enabled with the input token as a valid deposit route\n * from this spoke pool, or the transaction will revert.\n * @param exclusiveRelayer The relayer exclusively allowed to fill the deposit before the exclusivity deadline.\n * @param fillDeadlineOffset Added to the current time to set the fill deadline. After this timestamp, fills on the\n * destination chain will revert.\n * @param exclusivityParameter See identically named parameter in deposit() comments.\n * @param message The message to send to the recipient on the destination chain. If the recipient is a contract, it must\n * implement `handleV3AcrossMessage()` if the message is not empty, or the fill will revert.\n */\n function depositV3Now(\n address depositor,\n address recipient,\n address inputToken,\n address outputToken,\n uint256 inputAmount,\n uint256 outputAmount,\n uint256 destinationChainId,\n address exclusiveRelayer,\n uint32 fillDeadlineOffset,\n uint32 exclusivityParameter,\n bytes calldata message\n ) external payable override {\n depositV3(\n depositor,\n recipient,\n inputToken,\n outputToken,\n inputAmount,\n outputAmount,\n destinationChainId,\n exclusiveRelayer,\n uint32(getCurrentTime()),\n uint32(getCurrentTime()) + fillDeadlineOffset,\n exclusivityParameter,\n message\n );\n }\n\n /**\n * @notice Depositor can use this function to signal to relayer to use updated output amount, recipient,\n * and/or message. The speed up signature uniquely identifies the speed up based only on\n * depositor, deposit ID and origin chain, so using this function in conjunction with unsafeDeposit is risky\n * due to the chance of repeating a deposit ID.\n * @dev the depositor and depositId must match the params in a FundsDeposited event that the depositor\n * wants to speed up. The relayer has the option but not the obligation to use this updated information\n * when filling the deposit via fillRelayWithUpdatedDeposit().\n * @param depositor Depositor that must sign the depositorSignature and was the original depositor.\n * @param depositId Deposit ID to speed up.\n * @param updatedOutputAmount New output amount to use for this deposit. Should be lower than previous value\n * otherwise relayer has no incentive to use this updated value.\n * @param updatedRecipient New recipient to use for this deposit. Can be modified if the recipient is a contract\n * that expects to receive a message from the relay and for some reason needs to be modified.\n * @param updatedMessage New message to use for this deposit. Can be modified if the recipient is a contract\n * that expects to receive a message from the relay and for some reason needs to be modified.\n * @param depositorSignature Signed EIP712 hashstruct containing the deposit ID. Should be signed by the depositor\n * account. If depositor is a contract, then should implement EIP1271 to sign as a contract. See\n * _verifyUpdateV3DepositMessage() for more details about how this signature should be constructed.\n */\n function speedUpDeposit(\n bytes32 depositor,\n uint256 depositId,\n uint256 updatedOutputAmount,\n bytes32 updatedRecipient,\n bytes calldata updatedMessage,\n bytes calldata depositorSignature\n ) public override nonReentrant {\n _verifyUpdateV3DepositMessage(\n depositor.toAddress(),\n depositId,\n chainId(),\n updatedOutputAmount,\n updatedRecipient,\n updatedMessage,\n depositorSignature,\n UPDATE_BYTES32_DEPOSIT_DETAILS_HASH\n );\n\n // Assuming the above checks passed, a relayer can take the signature and the updated deposit information\n // from the following event to submit a fill with updated relay data.\n emit RequestedSpeedUpDeposit(\n updatedOutputAmount,\n depositId,\n depositor,\n updatedRecipient,\n updatedMessage,\n depositorSignature\n );\n }\n\n /**\n * @notice A version of `speedUpDeposit` using `address` types for backward compatibility.\n * This function allows the depositor to signal to the relayer to use updated output amount, recipient, and/or message\n * when filling a deposit. This can be useful when the deposit needs to be modified after the original transaction has\n * been mined.\n *\n * @dev The `depositor` and `depositId` must match the parameters in a `FundsDeposited` event that the depositor wants to speed up.\n * The relayer is not obligated but has the option to use this updated information when filling the deposit using\n * `fillRelayWithUpdatedDeposit()`. This version uses `address` types for compatibility with systems relying on\n * `address`-based implementations.\n *\n * @param depositor The depositor that must sign the `depositorSignature` and was the original depositor.\n * @param depositId The deposit ID to speed up.\n * @param updatedOutputAmount The new output amount to use for this deposit. It should be lower than the previous value,\n * otherwise the relayer has no incentive to use this updated value.\n * @param updatedRecipient The new recipient for this deposit. Can be modified if the original recipient is a contract that\n * expects to receive a message from the relay and needs to be changed.\n * @param updatedMessage The new message for this deposit. Can be modified if the recipient is a contract that expects\n * to receive a message from the relay and needs to be updated.\n * @param depositorSignature The signed EIP712 hashstruct containing the deposit ID. Should be signed by the depositor account.\n * If the depositor is a contract, it should implement EIP1271 to sign as a contract. See `_verifyUpdateV3DepositMessage()`\n * for more details on how the signature should be constructed.\n */\n function speedUpV3Deposit(\n address depositor,\n uint256 depositId,\n uint256 updatedOutputAmount,\n address updatedRecipient,\n bytes calldata updatedMessage,\n bytes calldata depositorSignature\n ) public {\n _verifyUpdateV3DepositMessage(\n depositor,\n depositId,\n chainId(),\n updatedOutputAmount,\n updatedRecipient.toBytes32(),\n updatedMessage,\n depositorSignature,\n UPDATE_BYTES32_DEPOSIT_DETAILS_HASH\n );\n\n // Assuming the above checks passed, a relayer can take the signature and the updated deposit information\n // from the following event to submit a fill with updated relay data.\n emit RequestedSpeedUpDeposit(\n updatedOutputAmount,\n depositId,\n depositor.toBytes32(),\n updatedRecipient.toBytes32(),\n updatedMessage,\n depositorSignature\n );\n }\n\n /**************************************\n * RELAYER FUNCTIONS *\n **************************************/\n\n /**\n * @notice Fulfill request to bridge cross chain by sending specified output tokens to the recipient.\n * @dev The fee paid to relayers and the system should be captured in the spread between output\n * amount and input amount when adjusted to be denominated in the input token. A relayer on the destination\n * chain will send outputAmount of outputTokens to the recipient and receive inputTokens on a repayment\n * chain of their choice. Therefore, the fee should account for destination fee transaction costs, the\n * relayer's opportunity cost of capital while they wait to be refunded following an optimistic challenge\n * window in the HubPool, and a system fee charged to relayers.\n * @dev The hash of the relayData will be used to uniquely identify the deposit to fill, so\n * modifying any params in it will result in a different hash and a different deposit. The hash will comprise\n * all parameters passed to deposit() on the origin chain along with that chain's chainId(). This chain's\n * chainId() must therefore match the destinationChainId passed into deposit.\n * Relayers are only refunded for filling deposits with deposit hashes that map exactly to the one emitted by the\n * origin SpokePool therefore the relayer should not modify any params in relayData.\n * @dev Cannot fill more than once. Partial fills are not supported.\n * @param relayData struct containing all the data needed to identify the deposit to be filled. Should match\n * all the same-named parameters emitted in the origin chain FundsDeposited event.\n * - depositor: The account credited with the deposit who can request to \"speed up\" this deposit by modifying\n * the output amount, recipient, and message.\n * - recipient The account receiving funds on this chain. Can be an EOA or a contract. If\n * the output token is the wrapped native token for the chain, then the recipient will receive native token if\n * an EOA or wrapped native token if a contract.\n * - inputToken: The token pulled from the caller's account to initiate the deposit. The equivalent of this\n * token on the repayment chain will be sent as a refund to the caller.\n * - outputToken The token that the caller will send to the recipient on the destination chain. Must be an\n * ERC20.\n * - inputAmount: This amount, less a system fee, will be sent to the caller on their repayment chain of choice as a refund\n * following an optimistic challenge window in the HubPool.\n * - outputAmount: The amount of output tokens that the caller will send to the recipient.\n * - originChainId: The origin chain identifier.\n * - exclusiveRelayer The relayer that will be exclusively allowed to fill this deposit before the\n * exclusivity deadline timestamp.\n * - fillDeadline The deadline for the caller to fill the deposit. After this timestamp,\n * the fill will revert on the destination chain.\n * - exclusivityDeadline: The deadline for the exclusive relayer to fill the deposit. After this\n * timestamp, anyone can fill this deposit. Note that if this value was set in deposit by adding an offset\n * to the deposit's block.timestamp, there is re-org risk for the caller of this method because the event's\n * block.timestamp can change. Read the comments in `deposit` about the `exclusivityParameter` for more details.\n * - message The message to send to the recipient if the recipient is a contract that implements a\n * handleV3AcrossMessage() public function\n * @param repaymentChainId Chain of SpokePool where relayer wants to be refunded after the challenge window has\n * passed. Will receive inputAmount of the equivalent token to inputToken on the repayment chain.\n * @param repaymentAddress Address the relayer wants to be receive their refund at.\n */\n function fillRelay(\n V3RelayData memory relayData,\n uint256 repaymentChainId,\n bytes32 repaymentAddress\n ) public override nonReentrant unpausedFills {\n // Exclusivity deadline is inclusive and is the latest timestamp that the exclusive relayer has sole right\n // to fill the relay.\n if (\n _fillIsExclusive(relayData.exclusivityDeadline, uint32(getCurrentTime())) &&\n relayData.exclusiveRelayer.toAddress() != msg.sender\n ) {\n revert NotExclusiveRelayer();\n }\n\n V3RelayExecutionParams memory relayExecution = V3RelayExecutionParams({\n relay: relayData,\n relayHash: getV3RelayHash(relayData),\n updatedOutputAmount: relayData.outputAmount,\n updatedRecipient: relayData.recipient,\n updatedMessage: relayData.message,\n repaymentChainId: repaymentChainId\n });\n\n _fillRelayV3(relayExecution, repaymentAddress, false);\n }\n\n // Exposes the same function as fillRelay but with a legacy V3RelayData struct that takes in address types. Inner\n // function fillV3Relay() applies reentrancy & non-paused checks.\n function fillV3Relay(V3RelayDataLegacy calldata relayData, uint256 repaymentChainId) public override {\n // Convert V3RelayDataLegacy to V3RelayData using the .toBytes32() method.\n V3RelayData memory convertedRelayData = V3RelayData({\n depositor: relayData.depositor.toBytes32(),\n recipient: relayData.recipient.toBytes32(),\n exclusiveRelayer: relayData.exclusiveRelayer.toBytes32(),\n inputToken: relayData.inputToken.toBytes32(),\n outputToken: relayData.outputToken.toBytes32(),\n inputAmount: relayData.inputAmount,\n outputAmount: relayData.outputAmount,\n originChainId: relayData.originChainId,\n depositId: relayData.depositId,\n fillDeadline: relayData.fillDeadline,\n exclusivityDeadline: relayData.exclusivityDeadline,\n message: relayData.message\n });\n\n fillRelay(convertedRelayData, repaymentChainId, msg.sender.toBytes32());\n }\n\n /**\n * @notice Identical to fillV3Relay except that the relayer wants to use a depositor's updated output amount,\n * recipient, and/or message. The relayer should only use this function if they can supply a message signed\n * by the depositor that contains the fill's matching deposit ID along with updated relay parameters.\n * If the signature can be verified, then this function will emit a FilledV3Event that will be used by\n * the system for refund verification purposes. In other words, this function is an alternative way to fill a\n * a deposit than fillV3Relay.\n * @dev Subject to same exclusivity deadline rules as fillV3Relay().\n * @param relayData struct containing all the data needed to identify the deposit to be filled. See fillV3Relay().\n * @param repaymentChainId Chain of SpokePool where relayer wants to be refunded after the challenge window has\n * passed. See fillV3Relay().\n * @param repaymentAddress Address the relayer wants to be receive their refund at.\n * @param updatedOutputAmount New output amount to use for this deposit.\n * @param updatedRecipient New recipient to use for this deposit.\n * @param updatedMessage New message to use for this deposit.\n * @param depositorSignature Signed EIP712 hashstruct containing the deposit ID. Should be signed by the depositor\n * account.\n */\n function fillRelayWithUpdatedDeposit(\n V3RelayData calldata relayData,\n uint256 repaymentChainId,\n bytes32 repaymentAddress,\n uint256 updatedOutputAmount,\n bytes32 updatedRecipient,\n bytes calldata updatedMessage,\n bytes calldata depositorSignature\n ) public override nonReentrant unpausedFills {\n // Exclusivity deadline is inclusive and is the latest timestamp that the exclusive relayer has sole right\n // to fill the relay.\n if (\n _fillIsExclusive(relayData.exclusivityDeadline, uint32(getCurrentTime())) &&\n relayData.exclusiveRelayer.toAddress() != msg.sender\n ) {\n revert NotExclusiveRelayer();\n }\n\n V3RelayExecutionParams memory relayExecution = V3RelayExecutionParams({\n relay: relayData,\n relayHash: getV3RelayHash(relayData),\n updatedOutputAmount: updatedOutputAmount,\n updatedRecipient: updatedRecipient,\n updatedMessage: updatedMessage,\n repaymentChainId: repaymentChainId\n });\n\n _verifyUpdateV3DepositMessage(\n relayData.depositor.toAddress(),\n relayData.depositId,\n relayData.originChainId,\n updatedOutputAmount,\n updatedRecipient,\n updatedMessage,\n depositorSignature,\n UPDATE_BYTES32_DEPOSIT_DETAILS_HASH\n );\n\n _fillRelayV3(relayExecution, repaymentAddress, false);\n }\n\n /**\n * @notice Request Across to send LP funds to this contract to fulfill a slow fill relay\n * for a deposit in the next bundle.\n * @dev Slow fills are not possible unless the input and output tokens are \"equivalent\", i.e.\n * they route to the same L1 token via PoolRebalanceRoutes.\n * @dev Slow fills are created by inserting slow fill objects into a merkle tree that is included\n * in the next HubPool \"root bundle\". Once the optimistic challenge window has passed, the HubPool\n * will relay the slow root to this chain via relayRootBundle(). Once the slow root is relayed,\n * the slow fill can be executed by anyone who calls executeSlowRelayLeaf().\n * @dev Cannot request a slow fill if the fill deadline has passed.\n * @dev Cannot request a slow fill if the relay has already been filled or a slow fill has already been requested.\n * @param relayData struct containing all the data needed to identify the deposit that should be\n * slow filled. If any of the params are missing or different from the origin chain deposit,\n * then Across will not include a slow fill for the intended deposit.\n */\n function requestSlowFill(V3RelayData calldata relayData) public override nonReentrant unpausedFills {\n uint32 currentTime = uint32(getCurrentTime());\n // If a depositor has set an exclusivity deadline, then only the exclusive relayer should be able to\n // fast fill within this deadline. Moreover, the depositor should expect to get *fast* filled within\n // this deadline, not slow filled. As a simplifying assumption, we will not allow slow fills to be requested\n // during this exclusivity period.\n if (_fillIsExclusive(relayData.exclusivityDeadline, currentTime)) {\n revert NoSlowFillsInExclusivityWindow();\n }\n if (relayData.fillDeadline < currentTime) revert ExpiredFillDeadline();\n\n bytes32 relayHash = getV3RelayHash(relayData);\n if (fillStatuses[relayHash] != uint256(FillStatus.Unfilled)) revert InvalidSlowFillRequest();\n fillStatuses[relayHash] = uint256(FillStatus.RequestedSlowFill);\n\n emit RequestedSlowFill(\n relayData.inputToken,\n relayData.outputToken,\n relayData.inputAmount,\n relayData.outputAmount,\n relayData.originChainId,\n relayData.depositId,\n relayData.fillDeadline,\n relayData.exclusivityDeadline,\n relayData.exclusiveRelayer,\n relayData.depositor,\n relayData.recipient,\n _hashNonEmptyMessage(relayData.message)\n );\n }\n\n /**\n * @notice Fills a single leg of a particular order on the destination chain\n * @dev ERC-7683 fill function.\n * @param orderId Unique order identifier for this order\n * @param originData Data emitted on the origin to parameterize the fill\n * @param fillerData Data provided by the filler to inform the fill or express their preferences\n */\n function fill(\n bytes32 orderId,\n bytes calldata originData,\n bytes calldata fillerData\n ) external {\n if (keccak256(abi.encode(originData, chainId())) != orderId) {\n revert WrongERC7683OrderId();\n }\n\n // Ensure that the call is not malformed. If the call is malformed, abi.decode will fail.\n V3SpokePoolInterface.V3RelayData memory relayData = abi.decode(originData, (V3SpokePoolInterface.V3RelayData));\n AcrossDestinationFillerData memory destinationFillerData = abi.decode(\n fillerData,\n (AcrossDestinationFillerData)\n );\n\n // Must do a delegatecall because the function requires the inputs to be calldata.\n (bool success, bytes memory data) = address(this).delegatecall(\n abi.encodeCall(\n V3SpokePoolInterface.fillRelay,\n (relayData, destinationFillerData.repaymentChainId, msg.sender.toBytes32())\n )\n );\n if (!success) {\n revert LowLevelCallFailed(data);\n }\n }\n\n /**************************************\n * DATA WORKER FUNCTIONS *\n **************************************/\n\n /**\n * @notice Executes a slow relay leaf stored as part of a root bundle relayed by the HubPool.\n * @dev Executing a slow fill leaf is equivalent to filling the relayData so this function cannot be used to\n * double fill a recipient. The relayData that is filled is included in the slowFillLeaf and is hashed\n * like any other fill sent through a fill method.\n * @dev There is no relayer credited with filling this relay since funds are sent directly out of this contract.\n * @param slowFillLeaf Contains all data necessary to uniquely identify a relay for this chain. This struct is\n * hashed and included in a merkle root that is relayed to all spoke pools.\n * - relayData: struct containing all the data needed to identify the original deposit to be slow filled.\n * - chainId: chain identifier where slow fill leaf should be executed. If this doesn't match this chain's\n * chainId, then this function will revert.\n * - updatedOutputAmount: Amount to be sent to recipient out of this contract's balance. Can be set differently\n * from relayData.outputAmount to charge a different fee because this deposit was \"slow\" filled. Usually,\n * this will be set higher to reimburse the recipient for waiting for the slow fill.\n * @param rootBundleId Unique ID of root bundle containing slow relay root that this leaf is contained in.\n * @param proof Inclusion proof for this leaf in slow relay root in root bundle.\n */\n function executeSlowRelayLeaf(\n V3SlowFill calldata slowFillLeaf,\n uint32 rootBundleId,\n bytes32[] calldata proof\n ) public override nonReentrant {\n V3RelayData memory relayData = slowFillLeaf.relayData;\n\n _preExecuteLeafHook(relayData.outputToken.toAddress());\n\n // @TODO In the future consider allowing way for slow fill leaf to be created with updated\n // deposit params like outputAmount, message and recipient.\n V3RelayExecutionParams memory relayExecution = V3RelayExecutionParams({\n relay: relayData,\n relayHash: getV3RelayHash(relayData),\n updatedOutputAmount: slowFillLeaf.updatedOutputAmount,\n updatedRecipient: relayData.recipient,\n updatedMessage: relayData.message,\n repaymentChainId: EMPTY_REPAYMENT_CHAIN_ID // Repayment not relevant for slow fills.\n });\n\n _verifyV3SlowFill(relayExecution, rootBundleId, proof);\n\n // - No relayer to refund for slow fill executions.\n _fillRelayV3(relayExecution, EMPTY_RELAYER, true);\n }\n\n /**\n * @notice Executes a relayer refund leaf stored as part of a root bundle. Will send the relayer the amount they\n * sent to the recipient plus a relayer fee.\n * @param rootBundleId Unique ID of root bundle containing relayer refund root that this leaf is contained in.\n * @param relayerRefundLeaf Contains all data necessary to reconstruct leaf contained in root bundle and to\n * refund relayer. This data structure is explained in detail in the SpokePoolInterface.\n * @param proof Inclusion proof for this leaf in relayer refund root in root bundle.\n */\n function executeRelayerRefundLeaf(\n uint32 rootBundleId,\n SpokePoolInterface.RelayerRefundLeaf memory relayerRefundLeaf,\n bytes32[] memory proof\n ) public payable virtual override nonReentrant {\n _preExecuteLeafHook(relayerRefundLeaf.l2TokenAddress);\n\n if (relayerRefundLeaf.chainId != chainId()) revert InvalidChainId();\n\n RootBundle storage rootBundle = rootBundles[rootBundleId];\n\n // Check that proof proves that relayerRefundLeaf is contained within the relayer refund root.\n // Note: This should revert if the relayerRefundRoot is uninitialized.\n if (!MerkleLib.verifyRelayerRefund(rootBundle.relayerRefundRoot, relayerRefundLeaf, proof)) {\n revert InvalidMerkleProof();\n }\n\n _setClaimedLeaf(rootBundleId, relayerRefundLeaf.leafId);\n\n bool deferredRefunds = _distributeRelayerRefunds(\n relayerRefundLeaf.chainId,\n relayerRefundLeaf.amountToReturn,\n relayerRefundLeaf.refundAmounts,\n relayerRefundLeaf.leafId,\n relayerRefundLeaf.l2TokenAddress,\n relayerRefundLeaf.refundAddresses\n );\n\n emit ExecutedRelayerRefundRoot(\n relayerRefundLeaf.amountToReturn,\n relayerRefundLeaf.chainId,\n relayerRefundLeaf.refundAmounts,\n rootBundleId,\n relayerRefundLeaf.leafId,\n relayerRefundLeaf.l2TokenAddress,\n relayerRefundLeaf.refundAddresses,\n deferredRefunds,\n msg.sender\n );\n }\n\n /**\n * @notice Enables a relayer to claim outstanding repayments. Should virtually never be used, unless for some reason\n * relayer repayment transfer fails for reasons such as token transfer reverts due to blacklisting. In this case,\n * the relayer can still call this method and claim the tokens to a new address.\n * @param l2TokenAddress Address of the L2 token to claim refunds for.\n * @param refundAddress Address to send the refund to.\n */\n function claimRelayerRefund(bytes32 l2TokenAddress, bytes32 refundAddress) external {\n uint256 refund = relayerRefund[l2TokenAddress.toAddress()][msg.sender];\n if (refund == 0) revert NoRelayerRefundToClaim();\n relayerRefund[l2TokenAddress.toAddress()][msg.sender] = 0;\n IERC20Upgradeable(l2TokenAddress.toAddress()).safeTransfer(refundAddress.toAddress(), refund);\n\n emit ClaimedRelayerRefund(l2TokenAddress, refundAddress, refund, msg.sender);\n }\n\n /**************************************\n * VIEW FUNCTIONS *\n **************************************/\n\n /**\n * @notice Returns chain ID for this network.\n * @dev Some L2s like ZKSync don't support the CHAIN_ID opcode so we allow the implementer to override this.\n */\n function chainId() public view virtual override returns (uint256) {\n return block.chainid;\n }\n\n /**\n * @notice Gets the current time.\n * @return uint for the current timestamp.\n */\n function getCurrentTime() public view virtual returns (uint256) {\n return block.timestamp; // solhint-disable-line not-rely-on-time\n }\n\n /**\n * @notice Returns the deposit ID for an unsafe deposit. This function is used to compute the deposit ID\n * in unsafeDeposit and is provided as a convenience.\n * @dev msgSender and depositor are both used as inputs to allow passthrough depositors to create unique\n * deposit hash spaces for unique depositors.\n * @param msgSender The caller of the transaction used as input to produce the deposit ID.\n * @param depositor The depositor address used as input to produce the deposit ID.\n * @param depositNonce The nonce used as input to produce the deposit ID.\n * @return The deposit ID for the unsafe deposit.\n */\n function getUnsafeDepositId(\n address msgSender,\n bytes32 depositor,\n uint256 depositNonce\n ) public pure returns (uint256) {\n return uint256(keccak256(abi.encodePacked(msgSender, depositor, depositNonce)));\n }\n\n function getRelayerRefund(address l2TokenAddress, address refundAddress) public view returns (uint256) {\n return relayerRefund[l2TokenAddress][refundAddress];\n }\n\n function getV3RelayHash(V3RelayData memory relayData) public view returns (bytes32) {\n return keccak256(abi.encode(relayData, chainId()));\n }\n\n /**************************************\n * INTERNAL FUNCTIONS *\n **************************************/\n\n function _depositV3(DepositV3Params memory params) internal {\n // Verify depositor is a valid EVM address.\n params.depositor.checkAddress();\n\n // Require that quoteTimestamp has a maximum age so that depositors pay an LP fee based on recent HubPool usage.\n // It is assumed that cross-chain timestamps are normally loosely in-sync, but clock drift can occur. If the\n // SpokePool time stalls or lags significantly, it is still possible to make deposits by setting quoteTimestamp\n // within the configured buffer. The owner should pause deposits/fills if this is undesirable.\n // This will underflow if quoteTimestamp is more than depositQuoteTimeBuffer;\n // this is safe but will throw an unintuitive error.\n\n // slither-disable-next-line timestamp\n uint256 currentTime = getCurrentTime();\n if (currentTime < params.quoteTimestamp || currentTime - params.quoteTimestamp > depositQuoteTimeBuffer)\n revert InvalidQuoteTimestamp();\n\n // fillDeadline is relative to the destination chain.\n // Don’t allow fillDeadline to be more than several bundles into the future.\n // This limits the maximum required lookback for dataworker and relayer instances.\n if (params.fillDeadline > currentTime + fillDeadlineBuffer) revert InvalidFillDeadline();\n\n // There are three cases for setting the exclusivity deadline using the exclusivity parameter:\n // 1. If this parameter is 0, then there is no exclusivity period and emit 0 for the deadline. This\n // means that fillers of this deposit do not have to worry about the block.timestamp of this event changing\n // due to re-orgs when filling this deposit.\n // 2. If the exclusivity parameter is less than or equal to MAX_EXCLUSIVITY_PERIOD_SECONDS, then the exclusivity\n // deadline is set to the block.timestamp of this event plus the exclusivity parameter. This means that the\n // filler of this deposit assumes re-org risk when filling this deposit because the block.timestamp of this\n // event affects the exclusivity deadline.\n // 3. Otherwise, interpret this parameter as a timestamp and emit it as the exclusivity deadline. This means\n // that the filler of this deposit will not assume re-org risk related to the block.timestamp of this\n // event changing.\n uint32 exclusivityDeadline = params.exclusivityParameter;\n if (exclusivityDeadline > 0) {\n if (exclusivityDeadline <= MAX_EXCLUSIVITY_PERIOD_SECONDS) {\n exclusivityDeadline += uint32(currentTime);\n }\n\n // As a safety measure, prevent caller from inadvertently locking funds during exclusivity period\n // by forcing them to specify an exclusive relayer.\n if (params.exclusiveRelayer == bytes32(0)) revert InvalidExclusiveRelayer();\n }\n\n // If the address of the origin token is a wrappedNativeToken contract and there is a msg.value with the\n // transaction then the user is sending the native token. In this case, the native token should be\n // wrapped.\n if (params.inputToken == address(wrappedNativeToken).toBytes32() && msg.value > 0) {\n if (msg.value != params.inputAmount) revert MsgValueDoesNotMatchInputAmount();\n wrappedNativeToken.deposit{ value: msg.value }();\n // Else, it is a normal ERC20. In this case pull the token from the caller as per normal.\n // Note: this includes the case where the L2 caller has WETH (already wrapped ETH) and wants to bridge them.\n // In this case the msg.value will be set to 0, indicating a \"normal\" ERC20 bridging action.\n } else {\n // msg.value should be 0 if input token isn't the wrapped native token.\n if (msg.value != 0) revert MsgValueDoesNotMatchInputAmount();\n IERC20Upgradeable(params.inputToken.toAddress()).safeTransferFrom(\n msg.sender,\n address(this),\n params.inputAmount\n );\n }\n\n emit FundsDeposited(\n params.inputToken,\n params.outputToken,\n params.inputAmount,\n params.outputAmount,\n params.destinationChainId,\n params.depositId,\n params.quoteTimestamp,\n params.fillDeadline,\n exclusivityDeadline,\n params.depositor,\n params.recipient,\n params.exclusiveRelayer,\n params.message\n );\n }\n\n function _deposit(\n address depositor,\n address recipient,\n address originToken,\n uint256 amount,\n uint256 destinationChainId,\n int64 relayerFeePct,\n uint32 quoteTimestamp,\n bytes memory message\n ) internal {\n // We limit the relay fees to prevent the user spending all their funds on fees.\n if (SignedMath.abs(relayerFeePct) >= 0.5e18) revert InvalidRelayerFeePct();\n if (amount > MAX_TRANSFER_SIZE) revert MaxTransferSizeExceeded();\n\n // Require that quoteTimestamp has a maximum age so that depositors pay an LP fee based on recent HubPool usage.\n // It is assumed that cross-chain timestamps are normally loosely in-sync, but clock drift can occur. If the\n // SpokePool time stalls or lags significantly, it is still possible to make deposits by setting quoteTimestamp\n // within the configured buffer. The owner should pause deposits if this is undesirable. This will underflow if\n // quoteTimestamp is more than depositQuoteTimeBuffer; this is safe but will throw an unintuitive error.\n\n // slither-disable-next-line timestamp\n if (getCurrentTime() - quoteTimestamp > depositQuoteTimeBuffer) revert InvalidQuoteTimestamp();\n\n // Increment count of deposits so that deposit ID for this spoke pool is unique.\n uint32 newDepositId = numberOfDeposits++;\n\n // If the address of the origin token is a wrappedNativeToken contract and there is a msg.value with the\n // transaction then the user is sending ETH. In this case, the ETH should be deposited to wrappedNativeToken.\n if (originToken == address(wrappedNativeToken) && msg.value > 0) {\n if (msg.value != amount) revert MsgValueDoesNotMatchInputAmount();\n wrappedNativeToken.deposit{ value: msg.value }();\n // Else, it is a normal ERC20. In this case pull the token from the user's wallet as per normal.\n // Note: this includes the case where the L2 user has WETH (already wrapped ETH) and wants to bridge them.\n // In this case the msg.value will be set to 0, indicating a \"normal\" ERC20 bridging action.\n } else {\n IERC20Upgradeable(originToken).safeTransferFrom(msg.sender, address(this), amount);\n }\n\n emit FundsDeposited(\n originToken.toBytes32(), // inputToken\n bytes32(0), // outputToken. Setting this to 0x0 means that the outputToken should be assumed to be the\n // canonical token for the destination chain matching the inputToken. Therefore, this deposit\n // can always be slow filled.\n // - setting token to 0x0 will signal to off-chain validator that the \"equivalent\"\n // token as the inputToken for the destination chain should be replaced here.\n amount, // inputAmount\n _computeAmountPostFees(amount, relayerFeePct), // outputAmount\n // - output amount will be the deposit amount less relayerFeePct, which should now be set\n // equal to realizedLpFeePct + gasFeePct + capitalCostFeePct where (gasFeePct + capitalCostFeePct)\n // is equal to the old usage of `relayerFeePct`.\n destinationChainId,\n newDepositId,\n quoteTimestamp,\n INFINITE_FILL_DEADLINE, // fillDeadline. Default to infinite expiry because\n // expired deposits refunds could be a breaking change for existing users of this function.\n 0, // exclusivityDeadline. Setting this to 0 along with the exclusiveRelayer to 0x0 means that there\n // is no exclusive deadline\n depositor.toBytes32(),\n recipient.toBytes32(),\n bytes32(0), // exclusiveRelayer. Setting this to 0x0 will signal to off-chain validator that there\n // is no exclusive relayer.\n message\n );\n }\n\n function _distributeRelayerRefunds(\n uint256 _chainId,\n uint256 amountToReturn,\n uint256[] memory refundAmounts,\n uint32 leafId,\n address l2TokenAddress,\n address[] memory refundAddresses\n ) internal returns (bool deferredRefunds) {\n uint256 numRefunds = refundAmounts.length;\n if (refundAddresses.length != numRefunds) revert InvalidMerkleLeaf();\n\n if (numRefunds > 0) {\n uint256 spokeStartBalance = IERC20Upgradeable(l2TokenAddress).balanceOf(address(this));\n uint256 totalRefundedAmount = 0; // Track the total amount refunded.\n\n // Send each relayer refund address the associated refundAmount for the L2 token address.\n // Note: Even if the L2 token is not enabled on this spoke pool, we should still refund relayers.\n for (uint256 i = 0; i < numRefunds; ++i) {\n if (refundAmounts[i] > 0) {\n totalRefundedAmount += refundAmounts[i];\n\n // Only if the total refunded amount exceeds the spoke starting balance, should we revert. This\n // ensures that bundles are atomic, if we have sufficient balance to refund all relayers and\n // prevents can only re-pay some of the relayers.\n if (totalRefundedAmount > spokeStartBalance) revert InsufficientSpokePoolBalanceToExecuteLeaf();\n\n bool success = _noRevertTransfer(l2TokenAddress, refundAddresses[i], refundAmounts[i]);\n\n // If the transfer failed then track a deferred transfer for the relayer. Given this function would\n // have reverted if there was insufficient balance, this will only happen if the transfer call\n // reverts. This will only occur if the underlying transfer method on the l2Token reverts due to\n // recipient blacklisting or other related modifications to the l2Token.transfer method.\n if (!success) {\n relayerRefund[l2TokenAddress][refundAddresses[i]] += refundAmounts[i];\n deferredRefunds = true;\n }\n }\n }\n }\n // If leaf's amountToReturn is positive, then send L2 --> L1 message to bridge tokens back via\n // chain-specific bridging method.\n if (amountToReturn > 0) {\n _bridgeTokensToHubPool(amountToReturn, l2TokenAddress);\n\n emit TokensBridged(amountToReturn, _chainId, leafId, l2TokenAddress.toBytes32(), msg.sender);\n }\n }\n\n // Re-implementation of OZ _callOptionalReturnBool to use private logic. Function executes a transfer and returns a\n // bool indicating if the external call was successful, rather than reverting. Original method:\n // https://github.com/OpenZeppelin/openzeppelin-contracts/blob/28aed34dc5e025e61ea0390c18cac875bfde1a78/contracts/token/ERC20/utils/SafeERC20.sol#L188\n function _noRevertTransfer(\n address token,\n address to,\n uint256 amount\n ) internal returns (bool) {\n bool success;\n uint256 returnSize;\n uint256 returnValue;\n bytes memory data = abi.encodeCall(IERC20Upgradeable.transfer, (to, amount));\n assembly {\n success := call(gas(), token, 0, add(data, 0x20), mload(data), 0, 0x20)\n returnSize := returndatasize()\n returnValue := mload(0)\n }\n return success && (returnSize == 0 ? address(token).code.length > 0 : returnValue == 1);\n }\n\n function _setCrossDomainAdmin(address newCrossDomainAdmin) internal {\n if (newCrossDomainAdmin == address(0)) revert InvalidCrossDomainAdmin();\n crossDomainAdmin = newCrossDomainAdmin;\n emit SetXDomainAdmin(newCrossDomainAdmin);\n }\n\n function _setWithdrawalRecipient(address newWithdrawalRecipient) internal {\n if (newWithdrawalRecipient == address(0)) revert InvalidWithdrawalRecipient();\n withdrawalRecipient = newWithdrawalRecipient;\n emit SetWithdrawalRecipient(newWithdrawalRecipient);\n }\n\n function _preExecuteLeafHook(address) internal virtual {\n // This method by default is a no-op. Different child spoke pools might want to execute functionality here\n // such as wrapping any native tokens owned by the contract into wrapped tokens before proceeding with\n // executing the leaf.\n }\n\n // Should be overriden by implementing contract depending on how L2 handles sending tokens to L1.\n function _bridgeTokensToHubPool(uint256 amountToReturn, address l2TokenAddress) internal virtual;\n\n function _setClaimedLeaf(uint32 rootBundleId, uint32 leafId) internal {\n RootBundle storage rootBundle = rootBundles[rootBundleId];\n\n // Verify the leafId in the leaf has not yet been claimed.\n if (MerkleLib.isClaimed(rootBundle.claimedBitmap, leafId)) revert ClaimedMerkleLeaf();\n\n // Set leaf as claimed in bitmap. This is passed by reference to the storage rootBundle.\n MerkleLib.setClaimed(rootBundle.claimedBitmap, leafId);\n }\n\n function _verifyUpdateV3DepositMessage(\n address depositor,\n uint256 depositId,\n uint256 originChainId,\n uint256 updatedOutputAmount,\n bytes32 updatedRecipient,\n bytes memory updatedMessage,\n bytes memory depositorSignature,\n bytes32 hashType\n ) internal view {\n // A depositor can request to modify an un-relayed deposit by signing a hash containing the updated\n // details and information uniquely identifying the deposit to relay. This information ensures\n // that this signature cannot be re-used for other deposits.\n bytes32 expectedTypedDataV4Hash = _hashTypedDataV4(\n keccak256(\n abi.encode(\n hashType,\n depositId,\n originChainId,\n updatedOutputAmount,\n updatedRecipient,\n keccak256(updatedMessage)\n )\n ),\n originChainId\n );\n _verifyDepositorSignature(depositor, expectedTypedDataV4Hash, depositorSignature);\n }\n\n // This function is isolated and made virtual to allow different L2's to implement chain specific recovery of\n // signers from signatures because some L2s might not support ecrecover. To be safe, consider always reverting\n // this function for L2s where ecrecover is different from how it works on Ethereum, otherwise there is the\n // potential to forge a signature from the depositor using a different private key than the original depositor's.\n function _verifyDepositorSignature(\n address depositor,\n bytes32 ethSignedMessageHash,\n bytes memory depositorSignature\n ) internal view virtual {\n // Note:\n // - We don't need to worry about re-entrancy from a contract deployed at the depositor address since the method\n // `SignatureChecker.isValidSignatureNow` is a view method. Re-entrancy can happen, but it cannot affect state.\n // - EIP-1271 signatures are supported. This means that a signature valid now, may not be valid later and vice-versa.\n // - For an EIP-1271 signature to work, the depositor contract address must map to a deployed contract on the destination\n // chain that can validate the signature.\n // - Regular signatures from an EOA are also supported.\n bool isValid = SignatureChecker.isValidSignatureNow(depositor, ethSignedMessageHash, depositorSignature);\n if (!isValid) revert InvalidDepositorSignature();\n }\n\n function _verifyV3SlowFill(\n V3RelayExecutionParams memory relayExecution,\n uint32 rootBundleId,\n bytes32[] memory proof\n ) internal view {\n V3SlowFill memory slowFill = V3SlowFill({\n relayData: relayExecution.relay,\n chainId: chainId(),\n updatedOutputAmount: relayExecution.updatedOutputAmount\n });\n\n if (!MerkleLib.verifyV3SlowRelayFulfillment(rootBundles[rootBundleId].slowRelayRoot, slowFill, proof)) {\n revert InvalidMerkleProof();\n }\n }\n\n function _computeAmountPostFees(uint256 amount, int256 feesPct) private pure returns (uint256) {\n return (amount * uint256(int256(1e18) - feesPct)) / 1e18;\n }\n\n // Unwraps ETH and does a transfer to a recipient address. If the recipient is a smart contract then sends wrappedNativeToken.\n function _unwrapwrappedNativeTokenTo(address payable to, uint256 amount) internal {\n if (address(to).isContract()) {\n IERC20Upgradeable(address(wrappedNativeToken)).safeTransfer(to, amount);\n } else {\n wrappedNativeToken.withdraw(amount);\n AddressLibUpgradeable.sendValue(to, amount);\n }\n }\n\n // @param relayer: relayer who is actually credited as filling this deposit. Can be different from\n // exclusiveRelayer if passed exclusivityDeadline or if slow fill.\n function _fillRelayV3(\n V3RelayExecutionParams memory relayExecution,\n bytes32 relayer,\n bool isSlowFill\n ) internal {\n V3RelayData memory relayData = relayExecution.relay;\n\n if (relayData.fillDeadline < getCurrentTime()) revert ExpiredFillDeadline();\n\n bytes32 relayHash = relayExecution.relayHash;\n\n // If a slow fill for this fill was requested then the relayFills value for this hash will be\n // FillStatus.RequestedSlowFill. Therefore, if this is the status, then this fast fill\n // will be replacing the slow fill. If this is a slow fill execution, then the following variable\n // is trivially true. We'll emit this value in the FilledRelay\n // event to assist the Dataworker in knowing when to return funds back to the HubPool that can no longer\n // be used for a slow fill execution.\n FillType fillType = isSlowFill\n ? FillType.SlowFill // The following is true if this is a fast fill that was sent after a slow fill request.\n : (\n fillStatuses[relayExecution.relayHash] == uint256(FillStatus.RequestedSlowFill)\n ? FillType.ReplacedSlowFill\n : FillType.FastFill\n );\n\n // @dev This function doesn't support partial fills. Therefore, we associate the relay hash with\n // an enum tracking its fill status. All filled relays, whether slow or fast fills, are set to the Filled\n // status. However, we also use this slot to track whether this fill had a slow fill requested. Therefore\n // we can include a bool in the FilledRelay event making it easy for the dataworker to compute if this\n // fill was a fast fill that replaced a slow fill and therefore this SpokePool has excess funds that it\n // needs to send back to the HubPool.\n if (fillStatuses[relayHash] == uint256(FillStatus.Filled)) revert RelayFilled();\n fillStatuses[relayHash] = uint256(FillStatus.Filled);\n\n // @dev Before returning early, emit events to assist the dataworker in being able to know which fills were\n // successful.\n emit FilledRelay(\n relayData.inputToken,\n relayData.outputToken,\n relayData.inputAmount,\n relayData.outputAmount,\n relayExecution.repaymentChainId,\n relayData.originChainId,\n relayData.depositId,\n relayData.fillDeadline,\n relayData.exclusivityDeadline,\n relayData.exclusiveRelayer,\n relayer,\n relayData.depositor,\n relayData.recipient,\n _hashNonEmptyMessage(relayData.message),\n V3RelayExecutionEventInfo({\n updatedRecipient: relayExecution.updatedRecipient,\n updatedMessageHash: _hashNonEmptyMessage(relayExecution.updatedMessage),\n updatedOutputAmount: relayExecution.updatedOutputAmount,\n fillType: fillType\n })\n );\n\n address outputToken = relayData.outputToken.toAddress();\n uint256 amountToSend = relayExecution.updatedOutputAmount;\n address recipientToSend = relayExecution.updatedRecipient.toAddress();\n // If relay token is wrappedNativeToken then unwrap and send native token.\n // Stack too deep.\n if (relayData.outputToken.toAddress() == address(wrappedNativeToken)) {\n // Note: useContractFunds is True if we want to send funds to the recipient directly out of this contract,\n // otherwise we expect the caller to send funds to the recipient. If useContractFunds is True and the\n // recipient wants wrappedNativeToken, then we can assume that wrappedNativeToken is already in the\n // contract, otherwise we'll need the user to send wrappedNativeToken to this contract. Regardless, we'll\n // need to unwrap it to native token before sending to the user.\n if (!isSlowFill) IERC20Upgradeable(outputToken).safeTransferFrom(msg.sender, address(this), amountToSend);\n _unwrapwrappedNativeTokenTo(payable(recipientToSend), amountToSend);\n // Else, this is a normal ERC20 token. Send to recipient.\n } else {\n // Note: Similar to note above, send token directly from the contract to the user in the slow relay case.\n if (!isSlowFill) IERC20Upgradeable(outputToken).safeTransferFrom(msg.sender, recipientToSend, amountToSend);\n else IERC20Upgradeable(outputToken).safeTransfer(recipientToSend, amountToSend);\n }\n\n bytes memory updatedMessage = relayExecution.updatedMessage;\n if (updatedMessage.length > 0 && recipientToSend.isContract()) {\n AcrossMessageHandler(recipientToSend).handleV3AcrossMessage(\n outputToken,\n amountToSend,\n msg.sender,\n updatedMessage\n );\n }\n }\n\n // Determine whether the exclusivityDeadline implies active exclusivity.\n function _fillIsExclusive(uint32 exclusivityDeadline, uint32 currentTime) internal pure returns (bool) {\n return exclusivityDeadline >= currentTime;\n }\n\n // Helper for emitting message hash. For easier easier human readability we return bytes32(0) for empty message.\n function _hashNonEmptyMessage(bytes memory message) internal pure returns (bytes32) {\n if (message.length == 0) return bytes32(0);\n else return keccak256(message);\n }\n\n // Implementing contract needs to override this to ensure that only the appropriate cross chain admin can execute\n // certain admin functions. For L2 contracts, the cross chain admin refers to some L1 address or contract, and for\n // L1, this would just be the same admin of the HubPool.\n function _requireAdminSender() internal virtual;\n\n // Added to enable the this contract to receive native token (ETH). Used when unwrapping wrappedNativeToken.\n receive() external payable {}\n\n // Reserve storage slots for future versions of this base contract to add state variables without\n // affecting the storage layout of child contracts. Decrement the size of __gap whenever state variables\n // are added. This is at bottom of contract to make sure it's always at the end of storage.\n uint256[998] private __gap;\n}\n"
- },
- "contracts/test/MockBedrockStandardBridge.sol": {
- "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\n\nimport \"../Ovm_SpokePool.sol\";\n\n// Provides payable withdrawTo interface introduced on Bedrock\ncontract MockBedrockL2StandardBridge is IL2ERC20Bridge {\n event ERC20WithdrawalInitiated(address indexed l2Token, address indexed to, uint256 amount);\n\n function withdrawTo(\n address _l2Token,\n address _to,\n uint256 _amount,\n uint32,\n bytes calldata\n ) external payable {\n emit ERC20WithdrawalInitiated(_l2Token, _to, _amount);\n }\n\n function bridgeERC20To(\n address _localToken,\n address _remoteToken,\n address _to,\n uint256 _amount,\n uint32,\n bytes calldata\n ) external {\n // Check that caller has approved this contract to pull funds, mirroring mainnet's behavior\n IERC20(_localToken).transferFrom(msg.sender, address(this), _amount);\n IERC20(_remoteToken).transfer(_to, _amount);\n }\n}\n\ncontract MockBedrockL1StandardBridge {\n event ETHDepositInitiated(address indexed to, uint256 amount);\n event ERC20DepositInitiated(address indexed to, address l1Token, address l2Token, uint256 amount);\n\n function depositERC20To(\n address l1Token,\n address l2Token,\n address to,\n uint256 amount,\n uint32,\n bytes calldata\n ) external {\n IERC20(l1Token).transferFrom(msg.sender, address(this), amount);\n emit ERC20DepositInitiated(to, l1Token, l2Token, amount);\n }\n\n function depositETHTo(\n address to,\n uint32,\n bytes calldata\n ) external payable {\n emit ETHDepositInitiated(to, msg.value);\n }\n}\n\ncontract MockBedrockCrossDomainMessenger {\n event MessageSent(address indexed target);\n\n address private msgSender;\n\n function sendMessage(\n address target,\n bytes calldata,\n uint32\n ) external {\n emit MessageSent(target);\n }\n\n // Impersonates making a call on L2 from L1.\n function impersonateCall(address target, bytes memory data) external payable returns (bytes memory) {\n msgSender = msg.sender;\n (bool success, bytes memory returnData) = target.call{ value: msg.value }(data);\n\n // Revert if call reverted.\n if (!success) {\n assembly {\n revert(add(32, returnData), mload(returnData))\n }\n }\n return returnData;\n }\n\n function xDomainMessageSender() external view returns (address) {\n return msgSender;\n }\n}\n"
- },
- "contracts/test/MockCCTP.sol": {
- "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\n\nimport \"../libraries/CircleCCTPAdapter.sol\";\n\ncontract MockCCTPMinter is ITokenMinter {\n function burnLimitsPerMessage(address) external pure returns (uint256) {\n return type(uint256).max;\n }\n}\n\ncontract MockCCTPMessenger is ITokenMessenger {\n ITokenMinter private minter;\n\n constructor(ITokenMinter _minter) {\n minter = _minter;\n }\n\n function depositForBurn(\n uint256,\n uint32,\n bytes32,\n address\n ) external pure returns (uint64 _nonce) {\n return 0;\n }\n\n function localMinter() external view returns (ITokenMinter) {\n return minter;\n }\n}\n"
- },
- "contracts/test/MockOptimism_SpokePool.sol": {
- "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\nimport \"../Ovm_SpokePool.sol\";\n\n/**\n * @notice Mock Optimism Spoke pool allowing deployer to override constructor params.\n */\ncontract MockOptimism_SpokePool is Ovm_SpokePool {\n /// @custom:oz-upgrades-unsafe-allow constructor\n constructor(address _wrappedNativeTokenAddress)\n Ovm_SpokePool(_wrappedNativeTokenAddress, 1 hours, 9 hours, IERC20(address(0)), ITokenMessenger(address(0)))\n {} // solhint-disable-line no-empty-blocks\n\n function initialize(\n address l2Eth,\n uint32 _initialDepositId,\n address _crossDomainAdmin,\n address _hubPool\n ) public initializer {\n __OvmSpokePool_init(_initialDepositId, _crossDomainAdmin, _hubPool, l2Eth);\n }\n}\n"
- },
- "contracts/upgradeable/AddressLibUpgradeable.sol": {
- "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (utils/Address.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @title AddressUpgradeable\n * @dev Collection of functions related to the address type\n * @notice Logic is 100% copied from \"@openzeppelin/contracts-upgradeable/contracts/utils/AddressUpgradeable.sol\" but one\n * comment is added to clarify why we allow delegatecall() in this contract, which is typically unsafe for use in\n * upgradeable implementation contracts.\n * @dev See https://docs.openzeppelin.com/upgrades-plugins/1.x/faq#delegatecall-selfdestruct for more details.\n * @custom:security-contact bugs@across.to\n */\nlibrary AddressLibUpgradeable {\n /**\n * @dev Returns true if `account` is a contract.\n *\n * [IMPORTANT]\n * ====\n * It is unsafe to assume that an address for which this function returns\n * false is an externally-owned account (EOA) and not a contract.\n *\n * Among others, `isContract` will return false for the following\n * types of addresses:\n *\n * - an externally-owned account\n * - a contract in construction\n * - an address where a contract will be created\n * - an address where a contract lived, but was destroyed\n *\n * Furthermore, `isContract` will also return true if the target contract within\n * the same transaction is already scheduled for destruction by `SELFDESTRUCT`,\n * which only has an effect at the end of a transaction.\n * ====\n *\n * [IMPORTANT]\n * ====\n * You shouldn't rely on `isContract` to protect against flash loan attacks!\n *\n * Preventing calls from contracts is highly discouraged. It breaks composability, breaks support for smart wallets\n * like Gnosis Safe, and does not provide security since it can be circumvented by calling from a contract\n * constructor.\n * ====\n */\n function isContract(address account) internal view returns (bool) {\n // This method relies on extcodesize/address.code.length, which returns 0\n // for contracts in construction, since the code is only stored at the end\n // of the constructor execution.\n\n return account.code.length > 0;\n }\n\n /**\n * @dev Replacement for Solidity's `transfer`: sends `amount` wei to\n * `recipient`, forwarding all available gas and reverting on errors.\n *\n * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost\n * of certain opcodes, possibly making contracts go over the 2300 gas limit\n * imposed by `transfer`, making them unable to receive funds via\n * `transfer`. {sendValue} removes this limitation.\n *\n * https://consensys.net/diligence/blog/2019/09/stop-using-soliditys-transfer-now/[Learn more].\n *\n * IMPORTANT: because control is transferred to `recipient`, care must be\n * taken to not create reentrancy vulnerabilities. Consider using\n * {ReentrancyGuard} or the\n * https://solidity.readthedocs.io/en/v0.8.0/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].\n */\n function sendValue(address payable recipient, uint256 amount) internal {\n require(address(this).balance >= amount, \"Address: insufficient balance\");\n\n (bool success, ) = recipient.call{ value: amount }(\"\");\n require(success, \"Address: unable to send value, recipient may have reverted\");\n }\n\n /**\n * @dev Performs a Solidity function call using a low level `call`. A\n * plain `call` is an unsafe replacement for a function call: use this\n * function instead.\n *\n * If `target` reverts with a revert reason, it is bubbled up by this\n * function (like regular Solidity function calls).\n *\n * Returns the raw returned data. To convert to the expected return value,\n * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].\n *\n * Requirements:\n *\n * - `target` must be a contract.\n * - calling `target` with `data` must not revert.\n *\n * _Available since v3.1._\n */\n function functionCall(address target, bytes memory data) internal returns (bytes memory) {\n return functionCallWithValue(target, data, 0, \"Address: low-level call failed\");\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with\n * `errorMessage` as a fallback revert reason when `target` reverts.\n *\n * _Available since v3.1._\n */\n function functionCall(\n address target,\n bytes memory data,\n string memory errorMessage\n ) internal returns (bytes memory) {\n return functionCallWithValue(target, data, 0, errorMessage);\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\n * but also transferring `value` wei to `target`.\n *\n * Requirements:\n *\n * - the calling contract must have an ETH balance of at least `value`.\n * - the called Solidity function must be `payable`.\n *\n * _Available since v3.1._\n */\n function functionCallWithValue(\n address target,\n bytes memory data,\n uint256 value\n ) internal returns (bytes memory) {\n return functionCallWithValue(target, data, value, \"Address: low-level call with value failed\");\n }\n\n /**\n * @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but\n * with `errorMessage` as a fallback revert reason when `target` reverts.\n *\n * _Available since v3.1._\n */\n function functionCallWithValue(\n address target,\n bytes memory data,\n uint256 value,\n string memory errorMessage\n ) internal returns (bytes memory) {\n require(address(this).balance >= value, \"Address: insufficient balance for call\");\n (bool success, bytes memory returndata) = target.call{ value: value }(data);\n return verifyCallResultFromTarget(target, success, returndata, errorMessage);\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\n * but performing a static call.\n *\n * _Available since v3.3._\n */\n function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {\n return functionStaticCall(target, data, \"Address: low-level static call failed\");\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],\n * but performing a static call.\n *\n * _Available since v3.3._\n */\n function functionStaticCall(\n address target,\n bytes memory data,\n string memory errorMessage\n ) internal view returns (bytes memory) {\n (bool success, bytes memory returndata) = target.staticcall(data);\n return verifyCallResultFromTarget(target, success, returndata, errorMessage);\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\n * but performing a delegate call.\n *\n * _Available since v3.4._\n */\n function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) {\n return functionDelegateCall(target, data, \"Address: low-level delegate call failed\");\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],\n * but performing a delegate call.\n *\n * _Available since v3.4._\n */\n function functionDelegateCall(\n address target,\n bytes memory data,\n string memory errorMessage\n ) internal returns (bytes memory) {\n /// @custom:oz-upgrades-unsafe-allow delegatecall\n (bool success, bytes memory returndata) = target.delegatecall(data);\n return verifyCallResultFromTarget(target, success, returndata, errorMessage);\n }\n\n /**\n * @dev Tool to verify that a low level call to smart-contract was successful, and revert (either by bubbling\n * the revert reason or using the provided one) in case of unsuccessful call or if target was not a contract.\n *\n * _Available since v4.8._\n */\n function verifyCallResultFromTarget(\n address target,\n bool success,\n bytes memory returndata,\n string memory errorMessage\n ) internal view returns (bytes memory) {\n if (success) {\n if (returndata.length == 0) {\n // only check isContract if the call was successful and the return data is empty\n // otherwise we already know that it was a contract\n require(isContract(target), \"Address: call to non-contract\");\n }\n return returndata;\n } else {\n _revert(returndata, errorMessage);\n }\n }\n\n /**\n * @dev Tool to verify that a low level call was successful, and revert if it wasn't, either by bubbling the\n * revert reason or using the provided one.\n *\n * _Available since v4.3._\n */\n function verifyCallResult(\n bool success,\n bytes memory returndata,\n string memory errorMessage\n ) internal pure returns (bytes memory) {\n if (success) {\n return returndata;\n } else {\n _revert(returndata, errorMessage);\n }\n }\n\n function _revert(bytes memory returndata, string memory errorMessage) private pure {\n // Look for revert reason and bubble it up if present\n if (returndata.length > 0) {\n // The easiest way to bubble the revert reason is using memory via assembly\n /// @solidity memory-safe-assembly\n assembly {\n let returndata_size := mload(returndata)\n revert(add(32, returndata), returndata_size)\n }\n } else {\n revert(errorMessage);\n }\n }\n}\n"
- },
- "contracts/upgradeable/EIP712CrossChainUpgradeable.sol": {
- "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\n\nimport \"@openzeppelin/contracts-upgradeable/utils/cryptography/ECDSAUpgradeable.sol\";\nimport \"@openzeppelin/contracts-upgradeable/proxy/utils/Initializable.sol\";\n\n/**\n * @dev https://eips.ethereum.org/EIPS/eip-712[EIP 712] is a standard for hashing and signing of typed structured data.\n *\n * This contract is based on OpenZeppelin's implementation:\n * https://github.com/OpenZeppelin/openzeppelin-contracts-upgradeable/blob/master/contracts/utils/cryptography/EIP712Upgradeable.sol\n *\n * NOTE: Modified version that allows to build a domain separator that relies on a different chain id than the chain this\n * contract is deployed to. An example use case we want to support is:\n * - User A signs a message on chain with id = 1\n * - User B executes a method by verifying user A's EIP-712 compliant signature on a chain with id != 1\n * @custom:security-contact bugs@across.to\n */\nabstract contract EIP712CrossChainUpgradeable is Initializable {\n /* solhint-disable var-name-mixedcase */\n bytes32 private _HASHED_NAME;\n bytes32 private _HASHED_VERSION;\n bytes32 private constant _TYPE_HASH = keccak256(\"EIP712Domain(string name,string version,uint256 chainId)\");\n\n /* solhint-enable var-name-mixedcase */\n\n /**\n * @dev Initializes the domain separator and parameter caches.\n *\n * The meaning of `name` and `version` is specified in\n * https://eips.ethereum.org/EIPS/eip-712#definition-of-domainseparator[EIP 712]:\n *\n * - `name`: the user readable name of the signing domain, i.e. the name of the DApp or the protocol.\n * - `version`: the current major version of the signing domain.\n *\n * NOTE: These parameters cannot be changed except through a xref:learn::upgrading-smart-contracts.adoc[smart\n * contract upgrade].\n */\n function __EIP712_init(string memory name, string memory version) internal onlyInitializing {\n __EIP712_init_unchained(name, version);\n }\n\n function __EIP712_init_unchained(string memory name, string memory version) internal onlyInitializing {\n bytes32 hashedName = keccak256(bytes(name));\n bytes32 hashedVersion = keccak256(bytes(version));\n _HASHED_NAME = hashedName;\n _HASHED_VERSION = hashedVersion;\n }\n\n /**\n * @dev Returns the domain separator depending on the `originChainId`.\n * @param originChainId Chain id of network where message originates from.\n * @return bytes32 EIP-712-compliant domain separator.\n */\n function _domainSeparatorV4(uint256 originChainId) internal view returns (bytes32) {\n return keccak256(abi.encode(_TYPE_HASH, _HASHED_NAME, _HASHED_VERSION, originChainId));\n }\n\n /**\n * @dev Given an already https://eips.ethereum.org/EIPS/eip-712#definition-of-hashstruct[hashed struct], this\n * function returns the hash of the fully encoded EIP712 message for this domain.\n *\n * This hash can be used together with {ECDSA-recover} to obtain the signer of a message. For example:\n *\n * ```solidity\n * bytes32 structHash = keccak256(abi.encode(\n * keccak256(\"Mail(address to,string contents)\"),\n * mailTo,\n * keccak256(bytes(mailContents))\n * ));\n * bytes32 digest = _hashTypedDataV4(structHash, originChainId);\n * address signer = ECDSA.recover(digest, signature);\n * ```\n * @param structHash Hashed struct as defined in https://eips.ethereum.org/EIPS/eip-712#definition-of-hashstruct.\n * @param originChainId Chain id of network where message originates from.\n * @return bytes32 Hash digest that is recoverable via `EDCSA.recover`.\n */\n function _hashTypedDataV4(bytes32 structHash, uint256 originChainId) internal view virtual returns (bytes32) {\n return ECDSAUpgradeable.toTypedDataHash(_domainSeparatorV4(originChainId), structHash);\n }\n\n // Reserve storage slots for future versions of this base contract to add state variables without\n // affecting the storage layout of child contracts. Decrement the size of __gap whenever state variables\n // are added. This is at bottom of contract to make sure it's always at the end of storage.\n uint256[1000] private __gap;\n}\n"
- },
- "contracts/upgradeable/MultiCallerUpgradeable.sol": {
- "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\n\n/**\n * @title MultiCallerUpgradeable\n * @notice Logic is 100% copied from \"@uma/core/contracts/common/implementation/MultiCaller.sol\" but one\n * comment is added to clarify why we allow delegatecall() in this contract, which is typically unsafe for use in\n * upgradeable implementation contracts.\n * @dev See https://docs.openzeppelin.com/upgrades-plugins/1.x/faq#delegatecall-selfdestruct for more details.\n * @custom:security-contact bugs@across.to\n */\ncontract MultiCallerUpgradeable {\n struct Result {\n bool success;\n bytes returnData;\n }\n\n function _validateMulticallData(bytes[] calldata data) internal virtual {\n // no-op\n }\n\n function multicall(bytes[] calldata data) external returns (bytes[] memory results) {\n _validateMulticallData(data);\n\n uint256 dataLength = data.length;\n results = new bytes[](dataLength);\n\n //slither-disable-start calls-loop\n for (uint256 i = 0; i < dataLength; ++i) {\n // Typically, implementation contracts used in the upgradeable proxy pattern shouldn't call `delegatecall`\n // because it could allow a malicious actor to call this implementation contract directly (rather than\n // through a proxy contract) and then selfdestruct() the contract, thereby freezing the upgradeable\n // proxy. However, since we're only delegatecall-ing into this contract, then we can consider this\n // use of delegatecall() safe.\n\n //slither-disable-start low-level-calls\n /// @custom:oz-upgrades-unsafe-allow delegatecall\n (bool success, bytes memory result) = address(this).delegatecall(data[i]);\n //slither-disable-end low-level-calls\n\n if (!success) {\n // Next 5 lines from https://ethereum.stackexchange.com/a/83577\n if (result.length < 68) revert();\n //slither-disable-next-line assembly\n assembly {\n result := add(result, 0x04)\n }\n revert(abi.decode(result, (string)));\n }\n\n results[i] = result;\n }\n //slither-disable-end calls-loop\n }\n\n function tryMulticall(bytes[] calldata data) external returns (Result[] memory results) {\n _validateMulticallData(data);\n\n uint256 dataLength = data.length;\n results = new Result[](dataLength);\n\n //slither-disable-start calls-loop\n for (uint256 i = 0; i < dataLength; ++i) {\n // The delegatecall here is safe for the same reasons outlined in the first multicall function.\n Result memory result = results[i];\n //slither-disable-start low-level-calls\n /// @custom:oz-upgrades-unsafe-allow delegatecall\n (result.success, result.returnData) = address(this).delegatecall(data[i]);\n //slither-disable-end low-level-calls\n }\n //slither-disable-end calls-loop\n }\n\n // Reserve storage slots for future versions of this base contract to add state variables without\n // affecting the storage layout of child contracts. Decrement the size of __gap whenever state variables\n // are added. This is at bottom of contract to make sure its always at the end of storage.\n uint256[1000] private __gap;\n}\n"
- },
- "contracts/ZkSync_SpokePool.sol": {
- "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\n\nimport \"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\";\nimport { CircleCCTPAdapter, CircleDomainIds, ITokenMessenger } from \"./libraries/CircleCCTPAdapter.sol\";\nimport { CrossDomainAddressUtils } from \"./libraries/CrossDomainAddressUtils.sol\";\nimport \"./SpokePool.sol\";\n\n// https://github.com/matter-labs/era-contracts/blob/6391c0d7bf6184d7f6718060e3991ba6f0efe4a7/zksync/contracts/bridge/L2ERC20Bridge.sol#L104\ninterface ZkBridgeLike {\n function withdraw(\n address _l1Receiver,\n address _l2Token,\n uint256 _amount\n ) external;\n}\n\ninterface IL2ETH {\n function withdraw(address _l1Receiver) external payable;\n}\n\n/**\n * @notice ZkSync specific SpokePool, intended to be compiled with `@matterlabs/hardhat-zksync-solc`.\n * @dev Resources for compiling and deploying contracts with hardhat: https://era.zksync.io/docs/tools/hardhat/hardhat-zksync-solc.html\n * @custom:security-contact bugs@across.to\n */\ncontract ZkSync_SpokePool is SpokePool, CircleCCTPAdapter {\n using SafeERC20 for IERC20;\n\n // On Ethereum, avoiding constructor parameters and putting them into constants reduces some of the gas cost\n // upon contract deployment. On zkSync the opposite is true: deploying the same bytecode for contracts,\n // while changing only constructor parameters can lead to substantial fee savings. So, the following params\n // are all set by passing in constructor params where possible.\n\n // ETH on ZkSync implements a subset of the ERC-20 interface, with additional built-in support to bridge to L1.\n address public l2Eth;\n\n // Bridge used to withdraw ERC20's to L1\n ZkBridgeLike public zkErc20Bridge;\n /// @custom:oz-upgrades-unsafe-allow state-variable-immutable\n ZkBridgeLike public immutable zkUSDCBridge;\n\n event SetZkBridge(address indexed erc20Bridge, address indexed oldErc20Bridge);\n\n error InvalidBridgeConfig();\n\n /**\n * @notice Constructor.\n * @notice Circle bridged & native USDC are optionally supported via configuration, but are mutually exclusive.\n * @param _wrappedNativeTokenAddress wrappedNativeToken address for this network to set.\n * @param _circleUSDC Circle USDC address on the SpokePool. Set to 0x0 to use the standard ERC20 bridge instead.\n * If not set to zero, then either the zkUSDCBridge or cctpTokenMessenger must be set and will be used to\n * bridge this token.\n * @param _zkUSDCBridge Elastic chain custom bridge address for USDC (if deployed, or address(0) to disable).\n * @param _cctpTokenMessenger TokenMessenger contract to bridge via CCTP. If the zero address is passed, CCTP bridging will be disabled.\n * @param _depositQuoteTimeBuffer depositQuoteTimeBuffer to set. Quote timestamps can't be set more than this amount\n * into the past from the block time of the deposit.\n * @param _fillDeadlineBuffer fillDeadlineBuffer to set. Fill deadlines can't be set more than this amount\n * into the future from the block time of the deposit.\n */\n /// @custom:oz-upgrades-unsafe-allow constructor\n constructor(\n address _wrappedNativeTokenAddress,\n IERC20 _circleUSDC,\n ZkBridgeLike _zkUSDCBridge,\n ITokenMessenger _cctpTokenMessenger,\n uint32 _depositQuoteTimeBuffer,\n uint32 _fillDeadlineBuffer\n )\n SpokePool(_wrappedNativeTokenAddress, _depositQuoteTimeBuffer, _fillDeadlineBuffer)\n CircleCCTPAdapter(_circleUSDC, _cctpTokenMessenger, CircleDomainIds.Ethereum)\n {\n address zero = address(0);\n if (address(_circleUSDC) != zero) {\n bool zkUSDCBridgeDisabled = address(_zkUSDCBridge) == zero;\n bool cctpUSDCBridgeDisabled = address(_cctpTokenMessenger) == zero;\n // Bridged and Native USDC are mutually exclusive.\n if (zkUSDCBridgeDisabled == cctpUSDCBridgeDisabled) {\n revert InvalidBridgeConfig();\n }\n }\n\n zkUSDCBridge = _zkUSDCBridge;\n }\n\n /**\n * @notice Initialize the ZkSync SpokePool.\n * @param _initialDepositId Starting deposit ID. Set to 0 unless this is a re-deployment in order to mitigate\n * relay hash collisions.\n * @param _zkErc20Bridge Address of L2 ERC20 gateway. Can be reset by admin.\n * @param _crossDomainAdmin Cross domain admin to set. Can be changed by admin.\n * @param _withdrawalRecipient Address which receives token withdrawals. Can be changed by admin. For Spoke Pools on L2, this will\n * likely be the hub pool.\n */\n function initialize(\n uint32 _initialDepositId,\n ZkBridgeLike _zkErc20Bridge,\n address _crossDomainAdmin,\n address _withdrawalRecipient\n ) public initializer {\n l2Eth = 0x000000000000000000000000000000000000800A;\n __SpokePool_init(_initialDepositId, _crossDomainAdmin, _withdrawalRecipient);\n _setZkBridge(_zkErc20Bridge);\n }\n\n modifier onlyFromCrossDomainAdmin() {\n require(msg.sender == CrossDomainAddressUtils.applyL1ToL2Alias(crossDomainAdmin), \"ONLY_COUNTERPART_GATEWAY\");\n _;\n }\n\n /********************************************************\n * ZKSYNC-SPECIFIC CROSS-CHAIN ADMIN FUNCTIONS *\n ********************************************************/\n\n /**\n * @notice Change L2 token bridge addresses. Callable only by admin.\n * @param _zkErc20Bridge New address of L2 ERC20 gateway.\n */\n function setZkBridge(ZkBridgeLike _zkErc20Bridge) public onlyAdmin nonReentrant {\n _setZkBridge(_zkErc20Bridge);\n }\n\n /**************************************\n * INTERNAL FUNCTIONS *\n **************************************/\n\n /**\n * @notice Wraps any ETH into WETH before executing base function. This is necessary because SpokePool receives\n * ETH over the canonical token bridge instead of WETH.\n */\n function _preExecuteLeafHook(address l2TokenAddress) internal override {\n if (l2TokenAddress == address(wrappedNativeToken)) _depositEthToWeth();\n }\n\n // Wrap any ETH owned by this contract so we can send expected L2 token to recipient. This is necessary because\n // this SpokePool will receive ETH from the canonical token bridge instead of WETH. This may not be neccessary\n // if ETH on ZkSync is treated as ETH and the fallback() function is triggered when this contract receives\n // ETH. We will have to test this but this function for now allows the contract to safely convert all of its\n // held ETH into WETH at the cost of higher gas costs.\n function _depositEthToWeth() internal {\n //slither-disable-next-line arbitrary-send-eth\n if (address(this).balance > 0) wrappedNativeToken.deposit{ value: address(this).balance }();\n }\n\n function _bridgeTokensToHubPool(uint256 amountToReturn, address l2TokenAddress) internal override {\n // SpokePool is expected to receive ETH from the L1 HubPool and currently, withdrawing ETH directly\n // over the ERC20 Bridge is blocked at the contract level. Therefore, we need to unwrap it before withdrawing.\n if (l2TokenAddress == address(wrappedNativeToken)) {\n WETH9Interface(l2TokenAddress).withdraw(amountToReturn); // Unwrap into ETH.\n // To withdraw tokens, we actually call 'withdraw' on the L2 eth token itself.\n IL2ETH(l2Eth).withdraw{ value: amountToReturn }(withdrawalRecipient);\n } else if (l2TokenAddress == address(usdcToken)) {\n if (_isCCTPEnabled()) {\n // Circle native USDC via CCTP.\n _transferUsdc(withdrawalRecipient, amountToReturn);\n } else {\n // Matter Labs custom USDC bridge for Circle Bridged (upgradable) USDC.\n IERC20(l2TokenAddress).forceApprove(address(zkUSDCBridge), amountToReturn);\n zkUSDCBridge.withdraw(withdrawalRecipient, l2TokenAddress, amountToReturn);\n }\n } else {\n zkErc20Bridge.withdraw(withdrawalRecipient, l2TokenAddress, amountToReturn);\n }\n }\n\n function _setZkBridge(ZkBridgeLike _zkErc20Bridge) internal {\n address oldErc20Bridge = address(zkErc20Bridge);\n zkErc20Bridge = _zkErc20Bridge;\n emit SetZkBridge(address(_zkErc20Bridge), oldErc20Bridge);\n }\n\n function _requireAdminSender() internal override onlyFromCrossDomainAdmin {}\n\n // Reserve storage slots for future versions of this base contract to add state variables without\n // affecting the storage layout of child contracts. Decrement the size of __gap whenever state variables\n // are added. This is at bottom of contract to make sure its always at the end of storage.\n uint256[999] private __gap;\n}\n"
- }
- },
- "settings": {
- "optimizer": {
- "enabled": true,
- "runs": 1000000
- },
- "viaIR": true,
- "debug": {
- "revertStrings": "strip"
- },
- "outputSelection": {
- "*": {
- "*": [
- "abi",
- "evm.bytecode",
- "evm.deployedBytecode",
- "evm.methodIdentifiers",
- "metadata",
- "devdoc",
- "userdoc",
- "storageLayout",
- "evm.gasEstimates"
- ],
- "": ["ast"]
- }
- },
- "metadata": {
- "useLiteralContent": true
- }
- }
-}
From 13766ae06d2de2c27678a122cdf9962fe6256878 Mon Sep 17 00:00:00 2001
From: Paul <108695806+pxrl@users.noreply.github.com>
Date: Tue, 23 Dec 2025 13:28:45 +0000
Subject: [PATCH 3/6] Drop redundant changes
---
broadcast/deployed-addresses.md | 16 ++++++++--------
generated/constants.json | 13 ++++++-------
2 files changed, 14 insertions(+), 15 deletions(-)
diff --git a/broadcast/deployed-addresses.md b/broadcast/deployed-addresses.md
index bdc44b1f5..b4d151f85 100644
--- a/broadcast/deployed-addresses.md
+++ b/broadcast/deployed-addresses.md
@@ -115,14 +115,14 @@ This file contains the latest deployed smart contract addresses from the broadca
## Monad (143)
-| Contract Name | Address |
-| ------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
-| Helios | [0x09aea4b2242abC8bb4BB78D537A67a245A7bEC64](https://monadvision.com/address/0x09aea4b2242abC8bb4BB78D537A67a245A7bEC64) |
-| MulticallHandler | [0xeC41F75c686e376Ab2a4F18bde263ab5822c4511](https://monadvision.com/address/0xeC41F75c686e376Ab2a4F18bde263ab5822c4511) |
-| SpokePool | [0xd2ecb3afe598b746F8123CaE365a598DA831A449](https://monadvision.com/address/0xd2ecb3afe598b746F8123CaE365a598DA831A449) |
-| SpokePoolPeriphery | [0xe9b0666DFfC176Df6686726CB9aaC78fD83D20d7](https://monadvision.com/address/0xe9b0666DFfC176Df6686726CB9aaC78fD83D20d7) |
-| SponsoredCCTPSrcPeriphery | [0xCbf361EE59Cc74b9d6e7Af947fe4136828faf2C5](https://monadvision.com/address/0xCbf361EE59Cc74b9d6e7Af947fe4136828faf2C5) |
-| SponsoredOFTSrcPeriphery | [0xa3dE5F042EFD4C732498883100A2d319BbB3c1A1](https://monadvision.com/address/0xa3dE5F042EFD4C732498883100A2d319BbB3c1A1) |
+| Contract Name | Address |
+| ------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
+| Helios | [0x09aea4b2242abC8bb4BB78D537A67a245A7bEC64](https://monadscan.com//address/0x09aea4b2242abC8bb4BB78D537A67a245A7bEC64) |
+| MulticallHandler | [0xeC41F75c686e376Ab2a4F18bde263ab5822c4511](https://monadscan.com//address/0xeC41F75c686e376Ab2a4F18bde263ab5822c4511) |
+| SpokePool | [0xd2ecb3afe598b746F8123CaE365a598DA831A449](https://monadscan.com//address/0xd2ecb3afe598b746F8123CaE365a598DA831A449) |
+| SpokePoolPeriphery | [0xe9b0666DFfC176Df6686726CB9aaC78fD83D20d7](https://monadscan.com//address/0xe9b0666DFfC176Df6686726CB9aaC78fD83D20d7) |
+| SponsoredCCTPSrcPeriphery | [0xCbf361EE59Cc74b9d6e7Af947fe4136828faf2C5](https://monadscan.com//address/0xCbf361EE59Cc74b9d6e7Af947fe4136828faf2C5) |
+| SponsoredOFTSrcPeriphery | [0xa3dE5F042EFD4C732498883100A2d319BbB3c1A1](https://monadscan.com//address/0xa3dE5F042EFD4C732498883100A2d319BbB3c1A1) |
## Lens (232)
diff --git a/generated/constants.json b/generated/constants.json
index ced677ee1..0689f7c79 100644
--- a/generated/constants.json
+++ b/generated/constants.json
@@ -54,8 +54,8 @@
"name": "Monad",
"family": "NONE",
"nativeToken": "MON",
- "publicRPC": "https://rpc-mainnet.monadinfra.com",
- "blockExplorer": "https://monadvision.com",
+ "publicRPC": "https://rpc-mainnet.monadinfra.com/",
+ "blockExplorer": "https://monadscan.com/",
"cctpDomain": 15,
"oftEid": 30390,
"hypDomainId": 143
@@ -244,8 +244,8 @@
"name": "Monad Testnet",
"family": "NONE",
"nativeToken": "MON",
- "publicRPC": "https://testnet-rpc.monad.xyz",
- "blockExplorer": "https://testnet.monvision.io",
+ "publicRPC": "https://testnet-rpc.monad.xyz/",
+ "blockExplorer": "https://testnet.monvision.io/",
"cctpDomain": 15,
"oftEid": 40204,
"hypDomainId": 10143
@@ -296,8 +296,8 @@
"nativeToken": "ETH",
"publicRPC": "https://rpc-gel.inkonchain.com",
"blockExplorer": "https://explorer.inkonchain.com",
- "cctpDomain": 21,
- "oftEid": 30339,
+ "cctpDomain": -1,
+ "oftEid": -1,
"hypDomainId": 57073
},
"59144": {
@@ -905,7 +905,6 @@
"8453": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"10143": "0xf817257fed379853cDe0fa4F97AB987181B1E5Ea",
"42161": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
- "57073": "0x2D270e6886d130D724215A266106e6832161EAEd",
"59144": "0x176211869cA2b568f2A7D4EE941E073a821EE1ff",
"80002": "0x41E94Eb019C0762f9Bfcf9Fb1E58725BfB0e7582",
"84532": "0x036CbD53842c5426634e7929541eC2318f3dCF7e",
From b2af7dbe75d91be87a8f16b54e6d8a92fd0f6cf6 Mon Sep 17 00:00:00 2001
From: Paul <108695806+pxrl@users.noreply.github.com>
Date: Tue, 23 Dec 2025 13:32:07 +0000
Subject: [PATCH 4/6] One more
---
contracts/chain-adapters/Universal_Adapter.sol | 7 ++++++-
1 file changed, 6 insertions(+), 1 deletion(-)
diff --git a/contracts/chain-adapters/Universal_Adapter.sol b/contracts/chain-adapters/Universal_Adapter.sol
index 6d99e9416..03e0833c1 100644
--- a/contracts/chain-adapters/Universal_Adapter.sol
+++ b/contracts/chain-adapters/Universal_Adapter.sol
@@ -78,7 +78,12 @@ contract Universal_Adapter is AdapterInterface, CircleCCTPAdapter, OFTTransportA
* @param amount Amount of tokens to relay.
* @param to Address to receive the tokens on L2. Should be SpokePool address.
*/
- function relayTokens(address l1Token, address l2Token, uint256 amount, address to) external payable override {
+ function relayTokens(
+ address l1Token,
+ address l2Token,
+ uint256 amount,
+ address to
+ ) external payable override {
address oftMessenger = _getOftMessenger(l1Token);
if (_isCCTPEnabled() && l1Token == address(usdcToken)) {
_transferUsdc(to, amount);
From 131b4105f01c0b9afbc912b6cd6b383e6055fc79 Mon Sep 17 00:00:00 2001
From: Paul <108695806+pxrl@users.noreply.github.com>
Date: Tue, 23 Dec 2025 13:35:24 +0000
Subject: [PATCH 5/6] Drop
---
.../worldchain/WorldChain_SpokePool.json | 85 +++++++--
.../f6db5bcc09d996b0e542155af45c1220.json | 168 ------------------
2 files changed, 66 insertions(+), 187 deletions(-)
delete mode 100644 deployments/worldchain/solcInputs/f6db5bcc09d996b0e542155af45c1220.json
diff --git a/deployments/worldchain/WorldChain_SpokePool.json b/deployments/worldchain/WorldChain_SpokePool.json
index ac7eea77a..4414f9a6e 100644
--- a/deployments/worldchain/WorldChain_SpokePool.json
+++ b/deployments/worldchain/WorldChain_SpokePool.json
@@ -1,5 +1,5 @@
{
- "address": "0x1771c470d41b8c39338450C380bf2C080a2CEdD8",
+ "address": "0xAcDE84590A2ba1aCfEbB220997Eb41B7A01f271f",
"abi": [
{
"inputs": [
@@ -1271,6 +1271,19 @@
"stateMutability": "view",
"type": "function"
},
+ {
+ "inputs": [],
+ "name": "UPDATE_ADDRESS_DEPOSIT_DETAILS_HASH",
+ "outputs": [
+ {
+ "internalType": "bytes32",
+ "name": "",
+ "type": "bytes32"
+ }
+ ],
+ "stateMutability": "view",
+ "type": "function"
+ },
{
"inputs": [],
"name": "UPDATE_BYTES32_DEPOSIT_DETAILS_HASH",
@@ -1348,19 +1361,6 @@
"stateMutability": "view",
"type": "function"
},
- {
- "inputs": [],
- "name": "cctpV2",
- "outputs": [
- {
- "internalType": "bool",
- "name": "",
- "type": "bool"
- }
- ],
- "stateMutability": "view",
- "type": "function"
- },
{
"inputs": [],
"name": "chainId",
@@ -1794,6 +1794,30 @@
"stateMutability": "nonpayable",
"type": "function"
},
+ {
+ "inputs": [
+ {
+ "internalType": "address",
+ "name": "",
+ "type": "address"
+ },
+ {
+ "internalType": "uint256",
+ "name": "",
+ "type": "uint256"
+ }
+ ],
+ "name": "enabledDepositRoutes",
+ "outputs": [
+ {
+ "internalType": "bool",
+ "name": "",
+ "type": "bool"
+ }
+ ],
+ "stateMutability": "view",
+ "type": "function"
+ },
{
"inputs": [
{
@@ -2755,6 +2779,29 @@
"stateMutability": "nonpayable",
"type": "function"
},
+ {
+ "inputs": [
+ {
+ "internalType": "address",
+ "name": "originToken",
+ "type": "address"
+ },
+ {
+ "internalType": "uint256",
+ "name": "destinationChainId",
+ "type": "uint256"
+ },
+ {
+ "internalType": "bool",
+ "name": "enabled",
+ "type": "bool"
+ }
+ ],
+ "name": "setEnableRoute",
+ "outputs": [],
+ "stateMutability": "nonpayable",
+ "type": "function"
+ },
{
"inputs": [
{
@@ -3091,9 +3138,9 @@
"type": "receive"
}
],
- "numDeployments": 6,
- "solcInputHash": "f6db5bcc09d996b0e542155af45c1220",
- "metadata": "{\"compiler\":{\"version\":\"0.8.23+commit.f704f362\"},\"language\":\"Solidity\",\"output\":{\"abi\":[{\"inputs\":[{\"internalType\":\"address\",\"name\":\"_wrappedNativeTokenAddress\",\"type\":\"address\"},{\"internalType\":\"uint32\",\"name\":\"_depositQuoteTimeBuffer\",\"type\":\"uint32\"},{\"internalType\":\"uint32\",\"name\":\"_fillDeadlineBuffer\",\"type\":\"uint32\"},{\"internalType\":\"contract IERC20\",\"name\":\"_l2Usdc\",\"type\":\"address\"},{\"internalType\":\"contract ITokenMessenger\",\"name\":\"_cctpTokenMessenger\",\"type\":\"address\"}],\"stateMutability\":\"nonpayable\",\"type\":\"constructor\"},{\"inputs\":[],\"name\":\"ClaimedMerkleLeaf\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"DepositsArePaused\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"DisabledRoute\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"ExpiredFillDeadline\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"FillsArePaused\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"InsufficientSpokePoolBalanceToExecuteLeaf\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"InvalidBytes32\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"InvalidChainId\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"InvalidCrossDomainAdmin\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"InvalidDepositorSignature\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"InvalidExclusiveRelayer\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"InvalidFillDeadline\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"InvalidMerkleLeaf\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"InvalidMerkleProof\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"InvalidPayoutAdjustmentPct\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"InvalidQuoteTimestamp\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"InvalidRelayerFeePct\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"InvalidSlowFillRequest\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"InvalidWithdrawalRecipient\",\"type\":\"error\"},{\"inputs\":[{\"internalType\":\"bytes\",\"name\":\"data\",\"type\":\"bytes\"}],\"name\":\"LowLevelCallFailed\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"MaxTransferSizeExceeded\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"MsgValueDoesNotMatchInputAmount\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"NoRelayerRefundToClaim\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"NoSlowFillsInExclusivityWindow\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"NotCrossChainCall\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"NotCrossDomainAdmin\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"NotEOA\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"NotExclusiveRelayer\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"RelayFilled\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"WrongERC7683OrderId\",\"type\":\"error\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address\",\"name\":\"previousAdmin\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"newAdmin\",\"type\":\"address\"}],\"name\":\"AdminChanged\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"beacon\",\"type\":\"address\"}],\"name\":\"BeaconUpgraded\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"bytes32\",\"name\":\"l2TokenAddress\",\"type\":\"bytes32\"},{\"indexed\":true,\"internalType\":\"bytes32\",\"name\":\"refundAddress\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"amount\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"address\",\"name\":\"caller\",\"type\":\"address\"}],\"name\":\"ClaimedRelayerRefund\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"uint256\",\"name\":\"rootBundleId\",\"type\":\"uint256\"}],\"name\":\"EmergencyDeletedRootBundle\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"originToken\",\"type\":\"address\"},{\"indexed\":true,\"internalType\":\"uint256\",\"name\":\"destinationChainId\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"bool\",\"name\":\"enabled\",\"type\":\"bool\"}],\"name\":\"EnabledDepositRoute\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"amountToReturn\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"uint256\",\"name\":\"chainId\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"uint256[]\",\"name\":\"refundAmounts\",\"type\":\"uint256[]\"},{\"indexed\":true,\"internalType\":\"uint32\",\"name\":\"rootBundleId\",\"type\":\"uint32\"},{\"indexed\":true,\"internalType\":\"uint32\",\"name\":\"leafId\",\"type\":\"uint32\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"l2TokenAddress\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"address[]\",\"name\":\"refundAddresses\",\"type\":\"address[]\"},{\"indexed\":false,\"internalType\":\"bool\",\"name\":\"deferredRefunds\",\"type\":\"bool\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"caller\",\"type\":\"address\"}],\"name\":\"ExecutedRelayerRefundRoot\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"bytes32\",\"name\":\"inputToken\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"bytes32\",\"name\":\"outputToken\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"inputAmount\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"outputAmount\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"repaymentChainId\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"uint256\",\"name\":\"originChainId\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"uint256\",\"name\":\"depositId\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"uint32\",\"name\":\"fillDeadline\",\"type\":\"uint32\"},{\"indexed\":false,\"internalType\":\"uint32\",\"name\":\"exclusivityDeadline\",\"type\":\"uint32\"},{\"indexed\":false,\"internalType\":\"bytes32\",\"name\":\"exclusiveRelayer\",\"type\":\"bytes32\"},{\"indexed\":true,\"internalType\":\"bytes32\",\"name\":\"relayer\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"bytes32\",\"name\":\"depositor\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"bytes32\",\"name\":\"recipient\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"bytes32\",\"name\":\"messageHash\",\"type\":\"bytes32\"},{\"components\":[{\"internalType\":\"bytes32\",\"name\":\"updatedRecipient\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"updatedMessageHash\",\"type\":\"bytes32\"},{\"internalType\":\"uint256\",\"name\":\"updatedOutputAmount\",\"type\":\"uint256\"},{\"internalType\":\"enum V3SpokePoolInterface.FillType\",\"name\":\"fillType\",\"type\":\"uint8\"}],\"indexed\":false,\"internalType\":\"struct V3SpokePoolInterface.V3RelayExecutionEventInfo\",\"name\":\"relayExecutionInfo\",\"type\":\"tuple\"}],\"name\":\"FilledRelay\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address\",\"name\":\"inputToken\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"outputToken\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"inputAmount\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"outputAmount\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"repaymentChainId\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"uint256\",\"name\":\"originChainId\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"uint32\",\"name\":\"depositId\",\"type\":\"uint32\"},{\"indexed\":false,\"internalType\":\"uint32\",\"name\":\"fillDeadline\",\"type\":\"uint32\"},{\"indexed\":false,\"internalType\":\"uint32\",\"name\":\"exclusivityDeadline\",\"type\":\"uint32\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"exclusiveRelayer\",\"type\":\"address\"},{\"indexed\":true,\"internalType\":\"address\",\"name\":\"relayer\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"depositor\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"recipient\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"},{\"components\":[{\"internalType\":\"address\",\"name\":\"updatedRecipient\",\"type\":\"address\"},{\"internalType\":\"bytes\",\"name\":\"updatedMessage\",\"type\":\"bytes\"},{\"internalType\":\"uint256\",\"name\":\"updatedOutputAmount\",\"type\":\"uint256\"},{\"internalType\":\"enum V3SpokePoolInterface.FillType\",\"name\":\"fillType\",\"type\":\"uint8\"}],\"indexed\":false,\"internalType\":\"struct V3SpokePoolInterface.LegacyV3RelayExecutionEventInfo\",\"name\":\"relayExecutionInfo\",\"type\":\"tuple\"}],\"name\":\"FilledV3Relay\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"bytes32\",\"name\":\"inputToken\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"bytes32\",\"name\":\"outputToken\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"inputAmount\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"outputAmount\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"uint256\",\"name\":\"destinationChainId\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"uint256\",\"name\":\"depositId\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"uint32\",\"name\":\"quoteTimestamp\",\"type\":\"uint32\"},{\"indexed\":false,\"internalType\":\"uint32\",\"name\":\"fillDeadline\",\"type\":\"uint32\"},{\"indexed\":false,\"internalType\":\"uint32\",\"name\":\"exclusivityDeadline\",\"type\":\"uint32\"},{\"indexed\":true,\"internalType\":\"bytes32\",\"name\":\"depositor\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"bytes32\",\"name\":\"recipient\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"bytes32\",\"name\":\"exclusiveRelayer\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"}],\"name\":\"FundsDeposited\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"uint8\",\"name\":\"version\",\"type\":\"uint8\"}],\"name\":\"Initialized\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"bool\",\"name\":\"isPaused\",\"type\":\"bool\"}],\"name\":\"PausedDeposits\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"bool\",\"name\":\"isPaused\",\"type\":\"bool\"}],\"name\":\"PausedFills\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"uint32\",\"name\":\"rootBundleId\",\"type\":\"uint32\"},{\"indexed\":true,\"internalType\":\"bytes32\",\"name\":\"relayerRefundRoot\",\"type\":\"bytes32\"},{\"indexed\":true,\"internalType\":\"bytes32\",\"name\":\"slowRelayRoot\",\"type\":\"bytes32\"}],\"name\":\"RelayedRootBundle\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"bytes32\",\"name\":\"inputToken\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"bytes32\",\"name\":\"outputToken\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"inputAmount\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"outputAmount\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"uint256\",\"name\":\"originChainId\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"uint256\",\"name\":\"depositId\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"uint32\",\"name\":\"fillDeadline\",\"type\":\"uint32\"},{\"indexed\":false,\"internalType\":\"uint32\",\"name\":\"exclusivityDeadline\",\"type\":\"uint32\"},{\"indexed\":false,\"internalType\":\"bytes32\",\"name\":\"exclusiveRelayer\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"bytes32\",\"name\":\"depositor\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"bytes32\",\"name\":\"recipient\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"bytes32\",\"name\":\"messageHash\",\"type\":\"bytes32\"}],\"name\":\"RequestedSlowFill\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"updatedOutputAmount\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"uint256\",\"name\":\"depositId\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"bytes32\",\"name\":\"depositor\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"bytes32\",\"name\":\"updatedRecipient\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"bytes\",\"name\":\"updatedMessage\",\"type\":\"bytes\"},{\"indexed\":false,\"internalType\":\"bytes\",\"name\":\"depositorSignature\",\"type\":\"bytes\"}],\"name\":\"RequestedSpeedUpDeposit\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"updatedOutputAmount\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"uint32\",\"name\":\"depositId\",\"type\":\"uint32\"},{\"indexed\":true,\"internalType\":\"address\",\"name\":\"depositor\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"updatedRecipient\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"bytes\",\"name\":\"updatedMessage\",\"type\":\"bytes\"},{\"indexed\":false,\"internalType\":\"bytes\",\"name\":\"depositorSignature\",\"type\":\"bytes\"}],\"name\":\"RequestedSpeedUpV3Deposit\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address\",\"name\":\"inputToken\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"outputToken\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"inputAmount\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"outputAmount\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"uint256\",\"name\":\"originChainId\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"uint32\",\"name\":\"depositId\",\"type\":\"uint32\"},{\"indexed\":false,\"internalType\":\"uint32\",\"name\":\"fillDeadline\",\"type\":\"uint32\"},{\"indexed\":false,\"internalType\":\"uint32\",\"name\":\"exclusivityDeadline\",\"type\":\"uint32\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"exclusiveRelayer\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"depositor\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"recipient\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"}],\"name\":\"RequestedV3SlowFill\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"uint32\",\"name\":\"newL1Gas\",\"type\":\"uint32\"}],\"name\":\"SetL1Gas\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"l2Token\",\"type\":\"address\"},{\"indexed\":true,\"internalType\":\"address\",\"name\":\"tokenBridge\",\"type\":\"address\"}],\"name\":\"SetL2TokenBridge\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"l2Token\",\"type\":\"address\"},{\"indexed\":true,\"internalType\":\"address\",\"name\":\"l1Token\",\"type\":\"address\"}],\"name\":\"SetRemoteL1Token\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"newWithdrawalRecipient\",\"type\":\"address\"}],\"name\":\"SetWithdrawalRecipient\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"newAdmin\",\"type\":\"address\"}],\"name\":\"SetXDomainAdmin\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"amountToReturn\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"uint256\",\"name\":\"chainId\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"uint32\",\"name\":\"leafId\",\"type\":\"uint32\"},{\"indexed\":true,\"internalType\":\"bytes32\",\"name\":\"l2TokenAddress\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"caller\",\"type\":\"address\"}],\"name\":\"TokensBridged\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"implementation\",\"type\":\"address\"}],\"name\":\"Upgraded\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address\",\"name\":\"inputToken\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"outputToken\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"inputAmount\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"outputAmount\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"uint256\",\"name\":\"destinationChainId\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"uint32\",\"name\":\"depositId\",\"type\":\"uint32\"},{\"indexed\":false,\"internalType\":\"uint32\",\"name\":\"quoteTimestamp\",\"type\":\"uint32\"},{\"indexed\":false,\"internalType\":\"uint32\",\"name\":\"fillDeadline\",\"type\":\"uint32\"},{\"indexed\":false,\"internalType\":\"uint32\",\"name\":\"exclusivityDeadline\",\"type\":\"uint32\"},{\"indexed\":true,\"internalType\":\"address\",\"name\":\"depositor\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"recipient\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"exclusiveRelayer\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"}],\"name\":\"V3FundsDeposited\",\"type\":\"event\"},{\"inputs\":[],\"name\":\"EMPTY_RELAYER\",\"outputs\":[{\"internalType\":\"bytes32\",\"name\":\"\",\"type\":\"bytes32\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"EMPTY_REPAYMENT_CHAIN_ID\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"INFINITE_FILL_DEADLINE\",\"outputs\":[{\"internalType\":\"uint32\",\"name\":\"\",\"type\":\"uint32\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"MAX_EXCLUSIVITY_PERIOD_SECONDS\",\"outputs\":[{\"internalType\":\"uint32\",\"name\":\"\",\"type\":\"uint32\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"MAX_TRANSFER_SIZE\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"MESSENGER\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"UPDATE_BYTES32_DEPOSIT_DETAILS_HASH\",\"outputs\":[{\"internalType\":\"bytes32\",\"name\":\"\",\"type\":\"bytes32\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint32\",\"name\":\"_initialDepositId\",\"type\":\"uint32\"},{\"internalType\":\"address\",\"name\":\"_crossDomainAdmin\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"_withdrawalRecipient\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"_l2Eth\",\"type\":\"address\"}],\"name\":\"__OvmSpokePool_init\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint32\",\"name\":\"_initialDepositId\",\"type\":\"uint32\"},{\"internalType\":\"address\",\"name\":\"_crossDomainAdmin\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"_withdrawalRecipient\",\"type\":\"address\"}],\"name\":\"__SpokePool_init\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"cctpTokenMessenger\",\"outputs\":[{\"internalType\":\"contract ITokenMessenger\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"cctpV2\",\"outputs\":[{\"internalType\":\"bool\",\"name\":\"\",\"type\":\"bool\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"chainId\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"bytes32\",\"name\":\"l2TokenAddress\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"refundAddress\",\"type\":\"bytes32\"}],\"name\":\"claimRelayerRefund\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"crossDomainAdmin\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"bytes32\",\"name\":\"depositor\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"recipient\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"inputToken\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"outputToken\",\"type\":\"bytes32\"},{\"internalType\":\"uint256\",\"name\":\"inputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"outputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"destinationChainId\",\"type\":\"uint256\"},{\"internalType\":\"bytes32\",\"name\":\"exclusiveRelayer\",\"type\":\"bytes32\"},{\"internalType\":\"uint32\",\"name\":\"quoteTimestamp\",\"type\":\"uint32\"},{\"internalType\":\"uint32\",\"name\":\"fillDeadline\",\"type\":\"uint32\"},{\"internalType\":\"uint32\",\"name\":\"exclusivityParameter\",\"type\":\"uint32\"},{\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"}],\"name\":\"deposit\",\"outputs\":[],\"stateMutability\":\"payable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"recipient\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"originToken\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"amount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"destinationChainId\",\"type\":\"uint256\"},{\"internalType\":\"int64\",\"name\":\"relayerFeePct\",\"type\":\"int64\"},{\"internalType\":\"uint32\",\"name\":\"quoteTimestamp\",\"type\":\"uint32\"},{\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"},{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"name\":\"depositDeprecated_5947912356\",\"outputs\":[],\"stateMutability\":\"payable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"depositor\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"recipient\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"originToken\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"amount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"destinationChainId\",\"type\":\"uint256\"},{\"internalType\":\"int64\",\"name\":\"relayerFeePct\",\"type\":\"int64\"},{\"internalType\":\"uint32\",\"name\":\"quoteTimestamp\",\"type\":\"uint32\"},{\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"},{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"name\":\"depositFor\",\"outputs\":[],\"stateMutability\":\"payable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"bytes32\",\"name\":\"depositor\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"recipient\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"inputToken\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"outputToken\",\"type\":\"bytes32\"},{\"internalType\":\"uint256\",\"name\":\"inputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"outputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"destinationChainId\",\"type\":\"uint256\"},{\"internalType\":\"bytes32\",\"name\":\"exclusiveRelayer\",\"type\":\"bytes32\"},{\"internalType\":\"uint32\",\"name\":\"fillDeadlineOffset\",\"type\":\"uint32\"},{\"internalType\":\"uint32\",\"name\":\"exclusivityParameter\",\"type\":\"uint32\"},{\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"}],\"name\":\"depositNow\",\"outputs\":[],\"stateMutability\":\"payable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"depositQuoteTimeBuffer\",\"outputs\":[{\"internalType\":\"uint32\",\"name\":\"\",\"type\":\"uint32\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"depositor\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"recipient\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"inputToken\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"outputToken\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"inputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"outputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"destinationChainId\",\"type\":\"uint256\"},{\"internalType\":\"address\",\"name\":\"exclusiveRelayer\",\"type\":\"address\"},{\"internalType\":\"uint32\",\"name\":\"quoteTimestamp\",\"type\":\"uint32\"},{\"internalType\":\"uint32\",\"name\":\"fillDeadline\",\"type\":\"uint32\"},{\"internalType\":\"uint32\",\"name\":\"exclusivityParameter\",\"type\":\"uint32\"},{\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"}],\"name\":\"depositV3\",\"outputs\":[],\"stateMutability\":\"payable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"depositor\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"recipient\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"inputToken\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"outputToken\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"inputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"outputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"destinationChainId\",\"type\":\"uint256\"},{\"internalType\":\"address\",\"name\":\"exclusiveRelayer\",\"type\":\"address\"},{\"internalType\":\"uint32\",\"name\":\"fillDeadlineOffset\",\"type\":\"uint32\"},{\"internalType\":\"uint32\",\"name\":\"exclusivityParameter\",\"type\":\"uint32\"},{\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"}],\"name\":\"depositV3Now\",\"outputs\":[],\"stateMutability\":\"payable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint256\",\"name\":\"rootBundleId\",\"type\":\"uint256\"}],\"name\":\"emergencyDeleteRootBundle\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint32\",\"name\":\"rootBundleId\",\"type\":\"uint32\"},{\"components\":[{\"internalType\":\"uint256\",\"name\":\"amountToReturn\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"chainId\",\"type\":\"uint256\"},{\"internalType\":\"uint256[]\",\"name\":\"refundAmounts\",\"type\":\"uint256[]\"},{\"internalType\":\"uint32\",\"name\":\"leafId\",\"type\":\"uint32\"},{\"internalType\":\"address\",\"name\":\"l2TokenAddress\",\"type\":\"address\"},{\"internalType\":\"address[]\",\"name\":\"refundAddresses\",\"type\":\"address[]\"}],\"internalType\":\"struct SpokePoolInterface.RelayerRefundLeaf\",\"name\":\"relayerRefundLeaf\",\"type\":\"tuple\"},{\"internalType\":\"bytes32[]\",\"name\":\"proof\",\"type\":\"bytes32[]\"}],\"name\":\"executeRelayerRefundLeaf\",\"outputs\":[],\"stateMutability\":\"payable\",\"type\":\"function\"},{\"inputs\":[{\"components\":[{\"components\":[{\"internalType\":\"bytes32\",\"name\":\"depositor\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"recipient\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"exclusiveRelayer\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"inputToken\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"outputToken\",\"type\":\"bytes32\"},{\"internalType\":\"uint256\",\"name\":\"inputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"outputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"originChainId\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"depositId\",\"type\":\"uint256\"},{\"internalType\":\"uint32\",\"name\":\"fillDeadline\",\"type\":\"uint32\"},{\"internalType\":\"uint32\",\"name\":\"exclusivityDeadline\",\"type\":\"uint32\"},{\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"}],\"internalType\":\"struct V3SpokePoolInterface.V3RelayData\",\"name\":\"relayData\",\"type\":\"tuple\"},{\"internalType\":\"uint256\",\"name\":\"chainId\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"updatedOutputAmount\",\"type\":\"uint256\"}],\"internalType\":\"struct V3SpokePoolInterface.V3SlowFill\",\"name\":\"slowFillLeaf\",\"type\":\"tuple\"},{\"internalType\":\"uint32\",\"name\":\"rootBundleId\",\"type\":\"uint32\"},{\"internalType\":\"bytes32[]\",\"name\":\"proof\",\"type\":\"bytes32[]\"}],\"name\":\"executeSlowRelayLeaf\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"bytes32\",\"name\":\"orderId\",\"type\":\"bytes32\"},{\"internalType\":\"bytes\",\"name\":\"originData\",\"type\":\"bytes\"},{\"internalType\":\"bytes\",\"name\":\"fillerData\",\"type\":\"bytes\"}],\"name\":\"fill\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"fillDeadlineBuffer\",\"outputs\":[{\"internalType\":\"uint32\",\"name\":\"\",\"type\":\"uint32\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"components\":[{\"internalType\":\"bytes32\",\"name\":\"depositor\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"recipient\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"exclusiveRelayer\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"inputToken\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"outputToken\",\"type\":\"bytes32\"},{\"internalType\":\"uint256\",\"name\":\"inputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"outputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"originChainId\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"depositId\",\"type\":\"uint256\"},{\"internalType\":\"uint32\",\"name\":\"fillDeadline\",\"type\":\"uint32\"},{\"internalType\":\"uint32\",\"name\":\"exclusivityDeadline\",\"type\":\"uint32\"},{\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"}],\"internalType\":\"struct V3SpokePoolInterface.V3RelayData\",\"name\":\"relayData\",\"type\":\"tuple\"},{\"internalType\":\"uint256\",\"name\":\"repaymentChainId\",\"type\":\"uint256\"},{\"internalType\":\"bytes32\",\"name\":\"repaymentAddress\",\"type\":\"bytes32\"}],\"name\":\"fillRelay\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"components\":[{\"internalType\":\"bytes32\",\"name\":\"depositor\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"recipient\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"exclusiveRelayer\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"inputToken\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"outputToken\",\"type\":\"bytes32\"},{\"internalType\":\"uint256\",\"name\":\"inputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"outputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"originChainId\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"depositId\",\"type\":\"uint256\"},{\"internalType\":\"uint32\",\"name\":\"fillDeadline\",\"type\":\"uint32\"},{\"internalType\":\"uint32\",\"name\":\"exclusivityDeadline\",\"type\":\"uint32\"},{\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"}],\"internalType\":\"struct V3SpokePoolInterface.V3RelayData\",\"name\":\"relayData\",\"type\":\"tuple\"},{\"internalType\":\"uint256\",\"name\":\"repaymentChainId\",\"type\":\"uint256\"},{\"internalType\":\"bytes32\",\"name\":\"repaymentAddress\",\"type\":\"bytes32\"},{\"internalType\":\"uint256\",\"name\":\"updatedOutputAmount\",\"type\":\"uint256\"},{\"internalType\":\"bytes32\",\"name\":\"updatedRecipient\",\"type\":\"bytes32\"},{\"internalType\":\"bytes\",\"name\":\"updatedMessage\",\"type\":\"bytes\"},{\"internalType\":\"bytes\",\"name\":\"depositorSignature\",\"type\":\"bytes\"}],\"name\":\"fillRelayWithUpdatedDeposit\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"bytes32\",\"name\":\"\",\"type\":\"bytes32\"}],\"name\":\"fillStatuses\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"components\":[{\"internalType\":\"address\",\"name\":\"depositor\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"recipient\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"exclusiveRelayer\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"inputToken\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"outputToken\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"inputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"outputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"originChainId\",\"type\":\"uint256\"},{\"internalType\":\"uint32\",\"name\":\"depositId\",\"type\":\"uint32\"},{\"internalType\":\"uint32\",\"name\":\"fillDeadline\",\"type\":\"uint32\"},{\"internalType\":\"uint32\",\"name\":\"exclusivityDeadline\",\"type\":\"uint32\"},{\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"}],\"internalType\":\"struct V3SpokePoolInterface.V3RelayDataLegacy\",\"name\":\"relayData\",\"type\":\"tuple\"},{\"internalType\":\"uint256\",\"name\":\"repaymentChainId\",\"type\":\"uint256\"}],\"name\":\"fillV3Relay\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"getCurrentTime\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"l2TokenAddress\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"refundAddress\",\"type\":\"address\"}],\"name\":\"getRelayerRefund\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"msgSender\",\"type\":\"address\"},{\"internalType\":\"bytes32\",\"name\":\"depositor\",\"type\":\"bytes32\"},{\"internalType\":\"uint256\",\"name\":\"depositNonce\",\"type\":\"uint256\"}],\"name\":\"getUnsafeDepositId\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"pure\",\"type\":\"function\"},{\"inputs\":[{\"components\":[{\"internalType\":\"bytes32\",\"name\":\"depositor\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"recipient\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"exclusiveRelayer\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"inputToken\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"outputToken\",\"type\":\"bytes32\"},{\"internalType\":\"uint256\",\"name\":\"inputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"outputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"originChainId\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"depositId\",\"type\":\"uint256\"},{\"internalType\":\"uint32\",\"name\":\"fillDeadline\",\"type\":\"uint32\"},{\"internalType\":\"uint32\",\"name\":\"exclusivityDeadline\",\"type\":\"uint32\"},{\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"}],\"internalType\":\"struct V3SpokePoolInterface.V3RelayData\",\"name\":\"relayData\",\"type\":\"tuple\"}],\"name\":\"getV3RelayHash\",\"outputs\":[{\"internalType\":\"bytes32\",\"name\":\"\",\"type\":\"bytes32\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint32\",\"name\":\"_initialDepositId\",\"type\":\"uint32\"},{\"internalType\":\"address\",\"name\":\"_crossDomainAdmin\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"_withdrawalRecipient\",\"type\":\"address\"}],\"name\":\"initialize\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"l1Gas\",\"outputs\":[{\"internalType\":\"uint32\",\"name\":\"\",\"type\":\"uint32\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"l2Eth\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"bytes[]\",\"name\":\"data\",\"type\":\"bytes[]\"}],\"name\":\"multicall\",\"outputs\":[{\"internalType\":\"bytes[]\",\"name\":\"results\",\"type\":\"bytes[]\"}],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"numberOfDeposits\",\"outputs\":[{\"internalType\":\"uint32\",\"name\":\"\",\"type\":\"uint32\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"bool\",\"name\":\"pause\",\"type\":\"bool\"}],\"name\":\"pauseDeposits\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"bool\",\"name\":\"pause\",\"type\":\"bool\"}],\"name\":\"pauseFills\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"pausedDeposits\",\"outputs\":[{\"internalType\":\"bool\",\"name\":\"\",\"type\":\"bool\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"pausedFills\",\"outputs\":[{\"internalType\":\"bool\",\"name\":\"\",\"type\":\"bool\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"proxiableUUID\",\"outputs\":[{\"internalType\":\"bytes32\",\"name\":\"\",\"type\":\"bytes32\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"recipientCircleDomainId\",\"outputs\":[{\"internalType\":\"uint32\",\"name\":\"\",\"type\":\"uint32\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"bytes32\",\"name\":\"relayerRefundRoot\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"slowRelayRoot\",\"type\":\"bytes32\"}],\"name\":\"relayRootBundle\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"name\":\"relayerRefund\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"name\":\"remoteL1Tokens\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"components\":[{\"internalType\":\"bytes32\",\"name\":\"depositor\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"recipient\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"exclusiveRelayer\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"inputToken\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"outputToken\",\"type\":\"bytes32\"},{\"internalType\":\"uint256\",\"name\":\"inputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"outputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"originChainId\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"depositId\",\"type\":\"uint256\"},{\"internalType\":\"uint32\",\"name\":\"fillDeadline\",\"type\":\"uint32\"},{\"internalType\":\"uint32\",\"name\":\"exclusivityDeadline\",\"type\":\"uint32\"},{\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"}],\"internalType\":\"struct V3SpokePoolInterface.V3RelayData\",\"name\":\"relayData\",\"type\":\"tuple\"}],\"name\":\"requestSlowFill\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"name\":\"rootBundles\",\"outputs\":[{\"internalType\":\"bytes32\",\"name\":\"slowRelayRoot\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"relayerRefundRoot\",\"type\":\"bytes32\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"newCrossDomainAdmin\",\"type\":\"address\"}],\"name\":\"setCrossDomainAdmin\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint32\",\"name\":\"newl1Gas\",\"type\":\"uint32\"}],\"name\":\"setL1GasLimit\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"l2Token\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"l1Token\",\"type\":\"address\"}],\"name\":\"setRemoteL1Token\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"l2Token\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"tokenBridge\",\"type\":\"address\"}],\"name\":\"setTokenBridge\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"newWithdrawalRecipient\",\"type\":\"address\"}],\"name\":\"setWithdrawalRecipient\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"bytes32\",\"name\":\"depositor\",\"type\":\"bytes32\"},{\"internalType\":\"uint256\",\"name\":\"depositId\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"updatedOutputAmount\",\"type\":\"uint256\"},{\"internalType\":\"bytes32\",\"name\":\"updatedRecipient\",\"type\":\"bytes32\"},{\"internalType\":\"bytes\",\"name\":\"updatedMessage\",\"type\":\"bytes\"},{\"internalType\":\"bytes\",\"name\":\"depositorSignature\",\"type\":\"bytes\"}],\"name\":\"speedUpDeposit\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"depositor\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"depositId\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"updatedOutputAmount\",\"type\":\"uint256\"},{\"internalType\":\"address\",\"name\":\"updatedRecipient\",\"type\":\"address\"},{\"internalType\":\"bytes\",\"name\":\"updatedMessage\",\"type\":\"bytes\"},{\"internalType\":\"bytes\",\"name\":\"depositorSignature\",\"type\":\"bytes\"}],\"name\":\"speedUpV3Deposit\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"name\":\"tokenBridges\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"bytes[]\",\"name\":\"data\",\"type\":\"bytes[]\"}],\"name\":\"tryMulticall\",\"outputs\":[{\"components\":[{\"internalType\":\"bool\",\"name\":\"success\",\"type\":\"bool\"},{\"internalType\":\"bytes\",\"name\":\"returnData\",\"type\":\"bytes\"}],\"internalType\":\"struct MultiCallerUpgradeable.Result[]\",\"name\":\"results\",\"type\":\"tuple[]\"}],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"bytes32\",\"name\":\"depositor\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"recipient\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"inputToken\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"outputToken\",\"type\":\"bytes32\"},{\"internalType\":\"uint256\",\"name\":\"inputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"outputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"destinationChainId\",\"type\":\"uint256\"},{\"internalType\":\"bytes32\",\"name\":\"exclusiveRelayer\",\"type\":\"bytes32\"},{\"internalType\":\"uint256\",\"name\":\"depositNonce\",\"type\":\"uint256\"},{\"internalType\":\"uint32\",\"name\":\"quoteTimestamp\",\"type\":\"uint32\"},{\"internalType\":\"uint32\",\"name\":\"fillDeadline\",\"type\":\"uint32\"},{\"internalType\":\"uint32\",\"name\":\"exclusivityParameter\",\"type\":\"uint32\"},{\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"}],\"name\":\"unsafeDeposit\",\"outputs\":[],\"stateMutability\":\"payable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"newImplementation\",\"type\":\"address\"}],\"name\":\"upgradeTo\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"newImplementation\",\"type\":\"address\"},{\"internalType\":\"bytes\",\"name\":\"data\",\"type\":\"bytes\"}],\"name\":\"upgradeToAndCall\",\"outputs\":[],\"stateMutability\":\"payable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"usdcToken\",\"outputs\":[{\"internalType\":\"contract IERC20\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"withdrawalRecipient\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"wrappedNativeToken\",\"outputs\":[{\"internalType\":\"contract WETH9Interface\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"stateMutability\":\"payable\",\"type\":\"receive\"}],\"devdoc\":{\"custom:security-contact\":\"bugs@across.to\",\"events\":{\"AdminChanged(address,address)\":{\"details\":\"Emitted when the admin account has changed.\"},\"BeaconUpgraded(address)\":{\"details\":\"Emitted when the beacon is changed.\"},\"Initialized(uint8)\":{\"details\":\"Triggered when the contract has been initialized or reinitialized.\"},\"Upgraded(address)\":{\"details\":\"Emitted when the implementation is upgraded.\"}},\"kind\":\"dev\",\"methods\":{\"__OvmSpokePool_init(uint32,address,address,address)\":{\"params\":{\"_crossDomainAdmin\":\"Cross domain admin to set. Can be changed by admin.\",\"_initialDepositId\":\"Starting deposit ID. Set to 0 unless this is a re-deployment in order to mitigate relay hash collisions.\",\"_l2Eth\":\"Address of L2 ETH token. Usually should be Lib_PreeployAddresses.OVM_ETH but sometimes this can be different, like with Boba which flips the WETH and OVM_ETH addresses.\",\"_withdrawalRecipient\":\"Address which receives token withdrawals. Can be changed by admin. For Spoke Pools on L2, this will likely be the hub pool.\"}},\"__SpokePool_init(uint32,address,address)\":{\"params\":{\"_crossDomainAdmin\":\"Cross domain admin to set. Can be changed by admin.\",\"_initialDepositId\":\"Starting deposit ID. Set to 0 unless this is a re-deployment in order to mitigate relay hash collisions.\",\"_withdrawalRecipient\":\"Address which receives token withdrawals. Can be changed by admin. For Spoke Pools on L2, this will likely be the hub pool.\"}},\"chainId()\":{\"details\":\"Some L2s like ZKSync don't support the CHAIN_ID opcode so we allow the implementer to override this.\"},\"claimRelayerRefund(bytes32,bytes32)\":{\"params\":{\"l2TokenAddress\":\"Address of the L2 token to claim refunds for.\",\"refundAddress\":\"Address to send the refund to.\"}},\"constructor\":{\"custom:oz-upgrades-unsafe-allow\":\"constructor\"},\"deposit(bytes32,bytes32,bytes32,bytes32,uint256,uint256,uint256,bytes32,uint32,uint32,uint32,bytes)\":{\"details\":\"On the destination chain, the hash of the deposit data will be used to uniquely identify this deposit, so modifying any params in it will result in a different hash and a different deposit. The hash will comprise all parameters to this function along with this chain's chainId(). Relayers are only refunded for filling deposits with deposit hashes that map exactly to the one emitted by this contract.\",\"params\":{\"depositor\":\"The account credited with the deposit who can request to \\\"speed up\\\" this deposit by modifying the output amount, recipient, and message.\",\"destinationChainId\":\"The destination chain identifier. Must be enabled along with the input token as a valid deposit route from this spoke pool or this transaction will revert.\",\"exclusiveRelayer\":\"The relayer that will be exclusively allowed to fill this deposit before the exclusivity deadline timestamp. This must be a valid, non-zero address if the exclusivity deadline is greater than the current block.timestamp. If the exclusivity deadline is < currentTime, then this must be address(0), and vice versa if this is address(0).\",\"exclusivityParameter\":\"This value is used to set the exclusivity deadline timestamp in the emitted deposit event. Before this destination chain timestamp, only the exclusiveRelayer (if set to a non-zero address), can fill this deposit. There are three ways to use this parameter: 1. NO EXCLUSIVITY: If this value is set to 0, then a timestamp of 0 will be emitted, meaning that there is no exclusivity period. 2. OFFSET: If this value is less than MAX_EXCLUSIVITY_PERIOD_SECONDS, then add this value to the block.timestamp to derive the exclusive relayer deadline. Note that using the parameter in this way will expose the filler of the deposit to the risk that the block.timestamp of this event gets changed due to a chain-reorg, which would also change the exclusivity timestamp. 3. TIMESTAMP: Otherwise, set this value as the exclusivity deadline timestamp. which is the deadline for the exclusiveRelayer to fill the deposit.\",\"fillDeadline\":\"The deadline for the relayer to fill the deposit. After this destination chain timestamp, the fill will revert on the destination chain. Must be set before currentTime + fillDeadlineBuffer, where currentTime is block.timestamp on this chain or this transaction will revert.\",\"inputAmount\":\"The amount of input tokens to pull from the caller's account and lock into this contract. This amount will be sent to the relayer on their repayment chain of choice as a refund following an optimistic challenge window in the HubPool, less a system fee.\",\"inputToken\":\"The token pulled from the caller's account and locked into this contract to initiate the deposit. The equivalent of this token on the relayer's repayment chain of choice will be sent as a refund. If this is equal to the wrapped native token then the caller can optionally pass in native token as msg.value, as long as msg.value = inputTokenAmount.\",\"message\":\"The message to send to the recipient on the destination chain if the recipient is a contract. If the message is not empty, the recipient contract must implement handleV3AcrossMessage() or the fill will revert.\",\"outputAmount\":\"The amount of output tokens that the relayer will send to the recipient on the destination.\",\"outputToken\":\"The token that the relayer will send to the recipient on the destination chain. Must be an ERC20.\",\"quoteTimestamp\":\"The HubPool timestamp that is used to determine the system fee paid by the depositor. This must be set to some time between [currentTime - depositQuoteTimeBuffer, currentTime] where currentTime is block.timestamp on this chain or this transaction will revert.\",\"recipient\":\"The account receiving funds on the destination chain. Can be an EOA or a contract. If the output token is the wrapped native token for the chain, then the recipient will receive native token if an EOA or wrapped native token if a contract.\"}},\"depositDeprecated_5947912356(address,address,uint256,uint256,int64,uint32,bytes,uint256)\":{\"details\":\"DEPRECATION NOTICE: this function is deprecated and will be removed in the future. Please use deposit (under DEPOSITOR FUNCTIONS below) or depositV3 instead.Produces a FundsDeposited event with an infinite expiry, meaning that this deposit can never expire. Moreover, the event's outputToken is set to 0x0 meaning that this deposit can always be slow filled.\",\"params\":{\"amount\":\"Amount of tokens to deposit. Will be amount of tokens to receive less fees.\",\"destinationChainId\":\"Denotes network where user will receive funds from SpokePool by a relayer.\",\"message\":\"Arbitrary data that can be used to pass additional information to the recipient along with the tokens. Note: this is intended to be used to pass along instructions for how a contract should use or allocate the tokens.\",\"originToken\":\"Token to lock into this contract to initiate deposit.\",\"quoteTimestamp\":\"Timestamp used by relayers to compute this deposit's realizedLPFeePct which is paid to LP pool on HubPool.\",\"recipient\":\"Address to receive funds at on destination chain.\",\"relayerFeePct\":\"% of deposit amount taken out to incentivize a fast relayer.\"}},\"depositFor(address,address,address,uint256,uint256,int64,uint32,bytes,uint256)\":{\"details\":\"DEPRECATION NOTICE: this function is deprecated and will be removed in the future. Please use the other deposit or depositV3 instead.\",\"params\":{\"amount\":\"Amount of tokens to deposit. Will be amount of tokens to receive less fees.\",\"depositor\":\"Address who is credited for depositing funds on origin chain and can speed up the deposit.\",\"destinationChainId\":\"Denotes network where user will receive funds from SpokePool by a relayer.\",\"message\":\"Arbitrary data that can be used to pass additional information to the recipient along with the tokens. Note: this is intended to be used to pass along instructions for how a contract should use or allocate the tokens.\",\"originToken\":\"Token to lock into this contract to initiate deposit.\",\"quoteTimestamp\":\"Timestamp used by relayers to compute this deposit's realizedLPFeePct which is paid to LP pool on HubPool.\",\"recipient\":\"Address to receive funds at on destination chain.\",\"relayerFeePct\":\"% of deposit amount taken out to incentivize a fast relayer.\"}},\"depositNow(bytes32,bytes32,bytes32,bytes32,uint256,uint256,uint256,bytes32,uint32,uint32,bytes)\":{\"params\":{\"depositor\":\"The account credited with the deposit who can request to \\\"speed up\\\" this deposit by modifying the output amount, recipient, and message.\",\"destinationChainId\":\"The destination chain identifier. Must be enabled along with the input token as a valid deposit route from this spoke pool or this transaction will revert.\",\"exclusiveRelayer\":\"The relayer that will be exclusively allowed to fill this deposit before the exclusivity deadline timestamp.\",\"exclusivityParameter\":\"See identically named parameter in deposit() comments.\",\"fillDeadlineOffset\":\"Added to the current time to set the fill deadline, which is the deadline for the relayer to fill the deposit. After this destination chain timestamp, the fill will revert on the destination chain.\",\"inputAmount\":\"The amount of input tokens to pull from the caller's account and lock into this contract. This amount will be sent to the relayer on their repayment chain of choice as a refund following an optimistic challenge window in the HubPool, plus a system fee.\",\"inputToken\":\"The token pulled from the caller's account and locked into this contract to initiate the deposit. The equivalent of this token on the relayer's repayment chain of choice will be sent as a refund. If this is equal to the wrapped native token then the caller can optionally pass in native token as msg.value, as long as msg.value = inputTokenAmount.\",\"message\":\"The message to send to the recipient on the destination chain if the recipient is a contract. If the message is not empty, the recipient contract must implement handleV3AcrossMessage() or the fill will revert.\",\"outputAmount\":\"The amount of output tokens that the relayer will send to the recipient on the destination.\",\"outputToken\":\"The token that the relayer will send to the recipient on the destination chain. Must be an ERC20.\",\"recipient\":\"The account receiving funds on the destination chain. Can be an EOA or a contract. If the output token is the wrapped native token for the chain, then the recipient will receive native token if an EOA or wrapped native token if a contract.\"}},\"depositV3(address,address,address,address,uint256,uint256,uint256,address,uint32,uint32,uint32,bytes)\":{\"details\":\"This version mirrors the original `depositV3` function, but uses `address` types for `depositor`, `recipient`, `inputToken`, `outputToken`, and `exclusiveRelayer` for compatibility with contracts using the `address` type. The key functionality and logic remain identical, ensuring interoperability across both versions.\",\"params\":{\"depositor\":\"The account credited with the deposit who can request to \\\"speed up\\\" this deposit by modifying the output amount, recipient, and message.\",\"destinationChainId\":\"The destination chain identifier. Must be enabled along with the input token as a valid deposit route from this spoke pool or this transaction will revert.\",\"exclusiveRelayer\":\"The relayer exclusively allowed to fill this deposit before the exclusivity deadline.\",\"exclusivityParameter\":\"This value is used to set the exclusivity deadline timestamp in the emitted deposit event. Before this destination chain timestamp, only the exclusiveRelayer (if set to a non-zero address), can fill this deposit. There are three ways to use this parameter: 1. NO EXCLUSIVITY: If this value is set to 0, then a timestamp of 0 will be emitted, meaning that there is no exclusivity period. 2. OFFSET: If this value is less than MAX_EXCLUSIVITY_PERIOD_SECONDS, then add this value to the block.timestamp to derive the exclusive relayer deadline. Note that using the parameter in this way will expose the filler of the deposit to the risk that the block.timestamp of this event gets changed due to a chain-reorg, which would also change the exclusivity timestamp. 3. TIMESTAMP: Otherwise, set this value as the exclusivity deadline timestamp. which is the deadline for the exclusiveRelayer to fill the deposit.\",\"fillDeadline\":\"The deadline for the relayer to fill the deposit. After this destination chain timestamp, the fill will revert on the destination chain. Must be set before currentTime + fillDeadlineBuffer, where currentTime is block.timestamp on this chain.\",\"inputAmount\":\"The amount of input tokens pulled from the caller's account and locked into this contract. This amount will be sent to the relayer as a refund following an optimistic challenge window in the HubPool, less a system fee.\",\"inputToken\":\"The token pulled from the caller's account and locked into this contract to initiate the deposit. The equivalent of this token on the relayer's repayment chain of choice will be sent as a refund. If this is equal to the wrapped native token, the caller can optionally pass in native token as msg.value, provided msg.value = inputTokenAmount.\",\"message\":\"The message to send to the recipient on the destination chain if the recipient is a contract. If the message is not empty, the recipient contract must implement `handleV3AcrossMessage()` or the fill will revert.\",\"outputAmount\":\"The amount of output tokens that the relayer will send to the recipient on the destination.\",\"outputToken\":\"The token that the relayer will send to the recipient on the destination chain. Must be an ERC20.\",\"quoteTimestamp\":\"The HubPool timestamp that determines the system fee paid by the depositor. This must be set between [currentTime - depositQuoteTimeBuffer, currentTime] where currentTime is block.timestamp on this chain.\",\"recipient\":\"The account receiving funds on the destination chain. Can be an EOA or a contract. If the output token is the wrapped native token for the chain, then the recipient will receive native token if an EOA or wrapped native token if a contract.\"}},\"depositV3Now(address,address,address,address,uint256,uint256,uint256,address,uint32,uint32,bytes)\":{\"details\":\"This version is identical to the original `depositV3Now` but uses `address` types for `depositor`, `recipient`, `inputToken`, `outputToken`, and `exclusiveRelayer` to support compatibility with older systems. It maintains the same logic and purpose, ensuring interoperability with both versions.\",\"params\":{\"depositor\":\"The account credited with the deposit, who can request to \\\"speed up\\\" this deposit by modifying the output amount, recipient, and message.\",\"destinationChainId\":\"The destination chain identifier. Must be enabled with the input token as a valid deposit route from this spoke pool, or the transaction will revert.\",\"exclusiveRelayer\":\"The relayer exclusively allowed to fill the deposit before the exclusivity deadline.\",\"exclusivityParameter\":\"See identically named parameter in deposit() comments.\",\"fillDeadlineOffset\":\"Added to the current time to set the fill deadline. After this timestamp, fills on the destination chain will revert.\",\"inputAmount\":\"The amount of input tokens pulled from the caller's account and locked into this contract. This amount will be sent to the relayer as a refund following an optimistic challenge window in the HubPool, plus a system fee.\",\"inputToken\":\"The token pulled from the caller's account and locked into this contract to initiate the deposit. Equivalent tokens on the relayer's repayment chain will be sent as a refund. If this is the wrapped native token, msg.value must equal inputTokenAmount when passed.\",\"message\":\"The message to send to the recipient on the destination chain. If the recipient is a contract, it must implement `handleV3AcrossMessage()` if the message is not empty, or the fill will revert.\",\"outputAmount\":\"The amount of output tokens the relayer will send to the recipient on the destination.\",\"outputToken\":\"The token the relayer will send to the recipient on the destination chain. Must be an ERC20.\",\"recipient\":\"The account receiving funds on the destination chain. Can be an EOA or a contract. If the output token is the wrapped native token for the chain, then the recipient will receive the native token if an EOA or wrapped native token if a contract.\"}},\"emergencyDeleteRootBundle(uint256)\":{\"params\":{\"rootBundleId\":\"Index of the root bundle that needs to be deleted. Note: this is intentionally a uint256 to ensure that a small input range doesn't limit which indices this method is able to reach.\"}},\"executeRelayerRefundLeaf(uint32,(uint256,uint256,uint256[],uint32,address,address[]),bytes32[])\":{\"params\":{\"proof\":\"Inclusion proof for this leaf in relayer refund root in root bundle.\",\"relayerRefundLeaf\":\"Contains all data necessary to reconstruct leaf contained in root bundle and to refund relayer. This data structure is explained in detail in the SpokePoolInterface.\",\"rootBundleId\":\"Unique ID of root bundle containing relayer refund root that this leaf is contained in.\"}},\"executeSlowRelayLeaf(((bytes32,bytes32,bytes32,bytes32,bytes32,uint256,uint256,uint256,uint256,uint32,uint32,bytes),uint256,uint256),uint32,bytes32[])\":{\"details\":\"Executing a slow fill leaf is equivalent to filling the relayData so this function cannot be used to double fill a recipient. The relayData that is filled is included in the slowFillLeaf and is hashed like any other fill sent through a fill method.There is no relayer credited with filling this relay since funds are sent directly out of this contract.\",\"params\":{\"proof\":\"Inclusion proof for this leaf in slow relay root in root bundle.\",\"rootBundleId\":\"Unique ID of root bundle containing slow relay root that this leaf is contained in.\",\"slowFillLeaf\":\"Contains all data necessary to uniquely identify a relay for this chain. This struct is hashed and included in a merkle root that is relayed to all spoke pools. - relayData: struct containing all the data needed to identify the original deposit to be slow filled. - chainId: chain identifier where slow fill leaf should be executed. If this doesn't match this chain's chainId, then this function will revert. - updatedOutputAmount: Amount to be sent to recipient out of this contract's balance. Can be set differently from relayData.outputAmount to charge a different fee because this deposit was \\\"slow\\\" filled. Usually, this will be set higher to reimburse the recipient for waiting for the slow fill.\"}},\"fill(bytes32,bytes,bytes)\":{\"details\":\"ERC-7683 fill function.\",\"params\":{\"fillerData\":\"Data provided by the filler to inform the fill or express their preferences\",\"orderId\":\"Unique order identifier for this order\",\"originData\":\"Data emitted on the origin to parameterize the fill\"}},\"fillRelay((bytes32,bytes32,bytes32,bytes32,bytes32,uint256,uint256,uint256,uint256,uint32,uint32,bytes),uint256,bytes32)\":{\"details\":\"The fee paid to relayers and the system should be captured in the spread between output amount and input amount when adjusted to be denominated in the input token. A relayer on the destination chain will send outputAmount of outputTokens to the recipient and receive inputTokens on a repayment chain of their choice. Therefore, the fee should account for destination fee transaction costs, the relayer's opportunity cost of capital while they wait to be refunded following an optimistic challenge window in the HubPool, and a system fee charged to relayers.The hash of the relayData will be used to uniquely identify the deposit to fill, so modifying any params in it will result in a different hash and a different deposit. The hash will comprise all parameters passed to deposit() on the origin chain along with that chain's chainId(). This chain's chainId() must therefore match the destinationChainId passed into deposit. Relayers are only refunded for filling deposits with deposit hashes that map exactly to the one emitted by the origin SpokePool therefore the relayer should not modify any params in relayData.Cannot fill more than once. Partial fills are not supported.\",\"params\":{\"relayData\":\"struct containing all the data needed to identify the deposit to be filled. Should match all the same-named parameters emitted in the origin chain FundsDeposited event. - depositor: The account credited with the deposit who can request to \\\"speed up\\\" this deposit by modifying the output amount, recipient, and message. - recipient The account receiving funds on this chain. Can be an EOA or a contract. If the output token is the wrapped native token for the chain, then the recipient will receive native token if an EOA or wrapped native token if a contract. - inputToken: The token pulled from the caller's account to initiate the deposit. The equivalent of this token on the repayment chain will be sent as a refund to the caller. - outputToken The token that the caller will send to the recipient on the destination chain. Must be an ERC20. - inputAmount: This amount, less a system fee, will be sent to the caller on their repayment chain of choice as a refund following an optimistic challenge window in the HubPool. - outputAmount: The amount of output tokens that the caller will send to the recipient. - originChainId: The origin chain identifier. - exclusiveRelayer The relayer that will be exclusively allowed to fill this deposit before the exclusivity deadline timestamp. - fillDeadline The deadline for the caller to fill the deposit. After this timestamp, the fill will revert on the destination chain. - exclusivityDeadline: The deadline for the exclusive relayer to fill the deposit. After this timestamp, anyone can fill this deposit. Note that if this value was set in deposit by adding an offset to the deposit's block.timestamp, there is re-org risk for the caller of this method because the event's block.timestamp can change. Read the comments in `deposit` about the `exclusivityParameter` for more details. - message The message to send to the recipient if the recipient is a contract that implements a handleV3AcrossMessage() public function\",\"repaymentAddress\":\"Address the relayer wants to be receive their refund at.\",\"repaymentChainId\":\"Chain of SpokePool where relayer wants to be refunded after the challenge window has passed. Will receive inputAmount of the equivalent token to inputToken on the repayment chain.\"}},\"fillRelayWithUpdatedDeposit((bytes32,bytes32,bytes32,bytes32,bytes32,uint256,uint256,uint256,uint256,uint32,uint32,bytes),uint256,bytes32,uint256,bytes32,bytes,bytes)\":{\"details\":\"Subject to same exclusivity deadline rules as fillV3Relay().\",\"params\":{\"depositorSignature\":\"Signed EIP712 hashstruct containing the deposit ID. Should be signed by the depositor account.\",\"relayData\":\"struct containing all the data needed to identify the deposit to be filled. See fillV3Relay().\",\"repaymentAddress\":\"Address the relayer wants to be receive their refund at.\",\"repaymentChainId\":\"Chain of SpokePool where relayer wants to be refunded after the challenge window has passed. See fillV3Relay().\",\"updatedMessage\":\"New message to use for this deposit.\",\"updatedOutputAmount\":\"New output amount to use for this deposit.\",\"updatedRecipient\":\"New recipient to use for this deposit.\"}},\"getCurrentTime()\":{\"returns\":{\"_0\":\"uint for the current timestamp.\"}},\"getUnsafeDepositId(address,bytes32,uint256)\":{\"details\":\"msgSender and depositor are both used as inputs to allow passthrough depositors to create unique deposit hash spaces for unique depositors.\",\"params\":{\"depositNonce\":\"The nonce used as input to produce the deposit ID.\",\"depositor\":\"The depositor address used as input to produce the deposit ID.\",\"msgSender\":\"The caller of the transaction used as input to produce the deposit ID.\"},\"returns\":{\"_0\":\"The deposit ID for the unsafe deposit.\"}},\"initialize(uint32,address,address)\":{\"params\":{\"_crossDomainAdmin\":\"Cross domain admin to set. Can be changed by admin.\",\"_initialDepositId\":\"Starting deposit ID. Set to 0 unless this is a re-deployment in order to mitigate relay hash collisions.\",\"_withdrawalRecipient\":\"Address which receives token withdrawals. Can be changed by admin. For Spoke Pools on L2, this will likely be the hub pool.\"}},\"pauseDeposits(bool)\":{\"details\":\"Affects `deposit()` but not `speedUpDeposit()`, so that existing deposits can be sped up and still relayed.\",\"params\":{\"pause\":\"true if the call is meant to pause the system, false if the call is meant to unpause it.\"}},\"pauseFills(bool)\":{\"details\":\"Affects fillRelayWithUpdatedDeposit() and fillRelay().\",\"params\":{\"pause\":\"true if the call is meant to pause the system, false if the call is meant to unpause it.\"}},\"proxiableUUID()\":{\"details\":\"Implementation of the ERC1822 {proxiableUUID} function. This returns the storage slot used by the implementation. It is used to validate the implementation's compatibility when performing an upgrade. IMPORTANT: A proxy pointing at a proxiable contract should not be considered proxiable itself, because this risks bricking a proxy that upgrades to it, by delegating to itself until out of gas. Thus it is critical that this function revert if invoked through a proxy. This is guaranteed by the `notDelegated` modifier.\"},\"relayRootBundle(bytes32,bytes32)\":{\"params\":{\"relayerRefundRoot\":\"Merkle root containing relayer refund leaves that can be individually executed via executeRelayerRefundLeaf().\",\"slowRelayRoot\":\"Merkle root containing slow relay fulfillment leaves that can be individually executed via executeSlowRelayLeaf().\"}},\"requestSlowFill((bytes32,bytes32,bytes32,bytes32,bytes32,uint256,uint256,uint256,uint256,uint32,uint32,bytes))\":{\"details\":\"Slow fills are not possible unless the input and output tokens are \\\"equivalent\\\", i.e. they route to the same L1 token via PoolRebalanceRoutes.Slow fills are created by inserting slow fill objects into a merkle tree that is included in the next HubPool \\\"root bundle\\\". Once the optimistic challenge window has passed, the HubPool will relay the slow root to this chain via relayRootBundle(). Once the slow root is relayed, the slow fill can be executed by anyone who calls executeSlowRelayLeaf().Cannot request a slow fill if the fill deadline has passed.Cannot request a slow fill if the relay has already been filled or a slow fill has already been requested.\",\"params\":{\"relayData\":\"struct containing all the data needed to identify the deposit that should be slow filled. If any of the params are missing or different from the origin chain deposit, then Across will not include a slow fill for the intended deposit.\"}},\"setCrossDomainAdmin(address)\":{\"params\":{\"newCrossDomainAdmin\":\"New cross domain admin.\"}},\"setL1GasLimit(uint32)\":{\"params\":{\"newl1Gas\":\"New L1 gas limit to set.\"}},\"setTokenBridge(address,address)\":{\"details\":\"If this mapping isn't set for an L2 token, then the standard bridge will be used to bridge this token.\",\"params\":{\"tokenBridge\":\"Address of token bridge\"}},\"setWithdrawalRecipient(address)\":{\"params\":{\"newWithdrawalRecipient\":\"New withdrawal recipient address.\"}},\"speedUpDeposit(bytes32,uint256,uint256,bytes32,bytes,bytes)\":{\"details\":\"the depositor and depositId must match the params in a FundsDeposited event that the depositor wants to speed up. The relayer has the option but not the obligation to use this updated information when filling the deposit via fillRelayWithUpdatedDeposit().\",\"params\":{\"depositId\":\"Deposit ID to speed up.\",\"depositor\":\"Depositor that must sign the depositorSignature and was the original depositor.\",\"depositorSignature\":\"Signed EIP712 hashstruct containing the deposit ID. Should be signed by the depositor account. If depositor is a contract, then should implement EIP1271 to sign as a contract. See _verifyUpdateV3DepositMessage() for more details about how this signature should be constructed.\",\"updatedMessage\":\"New message to use for this deposit. Can be modified if the recipient is a contract that expects to receive a message from the relay and for some reason needs to be modified.\",\"updatedOutputAmount\":\"New output amount to use for this deposit. Should be lower than previous value otherwise relayer has no incentive to use this updated value.\",\"updatedRecipient\":\"New recipient to use for this deposit. Can be modified if the recipient is a contract that expects to receive a message from the relay and for some reason needs to be modified.\"}},\"speedUpV3Deposit(address,uint256,uint256,address,bytes,bytes)\":{\"details\":\"The `depositor` and `depositId` must match the parameters in a `FundsDeposited` event that the depositor wants to speed up. The relayer is not obligated but has the option to use this updated information when filling the deposit using `fillRelayWithUpdatedDeposit()`. This version uses `address` types for compatibility with systems relying on `address`-based implementations.\",\"params\":{\"depositId\":\"The deposit ID to speed up.\",\"depositor\":\"The depositor that must sign the `depositorSignature` and was the original depositor.\",\"depositorSignature\":\"The signed EIP712 hashstruct containing the deposit ID. Should be signed by the depositor account. If the depositor is a contract, it should implement EIP1271 to sign as a contract. See `_verifyUpdateV3DepositMessage()` for more details on how the signature should be constructed.\",\"updatedMessage\":\"The new message for this deposit. Can be modified if the recipient is a contract that expects to receive a message from the relay and needs to be updated.\",\"updatedOutputAmount\":\"The new output amount to use for this deposit. It should be lower than the previous value, otherwise the relayer has no incentive to use this updated value.\",\"updatedRecipient\":\"The new recipient for this deposit. Can be modified if the original recipient is a contract that expects to receive a message from the relay and needs to be changed.\"}},\"unsafeDeposit(bytes32,bytes32,bytes32,bytes32,uint256,uint256,uint256,bytes32,uint256,uint32,uint32,uint32,bytes)\":{\"details\":\"This is labeled \\\"unsafe\\\" because there is no guarantee that the depositId emitted in the resultant FundsDeposited event is unique which means that the corresponding fill might collide with an existing relay hash on the destination chain SpokePool, which would make this deposit unfillable. In this case, the depositor would subsequently receive a refund of `inputAmount` of `inputToken` on the origin chain after the fill deadline. Re-using a depositNonce is very dangerous when combined with `speedUpDeposit`, as a speed up signature can be re-used for any deposits with the same deposit ID.On the destination chain, the hash of the deposit data will be used to uniquely identify this deposit, so modifying any params in it will result in a different hash and a different deposit. The hash will comprise all parameters to this function along with this chain's chainId(). Relayers are only refunded for filling deposits with deposit hashes that map exactly to the one emitted by this contract.\",\"params\":{\"depositNonce\":\"The nonce that uniquely identifies this deposit. This function will combine this parameter with the msg.sender address to create a unique uint256 depositNonce and ensure that the msg.sender cannot use this function to front-run another depositor's unsafe deposit. This function guarantees that the resultant deposit nonce will not collide with a safe uint256 deposit nonce whose 24 most significant bytes are always 0.\",\"depositor\":\"See identically named parameter in depositV3() comments.\",\"destinationChainId\":\"See identically named parameter in depositV3() comments.\",\"exclusiveRelayer\":\"See identically named parameter in depositV3() comments.\",\"exclusivityParameter\":\"See identically named parameter in depositV3() comments.\",\"fillDeadline\":\"See identically named parameter in depositV3() comments.\",\"inputAmount\":\"See identically named parameter in depositV3() comments.\",\"inputToken\":\"See identically named parameter in depositV3() comments.\",\"message\":\"See identically named parameter in depositV3() comments.\",\"outputAmount\":\"See identically named parameter in depositV3() comments.\",\"outputToken\":\"See identically named parameter in depositV3() comments.\",\"quoteTimestamp\":\"See identically named parameter in depositV3() comments.\",\"recipient\":\"See identically named parameter in depositV3() comments.\"}},\"upgradeTo(address)\":{\"custom:oz-upgrades-unsafe-allow-reachable\":\"delegatecall\",\"details\":\"Upgrade the implementation of the proxy to `newImplementation`. Calls {_authorizeUpgrade}. Emits an {Upgraded} event.\"},\"upgradeToAndCall(address,bytes)\":{\"custom:oz-upgrades-unsafe-allow-reachable\":\"delegatecall\",\"details\":\"Upgrade the implementation of the proxy to `newImplementation`, and subsequently execute the function call encoded in `data`. Calls {_authorizeUpgrade}. Emits an {Upgraded} event.\"}},\"version\":1},\"userdoc\":{\"kind\":\"user\",\"methods\":{\"__OvmSpokePool_init(uint32,address,address,address)\":{\"notice\":\"Construct the OVM SpokePool.\"},\"__SpokePool_init(uint32,address,address)\":{\"notice\":\"Construct the base SpokePool.\"},\"chainId()\":{\"notice\":\"Returns chain ID for this network.\"},\"claimRelayerRefund(bytes32,bytes32)\":{\"notice\":\"Enables a relayer to claim outstanding repayments. Should virtually never be used, unless for some reason relayer repayment transfer fails for reasons such as token transfer reverts due to blacklisting. In this case, the relayer can still call this method and claim the tokens to a new address.\"},\"deposit(bytes32,bytes32,bytes32,bytes32,uint256,uint256,uint256,bytes32,uint32,uint32,uint32,bytes)\":{\"notice\":\"Previously, this function allowed the caller to specify the exclusivityDeadline, otherwise known as the as exact timestamp on the destination chain before which only the exclusiveRelayer could fill the deposit. Now, the caller is expected to pass in a number that will be interpreted either as an offset or a fixed timestamp depending on its value.Request to bridge input token cross chain to a destination chain and receive a specified amount of output tokens. The fee paid to relayers and the system should be captured in the spread between output amount and input amount when adjusted to be denominated in the input token. A relayer on the destination chain will send outputAmount of outputTokens to the recipient and receive inputTokens on a repayment chain of their choice. Therefore, the fee should account for destination fee transaction costs, the relayer's opportunity cost of capital while they wait to be refunded following an optimistic challenge window in the HubPool, and the system fee that they'll be charged.\"},\"depositDeprecated_5947912356(address,address,uint256,uint256,int64,uint32,bytes,uint256)\":{\"notice\":\"Called by user to bridge funds from origin to destination chain. Depositor will effectively lock tokens in this contract and receive a destination token on the destination chain. The origin => destination token mapping is stored on the L1 HubPool.The caller must first approve this contract to spend amount of originToken.The originToken => destinationChainId must be enabled.This method is payable because the caller is able to deposit native token if the originToken is wrappedNativeToken and this function will handle wrapping the native token to wrappedNativeToken.\"},\"depositFor(address,address,address,uint256,uint256,int64,uint32,bytes,uint256)\":{\"notice\":\"The only difference between depositFor and deposit is that the depositor address stored in the relay hash can be overridden by the caller. This means that the passed in depositor can speed up the deposit, which is useful if the deposit is taken from the end user to a middle layer contract, like an aggregator or the SpokePoolVerifier, before calling deposit on this contract.The caller must first approve this contract to spend amount of originToken.The originToken => destinationChainId must be enabled.This method is payable because the caller is able to deposit native token if the originToken is wrappedNativeToken and this function will handle wrapping the native token to wrappedNativeToken.\"},\"depositNow(bytes32,bytes32,bytes32,bytes32,uint256,uint256,uint256,bytes32,uint32,uint32,bytes)\":{\"notice\":\"Submits deposit and sets quoteTimestamp to current Time. Sets fill and exclusivity deadlines as offsets added to the current time. This function is designed to be called by users such as Multisig contracts who do not have certainty when their transaction will mine.\"},\"depositV3(address,address,address,address,uint256,uint256,uint256,address,uint32,uint32,uint32,bytes)\":{\"notice\":\"A version of `deposit` that accepts `address` types for backward compatibility. This function allows bridging of input tokens cross-chain to a destination chain, receiving a specified amount of output tokens. The relayer is refunded in input tokens on a repayment chain of their choice, minus system fees, after an optimistic challenge window. The exclusivity period is specified as an offset from the current block timestamp.\"},\"depositV3Now(address,address,address,address,uint256,uint256,uint256,address,uint32,uint32,bytes)\":{\"notice\":\"A version of `depositNow` that supports addresses as input types for backward compatibility. This function submits a deposit and sets `quoteTimestamp` to the current time. The `fill` and `exclusivity` deadlines are set as offsets added to the current time. It is designed to be called by users, including Multisig contracts, who may not have certainty when their transaction will be mined.\"},\"emergencyDeleteRootBundle(uint256)\":{\"notice\":\"This method is intended to only be used in emergencies where a bad root bundle has reached the SpokePool.\"},\"executeRelayerRefundLeaf(uint32,(uint256,uint256,uint256[],uint32,address,address[]),bytes32[])\":{\"notice\":\"Executes a relayer refund leaf stored as part of a root bundle. Will send the relayer the amount they sent to the recipient plus a relayer fee.\"},\"executeSlowRelayLeaf(((bytes32,bytes32,bytes32,bytes32,bytes32,uint256,uint256,uint256,uint256,uint32,uint32,bytes),uint256,uint256),uint32,bytes32[])\":{\"notice\":\"Executes a slow relay leaf stored as part of a root bundle relayed by the HubPool.\"},\"fill(bytes32,bytes,bytes)\":{\"notice\":\"Fills a single leg of a particular order on the destination chain\"},\"fillRelay((bytes32,bytes32,bytes32,bytes32,bytes32,uint256,uint256,uint256,uint256,uint32,uint32,bytes),uint256,bytes32)\":{\"notice\":\"Fulfill request to bridge cross chain by sending specified output tokens to the recipient.\"},\"fillRelayWithUpdatedDeposit((bytes32,bytes32,bytes32,bytes32,bytes32,uint256,uint256,uint256,uint256,uint32,uint32,bytes),uint256,bytes32,uint256,bytes32,bytes,bytes)\":{\"notice\":\"Identical to fillV3Relay except that the relayer wants to use a depositor's updated output amount, recipient, and/or message. The relayer should only use this function if they can supply a message signed by the depositor that contains the fill's matching deposit ID along with updated relay parameters. If the signature can be verified, then this function will emit a FilledV3Event that will be used by the system for refund verification purposes. In other words, this function is an alternative way to fill a a deposit than fillV3Relay.\"},\"getCurrentTime()\":{\"notice\":\"Gets the current time.\"},\"getUnsafeDepositId(address,bytes32,uint256)\":{\"notice\":\"Returns the deposit ID for an unsafe deposit. This function is used to compute the deposit ID in unsafeDeposit and is provided as a convenience.\"},\"initialize(uint32,address,address)\":{\"notice\":\"Construct the OVM SpokePool.\"},\"pauseDeposits(bool)\":{\"notice\":\"Pauses deposit-related functions. This is intended to be used if this contract is deprecated or when something goes awry.\"},\"pauseFills(bool)\":{\"notice\":\"Pauses fill-related functions. This is intended to be used if this contract is deprecated or when something goes awry.\"},\"relayRootBundle(bytes32,bytes32)\":{\"notice\":\"This method stores a new root bundle in this contract that can be executed to refund relayers, fulfill slow relays, and send funds back to the HubPool on L1. This method can only be called by the admin and is designed to be called as part of a cross-chain message from the HubPool's executeRootBundle method.\"},\"requestSlowFill((bytes32,bytes32,bytes32,bytes32,bytes32,uint256,uint256,uint256,uint256,uint32,uint32,bytes))\":{\"notice\":\"Request Across to send LP funds to this contract to fulfill a slow fill relay for a deposit in the next bundle.\"},\"setCrossDomainAdmin(address)\":{\"notice\":\"Change cross domain admin address. Callable by admin only.\"},\"setL1GasLimit(uint32)\":{\"notice\":\"Change L1 gas limit. Callable only by admin.\"},\"setTokenBridge(address,address)\":{\"notice\":\"Set bridge contract for L2 token used to withdraw back to L1.\"},\"setWithdrawalRecipient(address)\":{\"notice\":\"Change L1 withdrawal recipient address. Callable by admin only.\"},\"speedUpDeposit(bytes32,uint256,uint256,bytes32,bytes,bytes)\":{\"notice\":\"Depositor can use this function to signal to relayer to use updated output amount, recipient, and/or message. The speed up signature uniquely identifies the speed up based only on depositor, deposit ID and origin chain, so using this function in conjunction with unsafeDeposit is risky due to the chance of repeating a deposit ID.\"},\"speedUpV3Deposit(address,uint256,uint256,address,bytes,bytes)\":{\"notice\":\"A version of `speedUpDeposit` using `address` types for backward compatibility. This function allows the depositor to signal to the relayer to use updated output amount, recipient, and/or message when filling a deposit. This can be useful when the deposit needs to be modified after the original transaction has been mined.\"},\"unsafeDeposit(bytes32,bytes32,bytes32,bytes32,uint256,uint256,uint256,bytes32,uint256,uint32,uint32,uint32,bytes)\":{\"notice\":\"See deposit for details. This function is identical to deposit except that it does not use the global deposit ID counter as a deposit nonce, instead allowing the caller to pass in a deposit nonce. This function is designed to be used by anyone who wants to pre-compute their resultant relay data hash, which could be useful for filling a deposit faster and avoiding any risk of a relay hash unexpectedly changing due to another deposit front-running this one and incrementing the global deposit ID counter.\"}},\"notice\":\"World Chain Spoke pool.\",\"version\":1}},\"settings\":{\"compilationTarget\":{\"contracts/WorldChain_SpokePool.sol\":\"WorldChain_SpokePool\"},\"debug\":{\"revertStrings\":\"strip\"},\"evmVersion\":\"shanghai\",\"libraries\":{},\"metadata\":{\"bytecodeHash\":\"ipfs\"},\"optimizer\":{\"enabled\":true,\"runs\":800},\"remappings\":[],\"viaIR\":true},\"sources\":{\"@eth-optimism/contracts/libraries/constants/Lib_PredeployAddresses.sol\":{\"keccak256\":\"0x2bc28307af93e9716151a41a81694b56cbe513ef5eb335fb1d81f35e5db8edfa\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://bbdde142b16f7e0301b7b6a331b35ce609eaf5c9127f14f60c0008abb36e100f\",\"dweb:/ipfs/QmdKUiY6U2vh5egW1bYtvrNhpEmo4Jo4DEwUUmBCfW4eLy\"]},\"@openzeppelin/contracts-upgradeable/crosschain/errorsUpgradeable.sol\":{\"keccak256\":\"0xa1e9b651a2427925598b49ef35da5930abc07859cfac5b9dfb1912f063a024b3\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://c514518c36a3fb1c5f1a99d88857e93160c72ea1fd728c443406ad1acb43ae9a\",\"dweb:/ipfs/Qmc3oXjBNhdeM5cfWpsvewXZAhH34Scgna2W3MvLaiiapQ\"]},\"@openzeppelin/contracts-upgradeable/crosschain/optimism/LibOptimismUpgradeable.sol\":{\"keccak256\":\"0x4e749e196701e221283db53ccaafd372434cdaed2a0b1f5a81b23e36b826b3e8\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://c12147f335d1f8cfee08c853de86d06f63534fe8395f4f0c3c202c045f2ef4d2\",\"dweb:/ipfs/QmNnJzZGLymFtaaKn9zQAtxeNAGmXCDPFyjxzthkUTrKre\"]},\"@openzeppelin/contracts-upgradeable/interfaces/IERC1967Upgradeable.sol\":{\"keccak256\":\"0x47d6e06872b12e72c79d1b5eb55842f860b5fb1207b2317c2358d2766b950a7b\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://ac55bf6f92fc7b90c6d79d346163a0a02bd5c648c7fede08b20e5da96d4ae2a0\",\"dweb:/ipfs/QmQoSrHhka35iKDK5iyNt8cuXXS5ANXVPjLhfsJjktB8V9\"]},\"@openzeppelin/contracts-upgradeable/interfaces/draft-IERC1822Upgradeable.sol\":{\"keccak256\":\"0x77c89f893e403efc6929ba842b7ccf6534d4ffe03afe31670b4a528c0ad78c0f\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://496bd9b3df2455d571018c09f0c6badd29713fdeb907c6aa09d8d28cb603f053\",\"dweb:/ipfs/QmXdJDyYs6WMwMh21dez2BYPxhSUaUYFMDtVNcn2cgFR79\"]},\"@openzeppelin/contracts-upgradeable/proxy/ERC1967/ERC1967UpgradeUpgradeable.sol\":{\"keccak256\":\"0x7795808e3899c805254e3ae58074b20f799b466e3f43e057e47bedee5fb771f8\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://319853a2a682f3f72411507242669ef5e76e0ad3457be53102439709ee8948f0\",\"dweb:/ipfs/QmRtm4Ese9u4jfxXyuWPXLwzenwFotuQjAWV7rXtZTB1E9\"]},\"@openzeppelin/contracts-upgradeable/proxy/beacon/IBeaconUpgradeable.sol\":{\"keccak256\":\"0x24b86ac8c005b8c654fbf6ac34a5a4f61580d7273541e83e013e89d66fbf0908\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://4dbfe1a3b3b3fb64294ce41fd2ad362e7b7012208117864f42c1a67620a6d5c1\",\"dweb:/ipfs/QmVMU5tWt7zBQMmf5cpMX8UMHV86T3kFeTxBTBjFqVWfoJ\"]},\"@openzeppelin/contracts-upgradeable/proxy/utils/Initializable.sol\":{\"keccak256\":\"0x89be10e757d242e9b18d5a32c9fbe2019f6d63052bbe46397a430a1d60d7f794\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://f103ee2e4aecd37aac6ceefe670709cdd7613dee25fa2d4d9feaf7fc0aaa155e\",\"dweb:/ipfs/QmRiNZLoJk5k3HPMYGPGjZFd2ke1ZxjhJZkM45Ec9GH9hv\"]},\"@openzeppelin/contracts-upgradeable/proxy/utils/UUPSUpgradeable.sol\":{\"keccak256\":\"0xefb41f5c1a00249b7a99f0782f8c557865605426a3fb6e5fe9ae334293ae4f33\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://90def55e5782595aabc13f57780c02d3613e5226f20ce6c1709503a63fdeb58f\",\"dweb:/ipfs/Qmb5vcymmNEZUJMaHmYxnhvGJDEsGMae4YjcHwkA74jy99\"]},\"@openzeppelin/contracts-upgradeable/security/ReentrancyGuardUpgradeable.sol\":{\"keccak256\":\"0x2025ccf05f6f1f2fd4e078e552836f525a1864e3854ed555047cd732320ab29b\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://d27f4b23c2dee42394aebaf42bf238285230f472dfd3282a39c3f000ec28214f\",\"dweb:/ipfs/QmQa3DnvccwdWJeWrjgXPnFMTWbzWQWR39hVqC7eEwo2PC\"]},\"@openzeppelin/contracts-upgradeable/token/ERC20/IERC20Upgradeable.sol\":{\"keccak256\":\"0x0e1f0f5f62f67a881cd1a9597acbc0a5e4071f3c2c10449a183b922ae7272e3f\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://c25f742ff154998d19a669e2508c3597b363e123ce9144cd0fcf6521229f401f\",\"dweb:/ipfs/QmQXRuFzStEWqeEPbhQU6cAg9PaSowxJVo4PDKyRod7dco\"]},\"@openzeppelin/contracts-upgradeable/token/ERC20/extensions/IERC20PermitUpgradeable.sol\":{\"keccak256\":\"0x07e881de3b9f6d2c07909f193f24b96c7fe4ea60013260f3f25aecd8bab3c2f8\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://1fed09b97ccb0ff9ba9b6a94224f1d489026bf6b4b7279bfe64fb6e8749dee4d\",\"dweb:/ipfs/QmcRAzaSP1UnGr4vrGkfJmB2L9aiTYoXfV1Lg9gqrVRWn8\"]},\"@openzeppelin/contracts-upgradeable/token/ERC20/utils/SafeERC20Upgradeable.sol\":{\"keccak256\":\"0x23b997be73d3dd46885262704f0f8cfc7273fdadfe303d37969a9561373972b5\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://d03ebe5406134f0c4a017dee625ff615031194493bd1e88504e5c8fae55bc166\",\"dweb:/ipfs/QmUZV5bMbgk2PAkV3coouSeSainHN2jhqaQDJaA7hQRyu2\"]},\"@openzeppelin/contracts-upgradeable/utils/AddressUpgradeable.sol\":{\"keccak256\":\"0x9c80f545915582e63fe206c6ce27cbe85a86fc10b9cd2a0e8c9488fb7c2ee422\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://310136ad60820af4177a11a61d77a3686faf5fca4942b600e08fc940db38396b\",\"dweb:/ipfs/QmbCzMNSTL7Zi7M4UCSqBrkHtp4jjxUnGbkneCZKdR1qeq\"]},\"@openzeppelin/contracts-upgradeable/utils/StorageSlotUpgradeable.sol\":{\"keccak256\":\"0x07ac95acad040f1fb1f6120dd0aa5f702db69446e95f82613721879d30de0908\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://a9df9de7b5da1d1bd3d4b6c073d0174bc4211db60e794a321c8cb5d4eae34685\",\"dweb:/ipfs/QmWe49zj65jayrCe9jZpoWhYUZ1RiwSxyU2s7SBZnMztVy\"]},\"@openzeppelin/contracts-upgradeable/utils/StringsUpgradeable.sol\":{\"keccak256\":\"0xb96dc79b65b7c37937919dcdb356a969ce0aa2e8338322bf4dc027a3c9c9a7eb\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://f8613145881436fc0480fff22da4868d611e2b0c0c3da083334eb4362ce1945a\",\"dweb:/ipfs/QmPqpP3YeRbBdTJRe6Gv2eGsUaANf4J6RwTNRW36iYahfV\"]},\"@openzeppelin/contracts-upgradeable/utils/cryptography/ECDSAUpgradeable.sol\":{\"keccak256\":\"0xa014f65d84b02827055d99993ccdbfb4b56b2c9e91eb278d82a93330659d06e4\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://50a7e716a74f3d48a7f549086faa94afcd58b9f18ac8e9f74af4571f3a1d8d5c\",\"dweb:/ipfs/QmTkDNWkq5o9Cv2jS7s6JvSmsPBkeunZhPe7Z2njGL31wo\"]},\"@openzeppelin/contracts-upgradeable/utils/math/MathUpgradeable.sol\":{\"keccak256\":\"0x2bc0007987c229ae7624eb29be6a9b84f6a6a5872f76248b15208b131ea41c4e\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://2b2835c737d073ef8b82a4cc246495a9740f43e7ff2cf130906b2449ff9bfb91\",\"dweb:/ipfs/QmSCWfNoSvvTN57ic7o1RW6NqSxxGAqbBTnLKc7QHe27qB\"]},\"@openzeppelin/contracts-upgradeable/utils/math/SignedMathUpgradeable.sol\":{\"keccak256\":\"0x88f6b7bba3ee33eeb741f9a0f5bc98b6e6e352d0fe4905377bb328590f84095a\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://88ace2d60f265752f18903d839910be4e4e104340b2957678585b812447825d4\",\"dweb:/ipfs/QmXFkNxMc3AAGzhs2wUEZyErWQjsvoTGyYjuU5oZkFki5Z\"]},\"@openzeppelin/contracts-upgradeable/vendor/optimism/ICrossDomainMessengerUpgradeable.sol\":{\"keccak256\":\"0xb531a6941d55a97d0db7af85c19b6aaf7fc634e550b513daa28e874b2c9b2dfa\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://23b0ce75313d9863512271a51940f6876051a5cb6dce60dd06bc03e565631b9d\",\"dweb:/ipfs/QmZobv3VixcvPxVF6hZgWxo8ELd9nXK935aiBpyHypYSoL\"]},\"@openzeppelin/contracts/interfaces/IERC1271.sol\":{\"keccak256\":\"0x0705a4b1b86d7b0bd8432118f226ba139c44b9dcaba0a6eafba2dd7d0639c544\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://c45b821ef9e882e57c256697a152e108f0f2ad6997609af8904cae99c9bd422e\",\"dweb:/ipfs/QmRKCJW6jjzR5UYZcLpGnhEJ75UVbH6EHkEa49sWx2SKng\"]},\"@openzeppelin/contracts/token/ERC20/IERC20.sol\":{\"keccak256\":\"0x287b55befed2961a7eabd7d7b1b2839cbca8a5b80ef8dcbb25ed3d4c2002c305\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://bd39944e8fc06be6dbe2dd1d8449b5336e23c6a7ba3e8e9ae5ae0f37f35283f5\",\"dweb:/ipfs/QmPV3FGYjVwvKSgAXKUN3r9T9GwniZz83CxBpM7vyj2G53\"]},\"@openzeppelin/contracts/token/ERC20/extensions/IERC20Permit.sol\":{\"keccak256\":\"0xb264c03a3442eb37a68ad620cefd1182766b58bee6cec40343480392d6b14d69\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://28879d01fd22c07b44f006612775f8577defbe459cb01685c5e25cd518c91a71\",\"dweb:/ipfs/QmVgfkwv2Fxw6hhTcDUZhE7NkoSKjab3ipM7UaRbt6uXb5\"]},\"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\":{\"keccak256\":\"0xabefac93435967b4d36a4fabcbdbb918d1f0b7ae3c3d85bc30923b326c927ed1\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://9d213d3befca47da33f6db0310826bcdb148299805c10d77175ecfe1d06a9a68\",\"dweb:/ipfs/QmRgCn6SP1hbBkExUADFuDo8xkT4UU47yjNF5FhCeRbQmS\"]},\"@openzeppelin/contracts/utils/Address.sol\":{\"keccak256\":\"0x006dd67219697fe68d7fbfdea512e7c4cb64a43565ed86171d67e844982da6fa\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://2455248c8ddd9cc6a7af76a13973cddf222072427e7b0e2a7d1aff345145e931\",\"dweb:/ipfs/QmfYjnjRbWqYpuxurqveE6HtzsY1Xx323J428AKQgtBJZm\"]},\"@openzeppelin/contracts/utils/Strings.sol\":{\"keccak256\":\"0x3088eb2868e8d13d89d16670b5f8612c4ab9ff8956272837d8e90106c59c14a0\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://b81d9ff6559ea5c47fc573e17ece6d9ba5d6839e213e6ebc3b4c5c8fe4199d7f\",\"dweb:/ipfs/QmPCW1bFisUzJkyjroY3yipwfism9RRCigCcK1hbXtVM8n\"]},\"@openzeppelin/contracts/utils/cryptography/ECDSA.sol\":{\"keccak256\":\"0x809bc3edb4bcbef8263fa616c1b60ee0004b50a8a1bfa164d8f57fd31f520c58\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://8b93a1e39a4a19eba1600b92c96f435442db88cac91e315c8291547a2a7bcfe2\",\"dweb:/ipfs/QmTm34KVe6uZBZwq8dZDNWwPcm24qBJdxqL3rPxBJ4LrMv\"]},\"@openzeppelin/contracts/utils/cryptography/MerkleProof.sol\":{\"keccak256\":\"0xcf688741f79f4838d5301dcf72d0af9eff11bbab6ab0bb112ad144c7fb672dac\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://85d9c87a481fe99fd28a146c205da0867ef7e1b7edbe0036abc86d2e64eb1f04\",\"dweb:/ipfs/QmR7m1zWQNfZHUKTtqnjoCjCBbNFcjCxV27rxf6iMfhVtG\"]},\"@openzeppelin/contracts/utils/cryptography/SignatureChecker.sol\":{\"keccak256\":\"0x3af3ca86df39aac39a0514c84459d691434a108d2151c8ce9d69f32e315cab80\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://77d1f1cf302cd5e1dfbbb4ce3b281b28e8c52942d4319fce43df2e1b6f02a52d\",\"dweb:/ipfs/QmT6ZXStmK3Knhh9BokeVHQ9HXTBZNgL3Eb1ar1cYg1hWy\"]},\"@openzeppelin/contracts/utils/math/Math.sol\":{\"keccak256\":\"0xe4455ac1eb7fc497bb7402579e7b4d64d928b846fce7d2b6fde06d366f21c2b3\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://cc8841b3cd48ad125e2f46323c8bad3aa0e88e399ec62acb9e57efa7e7c8058c\",\"dweb:/ipfs/QmSqE4mXHA2BXW58deDbXE8MTcsL5JSKNDbm23sVQxRLPS\"]},\"@openzeppelin/contracts/utils/math/SignedMath.sol\":{\"keccak256\":\"0xf92515413956f529d95977adc9b0567d583c6203fc31ab1c23824c35187e3ddc\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://c50fcc459e49a9858b6d8ad5f911295cb7c9ab57567845a250bf0153f84a95c7\",\"dweb:/ipfs/QmcEW85JRzvDkQggxiBBLVAasXWdkhEysqypj9EaB6H2g6\"]},\"contracts/MerkleLib.sol\":{\"keccak256\":\"0xdaf19fdc82593b79a608af8f691aec89a3c0e47b210770deabbe66ece7c35bb1\",\"license\":\"BUSL-1.1\",\"urls\":[\"bzz-raw://03c37f78657beed37257187e237d74492de0199734aa03272a419f66161c0dca\",\"dweb:/ipfs/QmdcXMAoRLZejhh2xcVMWR3WfUvXcArKrCFEE82JDYiJbh\"]},\"contracts/Ovm_SpokePool.sol\":{\"keccak256\":\"0xc46d3c3c1b493137eca6fbe8cd9eae2381cb792945e7ede376cbe15ef95b5454\",\"license\":\"BUSL-1.1\",\"urls\":[\"bzz-raw://7e76ca618799ea810d1fce4449d55ec3bbfbe7482374cf4259755e0103a91c19\",\"dweb:/ipfs/QmVoiCjM4yKCLxe2TNL9i9QViYFCd4f2v9wB37ogtwb6Md\"]},\"contracts/SpokePool.sol\":{\"keccak256\":\"0xc3ef7fff0c2985702bfd44a22f6b3b8b7e6150d37dd3e1db1bc966e892d629a9\",\"license\":\"BUSL-1.1\",\"urls\":[\"bzz-raw://be57513109cc0282ca1c307188c1b03595d547d66ced6d64cdc9040f19171f2a\",\"dweb:/ipfs/QmcoNGPYJk6e24Ma5T5wPaz2nXtPxqd1WQHjfXUXVHKegX\"]},\"contracts/WorldChain_SpokePool.sol\":{\"keccak256\":\"0xb70316e7560e04c79acdb9e4550567b0d96877d6d62637effa5c3ff7443af8bd\",\"license\":\"BUSL-1.1\",\"urls\":[\"bzz-raw://010c34b5e1df625843a129b5503cb99a1db910ab96542fbbf6731ec81b86bb5e\",\"dweb:/ipfs/QmPztgbFieX6axTtLPc15NusRZcKKu3dWxh63DeyaAhTub\"]},\"contracts/erc7683/ERC7683.sol\":{\"keccak256\":\"0x726d0426b0f3a11ff59d3a5bbe433c182c0feac9ea2c8c75377fcc2693eccded\",\"license\":\"GPL-3.0-or-later\",\"urls\":[\"bzz-raw://99336cc59dd5923815a8fad6e200b7b265e8446414b099e9b17e3f15f094b774\",\"dweb:/ipfs/QmWCrqefGqEpKsvfn1oBzTTUAFBjscjHc6g1EX2ab51bGA\"]},\"contracts/erc7683/ERC7683Permit2Lib.sol\":{\"keccak256\":\"0x47bf69c597fd6735fd4bb24c42d78a2c967d9bce0c303fe0a8ddafe6d2321f94\",\"license\":\"UNLICENSED\",\"urls\":[\"bzz-raw://d37b60c5b94d9bb29c42d41dd18dacbc54649921d5cdf85d8c20bb4e43c415b9\",\"dweb:/ipfs/QmZFhiKWztX7UTG6w4wrcK5LSaMHFKH7NxVgrzkxV24bEs\"]},\"contracts/external/interfaces/CCTPInterfaces.sol\":{\"keccak256\":\"0x69059bd91cdb9bea59242c543a167e38a9f3a7788687d4194f68420a956c7608\",\"license\":\"GPL-3.0-or-later\",\"urls\":[\"bzz-raw://0d0781aeb87d7f860ab9ff49c6c6af60b0e93fb547108b98ba8c8501c3980104\",\"dweb:/ipfs/QmY9H7YiXn3a8jdQgcADboxSEsi5V4F7CPcJrWNbxGToAu\"]},\"contracts/external/interfaces/IPermit2.sol\":{\"keccak256\":\"0x68f40961ee44fbc71eff2037f2c88ba9bfbccf35b9b1eae5a527b71d19bf3a71\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://2281f309f1b0df4d1c9beeeaa2673152c73e6e20991438420a9de18c51269ea7\",\"dweb:/ipfs/QmafDC3g5yBqPvSof5FmGKv4gMR3TXT5Xj3tULDA5CKmaE\"]},\"contracts/external/interfaces/WETH9Interface.sol\":{\"keccak256\":\"0x3f7892554ec7f54681fdd3cc18a41346c246c9c1afba016c52990ef77741f718\",\"license\":\"BUSL-1.1\",\"urls\":[\"bzz-raw://76e901f8da798eb2fdef8fd0083a51088103269f08ee751598c5a6eba407785f\",\"dweb:/ipfs/QmcAHbwbwCZd78teaK4cHuAvXq71aWX1r9vTGkSRRBDJV1\"]},\"contracts/interfaces/HubPoolInterface.sol\":{\"keccak256\":\"0xd8cfdded5db9bf29099e91abd8c8992b4deba1a22d4ffaed94c43ff3d47dcf33\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://aeefb0b7816fbfe2f63968f34726155d30b0428558df9a20f839042795b24c82\",\"dweb:/ipfs/QmT5uYJenMLkiBEWtzdEZ4SnsysAhQ9uyHdx3pKNU1gyVy\"]},\"contracts/interfaces/SpokePoolInterface.sol\":{\"keccak256\":\"0x67734f330d9b5eb5f7ea7f9f32d2d1cc107879154e9c9424623c6df1709b48e0\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://d80f8ef8f10046624d7ab588538f041bab0c18e475e90b287505d5feae52578f\",\"dweb:/ipfs/QmS7QbHqygik4H6BSm1Cvypx8cWB6QxoHSPZ3FAVDkgYQj\"]},\"contracts/interfaces/SpokePoolMessageHandler.sol\":{\"keccak256\":\"0xc522e2ee6d874df26cae297fc23fc6e8b5216fc8d1901299bb147a25a8c6c259\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://8942693e1cef207ae68750884e9e3c221df24dafe897af0ae6a1339e17391c29\",\"dweb:/ipfs/QmSCSQ5DNBetH8xUa73vWXR3D4CdsV6hHFmDqtT2QwLuWt\"]},\"contracts/interfaces/V3SpokePoolInterface.sol\":{\"keccak256\":\"0x15819fd7ff7b33d3fc55de30a5eb1136dfbcf953be2a962dddc550d77e1823fe\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://4f8c43279c38b718fe471171f8dd2eb9f6e8550b939ce65c7c71f0aa6233c421\",\"dweb:/ipfs/QmXFCLp8jWNKi7QRYTN9ZyNoxsTL1RZfJPLMYzUN9xQC9K\"]},\"contracts/libraries/AddressConverters.sol\":{\"keccak256\":\"0x378f28bb4a17a5c47457cb9341086b2140f7faf6c048f702d3528166f0d74453\",\"license\":\"BUSL-1.1\",\"urls\":[\"bzz-raw://0fa273e028c9555202cac439ddf458d074b66c6f74778b2b0e5e17a0e331dc38\",\"dweb:/ipfs/QmYqEaWXgiJnsH8wRAuTKF41bxkxxvY947wdKoZrjM7HVx\"]},\"contracts/libraries/CircleCCTPAdapter.sol\":{\"keccak256\":\"0x5007254d87c41857f737ddee8b06ef5838182acf6c593f8cc7ced972e03feecb\",\"license\":\"BUSL-1.1\",\"urls\":[\"bzz-raw://6559694d840b3fdbef6da3079478e0ffc168fef81a568633ecb2b9fb860caf34\",\"dweb:/ipfs/QmNnnB5pr745DFZTfDsFSq3BJi2DooaRM8f31qGwXNjLrb\"]},\"contracts/upgradeable/AddressLibUpgradeable.sol\":{\"keccak256\":\"0x655040da45a857cf609d7176c7b0647bf76d36e73e856af79d511014c7e8ef81\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://5c17767f34d57380767b49f8584d62598964fc813e6f3587d76b51ec2357bb4e\",\"dweb:/ipfs/QmSyoTa1Snn3KiJD7KjCwsPmNqpJzusXterbEXxbYCZoJK\"]},\"contracts/upgradeable/EIP712CrossChainUpgradeable.sol\":{\"keccak256\":\"0xff617722706d1c0a6d346e56e4598cc5f60adea99b4ac1d2347dcd69270a14f6\",\"license\":\"BUSL-1.1\",\"urls\":[\"bzz-raw://e2d04649c09bad766c5632da2e3a4f1deed1e013e8b713fad1f101e06f4b56a3\",\"dweb:/ipfs/QmfCewdTDr2krzvNY5rH5BprngEtBmxPXCZf6JKavxw2Sb\"]},\"contracts/upgradeable/MultiCallerUpgradeable.sol\":{\"keccak256\":\"0xc1378a7d63785d9381b8fb6e42962499ab26a243292e20981c2792511a4697f3\",\"license\":\"BUSL-1.1\",\"urls\":[\"bzz-raw://2ec8d733e528d6e79732409eb04aa5f8a8bcdf5888e677919a07d8b84afb1598\",\"dweb:/ipfs/QmQF23Gf9vHb6Ne6kaEZmQTjobWzasEWWr5YaBFkuEypz4\"]}},\"version\":1}",
- "bytecode": "0x61018060409080825234620002b85760a081620056ac8038038091620000268285620002bc565b833981010312620002b85780516001600160a01b038082169391849003620002b85760209162000058838501620002e0565b9162000066828601620002e0565b6060860151958287168703620002b857608001519382851697888603620002b8573060805260a05260c05260e0525f5460ff8160081c16620002b85760ff808216036200027f575b506101209485526101409283525f610100908152825163011a412160e61b8682019081526004825291976001600160401b039282860191908483118484101762000261575f938493885251915afa943d1562000275573d918211620002615783519162000125601f8201601f1916830184620002bc565b82523d5f8284013e5b8562000255575b8562000220575b50505061016092835251926153b99485620002f38639608051858181610f85015281816114a101526115cd015260a051858181610860015281816136d80152818161383701528181613e58015281816140ea015281816143b90152818161482401528181614bcd0152614bf4015260c0518581816117d50152818161368c0152614572015260e05185818161044e015261436201525184818161197e0152818161510e01526151b901525183818161080301528181614b700152614fef015251828181611e7e015281816149420152615012015251818181611a7c01526150ae0152f35b90919294508082519201519181811062000244575b5050161515915f80806200013c565b5f19910360031b1b165f8062000235565b81518114955062000135565b634e487b7160e01b5f52604160045260245ffd5b606091506200012e565b60ff90811916175f557f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb384740249884835160ff8152a15f620000ae565b5f80fd5b601f909101601f19168101906001600160401b038211908210176200026157604052565b519063ffffffff82168203620002b85756fe6080604052600436101561001a575b3615610018575f80fd5b005b5f3560e01c8063079bd2c71461041f5780630c5d5f731461041a5780630eaac9f0146104155780631186ec331461041057806311eac8551461040b57806315348e44146103a257806317fcb39b146104065780631b3d5559146104015780631fab657c146103fc57806329cb924d146103f75780632e378115146103f25780632e63e59a146103ed5780633659cfe6146103e8578063431023b8146103e3578063437b9116146103de578063490e49ef146103d9578063493a4f84146103d45780634f1ef286146103cf5780635285e058146103ca57806352d1902d146103c5578063541f4f14146103c0578063577f51f8146103bb57806357f6dcb8146103b65780636068d6cb146103b1578063647c576c146103ac578063670fa8ac146103a75780636bbbcd2e146103a25780636e4009831461039d578063738b62e514610398578063766e070314610393578063775c0d031461038e5780637aef642c146103895780637b939232146103845780637ef413e11461037f57806382e2c43f1461037a5780638a7860ce146103755780638b15788e14610370578063927ede2d1461036b5780639748cf7c1461036657806397943aa914610361578063979f2bc21461035c57806399cc2968146103575780639a8a059214610352578063a1244c671461034d578063a18a096e14610348578063ac9650d814610343578063ad5425c61461033e578063adb5a6a6146102f3578063b27a430014610339578063b370b7f514610334578063babb6aac1461032f578063bf10268d1461032a578063c35c83fc14610325578063ceb4c98714610320578063d7e1583a1461031b578063dda5211314610316578063ddd224f114610311578063de7eba781461030c578063deff4b2414610307578063e322921114610302578063ea86bd46146102fd578063ee2a53f8146102f8578063f79f29ed146102f3578063fbbba9ac146102ee5763fc8a584f0361000e57612af3565b612a6f565b61242e565b612a31565b61292e565b612905565b612810565b6127e0565b6127b7565b612791565b61275b565b612661565b612636565b6125b2565b6124db565b6124b4565b612475565b6122cd565b61222d565b6120c6565b61209f565b612085565b611ff0565b611f22565b611ea2565b611e5f565b611e31565b611db3565b611d3b565b611c20565b611be9565b611b41565b611aa1565b611a65565b611a41565b6119ac565b611962565b610827565b611928565b611851565b6117f9565b6117b9565b6116e0565b61161d565b6115b3565b61158c565b61145e565b6113d7565b6113b9565b6112ec565b61108f565b610f5d565b610d63565b610c03565b610bda565b610ad8565b6109cf565b610841565b6107e4565b610743565b6104f6565b610490565b610432565b5f91031261042e57565b5f80fd5b3461042e575f36600319011261042e57602060405163ffffffff7f0000000000000000000000000000000000000000000000000000000000000000168152f35b6001600160a01b0381160361042e57565b359061048e82610472565b565b3461042e57602036600319011261042e5760206004356104af81610472565b6001600160a01b038091165f52610c5d825260405f205416604051908152f35b63ffffffff81160361042e57565b610144359061048e826104cf565b359061048e826104cf565b3461042e57602036600319011261042e5763ffffffff600435610518816104cf565b610520613501565b6105286135c3565b16610c5a8163ffffffff198254161790557fe486a5c4bd7b36eabbfe274c99b39130277417be8d2209b4dae04c4fba64ee3a5f80a26001606555005b634e487b7160e01b5f52604160045260245ffd5b6040810190811067ffffffffffffffff82111761059457604052565b610564565b6101a0810190811067ffffffffffffffff82111761059457604052565b67ffffffffffffffff811161059457604052565b6060810190811067ffffffffffffffff82111761059457604052565b6080810190811067ffffffffffffffff82111761059457604052565b6020810190811067ffffffffffffffff82111761059457604052565b60e0810190811067ffffffffffffffff82111761059457604052565b60a0810190811067ffffffffffffffff82111761059457604052565b90601f8019910116810190811067ffffffffffffffff82111761059457604052565b6040519060c0820182811067ffffffffffffffff82111761059457604052565b60405190610180820182811067ffffffffffffffff82111761059457604052565b6040519061048e82610599565b6040519061048e826105e6565b67ffffffffffffffff811161059457601f01601f191660200190565b9291926106fb826106d3565b916107096040519384610656565b82948184528183011161042e578281602093845f960137010152565b9080601f8301121561042e57816020610740933591016106ef565b90565b61010036600319011261042e5760043561075c81610472565b60243561076881610472565b6084358060070b810361042e5760a43590610782826104cf565b60c43567ffffffffffffffff811161042e576107a2903690600401610725565b926107ab6135c3565b60ff61086b5460e81c166107d2576107cb9460643591604435913361363e565b6001606555005b604051630b4cba3160e31b8152600490fd5b3461042e575f36600319011261042e5760206040516001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000168152f35b3461042e575f36600319011261042e5760206040515f8152f35b3461042e575f36600319011261042e5760206040516001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000168152f35b67ffffffffffffffff81116105945760051b60200190565b9080601f8301121561042e5760209082356108b681610884565b936108c46040519586610656565b81855260208086019260051b82010192831161042e57602001905b8282106108ed575050505090565b813581529083019083016108df565b9080601f8301121561042e57602090823561091681610884565b936109246040519586610656565b81855260208086019260051b82010192831161042e57602001905b82821061094d575050505090565b838091833561095b81610472565b81520191019061093f565b929161097182610884565b9161097f6040519384610656565b829481845260208094019160051b810192831161042e57905b8282106109a55750505050565b81358152908301908301610998565b9080601f8301121561042e5781602061074093359101610966565b60031960603682011261042e576004356109e8816104cf565b60243567ffffffffffffffff9283821161042e5760c090823603011261042e57610a10610678565b908060040135825260248101356020830152604481013584811161042e57610a3e906004369184010161089c565b6040830152610a4f606482016104eb565b6060830152610a6060848201610483565b608083015260a48101359084821161042e576004610a8192369201016108fc565b60a082015260443592831161042e57610aa16100189336906004016109b4565b91612b23565b9181601f8401121561042e5782359167ffffffffffffffff831161042e576020808501948460051b01011161042e57565b3461042e5760031960603682011261042e5760043567ffffffffffffffff80821161042e5760608236039384011261042e5760243590610b17826104cf565b60443590811161042e57610b2f903690600401610aa7565b919093610b3a6135c3565b600484013590610182190181121561042e57610bd094610bcb93610b67610bc4936004369189010161267f565b95610b7d610b786080890151613b84565b61382d565b610b8687613434565b9060446020890151916101608a015193610b9e610678565b9a8b5260208b015201356040890152606088015260808701525f60a08701523691610966565b9083613b9a565b613ceb565b6100186001606555565b3461042e575f36600319011261042e576020604051428152f35b908161018091031261042e5790565b3461042e57604036600319011261042e5760043567ffffffffffffffff811161042e57610c34903690600401610bf4565b610c3d81612d1b565b6001600160a01b031690610c5360208201612d1b565b6001600160a01b031691610c6960408301612d1b565b6001600160a01b0316610c7e60608401612d1b565b6001600160a01b031692610c9460808201612d1b565b6001600160a01b031690610100610cac818301612d25565b9061012090610cbc848301612d25565b9261014094858101610ccd90612d25565b966101609a8b8301610cdf9084612d2f565b9a909b610cea610698565b9e8f91825260208201526040015260608d015260808c015260a081013560a08c015260c081013560c08c015260e0013560e08b015263ffffffff1690890152870190610d3b919063ffffffff169052565b63ffffffff909116908501523690610d52926106ef565b908201523360243561001892613465565b3461042e57602036600319011261042e576004803567ffffffffffffffff811161042e57610d949036908301610bf4565b610d9c6135c3565b60ff61086b5460e01c16610f4d5763ffffffff80421692610140830193610dd581610dc687612d25565b63ffffffff9182169116101590565b610f3d57610120840192610de884612d25565b1610610f2e57610e00610dfb368561267f565b613434565b90610e14825f5261087260205260405f2090565b54610f205750610e637f3cee3e290f36226751cd0b3321b213890fe9c768e922f267fa6111836ce05c3292610e5e610e58610e69945f5261087260205260405f2090565b60019055565b612d25565b93612d25565b610e89610e84610e7d610160860186612d2f565b36916106ef565b6141c0565b90610f136040519283926101008701359760e08801359760208101359281359260408301359260c08101359060a081013590606060808201359101358b9693909a999895919261012098959361014089019c895260208901526040880152606087015263ffffffff80921660808701521660a085015260c084015260e08301526101008201520152565b0390a36100186001606555565b604051624be79160e21b8152fd5b60405163d642b7d960e01b8152fd5b50604051630277ae7b60e21b8152fd5b50604051633d90fc5560e11b8152fd5b3461042e57602036600319011261042e57600435610f7a81610472565b6001600160a01b03807f00000000000000000000000000000000000000000000000000000000000000001680301461042e577f360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc90828254160361042e57610fdf613501565b60405191610fec83610602565b5f83527f4910fdfa16fed3260ed0e7147f7cc6da11a60208b5b9406d12a635614ffd91435460ff16156110255750505061001890614d8c565b6020600491604051928380926352d1902d60e01b825288165afa5f918161105e575b50611050575f80fd5b0361042e5761001891614c73565b61108191925060203d602011611088575b6110798183610656565b810190613987565b905f611047565b503d61106f565b3461042e57608036600319011261042e576004356110ac816104cf565b602435906110b982610472565b6044356110c581610472565b606435916110d283610472565b60ff5f5460081c161561042e5761111990610c5a624c4b4063ffffffff1982541617905561086b9063ffffffff60c01b1963ffffffff60c01b83549260c01b169116179055565b6040519061112682610578565b6009825260208201916820a1a927a9a996ab1960b91b8352640312e302e360dc1b602060405161115581610578565b60058152015260ff5f5460081c161561042e57610018946111ba936111b59251902061047f557f06c015bd22b4c69690933c1058878ebdfef31f9aaae40bbe86d8a09fe1b2972c610480556111a8614599565b6111b06145a8565b6145bc565b614616565b610c5a9077ffffffffffffffffffffffffffffffffffffffff000000001977ffffffffffffffffffffffffffffffffffffffff0000000083549260201b169116179055565b602060031982011261042e576004359067ffffffffffffffff821161042e5761122a91600401610aa7565b9091565b5f5b83811061123f5750505f910152565b8181015183820152602001611230565b906020916112688151809281855285808601910161122e565b601f01601f1916010190565b6020808201908083528351809252604092604081018260408560051b8401019601945f925b8584106112aa575050505050505090565b9091929394959685806112db600193603f1986820301885286838d518051151584520151918185820152019061124f565b990194019401929594939190611299565b3461042e576112fa366111ff565b61130381610884565b9160406113136040519485610656565b828452601f1961132284610884565b015f5b8181106113965750505f5b83811061134957604051806113458782611274565b0390f35b8061139061135960019388612d85565b515f80611367858a8a612d99565b90611376895180938193612db0565b0390305af490611384612dbd565b60208201529015159052565b01611330565b60209083516113a481610578565b5f815282606081830152828901015201611325565b3461042e575f36600319011261042e5760206040516301e133808152f35b3461042e57604036600319011261042e576024356004356113f6613501565b6113fe6135c3565b61086c8054680100000000000000008110156105945763ffffffff916001820190558361142a826129f2565b5084600182015555167fc86ba04c55bc5eb2f2876b91c438849a296dbec7b08751c3074d92e04f0a77af5f80a46001606555005b604036600319011261042e5760043561147681610472565b60243567ffffffffffffffff811161042e57611496903690600401610725565b6001600160a01b03807f0000000000000000000000000000000000000000000000000000000000000000169081301461042e577f360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc91818354160361042e576114fc613501565b7f4910fdfa16fed3260ed0e7147f7cc6da11a60208b5b9406d12a635614ffd91435460ff16156115325750505061001890614d8c565b6020600491604051928380926352d1902d60e01b825288165afa5f918161156b575b5061155d575f80fd5b0361042e5761001891614d3b565b61158591925060203d602011611088576110798183610656565b905f611554565b3461042e575f36600319011261042e5760206001600160a01b036108695416604051908152f35b3461042e575f36600319011261042e576001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016300361042e5760206040517f360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc8152f35b61012036600319011261042e5760043561163681610472565b6024359061164382610472565b6044359161165083610472565b60a4358060070b810361042e5760c4359161166a836104cf565b60e43567ffffffffffffffff811161042e5761168a903690600401610725565b936116936135c3565b60ff61086b5460e81c166107d2576107cb95608435926064359261363e565b9181601f8401121561042e5782359167ffffffffffffffff831161042e576020838186019501011161042e57565b3461042e5760c036600319011261042e576004356116fd81610472565b6024356044359160643561171081610472565b67ffffffffffffffff9160843583811161042e576117329036906004016116b2565b60a49491943591821161042e577f45e04bc8f121ba11466985789ca2822a91109f31bb8ac85504a37b7eaf873c26946117726117b49336906004016116b2565b9290916001600160a01b038097166117a68a8c836117913688886106ef565b9161179d368b8b6106ef565b9346908d6141d5565b604051978897169a87612e0c565b0390a3005b3461042e575f36600319011261042e57602060405163ffffffff7f0000000000000000000000000000000000000000000000000000000000000000168152f35b3461042e575f36600319011261042e57602060ff61086b5460e81c166040519015158152f35b606090600319011261042e57600435611837816104cf565b9060243561184481610472565b9060443561074081610472565b3461042e5761185f3661181f565b5f54600881901c60ff161593929084908161191a575b81156118fa575b501561042e576118a09284611897600160ff195f5416175f55565b6118e357612e3f565b6118a657005b6118b461ff00195f54165f55565b604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb384740249890602090a1005b6118f561010061ff00195f5416175f55565b612e3f565b303b1591508161190c575b505f61187c565b6001915060ff16145f611905565b600160ff8216109150611875565b3461042e575f36600319011261042e5760206040517f8d1994e2bbbd77564cdca06dd819e7ee2a5efa06c80dcb59a4a7b6e39edc538f8152f35b3461042e575f36600319011261042e57602060405163ffffffff7f0000000000000000000000000000000000000000000000000000000000000000168152f35b8015150361042e57565b3461042e57602036600319011261042e577fe88463c2f254e2b070013a2dc7ee1e099f9bc00534cbdf03af551dc26ae4921960206004356119ec816119a2565b6119f4613501565b6119fc6135c3565b151561086b80547fffff00ffffffffffffffffffffffffffffffffffffffffffffffffffffffffff60ff60e81b8460e81b169116179055604051908152a16001606555005b3461042e575f36600319011261042e57602063ffffffff610c5a5416604051908152f35b3461042e575f36600319011261042e5760206040517f000000000000000000000000000000000000000000000000000000000000000015158152f35b61016036600319011261042e57600435611aba81610472565b60243590611ac782610472565b604435611ad381610472565b60643590611ae082610472565b60e435611aec81610472565b6101043590611afa826104cf565b6101243592611b08846104cf565b610144359667ffffffffffffffff881161042e57611b2d6100189836906004016116b2565b97909660c4359360a4359360843593612f85565b61018036600319011261042e57600435611b5a81610472565b60243590611b6782610472565b604435611b7381610472565b60643590611b8082610472565b60e435611b8c81610472565b61010435611b99816104cf565b6101243591611ba7836104cf565b611baf6104dd565b93610164359767ffffffffffffffff891161042e57611bd56100189936906004016116b2565b98909760c4359360a4359360843593612fa7565b3461042e57606036600319011261042e576020611c18600435611c0b81610472565b60443590602435906130c2565b604051908152f35b3461042e57606036600319011261042e5767ffffffffffffffff60243581811161042e57611c529036906004016116b2565b9160443590811161042e57611c6b9036906004016116b2565b9060405193602085019480611c824684888a6130fe565b0395611c96601f1997888101845283610656565b6004359151902003611d29575f94611cc5611ce793611cbc87611cf3958a990190612735565b9581019061311b565b519360405193849160208301966337bfd2c960e21b88523391602485016131e3565b03908101835282610656565b5190305af4611d00612dbd565b9015611d0857005b60405163b8fe37a760e01b8152908190611d259060048301613205565b0390fd5b604051630f0c8f4760e11b8152600490fd5b3461042e57602036600319011261042e57600435611d57613501565b611d5f6135c3565b611d68816129f2565b611da0576001815f80935501557f7c1af0646963afc3343245b103731965735a893347bfa0d58a5dc77a77ae691c5f80a26001606555005b634e487b7160e01b5f525f60045260245ffd5b6101a036600319011261042e5761012435611dcd816104cf565b61014435611dda816104cf565b6101643591611de8836104cf565b610184359267ffffffffffffffff841161042e57611e0d6100189436906004016116b2565b9390926101043560e43560c43560a435608435606435604435602435600435613216565b3461042e575f36600319011261042e5760206040517342000000000000000000000000000000000000078152f35b3461042e575f36600319011261042e5760206040516001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000168152f35b3461042e5760e036600319011261042e5767ffffffffffffffff60043581811161042e57611ed4903690600401610bf4565b60a43582811161042e57611eec9036906004016116b2565b60c49291923593841161042e57611f0a6100189436906004016116b2565b9390926084359060643590604435906024359061328e565b3461042e57611f303661181f565b909160ff5f5460081c161561042e57611f669061086b9063ffffffff60c01b1963ffffffff60c01b83549260c01b169116179055565b604051611f7281610578565b6009815260208101926820a1a927a9a996ab1960b91b8452640312e302e360dc1b6020604051611fa181610578565b60058152015260ff5f5460081c161561042e57610018936111b59251902061047f557f06c015bd22b4c69690933c1058878ebdfef31f9aaae40bbe86d8a09fe1b2972c610480556111a8614599565b3461042e57602036600319011261042e577f2d5b62420992e5a4afce0e77742636ca2608ef58289fd2e1baa5161ef6e7e41e6020600435612030816119a2565b612038613501565b6120406135c3565b151561086b80547fffffff00ffffffffffffffffffffffffffffffffffffffffffffffffffffffff60ff60e01b8460e01b169116179055604051908152a16001606555005b3461042e575f36600319011261042e576020604051468152f35b3461042e575f36600319011261042e57602063ffffffff61086b5460c01c16604051908152f35b3461042e57604036600319011261042e576004356024356120e682614b97565b6001600160a01b0382165f5261087360205261211560405f20336001600160a01b03165f5260205260405f2090565b549182156121b8575f61215c3361214661212e85613b84565b6001600160a01b03165f5261087360205260405f2090565b906001600160a01b03165f5260205260405f2090565b556121888361217961216d84613b84565b6001600160a01b031690565b61218285613b84565b90614670565b60405192835233927f6c172ea51018fb2eb2118f3f8a507c4df71eb519b8c0052834dc3c920182fef490602090a4005b6040516336542bf760e21b8152600490fd5b6020808201906020835283518092526040830192602060408460051b8301019501935f915b8483106121ff5750505050505090565b909192939495848061221d600193603f198682030187528a5161124f565b98019301930191949392906121ef565b3461042e5761223b366111ff565b9061224582613377565b915f5b81811061225d576040518061134586826121ca565b5f8061226a838587612d99565b9061227a60405180938193612db0565b0390305af4612287612dbd565b90156122ad579060019161229b8287612d85565b526122a68186612d85565b5001612248565b604481511061042e5780600461042e9201516024809183010191016133c0565b6101808060031936011261042e57610104356122e8816104cf565b61012435916122f6836104cf565b6101443592612304846104cf565b6101643567ffffffffffffffff811161042e576123259036906004016116b2565b61232d6135c3565b61086b549260ff8460e81c166107d257610bd0966123f2610e7d926123e463ffffffff6124009860c01c16996123886123658c61341f565b61086b9063ffffffff60c01b1963ffffffff60c01b83549260c01b169116179055565b6123906106b9565b9a6004358c5260243560208d015260443560408d015260643560608d015260843560808d015260a43560a08d015260c43560c08d015260e43560e08d01526101008c01526101208b019063ffffffff169052565b63ffffffff16610140890152565b63ffffffff16610160870152565b90820152614307565b604090600319011261042e5760043561242181610472565b9060243561074081610472565b3461042e57602061246c6001600160a01b0361244936612409565b91165f52610873835260405f20906001600160a01b03165f5260205260405f2090565b54604051908152f35b3461042e57602036600319011261042e57602060043561249481610472565b6001600160a01b038091165f52610c5c825260405f205416604051908152f35b3461042e575f36600319011261042e5760206001600160a01b0361086a5416604051908152f35b3461042e5760c036600319011261042e5760043560243567ffffffffffffffff60643560443560843583811161042e576125199036906004016116b2565b60a49491943591821161042e577f45e04bc8f121ba11466985789ca2822a91109f31bb8ac85504a37b7eaf873c26946125596125a89336906004016116b2565b9290916125646135c3565b61256d8a614b97565b61259c898b898961257f3688886106ef565b9261258b368b8b6106ef565b946001600160a01b034692166141d5565b60405196879687612e0c565b0390a36001606555005b3461042e576125c036612409565b906125c9613501565b6125d16135c3565b6001600160a01b0380911691825f52610c5d6020526126098160405f20906001600160a01b03166001600160a01b0319825416179055565b16907fcb84c2022106a6f2b6f805d446f32fbfd2a528474364fa755f37dac1c0c1b6c85f80a36001606555005b3461042e57602036600319011261042e576004355f52610872602052602060405f2054604051908152f35b3461042e575f36600319011261042e57602060405163ffffffff8152f35b91906101808382031261042e57612694610698565b92803584526020810135602085015260408101356040850152606081013560608501526080810135608085015260a081013560a085015260c081013560c085015260e081013560e085015261010080820135908501526101206126f88183016104eb565b9085015261014061270a8183016104eb565b90850152610160918282013567ffffffffffffffff811161042e5761272f9201610725565b90830152565b9060208282031261042e57813567ffffffffffffffff811161042e57610740920161267f565b3461042e57602036600319011261042e5760043567ffffffffffffffff811161042e57611c18610dfb602092369060040161267f565b3461042e575f36600319011261042e57602060ff61086b5460e01c166040519015158152f35b3461042e575f36600319011261042e5760206040516ec097ce7bc90715b34b9f10000000008152f35b3461042e57602036600319011261042e576107cb60043561280081610472565b612808613501565b6111b06135c3565b3461042e57606036600319011261042e5760043567ffffffffffffffff811161042e5761284190369060040161267f565b6128496135c3565b60ff61086b5460e01c166128f35761014081015163ffffffff42811691161015806128d4575b6128c25780612880610bd092613434565b60c08201516020830151906101608401519261289a610678565b948552602085015260408401526060830152608082015260243560a082015260443590613f5f565b604051630c3a9b9d60e41b8152600490fd5b506128e26040820151613b84565b6001600160a01b031633141561286f565b604051633d90fc5560e11b8152600490fd5b3461042e575f36600319011261042e576020610c5a546001600160a01b0360405191831c168152f35b6101608060031936011261042e5761010435612949816104cf565b61012435612956816104cf565b6101443567ffffffffffffffff811161042e576129779036906004016116b2565b63ffffffff9461298a8642169586612f68565b936129936135c3565b61086b549160ff8360e81c166107d2576129c66129d3966123e4610bd09a610e7d9660c01c16996123886123658c61341f565b86019063ffffffff169052565b610180820152614307565b634e487b7160e01b5f52603260045260245ffd5b61086c908154811015612a2c576003915f52027f71cd7344f4eb2efc8e30291f6dbdb44d618ca368ea5425d217c1d604bf26b84d01905f90565b6129de565b3461042e57602036600319011261042e5760043561086c5481101561042e57612a5b6040916129f2565b506001815491015482519182526020820152f35b3461042e57612a7d36612409565b90612a86613501565b612a8e6135c3565b6001600160a01b0380911691825f52610c5c602052612ac68160405f20906001600160a01b03166001600160a01b0319825416179055565b16907ff3dc137d2246f9b8abd0bb821e185ba01122c9b3ea3745ffca6208037674d6705f80a36001606555005b3461042e57602036600319011261042e576107cb600435612b1381610472565b612b1b613501565b6111b56135c3565b91612b2c6135c3565b6080820191612b45610b7884516001600160a01b031690565b602081019182514603612c4c57612b6d612b7191836001612b65896129f2565b5001546138a0565b1590565b612c3a578060607ff4ad92585b1bc117fbdd644990adf0827bc4c95baeae8a23322af807b6d0020e920193612bb3612bad865163ffffffff1690565b87613932565b612c2d845194835193612c12612c04612bf360408401998a51612bda8d5163ffffffff1690565b89516001600160a01b03169160a088019b8c51946139a3565b925193519851995163ffffffff1690565b94516001600160a01b031690565b945163ffffffff9586604051978897169b1699339487612ccd565b0390a461048e6001606555565b60405163582f497d60e11b8152600490fd5b604051633d23e4d160e11b8152600490fd5b9081518082526020808093019301915f5b828110612c7d575050505090565b835185529381019392810192600101612c6f565b9081518082526020808093019301915f5b828110612cb0575050505090565b83516001600160a01b031685529381019392810192600101612ca2565b9496959193612cef60a095612d0d93885260c0602089015260c0880190612c5e565b906001600160a01b0380951660408801528682036060880152612c91565b951515608085015216910152565b3561074081610472565b35610740816104cf565b903590601e198136030182121561042e570180359067ffffffffffffffff821161042e5760200191813603831361042e57565b634e487b7160e01b5f52602160045260245ffd5b60031115612d8057565b612d62565b8051821015612a2c5760209160051b010190565b90821015612a2c5761122a9160051b810190612d2f565b908092918237015f815290565b3d15612de7573d90612dce826106d3565b91612ddc6040519384610656565b82523d5f602084013e565b606090565b908060209392818452848401375f828201840152601f01601f1916010190565b94929093612e3192610740979587526020870152608060408701526080860191612dec565b926060818503910152612dec565b91909160ff5f5460081c161561042e57612e8990610c5a624c4b4063ffffffff1982541617905561086b9063ffffffff60c01b1963ffffffff60c01b83549260c01b169116179055565b604051612e9581610578565b6009815260208101926820a1a927a9a996ab1960b91b8452640312e302e360dc1b6020604051612ec481610578565b60058152015260ff5f5460081c161561042e57612f13936111b59251902061047f557f06c015bd22b4c69690933c1058878ebdfef31f9aaae40bbe86d8a09fe1b2972c610480556111a8614599565b61048e610c5a77deaddeaddeaddeaddeaddeaddeaddeaddead00000000000077ffffffffffffffffffffffffffffffffffffffff0000000019825416179055565b634e487b7160e01b5f52601160045260245ffd5b91909163ffffffff80809416911601918211612f8057565b612f54565b969492909161048e9b9a9998969492612fa563ffffffff42169889612f68565b985b9593919b999897969492909b612fbb6135c3565b61086b549660ff8860e81c166107d2578760c01c63ffffffff16612fde9061341f565b6130059061086b9063ffffffff60c01b1963ffffffff60c01b83549260c01b169116179055565b61300d6106b9565b9d6001600160a01b038f921682526001600160a01b031690602001526001600160a01b031660408d01526001600160a01b031660608c015260808b015260a08a015260c08901526001600160a01b031660e088015260c01c63ffffffff16610100870152610120860190613086919063ffffffff169052565b63ffffffff1661014085015263ffffffff1661016084015236906130a9926106ef565b6101808201526130b890614307565b61048e6001606555565b916040519160208301936bffffffffffffffffffffffff199060601b16845260348301526054820152605481526130f8816105e6565b51902090565b93929160209161311691604087526040870191612dec565b930152565b9081602091031261042e57604051906020820182811067ffffffffffffffff8211176105945760405235815290565b6107409161018090825181526020830151602082015260408301516040820152606083015160608201526080830151608082015260a083015160a082015260c083015160c082015260e083015160e082015261010080840151908201526131bf610120808501519083019063ffffffff169052565b6101408381015163ffffffff1690820152816101608094015193820152019061124f565b6131fb6040929594939560608352606083019061314a565b9460208201520152565b90602061074092818152019061124f565b9c9a999897969594939291909661322b6135c3565b60ff61086b5460e81c166107d257613244908e336130c2565b96604051809e61325382610599565b81526020015260408d015260608c015260808b015260a08a015260c089015260e088015261010087015263ffffffff16610120860152613086565b97929095939196949761329f6135c3565b60ff61086b5460e01c166128f3576132ba6101408201612d25565b63ffffffff8042169116101580613358575b6128c257613341613353966133396130b89b6132eb610dfb368761267f565b9a6132f4610678565b9b6132ff368861267f565b8d5260208d01528660408d01528760608d015261331d368b846106ef565b60808d015260a08c01526133318535613b84565b9836916106ef565b9536916106ef565b9461010060e0830135920135906141d5565b613f5f565b506133666040820135613b84565b6001600160a01b03163314156132cc565b9061338182610884565b61338e6040519182610656565b828152809261339f601f1991610884565b01905f5b8281106133af57505050565b8060606020809385010152016133a3565b60208183031261042e5780519067ffffffffffffffff821161042e570181601f8201121561042e5780516133f3816106d3565b926134016040519485610656565b8184526020828401011161042e57610740916020808501910161122e565b63ffffffff809116908114612f805760010190565b6040516130f881613451602082019460408652606083019061314a565b46604083015203601f198101835282610656565b9190916134706135c3565b60ff61086b5460e01c166128f35761014081015163ffffffff42811691161015806134e2575b6128c2576130b8926134a782613434565b60c0830151602084015190610160850151926134c1610678565b958652602086015260408501526060840152608083015260a0820152613f5f565b506134f06040820151613b84565b6001600160a01b0316331415613496565b7342000000000000000000000000000000000000078033036135b157602060049160405192838092636e296e4560e01b82525afa9081156135ac575f9161357d575b506001600160a01b0361356261216d610869546001600160a01b031690565b91160361356b57565b6040516336a816d960e01b8152600490fd5b61359f915060203d6020116135a5575b6135978183610656565b8101906146b8565b5f613543565b503d61358d565b6135e1565b60405163253a6fc960e11b8152600490fd5b60026065541461042e576002606555565b91908203918211612f8057565b6040513d5f823e3d90fd5b926107409695929491946101409585525f60208601526040850152606084015263ffffffff809116608084015260a08301525f60c083015260e08201525f61010082015281610120820152019061124f565b9193949690959660070b906706f05b59d3b2000061365b836146cd565b101561381b576ec097ce7bc90715b34b9f100000000084116138095763ffffffff93613689858a16426135d4565b857f000000000000000000000000000000000000000000000000000000000000000016106137f75761086b5460c01c63ffffffff16986136cb6123658b61341f565b6001600160a01b039586807f000000000000000000000000000000000000000000000000000000000000000016981692888414806137ee575b156137b2578034036137a057883b1561042e575f6004996040519a8b8092630d0e30db60e41b825234905af19889156135ac5761376f613782978a927f32ed1a409ef04c7b0227189c3a103dc5ac10e775a15b785dcc510201f7c25ad39c613787575b505b8361471b565b92604051998a99169d169b1693876135ec565b0390a4565b8061379461379a926105b6565b80610424565b5f613767565b604051636452a35d60e01b8152600490fd5b7f32ed1a409ef04c7b0227189c3a103dc5ac10e775a15b785dcc510201f7c25ad398508761376f613782976137e98430338a6146dc565b613769565b50341515613704565b60405163f722177f60e01b8152600490fd5b60405163622db5a960e11b8152600490fd5b60405163284f109760e21b8152600490fd5b6001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000811691168114613864575b50565b4761386c5750565b4790803b1561042e575f90600460405180948193630d0e30db60e41b83525af180156135ac57156138615761048e906105b6565b61074092916040516139298161391b602082019460208652805160408401526020810151606084015260a06138e5604083015160c06080870152610100860190612c5e565b606083015163ffffffff168583015260808301516001600160a01b031660c0860152910151838203603f190160e0850152612c91565b03601f198101835282610656565b51902091614751565b61393d6002916129f2565b500162ffffff8260081c16805f5281602052600160ff60405f205494161b8080941614613975575f5260205260405f20908154179055565b60405163954476d960e01b8152600490fd5b9081602091031261042e575190565b91908201809211612f8057565b91959495939092935f9681519081815103613b725781613a22575b505050826139cd575b50505050565b6001600160a01b0381613a017ffa7fa7cf6d7dde5f9be65a67e6a1a747e7aa864dcd2d793353c722d80fbbb3579386614814565b6040805195865233602087015291169463ffffffff1693a45f8080806139c7565b604080516370a0823160e01b81523060048083019190915291906020816024816001600160a01b038b165afa9081156135ac575f91613b53575b505f805b868110613a715750505050506139be565b613a7b8189612d85565b51613a89575b600101613a60565b90613a9f90613a98838a612d85565b5190613996565b90828211613b4357613ad9612b6d613ac7613aba848a612d85565b516001600160a01b031690565b613ad1848c612d85565b51908c6147a2565b15613a81579c5087613b39613b318f613b1c613aba613b15613afb848f612d85565b51966001600160a01b03165f5261087360205260405f2090565b928b612d85565b6001600160a01b03165f5260205260405f2090565b918254613996565b905560019c613a81565b50505051632ddaa83160e11b8152fd5b613b6c915060203d602011611088576110798183610656565b5f613a5c565b6040516319a5316760e31b8152600490fd5b6001600160a01b0390613b9681614b97565b1690565b91612b6d90613c1392845160408096015191865191613bb8836105ca565b8252613929613bd360208401924684528985019586526129f2565b5054938851928391613bf86020840196602088525160608d86015260a085019061314a565b9151606084015251608083015203601f198101835282610656565b613c1a5750565b5163582f497d60e11b8152600490fd5b613c3382612d76565b52565b9a989693919c9b9997959492909c6101e08c019d8c5260208c015260408b015260608a0152608089015263ffffffff80921660a08901521660c087015260e08601526101008501526101208401526101408301528051610160830152602081015161018083015260408101516101a08301526060015190613cb682612d76565b6101c00152565b9061074094936080936001600160a01b0380931684526020840152166040820152816060820152019061124f565b905f82516101208101613d02815163ffffffff1690565b63ffffffff42911610613f4d576020850151906002613d2a835f5261087260205260405f2090565b5414613f3b57613d4486925f5261087260205260405f2090565b6002905560608301519060808401519160a08501519260c0860151918560a0810151938860e0810151956101008201519751613d839063ffffffff1690565b61014083015163ffffffff166040840151918451936020860151956101600151613dac906141c0565b966060890151986080019e8f51613dc2906141c0565b906040015190613dd06106c6565b9a8b5260208b015260408a0152600260608a01526040519d8e9b613df49b8d613c36565b037f44b559f101f8fbcc8a0ea43fa91a05a729a5ea6e14a7c75aa750374690137208905f94a46080820151613e2890613b84565b9060408601519560600151613e3c90613b84565b9260800151613e4a90613b84565b6001600160a01b03919082167f0000000000000000000000000000000000000000000000000000000000000000831603613f265784613f13575b613e9087838616614bb2565b51928351151580613f09575b613eaa575b50505050509050565b1690813b15613f055783613ed8959660405196879586948593633a5be8cb60e01b8552339160048601613cbd565b03925af180156135ac57613ef2575b808080808594613ea1565b80613794613eff926105b6565b5f613ee7565b8380fd5b50803b1515613e9c565b613f218730338587166146dc565b613e84565b5f9450613f368785858516614670565b613e90565b604051630479306360e51b8152600490fd5b60405163d642b7d960e01b8152600490fd5b8051916101208301613f75815163ffffffff1690565b63ffffffff42911610613f4d5760208301516001613f9c825f5261087260205260405f2090565b54036141b9576001905b6002613fbb825f5261087260205260405f2090565b5414613f3b57613fd7613fdd915f5261087260205260405f2090565b60029055565b7f44b559f101f8fbcc8a0ea43fa91a05a729a5ea6e14a7c75aa75037469013720860608601516080870151906140aa8760a08a0151958a60c08101519760a08401519860e08301519961403a6101008501519c5163ffffffff1690565b61014085015163ffffffff169160408601519386519561409e61406661016060208b01519a01516141c0565b9960608c01519b604061407c60808301516141c0565b91015190602061408a6106c6565b9e8f528e015260408d015260608c01613c2a565b6040519c8d9c8d613c36565b0390a46140ba6080830151613b84565b9160408201519160806140dc816140d46060850151613b84565b940151613b84565b6001600160a01b03929083167f00000000000000000000000000000000000000000000000000000000000000008416036141a65761411e853033868a166146dc565b61412a85848616614bb2565b015191825115158061419c575b614143575b5050505050565b16803b1561042e57614171935f809460405196879586948593633a5be8cb60e01b8552339160048601613cbd565b03925af180156135ac57614189575b8080808061413c565b80613794614196926105b6565b5f614180565b50803b1515614137565b6141b4858533868a166146dc565b61412a565b5f90613fa6565b805190816141ce5750505f90565b6020012090565b939260429361048e979660208151910120906040519260208401947f8d1994e2bbbd77564cdca06dd819e7ee2a5efa06c80dcb59a4a7b6e39edc538f86526040850152856060850152608084015260a083015260c082015260c0815261423a8161061e565b5190209061047f549061048054906040519160208301937fc2f8787176b8ac6bf7215b4adcc1e069bf4ab82d9ab1df05a57a91d425935b6e8552604084015260608301526080820152608081526142908161063a565b519020906040519161190160f01b8352600283015260228201522090614dcf565b96926107409a9996949198959261014099895260208901526040880152606087015263ffffffff928380921660808801521660a08601521660c084015260e083015261010082015281610120820152019061124f565b6143118151614b97565b6101208101614330614327825163ffffffff1690565b63ffffffff1690565b804210908115614560575b506137f757610140820191614354835163ffffffff1690565b9063ffffffff9182614388817f00000000000000000000000000000000000000000000000000000000000000001642613996565b91161161454e5761016081015163ffffffff169180831680614509575b505060408101908151916001600160a01b037f00000000000000000000000000000000000000000000000000000000000000001680931480614500575b156144b357608082015134036137a057823b1561042e575f60049360405194858092630d0e30db60e41b825234905af19283156135ac577f32ed1a409ef04c7b0227189c3a103dc5ac10e775a15b785dcc510201f7c25ad3936144a0575b505b5161378260608301519260808101519060a081015160c08201519761447f6144746101008501519b5163ffffffff1690565b9b5163ffffffff1690565b83519b60208501519361018060e0870151960151966040519a8b9a8b6142b1565b806137946144ad926105b6565b5f614440565b9150346137a057816144fb6144ec61216d7f32ed1a409ef04c7b0227189c3a103dc5ac10e775a15b785dcc510201f7c25ad39551613b84565b608084015190309033906146dc565b614442565b503415156143e2565b6301e133801015614539575b5060e081015115614527575f806143a5565b60405163495d907f60e01b8152600490fd5b916145479192421690612f68565b905f614515565b60405163582e388960e01b8152600490fd5b61456b9150426135d4565b63ffffffff7f000000000000000000000000000000000000000000000000000000000000000016105f61433b565b60ff5f5460081c161561042e57565b60ff5f5460081c161561042e576001606555565b6001600160a01b0316801561460457610869816001600160a01b03198254161790557fa9e8c42c9e7fca7f62755189a16b2f5314d43d8fb24e91ba54e6d65f9314e8495f80a2565b60405163ba97b39d60e01b8152600490fd5b6001600160a01b0316801561465e5761086a816001600160a01b03198254161790557fa73e8909f8616742d7fe701153d82666f7b7cd480552e23ebb05d358c22fd04e5f80a2565b604051635b03092b60e11b8152600490fd5b60405163a9059cbb60e01b60208201526001600160a01b039092166024830152604482019290925261048e916146b382606481015b03601f198101845283610656565b614ead565b9081602091031261042e575161074081610472565b5f81126146d75790565b5f0390565b909261048e93604051936323b872dd60e01b60208601526001600160a01b0380921660248601521660448401526064830152606482526146b38261063a565b90670de0b6b3a7640000915f828403921283831281169084841390151617612f8057818102918183041490151715612f80570490565b929091905f915b845183101561479a5761476b8386612d85565b519081811015614789575f52602052600160405f205b920191614758565b905f52602052600160405f20614781565b915092501490565b60405163a9059cbb60e01b60208281019182526001600160a01b039094166024830152604482019490945290925f916147de816064810161391b565b519082855af1903d5f5190836147f5575b50505090565b9192509061480a57503b15155b5f80806147ef565b6001915014614802565b906001600160a01b0390818116907f00000000000000000000000000000000000000000000000000000000000000008316820361493e5750803b1561042e57604051632e1a7d4d60e01b815260048101849052905f908290602490829084905af180156135ac5761492b575b50610c5a549161489961086a546001600160a01b031690565b73420000000000000000000000000000000000001090813b1561042e57604051631474f2a960e31b8152602086901c949094166001600160a01b0390811660048601521660248401526044830182905263ffffffff909316606483015260a060848301525f60a483018190529192839160c4918391905af180156135ac5761491e5750565b8061379461048e926105b6565b80613794614938926105b6565b5f614880565b91807f000000000000000000000000000000000000000000000000000000000000000016151580614b6c575b1561498e5750505061048e9061498961086a546001600160a01b031690565b614fe1565b806149bb6149ae856001600160a01b03165f52610c5c60205260405f2090565b546001600160a01b031690565b16614b48577342000000000000000000000000000000000000105b16906149fa61216d6149ae856001600160a01b03165f52610c5d60205260405f2090565b15614ac2578382614a0a92614f3d565b614a296149ae836001600160a01b03165f52610c5d60205260405f2090565b90614a3d61086a546001600160a01b031690565b91614a4e610c5a5463ffffffff1690565b823b1561042e5760405163540abf7360e01b81526001600160a01b0395861660048201529185166024830152929093166044840152606483019390935263ffffffff16608482015260c060a48201525f60c482018190529091829081838160e481015b03925af180156135ac5761491e5750565b5091614ad761086a546001600160a01b031690565b92614ae8610c5a5463ffffffff1690565b93813b1561042e57604051631474f2a960e31b81526001600160a01b03948516600482015293166024840152604483019190915263ffffffff909216606482015260a060848201525f60a482018190529091829081838160c48101614ab1565b614b676149ae846001600160a01b03165f52610c5c60205260405f2090565b6149d6565b50807f000000000000000000000000000000000000000000000000000000000000000016821461496a565b60a01c614ba057565b6040516379ec0ed760e11b8152600490fd5b6001600160a01b0390811690813b15614bf2579061048e92917f000000000000000000000000000000000000000000000000000000000000000016614670565b7f000000000000000000000000000000000000000000000000000000000000000016803b1561042e575f8091602460405180948193632e1a7d4d60e01b83528860048401525af180156135ac57614c64575b5081471061042e575f80809381935af1614c5c612dbd565b501561042e57565b614c6d906105b6565b5f614c44565b614c7c81614d8c565b6001600160a01b0381167fbc7cd75a20ee27fd9adebab32041f755214dbc6bffa90cc0225b39da2e5c2d3b5f80a2815115801590614d34575b614cbd575050565b5f80613861937f206661696c65640000000000000000000000000000000000000000000000000060408051614cf1816105ca565b602781527f416464726573733a206c6f772d6c6576656c2064656c65676174652063616c6c60208201520152602081519101845af4614d2e612dbd565b916152df565b505f614cb5565b614d4481614d8c565b6001600160a01b0381167fbc7cd75a20ee27fd9adebab32041f755214dbc6bffa90cc0225b39da2e5c2d3b5f80a2815115801590614d8457614cbd575050565b506001614cb5565b803b1561042e576001600160a01b037f360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc91166001600160a01b0319825416179055565b614dd983836152ae565b6005819592951015612d8057159384614e97575b508315614e11575b50505015614dff57565b60405163938a182160e01b8152600490fd5b5f929350908291604051614e498161391b6020820194630b135d3f60e11b998a8752602484015260406044840152606483019061124f565b51915afa90614e56612dbd565b82614e89575b82614e6c575b50505f8080614df5565b614e8191925060208082518301019101613987565b145f80614e62565b915060208251101591614e5c565b6001600160a01b0383811691161493505f614ded565b905f806001600160a01b03614f049416927f5361666545524332303a206c6f772d6c6576656c2063616c6c206661696c65646020604051614eed81610578565b818152015260208151910182855af1614d2e612dbd565b8051908115918215614f1a575b50501561042e57565b819250906020918101031261042e5760200151614f36816119a2565b5f80614f11565b6044919260206001600160a01b0360405194858092636eb1769f60e11b8252306004830152808916602483015286165afa9283156135ac575f93614fc0575b508201809211612f805760405163095ea7b360e01b60208201526001600160a01b039093166024840152604483019190915261048e91906146b382606481016146a5565b614fda91935060203d602011611088576110798183610656565b915f614f7c565b906001600160a01b038092167f000000000000000000000000000000000000000000000000000000000000000090837f0000000000000000000000000000000000000000000000000000000000000000169361503e848685614f3d565b604094604051926332dd704760e21b84526020956004948781600481875afa9687156135ac5788915f9861526d575b506040516352b7631960e11b81529086166001600160a01b03811660048301529097909588916024918391165afa9586156135ac575f9661524e575b5095867f0000000000000000000000000000000000000000000000000000000000000000975b6150de57505050505050505050565b8681111561524857865b88156151a057843b1561042e578951634701287760e11b815287810182815263ffffffff7f0000000000000000000000000000000000000000000000000000000000000000166020820152604081018690526001600160a01b03881660608201525f6080820181905260a082018190526107d060c0830152919391908490819060e0010381838a5af19283156135ac576151879361518d575b506135d4565b806150cf565b8061379461519a926105b6565b5f615181565b89516337e9a82760e11b815287810182815263ffffffff7f0000000000000000000000000000000000000000000000000000000000000000166020820152604081018690526001600160a01b038816606082015290929084908490819060800103815f8a5af19283156135ac576151879361521b57506135d4565b61523a90853d8711615241575b6152328183610656565b81019061528e565b505f615181565b503d615228565b806150e8565b615266919650873d8911611088576110798183610656565b945f6150a9565b8691985061528790833d85116135a5576135978183610656565b979061506d565b9081602091031261042e575167ffffffffffffffff8116810361042e5790565b9060418151145f146152d65761122a91602082015190606060408401519301515f1a90615308565b50505f90600290565b90156152f9578151156152f0575090565b3b1561042e5790565b50805190811561042e57602001fd5b7f7fffffffffffffffffffffffffffffff5d576e7357a4501ddfe92f46681b20a08411615378576020935f9360ff60809460405194855216868401526040830152606082015282805260015afa156135ac575f516001600160a01b0381161561537057905f90565b505f90600190565b505050505f9060039056fea264697066735822122055ad2af729c797abdaca5785a9aa033a3c01eebb02e628fb93e9a77e28791a2964736f6c63430008170033",
- "deployedBytecode": "0x6080604052600436101561001a575b3615610018575f80fd5b005b5f3560e01c8063079bd2c71461041f5780630c5d5f731461041a5780630eaac9f0146104155780631186ec331461041057806311eac8551461040b57806315348e44146103a257806317fcb39b146104065780631b3d5559146104015780631fab657c146103fc57806329cb924d146103f75780632e378115146103f25780632e63e59a146103ed5780633659cfe6146103e8578063431023b8146103e3578063437b9116146103de578063490e49ef146103d9578063493a4f84146103d45780634f1ef286146103cf5780635285e058146103ca57806352d1902d146103c5578063541f4f14146103c0578063577f51f8146103bb57806357f6dcb8146103b65780636068d6cb146103b1578063647c576c146103ac578063670fa8ac146103a75780636bbbcd2e146103a25780636e4009831461039d578063738b62e514610398578063766e070314610393578063775c0d031461038e5780637aef642c146103895780637b939232146103845780637ef413e11461037f57806382e2c43f1461037a5780638a7860ce146103755780638b15788e14610370578063927ede2d1461036b5780639748cf7c1461036657806397943aa914610361578063979f2bc21461035c57806399cc2968146103575780639a8a059214610352578063a1244c671461034d578063a18a096e14610348578063ac9650d814610343578063ad5425c61461033e578063adb5a6a6146102f3578063b27a430014610339578063b370b7f514610334578063babb6aac1461032f578063bf10268d1461032a578063c35c83fc14610325578063ceb4c98714610320578063d7e1583a1461031b578063dda5211314610316578063ddd224f114610311578063de7eba781461030c578063deff4b2414610307578063e322921114610302578063ea86bd46146102fd578063ee2a53f8146102f8578063f79f29ed146102f3578063fbbba9ac146102ee5763fc8a584f0361000e57612af3565b612a6f565b61242e565b612a31565b61292e565b612905565b612810565b6127e0565b6127b7565b612791565b61275b565b612661565b612636565b6125b2565b6124db565b6124b4565b612475565b6122cd565b61222d565b6120c6565b61209f565b612085565b611ff0565b611f22565b611ea2565b611e5f565b611e31565b611db3565b611d3b565b611c20565b611be9565b611b41565b611aa1565b611a65565b611a41565b6119ac565b611962565b610827565b611928565b611851565b6117f9565b6117b9565b6116e0565b61161d565b6115b3565b61158c565b61145e565b6113d7565b6113b9565b6112ec565b61108f565b610f5d565b610d63565b610c03565b610bda565b610ad8565b6109cf565b610841565b6107e4565b610743565b6104f6565b610490565b610432565b5f91031261042e57565b5f80fd5b3461042e575f36600319011261042e57602060405163ffffffff7f0000000000000000000000000000000000000000000000000000000000000000168152f35b6001600160a01b0381160361042e57565b359061048e82610472565b565b3461042e57602036600319011261042e5760206004356104af81610472565b6001600160a01b038091165f52610c5d825260405f205416604051908152f35b63ffffffff81160361042e57565b610144359061048e826104cf565b359061048e826104cf565b3461042e57602036600319011261042e5763ffffffff600435610518816104cf565b610520613501565b6105286135c3565b16610c5a8163ffffffff198254161790557fe486a5c4bd7b36eabbfe274c99b39130277417be8d2209b4dae04c4fba64ee3a5f80a26001606555005b634e487b7160e01b5f52604160045260245ffd5b6040810190811067ffffffffffffffff82111761059457604052565b610564565b6101a0810190811067ffffffffffffffff82111761059457604052565b67ffffffffffffffff811161059457604052565b6060810190811067ffffffffffffffff82111761059457604052565b6080810190811067ffffffffffffffff82111761059457604052565b6020810190811067ffffffffffffffff82111761059457604052565b60e0810190811067ffffffffffffffff82111761059457604052565b60a0810190811067ffffffffffffffff82111761059457604052565b90601f8019910116810190811067ffffffffffffffff82111761059457604052565b6040519060c0820182811067ffffffffffffffff82111761059457604052565b60405190610180820182811067ffffffffffffffff82111761059457604052565b6040519061048e82610599565b6040519061048e826105e6565b67ffffffffffffffff811161059457601f01601f191660200190565b9291926106fb826106d3565b916107096040519384610656565b82948184528183011161042e578281602093845f960137010152565b9080601f8301121561042e57816020610740933591016106ef565b90565b61010036600319011261042e5760043561075c81610472565b60243561076881610472565b6084358060070b810361042e5760a43590610782826104cf565b60c43567ffffffffffffffff811161042e576107a2903690600401610725565b926107ab6135c3565b60ff61086b5460e81c166107d2576107cb9460643591604435913361363e565b6001606555005b604051630b4cba3160e31b8152600490fd5b3461042e575f36600319011261042e5760206040516001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000168152f35b3461042e575f36600319011261042e5760206040515f8152f35b3461042e575f36600319011261042e5760206040516001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000168152f35b67ffffffffffffffff81116105945760051b60200190565b9080601f8301121561042e5760209082356108b681610884565b936108c46040519586610656565b81855260208086019260051b82010192831161042e57602001905b8282106108ed575050505090565b813581529083019083016108df565b9080601f8301121561042e57602090823561091681610884565b936109246040519586610656565b81855260208086019260051b82010192831161042e57602001905b82821061094d575050505090565b838091833561095b81610472565b81520191019061093f565b929161097182610884565b9161097f6040519384610656565b829481845260208094019160051b810192831161042e57905b8282106109a55750505050565b81358152908301908301610998565b9080601f8301121561042e5781602061074093359101610966565b60031960603682011261042e576004356109e8816104cf565b60243567ffffffffffffffff9283821161042e5760c090823603011261042e57610a10610678565b908060040135825260248101356020830152604481013584811161042e57610a3e906004369184010161089c565b6040830152610a4f606482016104eb565b6060830152610a6060848201610483565b608083015260a48101359084821161042e576004610a8192369201016108fc565b60a082015260443592831161042e57610aa16100189336906004016109b4565b91612b23565b9181601f8401121561042e5782359167ffffffffffffffff831161042e576020808501948460051b01011161042e57565b3461042e5760031960603682011261042e5760043567ffffffffffffffff80821161042e5760608236039384011261042e5760243590610b17826104cf565b60443590811161042e57610b2f903690600401610aa7565b919093610b3a6135c3565b600484013590610182190181121561042e57610bd094610bcb93610b67610bc4936004369189010161267f565b95610b7d610b786080890151613b84565b61382d565b610b8687613434565b9060446020890151916101608a015193610b9e610678565b9a8b5260208b015201356040890152606088015260808701525f60a08701523691610966565b9083613b9a565b613ceb565b6100186001606555565b3461042e575f36600319011261042e576020604051428152f35b908161018091031261042e5790565b3461042e57604036600319011261042e5760043567ffffffffffffffff811161042e57610c34903690600401610bf4565b610c3d81612d1b565b6001600160a01b031690610c5360208201612d1b565b6001600160a01b031691610c6960408301612d1b565b6001600160a01b0316610c7e60608401612d1b565b6001600160a01b031692610c9460808201612d1b565b6001600160a01b031690610100610cac818301612d25565b9061012090610cbc848301612d25565b9261014094858101610ccd90612d25565b966101609a8b8301610cdf9084612d2f565b9a909b610cea610698565b9e8f91825260208201526040015260608d015260808c015260a081013560a08c015260c081013560c08c015260e0013560e08b015263ffffffff1690890152870190610d3b919063ffffffff169052565b63ffffffff909116908501523690610d52926106ef565b908201523360243561001892613465565b3461042e57602036600319011261042e576004803567ffffffffffffffff811161042e57610d949036908301610bf4565b610d9c6135c3565b60ff61086b5460e01c16610f4d5763ffffffff80421692610140830193610dd581610dc687612d25565b63ffffffff9182169116101590565b610f3d57610120840192610de884612d25565b1610610f2e57610e00610dfb368561267f565b613434565b90610e14825f5261087260205260405f2090565b54610f205750610e637f3cee3e290f36226751cd0b3321b213890fe9c768e922f267fa6111836ce05c3292610e5e610e58610e69945f5261087260205260405f2090565b60019055565b612d25565b93612d25565b610e89610e84610e7d610160860186612d2f565b36916106ef565b6141c0565b90610f136040519283926101008701359760e08801359760208101359281359260408301359260c08101359060a081013590606060808201359101358b9693909a999895919261012098959361014089019c895260208901526040880152606087015263ffffffff80921660808701521660a085015260c084015260e08301526101008201520152565b0390a36100186001606555565b604051624be79160e21b8152fd5b60405163d642b7d960e01b8152fd5b50604051630277ae7b60e21b8152fd5b50604051633d90fc5560e11b8152fd5b3461042e57602036600319011261042e57600435610f7a81610472565b6001600160a01b03807f00000000000000000000000000000000000000000000000000000000000000001680301461042e577f360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc90828254160361042e57610fdf613501565b60405191610fec83610602565b5f83527f4910fdfa16fed3260ed0e7147f7cc6da11a60208b5b9406d12a635614ffd91435460ff16156110255750505061001890614d8c565b6020600491604051928380926352d1902d60e01b825288165afa5f918161105e575b50611050575f80fd5b0361042e5761001891614c73565b61108191925060203d602011611088575b6110798183610656565b810190613987565b905f611047565b503d61106f565b3461042e57608036600319011261042e576004356110ac816104cf565b602435906110b982610472565b6044356110c581610472565b606435916110d283610472565b60ff5f5460081c161561042e5761111990610c5a624c4b4063ffffffff1982541617905561086b9063ffffffff60c01b1963ffffffff60c01b83549260c01b169116179055565b6040519061112682610578565b6009825260208201916820a1a927a9a996ab1960b91b8352640312e302e360dc1b602060405161115581610578565b60058152015260ff5f5460081c161561042e57610018946111ba936111b59251902061047f557f06c015bd22b4c69690933c1058878ebdfef31f9aaae40bbe86d8a09fe1b2972c610480556111a8614599565b6111b06145a8565b6145bc565b614616565b610c5a9077ffffffffffffffffffffffffffffffffffffffff000000001977ffffffffffffffffffffffffffffffffffffffff0000000083549260201b169116179055565b602060031982011261042e576004359067ffffffffffffffff821161042e5761122a91600401610aa7565b9091565b5f5b83811061123f5750505f910152565b8181015183820152602001611230565b906020916112688151809281855285808601910161122e565b601f01601f1916010190565b6020808201908083528351809252604092604081018260408560051b8401019601945f925b8584106112aa575050505050505090565b9091929394959685806112db600193603f1986820301885286838d518051151584520151918185820152019061124f565b990194019401929594939190611299565b3461042e576112fa366111ff565b61130381610884565b9160406113136040519485610656565b828452601f1961132284610884565b015f5b8181106113965750505f5b83811061134957604051806113458782611274565b0390f35b8061139061135960019388612d85565b515f80611367858a8a612d99565b90611376895180938193612db0565b0390305af490611384612dbd565b60208201529015159052565b01611330565b60209083516113a481610578565b5f815282606081830152828901015201611325565b3461042e575f36600319011261042e5760206040516301e133808152f35b3461042e57604036600319011261042e576024356004356113f6613501565b6113fe6135c3565b61086c8054680100000000000000008110156105945763ffffffff916001820190558361142a826129f2565b5084600182015555167fc86ba04c55bc5eb2f2876b91c438849a296dbec7b08751c3074d92e04f0a77af5f80a46001606555005b604036600319011261042e5760043561147681610472565b60243567ffffffffffffffff811161042e57611496903690600401610725565b6001600160a01b03807f0000000000000000000000000000000000000000000000000000000000000000169081301461042e577f360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc91818354160361042e576114fc613501565b7f4910fdfa16fed3260ed0e7147f7cc6da11a60208b5b9406d12a635614ffd91435460ff16156115325750505061001890614d8c565b6020600491604051928380926352d1902d60e01b825288165afa5f918161156b575b5061155d575f80fd5b0361042e5761001891614d3b565b61158591925060203d602011611088576110798183610656565b905f611554565b3461042e575f36600319011261042e5760206001600160a01b036108695416604051908152f35b3461042e575f36600319011261042e576001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016300361042e5760206040517f360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc8152f35b61012036600319011261042e5760043561163681610472565b6024359061164382610472565b6044359161165083610472565b60a4358060070b810361042e5760c4359161166a836104cf565b60e43567ffffffffffffffff811161042e5761168a903690600401610725565b936116936135c3565b60ff61086b5460e81c166107d2576107cb95608435926064359261363e565b9181601f8401121561042e5782359167ffffffffffffffff831161042e576020838186019501011161042e57565b3461042e5760c036600319011261042e576004356116fd81610472565b6024356044359160643561171081610472565b67ffffffffffffffff9160843583811161042e576117329036906004016116b2565b60a49491943591821161042e577f45e04bc8f121ba11466985789ca2822a91109f31bb8ac85504a37b7eaf873c26946117726117b49336906004016116b2565b9290916001600160a01b038097166117a68a8c836117913688886106ef565b9161179d368b8b6106ef565b9346908d6141d5565b604051978897169a87612e0c565b0390a3005b3461042e575f36600319011261042e57602060405163ffffffff7f0000000000000000000000000000000000000000000000000000000000000000168152f35b3461042e575f36600319011261042e57602060ff61086b5460e81c166040519015158152f35b606090600319011261042e57600435611837816104cf565b9060243561184481610472565b9060443561074081610472565b3461042e5761185f3661181f565b5f54600881901c60ff161593929084908161191a575b81156118fa575b501561042e576118a09284611897600160ff195f5416175f55565b6118e357612e3f565b6118a657005b6118b461ff00195f54165f55565b604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb384740249890602090a1005b6118f561010061ff00195f5416175f55565b612e3f565b303b1591508161190c575b505f61187c565b6001915060ff16145f611905565b600160ff8216109150611875565b3461042e575f36600319011261042e5760206040517f8d1994e2bbbd77564cdca06dd819e7ee2a5efa06c80dcb59a4a7b6e39edc538f8152f35b3461042e575f36600319011261042e57602060405163ffffffff7f0000000000000000000000000000000000000000000000000000000000000000168152f35b8015150361042e57565b3461042e57602036600319011261042e577fe88463c2f254e2b070013a2dc7ee1e099f9bc00534cbdf03af551dc26ae4921960206004356119ec816119a2565b6119f4613501565b6119fc6135c3565b151561086b80547fffff00ffffffffffffffffffffffffffffffffffffffffffffffffffffffffff60ff60e81b8460e81b169116179055604051908152a16001606555005b3461042e575f36600319011261042e57602063ffffffff610c5a5416604051908152f35b3461042e575f36600319011261042e5760206040517f000000000000000000000000000000000000000000000000000000000000000015158152f35b61016036600319011261042e57600435611aba81610472565b60243590611ac782610472565b604435611ad381610472565b60643590611ae082610472565b60e435611aec81610472565b6101043590611afa826104cf565b6101243592611b08846104cf565b610144359667ffffffffffffffff881161042e57611b2d6100189836906004016116b2565b97909660c4359360a4359360843593612f85565b61018036600319011261042e57600435611b5a81610472565b60243590611b6782610472565b604435611b7381610472565b60643590611b8082610472565b60e435611b8c81610472565b61010435611b99816104cf565b6101243591611ba7836104cf565b611baf6104dd565b93610164359767ffffffffffffffff891161042e57611bd56100189936906004016116b2565b98909760c4359360a4359360843593612fa7565b3461042e57606036600319011261042e576020611c18600435611c0b81610472565b60443590602435906130c2565b604051908152f35b3461042e57606036600319011261042e5767ffffffffffffffff60243581811161042e57611c529036906004016116b2565b9160443590811161042e57611c6b9036906004016116b2565b9060405193602085019480611c824684888a6130fe565b0395611c96601f1997888101845283610656565b6004359151902003611d29575f94611cc5611ce793611cbc87611cf3958a990190612735565b9581019061311b565b519360405193849160208301966337bfd2c960e21b88523391602485016131e3565b03908101835282610656565b5190305af4611d00612dbd565b9015611d0857005b60405163b8fe37a760e01b8152908190611d259060048301613205565b0390fd5b604051630f0c8f4760e11b8152600490fd5b3461042e57602036600319011261042e57600435611d57613501565b611d5f6135c3565b611d68816129f2565b611da0576001815f80935501557f7c1af0646963afc3343245b103731965735a893347bfa0d58a5dc77a77ae691c5f80a26001606555005b634e487b7160e01b5f525f60045260245ffd5b6101a036600319011261042e5761012435611dcd816104cf565b61014435611dda816104cf565b6101643591611de8836104cf565b610184359267ffffffffffffffff841161042e57611e0d6100189436906004016116b2565b9390926101043560e43560c43560a435608435606435604435602435600435613216565b3461042e575f36600319011261042e5760206040517342000000000000000000000000000000000000078152f35b3461042e575f36600319011261042e5760206040516001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000168152f35b3461042e5760e036600319011261042e5767ffffffffffffffff60043581811161042e57611ed4903690600401610bf4565b60a43582811161042e57611eec9036906004016116b2565b60c49291923593841161042e57611f0a6100189436906004016116b2565b9390926084359060643590604435906024359061328e565b3461042e57611f303661181f565b909160ff5f5460081c161561042e57611f669061086b9063ffffffff60c01b1963ffffffff60c01b83549260c01b169116179055565b604051611f7281610578565b6009815260208101926820a1a927a9a996ab1960b91b8452640312e302e360dc1b6020604051611fa181610578565b60058152015260ff5f5460081c161561042e57610018936111b59251902061047f557f06c015bd22b4c69690933c1058878ebdfef31f9aaae40bbe86d8a09fe1b2972c610480556111a8614599565b3461042e57602036600319011261042e577f2d5b62420992e5a4afce0e77742636ca2608ef58289fd2e1baa5161ef6e7e41e6020600435612030816119a2565b612038613501565b6120406135c3565b151561086b80547fffffff00ffffffffffffffffffffffffffffffffffffffffffffffffffffffff60ff60e01b8460e01b169116179055604051908152a16001606555005b3461042e575f36600319011261042e576020604051468152f35b3461042e575f36600319011261042e57602063ffffffff61086b5460c01c16604051908152f35b3461042e57604036600319011261042e576004356024356120e682614b97565b6001600160a01b0382165f5261087360205261211560405f20336001600160a01b03165f5260205260405f2090565b549182156121b8575f61215c3361214661212e85613b84565b6001600160a01b03165f5261087360205260405f2090565b906001600160a01b03165f5260205260405f2090565b556121888361217961216d84613b84565b6001600160a01b031690565b61218285613b84565b90614670565b60405192835233927f6c172ea51018fb2eb2118f3f8a507c4df71eb519b8c0052834dc3c920182fef490602090a4005b6040516336542bf760e21b8152600490fd5b6020808201906020835283518092526040830192602060408460051b8301019501935f915b8483106121ff5750505050505090565b909192939495848061221d600193603f198682030187528a5161124f565b98019301930191949392906121ef565b3461042e5761223b366111ff565b9061224582613377565b915f5b81811061225d576040518061134586826121ca565b5f8061226a838587612d99565b9061227a60405180938193612db0565b0390305af4612287612dbd565b90156122ad579060019161229b8287612d85565b526122a68186612d85565b5001612248565b604481511061042e5780600461042e9201516024809183010191016133c0565b6101808060031936011261042e57610104356122e8816104cf565b61012435916122f6836104cf565b6101443592612304846104cf565b6101643567ffffffffffffffff811161042e576123259036906004016116b2565b61232d6135c3565b61086b549260ff8460e81c166107d257610bd0966123f2610e7d926123e463ffffffff6124009860c01c16996123886123658c61341f565b61086b9063ffffffff60c01b1963ffffffff60c01b83549260c01b169116179055565b6123906106b9565b9a6004358c5260243560208d015260443560408d015260643560608d015260843560808d015260a43560a08d015260c43560c08d015260e43560e08d01526101008c01526101208b019063ffffffff169052565b63ffffffff16610140890152565b63ffffffff16610160870152565b90820152614307565b604090600319011261042e5760043561242181610472565b9060243561074081610472565b3461042e57602061246c6001600160a01b0361244936612409565b91165f52610873835260405f20906001600160a01b03165f5260205260405f2090565b54604051908152f35b3461042e57602036600319011261042e57602060043561249481610472565b6001600160a01b038091165f52610c5c825260405f205416604051908152f35b3461042e575f36600319011261042e5760206001600160a01b0361086a5416604051908152f35b3461042e5760c036600319011261042e5760043560243567ffffffffffffffff60643560443560843583811161042e576125199036906004016116b2565b60a49491943591821161042e577f45e04bc8f121ba11466985789ca2822a91109f31bb8ac85504a37b7eaf873c26946125596125a89336906004016116b2565b9290916125646135c3565b61256d8a614b97565b61259c898b898961257f3688886106ef565b9261258b368b8b6106ef565b946001600160a01b034692166141d5565b60405196879687612e0c565b0390a36001606555005b3461042e576125c036612409565b906125c9613501565b6125d16135c3565b6001600160a01b0380911691825f52610c5d6020526126098160405f20906001600160a01b03166001600160a01b0319825416179055565b16907fcb84c2022106a6f2b6f805d446f32fbfd2a528474364fa755f37dac1c0c1b6c85f80a36001606555005b3461042e57602036600319011261042e576004355f52610872602052602060405f2054604051908152f35b3461042e575f36600319011261042e57602060405163ffffffff8152f35b91906101808382031261042e57612694610698565b92803584526020810135602085015260408101356040850152606081013560608501526080810135608085015260a081013560a085015260c081013560c085015260e081013560e085015261010080820135908501526101206126f88183016104eb565b9085015261014061270a8183016104eb565b90850152610160918282013567ffffffffffffffff811161042e5761272f9201610725565b90830152565b9060208282031261042e57813567ffffffffffffffff811161042e57610740920161267f565b3461042e57602036600319011261042e5760043567ffffffffffffffff811161042e57611c18610dfb602092369060040161267f565b3461042e575f36600319011261042e57602060ff61086b5460e01c166040519015158152f35b3461042e575f36600319011261042e5760206040516ec097ce7bc90715b34b9f10000000008152f35b3461042e57602036600319011261042e576107cb60043561280081610472565b612808613501565b6111b06135c3565b3461042e57606036600319011261042e5760043567ffffffffffffffff811161042e5761284190369060040161267f565b6128496135c3565b60ff61086b5460e01c166128f35761014081015163ffffffff42811691161015806128d4575b6128c25780612880610bd092613434565b60c08201516020830151906101608401519261289a610678565b948552602085015260408401526060830152608082015260243560a082015260443590613f5f565b604051630c3a9b9d60e41b8152600490fd5b506128e26040820151613b84565b6001600160a01b031633141561286f565b604051633d90fc5560e11b8152600490fd5b3461042e575f36600319011261042e576020610c5a546001600160a01b0360405191831c168152f35b6101608060031936011261042e5761010435612949816104cf565b61012435612956816104cf565b6101443567ffffffffffffffff811161042e576129779036906004016116b2565b63ffffffff9461298a8642169586612f68565b936129936135c3565b61086b549160ff8360e81c166107d2576129c66129d3966123e4610bd09a610e7d9660c01c16996123886123658c61341f565b86019063ffffffff169052565b610180820152614307565b634e487b7160e01b5f52603260045260245ffd5b61086c908154811015612a2c576003915f52027f71cd7344f4eb2efc8e30291f6dbdb44d618ca368ea5425d217c1d604bf26b84d01905f90565b6129de565b3461042e57602036600319011261042e5760043561086c5481101561042e57612a5b6040916129f2565b506001815491015482519182526020820152f35b3461042e57612a7d36612409565b90612a86613501565b612a8e6135c3565b6001600160a01b0380911691825f52610c5c602052612ac68160405f20906001600160a01b03166001600160a01b0319825416179055565b16907ff3dc137d2246f9b8abd0bb821e185ba01122c9b3ea3745ffca6208037674d6705f80a36001606555005b3461042e57602036600319011261042e576107cb600435612b1381610472565b612b1b613501565b6111b56135c3565b91612b2c6135c3565b6080820191612b45610b7884516001600160a01b031690565b602081019182514603612c4c57612b6d612b7191836001612b65896129f2565b5001546138a0565b1590565b612c3a578060607ff4ad92585b1bc117fbdd644990adf0827bc4c95baeae8a23322af807b6d0020e920193612bb3612bad865163ffffffff1690565b87613932565b612c2d845194835193612c12612c04612bf360408401998a51612bda8d5163ffffffff1690565b89516001600160a01b03169160a088019b8c51946139a3565b925193519851995163ffffffff1690565b94516001600160a01b031690565b945163ffffffff9586604051978897169b1699339487612ccd565b0390a461048e6001606555565b60405163582f497d60e11b8152600490fd5b604051633d23e4d160e11b8152600490fd5b9081518082526020808093019301915f5b828110612c7d575050505090565b835185529381019392810192600101612c6f565b9081518082526020808093019301915f5b828110612cb0575050505090565b83516001600160a01b031685529381019392810192600101612ca2565b9496959193612cef60a095612d0d93885260c0602089015260c0880190612c5e565b906001600160a01b0380951660408801528682036060880152612c91565b951515608085015216910152565b3561074081610472565b35610740816104cf565b903590601e198136030182121561042e570180359067ffffffffffffffff821161042e5760200191813603831361042e57565b634e487b7160e01b5f52602160045260245ffd5b60031115612d8057565b612d62565b8051821015612a2c5760209160051b010190565b90821015612a2c5761122a9160051b810190612d2f565b908092918237015f815290565b3d15612de7573d90612dce826106d3565b91612ddc6040519384610656565b82523d5f602084013e565b606090565b908060209392818452848401375f828201840152601f01601f1916010190565b94929093612e3192610740979587526020870152608060408701526080860191612dec565b926060818503910152612dec565b91909160ff5f5460081c161561042e57612e8990610c5a624c4b4063ffffffff1982541617905561086b9063ffffffff60c01b1963ffffffff60c01b83549260c01b169116179055565b604051612e9581610578565b6009815260208101926820a1a927a9a996ab1960b91b8452640312e302e360dc1b6020604051612ec481610578565b60058152015260ff5f5460081c161561042e57612f13936111b59251902061047f557f06c015bd22b4c69690933c1058878ebdfef31f9aaae40bbe86d8a09fe1b2972c610480556111a8614599565b61048e610c5a77deaddeaddeaddeaddeaddeaddeaddeaddead00000000000077ffffffffffffffffffffffffffffffffffffffff0000000019825416179055565b634e487b7160e01b5f52601160045260245ffd5b91909163ffffffff80809416911601918211612f8057565b612f54565b969492909161048e9b9a9998969492612fa563ffffffff42169889612f68565b985b9593919b999897969492909b612fbb6135c3565b61086b549660ff8860e81c166107d2578760c01c63ffffffff16612fde9061341f565b6130059061086b9063ffffffff60c01b1963ffffffff60c01b83549260c01b169116179055565b61300d6106b9565b9d6001600160a01b038f921682526001600160a01b031690602001526001600160a01b031660408d01526001600160a01b031660608c015260808b015260a08a015260c08901526001600160a01b031660e088015260c01c63ffffffff16610100870152610120860190613086919063ffffffff169052565b63ffffffff1661014085015263ffffffff1661016084015236906130a9926106ef565b6101808201526130b890614307565b61048e6001606555565b916040519160208301936bffffffffffffffffffffffff199060601b16845260348301526054820152605481526130f8816105e6565b51902090565b93929160209161311691604087526040870191612dec565b930152565b9081602091031261042e57604051906020820182811067ffffffffffffffff8211176105945760405235815290565b6107409161018090825181526020830151602082015260408301516040820152606083015160608201526080830151608082015260a083015160a082015260c083015160c082015260e083015160e082015261010080840151908201526131bf610120808501519083019063ffffffff169052565b6101408381015163ffffffff1690820152816101608094015193820152019061124f565b6131fb6040929594939560608352606083019061314a565b9460208201520152565b90602061074092818152019061124f565b9c9a999897969594939291909661322b6135c3565b60ff61086b5460e81c166107d257613244908e336130c2565b96604051809e61325382610599565b81526020015260408d015260608c015260808b015260a08a015260c089015260e088015261010087015263ffffffff16610120860152613086565b97929095939196949761329f6135c3565b60ff61086b5460e01c166128f3576132ba6101408201612d25565b63ffffffff8042169116101580613358575b6128c257613341613353966133396130b89b6132eb610dfb368761267f565b9a6132f4610678565b9b6132ff368861267f565b8d5260208d01528660408d01528760608d015261331d368b846106ef565b60808d015260a08c01526133318535613b84565b9836916106ef565b9536916106ef565b9461010060e0830135920135906141d5565b613f5f565b506133666040820135613b84565b6001600160a01b03163314156132cc565b9061338182610884565b61338e6040519182610656565b828152809261339f601f1991610884565b01905f5b8281106133af57505050565b8060606020809385010152016133a3565b60208183031261042e5780519067ffffffffffffffff821161042e570181601f8201121561042e5780516133f3816106d3565b926134016040519485610656565b8184526020828401011161042e57610740916020808501910161122e565b63ffffffff809116908114612f805760010190565b6040516130f881613451602082019460408652606083019061314a565b46604083015203601f198101835282610656565b9190916134706135c3565b60ff61086b5460e01c166128f35761014081015163ffffffff42811691161015806134e2575b6128c2576130b8926134a782613434565b60c0830151602084015190610160850151926134c1610678565b958652602086015260408501526060840152608083015260a0820152613f5f565b506134f06040820151613b84565b6001600160a01b0316331415613496565b7342000000000000000000000000000000000000078033036135b157602060049160405192838092636e296e4560e01b82525afa9081156135ac575f9161357d575b506001600160a01b0361356261216d610869546001600160a01b031690565b91160361356b57565b6040516336a816d960e01b8152600490fd5b61359f915060203d6020116135a5575b6135978183610656565b8101906146b8565b5f613543565b503d61358d565b6135e1565b60405163253a6fc960e11b8152600490fd5b60026065541461042e576002606555565b91908203918211612f8057565b6040513d5f823e3d90fd5b926107409695929491946101409585525f60208601526040850152606084015263ffffffff809116608084015260a08301525f60c083015260e08201525f61010082015281610120820152019061124f565b9193949690959660070b906706f05b59d3b2000061365b836146cd565b101561381b576ec097ce7bc90715b34b9f100000000084116138095763ffffffff93613689858a16426135d4565b857f000000000000000000000000000000000000000000000000000000000000000016106137f75761086b5460c01c63ffffffff16986136cb6123658b61341f565b6001600160a01b039586807f000000000000000000000000000000000000000000000000000000000000000016981692888414806137ee575b156137b2578034036137a057883b1561042e575f6004996040519a8b8092630d0e30db60e41b825234905af19889156135ac5761376f613782978a927f32ed1a409ef04c7b0227189c3a103dc5ac10e775a15b785dcc510201f7c25ad39c613787575b505b8361471b565b92604051998a99169d169b1693876135ec565b0390a4565b8061379461379a926105b6565b80610424565b5f613767565b604051636452a35d60e01b8152600490fd5b7f32ed1a409ef04c7b0227189c3a103dc5ac10e775a15b785dcc510201f7c25ad398508761376f613782976137e98430338a6146dc565b613769565b50341515613704565b60405163f722177f60e01b8152600490fd5b60405163622db5a960e11b8152600490fd5b60405163284f109760e21b8152600490fd5b6001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000811691168114613864575b50565b4761386c5750565b4790803b1561042e575f90600460405180948193630d0e30db60e41b83525af180156135ac57156138615761048e906105b6565b61074092916040516139298161391b602082019460208652805160408401526020810151606084015260a06138e5604083015160c06080870152610100860190612c5e565b606083015163ffffffff168583015260808301516001600160a01b031660c0860152910151838203603f190160e0850152612c91565b03601f198101835282610656565b51902091614751565b61393d6002916129f2565b500162ffffff8260081c16805f5281602052600160ff60405f205494161b8080941614613975575f5260205260405f20908154179055565b60405163954476d960e01b8152600490fd5b9081602091031261042e575190565b91908201809211612f8057565b91959495939092935f9681519081815103613b725781613a22575b505050826139cd575b50505050565b6001600160a01b0381613a017ffa7fa7cf6d7dde5f9be65a67e6a1a747e7aa864dcd2d793353c722d80fbbb3579386614814565b6040805195865233602087015291169463ffffffff1693a45f8080806139c7565b604080516370a0823160e01b81523060048083019190915291906020816024816001600160a01b038b165afa9081156135ac575f91613b53575b505f805b868110613a715750505050506139be565b613a7b8189612d85565b51613a89575b600101613a60565b90613a9f90613a98838a612d85565b5190613996565b90828211613b4357613ad9612b6d613ac7613aba848a612d85565b516001600160a01b031690565b613ad1848c612d85565b51908c6147a2565b15613a81579c5087613b39613b318f613b1c613aba613b15613afb848f612d85565b51966001600160a01b03165f5261087360205260405f2090565b928b612d85565b6001600160a01b03165f5260205260405f2090565b918254613996565b905560019c613a81565b50505051632ddaa83160e11b8152fd5b613b6c915060203d602011611088576110798183610656565b5f613a5c565b6040516319a5316760e31b8152600490fd5b6001600160a01b0390613b9681614b97565b1690565b91612b6d90613c1392845160408096015191865191613bb8836105ca565b8252613929613bd360208401924684528985019586526129f2565b5054938851928391613bf86020840196602088525160608d86015260a085019061314a565b9151606084015251608083015203601f198101835282610656565b613c1a5750565b5163582f497d60e11b8152600490fd5b613c3382612d76565b52565b9a989693919c9b9997959492909c6101e08c019d8c5260208c015260408b015260608a0152608089015263ffffffff80921660a08901521660c087015260e08601526101008501526101208401526101408301528051610160830152602081015161018083015260408101516101a08301526060015190613cb682612d76565b6101c00152565b9061074094936080936001600160a01b0380931684526020840152166040820152816060820152019061124f565b905f82516101208101613d02815163ffffffff1690565b63ffffffff42911610613f4d576020850151906002613d2a835f5261087260205260405f2090565b5414613f3b57613d4486925f5261087260205260405f2090565b6002905560608301519060808401519160a08501519260c0860151918560a0810151938860e0810151956101008201519751613d839063ffffffff1690565b61014083015163ffffffff166040840151918451936020860151956101600151613dac906141c0565b966060890151986080019e8f51613dc2906141c0565b906040015190613dd06106c6565b9a8b5260208b015260408a0152600260608a01526040519d8e9b613df49b8d613c36565b037f44b559f101f8fbcc8a0ea43fa91a05a729a5ea6e14a7c75aa750374690137208905f94a46080820151613e2890613b84565b9060408601519560600151613e3c90613b84565b9260800151613e4a90613b84565b6001600160a01b03919082167f0000000000000000000000000000000000000000000000000000000000000000831603613f265784613f13575b613e9087838616614bb2565b51928351151580613f09575b613eaa575b50505050509050565b1690813b15613f055783613ed8959660405196879586948593633a5be8cb60e01b8552339160048601613cbd565b03925af180156135ac57613ef2575b808080808594613ea1565b80613794613eff926105b6565b5f613ee7565b8380fd5b50803b1515613e9c565b613f218730338587166146dc565b613e84565b5f9450613f368785858516614670565b613e90565b604051630479306360e51b8152600490fd5b60405163d642b7d960e01b8152600490fd5b8051916101208301613f75815163ffffffff1690565b63ffffffff42911610613f4d5760208301516001613f9c825f5261087260205260405f2090565b54036141b9576001905b6002613fbb825f5261087260205260405f2090565b5414613f3b57613fd7613fdd915f5261087260205260405f2090565b60029055565b7f44b559f101f8fbcc8a0ea43fa91a05a729a5ea6e14a7c75aa75037469013720860608601516080870151906140aa8760a08a0151958a60c08101519760a08401519860e08301519961403a6101008501519c5163ffffffff1690565b61014085015163ffffffff169160408601519386519561409e61406661016060208b01519a01516141c0565b9960608c01519b604061407c60808301516141c0565b91015190602061408a6106c6565b9e8f528e015260408d015260608c01613c2a565b6040519c8d9c8d613c36565b0390a46140ba6080830151613b84565b9160408201519160806140dc816140d46060850151613b84565b940151613b84565b6001600160a01b03929083167f00000000000000000000000000000000000000000000000000000000000000008416036141a65761411e853033868a166146dc565b61412a85848616614bb2565b015191825115158061419c575b614143575b5050505050565b16803b1561042e57614171935f809460405196879586948593633a5be8cb60e01b8552339160048601613cbd565b03925af180156135ac57614189575b8080808061413c565b80613794614196926105b6565b5f614180565b50803b1515614137565b6141b4858533868a166146dc565b61412a565b5f90613fa6565b805190816141ce5750505f90565b6020012090565b939260429361048e979660208151910120906040519260208401947f8d1994e2bbbd77564cdca06dd819e7ee2a5efa06c80dcb59a4a7b6e39edc538f86526040850152856060850152608084015260a083015260c082015260c0815261423a8161061e565b5190209061047f549061048054906040519160208301937fc2f8787176b8ac6bf7215b4adcc1e069bf4ab82d9ab1df05a57a91d425935b6e8552604084015260608301526080820152608081526142908161063a565b519020906040519161190160f01b8352600283015260228201522090614dcf565b96926107409a9996949198959261014099895260208901526040880152606087015263ffffffff928380921660808801521660a08601521660c084015260e083015261010082015281610120820152019061124f565b6143118151614b97565b6101208101614330614327825163ffffffff1690565b63ffffffff1690565b804210908115614560575b506137f757610140820191614354835163ffffffff1690565b9063ffffffff9182614388817f00000000000000000000000000000000000000000000000000000000000000001642613996565b91161161454e5761016081015163ffffffff169180831680614509575b505060408101908151916001600160a01b037f00000000000000000000000000000000000000000000000000000000000000001680931480614500575b156144b357608082015134036137a057823b1561042e575f60049360405194858092630d0e30db60e41b825234905af19283156135ac577f32ed1a409ef04c7b0227189c3a103dc5ac10e775a15b785dcc510201f7c25ad3936144a0575b505b5161378260608301519260808101519060a081015160c08201519761447f6144746101008501519b5163ffffffff1690565b9b5163ffffffff1690565b83519b60208501519361018060e0870151960151966040519a8b9a8b6142b1565b806137946144ad926105b6565b5f614440565b9150346137a057816144fb6144ec61216d7f32ed1a409ef04c7b0227189c3a103dc5ac10e775a15b785dcc510201f7c25ad39551613b84565b608084015190309033906146dc565b614442565b503415156143e2565b6301e133801015614539575b5060e081015115614527575f806143a5565b60405163495d907f60e01b8152600490fd5b916145479192421690612f68565b905f614515565b60405163582e388960e01b8152600490fd5b61456b9150426135d4565b63ffffffff7f000000000000000000000000000000000000000000000000000000000000000016105f61433b565b60ff5f5460081c161561042e57565b60ff5f5460081c161561042e576001606555565b6001600160a01b0316801561460457610869816001600160a01b03198254161790557fa9e8c42c9e7fca7f62755189a16b2f5314d43d8fb24e91ba54e6d65f9314e8495f80a2565b60405163ba97b39d60e01b8152600490fd5b6001600160a01b0316801561465e5761086a816001600160a01b03198254161790557fa73e8909f8616742d7fe701153d82666f7b7cd480552e23ebb05d358c22fd04e5f80a2565b604051635b03092b60e11b8152600490fd5b60405163a9059cbb60e01b60208201526001600160a01b039092166024830152604482019290925261048e916146b382606481015b03601f198101845283610656565b614ead565b9081602091031261042e575161074081610472565b5f81126146d75790565b5f0390565b909261048e93604051936323b872dd60e01b60208601526001600160a01b0380921660248601521660448401526064830152606482526146b38261063a565b90670de0b6b3a7640000915f828403921283831281169084841390151617612f8057818102918183041490151715612f80570490565b929091905f915b845183101561479a5761476b8386612d85565b519081811015614789575f52602052600160405f205b920191614758565b905f52602052600160405f20614781565b915092501490565b60405163a9059cbb60e01b60208281019182526001600160a01b039094166024830152604482019490945290925f916147de816064810161391b565b519082855af1903d5f5190836147f5575b50505090565b9192509061480a57503b15155b5f80806147ef565b6001915014614802565b906001600160a01b0390818116907f00000000000000000000000000000000000000000000000000000000000000008316820361493e5750803b1561042e57604051632e1a7d4d60e01b815260048101849052905f908290602490829084905af180156135ac5761492b575b50610c5a549161489961086a546001600160a01b031690565b73420000000000000000000000000000000000001090813b1561042e57604051631474f2a960e31b8152602086901c949094166001600160a01b0390811660048601521660248401526044830182905263ffffffff909316606483015260a060848301525f60a483018190529192839160c4918391905af180156135ac5761491e5750565b8061379461048e926105b6565b80613794614938926105b6565b5f614880565b91807f000000000000000000000000000000000000000000000000000000000000000016151580614b6c575b1561498e5750505061048e9061498961086a546001600160a01b031690565b614fe1565b806149bb6149ae856001600160a01b03165f52610c5c60205260405f2090565b546001600160a01b031690565b16614b48577342000000000000000000000000000000000000105b16906149fa61216d6149ae856001600160a01b03165f52610c5d60205260405f2090565b15614ac2578382614a0a92614f3d565b614a296149ae836001600160a01b03165f52610c5d60205260405f2090565b90614a3d61086a546001600160a01b031690565b91614a4e610c5a5463ffffffff1690565b823b1561042e5760405163540abf7360e01b81526001600160a01b0395861660048201529185166024830152929093166044840152606483019390935263ffffffff16608482015260c060a48201525f60c482018190529091829081838160e481015b03925af180156135ac5761491e5750565b5091614ad761086a546001600160a01b031690565b92614ae8610c5a5463ffffffff1690565b93813b1561042e57604051631474f2a960e31b81526001600160a01b03948516600482015293166024840152604483019190915263ffffffff909216606482015260a060848201525f60a482018190529091829081838160c48101614ab1565b614b676149ae846001600160a01b03165f52610c5c60205260405f2090565b6149d6565b50807f000000000000000000000000000000000000000000000000000000000000000016821461496a565b60a01c614ba057565b6040516379ec0ed760e11b8152600490fd5b6001600160a01b0390811690813b15614bf2579061048e92917f000000000000000000000000000000000000000000000000000000000000000016614670565b7f000000000000000000000000000000000000000000000000000000000000000016803b1561042e575f8091602460405180948193632e1a7d4d60e01b83528860048401525af180156135ac57614c64575b5081471061042e575f80809381935af1614c5c612dbd565b501561042e57565b614c6d906105b6565b5f614c44565b614c7c81614d8c565b6001600160a01b0381167fbc7cd75a20ee27fd9adebab32041f755214dbc6bffa90cc0225b39da2e5c2d3b5f80a2815115801590614d34575b614cbd575050565b5f80613861937f206661696c65640000000000000000000000000000000000000000000000000060408051614cf1816105ca565b602781527f416464726573733a206c6f772d6c6576656c2064656c65676174652063616c6c60208201520152602081519101845af4614d2e612dbd565b916152df565b505f614cb5565b614d4481614d8c565b6001600160a01b0381167fbc7cd75a20ee27fd9adebab32041f755214dbc6bffa90cc0225b39da2e5c2d3b5f80a2815115801590614d8457614cbd575050565b506001614cb5565b803b1561042e576001600160a01b037f360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc91166001600160a01b0319825416179055565b614dd983836152ae565b6005819592951015612d8057159384614e97575b508315614e11575b50505015614dff57565b60405163938a182160e01b8152600490fd5b5f929350908291604051614e498161391b6020820194630b135d3f60e11b998a8752602484015260406044840152606483019061124f565b51915afa90614e56612dbd565b82614e89575b82614e6c575b50505f8080614df5565b614e8191925060208082518301019101613987565b145f80614e62565b915060208251101591614e5c565b6001600160a01b0383811691161493505f614ded565b905f806001600160a01b03614f049416927f5361666545524332303a206c6f772d6c6576656c2063616c6c206661696c65646020604051614eed81610578565b818152015260208151910182855af1614d2e612dbd565b8051908115918215614f1a575b50501561042e57565b819250906020918101031261042e5760200151614f36816119a2565b5f80614f11565b6044919260206001600160a01b0360405194858092636eb1769f60e11b8252306004830152808916602483015286165afa9283156135ac575f93614fc0575b508201809211612f805760405163095ea7b360e01b60208201526001600160a01b039093166024840152604483019190915261048e91906146b382606481016146a5565b614fda91935060203d602011611088576110798183610656565b915f614f7c565b906001600160a01b038092167f000000000000000000000000000000000000000000000000000000000000000090837f0000000000000000000000000000000000000000000000000000000000000000169361503e848685614f3d565b604094604051926332dd704760e21b84526020956004948781600481875afa9687156135ac5788915f9861526d575b506040516352b7631960e11b81529086166001600160a01b03811660048301529097909588916024918391165afa9586156135ac575f9661524e575b5095867f0000000000000000000000000000000000000000000000000000000000000000975b6150de57505050505050505050565b8681111561524857865b88156151a057843b1561042e578951634701287760e11b815287810182815263ffffffff7f0000000000000000000000000000000000000000000000000000000000000000166020820152604081018690526001600160a01b03881660608201525f6080820181905260a082018190526107d060c0830152919391908490819060e0010381838a5af19283156135ac576151879361518d575b506135d4565b806150cf565b8061379461519a926105b6565b5f615181565b89516337e9a82760e11b815287810182815263ffffffff7f0000000000000000000000000000000000000000000000000000000000000000166020820152604081018690526001600160a01b038816606082015290929084908490819060800103815f8a5af19283156135ac576151879361521b57506135d4565b61523a90853d8711615241575b6152328183610656565b81019061528e565b505f615181565b503d615228565b806150e8565b615266919650873d8911611088576110798183610656565b945f6150a9565b8691985061528790833d85116135a5576135978183610656565b979061506d565b9081602091031261042e575167ffffffffffffffff8116810361042e5790565b9060418151145f146152d65761122a91602082015190606060408401519301515f1a90615308565b50505f90600290565b90156152f9578151156152f0575090565b3b1561042e5790565b50805190811561042e57602001fd5b7f7fffffffffffffffffffffffffffffff5d576e7357a4501ddfe92f46681b20a08411615378576020935f9360ff60809460405194855216868401526040830152606082015282805260015afa156135ac575f516001600160a01b0381161561537057905f90565b505f90600190565b505050505f9060039056fea264697066735822122055ad2af729c797abdaca5785a9aa033a3c01eebb02e628fb93e9a77e28791a2964736f6c63430008170033"
+ "numDeployments": 5,
+ "solcInputHash": "9ca5938cf4c090d09521d58c1a5ad038",
+ "metadata": "{\"compiler\":{\"version\":\"0.8.23+commit.f704f362\"},\"language\":\"Solidity\",\"output\":{\"abi\":[{\"inputs\":[{\"internalType\":\"address\",\"name\":\"_wrappedNativeTokenAddress\",\"type\":\"address\"},{\"internalType\":\"uint32\",\"name\":\"_depositQuoteTimeBuffer\",\"type\":\"uint32\"},{\"internalType\":\"uint32\",\"name\":\"_fillDeadlineBuffer\",\"type\":\"uint32\"},{\"internalType\":\"contract IERC20\",\"name\":\"_l2Usdc\",\"type\":\"address\"},{\"internalType\":\"contract ITokenMessenger\",\"name\":\"_cctpTokenMessenger\",\"type\":\"address\"}],\"stateMutability\":\"nonpayable\",\"type\":\"constructor\"},{\"inputs\":[],\"name\":\"ClaimedMerkleLeaf\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"DepositsArePaused\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"DisabledRoute\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"ExpiredFillDeadline\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"FillsArePaused\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"InsufficientSpokePoolBalanceToExecuteLeaf\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"InvalidBytes32\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"InvalidChainId\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"InvalidCrossDomainAdmin\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"InvalidDepositorSignature\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"InvalidExclusiveRelayer\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"InvalidFillDeadline\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"InvalidMerkleLeaf\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"InvalidMerkleProof\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"InvalidPayoutAdjustmentPct\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"InvalidQuoteTimestamp\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"InvalidRelayerFeePct\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"InvalidSlowFillRequest\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"InvalidWithdrawalRecipient\",\"type\":\"error\"},{\"inputs\":[{\"internalType\":\"bytes\",\"name\":\"data\",\"type\":\"bytes\"}],\"name\":\"LowLevelCallFailed\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"MaxTransferSizeExceeded\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"MsgValueDoesNotMatchInputAmount\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"NoRelayerRefundToClaim\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"NoSlowFillsInExclusivityWindow\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"NotCrossChainCall\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"NotCrossDomainAdmin\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"NotEOA\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"NotExclusiveRelayer\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"RelayFilled\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"WrongERC7683OrderId\",\"type\":\"error\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address\",\"name\":\"previousAdmin\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"newAdmin\",\"type\":\"address\"}],\"name\":\"AdminChanged\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"beacon\",\"type\":\"address\"}],\"name\":\"BeaconUpgraded\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"bytes32\",\"name\":\"l2TokenAddress\",\"type\":\"bytes32\"},{\"indexed\":true,\"internalType\":\"bytes32\",\"name\":\"refundAddress\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"amount\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"address\",\"name\":\"caller\",\"type\":\"address\"}],\"name\":\"ClaimedRelayerRefund\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"uint256\",\"name\":\"rootBundleId\",\"type\":\"uint256\"}],\"name\":\"EmergencyDeletedRootBundle\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"originToken\",\"type\":\"address\"},{\"indexed\":true,\"internalType\":\"uint256\",\"name\":\"destinationChainId\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"bool\",\"name\":\"enabled\",\"type\":\"bool\"}],\"name\":\"EnabledDepositRoute\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"amountToReturn\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"uint256\",\"name\":\"chainId\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"uint256[]\",\"name\":\"refundAmounts\",\"type\":\"uint256[]\"},{\"indexed\":true,\"internalType\":\"uint32\",\"name\":\"rootBundleId\",\"type\":\"uint32\"},{\"indexed\":true,\"internalType\":\"uint32\",\"name\":\"leafId\",\"type\":\"uint32\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"l2TokenAddress\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"address[]\",\"name\":\"refundAddresses\",\"type\":\"address[]\"},{\"indexed\":false,\"internalType\":\"bool\",\"name\":\"deferredRefunds\",\"type\":\"bool\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"caller\",\"type\":\"address\"}],\"name\":\"ExecutedRelayerRefundRoot\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"bytes32\",\"name\":\"inputToken\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"bytes32\",\"name\":\"outputToken\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"inputAmount\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"outputAmount\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"repaymentChainId\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"uint256\",\"name\":\"originChainId\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"uint256\",\"name\":\"depositId\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"uint32\",\"name\":\"fillDeadline\",\"type\":\"uint32\"},{\"indexed\":false,\"internalType\":\"uint32\",\"name\":\"exclusivityDeadline\",\"type\":\"uint32\"},{\"indexed\":false,\"internalType\":\"bytes32\",\"name\":\"exclusiveRelayer\",\"type\":\"bytes32\"},{\"indexed\":true,\"internalType\":\"bytes32\",\"name\":\"relayer\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"bytes32\",\"name\":\"depositor\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"bytes32\",\"name\":\"recipient\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"bytes32\",\"name\":\"messageHash\",\"type\":\"bytes32\"},{\"components\":[{\"internalType\":\"bytes32\",\"name\":\"updatedRecipient\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"updatedMessageHash\",\"type\":\"bytes32\"},{\"internalType\":\"uint256\",\"name\":\"updatedOutputAmount\",\"type\":\"uint256\"},{\"internalType\":\"enum V3SpokePoolInterface.FillType\",\"name\":\"fillType\",\"type\":\"uint8\"}],\"indexed\":false,\"internalType\":\"struct V3SpokePoolInterface.V3RelayExecutionEventInfo\",\"name\":\"relayExecutionInfo\",\"type\":\"tuple\"}],\"name\":\"FilledRelay\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address\",\"name\":\"inputToken\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"outputToken\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"inputAmount\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"outputAmount\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"repaymentChainId\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"uint256\",\"name\":\"originChainId\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"uint32\",\"name\":\"depositId\",\"type\":\"uint32\"},{\"indexed\":false,\"internalType\":\"uint32\",\"name\":\"fillDeadline\",\"type\":\"uint32\"},{\"indexed\":false,\"internalType\":\"uint32\",\"name\":\"exclusivityDeadline\",\"type\":\"uint32\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"exclusiveRelayer\",\"type\":\"address\"},{\"indexed\":true,\"internalType\":\"address\",\"name\":\"relayer\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"depositor\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"recipient\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"},{\"components\":[{\"internalType\":\"address\",\"name\":\"updatedRecipient\",\"type\":\"address\"},{\"internalType\":\"bytes\",\"name\":\"updatedMessage\",\"type\":\"bytes\"},{\"internalType\":\"uint256\",\"name\":\"updatedOutputAmount\",\"type\":\"uint256\"},{\"internalType\":\"enum V3SpokePoolInterface.FillType\",\"name\":\"fillType\",\"type\":\"uint8\"}],\"indexed\":false,\"internalType\":\"struct V3SpokePoolInterface.LegacyV3RelayExecutionEventInfo\",\"name\":\"relayExecutionInfo\",\"type\":\"tuple\"}],\"name\":\"FilledV3Relay\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"bytes32\",\"name\":\"inputToken\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"bytes32\",\"name\":\"outputToken\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"inputAmount\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"outputAmount\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"uint256\",\"name\":\"destinationChainId\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"uint256\",\"name\":\"depositId\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"uint32\",\"name\":\"quoteTimestamp\",\"type\":\"uint32\"},{\"indexed\":false,\"internalType\":\"uint32\",\"name\":\"fillDeadline\",\"type\":\"uint32\"},{\"indexed\":false,\"internalType\":\"uint32\",\"name\":\"exclusivityDeadline\",\"type\":\"uint32\"},{\"indexed\":true,\"internalType\":\"bytes32\",\"name\":\"depositor\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"bytes32\",\"name\":\"recipient\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"bytes32\",\"name\":\"exclusiveRelayer\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"}],\"name\":\"FundsDeposited\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"uint8\",\"name\":\"version\",\"type\":\"uint8\"}],\"name\":\"Initialized\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"bool\",\"name\":\"isPaused\",\"type\":\"bool\"}],\"name\":\"PausedDeposits\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"bool\",\"name\":\"isPaused\",\"type\":\"bool\"}],\"name\":\"PausedFills\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"uint32\",\"name\":\"rootBundleId\",\"type\":\"uint32\"},{\"indexed\":true,\"internalType\":\"bytes32\",\"name\":\"relayerRefundRoot\",\"type\":\"bytes32\"},{\"indexed\":true,\"internalType\":\"bytes32\",\"name\":\"slowRelayRoot\",\"type\":\"bytes32\"}],\"name\":\"RelayedRootBundle\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"bytes32\",\"name\":\"inputToken\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"bytes32\",\"name\":\"outputToken\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"inputAmount\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"outputAmount\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"uint256\",\"name\":\"originChainId\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"uint256\",\"name\":\"depositId\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"uint32\",\"name\":\"fillDeadline\",\"type\":\"uint32\"},{\"indexed\":false,\"internalType\":\"uint32\",\"name\":\"exclusivityDeadline\",\"type\":\"uint32\"},{\"indexed\":false,\"internalType\":\"bytes32\",\"name\":\"exclusiveRelayer\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"bytes32\",\"name\":\"depositor\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"bytes32\",\"name\":\"recipient\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"bytes32\",\"name\":\"messageHash\",\"type\":\"bytes32\"}],\"name\":\"RequestedSlowFill\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"updatedOutputAmount\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"uint256\",\"name\":\"depositId\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"bytes32\",\"name\":\"depositor\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"bytes32\",\"name\":\"updatedRecipient\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"bytes\",\"name\":\"updatedMessage\",\"type\":\"bytes\"},{\"indexed\":false,\"internalType\":\"bytes\",\"name\":\"depositorSignature\",\"type\":\"bytes\"}],\"name\":\"RequestedSpeedUpDeposit\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"updatedOutputAmount\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"uint32\",\"name\":\"depositId\",\"type\":\"uint32\"},{\"indexed\":true,\"internalType\":\"address\",\"name\":\"depositor\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"updatedRecipient\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"bytes\",\"name\":\"updatedMessage\",\"type\":\"bytes\"},{\"indexed\":false,\"internalType\":\"bytes\",\"name\":\"depositorSignature\",\"type\":\"bytes\"}],\"name\":\"RequestedSpeedUpV3Deposit\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address\",\"name\":\"inputToken\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"outputToken\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"inputAmount\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"outputAmount\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"uint256\",\"name\":\"originChainId\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"uint32\",\"name\":\"depositId\",\"type\":\"uint32\"},{\"indexed\":false,\"internalType\":\"uint32\",\"name\":\"fillDeadline\",\"type\":\"uint32\"},{\"indexed\":false,\"internalType\":\"uint32\",\"name\":\"exclusivityDeadline\",\"type\":\"uint32\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"exclusiveRelayer\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"depositor\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"recipient\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"}],\"name\":\"RequestedV3SlowFill\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"uint32\",\"name\":\"newL1Gas\",\"type\":\"uint32\"}],\"name\":\"SetL1Gas\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"l2Token\",\"type\":\"address\"},{\"indexed\":true,\"internalType\":\"address\",\"name\":\"tokenBridge\",\"type\":\"address\"}],\"name\":\"SetL2TokenBridge\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"l2Token\",\"type\":\"address\"},{\"indexed\":true,\"internalType\":\"address\",\"name\":\"l1Token\",\"type\":\"address\"}],\"name\":\"SetRemoteL1Token\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"newWithdrawalRecipient\",\"type\":\"address\"}],\"name\":\"SetWithdrawalRecipient\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"newAdmin\",\"type\":\"address\"}],\"name\":\"SetXDomainAdmin\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"amountToReturn\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"uint256\",\"name\":\"chainId\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"uint32\",\"name\":\"leafId\",\"type\":\"uint32\"},{\"indexed\":true,\"internalType\":\"bytes32\",\"name\":\"l2TokenAddress\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"caller\",\"type\":\"address\"}],\"name\":\"TokensBridged\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"implementation\",\"type\":\"address\"}],\"name\":\"Upgraded\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address\",\"name\":\"inputToken\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"outputToken\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"inputAmount\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"outputAmount\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"uint256\",\"name\":\"destinationChainId\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"uint32\",\"name\":\"depositId\",\"type\":\"uint32\"},{\"indexed\":false,\"internalType\":\"uint32\",\"name\":\"quoteTimestamp\",\"type\":\"uint32\"},{\"indexed\":false,\"internalType\":\"uint32\",\"name\":\"fillDeadline\",\"type\":\"uint32\"},{\"indexed\":false,\"internalType\":\"uint32\",\"name\":\"exclusivityDeadline\",\"type\":\"uint32\"},{\"indexed\":true,\"internalType\":\"address\",\"name\":\"depositor\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"recipient\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"exclusiveRelayer\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"}],\"name\":\"V3FundsDeposited\",\"type\":\"event\"},{\"inputs\":[],\"name\":\"EMPTY_RELAYER\",\"outputs\":[{\"internalType\":\"bytes32\",\"name\":\"\",\"type\":\"bytes32\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"EMPTY_REPAYMENT_CHAIN_ID\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"INFINITE_FILL_DEADLINE\",\"outputs\":[{\"internalType\":\"uint32\",\"name\":\"\",\"type\":\"uint32\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"MAX_EXCLUSIVITY_PERIOD_SECONDS\",\"outputs\":[{\"internalType\":\"uint32\",\"name\":\"\",\"type\":\"uint32\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"MAX_TRANSFER_SIZE\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"MESSENGER\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"UPDATE_ADDRESS_DEPOSIT_DETAILS_HASH\",\"outputs\":[{\"internalType\":\"bytes32\",\"name\":\"\",\"type\":\"bytes32\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"UPDATE_BYTES32_DEPOSIT_DETAILS_HASH\",\"outputs\":[{\"internalType\":\"bytes32\",\"name\":\"\",\"type\":\"bytes32\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint32\",\"name\":\"_initialDepositId\",\"type\":\"uint32\"},{\"internalType\":\"address\",\"name\":\"_crossDomainAdmin\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"_withdrawalRecipient\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"_l2Eth\",\"type\":\"address\"}],\"name\":\"__OvmSpokePool_init\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint32\",\"name\":\"_initialDepositId\",\"type\":\"uint32\"},{\"internalType\":\"address\",\"name\":\"_crossDomainAdmin\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"_withdrawalRecipient\",\"type\":\"address\"}],\"name\":\"__SpokePool_init\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"cctpTokenMessenger\",\"outputs\":[{\"internalType\":\"contract ITokenMessenger\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"chainId\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"bytes32\",\"name\":\"l2TokenAddress\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"refundAddress\",\"type\":\"bytes32\"}],\"name\":\"claimRelayerRefund\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"crossDomainAdmin\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"bytes32\",\"name\":\"depositor\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"recipient\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"inputToken\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"outputToken\",\"type\":\"bytes32\"},{\"internalType\":\"uint256\",\"name\":\"inputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"outputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"destinationChainId\",\"type\":\"uint256\"},{\"internalType\":\"bytes32\",\"name\":\"exclusiveRelayer\",\"type\":\"bytes32\"},{\"internalType\":\"uint32\",\"name\":\"quoteTimestamp\",\"type\":\"uint32\"},{\"internalType\":\"uint32\",\"name\":\"fillDeadline\",\"type\":\"uint32\"},{\"internalType\":\"uint32\",\"name\":\"exclusivityParameter\",\"type\":\"uint32\"},{\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"}],\"name\":\"deposit\",\"outputs\":[],\"stateMutability\":\"payable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"recipient\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"originToken\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"amount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"destinationChainId\",\"type\":\"uint256\"},{\"internalType\":\"int64\",\"name\":\"relayerFeePct\",\"type\":\"int64\"},{\"internalType\":\"uint32\",\"name\":\"quoteTimestamp\",\"type\":\"uint32\"},{\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"},{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"name\":\"depositDeprecated_5947912356\",\"outputs\":[],\"stateMutability\":\"payable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"depositor\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"recipient\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"originToken\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"amount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"destinationChainId\",\"type\":\"uint256\"},{\"internalType\":\"int64\",\"name\":\"relayerFeePct\",\"type\":\"int64\"},{\"internalType\":\"uint32\",\"name\":\"quoteTimestamp\",\"type\":\"uint32\"},{\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"},{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"name\":\"depositFor\",\"outputs\":[],\"stateMutability\":\"payable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"bytes32\",\"name\":\"depositor\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"recipient\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"inputToken\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"outputToken\",\"type\":\"bytes32\"},{\"internalType\":\"uint256\",\"name\":\"inputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"outputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"destinationChainId\",\"type\":\"uint256\"},{\"internalType\":\"bytes32\",\"name\":\"exclusiveRelayer\",\"type\":\"bytes32\"},{\"internalType\":\"uint32\",\"name\":\"fillDeadlineOffset\",\"type\":\"uint32\"},{\"internalType\":\"uint32\",\"name\":\"exclusivityParameter\",\"type\":\"uint32\"},{\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"}],\"name\":\"depositNow\",\"outputs\":[],\"stateMutability\":\"payable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"depositQuoteTimeBuffer\",\"outputs\":[{\"internalType\":\"uint32\",\"name\":\"\",\"type\":\"uint32\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"depositor\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"recipient\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"inputToken\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"outputToken\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"inputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"outputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"destinationChainId\",\"type\":\"uint256\"},{\"internalType\":\"address\",\"name\":\"exclusiveRelayer\",\"type\":\"address\"},{\"internalType\":\"uint32\",\"name\":\"quoteTimestamp\",\"type\":\"uint32\"},{\"internalType\":\"uint32\",\"name\":\"fillDeadline\",\"type\":\"uint32\"},{\"internalType\":\"uint32\",\"name\":\"exclusivityParameter\",\"type\":\"uint32\"},{\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"}],\"name\":\"depositV3\",\"outputs\":[],\"stateMutability\":\"payable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"depositor\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"recipient\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"inputToken\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"outputToken\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"inputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"outputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"destinationChainId\",\"type\":\"uint256\"},{\"internalType\":\"address\",\"name\":\"exclusiveRelayer\",\"type\":\"address\"},{\"internalType\":\"uint32\",\"name\":\"fillDeadlineOffset\",\"type\":\"uint32\"},{\"internalType\":\"uint32\",\"name\":\"exclusivityParameter\",\"type\":\"uint32\"},{\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"}],\"name\":\"depositV3Now\",\"outputs\":[],\"stateMutability\":\"payable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint256\",\"name\":\"rootBundleId\",\"type\":\"uint256\"}],\"name\":\"emergencyDeleteRootBundle\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"name\":\"enabledDepositRoutes\",\"outputs\":[{\"internalType\":\"bool\",\"name\":\"\",\"type\":\"bool\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint32\",\"name\":\"rootBundleId\",\"type\":\"uint32\"},{\"components\":[{\"internalType\":\"uint256\",\"name\":\"amountToReturn\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"chainId\",\"type\":\"uint256\"},{\"internalType\":\"uint256[]\",\"name\":\"refundAmounts\",\"type\":\"uint256[]\"},{\"internalType\":\"uint32\",\"name\":\"leafId\",\"type\":\"uint32\"},{\"internalType\":\"address\",\"name\":\"l2TokenAddress\",\"type\":\"address\"},{\"internalType\":\"address[]\",\"name\":\"refundAddresses\",\"type\":\"address[]\"}],\"internalType\":\"struct SpokePoolInterface.RelayerRefundLeaf\",\"name\":\"relayerRefundLeaf\",\"type\":\"tuple\"},{\"internalType\":\"bytes32[]\",\"name\":\"proof\",\"type\":\"bytes32[]\"}],\"name\":\"executeRelayerRefundLeaf\",\"outputs\":[],\"stateMutability\":\"payable\",\"type\":\"function\"},{\"inputs\":[{\"components\":[{\"components\":[{\"internalType\":\"bytes32\",\"name\":\"depositor\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"recipient\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"exclusiveRelayer\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"inputToken\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"outputToken\",\"type\":\"bytes32\"},{\"internalType\":\"uint256\",\"name\":\"inputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"outputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"originChainId\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"depositId\",\"type\":\"uint256\"},{\"internalType\":\"uint32\",\"name\":\"fillDeadline\",\"type\":\"uint32\"},{\"internalType\":\"uint32\",\"name\":\"exclusivityDeadline\",\"type\":\"uint32\"},{\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"}],\"internalType\":\"struct V3SpokePoolInterface.V3RelayData\",\"name\":\"relayData\",\"type\":\"tuple\"},{\"internalType\":\"uint256\",\"name\":\"chainId\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"updatedOutputAmount\",\"type\":\"uint256\"}],\"internalType\":\"struct V3SpokePoolInterface.V3SlowFill\",\"name\":\"slowFillLeaf\",\"type\":\"tuple\"},{\"internalType\":\"uint32\",\"name\":\"rootBundleId\",\"type\":\"uint32\"},{\"internalType\":\"bytes32[]\",\"name\":\"proof\",\"type\":\"bytes32[]\"}],\"name\":\"executeSlowRelayLeaf\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"bytes32\",\"name\":\"orderId\",\"type\":\"bytes32\"},{\"internalType\":\"bytes\",\"name\":\"originData\",\"type\":\"bytes\"},{\"internalType\":\"bytes\",\"name\":\"fillerData\",\"type\":\"bytes\"}],\"name\":\"fill\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"fillDeadlineBuffer\",\"outputs\":[{\"internalType\":\"uint32\",\"name\":\"\",\"type\":\"uint32\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"components\":[{\"internalType\":\"bytes32\",\"name\":\"depositor\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"recipient\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"exclusiveRelayer\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"inputToken\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"outputToken\",\"type\":\"bytes32\"},{\"internalType\":\"uint256\",\"name\":\"inputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"outputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"originChainId\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"depositId\",\"type\":\"uint256\"},{\"internalType\":\"uint32\",\"name\":\"fillDeadline\",\"type\":\"uint32\"},{\"internalType\":\"uint32\",\"name\":\"exclusivityDeadline\",\"type\":\"uint32\"},{\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"}],\"internalType\":\"struct V3SpokePoolInterface.V3RelayData\",\"name\":\"relayData\",\"type\":\"tuple\"},{\"internalType\":\"uint256\",\"name\":\"repaymentChainId\",\"type\":\"uint256\"},{\"internalType\":\"bytes32\",\"name\":\"repaymentAddress\",\"type\":\"bytes32\"}],\"name\":\"fillRelay\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"components\":[{\"internalType\":\"bytes32\",\"name\":\"depositor\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"recipient\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"exclusiveRelayer\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"inputToken\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"outputToken\",\"type\":\"bytes32\"},{\"internalType\":\"uint256\",\"name\":\"inputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"outputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"originChainId\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"depositId\",\"type\":\"uint256\"},{\"internalType\":\"uint32\",\"name\":\"fillDeadline\",\"type\":\"uint32\"},{\"internalType\":\"uint32\",\"name\":\"exclusivityDeadline\",\"type\":\"uint32\"},{\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"}],\"internalType\":\"struct V3SpokePoolInterface.V3RelayData\",\"name\":\"relayData\",\"type\":\"tuple\"},{\"internalType\":\"uint256\",\"name\":\"repaymentChainId\",\"type\":\"uint256\"},{\"internalType\":\"bytes32\",\"name\":\"repaymentAddress\",\"type\":\"bytes32\"},{\"internalType\":\"uint256\",\"name\":\"updatedOutputAmount\",\"type\":\"uint256\"},{\"internalType\":\"bytes32\",\"name\":\"updatedRecipient\",\"type\":\"bytes32\"},{\"internalType\":\"bytes\",\"name\":\"updatedMessage\",\"type\":\"bytes\"},{\"internalType\":\"bytes\",\"name\":\"depositorSignature\",\"type\":\"bytes\"}],\"name\":\"fillRelayWithUpdatedDeposit\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"bytes32\",\"name\":\"\",\"type\":\"bytes32\"}],\"name\":\"fillStatuses\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"components\":[{\"internalType\":\"address\",\"name\":\"depositor\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"recipient\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"exclusiveRelayer\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"inputToken\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"outputToken\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"inputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"outputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"originChainId\",\"type\":\"uint256\"},{\"internalType\":\"uint32\",\"name\":\"depositId\",\"type\":\"uint32\"},{\"internalType\":\"uint32\",\"name\":\"fillDeadline\",\"type\":\"uint32\"},{\"internalType\":\"uint32\",\"name\":\"exclusivityDeadline\",\"type\":\"uint32\"},{\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"}],\"internalType\":\"struct V3SpokePoolInterface.V3RelayDataLegacy\",\"name\":\"relayData\",\"type\":\"tuple\"},{\"internalType\":\"uint256\",\"name\":\"repaymentChainId\",\"type\":\"uint256\"}],\"name\":\"fillV3Relay\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"getCurrentTime\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"l2TokenAddress\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"refundAddress\",\"type\":\"address\"}],\"name\":\"getRelayerRefund\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"msgSender\",\"type\":\"address\"},{\"internalType\":\"bytes32\",\"name\":\"depositor\",\"type\":\"bytes32\"},{\"internalType\":\"uint256\",\"name\":\"depositNonce\",\"type\":\"uint256\"}],\"name\":\"getUnsafeDepositId\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"pure\",\"type\":\"function\"},{\"inputs\":[{\"components\":[{\"internalType\":\"bytes32\",\"name\":\"depositor\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"recipient\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"exclusiveRelayer\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"inputToken\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"outputToken\",\"type\":\"bytes32\"},{\"internalType\":\"uint256\",\"name\":\"inputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"outputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"originChainId\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"depositId\",\"type\":\"uint256\"},{\"internalType\":\"uint32\",\"name\":\"fillDeadline\",\"type\":\"uint32\"},{\"internalType\":\"uint32\",\"name\":\"exclusivityDeadline\",\"type\":\"uint32\"},{\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"}],\"internalType\":\"struct V3SpokePoolInterface.V3RelayData\",\"name\":\"relayData\",\"type\":\"tuple\"}],\"name\":\"getV3RelayHash\",\"outputs\":[{\"internalType\":\"bytes32\",\"name\":\"\",\"type\":\"bytes32\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint32\",\"name\":\"_initialDepositId\",\"type\":\"uint32\"},{\"internalType\":\"address\",\"name\":\"_crossDomainAdmin\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"_withdrawalRecipient\",\"type\":\"address\"}],\"name\":\"initialize\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"l1Gas\",\"outputs\":[{\"internalType\":\"uint32\",\"name\":\"\",\"type\":\"uint32\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"l2Eth\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"bytes[]\",\"name\":\"data\",\"type\":\"bytes[]\"}],\"name\":\"multicall\",\"outputs\":[{\"internalType\":\"bytes[]\",\"name\":\"results\",\"type\":\"bytes[]\"}],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"numberOfDeposits\",\"outputs\":[{\"internalType\":\"uint32\",\"name\":\"\",\"type\":\"uint32\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"bool\",\"name\":\"pause\",\"type\":\"bool\"}],\"name\":\"pauseDeposits\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"bool\",\"name\":\"pause\",\"type\":\"bool\"}],\"name\":\"pauseFills\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"pausedDeposits\",\"outputs\":[{\"internalType\":\"bool\",\"name\":\"\",\"type\":\"bool\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"pausedFills\",\"outputs\":[{\"internalType\":\"bool\",\"name\":\"\",\"type\":\"bool\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"proxiableUUID\",\"outputs\":[{\"internalType\":\"bytes32\",\"name\":\"\",\"type\":\"bytes32\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"recipientCircleDomainId\",\"outputs\":[{\"internalType\":\"uint32\",\"name\":\"\",\"type\":\"uint32\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"bytes32\",\"name\":\"relayerRefundRoot\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"slowRelayRoot\",\"type\":\"bytes32\"}],\"name\":\"relayRootBundle\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"name\":\"relayerRefund\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"name\":\"remoteL1Tokens\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"components\":[{\"internalType\":\"bytes32\",\"name\":\"depositor\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"recipient\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"exclusiveRelayer\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"inputToken\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"outputToken\",\"type\":\"bytes32\"},{\"internalType\":\"uint256\",\"name\":\"inputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"outputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"originChainId\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"depositId\",\"type\":\"uint256\"},{\"internalType\":\"uint32\",\"name\":\"fillDeadline\",\"type\":\"uint32\"},{\"internalType\":\"uint32\",\"name\":\"exclusivityDeadline\",\"type\":\"uint32\"},{\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"}],\"internalType\":\"struct V3SpokePoolInterface.V3RelayData\",\"name\":\"relayData\",\"type\":\"tuple\"}],\"name\":\"requestSlowFill\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"name\":\"rootBundles\",\"outputs\":[{\"internalType\":\"bytes32\",\"name\":\"slowRelayRoot\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"relayerRefundRoot\",\"type\":\"bytes32\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"newCrossDomainAdmin\",\"type\":\"address\"}],\"name\":\"setCrossDomainAdmin\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"originToken\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"destinationChainId\",\"type\":\"uint256\"},{\"internalType\":\"bool\",\"name\":\"enabled\",\"type\":\"bool\"}],\"name\":\"setEnableRoute\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint32\",\"name\":\"newl1Gas\",\"type\":\"uint32\"}],\"name\":\"setL1GasLimit\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"l2Token\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"l1Token\",\"type\":\"address\"}],\"name\":\"setRemoteL1Token\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"l2Token\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"tokenBridge\",\"type\":\"address\"}],\"name\":\"setTokenBridge\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"newWithdrawalRecipient\",\"type\":\"address\"}],\"name\":\"setWithdrawalRecipient\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"bytes32\",\"name\":\"depositor\",\"type\":\"bytes32\"},{\"internalType\":\"uint256\",\"name\":\"depositId\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"updatedOutputAmount\",\"type\":\"uint256\"},{\"internalType\":\"bytes32\",\"name\":\"updatedRecipient\",\"type\":\"bytes32\"},{\"internalType\":\"bytes\",\"name\":\"updatedMessage\",\"type\":\"bytes\"},{\"internalType\":\"bytes\",\"name\":\"depositorSignature\",\"type\":\"bytes\"}],\"name\":\"speedUpDeposit\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"depositor\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"depositId\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"updatedOutputAmount\",\"type\":\"uint256\"},{\"internalType\":\"address\",\"name\":\"updatedRecipient\",\"type\":\"address\"},{\"internalType\":\"bytes\",\"name\":\"updatedMessage\",\"type\":\"bytes\"},{\"internalType\":\"bytes\",\"name\":\"depositorSignature\",\"type\":\"bytes\"}],\"name\":\"speedUpV3Deposit\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"name\":\"tokenBridges\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"bytes[]\",\"name\":\"data\",\"type\":\"bytes[]\"}],\"name\":\"tryMulticall\",\"outputs\":[{\"components\":[{\"internalType\":\"bool\",\"name\":\"success\",\"type\":\"bool\"},{\"internalType\":\"bytes\",\"name\":\"returnData\",\"type\":\"bytes\"}],\"internalType\":\"struct MultiCallerUpgradeable.Result[]\",\"name\":\"results\",\"type\":\"tuple[]\"}],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"bytes32\",\"name\":\"depositor\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"recipient\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"inputToken\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"outputToken\",\"type\":\"bytes32\"},{\"internalType\":\"uint256\",\"name\":\"inputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"outputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"destinationChainId\",\"type\":\"uint256\"},{\"internalType\":\"bytes32\",\"name\":\"exclusiveRelayer\",\"type\":\"bytes32\"},{\"internalType\":\"uint256\",\"name\":\"depositNonce\",\"type\":\"uint256\"},{\"internalType\":\"uint32\",\"name\":\"quoteTimestamp\",\"type\":\"uint32\"},{\"internalType\":\"uint32\",\"name\":\"fillDeadline\",\"type\":\"uint32\"},{\"internalType\":\"uint32\",\"name\":\"exclusivityParameter\",\"type\":\"uint32\"},{\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"}],\"name\":\"unsafeDeposit\",\"outputs\":[],\"stateMutability\":\"payable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"newImplementation\",\"type\":\"address\"}],\"name\":\"upgradeTo\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"newImplementation\",\"type\":\"address\"},{\"internalType\":\"bytes\",\"name\":\"data\",\"type\":\"bytes\"}],\"name\":\"upgradeToAndCall\",\"outputs\":[],\"stateMutability\":\"payable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"usdcToken\",\"outputs\":[{\"internalType\":\"contract IERC20\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"withdrawalRecipient\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"wrappedNativeToken\",\"outputs\":[{\"internalType\":\"contract WETH9Interface\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"stateMutability\":\"payable\",\"type\":\"receive\"}],\"devdoc\":{\"custom:security-contact\":\"bugs@across.to\",\"events\":{\"AdminChanged(address,address)\":{\"details\":\"Emitted when the admin account has changed.\"},\"BeaconUpgraded(address)\":{\"details\":\"Emitted when the beacon is changed.\"},\"Initialized(uint8)\":{\"details\":\"Triggered when the contract has been initialized or reinitialized.\"},\"Upgraded(address)\":{\"details\":\"Emitted when the implementation is upgraded.\"}},\"kind\":\"dev\",\"methods\":{\"__OvmSpokePool_init(uint32,address,address,address)\":{\"params\":{\"_crossDomainAdmin\":\"Cross domain admin to set. Can be changed by admin.\",\"_initialDepositId\":\"Starting deposit ID. Set to 0 unless this is a re-deployment in order to mitigate relay hash collisions.\",\"_l2Eth\":\"Address of L2 ETH token. Usually should be Lib_PreeployAddresses.OVM_ETH but sometimes this can be different, like with Boba which flips the WETH and OVM_ETH addresses.\",\"_withdrawalRecipient\":\"Address which receives token withdrawals. Can be changed by admin. For Spoke Pools on L2, this will likely be the hub pool.\"}},\"__SpokePool_init(uint32,address,address)\":{\"params\":{\"_crossDomainAdmin\":\"Cross domain admin to set. Can be changed by admin.\",\"_initialDepositId\":\"Starting deposit ID. Set to 0 unless this is a re-deployment in order to mitigate relay hash collisions.\",\"_withdrawalRecipient\":\"Address which receives token withdrawals. Can be changed by admin. For Spoke Pools on L2, this will likely be the hub pool.\"}},\"chainId()\":{\"details\":\"Some L2s like ZKSync don't support the CHAIN_ID opcode so we allow the implementer to override this.\"},\"claimRelayerRefund(bytes32,bytes32)\":{\"params\":{\"l2TokenAddress\":\"Address of the L2 token to claim refunds for.\",\"refundAddress\":\"Address to send the refund to.\"}},\"constructor\":{\"custom:oz-upgrades-unsafe-allow\":\"constructor\"},\"deposit(bytes32,bytes32,bytes32,bytes32,uint256,uint256,uint256,bytes32,uint32,uint32,uint32,bytes)\":{\"details\":\"On the destination chain, the hash of the deposit data will be used to uniquely identify this deposit, so modifying any params in it will result in a different hash and a different deposit. The hash will comprise all parameters to this function along with this chain's chainId(). Relayers are only refunded for filling deposits with deposit hashes that map exactly to the one emitted by this contract.\",\"params\":{\"depositor\":\"The account credited with the deposit who can request to \\\"speed up\\\" this deposit by modifying the output amount, recipient, and message.\",\"destinationChainId\":\"The destination chain identifier. Must be enabled along with the input token as a valid deposit route from this spoke pool or this transaction will revert.\",\"exclusiveRelayer\":\"The relayer that will be exclusively allowed to fill this deposit before the exclusivity deadline timestamp. This must be a valid, non-zero address if the exclusivity deadline is greater than the current block.timestamp. If the exclusivity deadline is < currentTime, then this must be address(0), and vice versa if this is address(0).\",\"exclusivityParameter\":\"This value is used to set the exclusivity deadline timestamp in the emitted deposit event. Before this destination chain timestamp, only the exclusiveRelayer (if set to a non-zero address), can fill this deposit. There are three ways to use this parameter: 1. NO EXCLUSIVITY: If this value is set to 0, then a timestamp of 0 will be emitted, meaning that there is no exclusivity period. 2. OFFSET: If this value is less than MAX_EXCLUSIVITY_PERIOD_SECONDS, then add this value to the block.timestamp to derive the exclusive relayer deadline. Note that using the parameter in this way will expose the filler of the deposit to the risk that the block.timestamp of this event gets changed due to a chain-reorg, which would also change the exclusivity timestamp. 3. TIMESTAMP: Otherwise, set this value as the exclusivity deadline timestamp. which is the deadline for the exclusiveRelayer to fill the deposit.\",\"fillDeadline\":\"The deadline for the relayer to fill the deposit. After this destination chain timestamp, the fill will revert on the destination chain. Must be set before currentTime + fillDeadlineBuffer, where currentTime is block.timestamp on this chain or this transaction will revert.\",\"inputAmount\":\"The amount of input tokens to pull from the caller's account and lock into this contract. This amount will be sent to the relayer on their repayment chain of choice as a refund following an optimistic challenge window in the HubPool, less a system fee.\",\"inputToken\":\"The token pulled from the caller's account and locked into this contract to initiate the deposit. The equivalent of this token on the relayer's repayment chain of choice will be sent as a refund. If this is equal to the wrapped native token then the caller can optionally pass in native token as msg.value, as long as msg.value = inputTokenAmount.\",\"message\":\"The message to send to the recipient on the destination chain if the recipient is a contract. If the message is not empty, the recipient contract must implement handleV3AcrossMessage() or the fill will revert.\",\"outputAmount\":\"The amount of output tokens that the relayer will send to the recipient on the destination.\",\"outputToken\":\"The token that the relayer will send to the recipient on the destination chain. Must be an ERC20.\",\"quoteTimestamp\":\"The HubPool timestamp that is used to determine the system fee paid by the depositor. This must be set to some time between [currentTime - depositQuoteTimeBuffer, currentTime] where currentTime is block.timestamp on this chain or this transaction will revert.\",\"recipient\":\"The account receiving funds on the destination chain. Can be an EOA or a contract. If the output token is the wrapped native token for the chain, then the recipient will receive native token if an EOA or wrapped native token if a contract.\"}},\"depositDeprecated_5947912356(address,address,uint256,uint256,int64,uint32,bytes,uint256)\":{\"details\":\"DEPRECATION NOTICE: this function is deprecated and will be removed in the future. Please use deposit (under DEPOSITOR FUNCTIONS below) or depositV3 instead.Produces a FundsDeposited event with an infinite expiry, meaning that this deposit can never expire. Moreover, the event's outputToken is set to 0x0 meaning that this deposit can always be slow filled.\",\"params\":{\"amount\":\"Amount of tokens to deposit. Will be amount of tokens to receive less fees.\",\"destinationChainId\":\"Denotes network where user will receive funds from SpokePool by a relayer.\",\"message\":\"Arbitrary data that can be used to pass additional information to the recipient along with the tokens. Note: this is intended to be used to pass along instructions for how a contract should use or allocate the tokens.\",\"originToken\":\"Token to lock into this contract to initiate deposit.\",\"quoteTimestamp\":\"Timestamp used by relayers to compute this deposit's realizedLPFeePct which is paid to LP pool on HubPool.\",\"recipient\":\"Address to receive funds at on destination chain.\",\"relayerFeePct\":\"% of deposit amount taken out to incentivize a fast relayer.\"}},\"depositFor(address,address,address,uint256,uint256,int64,uint32,bytes,uint256)\":{\"details\":\"DEPRECATION NOTICE: this function is deprecated and will be removed in the future. Please use the other deposit or depositV3 instead.\",\"params\":{\"amount\":\"Amount of tokens to deposit. Will be amount of tokens to receive less fees.\",\"depositor\":\"Address who is credited for depositing funds on origin chain and can speed up the deposit.\",\"destinationChainId\":\"Denotes network where user will receive funds from SpokePool by a relayer.\",\"message\":\"Arbitrary data that can be used to pass additional information to the recipient along with the tokens. Note: this is intended to be used to pass along instructions for how a contract should use or allocate the tokens.\",\"originToken\":\"Token to lock into this contract to initiate deposit.\",\"quoteTimestamp\":\"Timestamp used by relayers to compute this deposit's realizedLPFeePct which is paid to LP pool on HubPool.\",\"recipient\":\"Address to receive funds at on destination chain.\",\"relayerFeePct\":\"% of deposit amount taken out to incentivize a fast relayer.\"}},\"depositNow(bytes32,bytes32,bytes32,bytes32,uint256,uint256,uint256,bytes32,uint32,uint32,bytes)\":{\"params\":{\"depositor\":\"The account credited with the deposit who can request to \\\"speed up\\\" this deposit by modifying the output amount, recipient, and message.\",\"destinationChainId\":\"The destination chain identifier. Must be enabled along with the input token as a valid deposit route from this spoke pool or this transaction will revert.\",\"exclusiveRelayer\":\"The relayer that will be exclusively allowed to fill this deposit before the exclusivity deadline timestamp.\",\"exclusivityParameter\":\"See identically named parameter in deposit() comments.\",\"fillDeadlineOffset\":\"Added to the current time to set the fill deadline, which is the deadline for the relayer to fill the deposit. After this destination chain timestamp, the fill will revert on the destination chain.\",\"inputAmount\":\"The amount of input tokens to pull from the caller's account and lock into this contract. This amount will be sent to the relayer on their repayment chain of choice as a refund following an optimistic challenge window in the HubPool, plus a system fee.\",\"inputToken\":\"The token pulled from the caller's account and locked into this contract to initiate the deposit. The equivalent of this token on the relayer's repayment chain of choice will be sent as a refund. If this is equal to the wrapped native token then the caller can optionally pass in native token as msg.value, as long as msg.value = inputTokenAmount.\",\"message\":\"The message to send to the recipient on the destination chain if the recipient is a contract. If the message is not empty, the recipient contract must implement handleV3AcrossMessage() or the fill will revert.\",\"outputAmount\":\"The amount of output tokens that the relayer will send to the recipient on the destination.\",\"outputToken\":\"The token that the relayer will send to the recipient on the destination chain. Must be an ERC20.\",\"recipient\":\"The account receiving funds on the destination chain. Can be an EOA or a contract. If the output token is the wrapped native token for the chain, then the recipient will receive native token if an EOA or wrapped native token if a contract.\"}},\"depositV3(address,address,address,address,uint256,uint256,uint256,address,uint32,uint32,uint32,bytes)\":{\"details\":\"This version mirrors the original `depositV3` function, but uses `address` types for `depositor`, `recipient`, `inputToken`, `outputToken`, and `exclusiveRelayer` for compatibility with contracts using the `address` type. The key functionality and logic remain identical, ensuring interoperability across both versions.\",\"params\":{\"depositor\":\"The account credited with the deposit who can request to \\\"speed up\\\" this deposit by modifying the output amount, recipient, and message.\",\"destinationChainId\":\"The destination chain identifier. Must be enabled along with the input token as a valid deposit route from this spoke pool or this transaction will revert.\",\"exclusiveRelayer\":\"The relayer exclusively allowed to fill this deposit before the exclusivity deadline.\",\"exclusivityParameter\":\"This value is used to set the exclusivity deadline timestamp in the emitted deposit event. Before this destination chain timestamp, only the exclusiveRelayer (if set to a non-zero address), can fill this deposit. There are three ways to use this parameter: 1. NO EXCLUSIVITY: If this value is set to 0, then a timestamp of 0 will be emitted, meaning that there is no exclusivity period. 2. OFFSET: If this value is less than MAX_EXCLUSIVITY_PERIOD_SECONDS, then add this value to the block.timestamp to derive the exclusive relayer deadline. Note that using the parameter in this way will expose the filler of the deposit to the risk that the block.timestamp of this event gets changed due to a chain-reorg, which would also change the exclusivity timestamp. 3. TIMESTAMP: Otherwise, set this value as the exclusivity deadline timestamp. which is the deadline for the exclusiveRelayer to fill the deposit.\",\"fillDeadline\":\"The deadline for the relayer to fill the deposit. After this destination chain timestamp, the fill will revert on the destination chain. Must be set before currentTime + fillDeadlineBuffer, where currentTime is block.timestamp on this chain.\",\"inputAmount\":\"The amount of input tokens pulled from the caller's account and locked into this contract. This amount will be sent to the relayer as a refund following an optimistic challenge window in the HubPool, less a system fee.\",\"inputToken\":\"The token pulled from the caller's account and locked into this contract to initiate the deposit. The equivalent of this token on the relayer's repayment chain of choice will be sent as a refund. If this is equal to the wrapped native token, the caller can optionally pass in native token as msg.value, provided msg.value = inputTokenAmount.\",\"message\":\"The message to send to the recipient on the destination chain if the recipient is a contract. If the message is not empty, the recipient contract must implement `handleV3AcrossMessage()` or the fill will revert.\",\"outputAmount\":\"The amount of output tokens that the relayer will send to the recipient on the destination.\",\"outputToken\":\"The token that the relayer will send to the recipient on the destination chain. Must be an ERC20.\",\"quoteTimestamp\":\"The HubPool timestamp that determines the system fee paid by the depositor. This must be set between [currentTime - depositQuoteTimeBuffer, currentTime] where currentTime is block.timestamp on this chain.\",\"recipient\":\"The account receiving funds on the destination chain. Can be an EOA or a contract. If the output token is the wrapped native token for the chain, then the recipient will receive native token if an EOA or wrapped native token if a contract.\"}},\"depositV3Now(address,address,address,address,uint256,uint256,uint256,address,uint32,uint32,bytes)\":{\"details\":\"This version is identical to the original `depositV3Now` but uses `address` types for `depositor`, `recipient`, `inputToken`, `outputToken`, and `exclusiveRelayer` to support compatibility with older systems. It maintains the same logic and purpose, ensuring interoperability with both versions.\",\"params\":{\"depositor\":\"The account credited with the deposit, who can request to \\\"speed up\\\" this deposit by modifying the output amount, recipient, and message.\",\"destinationChainId\":\"The destination chain identifier. Must be enabled with the input token as a valid deposit route from this spoke pool, or the transaction will revert.\",\"exclusiveRelayer\":\"The relayer exclusively allowed to fill the deposit before the exclusivity deadline.\",\"exclusivityParameter\":\"See identically named parameter in deposit() comments.\",\"fillDeadlineOffset\":\"Added to the current time to set the fill deadline. After this timestamp, fills on the destination chain will revert.\",\"inputAmount\":\"The amount of input tokens pulled from the caller's account and locked into this contract. This amount will be sent to the relayer as a refund following an optimistic challenge window in the HubPool, plus a system fee.\",\"inputToken\":\"The token pulled from the caller's account and locked into this contract to initiate the deposit. Equivalent tokens on the relayer's repayment chain will be sent as a refund. If this is the wrapped native token, msg.value must equal inputTokenAmount when passed.\",\"message\":\"The message to send to the recipient on the destination chain. If the recipient is a contract, it must implement `handleV3AcrossMessage()` if the message is not empty, or the fill will revert.\",\"outputAmount\":\"The amount of output tokens the relayer will send to the recipient on the destination.\",\"outputToken\":\"The token the relayer will send to the recipient on the destination chain. Must be an ERC20.\",\"recipient\":\"The account receiving funds on the destination chain. Can be an EOA or a contract. If the output token is the wrapped native token for the chain, then the recipient will receive the native token if an EOA or wrapped native token if a contract.\"}},\"emergencyDeleteRootBundle(uint256)\":{\"params\":{\"rootBundleId\":\"Index of the root bundle that needs to be deleted. Note: this is intentionally a uint256 to ensure that a small input range doesn't limit which indices this method is able to reach.\"}},\"executeRelayerRefundLeaf(uint32,(uint256,uint256,uint256[],uint32,address,address[]),bytes32[])\":{\"params\":{\"proof\":\"Inclusion proof for this leaf in relayer refund root in root bundle.\",\"relayerRefundLeaf\":\"Contains all data necessary to reconstruct leaf contained in root bundle and to refund relayer. This data structure is explained in detail in the SpokePoolInterface.\",\"rootBundleId\":\"Unique ID of root bundle containing relayer refund root that this leaf is contained in.\"}},\"executeSlowRelayLeaf(((bytes32,bytes32,bytes32,bytes32,bytes32,uint256,uint256,uint256,uint256,uint32,uint32,bytes),uint256,uint256),uint32,bytes32[])\":{\"details\":\"Executing a slow fill leaf is equivalent to filling the relayData so this function cannot be used to double fill a recipient. The relayData that is filled is included in the slowFillLeaf and is hashed like any other fill sent through a fill method.There is no relayer credited with filling this relay since funds are sent directly out of this contract.\",\"params\":{\"proof\":\"Inclusion proof for this leaf in slow relay root in root bundle.\",\"rootBundleId\":\"Unique ID of root bundle containing slow relay root that this leaf is contained in.\",\"slowFillLeaf\":\"Contains all data necessary to uniquely identify a relay for this chain. This struct is hashed and included in a merkle root that is relayed to all spoke pools. - relayData: struct containing all the data needed to identify the original deposit to be slow filled. - chainId: chain identifier where slow fill leaf should be executed. If this doesn't match this chain's chainId, then this function will revert. - updatedOutputAmount: Amount to be sent to recipient out of this contract's balance. Can be set differently from relayData.outputAmount to charge a different fee because this deposit was \\\"slow\\\" filled. Usually, this will be set higher to reimburse the recipient for waiting for the slow fill.\"}},\"fill(bytes32,bytes,bytes)\":{\"details\":\"ERC-7683 fill function.\",\"params\":{\"fillerData\":\"Data provided by the filler to inform the fill or express their preferences\",\"orderId\":\"Unique order identifier for this order\",\"originData\":\"Data emitted on the origin to parameterize the fill\"}},\"fillRelay((bytes32,bytes32,bytes32,bytes32,bytes32,uint256,uint256,uint256,uint256,uint32,uint32,bytes),uint256,bytes32)\":{\"details\":\"The fee paid to relayers and the system should be captured in the spread between output amount and input amount when adjusted to be denominated in the input token. A relayer on the destination chain will send outputAmount of outputTokens to the recipient and receive inputTokens on a repayment chain of their choice. Therefore, the fee should account for destination fee transaction costs, the relayer's opportunity cost of capital while they wait to be refunded following an optimistic challenge window in the HubPool, and a system fee charged to relayers.The hash of the relayData will be used to uniquely identify the deposit to fill, so modifying any params in it will result in a different hash and a different deposit. The hash will comprise all parameters passed to deposit() on the origin chain along with that chain's chainId(). This chain's chainId() must therefore match the destinationChainId passed into deposit. Relayers are only refunded for filling deposits with deposit hashes that map exactly to the one emitted by the origin SpokePool therefore the relayer should not modify any params in relayData.Cannot fill more than once. Partial fills are not supported.\",\"params\":{\"relayData\":\"struct containing all the data needed to identify the deposit to be filled. Should match all the same-named parameters emitted in the origin chain FundsDeposited event. - depositor: The account credited with the deposit who can request to \\\"speed up\\\" this deposit by modifying the output amount, recipient, and message. - recipient The account receiving funds on this chain. Can be an EOA or a contract. If the output token is the wrapped native token for the chain, then the recipient will receive native token if an EOA or wrapped native token if a contract. - inputToken: The token pulled from the caller's account to initiate the deposit. The equivalent of this token on the repayment chain will be sent as a refund to the caller. - outputToken The token that the caller will send to the recipient on the destination chain. Must be an ERC20. - inputAmount: This amount, less a system fee, will be sent to the caller on their repayment chain of choice as a refund following an optimistic challenge window in the HubPool. - outputAmount: The amount of output tokens that the caller will send to the recipient. - originChainId: The origin chain identifier. - exclusiveRelayer The relayer that will be exclusively allowed to fill this deposit before the exclusivity deadline timestamp. - fillDeadline The deadline for the caller to fill the deposit. After this timestamp, the fill will revert on the destination chain. - exclusivityDeadline: The deadline for the exclusive relayer to fill the deposit. After this timestamp, anyone can fill this deposit. Note that if this value was set in deposit by adding an offset to the deposit's block.timestamp, there is re-org risk for the caller of this method because the event's block.timestamp can change. Read the comments in `deposit` about the `exclusivityParameter` for more details. - message The message to send to the recipient if the recipient is a contract that implements a handleV3AcrossMessage() public function\",\"repaymentAddress\":\"Address the relayer wants to be receive their refund at.\",\"repaymentChainId\":\"Chain of SpokePool where relayer wants to be refunded after the challenge window has passed. Will receive inputAmount of the equivalent token to inputToken on the repayment chain.\"}},\"fillRelayWithUpdatedDeposit((bytes32,bytes32,bytes32,bytes32,bytes32,uint256,uint256,uint256,uint256,uint32,uint32,bytes),uint256,bytes32,uint256,bytes32,bytes,bytes)\":{\"details\":\"Subject to same exclusivity deadline rules as fillV3Relay().\",\"params\":{\"depositorSignature\":\"Signed EIP712 hashstruct containing the deposit ID. Should be signed by the depositor account.\",\"relayData\":\"struct containing all the data needed to identify the deposit to be filled. See fillV3Relay().\",\"repaymentAddress\":\"Address the relayer wants to be receive their refund at.\",\"repaymentChainId\":\"Chain of SpokePool where relayer wants to be refunded after the challenge window has passed. See fillV3Relay().\",\"updatedMessage\":\"New message to use for this deposit.\",\"updatedOutputAmount\":\"New output amount to use for this deposit.\",\"updatedRecipient\":\"New recipient to use for this deposit.\"}},\"getCurrentTime()\":{\"returns\":{\"_0\":\"uint for the current timestamp.\"}},\"getUnsafeDepositId(address,bytes32,uint256)\":{\"details\":\"msgSender and depositor are both used as inputs to allow passthrough depositors to create unique deposit hash spaces for unique depositors.\",\"params\":{\"depositNonce\":\"The nonce used as input to produce the deposit ID.\",\"depositor\":\"The depositor address used as input to produce the deposit ID.\",\"msgSender\":\"The caller of the transaction used as input to produce the deposit ID.\"},\"returns\":{\"_0\":\"The deposit ID for the unsafe deposit.\"}},\"initialize(uint32,address,address)\":{\"params\":{\"_crossDomainAdmin\":\"Cross domain admin to set. Can be changed by admin.\",\"_initialDepositId\":\"Starting deposit ID. Set to 0 unless this is a re-deployment in order to mitigate relay hash collisions.\",\"_withdrawalRecipient\":\"Address which receives token withdrawals. Can be changed by admin. For Spoke Pools on L2, this will\"}},\"pauseDeposits(bool)\":{\"details\":\"Affects `deposit()` but not `speedUpDeposit()`, so that existing deposits can be sped up and still relayed.\",\"params\":{\"pause\":\"true if the call is meant to pause the system, false if the call is meant to unpause it.\"}},\"pauseFills(bool)\":{\"details\":\"Affects fillRelayWithUpdatedDeposit() and fillRelay().\",\"params\":{\"pause\":\"true if the call is meant to pause the system, false if the call is meant to unpause it.\"}},\"proxiableUUID()\":{\"details\":\"Implementation of the ERC1822 {proxiableUUID} function. This returns the storage slot used by the implementation. It is used to validate the implementation's compatibility when performing an upgrade. IMPORTANT: A proxy pointing at a proxiable contract should not be considered proxiable itself, because this risks bricking a proxy that upgrades to it, by delegating to itself until out of gas. Thus it is critical that this function revert if invoked through a proxy. This is guaranteed by the `notDelegated` modifier.\"},\"relayRootBundle(bytes32,bytes32)\":{\"params\":{\"relayerRefundRoot\":\"Merkle root containing relayer refund leaves that can be individually executed via executeRelayerRefundLeaf().\",\"slowRelayRoot\":\"Merkle root containing slow relay fulfillment leaves that can be individually executed via executeSlowRelayLeaf().\"}},\"requestSlowFill((bytes32,bytes32,bytes32,bytes32,bytes32,uint256,uint256,uint256,uint256,uint32,uint32,bytes))\":{\"details\":\"Slow fills are not possible unless the input and output tokens are \\\"equivalent\\\", i.e. they route to the same L1 token via PoolRebalanceRoutes.Slow fills are created by inserting slow fill objects into a merkle tree that is included in the next HubPool \\\"root bundle\\\". Once the optimistic challenge window has passed, the HubPool will relay the slow root to this chain via relayRootBundle(). Once the slow root is relayed, the slow fill can be executed by anyone who calls executeSlowRelayLeaf().Cannot request a slow fill if the fill deadline has passed.Cannot request a slow fill if the relay has already been filled or a slow fill has already been requested.\",\"params\":{\"relayData\":\"struct containing all the data needed to identify the deposit that should be slow filled. If any of the params are missing or different from the origin chain deposit, then Across will not include a slow fill for the intended deposit.\"}},\"setCrossDomainAdmin(address)\":{\"params\":{\"newCrossDomainAdmin\":\"New cross domain admin.\"}},\"setEnableRoute(address,uint256,bool)\":{\"params\":{\"destinationChainId\":\"Chain ID for where depositor wants to receive funds.\",\"enabled\":\"True to enable deposits, False otherwise.\",\"originToken\":\"Token that depositor can deposit to this contract.\"}},\"setL1GasLimit(uint32)\":{\"params\":{\"newl1Gas\":\"New L1 gas limit to set.\"}},\"setTokenBridge(address,address)\":{\"details\":\"If this mapping isn't set for an L2 token, then the standard bridge will be used to bridge this token.\",\"params\":{\"tokenBridge\":\"Address of token bridge\"}},\"setWithdrawalRecipient(address)\":{\"params\":{\"newWithdrawalRecipient\":\"New withdrawal recipient address.\"}},\"speedUpDeposit(bytes32,uint256,uint256,bytes32,bytes,bytes)\":{\"details\":\"the depositor and depositId must match the params in a FundsDeposited event that the depositor wants to speed up. The relayer has the option but not the obligation to use this updated information when filling the deposit via fillRelayWithUpdatedDeposit().\",\"params\":{\"depositId\":\"Deposit ID to speed up.\",\"depositor\":\"Depositor that must sign the depositorSignature and was the original depositor.\",\"depositorSignature\":\"Signed EIP712 hashstruct containing the deposit ID. Should be signed by the depositor account. If depositor is a contract, then should implement EIP1271 to sign as a contract. See _verifyUpdateV3DepositMessage() for more details about how this signature should be constructed.\",\"updatedMessage\":\"New message to use for this deposit. Can be modified if the recipient is a contract that expects to receive a message from the relay and for some reason needs to be modified.\",\"updatedOutputAmount\":\"New output amount to use for this deposit. Should be lower than previous value otherwise relayer has no incentive to use this updated value.\",\"updatedRecipient\":\"New recipient to use for this deposit. Can be modified if the recipient is a contract that expects to receive a message from the relay and for some reason needs to be modified.\"}},\"speedUpV3Deposit(address,uint256,uint256,address,bytes,bytes)\":{\"details\":\"The `depositor` and `depositId` must match the parameters in a `FundsDeposited` event that the depositor wants to speed up. The relayer is not obligated but has the option to use this updated information when filling the deposit using `fillRelayWithUpdatedDeposit()`. This version uses `address` types for compatibility with systems relying on `address`-based implementations.\",\"params\":{\"depositId\":\"The deposit ID to speed up.\",\"depositor\":\"The depositor that must sign the `depositorSignature` and was the original depositor.\",\"depositorSignature\":\"The signed EIP712 hashstruct containing the deposit ID. Should be signed by the depositor account. If the depositor is a contract, it should implement EIP1271 to sign as a contract. See `_verifyUpdateV3DepositMessage()` for more details on how the signature should be constructed.\",\"updatedMessage\":\"The new message for this deposit. Can be modified if the recipient is a contract that expects to receive a message from the relay and needs to be updated.\",\"updatedOutputAmount\":\"The new output amount to use for this deposit. It should be lower than the previous value, otherwise the relayer has no incentive to use this updated value.\",\"updatedRecipient\":\"The new recipient for this deposit. Can be modified if the original recipient is a contract that expects to receive a message from the relay and needs to be changed.\"}},\"unsafeDeposit(bytes32,bytes32,bytes32,bytes32,uint256,uint256,uint256,bytes32,uint256,uint32,uint32,uint32,bytes)\":{\"details\":\"This is labeled \\\"unsafe\\\" because there is no guarantee that the depositId emitted in the resultant FundsDeposited event is unique which means that the corresponding fill might collide with an existing relay hash on the destination chain SpokePool, which would make this deposit unfillable. In this case, the depositor would subsequently receive a refund of `inputAmount` of `inputToken` on the origin chain after the fill deadline.On the destination chain, the hash of the deposit data will be used to uniquely identify this deposit, so modifying any params in it will result in a different hash and a different deposit. The hash will comprise all parameters to this function along with this chain's chainId(). Relayers are only refunded for filling deposits with deposit hashes that map exactly to the one emitted by this contract.\",\"params\":{\"depositNonce\":\"The nonce that uniquely identifies this deposit. This function will combine this parameter with the msg.sender address to create a unique uint256 depositNonce and ensure that the msg.sender cannot use this function to front-run another depositor's unsafe deposit. This function guarantees that the resultant deposit nonce will not collide with a safe uint256 deposit nonce whose 24 most significant bytes are always 0.\",\"depositor\":\"See identically named parameter in depositV3() comments.\",\"destinationChainId\":\"See identically named parameter in depositV3() comments.\",\"exclusiveRelayer\":\"See identically named parameter in depositV3() comments.\",\"exclusivityParameter\":\"See identically named parameter in depositV3() comments.\",\"fillDeadline\":\"See identically named parameter in depositV3() comments.\",\"inputAmount\":\"See identically named parameter in depositV3() comments.\",\"inputToken\":\"See identically named parameter in depositV3() comments.\",\"message\":\"See identically named parameter in depositV3() comments.\",\"outputAmount\":\"See identically named parameter in depositV3() comments.\",\"outputToken\":\"See identically named parameter in depositV3() comments.\",\"quoteTimestamp\":\"See identically named parameter in depositV3() comments.\",\"recipient\":\"See identically named parameter in depositV3() comments.\"}},\"upgradeTo(address)\":{\"custom:oz-upgrades-unsafe-allow-reachable\":\"delegatecall\",\"details\":\"Upgrade the implementation of the proxy to `newImplementation`. Calls {_authorizeUpgrade}. Emits an {Upgraded} event.\"},\"upgradeToAndCall(address,bytes)\":{\"custom:oz-upgrades-unsafe-allow-reachable\":\"delegatecall\",\"details\":\"Upgrade the implementation of the proxy to `newImplementation`, and subsequently execute the function call encoded in `data`. Calls {_authorizeUpgrade}. Emits an {Upgraded} event.\"}},\"version\":1},\"userdoc\":{\"kind\":\"user\",\"methods\":{\"__OvmSpokePool_init(uint32,address,address,address)\":{\"notice\":\"Construct the OVM SpokePool.\"},\"__SpokePool_init(uint32,address,address)\":{\"notice\":\"Construct the base SpokePool.\"},\"chainId()\":{\"notice\":\"Returns chain ID for this network.\"},\"claimRelayerRefund(bytes32,bytes32)\":{\"notice\":\"Enables a relayer to claim outstanding repayments. Should virtually never be used, unless for some reason relayer repayment transfer fails for reasons such as token transfer reverts due to blacklisting. In this case, the relayer can still call this method and claim the tokens to a new address.\"},\"deposit(bytes32,bytes32,bytes32,bytes32,uint256,uint256,uint256,bytes32,uint32,uint32,uint32,bytes)\":{\"notice\":\"Previously, this function allowed the caller to specify the exclusivityDeadline, otherwise known as the as exact timestamp on the destination chain before which only the exclusiveRelayer could fill the deposit. Now, the caller is expected to pass in a number that will be interpreted either as an offset or a fixed timestamp depending on its value.Request to bridge input token cross chain to a destination chain and receive a specified amount of output tokens. The fee paid to relayers and the system should be captured in the spread between output amount and input amount when adjusted to be denominated in the input token. A relayer on the destination chain will send outputAmount of outputTokens to the recipient and receive inputTokens on a repayment chain of their choice. Therefore, the fee should account for destination fee transaction costs, the relayer's opportunity cost of capital while they wait to be refunded following an optimistic challenge window in the HubPool, and the system fee that they'll be charged.\"},\"depositDeprecated_5947912356(address,address,uint256,uint256,int64,uint32,bytes,uint256)\":{\"notice\":\"Called by user to bridge funds from origin to destination chain. Depositor will effectively lock tokens in this contract and receive a destination token on the destination chain. The origin => destination token mapping is stored on the L1 HubPool.The caller must first approve this contract to spend amount of originToken.The originToken => destinationChainId must be enabled.This method is payable because the caller is able to deposit native token if the originToken is wrappedNativeToken and this function will handle wrapping the native token to wrappedNativeToken.\"},\"depositFor(address,address,address,uint256,uint256,int64,uint32,bytes,uint256)\":{\"notice\":\"The only difference between depositFor and deposit is that the depositor address stored in the relay hash can be overridden by the caller. This means that the passed in depositor can speed up the deposit, which is useful if the deposit is taken from the end user to a middle layer contract, like an aggregator or the SpokePoolVerifier, before calling deposit on this contract.The caller must first approve this contract to spend amount of originToken.The originToken => destinationChainId must be enabled.This method is payable because the caller is able to deposit native token if the originToken is wrappedNativeToken and this function will handle wrapping the native token to wrappedNativeToken.\"},\"depositNow(bytes32,bytes32,bytes32,bytes32,uint256,uint256,uint256,bytes32,uint32,uint32,bytes)\":{\"notice\":\"Submits deposit and sets quoteTimestamp to current Time. Sets fill and exclusivity deadlines as offsets added to the current time. This function is designed to be called by users such as Multisig contracts who do not have certainty when their transaction will mine.\"},\"depositV3(address,address,address,address,uint256,uint256,uint256,address,uint32,uint32,uint32,bytes)\":{\"notice\":\"A version of `deposit` that accepts `address` types for backward compatibility. This function allows bridging of input tokens cross-chain to a destination chain, receiving a specified amount of output tokens. The relayer is refunded in input tokens on a repayment chain of their choice, minus system fees, after an optimistic challenge window. The exclusivity period is specified as an offset from the current block timestamp.\"},\"depositV3Now(address,address,address,address,uint256,uint256,uint256,address,uint32,uint32,bytes)\":{\"notice\":\"A version of `depositNow` that supports addresses as input types for backward compatibility. This function submits a deposit and sets `quoteTimestamp` to the current time. The `fill` and `exclusivity` deadlines are set as offsets added to the current time. It is designed to be called by users, including Multisig contracts, who may not have certainty when their transaction will be mined.\"},\"emergencyDeleteRootBundle(uint256)\":{\"notice\":\"This method is intended to only be used in emergencies where a bad root bundle has reached the SpokePool.\"},\"executeRelayerRefundLeaf(uint32,(uint256,uint256,uint256[],uint32,address,address[]),bytes32[])\":{\"notice\":\"Executes a relayer refund leaf stored as part of a root bundle. Will send the relayer the amount they sent to the recipient plus a relayer fee.\"},\"executeSlowRelayLeaf(((bytes32,bytes32,bytes32,bytes32,bytes32,uint256,uint256,uint256,uint256,uint32,uint32,bytes),uint256,uint256),uint32,bytes32[])\":{\"notice\":\"Executes a slow relay leaf stored as part of a root bundle relayed by the HubPool.\"},\"fill(bytes32,bytes,bytes)\":{\"notice\":\"Fills a single leg of a particular order on the destination chain\"},\"fillRelay((bytes32,bytes32,bytes32,bytes32,bytes32,uint256,uint256,uint256,uint256,uint32,uint32,bytes),uint256,bytes32)\":{\"notice\":\"Fulfill request to bridge cross chain by sending specified output tokens to the recipient.\"},\"fillRelayWithUpdatedDeposit((bytes32,bytes32,bytes32,bytes32,bytes32,uint256,uint256,uint256,uint256,uint32,uint32,bytes),uint256,bytes32,uint256,bytes32,bytes,bytes)\":{\"notice\":\"Identical to fillV3Relay except that the relayer wants to use a depositor's updated output amount, recipient, and/or message. The relayer should only use this function if they can supply a message signed by the depositor that contains the fill's matching deposit ID along with updated relay parameters. If the signature can be verified, then this function will emit a FilledV3Event that will be used by the system for refund verification purposes. In other words, this function is an alternative way to fill a a deposit than fillV3Relay.\"},\"getCurrentTime()\":{\"notice\":\"Gets the current time.\"},\"getUnsafeDepositId(address,bytes32,uint256)\":{\"notice\":\"Returns the deposit ID for an unsafe deposit. This function is used to compute the deposit ID in unsafeDeposit and is provided as a convenience.\"},\"initialize(uint32,address,address)\":{\"notice\":\"Construct the OVM World Chain SpokePool.\"},\"pauseDeposits(bool)\":{\"notice\":\"Pauses deposit-related functions. This is intended to be used if this contract is deprecated or when something goes awry.\"},\"pauseFills(bool)\":{\"notice\":\"Pauses fill-related functions. This is intended to be used if this contract is deprecated or when something goes awry.\"},\"relayRootBundle(bytes32,bytes32)\":{\"notice\":\"This method stores a new root bundle in this contract that can be executed to refund relayers, fulfill slow relays, and send funds back to the HubPool on L1. This method can only be called by the admin and is designed to be called as part of a cross-chain message from the HubPool's executeRootBundle method.\"},\"requestSlowFill((bytes32,bytes32,bytes32,bytes32,bytes32,uint256,uint256,uint256,uint256,uint32,uint32,bytes))\":{\"notice\":\"Request Across to send LP funds to this contract to fulfill a slow fill relay for a deposit in the next bundle.\"},\"setCrossDomainAdmin(address)\":{\"notice\":\"Change cross domain admin address. Callable by admin only.\"},\"setEnableRoute(address,uint256,bool)\":{\"notice\":\"Enable/Disable an origin token => destination chain ID route for deposits. Callable by admin only.\"},\"setL1GasLimit(uint32)\":{\"notice\":\"Change L1 gas limit. Callable only by admin.\"},\"setTokenBridge(address,address)\":{\"notice\":\"Set bridge contract for L2 token used to withdraw back to L1.\"},\"setWithdrawalRecipient(address)\":{\"notice\":\"Change L1 withdrawal recipient address. Callable by admin only.\"},\"speedUpDeposit(bytes32,uint256,uint256,bytes32,bytes,bytes)\":{\"notice\":\"Depositor can use this function to signal to relayer to use updated output amount, recipient, and/or message.\"},\"speedUpV3Deposit(address,uint256,uint256,address,bytes,bytes)\":{\"notice\":\"A version of `speedUpDeposit` using `address` types for backward compatibility. This function allows the depositor to signal to the relayer to use updated output amount, recipient, and/or message when filling a deposit. This can be useful when the deposit needs to be modified after the original transaction has been mined.\"},\"unsafeDeposit(bytes32,bytes32,bytes32,bytes32,uint256,uint256,uint256,bytes32,uint256,uint32,uint32,uint32,bytes)\":{\"notice\":\"See deposit for details. This function is identical to deposit except that it does not use the global deposit ID counter as a deposit nonce, instead allowing the caller to pass in a deposit nonce. This function is designed to be used by anyone who wants to pre-compute their resultant relay data hash, which could be useful for filling a deposit faster and avoiding any risk of a relay hash unexpectedly changing due to another deposit front-running this one and incrementing the global deposit ID counter.\"}},\"notice\":\"World Chain Spoke pool.\",\"version\":1}},\"settings\":{\"compilationTarget\":{\"contracts/WorldChain_SpokePool.sol\":\"WorldChain_SpokePool\"},\"debug\":{\"revertStrings\":\"strip\"},\"evmVersion\":\"shanghai\",\"libraries\":{},\"metadata\":{\"bytecodeHash\":\"ipfs\"},\"optimizer\":{\"enabled\":true,\"runs\":800},\"remappings\":[],\"viaIR\":true},\"sources\":{\"@eth-optimism/contracts/libraries/constants/Lib_PredeployAddresses.sol\":{\"keccak256\":\"0x2bc28307af93e9716151a41a81694b56cbe513ef5eb335fb1d81f35e5db8edfa\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://bbdde142b16f7e0301b7b6a331b35ce609eaf5c9127f14f60c0008abb36e100f\",\"dweb:/ipfs/QmdKUiY6U2vh5egW1bYtvrNhpEmo4Jo4DEwUUmBCfW4eLy\"]},\"@openzeppelin/contracts-upgradeable/crosschain/errorsUpgradeable.sol\":{\"keccak256\":\"0xa1e9b651a2427925598b49ef35da5930abc07859cfac5b9dfb1912f063a024b3\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://c514518c36a3fb1c5f1a99d88857e93160c72ea1fd728c443406ad1acb43ae9a\",\"dweb:/ipfs/Qmc3oXjBNhdeM5cfWpsvewXZAhH34Scgna2W3MvLaiiapQ\"]},\"@openzeppelin/contracts-upgradeable/crosschain/optimism/LibOptimismUpgradeable.sol\":{\"keccak256\":\"0x4e749e196701e221283db53ccaafd372434cdaed2a0b1f5a81b23e36b826b3e8\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://c12147f335d1f8cfee08c853de86d06f63534fe8395f4f0c3c202c045f2ef4d2\",\"dweb:/ipfs/QmNnJzZGLymFtaaKn9zQAtxeNAGmXCDPFyjxzthkUTrKre\"]},\"@openzeppelin/contracts-upgradeable/interfaces/IERC1967Upgradeable.sol\":{\"keccak256\":\"0x47d6e06872b12e72c79d1b5eb55842f860b5fb1207b2317c2358d2766b950a7b\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://ac55bf6f92fc7b90c6d79d346163a0a02bd5c648c7fede08b20e5da96d4ae2a0\",\"dweb:/ipfs/QmQoSrHhka35iKDK5iyNt8cuXXS5ANXVPjLhfsJjktB8V9\"]},\"@openzeppelin/contracts-upgradeable/interfaces/draft-IERC1822Upgradeable.sol\":{\"keccak256\":\"0x77c89f893e403efc6929ba842b7ccf6534d4ffe03afe31670b4a528c0ad78c0f\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://496bd9b3df2455d571018c09f0c6badd29713fdeb907c6aa09d8d28cb603f053\",\"dweb:/ipfs/QmXdJDyYs6WMwMh21dez2BYPxhSUaUYFMDtVNcn2cgFR79\"]},\"@openzeppelin/contracts-upgradeable/proxy/ERC1967/ERC1967UpgradeUpgradeable.sol\":{\"keccak256\":\"0x7795808e3899c805254e3ae58074b20f799b466e3f43e057e47bedee5fb771f8\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://319853a2a682f3f72411507242669ef5e76e0ad3457be53102439709ee8948f0\",\"dweb:/ipfs/QmRtm4Ese9u4jfxXyuWPXLwzenwFotuQjAWV7rXtZTB1E9\"]},\"@openzeppelin/contracts-upgradeable/proxy/beacon/IBeaconUpgradeable.sol\":{\"keccak256\":\"0x24b86ac8c005b8c654fbf6ac34a5a4f61580d7273541e83e013e89d66fbf0908\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://4dbfe1a3b3b3fb64294ce41fd2ad362e7b7012208117864f42c1a67620a6d5c1\",\"dweb:/ipfs/QmVMU5tWt7zBQMmf5cpMX8UMHV86T3kFeTxBTBjFqVWfoJ\"]},\"@openzeppelin/contracts-upgradeable/proxy/utils/Initializable.sol\":{\"keccak256\":\"0x89be10e757d242e9b18d5a32c9fbe2019f6d63052bbe46397a430a1d60d7f794\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://f103ee2e4aecd37aac6ceefe670709cdd7613dee25fa2d4d9feaf7fc0aaa155e\",\"dweb:/ipfs/QmRiNZLoJk5k3HPMYGPGjZFd2ke1ZxjhJZkM45Ec9GH9hv\"]},\"@openzeppelin/contracts-upgradeable/proxy/utils/UUPSUpgradeable.sol\":{\"keccak256\":\"0xefb41f5c1a00249b7a99f0782f8c557865605426a3fb6e5fe9ae334293ae4f33\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://90def55e5782595aabc13f57780c02d3613e5226f20ce6c1709503a63fdeb58f\",\"dweb:/ipfs/Qmb5vcymmNEZUJMaHmYxnhvGJDEsGMae4YjcHwkA74jy99\"]},\"@openzeppelin/contracts-upgradeable/security/ReentrancyGuardUpgradeable.sol\":{\"keccak256\":\"0x2025ccf05f6f1f2fd4e078e552836f525a1864e3854ed555047cd732320ab29b\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://d27f4b23c2dee42394aebaf42bf238285230f472dfd3282a39c3f000ec28214f\",\"dweb:/ipfs/QmQa3DnvccwdWJeWrjgXPnFMTWbzWQWR39hVqC7eEwo2PC\"]},\"@openzeppelin/contracts-upgradeable/token/ERC20/IERC20Upgradeable.sol\":{\"keccak256\":\"0x0e1f0f5f62f67a881cd1a9597acbc0a5e4071f3c2c10449a183b922ae7272e3f\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://c25f742ff154998d19a669e2508c3597b363e123ce9144cd0fcf6521229f401f\",\"dweb:/ipfs/QmQXRuFzStEWqeEPbhQU6cAg9PaSowxJVo4PDKyRod7dco\"]},\"@openzeppelin/contracts-upgradeable/token/ERC20/extensions/IERC20PermitUpgradeable.sol\":{\"keccak256\":\"0x07e881de3b9f6d2c07909f193f24b96c7fe4ea60013260f3f25aecd8bab3c2f8\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://1fed09b97ccb0ff9ba9b6a94224f1d489026bf6b4b7279bfe64fb6e8749dee4d\",\"dweb:/ipfs/QmcRAzaSP1UnGr4vrGkfJmB2L9aiTYoXfV1Lg9gqrVRWn8\"]},\"@openzeppelin/contracts-upgradeable/token/ERC20/utils/SafeERC20Upgradeable.sol\":{\"keccak256\":\"0x23b997be73d3dd46885262704f0f8cfc7273fdadfe303d37969a9561373972b5\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://d03ebe5406134f0c4a017dee625ff615031194493bd1e88504e5c8fae55bc166\",\"dweb:/ipfs/QmUZV5bMbgk2PAkV3coouSeSainHN2jhqaQDJaA7hQRyu2\"]},\"@openzeppelin/contracts-upgradeable/utils/AddressUpgradeable.sol\":{\"keccak256\":\"0x9c80f545915582e63fe206c6ce27cbe85a86fc10b9cd2a0e8c9488fb7c2ee422\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://310136ad60820af4177a11a61d77a3686faf5fca4942b600e08fc940db38396b\",\"dweb:/ipfs/QmbCzMNSTL7Zi7M4UCSqBrkHtp4jjxUnGbkneCZKdR1qeq\"]},\"@openzeppelin/contracts-upgradeable/utils/StorageSlotUpgradeable.sol\":{\"keccak256\":\"0x07ac95acad040f1fb1f6120dd0aa5f702db69446e95f82613721879d30de0908\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://a9df9de7b5da1d1bd3d4b6c073d0174bc4211db60e794a321c8cb5d4eae34685\",\"dweb:/ipfs/QmWe49zj65jayrCe9jZpoWhYUZ1RiwSxyU2s7SBZnMztVy\"]},\"@openzeppelin/contracts-upgradeable/utils/StringsUpgradeable.sol\":{\"keccak256\":\"0xb96dc79b65b7c37937919dcdb356a969ce0aa2e8338322bf4dc027a3c9c9a7eb\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://f8613145881436fc0480fff22da4868d611e2b0c0c3da083334eb4362ce1945a\",\"dweb:/ipfs/QmPqpP3YeRbBdTJRe6Gv2eGsUaANf4J6RwTNRW36iYahfV\"]},\"@openzeppelin/contracts-upgradeable/utils/cryptography/ECDSAUpgradeable.sol\":{\"keccak256\":\"0xa014f65d84b02827055d99993ccdbfb4b56b2c9e91eb278d82a93330659d06e4\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://50a7e716a74f3d48a7f549086faa94afcd58b9f18ac8e9f74af4571f3a1d8d5c\",\"dweb:/ipfs/QmTkDNWkq5o9Cv2jS7s6JvSmsPBkeunZhPe7Z2njGL31wo\"]},\"@openzeppelin/contracts-upgradeable/utils/math/MathUpgradeable.sol\":{\"keccak256\":\"0x2bc0007987c229ae7624eb29be6a9b84f6a6a5872f76248b15208b131ea41c4e\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://2b2835c737d073ef8b82a4cc246495a9740f43e7ff2cf130906b2449ff9bfb91\",\"dweb:/ipfs/QmSCWfNoSvvTN57ic7o1RW6NqSxxGAqbBTnLKc7QHe27qB\"]},\"@openzeppelin/contracts-upgradeable/utils/math/SignedMathUpgradeable.sol\":{\"keccak256\":\"0x88f6b7bba3ee33eeb741f9a0f5bc98b6e6e352d0fe4905377bb328590f84095a\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://88ace2d60f265752f18903d839910be4e4e104340b2957678585b812447825d4\",\"dweb:/ipfs/QmXFkNxMc3AAGzhs2wUEZyErWQjsvoTGyYjuU5oZkFki5Z\"]},\"@openzeppelin/contracts-upgradeable/vendor/optimism/ICrossDomainMessengerUpgradeable.sol\":{\"keccak256\":\"0xb531a6941d55a97d0db7af85c19b6aaf7fc634e550b513daa28e874b2c9b2dfa\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://23b0ce75313d9863512271a51940f6876051a5cb6dce60dd06bc03e565631b9d\",\"dweb:/ipfs/QmZobv3VixcvPxVF6hZgWxo8ELd9nXK935aiBpyHypYSoL\"]},\"@openzeppelin/contracts/interfaces/IERC1271.sol\":{\"keccak256\":\"0x0705a4b1b86d7b0bd8432118f226ba139c44b9dcaba0a6eafba2dd7d0639c544\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://c45b821ef9e882e57c256697a152e108f0f2ad6997609af8904cae99c9bd422e\",\"dweb:/ipfs/QmRKCJW6jjzR5UYZcLpGnhEJ75UVbH6EHkEa49sWx2SKng\"]},\"@openzeppelin/contracts/token/ERC20/IERC20.sol\":{\"keccak256\":\"0x287b55befed2961a7eabd7d7b1b2839cbca8a5b80ef8dcbb25ed3d4c2002c305\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://bd39944e8fc06be6dbe2dd1d8449b5336e23c6a7ba3e8e9ae5ae0f37f35283f5\",\"dweb:/ipfs/QmPV3FGYjVwvKSgAXKUN3r9T9GwniZz83CxBpM7vyj2G53\"]},\"@openzeppelin/contracts/token/ERC20/extensions/IERC20Permit.sol\":{\"keccak256\":\"0xb264c03a3442eb37a68ad620cefd1182766b58bee6cec40343480392d6b14d69\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://28879d01fd22c07b44f006612775f8577defbe459cb01685c5e25cd518c91a71\",\"dweb:/ipfs/QmVgfkwv2Fxw6hhTcDUZhE7NkoSKjab3ipM7UaRbt6uXb5\"]},\"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\":{\"keccak256\":\"0xabefac93435967b4d36a4fabcbdbb918d1f0b7ae3c3d85bc30923b326c927ed1\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://9d213d3befca47da33f6db0310826bcdb148299805c10d77175ecfe1d06a9a68\",\"dweb:/ipfs/QmRgCn6SP1hbBkExUADFuDo8xkT4UU47yjNF5FhCeRbQmS\"]},\"@openzeppelin/contracts/utils/Address.sol\":{\"keccak256\":\"0x006dd67219697fe68d7fbfdea512e7c4cb64a43565ed86171d67e844982da6fa\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://2455248c8ddd9cc6a7af76a13973cddf222072427e7b0e2a7d1aff345145e931\",\"dweb:/ipfs/QmfYjnjRbWqYpuxurqveE6HtzsY1Xx323J428AKQgtBJZm\"]},\"@openzeppelin/contracts/utils/Strings.sol\":{\"keccak256\":\"0x3088eb2868e8d13d89d16670b5f8612c4ab9ff8956272837d8e90106c59c14a0\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://b81d9ff6559ea5c47fc573e17ece6d9ba5d6839e213e6ebc3b4c5c8fe4199d7f\",\"dweb:/ipfs/QmPCW1bFisUzJkyjroY3yipwfism9RRCigCcK1hbXtVM8n\"]},\"@openzeppelin/contracts/utils/cryptography/ECDSA.sol\":{\"keccak256\":\"0x809bc3edb4bcbef8263fa616c1b60ee0004b50a8a1bfa164d8f57fd31f520c58\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://8b93a1e39a4a19eba1600b92c96f435442db88cac91e315c8291547a2a7bcfe2\",\"dweb:/ipfs/QmTm34KVe6uZBZwq8dZDNWwPcm24qBJdxqL3rPxBJ4LrMv\"]},\"@openzeppelin/contracts/utils/cryptography/MerkleProof.sol\":{\"keccak256\":\"0xcf688741f79f4838d5301dcf72d0af9eff11bbab6ab0bb112ad144c7fb672dac\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://85d9c87a481fe99fd28a146c205da0867ef7e1b7edbe0036abc86d2e64eb1f04\",\"dweb:/ipfs/QmR7m1zWQNfZHUKTtqnjoCjCBbNFcjCxV27rxf6iMfhVtG\"]},\"@openzeppelin/contracts/utils/cryptography/SignatureChecker.sol\":{\"keccak256\":\"0x3af3ca86df39aac39a0514c84459d691434a108d2151c8ce9d69f32e315cab80\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://77d1f1cf302cd5e1dfbbb4ce3b281b28e8c52942d4319fce43df2e1b6f02a52d\",\"dweb:/ipfs/QmT6ZXStmK3Knhh9BokeVHQ9HXTBZNgL3Eb1ar1cYg1hWy\"]},\"@openzeppelin/contracts/utils/math/Math.sol\":{\"keccak256\":\"0xe4455ac1eb7fc497bb7402579e7b4d64d928b846fce7d2b6fde06d366f21c2b3\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://cc8841b3cd48ad125e2f46323c8bad3aa0e88e399ec62acb9e57efa7e7c8058c\",\"dweb:/ipfs/QmSqE4mXHA2BXW58deDbXE8MTcsL5JSKNDbm23sVQxRLPS\"]},\"@openzeppelin/contracts/utils/math/SignedMath.sol\":{\"keccak256\":\"0xf92515413956f529d95977adc9b0567d583c6203fc31ab1c23824c35187e3ddc\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://c50fcc459e49a9858b6d8ad5f911295cb7c9ab57567845a250bf0153f84a95c7\",\"dweb:/ipfs/QmcEW85JRzvDkQggxiBBLVAasXWdkhEysqypj9EaB6H2g6\"]},\"contracts/MerkleLib.sol\":{\"keccak256\":\"0xdaf19fdc82593b79a608af8f691aec89a3c0e47b210770deabbe66ece7c35bb1\",\"license\":\"BUSL-1.1\",\"urls\":[\"bzz-raw://03c37f78657beed37257187e237d74492de0199734aa03272a419f66161c0dca\",\"dweb:/ipfs/QmdcXMAoRLZejhh2xcVMWR3WfUvXcArKrCFEE82JDYiJbh\"]},\"contracts/Ovm_SpokePool.sol\":{\"keccak256\":\"0xc46d3c3c1b493137eca6fbe8cd9eae2381cb792945e7ede376cbe15ef95b5454\",\"license\":\"BUSL-1.1\",\"urls\":[\"bzz-raw://7e76ca618799ea810d1fce4449d55ec3bbfbe7482374cf4259755e0103a91c19\",\"dweb:/ipfs/QmVoiCjM4yKCLxe2TNL9i9QViYFCd4f2v9wB37ogtwb6Md\"]},\"contracts/SpokePool.sol\":{\"keccak256\":\"0x62c641e112f07f831e4141dcb6b2f5dade3e60b2c85ebb72d553e036742126fd\",\"license\":\"BUSL-1.1\",\"urls\":[\"bzz-raw://b2b4069889cdac14059dc0452dd352e8d899e85ac6a37886500fcb0608351739\",\"dweb:/ipfs/QmaLeMZevVxtrzxFd4ZER8Ukjk3HRTQ7da7QzzokKB6VMz\"]},\"contracts/WorldChain_SpokePool.sol\":{\"keccak256\":\"0xca2c33ecde7c11a115fac777e053aa03a096d39595778ee59dcc99248ead365f\",\"license\":\"BUSL-1.1\",\"urls\":[\"bzz-raw://c4f6577186f64b911880558c487434fd2f7347aa766be4f5f9cb807d874ab5c2\",\"dweb:/ipfs/QmcAAkTdakUqdz4TUEXYK28moXK8tQQ4ryZmQWb81AUU1t\"]},\"contracts/erc7683/ERC7683.sol\":{\"keccak256\":\"0x726d0426b0f3a11ff59d3a5bbe433c182c0feac9ea2c8c75377fcc2693eccded\",\"license\":\"GPL-3.0-or-later\",\"urls\":[\"bzz-raw://99336cc59dd5923815a8fad6e200b7b265e8446414b099e9b17e3f15f094b774\",\"dweb:/ipfs/QmWCrqefGqEpKsvfn1oBzTTUAFBjscjHc6g1EX2ab51bGA\"]},\"contracts/erc7683/ERC7683Permit2Lib.sol\":{\"keccak256\":\"0x12d0e6dd7e394b75067157ccbe3e8756db138b8f48b3c69494da2e2f294d582f\",\"license\":\"UNLICENSED\",\"urls\":[\"bzz-raw://f4185b2e3396fdb6ce934e462fcdca2c1be29caaa7949ab22072f2105354220e\",\"dweb:/ipfs/QmbPwAQK6K32ENZeytLkPi41TWiWXzFzpJ7Ah67hU8kvjw\"]},\"contracts/external/interfaces/CCTPInterfaces.sol\":{\"keccak256\":\"0xd9d9ecaf4617ec19f7c30f6ed94d15f656d8fc59eb7c757aca406331ba20424c\",\"license\":\"GPL-3.0-or-later\",\"urls\":[\"bzz-raw://19c87a9dfa12eccbfd8da0c5ad064608b0214536ad5fe5456725c8545b2d7372\",\"dweb:/ipfs/QmcaDCLq7bdk2EGi67Z9GfRe8pW77jZqveJvwyGJG5dnw3\"]},\"contracts/external/interfaces/IOpUSDCBridgeAdapter.sol\":{\"keccak256\":\"0x2a088bfda506fd767c796d29c049ac51f2a49bcd61a7f5b57110e55138b8cdc3\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://d97c8b596348a3dd2879d890d20cfb87262c8a3435a7e66927edf571796ee692\",\"dweb:/ipfs/Qmd8KSEvNZzVHpcngkGrahq8C3o9PcHkUtv89HLACYenGc\"]},\"contracts/external/interfaces/IPermit2.sol\":{\"keccak256\":\"0x68f40961ee44fbc71eff2037f2c88ba9bfbccf35b9b1eae5a527b71d19bf3a71\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://2281f309f1b0df4d1c9beeeaa2673152c73e6e20991438420a9de18c51269ea7\",\"dweb:/ipfs/QmafDC3g5yBqPvSof5FmGKv4gMR3TXT5Xj3tULDA5CKmaE\"]},\"contracts/external/interfaces/WETH9Interface.sol\":{\"keccak256\":\"0x3f7892554ec7f54681fdd3cc18a41346c246c9c1afba016c52990ef77741f718\",\"license\":\"BUSL-1.1\",\"urls\":[\"bzz-raw://76e901f8da798eb2fdef8fd0083a51088103269f08ee751598c5a6eba407785f\",\"dweb:/ipfs/QmcAHbwbwCZd78teaK4cHuAvXq71aWX1r9vTGkSRRBDJV1\"]},\"contracts/interfaces/HubPoolInterface.sol\":{\"keccak256\":\"0xefd509ab379b94004b5767d67971e5c0bda4ca1e9f376b5aea75a0297b5d7bd6\",\"license\":\"BUSL-1.1\",\"urls\":[\"bzz-raw://0b7e509e90bcca9b96bf55e92498b17bbb548359c470b17285740080a6c0d9de\",\"dweb:/ipfs/QmdviQBbB58H9HR3tKQepEuYcMKXZthyTThGXUgQDAC828\"]},\"contracts/interfaces/SpokePoolInterface.sol\":{\"keccak256\":\"0x4fefc97b3446f957f2679869ee7d8e8cc319a189f3fe47584b8203256a0d703b\",\"license\":\"BUSL-1.1\",\"urls\":[\"bzz-raw://0a73f80d7737c1a15f4d54225c66b7ffaf69fb85b0e9ef5a06a730f60d43ac13\",\"dweb:/ipfs/QmXegUowEkfsEraUYK2TgweT8j4uKVWxbQCiKV1qtDRKbt\"]},\"contracts/interfaces/SpokePoolMessageHandler.sol\":{\"keccak256\":\"0xef7377f05d40e665eb346fb1647e1341558ce5fd1e03768d81a41a579365ff47\",\"license\":\"BUSL-1.1\",\"urls\":[\"bzz-raw://6689551ad226c66bbab84387f193445ab209bf795f17ce4cf1be9ab5c1984e5d\",\"dweb:/ipfs/Qme3XnW4RZJruCDJTV8MNQsjJj14qPWZHLQZJhY4rh1iV6\"]},\"contracts/interfaces/V3SpokePoolInterface.sol\":{\"keccak256\":\"0x28d33b34690ea41eea70c5cce5db8c5f1066d74b59a23e28c7b4d9afddef7608\",\"license\":\"BUSL-1.1\",\"urls\":[\"bzz-raw://8098952a936841bb3616849c8ee96cf82328998a9cd739030f2ce57cf90d32ee\",\"dweb:/ipfs/Qmb1PpC5RkNsasyjyZrrmbMwXmKzMiSYfzm2B9Kutg6Bmf\"]},\"contracts/libraries/AddressConverters.sol\":{\"keccak256\":\"0x378f28bb4a17a5c47457cb9341086b2140f7faf6c048f702d3528166f0d74453\",\"license\":\"BUSL-1.1\",\"urls\":[\"bzz-raw://0fa273e028c9555202cac439ddf458d074b66c6f74778b2b0e5e17a0e331dc38\",\"dweb:/ipfs/QmYqEaWXgiJnsH8wRAuTKF41bxkxxvY947wdKoZrjM7HVx\"]},\"contracts/libraries/CircleCCTPAdapter.sol\":{\"keccak256\":\"0xf2d4f9d84b80259be516be7e543ea9a504ed665070d8105fbd7c84e7f79f8a32\",\"license\":\"BUSL-1.1\",\"urls\":[\"bzz-raw://42e842b241966fe9e0e612228e4ea43004d02d327bd67749b40fab2edde311bb\",\"dweb:/ipfs/QmafDiwZsycjYjsF32i5suqPTCCNEN3MQvxbvBskBJWggy\"]},\"contracts/upgradeable/AddressLibUpgradeable.sol\":{\"keccak256\":\"0x655040da45a857cf609d7176c7b0647bf76d36e73e856af79d511014c7e8ef81\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://5c17767f34d57380767b49f8584d62598964fc813e6f3587d76b51ec2357bb4e\",\"dweb:/ipfs/QmSyoTa1Snn3KiJD7KjCwsPmNqpJzusXterbEXxbYCZoJK\"]},\"contracts/upgradeable/EIP712CrossChainUpgradeable.sol\":{\"keccak256\":\"0xff617722706d1c0a6d346e56e4598cc5f60adea99b4ac1d2347dcd69270a14f6\",\"license\":\"BUSL-1.1\",\"urls\":[\"bzz-raw://e2d04649c09bad766c5632da2e3a4f1deed1e013e8b713fad1f101e06f4b56a3\",\"dweb:/ipfs/QmfCewdTDr2krzvNY5rH5BprngEtBmxPXCZf6JKavxw2Sb\"]},\"contracts/upgradeable/MultiCallerUpgradeable.sol\":{\"keccak256\":\"0xc1378a7d63785d9381b8fb6e42962499ab26a243292e20981c2792511a4697f3\",\"license\":\"BUSL-1.1\",\"urls\":[\"bzz-raw://2ec8d733e528d6e79732409eb04aa5f8a8bcdf5888e677919a07d8b84afb1598\",\"dweb:/ipfs/QmQF23Gf9vHb6Ne6kaEZmQTjobWzasEWWr5YaBFkuEypz4\"]}},\"version\":1}",
+ "bytecode": "0x61016034620001e257601f6200596d38819003918201601f19168301916001600160401b03831184841017620001e65780849260a094604052833981010312620001e25780516001600160a01b03919082811690819003620001e2576200006960208301620001fa565b6200007760408401620001fa565b916060840151938585168503620001e257608001519485168503620001e2573060805260a05260c05260e0525f5460ff8160081c16620001e25760ff80821603620001a7575b50610120908152610140918252610100915f83526040519161576093846200020d8539608051848181611088015281816115a4015261171e015260a051848181610880015281816138e601528181613a57015281816140780152818161430a0152818161462201528181614c0601528181614c2d0152614f86015260c0518481816119eb0152818161389a0152614810015260e05184818161046e01526145d0015251838181611b94015261552001525182818161082301528181614ac5015281816152b8015261545701525181818161204e01528181614ba90152818161508d015261547a0152f35b60ff90811916175f557f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb3847402498602060405160ff8152a15f620000bd565b5f80fd5b634e487b7160e01b5f52604160045260245ffd5b519063ffffffff82168203620001e25756fe6080604052600436101561001a575b3615610018575f80fd5b005b5f3560e01c8063079bd2c71461043f5780630c5d5f731461043a5780630eaac9f0146104355780631186ec331461043057806311eac8551461042b57806315348e44146103b357806317fcb39b146104265780631b3d5559146104215780631fab657c1461041c578063272751c71461041757806329cb924d146104125780632e3781151461040d5780632e63e59a1461040857806333a84ff0146104035780633659cfe6146103fe578063431023b8146103f9578063437b9116146103f4578063490e49ef146103ef578063493a4f84146103ea5780634f1ef286146103e55780635249fef1146103e05780635285e058146103db57806352d1902d146103d6578063541f4f14146103d1578063577f51f8146103cc57806357f6dcb8146103c75780636068d6cb146103c2578063647c576c146103bd578063670fa8ac146103b85780636bbbcd2e146103b35780636e400983146103ae578063738b62e5146103a9578063766e0703146103a45780637aef642c1461039f5780637b9392321461039a5780637ef413e11461039557806382e2c43f146103905780638a7860ce1461038b5780638b15788e14610386578063927ede2d146103815780639748cf7c1461037c57806397943aa914610377578063979f2bc21461037257806399cc29681461036d5780639a8a059214610368578063a1244c6714610363578063a18a096e1461035e578063ac9650d814610359578063ad5425c614610354578063adb5a6a614610309578063b27a43001461034f578063b370b7f51461034a578063babb6aac14610345578063bf10268d14610340578063c35c83fc1461033b578063ceb4c98714610336578063d7e1583a14610331578063dda521131461032c578063ddd224f114610327578063de7eba7814610322578063deff4b241461031d578063e322921114610318578063ea86bd4614610313578063ee2a53f81461030e578063f79f29ed14610309578063fbbba9ac146103045763fc8a584f0361000e57612cc3565b612c3f565b6125fe565b612c01565b612afe565b612ad5565b6129e0565b6129b0565b612987565b612961565b61292b565b612831565b612806565b612782565b6126ab565b612684565b612645565b61249d565b6123fd565b612296565b61226f565b612255565b6121c0565b6120f2565b612072565b61202f565b612001565b611f83565b611f0b565b611df0565b611db9565b611d11565b611c71565b611c4d565b611bb8565b611b78565b610847565b611b3e565b611a67565b611a0f565b6119cf565b611831565b61176e565b611704565b6116dd565b61168f565b611561565b6114da565b6114bc565b6113ef565b611192565b611060565b611026565b610e2c565b610ccc565b610ca3565b610c04565b610af8565b6109ef565b610861565b610804565b610763565b610516565b6104b0565b610452565b5f91031261044e57565b5f80fd5b3461044e575f36600319011261044e57602060405163ffffffff7f0000000000000000000000000000000000000000000000000000000000000000168152f35b6001600160a01b0381160361044e57565b35906104ae82610492565b565b3461044e57602036600319011261044e5760206004356104cf81610492565b6001600160a01b038091165f52610c5d825260405f205416604051908152f35b63ffffffff81160361044e57565b61014435906104ae826104ef565b35906104ae826104ef565b3461044e57602036600319011261044e5763ffffffff600435610538816104ef565b6105406136d1565b610548613793565b16610c5a8163ffffffff198254161790557fe486a5c4bd7b36eabbfe274c99b39130277417be8d2209b4dae04c4fba64ee3a5f80a26001606555005b634e487b7160e01b5f52604160045260245ffd5b6040810190811067ffffffffffffffff8211176105b457604052565b610584565b6101a0810190811067ffffffffffffffff8211176105b457604052565b67ffffffffffffffff81116105b457604052565b6060810190811067ffffffffffffffff8211176105b457604052565b6080810190811067ffffffffffffffff8211176105b457604052565b6020810190811067ffffffffffffffff8211176105b457604052565b60e0810190811067ffffffffffffffff8211176105b457604052565b60a0810190811067ffffffffffffffff8211176105b457604052565b90601f8019910116810190811067ffffffffffffffff8211176105b457604052565b6040519060c0820182811067ffffffffffffffff8211176105b457604052565b60405190610180820182811067ffffffffffffffff8211176105b457604052565b604051906104ae826105b9565b604051906104ae82610606565b67ffffffffffffffff81116105b457601f01601f191660200190565b92919261071b826106f3565b916107296040519384610676565b82948184528183011161044e578281602093845f960137010152565b9080601f8301121561044e578160206107609335910161070f565b90565b61010036600319011261044e5760043561077c81610492565b60243561078881610492565b6084358060070b810361044e5760a435906107a2826104ef565b60c43567ffffffffffffffff811161044e576107c2903690600401610745565b926107cb613793565b60ff61086b5460e81c166107f2576107eb9460643591604435913361380e565b6001606555005b604051630b4cba3160e31b8152600490fd5b3461044e575f36600319011261044e5760206040516001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000168152f35b3461044e575f36600319011261044e5760206040515f8152f35b3461044e575f36600319011261044e5760206040516001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000168152f35b67ffffffffffffffff81116105b45760051b60200190565b9080601f8301121561044e5760209082356108d6816108a4565b936108e46040519586610676565b81855260208086019260051b82010192831161044e57602001905b82821061090d575050505090565b813581529083019083016108ff565b9080601f8301121561044e576020908235610936816108a4565b936109446040519586610676565b81855260208086019260051b82010192831161044e57602001905b82821061096d575050505090565b838091833561097b81610492565b81520191019061095f565b9291610991826108a4565b9161099f6040519384610676565b829481845260208094019160051b810192831161044e57905b8282106109c55750505050565b813581529083019083016109b8565b9080601f8301121561044e5781602061076093359101610986565b60031960603682011261044e57600435610a08816104ef565b60243567ffffffffffffffff9283821161044e5760c090823603011261044e57610a30610698565b908060040135825260248101356020830152604481013584811161044e57610a5e90600436918401016108bc565b6040830152610a6f6064820161050b565b6060830152610a80608482016104a3565b608083015260a48101359084821161044e576004610aa1923692010161091c565b60a082015260443592831161044e57610ac16100189336906004016109d4565b91612cf3565b9181601f8401121561044e5782359167ffffffffffffffff831161044e576020808501948460051b01011161044e57565b3461044e5760031960603682011261044e5760043567ffffffffffffffff80821161044e5760608236039384011261044e5760243590610b37826104ef565b60443590811161044e57610b4f903690600401610ac7565b919093610b5a613793565b600484013590610182190181121561044e57610bf094610beb93610b87610be4936004369189010161284f565b95610b9d610b986080890151613da4565b613a4d565b610ba687613604565b9060446020890151916101608a015193610bbe610698565b9a8b5260208b015201356040890152606088015260808701525f60a08701523691610986565b9083613dba565b613f0b565b6100186001606555565b8015150361044e57565b3461044e57606036600319011261044e57600435610c2181610492565b602435907f0a21fdd43d0ad0c62689ee7230a47309a050755bcc52eba00310add65297692a60206001600160a01b0360443593610c5d85610bfa565b610c656136d1565b610c6d613793565b1692835f5261086d825260405f20855f52825260405f209015159060ff1981541660ff8316179055604051908152a36001606555005b3461044e575f36600319011261044e576020604051428152f35b908161018091031261044e5790565b3461044e57604036600319011261044e5760043567ffffffffffffffff811161044e57610cfd903690600401610cbd565b610d0681612eeb565b6001600160a01b031690610d1c60208201612eeb565b6001600160a01b031691610d3260408301612eeb565b6001600160a01b0316610d4760608401612eeb565b6001600160a01b031692610d5d60808201612eeb565b6001600160a01b031690610100610d75818301612ef5565b9061012090610d85848301612ef5565b9261014094858101610d9690612ef5565b966101609a8b8301610da89084612eff565b9a909b610db36106b8565b9e8f91825260208201526040015260608d015260808c015260a081013560a08c015260c081013560c08c015260e0013560e08b015263ffffffff1690890152870190610e04919063ffffffff169052565b63ffffffff909116908501523690610e1b9261070f565b908201523360243561001892613635565b3461044e57602036600319011261044e576004803567ffffffffffffffff811161044e57610e5d9036908301610cbd565b610e65613793565b60ff61086b5460e01c166110165763ffffffff80421692610140830193610e9e81610e8f87612ef5565b63ffffffff9182169116101590565b61100657610120840192610eb184612ef5565b1610610ff757610ec9610ec4368561284f565b613604565b90610edd825f5261087260205260405f2090565b54610fe95750610f2c7f3cee3e290f36226751cd0b3321b213890fe9c768e922f267fa6111836ce05c3292610f27610f21610f32945f5261087260205260405f2090565b60019055565b612ef5565b93612ef5565b610f52610f4d610f46610160860186612eff565b369161070f565b6143e0565b90610fdc6040519283926101008701359760e08801359760208101359281359260408301359260c08101359060a081013590606060808201359101358b9693909a999895919261012098959361014089019c895260208901526040880152606087015263ffffffff80921660808701521660a085015260c084015260e08301526101008201520152565b0390a36100186001606555565b604051624be79160e21b8152fd5b60405163d642b7d960e01b8152fd5b50604051630277ae7b60e21b8152fd5b50604051633d90fc5560e11b8152fd5b3461044e575f36600319011261044e5760206040517f9c6dfd61d811b9950a4f2b9adf46357b717c816d22c420d0bde8f2360148f7cd8152f35b3461044e57602036600319011261044e5760043561107d81610492565b6001600160a01b03807f00000000000000000000000000000000000000000000000000000000000000001680301461044e577f360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc90828254160361044e576110e26136d1565b604051916110ef83610622565b5f83527f4910fdfa16fed3260ed0e7147f7cc6da11a60208b5b9406d12a635614ffd91435460ff16156111285750505061001890614dc5565b6020600491604051928380926352d1902d60e01b825288165afa5f9181611161575b50611153575f80fd5b0361044e5761001891614cac565b61118491925060203d60201161118b575b61117c8183610676565b810190613ba7565b905f61114a565b503d611172565b3461044e57608036600319011261044e576004356111af816104ef565b602435906111bc82610492565b6044356111c881610492565b606435916111d583610492565b60ff5f5460081c161561044e5761121c90610c5a624c4b4063ffffffff1982541617905561086b9063ffffffff60c01b1963ffffffff60c01b83549260c01b169116179055565b6040519061122982610598565b6009825260208201916820a1a927a9a996ab1960b91b8352640312e302e360dc1b602060405161125881610598565b60058152015260ff5f5460081c161561044e57610018946112bd936112b89251902061047f557f06c015bd22b4c69690933c1058878ebdfef31f9aaae40bbe86d8a09fe1b2972c610480556112ab614847565b6112b3614856565b61486a565b6148c4565b610c5a9077ffffffffffffffffffffffffffffffffffffffff000000001977ffffffffffffffffffffffffffffffffffffffff0000000083549260201b169116179055565b602060031982011261044e576004359067ffffffffffffffff821161044e5761132d91600401610ac7565b9091565b5f5b8381106113425750505f910152565b8181015183820152602001611333565b9060209161136b81518092818552858086019101611331565b601f01601f1916010190565b6020808201908083528351809252604092604081018260408560051b8401019601945f925b8584106113ad575050505050505090565b9091929394959685806113de600193603f1986820301885286838d5180511515845201519181858201520190611352565b99019401940192959493919061139c565b3461044e576113fd36611302565b611406816108a4565b9160406114166040519485610676565b828452601f19611425846108a4565b015f5b8181106114995750505f5b83811061144c57604051806114488782611377565b0390f35b8061149361145c60019388612f55565b515f8061146a858a8a612f69565b90611479895180938193612f80565b0390305af490611487612f8d565b60208201529015159052565b01611433565b60209083516114a781610598565b5f815282606081830152828901015201611428565b3461044e575f36600319011261044e5760206040516301e133808152f35b3461044e57604036600319011261044e576024356004356114f96136d1565b611501613793565b61086c8054680100000000000000008110156105b45763ffffffff916001820190558361152d82612bc2565b5084600182015555167fc86ba04c55bc5eb2f2876b91c438849a296dbec7b08751c3074d92e04f0a77af5f80a46001606555005b604036600319011261044e5760043561157981610492565b60243567ffffffffffffffff811161044e57611599903690600401610745565b6001600160a01b03807f0000000000000000000000000000000000000000000000000000000000000000169081301461044e577f360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc91818354160361044e576115ff6136d1565b7f4910fdfa16fed3260ed0e7147f7cc6da11a60208b5b9406d12a635614ffd91435460ff16156116355750505061001890614dc5565b6020600491604051928380926352d1902d60e01b825288165afa5f918161166e575b50611660575f80fd5b0361044e5761001891614d74565b61168891925060203d60201161118b5761117c8183610676565b905f611657565b3461044e57604036600319011261044e576001600160a01b036004356116b481610492565b165f5261086d60205260405f206024355f52602052602060ff60405f2054166040519015158152f35b3461044e575f36600319011261044e5760206001600160a01b036108695416604051908152f35b3461044e575f36600319011261044e576001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016300361044e5760206040517f360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc8152f35b61012036600319011261044e5760043561178781610492565b6024359061179482610492565b604435916117a183610492565b60a4358060070b810361044e5760c435916117bb836104ef565b60e43567ffffffffffffffff811161044e576117db903690600401610745565b936117e4613793565b60ff61086b5460e81c166107f2576107eb95608435926064359261380e565b9181601f8401121561044e5782359167ffffffffffffffff831161044e576020838186019501011161044e57565b3461044e5760c036600319011261044e5760043561184e81610492565b6024356044359160643561186181610492565b67ffffffffffffffff9160843583811161044e57611883903690600401611803565b60a49491943591821161044e577f45e04bc8f121ba11466985789ca2822a91109f31bb8ac85504a37b7eaf873c26946118c36119ca933690600401611803565b9290916001600160a01b038097168a6119be6118e036868661070f565b60428d6118ee368b8b61070f565b92602081519101209460409586519160208301937f9c6dfd61d811b9950a4f2b9adf46357b717c816d22c420d0bde8f2360148f7cd85528884015246606084015260808301528760a083015260c082015260c0815261194c8161063e565b51902061047f546104805486519060208201927fc2f8787176b8ac6bf7215b4adcc1e069bf4ab82d9ab1df05a57a91d425935b6e84528883015260608201524660808201526080815261199e8161065a565b5190209085519161190160f01b835260028301526022820152208a614e08565b51978897169a87612fdc565b0390a3005b3461044e575f36600319011261044e57602060405163ffffffff7f0000000000000000000000000000000000000000000000000000000000000000168152f35b3461044e575f36600319011261044e57602060ff61086b5460e81c166040519015158152f35b606090600319011261044e57600435611a4d816104ef565b90602435611a5a81610492565b9060443561076081610492565b3461044e57611a7536611a35565b5f54600881901c60ff1615939290849081611b30575b8115611b10575b501561044e57611ab69284611aad600160ff195f5416175f55565b611af95761300f565b611abc57005b611aca61ff00195f54165f55565b604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb384740249890602090a1005b611b0b61010061ff00195f5416175f55565b61300f565b303b15915081611b22575b505f611a92565b6001915060ff16145f611b1b565b600160ff8216109150611a8b565b3461044e575f36600319011261044e5760206040517f8d1994e2bbbd77564cdca06dd819e7ee2a5efa06c80dcb59a4a7b6e39edc538f8152f35b3461044e575f36600319011261044e57602060405163ffffffff7f0000000000000000000000000000000000000000000000000000000000000000168152f35b3461044e57602036600319011261044e577fe88463c2f254e2b070013a2dc7ee1e099f9bc00534cbdf03af551dc26ae492196020600435611bf881610bfa565b611c006136d1565b611c08613793565b151561086b80547fffff00ffffffffffffffffffffffffffffffffffffffffffffffffffffffffff60ff60e81b8460e81b169116179055604051908152a16001606555005b3461044e575f36600319011261044e57602063ffffffff610c5a5416604051908152f35b61016036600319011261044e57600435611c8a81610492565b60243590611c9782610492565b604435611ca381610492565b60643590611cb082610492565b60e435611cbc81610492565b6101043590611cca826104ef565b6101243592611cd8846104ef565b610144359667ffffffffffffffff881161044e57611cfd610018983690600401611803565b97909660c4359360a4359360843593613155565b61018036600319011261044e57600435611d2a81610492565b60243590611d3782610492565b604435611d4381610492565b60643590611d5082610492565b60e435611d5c81610492565b61010435611d69816104ef565b6101243591611d77836104ef565b611d7f6104fd565b93610164359767ffffffffffffffff891161044e57611da5610018993690600401611803565b98909760c4359360a4359360843593613177565b3461044e57606036600319011261044e576020611de8600435611ddb81610492565b6044359060243590613292565b604051908152f35b3461044e57606036600319011261044e5767ffffffffffffffff60243581811161044e57611e22903690600401611803565b9160443590811161044e57611e3b903690600401611803565b9060405193602085019480611e524684888a6132ce565b0395611e66601f1997888101845283610676565b6004359151902003611ef9575f94611e95611eb793611e8c87611ec3958a990190612905565b958101906132eb565b519360405193849160208301966337bfd2c960e21b88523391602485016133b3565b03908101835282610676565b5190305af4611ed0612f8d565b9015611ed857005b60405163b8fe37a760e01b8152908190611ef590600483016133d5565b0390fd5b604051630f0c8f4760e11b8152600490fd5b3461044e57602036600319011261044e57600435611f276136d1565b611f2f613793565b611f3881612bc2565b611f70576001815f80935501557f7c1af0646963afc3343245b103731965735a893347bfa0d58a5dc77a77ae691c5f80a26001606555005b634e487b7160e01b5f525f60045260245ffd5b6101a036600319011261044e5761012435611f9d816104ef565b61014435611faa816104ef565b6101643591611fb8836104ef565b610184359267ffffffffffffffff841161044e57611fdd610018943690600401611803565b9390926101043560e43560c43560a4356084356064356044356024356004356133e6565b3461044e575f36600319011261044e5760206040517342000000000000000000000000000000000000078152f35b3461044e575f36600319011261044e5760206040516001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000168152f35b3461044e5760e036600319011261044e5767ffffffffffffffff60043581811161044e576120a4903690600401610cbd565b60a43582811161044e576120bc903690600401611803565b60c49291923593841161044e576120da610018943690600401611803565b9390926084359060643590604435906024359061345e565b3461044e5761210036611a35565b909160ff5f5460081c161561044e576121369061086b9063ffffffff60c01b1963ffffffff60c01b83549260c01b169116179055565b60405161214281610598565b6009815260208101926820a1a927a9a996ab1960b91b8452640312e302e360dc1b602060405161217181610598565b60058152015260ff5f5460081c161561044e57610018936112b89251902061047f557f06c015bd22b4c69690933c1058878ebdfef31f9aaae40bbe86d8a09fe1b2972c610480556112ab614847565b3461044e57602036600319011261044e577f2d5b62420992e5a4afce0e77742636ca2608ef58289fd2e1baa5161ef6e7e41e602060043561220081610bfa565b6122086136d1565b612210613793565b151561086b80547fffffff00ffffffffffffffffffffffffffffffffffffffffffffffffffffffff60ff60e01b8460e01b169116179055604051908152a16001606555005b3461044e575f36600319011261044e576020604051468152f35b3461044e575f36600319011261044e57602063ffffffff61086b5460c01c16604051908152f35b3461044e57604036600319011261044e576004356024356122b682614bd0565b6001600160a01b0382165f526108736020526122e560405f20336001600160a01b03165f5260205260405f2090565b54918215612388575f61232c336123166122fe85613da4565b6001600160a01b03165f5261087360205260405f2090565b906001600160a01b03165f5260205260405f2090565b556123588361234961233d84613da4565b6001600160a01b031690565b61235285613da4565b9061491e565b60405192835233927f6c172ea51018fb2eb2118f3f8a507c4df71eb519b8c0052834dc3c920182fef490602090a4005b6040516336542bf760e21b8152600490fd5b6020808201906020835283518092526040830192602060408460051b8301019501935f915b8483106123cf5750505050505090565b90919293949584806123ed600193603f198682030187528a51611352565b98019301930191949392906123bf565b3461044e5761240b36611302565b9061241582613547565b915f5b81811061242d5760405180611448868261239a565b5f8061243a838587612f69565b9061244a60405180938193612f80565b0390305af4612457612f8d565b901561247d579060019161246b8287612f55565b526124768186612f55565b5001612418565b604481511061044e5780600461044e920151602480918301019101613590565b6101808060031936011261044e57610104356124b8816104ef565b61012435916124c6836104ef565b61014435926124d4846104ef565b6101643567ffffffffffffffff811161044e576124f5903690600401611803565b6124fd613793565b61086b549260ff8460e81c166107f257610bf0966125c2610f46926125b463ffffffff6125d09860c01c16996125586125358c6135ef565b61086b9063ffffffff60c01b1963ffffffff60c01b83549260c01b169116179055565b6125606106d9565b9a6004358c5260243560208d015260443560408d015260643560608d015260843560808d015260a43560a08d015260c43560c08d015260e43560e08d01526101008c01526101208b019063ffffffff169052565b63ffffffff16610140890152565b63ffffffff16610160870152565b90820152614527565b604090600319011261044e576004356125f181610492565b9060243561076081610492565b3461044e57602061263c6001600160a01b03612619366125d9565b91165f52610873835260405f20906001600160a01b03165f5260205260405f2090565b54604051908152f35b3461044e57602036600319011261044e57602060043561266481610492565b6001600160a01b038091165f52610c5c825260405f205416604051908152f35b3461044e575f36600319011261044e5760206001600160a01b0361086a5416604051908152f35b3461044e5760c036600319011261044e5760043560243567ffffffffffffffff60643560443560843583811161044e576126e9903690600401611803565b60a49491943591821161044e577f45e04bc8f121ba11466985789ca2822a91109f31bb8ac85504a37b7eaf873c2694612729612778933690600401611803565b929091612734613793565b61273d8a614bd0565b61276c898b898961274f36888861070f565b9261275b368b8b61070f565b946001600160a01b034692166143f5565b60405196879687612fdc565b0390a36001606555005b3461044e57612790366125d9565b906127996136d1565b6127a1613793565b6001600160a01b0380911691825f52610c5d6020526127d98160405f20906001600160a01b03166001600160a01b0319825416179055565b16907fcb84c2022106a6f2b6f805d446f32fbfd2a528474364fa755f37dac1c0c1b6c85f80a36001606555005b3461044e57602036600319011261044e576004355f52610872602052602060405f2054604051908152f35b3461044e575f36600319011261044e57602060405163ffffffff8152f35b91906101808382031261044e576128646106b8565b92803584526020810135602085015260408101356040850152606081013560608501526080810135608085015260a081013560a085015260c081013560c085015260e081013560e085015261010080820135908501526101206128c881830161050b565b908501526101406128da81830161050b565b90850152610160918282013567ffffffffffffffff811161044e576128ff9201610745565b90830152565b9060208282031261044e57813567ffffffffffffffff811161044e57610760920161284f565b3461044e57602036600319011261044e5760043567ffffffffffffffff811161044e57611de8610ec4602092369060040161284f565b3461044e575f36600319011261044e57602060ff61086b5460e01c166040519015158152f35b3461044e575f36600319011261044e5760206040516ec097ce7bc90715b34b9f10000000008152f35b3461044e57602036600319011261044e576107eb6004356129d081610492565b6129d86136d1565b6112b3613793565b3461044e57606036600319011261044e5760043567ffffffffffffffff811161044e57612a1190369060040161284f565b612a19613793565b60ff61086b5460e01c16612ac35761014081015163ffffffff4281169116101580612aa4575b612a925780612a50610bf092613604565b60c082015160208301519061016084015192612a6a610698565b948552602085015260408401526060830152608082015260243560a08201526044359061417f565b604051630c3a9b9d60e41b8152600490fd5b50612ab26040820151613da4565b6001600160a01b0316331415612a3f565b604051633d90fc5560e11b8152600490fd5b3461044e575f36600319011261044e576020610c5a546001600160a01b0360405191831c168152f35b6101608060031936011261044e5761010435612b19816104ef565b61012435612b26816104ef565b6101443567ffffffffffffffff811161044e57612b47903690600401611803565b63ffffffff94612b5a8642169586613138565b93612b63613793565b61086b549160ff8360e81c166107f257612b96612ba3966125b4610bf09a610f469660c01c16996125586125358c6135ef565b86019063ffffffff169052565b610180820152614527565b634e487b7160e01b5f52603260045260245ffd5b61086c908154811015612bfc576003915f52027f71cd7344f4eb2efc8e30291f6dbdb44d618ca368ea5425d217c1d604bf26b84d01905f90565b612bae565b3461044e57602036600319011261044e5760043561086c5481101561044e57612c2b604091612bc2565b506001815491015482519182526020820152f35b3461044e57612c4d366125d9565b90612c566136d1565b612c5e613793565b6001600160a01b0380911691825f52610c5c602052612c968160405f20906001600160a01b03166001600160a01b0319825416179055565b16907ff3dc137d2246f9b8abd0bb821e185ba01122c9b3ea3745ffca6208037674d6705f80a36001606555005b3461044e57602036600319011261044e576107eb600435612ce381610492565b612ceb6136d1565b6112b8613793565b91612cfc613793565b6080820191612d15610b9884516001600160a01b031690565b602081019182514603612e1c57612d3d612d4191836001612d3589612bc2565b500154613ac0565b1590565b612e0a578060607ff4ad92585b1bc117fbdd644990adf0827bc4c95baeae8a23322af807b6d0020e920193612d83612d7d865163ffffffff1690565b87613b52565b612dfd845194835193612de2612dd4612dc360408401998a51612daa8d5163ffffffff1690565b89516001600160a01b03169160a088019b8c5194613bc3565b925193519851995163ffffffff1690565b94516001600160a01b031690565b945163ffffffff9586604051978897169b1699339487612e9d565b0390a46104ae6001606555565b60405163582f497d60e11b8152600490fd5b604051633d23e4d160e11b8152600490fd5b9081518082526020808093019301915f5b828110612e4d575050505090565b835185529381019392810192600101612e3f565b9081518082526020808093019301915f5b828110612e80575050505090565b83516001600160a01b031685529381019392810192600101612e72565b9496959193612ebf60a095612edd93885260c0602089015260c0880190612e2e565b906001600160a01b0380951660408801528682036060880152612e61565b951515608085015216910152565b3561076081610492565b35610760816104ef565b903590601e198136030182121561044e570180359067ffffffffffffffff821161044e5760200191813603831361044e57565b634e487b7160e01b5f52602160045260245ffd5b60031115612f5057565b612f32565b8051821015612bfc5760209160051b010190565b90821015612bfc5761132d9160051b810190612eff565b908092918237015f815290565b3d15612fb7573d90612f9e826106f3565b91612fac6040519384610676565b82523d5f602084013e565b606090565b908060209392818452848401375f828201840152601f01601f1916010190565b9492909361300192610760979587526020870152608060408701526080860191612fbc565b926060818503910152612fbc565b91909160ff5f5460081c161561044e5761305990610c5a624c4b4063ffffffff1982541617905561086b9063ffffffff60c01b1963ffffffff60c01b83549260c01b169116179055565b60405161306581610598565b6009815260208101926820a1a927a9a996ab1960b91b8452640312e302e360dc1b602060405161309481610598565b60058152015260ff5f5460081c161561044e576130e3936112b89251902061047f557f06c015bd22b4c69690933c1058878ebdfef31f9aaae40bbe86d8a09fe1b2972c610480556112ab614847565b6104ae610c5a77deaddeaddeaddeaddeaddeaddeaddeaddead00000000000077ffffffffffffffffffffffffffffffffffffffff0000000019825416179055565b634e487b7160e01b5f52601160045260245ffd5b91909163ffffffff8080941691160191821161315057565b613124565b96949290916104ae9b9a999896949261317563ffffffff42169889613138565b985b9593919b999897969492909b61318b613793565b61086b549660ff8860e81c166107f2578760c01c63ffffffff166131ae906135ef565b6131d59061086b9063ffffffff60c01b1963ffffffff60c01b83549260c01b169116179055565b6131dd6106d9565b9d6001600160a01b038f921682526001600160a01b031690602001526001600160a01b031660408d01526001600160a01b031660608c015260808b015260a08a015260c08901526001600160a01b031660e088015260c01c63ffffffff16610100870152610120860190613256919063ffffffff169052565b63ffffffff1661014085015263ffffffff1661016084015236906132799261070f565b61018082015261328890614527565b6104ae6001606555565b916040519160208301936bffffffffffffffffffffffff199060601b16845260348301526054820152605481526132c881610606565b51902090565b9392916020916132e691604087526040870191612fbc565b930152565b9081602091031261044e57604051906020820182811067ffffffffffffffff8211176105b45760405235815290565b6107609161018090825181526020830151602082015260408301516040820152606083015160608201526080830151608082015260a083015160a082015260c083015160c082015260e083015160e0820152610100808401519082015261338f610120808501519083019063ffffffff169052565b6101408381015163ffffffff16908201528161016080940151938201520190611352565b6133cb6040929594939560608352606083019061331a565b9460208201520152565b906020610760928181520190611352565b9c9a99989796959493929190966133fb613793565b60ff61086b5460e81c166107f257613414908e33613292565b96604051809e613423826105b9565b81526020015260408d015260608c015260808b015260a08a015260c089015260e088015261010087015263ffffffff16610120860152613256565b97929095939196949761346f613793565b60ff61086b5460e01c16612ac35761348a6101408201612ef5565b63ffffffff8042169116101580613528575b612a9257613511613523966135096132889b6134bb610ec4368761284f565b9a6134c4610698565b9b6134cf368861284f565b8d5260208d01528660408d01528760608d01526134ed368b8461070f565b60808d015260a08c01526135018535613da4565b98369161070f565b95369161070f565b9461010060e0830135920135906143f5565b61417f565b506135366040820135613da4565b6001600160a01b031633141561349c565b90613551826108a4565b61355e6040519182610676565b828152809261356f601f19916108a4565b01905f5b82811061357f57505050565b806060602080938501015201613573565b60208183031261044e5780519067ffffffffffffffff821161044e570181601f8201121561044e5780516135c3816106f3565b926135d16040519485610676565b8184526020828401011161044e576107609160208085019101611331565b63ffffffff8091169081146131505760010190565b6040516132c881613621602082019460408652606083019061331a565b46604083015203601f198101835282610676565b919091613640613793565b60ff61086b5460e01c16612ac35761014081015163ffffffff42811691161015806136b2575b612a92576132889261367782613604565b60c083015160208401519061016085015192613691610698565b958652602086015260408501526060840152608083015260a082015261417f565b506136c06040820151613da4565b6001600160a01b0316331415613666565b73420000000000000000000000000000000000000780330361378157602060049160405192838092636e296e4560e01b82525afa90811561377c575f9161374d575b506001600160a01b0361373261233d610869546001600160a01b031690565b91160361373b57565b6040516336a816d960e01b8152600490fd5b61376f915060203d602011613775575b6137678183610676565b810190614966565b5f613713565b503d61375d565b6137b1565b60405163253a6fc960e11b8152600490fd5b60026065541461044e576002606555565b9190820391821161315057565b6040513d5f823e3d90fd5b926107609695929491946101409585525f60208601526040850152606084015263ffffffff809116608084015260a08301525f60c083015260e08201525f610100820152816101208201520190611352565b9193949690959661384f612d3d6138488861383b896001600160a01b03165f5261086d60205260405f2090565b905f5260205260405f2090565b5460ff1690565b613a3b5760070b906706f05b59d3b200006138698361497b565b1015613a29576ec097ce7bc90715b34b9f10000000008411613a175763ffffffff93613897858a16426137a4565b857f00000000000000000000000000000000000000000000000000000000000000001610613a055761086b5460c01c63ffffffff16986138d96125358b6135ef565b6001600160a01b039586807f000000000000000000000000000000000000000000000000000000000000000016981692888414806139fc575b156139c0578034036139ae57883b1561044e575f6004996040519a8b8092630d0e30db60e41b825234905af198891561377c5761397d613990978a927f32ed1a409ef04c7b0227189c3a103dc5ac10e775a15b785dcc510201f7c25ad39c613995575b505b836149c9565b92604051998a99169d169b1693876137bc565b0390a4565b806139a26139a8926105d6565b80610444565b5f613975565b604051636452a35d60e01b8152600490fd5b7f32ed1a409ef04c7b0227189c3a103dc5ac10e775a15b785dcc510201f7c25ad398508761397d613990976139f78430338a61498a565b613977565b50341515613912565b60405163f722177f60e01b8152600490fd5b60405163622db5a960e11b8152600490fd5b60405163284f109760e21b8152600490fd5b604051632a58c4f360e01b8152600490fd5b6001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000811691168114613a84575b50565b47613a8c5750565b4790803b1561044e575f90600460405180948193630d0e30db60e41b83525af1801561377c5715613a81576104ae906105d6565b6107609291604051613b4981613b3b602082019460208652805160408401526020810151606084015260a0613b05604083015160c06080870152610100860190612e2e565b606083015163ffffffff168583015260808301516001600160a01b031660c0860152910151838203603f190160e0850152612e61565b03601f198101835282610676565b519020916149ff565b613b5d600291612bc2565b500162ffffff8260081c16805f5281602052600160ff60405f205494161b8080941614613b95575f5260205260405f20908154179055565b60405163954476d960e01b8152600490fd5b9081602091031261044e575190565b9190820180921161315057565b91959495939092935f9681519081815103613d925781613c42575b50505082613bed575b50505050565b6001600160a01b0381613c217ffa7fa7cf6d7dde5f9be65a67e6a1a747e7aa864dcd2d793353c722d80fbbb3579386614ac2565b6040805195865233602087015291169463ffffffff1693a45f808080613be7565b604080516370a0823160e01b81523060048083019190915291906020816024816001600160a01b038b165afa90811561377c575f91613d73575b505f805b868110613c91575050505050613bde565b613c9b8189612f55565b51613ca9575b600101613c80565b90613cbf90613cb8838a612f55565b5190613bb6565b90828211613d6357613cf9612d3d613ce7613cda848a612f55565b516001600160a01b031690565b613cf1848c612f55565b51908c614a50565b15613ca1579c5087613d59613d518f613d3c613cda613d35613d1b848f612f55565b51966001600160a01b03165f5261087360205260405f2090565b928b612f55565b6001600160a01b03165f5260205260405f2090565b918254613bb6565b905560019c613ca1565b50505051632ddaa83160e11b8152fd5b613d8c915060203d60201161118b5761117c8183610676565b5f613c7c565b6040516319a5316760e31b8152600490fd5b6001600160a01b0390613db681614bd0565b1690565b91612d3d90613e3392845160408096015191865191613dd8836105ea565b8252613b49613df36020840192468452898501958652612bc2565b5054938851928391613e186020840196602088525160608d86015260a085019061331a565b9151606084015251608083015203601f198101835282610676565b613e3a5750565b5163582f497d60e11b8152600490fd5b613e5382612f46565b52565b9a989693919c9b9997959492909c6101e08c019d8c5260208c015260408b015260608a0152608089015263ffffffff80921660a08901521660c087015260e08601526101008501526101208401526101408301528051610160830152602081015161018083015260408101516101a08301526060015190613ed682612f46565b6101c00152565b9061076094936080936001600160a01b03809316845260208401521660408201528160608201520190611352565b905f82516101208101613f22815163ffffffff1690565b63ffffffff4291161061416d576020850151906002613f4a835f5261087260205260405f2090565b541461415b57613f6486925f5261087260205260405f2090565b6002905560608301519060808401519160a08501519260c0860151918560a0810151938860e0810151956101008201519751613fa39063ffffffff1690565b61014083015163ffffffff166040840151918451936020860151956101600151613fcc906143e0565b966060890151986080019e8f51613fe2906143e0565b906040015190613ff06106e6565b9a8b5260208b015260408a0152600260608a01526040519d8e9b6140149b8d613e56565b037f44b559f101f8fbcc8a0ea43fa91a05a729a5ea6e14a7c75aa750374690137208905f94a4608082015161404890613da4565b906040860151956060015161405c90613da4565b926080015161406a90613da4565b6001600160a01b03919082167f00000000000000000000000000000000000000000000000000000000000000008316036141465784614133575b6140b087838616614beb565b51928351151580614129575b6140ca575b50505050509050565b1690813b1561412557836140f8959660405196879586948593633a5be8cb60e01b8552339160048601613edd565b03925af1801561377c57614112575b8080808085946140c1565b806139a261411f926105d6565b5f614107565b8380fd5b50803b15156140bc565b61414187303385871661498a565b6140a4565b5f9450614156878585851661491e565b6140b0565b604051630479306360e51b8152600490fd5b60405163d642b7d960e01b8152600490fd5b8051916101208301614195815163ffffffff1690565b63ffffffff4291161061416d57602083015160016141bc825f5261087260205260405f2090565b54036143d9576001905b60026141db825f5261087260205260405f2090565b541461415b576141f76141fd915f5261087260205260405f2090565b60029055565b7f44b559f101f8fbcc8a0ea43fa91a05a729a5ea6e14a7c75aa75037469013720860608601516080870151906142ca8760a08a0151958a60c08101519760a08401519860e08301519961425a6101008501519c5163ffffffff1690565b61014085015163ffffffff16916040860151938651956142be61428661016060208b01519a01516143e0565b9960608c01519b604061429c60808301516143e0565b9101519060206142aa6106e6565b9e8f528e015260408d015260608c01613e4a565b6040519c8d9c8d613e56565b0390a46142da6080830151613da4565b9160408201519160806142fc816142f46060850151613da4565b940151613da4565b6001600160a01b03929083167f00000000000000000000000000000000000000000000000000000000000000008416036143c65761433e853033868a1661498a565b61434a85848616614beb565b01519182511515806143bc575b614363575b5050505050565b16803b1561044e57614391935f809460405196879586948593633a5be8cb60e01b8552339160048601613edd565b03925af1801561377c576143a9575b8080808061435c565b806139a26143b6926105d6565b5f6143a0565b50803b1515614357565b6143d4858533868a1661498a565b61434a565b5f906141c6565b805190816143ee5750505f90565b6020012090565b93926042936104ae979660208151910120906040519260208401947f8d1994e2bbbd77564cdca06dd819e7ee2a5efa06c80dcb59a4a7b6e39edc538f86526040850152856060850152608084015260a083015260c082015260c0815261445a8161063e565b5190209061047f549061048054906040519160208301937fc2f8787176b8ac6bf7215b4adcc1e069bf4ab82d9ab1df05a57a91d425935b6e8552604084015260608301526080820152608081526144b08161065a565b519020906040519161190160f01b8352600283015260228201522090614e08565b96926107609a9996949198959261014099895260208901526040880152606087015263ffffffff928380921660808801521660a08601521660c084015260e0830152610100820152816101208201520190611352565b6145318151614bd0565b6040908181019061455d6145458351613da4565b6001600160a01b03165f5261086d60205260405f2090565b9261457a612d3d61384860c085019687515f5260205260405f2090565b6148375761012082019261459e614595855163ffffffff1690565b63ffffffff1690565b8042109081156147fe575b506147ed576101408301926145c2845163ffffffff1690565b9163ffffffff92836145f6817f00000000000000000000000000000000000000000000000000000000000000001642613bb6565b9116116147dc5761016082015163ffffffff169280841680614798575b50508051936001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000168095148061478f575b15614729576080830151340361471957843b1561044e575f600495825196878092630d0e30db60e41b825234905af191821561377c577f32ed1a409ef04c7b0227189c3a103dc5ac10e775a15b785dcc510201f7c25ad39561399093614706575b505b519260608101519460808201519060a08301519a51986146e66146db6101008601519c5163ffffffff1690565b915163ffffffff1690565b9084519c60208601519461018060e088015197015197519a8b9a8b6144d1565b806139a2614713926105d6565b5f6146ac565b51636452a35d60e01b8152600490fd5b919293503461477e577f32ed1a409ef04c7b0227189c3a103dc5ac10e775a15b785dcc510201f7c25ad39392918161477961476a61233d6139909551613da4565b6080860151903090339061498a565b6146ae565b8151636452a35d60e01b8152600490fd5b5034151561464b565b6301e1338010156147c7575b5060e0820151156147b6575f80614613565b835163495d907f60e01b8152600490fd5b926147d59193421690613138565b915f6147a4565b835163582e388960e01b8152600490fd5b815163f722177f60e01b8152600490fd5b6148099150426137a4565b63ffffffff7f000000000000000000000000000000000000000000000000000000000000000016105f6145a9565b51632a58c4f360e01b8152600490fd5b60ff5f5460081c161561044e57565b60ff5f5460081c161561044e576001606555565b6001600160a01b031680156148b257610869816001600160a01b03198254161790557fa9e8c42c9e7fca7f62755189a16b2f5314d43d8fb24e91ba54e6d65f9314e8495f80a2565b60405163ba97b39d60e01b8152600490fd5b6001600160a01b0316801561490c5761086a816001600160a01b03198254161790557fa73e8909f8616742d7fe701153d82666f7b7cd480552e23ebb05d358c22fd04e5f80a2565b604051635b03092b60e11b8152600490fd5b60405163a9059cbb60e01b60208201526001600160a01b03909216602483015260448201929092526104ae9161496182606481015b03601f198101845283610676565b614ee6565b9081602091031261044e575161076081610492565b5f81126149855790565b5f0390565b90926104ae93604051936323b872dd60e01b60208601526001600160a01b0380921660248601521660448401526064830152606482526149618261065a565b90670de0b6b3a7640000915f82840392128383128116908484139015161761315057818102918183041490151715613150570490565b929091905f915b8451831015614a4857614a198386612f55565b519081811015614a37575f52602052600160405f205b920191614a06565b905f52602052600160405f20614a2f565b915092501490565b60405163a9059cbb60e01b60208281019182526001600160a01b039094166024830152604482019490945290925f91614a8c8160648101613b3b565b519082855af1903d5f519083614aa3575b50505090565b91925090614ab857503b15155b5f8080614a9d565b6001915014614ab0565b907f0000000000000000000000000000000000000000000000000000000000000000906001600160a01b03808316818316149081614ba5575b5015614b9a575081614b0c916152df565b61086a546001600160a01b0316610c5a5463ffffffff1673bd80b06d3dbd0801132c6689429ac09ca6d27f82803b1561044e5760405163262cc5ab60e11b81526001600160a01b039093166004840152602483019390935263ffffffff166044820152905f908290818381606481015b03925af1801561377c57614b8d5750565b806139a26104ae926105d6565b90506104ae91614f76565b90507f000000000000000000000000000000000000000000000000000000000000000016155f614afb565b60a01c614bd957565b6040516379ec0ed760e11b8152600490fd5b6001600160a01b0390811690813b15614c2b57906104ae92917f00000000000000000000000000000000000000000000000000000000000000001661491e565b7f000000000000000000000000000000000000000000000000000000000000000016803b1561044e575f8091602460405180948193632e1a7d4d60e01b83528860048401525af1801561377c57614c9d575b5081471061044e575f80809381935af1614c95612f8d565b501561044e57565b614ca6906105d6565b5f614c7d565b614cb581614dc5565b6001600160a01b0381167fbc7cd75a20ee27fd9adebab32041f755214dbc6bffa90cc0225b39da2e5c2d3b5f80a2815115801590614d6d575b614cf6575050565b5f80613a81937f206661696c65640000000000000000000000000000000000000000000000000060408051614d2a816105ea565b602781527f416464726573733a206c6f772d6c6576656c2064656c65676174652063616c6c60208201520152602081519101845af4614d67612f8d565b91615686565b505f614cee565b614d7d81614dc5565b6001600160a01b0381167fbc7cd75a20ee27fd9adebab32041f755214dbc6bffa90cc0225b39da2e5c2d3b5f80a2815115801590614dbd57614cf6575050565b506001614cee565b803b1561044e576001600160a01b037f360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc91166001600160a01b0319825416179055565b614e128383615635565b6005819592951015612f5057159384614ed0575b508315614e4a575b50505015614e3857565b60405163938a182160e01b8152600490fd5b5f929350908291604051614e8281613b3b6020820194630b135d3f60e11b998a87526024840152604060448401526064830190611352565b51915afa90614e8f612f8d565b82614ec2575b82614ea5575b50505f8080614e2e565b614eba91925060208082518301019101613ba7565b145f80614e9b565b915060208251101591614e95565b6001600160a01b0383811691161493505f614e26565b905f806001600160a01b03614f3d9416927f5361666545524332303a206c6f772d6c6576656c2063616c6c206661696c65646020604051614f2681610598565b818152015260208151910182855af1614d67612f8d565b8051908115918215614f53575b50501561044e57565b819250906020918101031261044e5760200151614f6f81610bfa565b5f80614f4a565b906001600160a01b0390818116907f0000000000000000000000000000000000000000000000000000000000000000831682036150895750803b1561044e57604051632e1a7d4d60e01b815260048101849052905f908290602490829084905af1801561377c57615076575b50610c5a5491614ffb61086a546001600160a01b031690565b73420000000000000000000000000000000000001090813b1561044e57604051631474f2a960e31b81526001600160a01b03602087901c90951685166004820152931660248401526044830182905263ffffffff909316606483015260a060848301525f60a483018190529192839182908160c48101614b7c565b806139a2615083926105d6565b5f614fe2565b91807f0000000000000000000000000000000000000000000000000000000000000000161515806152b4575b156150d9575050506104ae906150d461086a546001600160a01b031690565b615449565b806151066150f9856001600160a01b03165f52610c5c60205260405f2090565b546001600160a01b031690565b16615290577342000000000000000000000000000000000000105b169061514561233d6150f9856001600160a01b03165f52610c5d60205260405f2090565b1561520a5783826151559261539c565b6151746150f9836001600160a01b03165f52610c5d60205260405f2090565b9061518861086a546001600160a01b031690565b91615199610c5a5463ffffffff1690565b823b1561044e5760405163540abf7360e01b81526001600160a01b0395861660048201529185166024830152929093166044840152606483019390935263ffffffff16608482015260c060a48201525f60c482018190529091829060e490829084905af1801561377c57614b8d5750565b509161521f61086a546001600160a01b031690565b92615230610c5a5463ffffffff1690565b93813b1561044e57604051631474f2a960e31b81526001600160a01b03948516600482015293166024840152604483019190915263ffffffff909216606482015260a060848201525f60a482018190529091829081838160c48101614b7c565b6152af6150f9846001600160a01b03165f52610c5c60205260405f2090565b615121565b50807f00000000000000000000000000000000000000000000000000000000000000001682146150b5565b604051636eb1769f60e11b815230600482015273bd80b06d3dbd0801132c6689429ac09ca6d27f82602482015290916020826044816001600160a01b0387165afa91821561377c575f9261537b575b5081018091116131505760405163095ea7b360e01b602082015273bd80b06d3dbd0801132c6689429ac09ca6d27f82602482015260448101919091526104ae916149618260648101614953565b61539591925060203d60201161118b5761117c8183610676565b905f61532e565b604051636eb1769f60e11b81523060048201526001600160a01b03831660248201529192602083806044810103816001600160a01b0386165afa92831561377c575f93615428575b5082018092116131505760405163095ea7b360e01b60208201526001600160a01b03909316602484015260448301919091526104ae91906149618260648101614953565b61544291935060203d60201161118b5761117c8183610676565b915f6153e4565b6001600160a01b03809116917f000000000000000000000000000000000000000000000000000000000000000090827f0000000000000000000000000000000000000000000000000000000000000000166154a582828561539c565b604090604051916332dd704760e21b83526020936004958585600481875afa94851561377c57869189915f97615616575b501697604051958680926352b7631960e11b8252816155088d600483019190916001600160a01b036020820193169052565b0392165afa93841561377c575f946155f7575b5092947f000000000000000000000000000000000000000000000000000000000000000093805b61555157505050505050505050565b6155a290878111156155f15787905b84516337e9a82760e11b815284810183815263ffffffff89166020820152604081018d90526001600160a01b038c166060820152909389918591829160800190565b03815f8a5af192831561377c576155be936155c4575b506137a4565b80615542565b6155e390893d8b116155ea575b6155db8183610676565b810190615666565b505f6155b8565b503d6155d1565b80615560565b61560f919450853d871161118b5761117c8183610676565b925f61551b565b61562e919750833d8511613775576137678183610676565b955f6154d6565b9060418151145f1461565d5761132d91602082015190606060408401519301515f1a906156af565b50505f90600290565b9081602091031261044e575167ffffffffffffffff8116810361044e5790565b90156156a057815115615697575090565b3b1561044e5790565b50805190811561044e57602001fd5b7f7fffffffffffffffffffffffffffffff5d576e7357a4501ddfe92f46681b20a0841161571f576020935f9360ff60809460405194855216868401526040830152606082015282805260015afa1561377c575f516001600160a01b0381161561571757905f90565b505f90600190565b505050505f9060039056fea264697066735822122081de8cafbdfc055aa138e7706e83912b790d1c719a65b618b872483c2da3859c64736f6c63430008170033",
+ "deployedBytecode": "0x6080604052600436101561001a575b3615610018575f80fd5b005b5f3560e01c8063079bd2c71461043f5780630c5d5f731461043a5780630eaac9f0146104355780631186ec331461043057806311eac8551461042b57806315348e44146103b357806317fcb39b146104265780631b3d5559146104215780631fab657c1461041c578063272751c71461041757806329cb924d146104125780632e3781151461040d5780632e63e59a1461040857806333a84ff0146104035780633659cfe6146103fe578063431023b8146103f9578063437b9116146103f4578063490e49ef146103ef578063493a4f84146103ea5780634f1ef286146103e55780635249fef1146103e05780635285e058146103db57806352d1902d146103d6578063541f4f14146103d1578063577f51f8146103cc57806357f6dcb8146103c75780636068d6cb146103c2578063647c576c146103bd578063670fa8ac146103b85780636bbbcd2e146103b35780636e400983146103ae578063738b62e5146103a9578063766e0703146103a45780637aef642c1461039f5780637b9392321461039a5780637ef413e11461039557806382e2c43f146103905780638a7860ce1461038b5780638b15788e14610386578063927ede2d146103815780639748cf7c1461037c57806397943aa914610377578063979f2bc21461037257806399cc29681461036d5780639a8a059214610368578063a1244c6714610363578063a18a096e1461035e578063ac9650d814610359578063ad5425c614610354578063adb5a6a614610309578063b27a43001461034f578063b370b7f51461034a578063babb6aac14610345578063bf10268d14610340578063c35c83fc1461033b578063ceb4c98714610336578063d7e1583a14610331578063dda521131461032c578063ddd224f114610327578063de7eba7814610322578063deff4b241461031d578063e322921114610318578063ea86bd4614610313578063ee2a53f81461030e578063f79f29ed14610309578063fbbba9ac146103045763fc8a584f0361000e57612cc3565b612c3f565b6125fe565b612c01565b612afe565b612ad5565b6129e0565b6129b0565b612987565b612961565b61292b565b612831565b612806565b612782565b6126ab565b612684565b612645565b61249d565b6123fd565b612296565b61226f565b612255565b6121c0565b6120f2565b612072565b61202f565b612001565b611f83565b611f0b565b611df0565b611db9565b611d11565b611c71565b611c4d565b611bb8565b611b78565b610847565b611b3e565b611a67565b611a0f565b6119cf565b611831565b61176e565b611704565b6116dd565b61168f565b611561565b6114da565b6114bc565b6113ef565b611192565b611060565b611026565b610e2c565b610ccc565b610ca3565b610c04565b610af8565b6109ef565b610861565b610804565b610763565b610516565b6104b0565b610452565b5f91031261044e57565b5f80fd5b3461044e575f36600319011261044e57602060405163ffffffff7f0000000000000000000000000000000000000000000000000000000000000000168152f35b6001600160a01b0381160361044e57565b35906104ae82610492565b565b3461044e57602036600319011261044e5760206004356104cf81610492565b6001600160a01b038091165f52610c5d825260405f205416604051908152f35b63ffffffff81160361044e57565b61014435906104ae826104ef565b35906104ae826104ef565b3461044e57602036600319011261044e5763ffffffff600435610538816104ef565b6105406136d1565b610548613793565b16610c5a8163ffffffff198254161790557fe486a5c4bd7b36eabbfe274c99b39130277417be8d2209b4dae04c4fba64ee3a5f80a26001606555005b634e487b7160e01b5f52604160045260245ffd5b6040810190811067ffffffffffffffff8211176105b457604052565b610584565b6101a0810190811067ffffffffffffffff8211176105b457604052565b67ffffffffffffffff81116105b457604052565b6060810190811067ffffffffffffffff8211176105b457604052565b6080810190811067ffffffffffffffff8211176105b457604052565b6020810190811067ffffffffffffffff8211176105b457604052565b60e0810190811067ffffffffffffffff8211176105b457604052565b60a0810190811067ffffffffffffffff8211176105b457604052565b90601f8019910116810190811067ffffffffffffffff8211176105b457604052565b6040519060c0820182811067ffffffffffffffff8211176105b457604052565b60405190610180820182811067ffffffffffffffff8211176105b457604052565b604051906104ae826105b9565b604051906104ae82610606565b67ffffffffffffffff81116105b457601f01601f191660200190565b92919261071b826106f3565b916107296040519384610676565b82948184528183011161044e578281602093845f960137010152565b9080601f8301121561044e578160206107609335910161070f565b90565b61010036600319011261044e5760043561077c81610492565b60243561078881610492565b6084358060070b810361044e5760a435906107a2826104ef565b60c43567ffffffffffffffff811161044e576107c2903690600401610745565b926107cb613793565b60ff61086b5460e81c166107f2576107eb9460643591604435913361380e565b6001606555005b604051630b4cba3160e31b8152600490fd5b3461044e575f36600319011261044e5760206040516001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000168152f35b3461044e575f36600319011261044e5760206040515f8152f35b3461044e575f36600319011261044e5760206040516001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000168152f35b67ffffffffffffffff81116105b45760051b60200190565b9080601f8301121561044e5760209082356108d6816108a4565b936108e46040519586610676565b81855260208086019260051b82010192831161044e57602001905b82821061090d575050505090565b813581529083019083016108ff565b9080601f8301121561044e576020908235610936816108a4565b936109446040519586610676565b81855260208086019260051b82010192831161044e57602001905b82821061096d575050505090565b838091833561097b81610492565b81520191019061095f565b9291610991826108a4565b9161099f6040519384610676565b829481845260208094019160051b810192831161044e57905b8282106109c55750505050565b813581529083019083016109b8565b9080601f8301121561044e5781602061076093359101610986565b60031960603682011261044e57600435610a08816104ef565b60243567ffffffffffffffff9283821161044e5760c090823603011261044e57610a30610698565b908060040135825260248101356020830152604481013584811161044e57610a5e90600436918401016108bc565b6040830152610a6f6064820161050b565b6060830152610a80608482016104a3565b608083015260a48101359084821161044e576004610aa1923692010161091c565b60a082015260443592831161044e57610ac16100189336906004016109d4565b91612cf3565b9181601f8401121561044e5782359167ffffffffffffffff831161044e576020808501948460051b01011161044e57565b3461044e5760031960603682011261044e5760043567ffffffffffffffff80821161044e5760608236039384011261044e5760243590610b37826104ef565b60443590811161044e57610b4f903690600401610ac7565b919093610b5a613793565b600484013590610182190181121561044e57610bf094610beb93610b87610be4936004369189010161284f565b95610b9d610b986080890151613da4565b613a4d565b610ba687613604565b9060446020890151916101608a015193610bbe610698565b9a8b5260208b015201356040890152606088015260808701525f60a08701523691610986565b9083613dba565b613f0b565b6100186001606555565b8015150361044e57565b3461044e57606036600319011261044e57600435610c2181610492565b602435907f0a21fdd43d0ad0c62689ee7230a47309a050755bcc52eba00310add65297692a60206001600160a01b0360443593610c5d85610bfa565b610c656136d1565b610c6d613793565b1692835f5261086d825260405f20855f52825260405f209015159060ff1981541660ff8316179055604051908152a36001606555005b3461044e575f36600319011261044e576020604051428152f35b908161018091031261044e5790565b3461044e57604036600319011261044e5760043567ffffffffffffffff811161044e57610cfd903690600401610cbd565b610d0681612eeb565b6001600160a01b031690610d1c60208201612eeb565b6001600160a01b031691610d3260408301612eeb565b6001600160a01b0316610d4760608401612eeb565b6001600160a01b031692610d5d60808201612eeb565b6001600160a01b031690610100610d75818301612ef5565b9061012090610d85848301612ef5565b9261014094858101610d9690612ef5565b966101609a8b8301610da89084612eff565b9a909b610db36106b8565b9e8f91825260208201526040015260608d015260808c015260a081013560a08c015260c081013560c08c015260e0013560e08b015263ffffffff1690890152870190610e04919063ffffffff169052565b63ffffffff909116908501523690610e1b9261070f565b908201523360243561001892613635565b3461044e57602036600319011261044e576004803567ffffffffffffffff811161044e57610e5d9036908301610cbd565b610e65613793565b60ff61086b5460e01c166110165763ffffffff80421692610140830193610e9e81610e8f87612ef5565b63ffffffff9182169116101590565b61100657610120840192610eb184612ef5565b1610610ff757610ec9610ec4368561284f565b613604565b90610edd825f5261087260205260405f2090565b54610fe95750610f2c7f3cee3e290f36226751cd0b3321b213890fe9c768e922f267fa6111836ce05c3292610f27610f21610f32945f5261087260205260405f2090565b60019055565b612ef5565b93612ef5565b610f52610f4d610f46610160860186612eff565b369161070f565b6143e0565b90610fdc6040519283926101008701359760e08801359760208101359281359260408301359260c08101359060a081013590606060808201359101358b9693909a999895919261012098959361014089019c895260208901526040880152606087015263ffffffff80921660808701521660a085015260c084015260e08301526101008201520152565b0390a36100186001606555565b604051624be79160e21b8152fd5b60405163d642b7d960e01b8152fd5b50604051630277ae7b60e21b8152fd5b50604051633d90fc5560e11b8152fd5b3461044e575f36600319011261044e5760206040517f9c6dfd61d811b9950a4f2b9adf46357b717c816d22c420d0bde8f2360148f7cd8152f35b3461044e57602036600319011261044e5760043561107d81610492565b6001600160a01b03807f00000000000000000000000000000000000000000000000000000000000000001680301461044e577f360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc90828254160361044e576110e26136d1565b604051916110ef83610622565b5f83527f4910fdfa16fed3260ed0e7147f7cc6da11a60208b5b9406d12a635614ffd91435460ff16156111285750505061001890614dc5565b6020600491604051928380926352d1902d60e01b825288165afa5f9181611161575b50611153575f80fd5b0361044e5761001891614cac565b61118491925060203d60201161118b575b61117c8183610676565b810190613ba7565b905f61114a565b503d611172565b3461044e57608036600319011261044e576004356111af816104ef565b602435906111bc82610492565b6044356111c881610492565b606435916111d583610492565b60ff5f5460081c161561044e5761121c90610c5a624c4b4063ffffffff1982541617905561086b9063ffffffff60c01b1963ffffffff60c01b83549260c01b169116179055565b6040519061122982610598565b6009825260208201916820a1a927a9a996ab1960b91b8352640312e302e360dc1b602060405161125881610598565b60058152015260ff5f5460081c161561044e57610018946112bd936112b89251902061047f557f06c015bd22b4c69690933c1058878ebdfef31f9aaae40bbe86d8a09fe1b2972c610480556112ab614847565b6112b3614856565b61486a565b6148c4565b610c5a9077ffffffffffffffffffffffffffffffffffffffff000000001977ffffffffffffffffffffffffffffffffffffffff0000000083549260201b169116179055565b602060031982011261044e576004359067ffffffffffffffff821161044e5761132d91600401610ac7565b9091565b5f5b8381106113425750505f910152565b8181015183820152602001611333565b9060209161136b81518092818552858086019101611331565b601f01601f1916010190565b6020808201908083528351809252604092604081018260408560051b8401019601945f925b8584106113ad575050505050505090565b9091929394959685806113de600193603f1986820301885286838d5180511515845201519181858201520190611352565b99019401940192959493919061139c565b3461044e576113fd36611302565b611406816108a4565b9160406114166040519485610676565b828452601f19611425846108a4565b015f5b8181106114995750505f5b83811061144c57604051806114488782611377565b0390f35b8061149361145c60019388612f55565b515f8061146a858a8a612f69565b90611479895180938193612f80565b0390305af490611487612f8d565b60208201529015159052565b01611433565b60209083516114a781610598565b5f815282606081830152828901015201611428565b3461044e575f36600319011261044e5760206040516301e133808152f35b3461044e57604036600319011261044e576024356004356114f96136d1565b611501613793565b61086c8054680100000000000000008110156105b45763ffffffff916001820190558361152d82612bc2565b5084600182015555167fc86ba04c55bc5eb2f2876b91c438849a296dbec7b08751c3074d92e04f0a77af5f80a46001606555005b604036600319011261044e5760043561157981610492565b60243567ffffffffffffffff811161044e57611599903690600401610745565b6001600160a01b03807f0000000000000000000000000000000000000000000000000000000000000000169081301461044e577f360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc91818354160361044e576115ff6136d1565b7f4910fdfa16fed3260ed0e7147f7cc6da11a60208b5b9406d12a635614ffd91435460ff16156116355750505061001890614dc5565b6020600491604051928380926352d1902d60e01b825288165afa5f918161166e575b50611660575f80fd5b0361044e5761001891614d74565b61168891925060203d60201161118b5761117c8183610676565b905f611657565b3461044e57604036600319011261044e576001600160a01b036004356116b481610492565b165f5261086d60205260405f206024355f52602052602060ff60405f2054166040519015158152f35b3461044e575f36600319011261044e5760206001600160a01b036108695416604051908152f35b3461044e575f36600319011261044e576001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016300361044e5760206040517f360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc8152f35b61012036600319011261044e5760043561178781610492565b6024359061179482610492565b604435916117a183610492565b60a4358060070b810361044e5760c435916117bb836104ef565b60e43567ffffffffffffffff811161044e576117db903690600401610745565b936117e4613793565b60ff61086b5460e81c166107f2576107eb95608435926064359261380e565b9181601f8401121561044e5782359167ffffffffffffffff831161044e576020838186019501011161044e57565b3461044e5760c036600319011261044e5760043561184e81610492565b6024356044359160643561186181610492565b67ffffffffffffffff9160843583811161044e57611883903690600401611803565b60a49491943591821161044e577f45e04bc8f121ba11466985789ca2822a91109f31bb8ac85504a37b7eaf873c26946118c36119ca933690600401611803565b9290916001600160a01b038097168a6119be6118e036868661070f565b60428d6118ee368b8b61070f565b92602081519101209460409586519160208301937f9c6dfd61d811b9950a4f2b9adf46357b717c816d22c420d0bde8f2360148f7cd85528884015246606084015260808301528760a083015260c082015260c0815261194c8161063e565b51902061047f546104805486519060208201927fc2f8787176b8ac6bf7215b4adcc1e069bf4ab82d9ab1df05a57a91d425935b6e84528883015260608201524660808201526080815261199e8161065a565b5190209085519161190160f01b835260028301526022820152208a614e08565b51978897169a87612fdc565b0390a3005b3461044e575f36600319011261044e57602060405163ffffffff7f0000000000000000000000000000000000000000000000000000000000000000168152f35b3461044e575f36600319011261044e57602060ff61086b5460e81c166040519015158152f35b606090600319011261044e57600435611a4d816104ef565b90602435611a5a81610492565b9060443561076081610492565b3461044e57611a7536611a35565b5f54600881901c60ff1615939290849081611b30575b8115611b10575b501561044e57611ab69284611aad600160ff195f5416175f55565b611af95761300f565b611abc57005b611aca61ff00195f54165f55565b604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb384740249890602090a1005b611b0b61010061ff00195f5416175f55565b61300f565b303b15915081611b22575b505f611a92565b6001915060ff16145f611b1b565b600160ff8216109150611a8b565b3461044e575f36600319011261044e5760206040517f8d1994e2bbbd77564cdca06dd819e7ee2a5efa06c80dcb59a4a7b6e39edc538f8152f35b3461044e575f36600319011261044e57602060405163ffffffff7f0000000000000000000000000000000000000000000000000000000000000000168152f35b3461044e57602036600319011261044e577fe88463c2f254e2b070013a2dc7ee1e099f9bc00534cbdf03af551dc26ae492196020600435611bf881610bfa565b611c006136d1565b611c08613793565b151561086b80547fffff00ffffffffffffffffffffffffffffffffffffffffffffffffffffffffff60ff60e81b8460e81b169116179055604051908152a16001606555005b3461044e575f36600319011261044e57602063ffffffff610c5a5416604051908152f35b61016036600319011261044e57600435611c8a81610492565b60243590611c9782610492565b604435611ca381610492565b60643590611cb082610492565b60e435611cbc81610492565b6101043590611cca826104ef565b6101243592611cd8846104ef565b610144359667ffffffffffffffff881161044e57611cfd610018983690600401611803565b97909660c4359360a4359360843593613155565b61018036600319011261044e57600435611d2a81610492565b60243590611d3782610492565b604435611d4381610492565b60643590611d5082610492565b60e435611d5c81610492565b61010435611d69816104ef565b6101243591611d77836104ef565b611d7f6104fd565b93610164359767ffffffffffffffff891161044e57611da5610018993690600401611803565b98909760c4359360a4359360843593613177565b3461044e57606036600319011261044e576020611de8600435611ddb81610492565b6044359060243590613292565b604051908152f35b3461044e57606036600319011261044e5767ffffffffffffffff60243581811161044e57611e22903690600401611803565b9160443590811161044e57611e3b903690600401611803565b9060405193602085019480611e524684888a6132ce565b0395611e66601f1997888101845283610676565b6004359151902003611ef9575f94611e95611eb793611e8c87611ec3958a990190612905565b958101906132eb565b519360405193849160208301966337bfd2c960e21b88523391602485016133b3565b03908101835282610676565b5190305af4611ed0612f8d565b9015611ed857005b60405163b8fe37a760e01b8152908190611ef590600483016133d5565b0390fd5b604051630f0c8f4760e11b8152600490fd5b3461044e57602036600319011261044e57600435611f276136d1565b611f2f613793565b611f3881612bc2565b611f70576001815f80935501557f7c1af0646963afc3343245b103731965735a893347bfa0d58a5dc77a77ae691c5f80a26001606555005b634e487b7160e01b5f525f60045260245ffd5b6101a036600319011261044e5761012435611f9d816104ef565b61014435611faa816104ef565b6101643591611fb8836104ef565b610184359267ffffffffffffffff841161044e57611fdd610018943690600401611803565b9390926101043560e43560c43560a4356084356064356044356024356004356133e6565b3461044e575f36600319011261044e5760206040517342000000000000000000000000000000000000078152f35b3461044e575f36600319011261044e5760206040516001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000168152f35b3461044e5760e036600319011261044e5767ffffffffffffffff60043581811161044e576120a4903690600401610cbd565b60a43582811161044e576120bc903690600401611803565b60c49291923593841161044e576120da610018943690600401611803565b9390926084359060643590604435906024359061345e565b3461044e5761210036611a35565b909160ff5f5460081c161561044e576121369061086b9063ffffffff60c01b1963ffffffff60c01b83549260c01b169116179055565b60405161214281610598565b6009815260208101926820a1a927a9a996ab1960b91b8452640312e302e360dc1b602060405161217181610598565b60058152015260ff5f5460081c161561044e57610018936112b89251902061047f557f06c015bd22b4c69690933c1058878ebdfef31f9aaae40bbe86d8a09fe1b2972c610480556112ab614847565b3461044e57602036600319011261044e577f2d5b62420992e5a4afce0e77742636ca2608ef58289fd2e1baa5161ef6e7e41e602060043561220081610bfa565b6122086136d1565b612210613793565b151561086b80547fffffff00ffffffffffffffffffffffffffffffffffffffffffffffffffffffff60ff60e01b8460e01b169116179055604051908152a16001606555005b3461044e575f36600319011261044e576020604051468152f35b3461044e575f36600319011261044e57602063ffffffff61086b5460c01c16604051908152f35b3461044e57604036600319011261044e576004356024356122b682614bd0565b6001600160a01b0382165f526108736020526122e560405f20336001600160a01b03165f5260205260405f2090565b54918215612388575f61232c336123166122fe85613da4565b6001600160a01b03165f5261087360205260405f2090565b906001600160a01b03165f5260205260405f2090565b556123588361234961233d84613da4565b6001600160a01b031690565b61235285613da4565b9061491e565b60405192835233927f6c172ea51018fb2eb2118f3f8a507c4df71eb519b8c0052834dc3c920182fef490602090a4005b6040516336542bf760e21b8152600490fd5b6020808201906020835283518092526040830192602060408460051b8301019501935f915b8483106123cf5750505050505090565b90919293949584806123ed600193603f198682030187528a51611352565b98019301930191949392906123bf565b3461044e5761240b36611302565b9061241582613547565b915f5b81811061242d5760405180611448868261239a565b5f8061243a838587612f69565b9061244a60405180938193612f80565b0390305af4612457612f8d565b901561247d579060019161246b8287612f55565b526124768186612f55565b5001612418565b604481511061044e5780600461044e920151602480918301019101613590565b6101808060031936011261044e57610104356124b8816104ef565b61012435916124c6836104ef565b61014435926124d4846104ef565b6101643567ffffffffffffffff811161044e576124f5903690600401611803565b6124fd613793565b61086b549260ff8460e81c166107f257610bf0966125c2610f46926125b463ffffffff6125d09860c01c16996125586125358c6135ef565b61086b9063ffffffff60c01b1963ffffffff60c01b83549260c01b169116179055565b6125606106d9565b9a6004358c5260243560208d015260443560408d015260643560608d015260843560808d015260a43560a08d015260c43560c08d015260e43560e08d01526101008c01526101208b019063ffffffff169052565b63ffffffff16610140890152565b63ffffffff16610160870152565b90820152614527565b604090600319011261044e576004356125f181610492565b9060243561076081610492565b3461044e57602061263c6001600160a01b03612619366125d9565b91165f52610873835260405f20906001600160a01b03165f5260205260405f2090565b54604051908152f35b3461044e57602036600319011261044e57602060043561266481610492565b6001600160a01b038091165f52610c5c825260405f205416604051908152f35b3461044e575f36600319011261044e5760206001600160a01b0361086a5416604051908152f35b3461044e5760c036600319011261044e5760043560243567ffffffffffffffff60643560443560843583811161044e576126e9903690600401611803565b60a49491943591821161044e577f45e04bc8f121ba11466985789ca2822a91109f31bb8ac85504a37b7eaf873c2694612729612778933690600401611803565b929091612734613793565b61273d8a614bd0565b61276c898b898961274f36888861070f565b9261275b368b8b61070f565b946001600160a01b034692166143f5565b60405196879687612fdc565b0390a36001606555005b3461044e57612790366125d9565b906127996136d1565b6127a1613793565b6001600160a01b0380911691825f52610c5d6020526127d98160405f20906001600160a01b03166001600160a01b0319825416179055565b16907fcb84c2022106a6f2b6f805d446f32fbfd2a528474364fa755f37dac1c0c1b6c85f80a36001606555005b3461044e57602036600319011261044e576004355f52610872602052602060405f2054604051908152f35b3461044e575f36600319011261044e57602060405163ffffffff8152f35b91906101808382031261044e576128646106b8565b92803584526020810135602085015260408101356040850152606081013560608501526080810135608085015260a081013560a085015260c081013560c085015260e081013560e085015261010080820135908501526101206128c881830161050b565b908501526101406128da81830161050b565b90850152610160918282013567ffffffffffffffff811161044e576128ff9201610745565b90830152565b9060208282031261044e57813567ffffffffffffffff811161044e57610760920161284f565b3461044e57602036600319011261044e5760043567ffffffffffffffff811161044e57611de8610ec4602092369060040161284f565b3461044e575f36600319011261044e57602060ff61086b5460e01c166040519015158152f35b3461044e575f36600319011261044e5760206040516ec097ce7bc90715b34b9f10000000008152f35b3461044e57602036600319011261044e576107eb6004356129d081610492565b6129d86136d1565b6112b3613793565b3461044e57606036600319011261044e5760043567ffffffffffffffff811161044e57612a1190369060040161284f565b612a19613793565b60ff61086b5460e01c16612ac35761014081015163ffffffff4281169116101580612aa4575b612a925780612a50610bf092613604565b60c082015160208301519061016084015192612a6a610698565b948552602085015260408401526060830152608082015260243560a08201526044359061417f565b604051630c3a9b9d60e41b8152600490fd5b50612ab26040820151613da4565b6001600160a01b0316331415612a3f565b604051633d90fc5560e11b8152600490fd5b3461044e575f36600319011261044e576020610c5a546001600160a01b0360405191831c168152f35b6101608060031936011261044e5761010435612b19816104ef565b61012435612b26816104ef565b6101443567ffffffffffffffff811161044e57612b47903690600401611803565b63ffffffff94612b5a8642169586613138565b93612b63613793565b61086b549160ff8360e81c166107f257612b96612ba3966125b4610bf09a610f469660c01c16996125586125358c6135ef565b86019063ffffffff169052565b610180820152614527565b634e487b7160e01b5f52603260045260245ffd5b61086c908154811015612bfc576003915f52027f71cd7344f4eb2efc8e30291f6dbdb44d618ca368ea5425d217c1d604bf26b84d01905f90565b612bae565b3461044e57602036600319011261044e5760043561086c5481101561044e57612c2b604091612bc2565b506001815491015482519182526020820152f35b3461044e57612c4d366125d9565b90612c566136d1565b612c5e613793565b6001600160a01b0380911691825f52610c5c602052612c968160405f20906001600160a01b03166001600160a01b0319825416179055565b16907ff3dc137d2246f9b8abd0bb821e185ba01122c9b3ea3745ffca6208037674d6705f80a36001606555005b3461044e57602036600319011261044e576107eb600435612ce381610492565b612ceb6136d1565b6112b8613793565b91612cfc613793565b6080820191612d15610b9884516001600160a01b031690565b602081019182514603612e1c57612d3d612d4191836001612d3589612bc2565b500154613ac0565b1590565b612e0a578060607ff4ad92585b1bc117fbdd644990adf0827bc4c95baeae8a23322af807b6d0020e920193612d83612d7d865163ffffffff1690565b87613b52565b612dfd845194835193612de2612dd4612dc360408401998a51612daa8d5163ffffffff1690565b89516001600160a01b03169160a088019b8c5194613bc3565b925193519851995163ffffffff1690565b94516001600160a01b031690565b945163ffffffff9586604051978897169b1699339487612e9d565b0390a46104ae6001606555565b60405163582f497d60e11b8152600490fd5b604051633d23e4d160e11b8152600490fd5b9081518082526020808093019301915f5b828110612e4d575050505090565b835185529381019392810192600101612e3f565b9081518082526020808093019301915f5b828110612e80575050505090565b83516001600160a01b031685529381019392810192600101612e72565b9496959193612ebf60a095612edd93885260c0602089015260c0880190612e2e565b906001600160a01b0380951660408801528682036060880152612e61565b951515608085015216910152565b3561076081610492565b35610760816104ef565b903590601e198136030182121561044e570180359067ffffffffffffffff821161044e5760200191813603831361044e57565b634e487b7160e01b5f52602160045260245ffd5b60031115612f5057565b612f32565b8051821015612bfc5760209160051b010190565b90821015612bfc5761132d9160051b810190612eff565b908092918237015f815290565b3d15612fb7573d90612f9e826106f3565b91612fac6040519384610676565b82523d5f602084013e565b606090565b908060209392818452848401375f828201840152601f01601f1916010190565b9492909361300192610760979587526020870152608060408701526080860191612fbc565b926060818503910152612fbc565b91909160ff5f5460081c161561044e5761305990610c5a624c4b4063ffffffff1982541617905561086b9063ffffffff60c01b1963ffffffff60c01b83549260c01b169116179055565b60405161306581610598565b6009815260208101926820a1a927a9a996ab1960b91b8452640312e302e360dc1b602060405161309481610598565b60058152015260ff5f5460081c161561044e576130e3936112b89251902061047f557f06c015bd22b4c69690933c1058878ebdfef31f9aaae40bbe86d8a09fe1b2972c610480556112ab614847565b6104ae610c5a77deaddeaddeaddeaddeaddeaddeaddeaddead00000000000077ffffffffffffffffffffffffffffffffffffffff0000000019825416179055565b634e487b7160e01b5f52601160045260245ffd5b91909163ffffffff8080941691160191821161315057565b613124565b96949290916104ae9b9a999896949261317563ffffffff42169889613138565b985b9593919b999897969492909b61318b613793565b61086b549660ff8860e81c166107f2578760c01c63ffffffff166131ae906135ef565b6131d59061086b9063ffffffff60c01b1963ffffffff60c01b83549260c01b169116179055565b6131dd6106d9565b9d6001600160a01b038f921682526001600160a01b031690602001526001600160a01b031660408d01526001600160a01b031660608c015260808b015260a08a015260c08901526001600160a01b031660e088015260c01c63ffffffff16610100870152610120860190613256919063ffffffff169052565b63ffffffff1661014085015263ffffffff1661016084015236906132799261070f565b61018082015261328890614527565b6104ae6001606555565b916040519160208301936bffffffffffffffffffffffff199060601b16845260348301526054820152605481526132c881610606565b51902090565b9392916020916132e691604087526040870191612fbc565b930152565b9081602091031261044e57604051906020820182811067ffffffffffffffff8211176105b45760405235815290565b6107609161018090825181526020830151602082015260408301516040820152606083015160608201526080830151608082015260a083015160a082015260c083015160c082015260e083015160e0820152610100808401519082015261338f610120808501519083019063ffffffff169052565b6101408381015163ffffffff16908201528161016080940151938201520190611352565b6133cb6040929594939560608352606083019061331a565b9460208201520152565b906020610760928181520190611352565b9c9a99989796959493929190966133fb613793565b60ff61086b5460e81c166107f257613414908e33613292565b96604051809e613423826105b9565b81526020015260408d015260608c015260808b015260a08a015260c089015260e088015261010087015263ffffffff16610120860152613256565b97929095939196949761346f613793565b60ff61086b5460e01c16612ac35761348a6101408201612ef5565b63ffffffff8042169116101580613528575b612a9257613511613523966135096132889b6134bb610ec4368761284f565b9a6134c4610698565b9b6134cf368861284f565b8d5260208d01528660408d01528760608d01526134ed368b8461070f565b60808d015260a08c01526135018535613da4565b98369161070f565b95369161070f565b9461010060e0830135920135906143f5565b61417f565b506135366040820135613da4565b6001600160a01b031633141561349c565b90613551826108a4565b61355e6040519182610676565b828152809261356f601f19916108a4565b01905f5b82811061357f57505050565b806060602080938501015201613573565b60208183031261044e5780519067ffffffffffffffff821161044e570181601f8201121561044e5780516135c3816106f3565b926135d16040519485610676565b8184526020828401011161044e576107609160208085019101611331565b63ffffffff8091169081146131505760010190565b6040516132c881613621602082019460408652606083019061331a565b46604083015203601f198101835282610676565b919091613640613793565b60ff61086b5460e01c16612ac35761014081015163ffffffff42811691161015806136b2575b612a92576132889261367782613604565b60c083015160208401519061016085015192613691610698565b958652602086015260408501526060840152608083015260a082015261417f565b506136c06040820151613da4565b6001600160a01b0316331415613666565b73420000000000000000000000000000000000000780330361378157602060049160405192838092636e296e4560e01b82525afa90811561377c575f9161374d575b506001600160a01b0361373261233d610869546001600160a01b031690565b91160361373b57565b6040516336a816d960e01b8152600490fd5b61376f915060203d602011613775575b6137678183610676565b810190614966565b5f613713565b503d61375d565b6137b1565b60405163253a6fc960e11b8152600490fd5b60026065541461044e576002606555565b9190820391821161315057565b6040513d5f823e3d90fd5b926107609695929491946101409585525f60208601526040850152606084015263ffffffff809116608084015260a08301525f60c083015260e08201525f610100820152816101208201520190611352565b9193949690959661384f612d3d6138488861383b896001600160a01b03165f5261086d60205260405f2090565b905f5260205260405f2090565b5460ff1690565b613a3b5760070b906706f05b59d3b200006138698361497b565b1015613a29576ec097ce7bc90715b34b9f10000000008411613a175763ffffffff93613897858a16426137a4565b857f00000000000000000000000000000000000000000000000000000000000000001610613a055761086b5460c01c63ffffffff16986138d96125358b6135ef565b6001600160a01b039586807f000000000000000000000000000000000000000000000000000000000000000016981692888414806139fc575b156139c0578034036139ae57883b1561044e575f6004996040519a8b8092630d0e30db60e41b825234905af198891561377c5761397d613990978a927f32ed1a409ef04c7b0227189c3a103dc5ac10e775a15b785dcc510201f7c25ad39c613995575b505b836149c9565b92604051998a99169d169b1693876137bc565b0390a4565b806139a26139a8926105d6565b80610444565b5f613975565b604051636452a35d60e01b8152600490fd5b7f32ed1a409ef04c7b0227189c3a103dc5ac10e775a15b785dcc510201f7c25ad398508761397d613990976139f78430338a61498a565b613977565b50341515613912565b60405163f722177f60e01b8152600490fd5b60405163622db5a960e11b8152600490fd5b60405163284f109760e21b8152600490fd5b604051632a58c4f360e01b8152600490fd5b6001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000811691168114613a84575b50565b47613a8c5750565b4790803b1561044e575f90600460405180948193630d0e30db60e41b83525af1801561377c5715613a81576104ae906105d6565b6107609291604051613b4981613b3b602082019460208652805160408401526020810151606084015260a0613b05604083015160c06080870152610100860190612e2e565b606083015163ffffffff168583015260808301516001600160a01b031660c0860152910151838203603f190160e0850152612e61565b03601f198101835282610676565b519020916149ff565b613b5d600291612bc2565b500162ffffff8260081c16805f5281602052600160ff60405f205494161b8080941614613b95575f5260205260405f20908154179055565b60405163954476d960e01b8152600490fd5b9081602091031261044e575190565b9190820180921161315057565b91959495939092935f9681519081815103613d925781613c42575b50505082613bed575b50505050565b6001600160a01b0381613c217ffa7fa7cf6d7dde5f9be65a67e6a1a747e7aa864dcd2d793353c722d80fbbb3579386614ac2565b6040805195865233602087015291169463ffffffff1693a45f808080613be7565b604080516370a0823160e01b81523060048083019190915291906020816024816001600160a01b038b165afa90811561377c575f91613d73575b505f805b868110613c91575050505050613bde565b613c9b8189612f55565b51613ca9575b600101613c80565b90613cbf90613cb8838a612f55565b5190613bb6565b90828211613d6357613cf9612d3d613ce7613cda848a612f55565b516001600160a01b031690565b613cf1848c612f55565b51908c614a50565b15613ca1579c5087613d59613d518f613d3c613cda613d35613d1b848f612f55565b51966001600160a01b03165f5261087360205260405f2090565b928b612f55565b6001600160a01b03165f5260205260405f2090565b918254613bb6565b905560019c613ca1565b50505051632ddaa83160e11b8152fd5b613d8c915060203d60201161118b5761117c8183610676565b5f613c7c565b6040516319a5316760e31b8152600490fd5b6001600160a01b0390613db681614bd0565b1690565b91612d3d90613e3392845160408096015191865191613dd8836105ea565b8252613b49613df36020840192468452898501958652612bc2565b5054938851928391613e186020840196602088525160608d86015260a085019061331a565b9151606084015251608083015203601f198101835282610676565b613e3a5750565b5163582f497d60e11b8152600490fd5b613e5382612f46565b52565b9a989693919c9b9997959492909c6101e08c019d8c5260208c015260408b015260608a0152608089015263ffffffff80921660a08901521660c087015260e08601526101008501526101208401526101408301528051610160830152602081015161018083015260408101516101a08301526060015190613ed682612f46565b6101c00152565b9061076094936080936001600160a01b03809316845260208401521660408201528160608201520190611352565b905f82516101208101613f22815163ffffffff1690565b63ffffffff4291161061416d576020850151906002613f4a835f5261087260205260405f2090565b541461415b57613f6486925f5261087260205260405f2090565b6002905560608301519060808401519160a08501519260c0860151918560a0810151938860e0810151956101008201519751613fa39063ffffffff1690565b61014083015163ffffffff166040840151918451936020860151956101600151613fcc906143e0565b966060890151986080019e8f51613fe2906143e0565b906040015190613ff06106e6565b9a8b5260208b015260408a0152600260608a01526040519d8e9b6140149b8d613e56565b037f44b559f101f8fbcc8a0ea43fa91a05a729a5ea6e14a7c75aa750374690137208905f94a4608082015161404890613da4565b906040860151956060015161405c90613da4565b926080015161406a90613da4565b6001600160a01b03919082167f00000000000000000000000000000000000000000000000000000000000000008316036141465784614133575b6140b087838616614beb565b51928351151580614129575b6140ca575b50505050509050565b1690813b1561412557836140f8959660405196879586948593633a5be8cb60e01b8552339160048601613edd565b03925af1801561377c57614112575b8080808085946140c1565b806139a261411f926105d6565b5f614107565b8380fd5b50803b15156140bc565b61414187303385871661498a565b6140a4565b5f9450614156878585851661491e565b6140b0565b604051630479306360e51b8152600490fd5b60405163d642b7d960e01b8152600490fd5b8051916101208301614195815163ffffffff1690565b63ffffffff4291161061416d57602083015160016141bc825f5261087260205260405f2090565b54036143d9576001905b60026141db825f5261087260205260405f2090565b541461415b576141f76141fd915f5261087260205260405f2090565b60029055565b7f44b559f101f8fbcc8a0ea43fa91a05a729a5ea6e14a7c75aa75037469013720860608601516080870151906142ca8760a08a0151958a60c08101519760a08401519860e08301519961425a6101008501519c5163ffffffff1690565b61014085015163ffffffff16916040860151938651956142be61428661016060208b01519a01516143e0565b9960608c01519b604061429c60808301516143e0565b9101519060206142aa6106e6565b9e8f528e015260408d015260608c01613e4a565b6040519c8d9c8d613e56565b0390a46142da6080830151613da4565b9160408201519160806142fc816142f46060850151613da4565b940151613da4565b6001600160a01b03929083167f00000000000000000000000000000000000000000000000000000000000000008416036143c65761433e853033868a1661498a565b61434a85848616614beb565b01519182511515806143bc575b614363575b5050505050565b16803b1561044e57614391935f809460405196879586948593633a5be8cb60e01b8552339160048601613edd565b03925af1801561377c576143a9575b8080808061435c565b806139a26143b6926105d6565b5f6143a0565b50803b1515614357565b6143d4858533868a1661498a565b61434a565b5f906141c6565b805190816143ee5750505f90565b6020012090565b93926042936104ae979660208151910120906040519260208401947f8d1994e2bbbd77564cdca06dd819e7ee2a5efa06c80dcb59a4a7b6e39edc538f86526040850152856060850152608084015260a083015260c082015260c0815261445a8161063e565b5190209061047f549061048054906040519160208301937fc2f8787176b8ac6bf7215b4adcc1e069bf4ab82d9ab1df05a57a91d425935b6e8552604084015260608301526080820152608081526144b08161065a565b519020906040519161190160f01b8352600283015260228201522090614e08565b96926107609a9996949198959261014099895260208901526040880152606087015263ffffffff928380921660808801521660a08601521660c084015260e0830152610100820152816101208201520190611352565b6145318151614bd0565b6040908181019061455d6145458351613da4565b6001600160a01b03165f5261086d60205260405f2090565b9261457a612d3d61384860c085019687515f5260205260405f2090565b6148375761012082019261459e614595855163ffffffff1690565b63ffffffff1690565b8042109081156147fe575b506147ed576101408301926145c2845163ffffffff1690565b9163ffffffff92836145f6817f00000000000000000000000000000000000000000000000000000000000000001642613bb6565b9116116147dc5761016082015163ffffffff169280841680614798575b50508051936001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000168095148061478f575b15614729576080830151340361471957843b1561044e575f600495825196878092630d0e30db60e41b825234905af191821561377c577f32ed1a409ef04c7b0227189c3a103dc5ac10e775a15b785dcc510201f7c25ad39561399093614706575b505b519260608101519460808201519060a08301519a51986146e66146db6101008601519c5163ffffffff1690565b915163ffffffff1690565b9084519c60208601519461018060e088015197015197519a8b9a8b6144d1565b806139a2614713926105d6565b5f6146ac565b51636452a35d60e01b8152600490fd5b919293503461477e577f32ed1a409ef04c7b0227189c3a103dc5ac10e775a15b785dcc510201f7c25ad39392918161477961476a61233d6139909551613da4565b6080860151903090339061498a565b6146ae565b8151636452a35d60e01b8152600490fd5b5034151561464b565b6301e1338010156147c7575b5060e0820151156147b6575f80614613565b835163495d907f60e01b8152600490fd5b926147d59193421690613138565b915f6147a4565b835163582e388960e01b8152600490fd5b815163f722177f60e01b8152600490fd5b6148099150426137a4565b63ffffffff7f000000000000000000000000000000000000000000000000000000000000000016105f6145a9565b51632a58c4f360e01b8152600490fd5b60ff5f5460081c161561044e57565b60ff5f5460081c161561044e576001606555565b6001600160a01b031680156148b257610869816001600160a01b03198254161790557fa9e8c42c9e7fca7f62755189a16b2f5314d43d8fb24e91ba54e6d65f9314e8495f80a2565b60405163ba97b39d60e01b8152600490fd5b6001600160a01b0316801561490c5761086a816001600160a01b03198254161790557fa73e8909f8616742d7fe701153d82666f7b7cd480552e23ebb05d358c22fd04e5f80a2565b604051635b03092b60e11b8152600490fd5b60405163a9059cbb60e01b60208201526001600160a01b03909216602483015260448201929092526104ae9161496182606481015b03601f198101845283610676565b614ee6565b9081602091031261044e575161076081610492565b5f81126149855790565b5f0390565b90926104ae93604051936323b872dd60e01b60208601526001600160a01b0380921660248601521660448401526064830152606482526149618261065a565b90670de0b6b3a7640000915f82840392128383128116908484139015161761315057818102918183041490151715613150570490565b929091905f915b8451831015614a4857614a198386612f55565b519081811015614a37575f52602052600160405f205b920191614a06565b905f52602052600160405f20614a2f565b915092501490565b60405163a9059cbb60e01b60208281019182526001600160a01b039094166024830152604482019490945290925f91614a8c8160648101613b3b565b519082855af1903d5f519083614aa3575b50505090565b91925090614ab857503b15155b5f8080614a9d565b6001915014614ab0565b907f0000000000000000000000000000000000000000000000000000000000000000906001600160a01b03808316818316149081614ba5575b5015614b9a575081614b0c916152df565b61086a546001600160a01b0316610c5a5463ffffffff1673bd80b06d3dbd0801132c6689429ac09ca6d27f82803b1561044e5760405163262cc5ab60e11b81526001600160a01b039093166004840152602483019390935263ffffffff166044820152905f908290818381606481015b03925af1801561377c57614b8d5750565b806139a26104ae926105d6565b90506104ae91614f76565b90507f000000000000000000000000000000000000000000000000000000000000000016155f614afb565b60a01c614bd957565b6040516379ec0ed760e11b8152600490fd5b6001600160a01b0390811690813b15614c2b57906104ae92917f00000000000000000000000000000000000000000000000000000000000000001661491e565b7f000000000000000000000000000000000000000000000000000000000000000016803b1561044e575f8091602460405180948193632e1a7d4d60e01b83528860048401525af1801561377c57614c9d575b5081471061044e575f80809381935af1614c95612f8d565b501561044e57565b614ca6906105d6565b5f614c7d565b614cb581614dc5565b6001600160a01b0381167fbc7cd75a20ee27fd9adebab32041f755214dbc6bffa90cc0225b39da2e5c2d3b5f80a2815115801590614d6d575b614cf6575050565b5f80613a81937f206661696c65640000000000000000000000000000000000000000000000000060408051614d2a816105ea565b602781527f416464726573733a206c6f772d6c6576656c2064656c65676174652063616c6c60208201520152602081519101845af4614d67612f8d565b91615686565b505f614cee565b614d7d81614dc5565b6001600160a01b0381167fbc7cd75a20ee27fd9adebab32041f755214dbc6bffa90cc0225b39da2e5c2d3b5f80a2815115801590614dbd57614cf6575050565b506001614cee565b803b1561044e576001600160a01b037f360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc91166001600160a01b0319825416179055565b614e128383615635565b6005819592951015612f5057159384614ed0575b508315614e4a575b50505015614e3857565b60405163938a182160e01b8152600490fd5b5f929350908291604051614e8281613b3b6020820194630b135d3f60e11b998a87526024840152604060448401526064830190611352565b51915afa90614e8f612f8d565b82614ec2575b82614ea5575b50505f8080614e2e565b614eba91925060208082518301019101613ba7565b145f80614e9b565b915060208251101591614e95565b6001600160a01b0383811691161493505f614e26565b905f806001600160a01b03614f3d9416927f5361666545524332303a206c6f772d6c6576656c2063616c6c206661696c65646020604051614f2681610598565b818152015260208151910182855af1614d67612f8d565b8051908115918215614f53575b50501561044e57565b819250906020918101031261044e5760200151614f6f81610bfa565b5f80614f4a565b906001600160a01b0390818116907f0000000000000000000000000000000000000000000000000000000000000000831682036150895750803b1561044e57604051632e1a7d4d60e01b815260048101849052905f908290602490829084905af1801561377c57615076575b50610c5a5491614ffb61086a546001600160a01b031690565b73420000000000000000000000000000000000001090813b1561044e57604051631474f2a960e31b81526001600160a01b03602087901c90951685166004820152931660248401526044830182905263ffffffff909316606483015260a060848301525f60a483018190529192839182908160c48101614b7c565b806139a2615083926105d6565b5f614fe2565b91807f0000000000000000000000000000000000000000000000000000000000000000161515806152b4575b156150d9575050506104ae906150d461086a546001600160a01b031690565b615449565b806151066150f9856001600160a01b03165f52610c5c60205260405f2090565b546001600160a01b031690565b16615290577342000000000000000000000000000000000000105b169061514561233d6150f9856001600160a01b03165f52610c5d60205260405f2090565b1561520a5783826151559261539c565b6151746150f9836001600160a01b03165f52610c5d60205260405f2090565b9061518861086a546001600160a01b031690565b91615199610c5a5463ffffffff1690565b823b1561044e5760405163540abf7360e01b81526001600160a01b0395861660048201529185166024830152929093166044840152606483019390935263ffffffff16608482015260c060a48201525f60c482018190529091829060e490829084905af1801561377c57614b8d5750565b509161521f61086a546001600160a01b031690565b92615230610c5a5463ffffffff1690565b93813b1561044e57604051631474f2a960e31b81526001600160a01b03948516600482015293166024840152604483019190915263ffffffff909216606482015260a060848201525f60a482018190529091829081838160c48101614b7c565b6152af6150f9846001600160a01b03165f52610c5c60205260405f2090565b615121565b50807f00000000000000000000000000000000000000000000000000000000000000001682146150b5565b604051636eb1769f60e11b815230600482015273bd80b06d3dbd0801132c6689429ac09ca6d27f82602482015290916020826044816001600160a01b0387165afa91821561377c575f9261537b575b5081018091116131505760405163095ea7b360e01b602082015273bd80b06d3dbd0801132c6689429ac09ca6d27f82602482015260448101919091526104ae916149618260648101614953565b61539591925060203d60201161118b5761117c8183610676565b905f61532e565b604051636eb1769f60e11b81523060048201526001600160a01b03831660248201529192602083806044810103816001600160a01b0386165afa92831561377c575f93615428575b5082018092116131505760405163095ea7b360e01b60208201526001600160a01b03909316602484015260448301919091526104ae91906149618260648101614953565b61544291935060203d60201161118b5761117c8183610676565b915f6153e4565b6001600160a01b03809116917f000000000000000000000000000000000000000000000000000000000000000090827f0000000000000000000000000000000000000000000000000000000000000000166154a582828561539c565b604090604051916332dd704760e21b83526020936004958585600481875afa94851561377c57869189915f97615616575b501697604051958680926352b7631960e11b8252816155088d600483019190916001600160a01b036020820193169052565b0392165afa93841561377c575f946155f7575b5092947f000000000000000000000000000000000000000000000000000000000000000093805b61555157505050505050505050565b6155a290878111156155f15787905b84516337e9a82760e11b815284810183815263ffffffff89166020820152604081018d90526001600160a01b038c166060820152909389918591829160800190565b03815f8a5af192831561377c576155be936155c4575b506137a4565b80615542565b6155e390893d8b116155ea575b6155db8183610676565b810190615666565b505f6155b8565b503d6155d1565b80615560565b61560f919450853d871161118b5761117c8183610676565b925f61551b565b61562e919750833d8511613775576137678183610676565b955f6154d6565b9060418151145f1461565d5761132d91602082015190606060408401519301515f1a906156af565b50505f90600290565b9081602091031261044e575167ffffffffffffffff8116810361044e5790565b90156156a057815115615697575090565b3b1561044e5790565b50805190811561044e57602001fd5b7f7fffffffffffffffffffffffffffffff5d576e7357a4501ddfe92f46681b20a0841161571f576020935f9360ff60809460405194855216868401526040830152606082015282805260015afa1561377c575f516001600160a01b0381161561571757905f90565b505f90600190565b505050505f9060039056fea264697066735822122081de8cafbdfc055aa138e7706e83912b790d1c719a65b618b872483c2da3859c64736f6c63430008170033"
}
diff --git a/deployments/worldchain/solcInputs/f6db5bcc09d996b0e542155af45c1220.json b/deployments/worldchain/solcInputs/f6db5bcc09d996b0e542155af45c1220.json
deleted file mode 100644
index 3d74813bd..000000000
--- a/deployments/worldchain/solcInputs/f6db5bcc09d996b0e542155af45c1220.json
+++ /dev/null
@@ -1,168 +0,0 @@
-{
- "language": "Solidity",
- "sources": {
- "@eth-optimism/contracts/libraries/constants/Lib_PredeployAddresses.sol": {
- "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.9;\n\n/**\n * @title Lib_PredeployAddresses\n */\nlibrary Lib_PredeployAddresses {\n address internal constant L2_TO_L1_MESSAGE_PASSER = 0x4200000000000000000000000000000000000000;\n address internal constant L1_MESSAGE_SENDER = 0x4200000000000000000000000000000000000001;\n address internal constant DEPLOYER_WHITELIST = 0x4200000000000000000000000000000000000002;\n address payable internal constant OVM_ETH = payable(0xDeadDeAddeAddEAddeadDEaDDEAdDeaDDeAD0000);\n address internal constant L2_CROSS_DOMAIN_MESSENGER =\n 0x4200000000000000000000000000000000000007;\n address internal constant LIB_ADDRESS_MANAGER = 0x4200000000000000000000000000000000000008;\n address internal constant PROXY_EOA = 0x4200000000000000000000000000000000000009;\n address internal constant L2_STANDARD_BRIDGE = 0x4200000000000000000000000000000000000010;\n address internal constant SEQUENCER_FEE_WALLET = 0x4200000000000000000000000000000000000011;\n address internal constant L2_STANDARD_TOKEN_FACTORY =\n 0x4200000000000000000000000000000000000012;\n address internal constant L1_BLOCK_NUMBER = 0x4200000000000000000000000000000000000013;\n}\n"
- },
- "@openzeppelin/contracts-upgradeable/crosschain/errorsUpgradeable.sol": {
- "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.6.0) (crosschain/errors.sol)\n\npragma solidity ^0.8.4;\n\nerror NotCrossChainCall();\nerror InvalidCrossChainSender(address actual, address expected);\n"
- },
- "@openzeppelin/contracts-upgradeable/crosschain/optimism/LibOptimismUpgradeable.sol": {
- "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.7.0) (crosschain/optimism/LibOptimism.sol)\n\npragma solidity ^0.8.4;\n\nimport {ICrossDomainMessengerUpgradeable as Optimism_Bridge} from \"../../vendor/optimism/ICrossDomainMessengerUpgradeable.sol\";\nimport \"../errorsUpgradeable.sol\";\n\n/**\n * @dev Primitives for cross-chain aware contracts for https://www.optimism.io/[Optimism].\n * See the https://community.optimism.io/docs/developers/bridge/messaging/#accessing-msg-sender[documentation]\n * for the functionality used here.\n */\nlibrary LibOptimismUpgradeable {\n /**\n * @dev Returns whether the current function call is the result of a\n * cross-chain message relayed by `messenger`.\n */\n function isCrossChain(address messenger) internal view returns (bool) {\n return msg.sender == messenger;\n }\n\n /**\n * @dev Returns the address of the sender that triggered the current\n * cross-chain message through `messenger`.\n *\n * NOTE: {isCrossChain} should be checked before trying to recover the\n * sender, as it will revert with `NotCrossChainCall` if the current\n * function call is not the result of a cross-chain message.\n */\n function crossChainSender(address messenger) internal view returns (address) {\n if (!isCrossChain(messenger)) revert NotCrossChainCall();\n\n return Optimism_Bridge(messenger).xDomainMessageSender();\n }\n}\n"
- },
- "@openzeppelin/contracts-upgradeable/interfaces/draft-IERC1822Upgradeable.sol": {
- "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.5.0) (interfaces/draft-IERC1822.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @dev ERC1822: Universal Upgradeable Proxy Standard (UUPS) documents a method for upgradeability through a simplified\n * proxy whose upgrades are fully controlled by the current implementation.\n */\ninterface IERC1822ProxiableUpgradeable {\n /**\n * @dev Returns the storage slot that the proxiable contract assumes is being used to store the implementation\n * address.\n *\n * IMPORTANT: A proxy pointing at a proxiable contract should not be considered proxiable itself, because this risks\n * bricking a proxy that upgrades to it, by delegating to itself until out of gas. Thus it is critical that this\n * function revert if invoked through a proxy.\n */\n function proxiableUUID() external view returns (bytes32);\n}\n"
- },
- "@openzeppelin/contracts-upgradeable/interfaces/IERC1967Upgradeable.sol": {
- "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (interfaces/IERC1967.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @dev ERC-1967: Proxy Storage Slots. This interface contains the events defined in the ERC.\n *\n * _Available since v4.8.3._\n */\ninterface IERC1967Upgradeable {\n /**\n * @dev Emitted when the implementation is upgraded.\n */\n event Upgraded(address indexed implementation);\n\n /**\n * @dev Emitted when the admin account has changed.\n */\n event AdminChanged(address previousAdmin, address newAdmin);\n\n /**\n * @dev Emitted when the beacon is changed.\n */\n event BeaconUpgraded(address indexed beacon);\n}\n"
- },
- "@openzeppelin/contracts-upgradeable/proxy/beacon/IBeaconUpgradeable.sol": {
- "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts v4.4.1 (proxy/beacon/IBeacon.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @dev This is the interface that {BeaconProxy} expects of its beacon.\n */\ninterface IBeaconUpgradeable {\n /**\n * @dev Must return an address that can be used as a delegate call target.\n *\n * {BeaconProxy} will check that this address is a contract.\n */\n function implementation() external view returns (address);\n}\n"
- },
- "@openzeppelin/contracts-upgradeable/proxy/ERC1967/ERC1967UpgradeUpgradeable.sol": {
- "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (proxy/ERC1967/ERC1967Upgrade.sol)\n\npragma solidity ^0.8.2;\n\nimport \"../beacon/IBeaconUpgradeable.sol\";\nimport \"../../interfaces/IERC1967Upgradeable.sol\";\nimport \"../../interfaces/draft-IERC1822Upgradeable.sol\";\nimport \"../../utils/AddressUpgradeable.sol\";\nimport \"../../utils/StorageSlotUpgradeable.sol\";\nimport {Initializable} from \"../utils/Initializable.sol\";\n\n/**\n * @dev This abstract contract provides getters and event emitting update functions for\n * https://eips.ethereum.org/EIPS/eip-1967[EIP1967] slots.\n *\n * _Available since v4.1._\n */\nabstract contract ERC1967UpgradeUpgradeable is Initializable, IERC1967Upgradeable {\n // This is the keccak-256 hash of \"eip1967.proxy.rollback\" subtracted by 1\n bytes32 private constant _ROLLBACK_SLOT = 0x4910fdfa16fed3260ed0e7147f7cc6da11a60208b5b9406d12a635614ffd9143;\n\n /**\n * @dev Storage slot with the address of the current implementation.\n * This is the keccak-256 hash of \"eip1967.proxy.implementation\" subtracted by 1, and is\n * validated in the constructor.\n */\n bytes32 internal constant _IMPLEMENTATION_SLOT = 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc;\n\n function __ERC1967Upgrade_init() internal onlyInitializing {\n }\n\n function __ERC1967Upgrade_init_unchained() internal onlyInitializing {\n }\n /**\n * @dev Returns the current implementation address.\n */\n function _getImplementation() internal view returns (address) {\n return StorageSlotUpgradeable.getAddressSlot(_IMPLEMENTATION_SLOT).value;\n }\n\n /**\n * @dev Stores a new address in the EIP1967 implementation slot.\n */\n function _setImplementation(address newImplementation) private {\n require(AddressUpgradeable.isContract(newImplementation), \"ERC1967: new implementation is not a contract\");\n StorageSlotUpgradeable.getAddressSlot(_IMPLEMENTATION_SLOT).value = newImplementation;\n }\n\n /**\n * @dev Perform implementation upgrade\n *\n * Emits an {Upgraded} event.\n */\n function _upgradeTo(address newImplementation) internal {\n _setImplementation(newImplementation);\n emit Upgraded(newImplementation);\n }\n\n /**\n * @dev Perform implementation upgrade with additional setup call.\n *\n * Emits an {Upgraded} event.\n */\n function _upgradeToAndCall(address newImplementation, bytes memory data, bool forceCall) internal {\n _upgradeTo(newImplementation);\n if (data.length > 0 || forceCall) {\n AddressUpgradeable.functionDelegateCall(newImplementation, data);\n }\n }\n\n /**\n * @dev Perform implementation upgrade with security checks for UUPS proxies, and additional setup call.\n *\n * Emits an {Upgraded} event.\n */\n function _upgradeToAndCallUUPS(address newImplementation, bytes memory data, bool forceCall) internal {\n // Upgrades from old implementations will perform a rollback test. This test requires the new\n // implementation to upgrade back to the old, non-ERC1822 compliant, implementation. Removing\n // this special case will break upgrade paths from old UUPS implementation to new ones.\n if (StorageSlotUpgradeable.getBooleanSlot(_ROLLBACK_SLOT).value) {\n _setImplementation(newImplementation);\n } else {\n try IERC1822ProxiableUpgradeable(newImplementation).proxiableUUID() returns (bytes32 slot) {\n require(slot == _IMPLEMENTATION_SLOT, \"ERC1967Upgrade: unsupported proxiableUUID\");\n } catch {\n revert(\"ERC1967Upgrade: new implementation is not UUPS\");\n }\n _upgradeToAndCall(newImplementation, data, forceCall);\n }\n }\n\n /**\n * @dev Storage slot with the admin of the contract.\n * This is the keccak-256 hash of \"eip1967.proxy.admin\" subtracted by 1, and is\n * validated in the constructor.\n */\n bytes32 internal constant _ADMIN_SLOT = 0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103;\n\n /**\n * @dev Returns the current admin.\n */\n function _getAdmin() internal view returns (address) {\n return StorageSlotUpgradeable.getAddressSlot(_ADMIN_SLOT).value;\n }\n\n /**\n * @dev Stores a new address in the EIP1967 admin slot.\n */\n function _setAdmin(address newAdmin) private {\n require(newAdmin != address(0), \"ERC1967: new admin is the zero address\");\n StorageSlotUpgradeable.getAddressSlot(_ADMIN_SLOT).value = newAdmin;\n }\n\n /**\n * @dev Changes the admin of the proxy.\n *\n * Emits an {AdminChanged} event.\n */\n function _changeAdmin(address newAdmin) internal {\n emit AdminChanged(_getAdmin(), newAdmin);\n _setAdmin(newAdmin);\n }\n\n /**\n * @dev The storage slot of the UpgradeableBeacon contract which defines the implementation for this proxy.\n * This is bytes32(uint256(keccak256('eip1967.proxy.beacon')) - 1)) and is validated in the constructor.\n */\n bytes32 internal constant _BEACON_SLOT = 0xa3f0ad74e5423aebfd80d3ef4346578335a9a72aeaee59ff6cb3582b35133d50;\n\n /**\n * @dev Returns the current beacon.\n */\n function _getBeacon() internal view returns (address) {\n return StorageSlotUpgradeable.getAddressSlot(_BEACON_SLOT).value;\n }\n\n /**\n * @dev Stores a new beacon in the EIP1967 beacon slot.\n */\n function _setBeacon(address newBeacon) private {\n require(AddressUpgradeable.isContract(newBeacon), \"ERC1967: new beacon is not a contract\");\n require(\n AddressUpgradeable.isContract(IBeaconUpgradeable(newBeacon).implementation()),\n \"ERC1967: beacon implementation is not a contract\"\n );\n StorageSlotUpgradeable.getAddressSlot(_BEACON_SLOT).value = newBeacon;\n }\n\n /**\n * @dev Perform beacon upgrade with additional setup call. Note: This upgrades the address of the beacon, it does\n * not upgrade the implementation contained in the beacon (see {UpgradeableBeacon-_setImplementation} for that).\n *\n * Emits a {BeaconUpgraded} event.\n */\n function _upgradeBeaconToAndCall(address newBeacon, bytes memory data, bool forceCall) internal {\n _setBeacon(newBeacon);\n emit BeaconUpgraded(newBeacon);\n if (data.length > 0 || forceCall) {\n AddressUpgradeable.functionDelegateCall(IBeaconUpgradeable(newBeacon).implementation(), data);\n }\n }\n\n /**\n * @dev This empty reserved space is put in place to allow future versions to add new\n * variables without shifting down storage in the inheritance chain.\n * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps\n */\n uint256[50] private __gap;\n}\n"
- },
- "@openzeppelin/contracts-upgradeable/proxy/utils/Initializable.sol": {
- "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (proxy/utils/Initializable.sol)\n\npragma solidity ^0.8.2;\n\nimport \"../../utils/AddressUpgradeable.sol\";\n\n/**\n * @dev This is a base contract to aid in writing upgradeable contracts, or any kind of contract that will be deployed\n * behind a proxy. Since proxied contracts do not make use of a constructor, it's common to move constructor logic to an\n * external initializer function, usually called `initialize`. It then becomes necessary to protect this initializer\n * function so it can only be called once. The {initializer} modifier provided by this contract will have this effect.\n *\n * The initialization functions use a version number. Once a version number is used, it is consumed and cannot be\n * reused. This mechanism prevents re-execution of each \"step\" but allows the creation of new initialization steps in\n * case an upgrade adds a module that needs to be initialized.\n *\n * For example:\n *\n * [.hljs-theme-light.nopadding]\n * ```solidity\n * contract MyToken is ERC20Upgradeable {\n * function initialize() initializer public {\n * __ERC20_init(\"MyToken\", \"MTK\");\n * }\n * }\n *\n * contract MyTokenV2 is MyToken, ERC20PermitUpgradeable {\n * function initializeV2() reinitializer(2) public {\n * __ERC20Permit_init(\"MyToken\");\n * }\n * }\n * ```\n *\n * TIP: To avoid leaving the proxy in an uninitialized state, the initializer function should be called as early as\n * possible by providing the encoded function call as the `_data` argument to {ERC1967Proxy-constructor}.\n *\n * CAUTION: When used with inheritance, manual care must be taken to not invoke a parent initializer twice, or to ensure\n * that all initializers are idempotent. This is not verified automatically as constructors are by Solidity.\n *\n * [CAUTION]\n * ====\n * Avoid leaving a contract uninitialized.\n *\n * An uninitialized contract can be taken over by an attacker. This applies to both a proxy and its implementation\n * contract, which may impact the proxy. To prevent the implementation contract from being used, you should invoke\n * the {_disableInitializers} function in the constructor to automatically lock it when it is deployed:\n *\n * [.hljs-theme-light.nopadding]\n * ```\n * /// @custom:oz-upgrades-unsafe-allow constructor\n * constructor() {\n * _disableInitializers();\n * }\n * ```\n * ====\n */\nabstract contract Initializable {\n /**\n * @dev Indicates that the contract has been initialized.\n * @custom:oz-retyped-from bool\n */\n uint8 private _initialized;\n\n /**\n * @dev Indicates that the contract is in the process of being initialized.\n */\n bool private _initializing;\n\n /**\n * @dev Triggered when the contract has been initialized or reinitialized.\n */\n event Initialized(uint8 version);\n\n /**\n * @dev A modifier that defines a protected initializer function that can be invoked at most once. In its scope,\n * `onlyInitializing` functions can be used to initialize parent contracts.\n *\n * Similar to `reinitializer(1)`, except that functions marked with `initializer` can be nested in the context of a\n * constructor.\n *\n * Emits an {Initialized} event.\n */\n modifier initializer() {\n bool isTopLevelCall = !_initializing;\n require(\n (isTopLevelCall && _initialized < 1) || (!AddressUpgradeable.isContract(address(this)) && _initialized == 1),\n \"Initializable: contract is already initialized\"\n );\n _initialized = 1;\n if (isTopLevelCall) {\n _initializing = true;\n }\n _;\n if (isTopLevelCall) {\n _initializing = false;\n emit Initialized(1);\n }\n }\n\n /**\n * @dev A modifier that defines a protected reinitializer function that can be invoked at most once, and only if the\n * contract hasn't been initialized to a greater version before. In its scope, `onlyInitializing` functions can be\n * used to initialize parent contracts.\n *\n * A reinitializer may be used after the original initialization step. This is essential to configure modules that\n * are added through upgrades and that require initialization.\n *\n * When `version` is 1, this modifier is similar to `initializer`, except that functions marked with `reinitializer`\n * cannot be nested. If one is invoked in the context of another, execution will revert.\n *\n * Note that versions can jump in increments greater than 1; this implies that if multiple reinitializers coexist in\n * a contract, executing them in the right order is up to the developer or operator.\n *\n * WARNING: setting the version to 255 will prevent any future reinitialization.\n *\n * Emits an {Initialized} event.\n */\n modifier reinitializer(uint8 version) {\n require(!_initializing && _initialized < version, \"Initializable: contract is already initialized\");\n _initialized = version;\n _initializing = true;\n _;\n _initializing = false;\n emit Initialized(version);\n }\n\n /**\n * @dev Modifier to protect an initialization function so that it can only be invoked by functions with the\n * {initializer} and {reinitializer} modifiers, directly or indirectly.\n */\n modifier onlyInitializing() {\n require(_initializing, \"Initializable: contract is not initializing\");\n _;\n }\n\n /**\n * @dev Locks the contract, preventing any future reinitialization. This cannot be part of an initializer call.\n * Calling this in the constructor of a contract will prevent that contract from being initialized or reinitialized\n * to any version. It is recommended to use this to lock implementation contracts that are designed to be called\n * through proxies.\n *\n * Emits an {Initialized} event the first time it is successfully executed.\n */\n function _disableInitializers() internal virtual {\n require(!_initializing, \"Initializable: contract is initializing\");\n if (_initialized != type(uint8).max) {\n _initialized = type(uint8).max;\n emit Initialized(type(uint8).max);\n }\n }\n\n /**\n * @dev Returns the highest version that has been initialized. See {reinitializer}.\n */\n function _getInitializedVersion() internal view returns (uint8) {\n return _initialized;\n }\n\n /**\n * @dev Returns `true` if the contract is currently initializing. See {onlyInitializing}.\n */\n function _isInitializing() internal view returns (bool) {\n return _initializing;\n }\n}\n"
- },
- "@openzeppelin/contracts-upgradeable/proxy/utils/UUPSUpgradeable.sol": {
- "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (proxy/utils/UUPSUpgradeable.sol)\n\npragma solidity ^0.8.0;\n\nimport \"../../interfaces/draft-IERC1822Upgradeable.sol\";\nimport \"../ERC1967/ERC1967UpgradeUpgradeable.sol\";\nimport {Initializable} from \"./Initializable.sol\";\n\n/**\n * @dev An upgradeability mechanism designed for UUPS proxies. The functions included here can perform an upgrade of an\n * {ERC1967Proxy}, when this contract is set as the implementation behind such a proxy.\n *\n * A security mechanism ensures that an upgrade does not turn off upgradeability accidentally, although this risk is\n * reinstated if the upgrade retains upgradeability but removes the security mechanism, e.g. by replacing\n * `UUPSUpgradeable` with a custom implementation of upgrades.\n *\n * The {_authorizeUpgrade} function must be overridden to include access restriction to the upgrade mechanism.\n *\n * _Available since v4.1._\n */\nabstract contract UUPSUpgradeable is Initializable, IERC1822ProxiableUpgradeable, ERC1967UpgradeUpgradeable {\n /// @custom:oz-upgrades-unsafe-allow state-variable-immutable state-variable-assignment\n address private immutable __self = address(this);\n\n /**\n * @dev Check that the execution is being performed through a delegatecall call and that the execution context is\n * a proxy contract with an implementation (as defined in ERC1967) pointing to self. This should only be the case\n * for UUPS and transparent proxies that are using the current contract as their implementation. Execution of a\n * function through ERC1167 minimal proxies (clones) would not normally pass this test, but is not guaranteed to\n * fail.\n */\n modifier onlyProxy() {\n require(address(this) != __self, \"Function must be called through delegatecall\");\n require(_getImplementation() == __self, \"Function must be called through active proxy\");\n _;\n }\n\n /**\n * @dev Check that the execution is not being performed through a delegate call. This allows a function to be\n * callable on the implementing contract but not through proxies.\n */\n modifier notDelegated() {\n require(address(this) == __self, \"UUPSUpgradeable: must not be called through delegatecall\");\n _;\n }\n\n function __UUPSUpgradeable_init() internal onlyInitializing {\n }\n\n function __UUPSUpgradeable_init_unchained() internal onlyInitializing {\n }\n /**\n * @dev Implementation of the ERC1822 {proxiableUUID} function. This returns the storage slot used by the\n * implementation. It is used to validate the implementation's compatibility when performing an upgrade.\n *\n * IMPORTANT: A proxy pointing at a proxiable contract should not be considered proxiable itself, because this risks\n * bricking a proxy that upgrades to it, by delegating to itself until out of gas. Thus it is critical that this\n * function revert if invoked through a proxy. This is guaranteed by the `notDelegated` modifier.\n */\n function proxiableUUID() external view virtual override notDelegated returns (bytes32) {\n return _IMPLEMENTATION_SLOT;\n }\n\n /**\n * @dev Upgrade the implementation of the proxy to `newImplementation`.\n *\n * Calls {_authorizeUpgrade}.\n *\n * Emits an {Upgraded} event.\n *\n * @custom:oz-upgrades-unsafe-allow-reachable delegatecall\n */\n function upgradeTo(address newImplementation) public virtual onlyProxy {\n _authorizeUpgrade(newImplementation);\n _upgradeToAndCallUUPS(newImplementation, new bytes(0), false);\n }\n\n /**\n * @dev Upgrade the implementation of the proxy to `newImplementation`, and subsequently execute the function call\n * encoded in `data`.\n *\n * Calls {_authorizeUpgrade}.\n *\n * Emits an {Upgraded} event.\n *\n * @custom:oz-upgrades-unsafe-allow-reachable delegatecall\n */\n function upgradeToAndCall(address newImplementation, bytes memory data) public payable virtual onlyProxy {\n _authorizeUpgrade(newImplementation);\n _upgradeToAndCallUUPS(newImplementation, data, true);\n }\n\n /**\n * @dev Function that should revert when `msg.sender` is not authorized to upgrade the contract. Called by\n * {upgradeTo} and {upgradeToAndCall}.\n *\n * Normally, this function will use an xref:access.adoc[access control] modifier such as {Ownable-onlyOwner}.\n *\n * ```solidity\n * function _authorizeUpgrade(address) internal override onlyOwner {}\n * ```\n */\n function _authorizeUpgrade(address newImplementation) internal virtual;\n\n /**\n * @dev This empty reserved space is put in place to allow future versions to add new\n * variables without shifting down storage in the inheritance chain.\n * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps\n */\n uint256[50] private __gap;\n}\n"
- },
- "@openzeppelin/contracts-upgradeable/security/ReentrancyGuardUpgradeable.sol": {
- "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (security/ReentrancyGuard.sol)\n\npragma solidity ^0.8.0;\nimport {Initializable} from \"../proxy/utils/Initializable.sol\";\n\n/**\n * @dev Contract module that helps prevent reentrant calls to a function.\n *\n * Inheriting from `ReentrancyGuard` will make the {nonReentrant} modifier\n * available, which can be applied to functions to make sure there are no nested\n * (reentrant) calls to them.\n *\n * Note that because there is a single `nonReentrant` guard, functions marked as\n * `nonReentrant` may not call one another. This can be worked around by making\n * those functions `private`, and then adding `external` `nonReentrant` entry\n * points to them.\n *\n * TIP: If you would like to learn more about reentrancy and alternative ways\n * to protect against it, check out our blog post\n * https://blog.openzeppelin.com/reentrancy-after-istanbul/[Reentrancy After Istanbul].\n */\nabstract contract ReentrancyGuardUpgradeable is Initializable {\n // Booleans are more expensive than uint256 or any type that takes up a full\n // word because each write operation emits an extra SLOAD to first read the\n // slot's contents, replace the bits taken up by the boolean, and then write\n // back. This is the compiler's defense against contract upgrades and\n // pointer aliasing, and it cannot be disabled.\n\n // The values being non-zero value makes deployment a bit more expensive,\n // but in exchange the refund on every call to nonReentrant will be lower in\n // amount. Since refunds are capped to a percentage of the total\n // transaction's gas, it is best to keep them low in cases like this one, to\n // increase the likelihood of the full refund coming into effect.\n uint256 private constant _NOT_ENTERED = 1;\n uint256 private constant _ENTERED = 2;\n\n uint256 private _status;\n\n function __ReentrancyGuard_init() internal onlyInitializing {\n __ReentrancyGuard_init_unchained();\n }\n\n function __ReentrancyGuard_init_unchained() internal onlyInitializing {\n _status = _NOT_ENTERED;\n }\n\n /**\n * @dev Prevents a contract from calling itself, directly or indirectly.\n * Calling a `nonReentrant` function from another `nonReentrant`\n * function is not supported. It is possible to prevent this from happening\n * by making the `nonReentrant` function external, and making it call a\n * `private` function that does the actual work.\n */\n modifier nonReentrant() {\n _nonReentrantBefore();\n _;\n _nonReentrantAfter();\n }\n\n function _nonReentrantBefore() private {\n // On the first call to nonReentrant, _status will be _NOT_ENTERED\n require(_status != _ENTERED, \"ReentrancyGuard: reentrant call\");\n\n // Any calls to nonReentrant after this point will fail\n _status = _ENTERED;\n }\n\n function _nonReentrantAfter() private {\n // By storing the original value once again, a refund is triggered (see\n // https://eips.ethereum.org/EIPS/eip-2200)\n _status = _NOT_ENTERED;\n }\n\n /**\n * @dev Returns true if the reentrancy guard is currently set to \"entered\", which indicates there is a\n * `nonReentrant` function in the call stack.\n */\n function _reentrancyGuardEntered() internal view returns (bool) {\n return _status == _ENTERED;\n }\n\n /**\n * @dev This empty reserved space is put in place to allow future versions to add new\n * variables without shifting down storage in the inheritance chain.\n * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps\n */\n uint256[49] private __gap;\n}\n"
- },
- "@openzeppelin/contracts-upgradeable/token/ERC20/extensions/IERC20PermitUpgradeable.sol": {
- "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.4) (token/ERC20/extensions/IERC20Permit.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @dev Interface of the ERC20 Permit extension allowing approvals to be made via signatures, as defined in\n * https://eips.ethereum.org/EIPS/eip-2612[EIP-2612].\n *\n * Adds the {permit} method, which can be used to change an account's ERC20 allowance (see {IERC20-allowance}) by\n * presenting a message signed by the account. By not relying on {IERC20-approve}, the token holder account doesn't\n * need to send a transaction, and thus is not required to hold Ether at all.\n *\n * ==== Security Considerations\n *\n * There are two important considerations concerning the use of `permit`. The first is that a valid permit signature\n * expresses an allowance, and it should not be assumed to convey additional meaning. In particular, it should not be\n * considered as an intention to spend the allowance in any specific way. The second is that because permits have\n * built-in replay protection and can be submitted by anyone, they can be frontrun. A protocol that uses permits should\n * take this into consideration and allow a `permit` call to fail. Combining these two aspects, a pattern that may be\n * generally recommended is:\n *\n * ```solidity\n * function doThingWithPermit(..., uint256 value, uint256 deadline, uint8 v, bytes32 r, bytes32 s) public {\n * try token.permit(msg.sender, address(this), value, deadline, v, r, s) {} catch {}\n * doThing(..., value);\n * }\n *\n * function doThing(..., uint256 value) public {\n * token.safeTransferFrom(msg.sender, address(this), value);\n * ...\n * }\n * ```\n *\n * Observe that: 1) `msg.sender` is used as the owner, leaving no ambiguity as to the signer intent, and 2) the use of\n * `try/catch` allows the permit to fail and makes the code tolerant to frontrunning. (See also\n * {SafeERC20-safeTransferFrom}).\n *\n * Additionally, note that smart contract wallets (such as Argent or Safe) are not able to produce permit signatures, so\n * contracts should have entry points that don't rely on permit.\n */\ninterface IERC20PermitUpgradeable {\n /**\n * @dev Sets `value` as the allowance of `spender` over ``owner``'s tokens,\n * given ``owner``'s signed approval.\n *\n * IMPORTANT: The same issues {IERC20-approve} has related to transaction\n * ordering also apply here.\n *\n * Emits an {Approval} event.\n *\n * Requirements:\n *\n * - `spender` cannot be the zero address.\n * - `deadline` must be a timestamp in the future.\n * - `v`, `r` and `s` must be a valid `secp256k1` signature from `owner`\n * over the EIP712-formatted function arguments.\n * - the signature must use ``owner``'s current nonce (see {nonces}).\n *\n * For more information on the signature format, see the\n * https://eips.ethereum.org/EIPS/eip-2612#specification[relevant EIP\n * section].\n *\n * CAUTION: See Security Considerations above.\n */\n function permit(\n address owner,\n address spender,\n uint256 value,\n uint256 deadline,\n uint8 v,\n bytes32 r,\n bytes32 s\n ) external;\n\n /**\n * @dev Returns the current nonce for `owner`. This value must be\n * included whenever a signature is generated for {permit}.\n *\n * Every successful call to {permit} increases ``owner``'s nonce by one. This\n * prevents a signature from being used multiple times.\n */\n function nonces(address owner) external view returns (uint256);\n\n /**\n * @dev Returns the domain separator used in the encoding of the signature for {permit}, as defined by {EIP712}.\n */\n // solhint-disable-next-line func-name-mixedcase\n function DOMAIN_SEPARATOR() external view returns (bytes32);\n}\n"
- },
- "@openzeppelin/contracts-upgradeable/token/ERC20/IERC20Upgradeable.sol": {
- "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (token/ERC20/IERC20.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @dev Interface of the ERC20 standard as defined in the EIP.\n */\ninterface IERC20Upgradeable {\n /**\n * @dev Emitted when `value` tokens are moved from one account (`from`) to\n * another (`to`).\n *\n * Note that `value` may be zero.\n */\n event Transfer(address indexed from, address indexed to, uint256 value);\n\n /**\n * @dev Emitted when the allowance of a `spender` for an `owner` is set by\n * a call to {approve}. `value` is the new allowance.\n */\n event Approval(address indexed owner, address indexed spender, uint256 value);\n\n /**\n * @dev Returns the amount of tokens in existence.\n */\n function totalSupply() external view returns (uint256);\n\n /**\n * @dev Returns the amount of tokens owned by `account`.\n */\n function balanceOf(address account) external view returns (uint256);\n\n /**\n * @dev Moves `amount` tokens from the caller's account to `to`.\n *\n * Returns a boolean value indicating whether the operation succeeded.\n *\n * Emits a {Transfer} event.\n */\n function transfer(address to, uint256 amount) external returns (bool);\n\n /**\n * @dev Returns the remaining number of tokens that `spender` will be\n * allowed to spend on behalf of `owner` through {transferFrom}. This is\n * zero by default.\n *\n * This value changes when {approve} or {transferFrom} are called.\n */\n function allowance(address owner, address spender) external view returns (uint256);\n\n /**\n * @dev Sets `amount` as the allowance of `spender` over the caller's tokens.\n *\n * Returns a boolean value indicating whether the operation succeeded.\n *\n * IMPORTANT: Beware that changing an allowance with this method brings the risk\n * that someone may use both the old and the new allowance by unfortunate\n * transaction ordering. One possible solution to mitigate this race\n * condition is to first reduce the spender's allowance to 0 and set the\n * desired value afterwards:\n * https://github.com/ethereum/EIPs/issues/20#issuecomment-263524729\n *\n * Emits an {Approval} event.\n */\n function approve(address spender, uint256 amount) external returns (bool);\n\n /**\n * @dev Moves `amount` tokens from `from` to `to` using the\n * allowance mechanism. `amount` is then deducted from the caller's\n * allowance.\n *\n * Returns a boolean value indicating whether the operation succeeded.\n *\n * Emits a {Transfer} event.\n */\n function transferFrom(address from, address to, uint256 amount) external returns (bool);\n}\n"
- },
- "@openzeppelin/contracts-upgradeable/token/ERC20/utils/SafeERC20Upgradeable.sol": {
- "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.3) (token/ERC20/utils/SafeERC20.sol)\n\npragma solidity ^0.8.0;\n\nimport \"../IERC20Upgradeable.sol\";\nimport \"../extensions/IERC20PermitUpgradeable.sol\";\nimport \"../../../utils/AddressUpgradeable.sol\";\n\n/**\n * @title SafeERC20\n * @dev Wrappers around ERC20 operations that throw on failure (when the token\n * contract returns false). Tokens that return no value (and instead revert or\n * throw on failure) are also supported, non-reverting calls are assumed to be\n * successful.\n * To use this library you can add a `using SafeERC20 for IERC20;` statement to your contract,\n * which allows you to call the safe operations as `token.safeTransfer(...)`, etc.\n */\nlibrary SafeERC20Upgradeable {\n using AddressUpgradeable for address;\n\n /**\n * @dev Transfer `value` amount of `token` from the calling contract to `to`. If `token` returns no value,\n * non-reverting calls are assumed to be successful.\n */\n function safeTransfer(IERC20Upgradeable token, address to, uint256 value) internal {\n _callOptionalReturn(token, abi.encodeWithSelector(token.transfer.selector, to, value));\n }\n\n /**\n * @dev Transfer `value` amount of `token` from `from` to `to`, spending the approval given by `from` to the\n * calling contract. If `token` returns no value, non-reverting calls are assumed to be successful.\n */\n function safeTransferFrom(IERC20Upgradeable token, address from, address to, uint256 value) internal {\n _callOptionalReturn(token, abi.encodeWithSelector(token.transferFrom.selector, from, to, value));\n }\n\n /**\n * @dev Deprecated. This function has issues similar to the ones found in\n * {IERC20-approve}, and its usage is discouraged.\n *\n * Whenever possible, use {safeIncreaseAllowance} and\n * {safeDecreaseAllowance} instead.\n */\n function safeApprove(IERC20Upgradeable token, address spender, uint256 value) internal {\n // safeApprove should only be called when setting an initial allowance,\n // or when resetting it to zero. To increase and decrease it, use\n // 'safeIncreaseAllowance' and 'safeDecreaseAllowance'\n require(\n (value == 0) || (token.allowance(address(this), spender) == 0),\n \"SafeERC20: approve from non-zero to non-zero allowance\"\n );\n _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, value));\n }\n\n /**\n * @dev Increase the calling contract's allowance toward `spender` by `value`. If `token` returns no value,\n * non-reverting calls are assumed to be successful.\n */\n function safeIncreaseAllowance(IERC20Upgradeable token, address spender, uint256 value) internal {\n uint256 oldAllowance = token.allowance(address(this), spender);\n _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, oldAllowance + value));\n }\n\n /**\n * @dev Decrease the calling contract's allowance toward `spender` by `value`. If `token` returns no value,\n * non-reverting calls are assumed to be successful.\n */\n function safeDecreaseAllowance(IERC20Upgradeable token, address spender, uint256 value) internal {\n unchecked {\n uint256 oldAllowance = token.allowance(address(this), spender);\n require(oldAllowance >= value, \"SafeERC20: decreased allowance below zero\");\n _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, oldAllowance - value));\n }\n }\n\n /**\n * @dev Set the calling contract's allowance toward `spender` to `value`. If `token` returns no value,\n * non-reverting calls are assumed to be successful. Meant to be used with tokens that require the approval\n * to be set to zero before setting it to a non-zero value, such as USDT.\n */\n function forceApprove(IERC20Upgradeable token, address spender, uint256 value) internal {\n bytes memory approvalCall = abi.encodeWithSelector(token.approve.selector, spender, value);\n\n if (!_callOptionalReturnBool(token, approvalCall)) {\n _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, 0));\n _callOptionalReturn(token, approvalCall);\n }\n }\n\n /**\n * @dev Use a ERC-2612 signature to set the `owner` approval toward `spender` on `token`.\n * Revert on invalid signature.\n */\n function safePermit(\n IERC20PermitUpgradeable token,\n address owner,\n address spender,\n uint256 value,\n uint256 deadline,\n uint8 v,\n bytes32 r,\n bytes32 s\n ) internal {\n uint256 nonceBefore = token.nonces(owner);\n token.permit(owner, spender, value, deadline, v, r, s);\n uint256 nonceAfter = token.nonces(owner);\n require(nonceAfter == nonceBefore + 1, \"SafeERC20: permit did not succeed\");\n }\n\n /**\n * @dev Imitates a Solidity high-level call (i.e. a regular function call to a contract), relaxing the requirement\n * on the return value: the return value is optional (but if data is returned, it must not be false).\n * @param token The token targeted by the call.\n * @param data The call data (encoded using abi.encode or one of its variants).\n */\n function _callOptionalReturn(IERC20Upgradeable token, bytes memory data) private {\n // We need to perform a low level call here, to bypass Solidity's return data size checking mechanism, since\n // we're implementing it ourselves. We use {Address-functionCall} to perform this call, which verifies that\n // the target address contains contract code and also asserts for success in the low-level call.\n\n bytes memory returndata = address(token).functionCall(data, \"SafeERC20: low-level call failed\");\n require(returndata.length == 0 || abi.decode(returndata, (bool)), \"SafeERC20: ERC20 operation did not succeed\");\n }\n\n /**\n * @dev Imitates a Solidity high-level call (i.e. a regular function call to a contract), relaxing the requirement\n * on the return value: the return value is optional (but if data is returned, it must not be false).\n * @param token The token targeted by the call.\n * @param data The call data (encoded using abi.encode or one of its variants).\n *\n * This is a variant of {_callOptionalReturn} that silents catches all reverts and returns a bool instead.\n */\n function _callOptionalReturnBool(IERC20Upgradeable token, bytes memory data) private returns (bool) {\n // We need to perform a low level call here, to bypass Solidity's return data size checking mechanism, since\n // we're implementing it ourselves. We cannot use {Address-functionCall} here since this should return false\n // and not revert is the subcall reverts.\n\n (bool success, bytes memory returndata) = address(token).call(data);\n return\n success && (returndata.length == 0 || abi.decode(returndata, (bool))) && AddressUpgradeable.isContract(address(token));\n }\n}\n"
- },
- "@openzeppelin/contracts-upgradeable/utils/AddressUpgradeable.sol": {
- "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (utils/Address.sol)\n\npragma solidity ^0.8.1;\n\n/**\n * @dev Collection of functions related to the address type\n */\nlibrary AddressUpgradeable {\n /**\n * @dev Returns true if `account` is a contract.\n *\n * [IMPORTANT]\n * ====\n * It is unsafe to assume that an address for which this function returns\n * false is an externally-owned account (EOA) and not a contract.\n *\n * Among others, `isContract` will return false for the following\n * types of addresses:\n *\n * - an externally-owned account\n * - a contract in construction\n * - an address where a contract will be created\n * - an address where a contract lived, but was destroyed\n *\n * Furthermore, `isContract` will also return true if the target contract within\n * the same transaction is already scheduled for destruction by `SELFDESTRUCT`,\n * which only has an effect at the end of a transaction.\n * ====\n *\n * [IMPORTANT]\n * ====\n * You shouldn't rely on `isContract` to protect against flash loan attacks!\n *\n * Preventing calls from contracts is highly discouraged. It breaks composability, breaks support for smart wallets\n * like Gnosis Safe, and does not provide security since it can be circumvented by calling from a contract\n * constructor.\n * ====\n */\n function isContract(address account) internal view returns (bool) {\n // This method relies on extcodesize/address.code.length, which returns 0\n // for contracts in construction, since the code is only stored at the end\n // of the constructor execution.\n\n return account.code.length > 0;\n }\n\n /**\n * @dev Replacement for Solidity's `transfer`: sends `amount` wei to\n * `recipient`, forwarding all available gas and reverting on errors.\n *\n * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost\n * of certain opcodes, possibly making contracts go over the 2300 gas limit\n * imposed by `transfer`, making them unable to receive funds via\n * `transfer`. {sendValue} removes this limitation.\n *\n * https://consensys.net/diligence/blog/2019/09/stop-using-soliditys-transfer-now/[Learn more].\n *\n * IMPORTANT: because control is transferred to `recipient`, care must be\n * taken to not create reentrancy vulnerabilities. Consider using\n * {ReentrancyGuard} or the\n * https://solidity.readthedocs.io/en/v0.8.0/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].\n */\n function sendValue(address payable recipient, uint256 amount) internal {\n require(address(this).balance >= amount, \"Address: insufficient balance\");\n\n (bool success, ) = recipient.call{value: amount}(\"\");\n require(success, \"Address: unable to send value, recipient may have reverted\");\n }\n\n /**\n * @dev Performs a Solidity function call using a low level `call`. A\n * plain `call` is an unsafe replacement for a function call: use this\n * function instead.\n *\n * If `target` reverts with a revert reason, it is bubbled up by this\n * function (like regular Solidity function calls).\n *\n * Returns the raw returned data. To convert to the expected return value,\n * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].\n *\n * Requirements:\n *\n * - `target` must be a contract.\n * - calling `target` with `data` must not revert.\n *\n * _Available since v3.1._\n */\n function functionCall(address target, bytes memory data) internal returns (bytes memory) {\n return functionCallWithValue(target, data, 0, \"Address: low-level call failed\");\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with\n * `errorMessage` as a fallback revert reason when `target` reverts.\n *\n * _Available since v3.1._\n */\n function functionCall(\n address target,\n bytes memory data,\n string memory errorMessage\n ) internal returns (bytes memory) {\n return functionCallWithValue(target, data, 0, errorMessage);\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\n * but also transferring `value` wei to `target`.\n *\n * Requirements:\n *\n * - the calling contract must have an ETH balance of at least `value`.\n * - the called Solidity function must be `payable`.\n *\n * _Available since v3.1._\n */\n function functionCallWithValue(address target, bytes memory data, uint256 value) internal returns (bytes memory) {\n return functionCallWithValue(target, data, value, \"Address: low-level call with value failed\");\n }\n\n /**\n * @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but\n * with `errorMessage` as a fallback revert reason when `target` reverts.\n *\n * _Available since v3.1._\n */\n function functionCallWithValue(\n address target,\n bytes memory data,\n uint256 value,\n string memory errorMessage\n ) internal returns (bytes memory) {\n require(address(this).balance >= value, \"Address: insufficient balance for call\");\n (bool success, bytes memory returndata) = target.call{value: value}(data);\n return verifyCallResultFromTarget(target, success, returndata, errorMessage);\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\n * but performing a static call.\n *\n * _Available since v3.3._\n */\n function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {\n return functionStaticCall(target, data, \"Address: low-level static call failed\");\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],\n * but performing a static call.\n *\n * _Available since v3.3._\n */\n function functionStaticCall(\n address target,\n bytes memory data,\n string memory errorMessage\n ) internal view returns (bytes memory) {\n (bool success, bytes memory returndata) = target.staticcall(data);\n return verifyCallResultFromTarget(target, success, returndata, errorMessage);\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\n * but performing a delegate call.\n *\n * _Available since v3.4._\n */\n function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) {\n return functionDelegateCall(target, data, \"Address: low-level delegate call failed\");\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],\n * but performing a delegate call.\n *\n * _Available since v3.4._\n */\n function functionDelegateCall(\n address target,\n bytes memory data,\n string memory errorMessage\n ) internal returns (bytes memory) {\n (bool success, bytes memory returndata) = target.delegatecall(data);\n return verifyCallResultFromTarget(target, success, returndata, errorMessage);\n }\n\n /**\n * @dev Tool to verify that a low level call to smart-contract was successful, and revert (either by bubbling\n * the revert reason or using the provided one) in case of unsuccessful call or if target was not a contract.\n *\n * _Available since v4.8._\n */\n function verifyCallResultFromTarget(\n address target,\n bool success,\n bytes memory returndata,\n string memory errorMessage\n ) internal view returns (bytes memory) {\n if (success) {\n if (returndata.length == 0) {\n // only check isContract if the call was successful and the return data is empty\n // otherwise we already know that it was a contract\n require(isContract(target), \"Address: call to non-contract\");\n }\n return returndata;\n } else {\n _revert(returndata, errorMessage);\n }\n }\n\n /**\n * @dev Tool to verify that a low level call was successful, and revert if it wasn't, either by bubbling the\n * revert reason or using the provided one.\n *\n * _Available since v4.3._\n */\n function verifyCallResult(\n bool success,\n bytes memory returndata,\n string memory errorMessage\n ) internal pure returns (bytes memory) {\n if (success) {\n return returndata;\n } else {\n _revert(returndata, errorMessage);\n }\n }\n\n function _revert(bytes memory returndata, string memory errorMessage) private pure {\n // Look for revert reason and bubble it up if present\n if (returndata.length > 0) {\n // The easiest way to bubble the revert reason is using memory via assembly\n /// @solidity memory-safe-assembly\n assembly {\n let returndata_size := mload(returndata)\n revert(add(32, returndata), returndata_size)\n }\n } else {\n revert(errorMessage);\n }\n }\n}\n"
- },
- "@openzeppelin/contracts-upgradeable/utils/cryptography/ECDSAUpgradeable.sol": {
- "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (utils/cryptography/ECDSA.sol)\n\npragma solidity ^0.8.0;\n\nimport \"../StringsUpgradeable.sol\";\n\n/**\n * @dev Elliptic Curve Digital Signature Algorithm (ECDSA) operations.\n *\n * These functions can be used to verify that a message was signed by the holder\n * of the private keys of a given address.\n */\nlibrary ECDSAUpgradeable {\n enum RecoverError {\n NoError,\n InvalidSignature,\n InvalidSignatureLength,\n InvalidSignatureS,\n InvalidSignatureV // Deprecated in v4.8\n }\n\n function _throwError(RecoverError error) private pure {\n if (error == RecoverError.NoError) {\n return; // no error: do nothing\n } else if (error == RecoverError.InvalidSignature) {\n revert(\"ECDSA: invalid signature\");\n } else if (error == RecoverError.InvalidSignatureLength) {\n revert(\"ECDSA: invalid signature length\");\n } else if (error == RecoverError.InvalidSignatureS) {\n revert(\"ECDSA: invalid signature 's' value\");\n }\n }\n\n /**\n * @dev Returns the address that signed a hashed message (`hash`) with\n * `signature` or error string. This address can then be used for verification purposes.\n *\n * The `ecrecover` EVM opcode allows for malleable (non-unique) signatures:\n * this function rejects them by requiring the `s` value to be in the lower\n * half order, and the `v` value to be either 27 or 28.\n *\n * IMPORTANT: `hash` _must_ be the result of a hash operation for the\n * verification to be secure: it is possible to craft signatures that\n * recover to arbitrary addresses for non-hashed data. A safe way to ensure\n * this is by receiving a hash of the original message (which may otherwise\n * be too long), and then calling {toEthSignedMessageHash} on it.\n *\n * Documentation for signature generation:\n * - with https://web3js.readthedocs.io/en/v1.3.4/web3-eth-accounts.html#sign[Web3.js]\n * - with https://docs.ethers.io/v5/api/signer/#Signer-signMessage[ethers]\n *\n * _Available since v4.3._\n */\n function tryRecover(bytes32 hash, bytes memory signature) internal pure returns (address, RecoverError) {\n if (signature.length == 65) {\n bytes32 r;\n bytes32 s;\n uint8 v;\n // ecrecover takes the signature parameters, and the only way to get them\n // currently is to use assembly.\n /// @solidity memory-safe-assembly\n assembly {\n r := mload(add(signature, 0x20))\n s := mload(add(signature, 0x40))\n v := byte(0, mload(add(signature, 0x60)))\n }\n return tryRecover(hash, v, r, s);\n } else {\n return (address(0), RecoverError.InvalidSignatureLength);\n }\n }\n\n /**\n * @dev Returns the address that signed a hashed message (`hash`) with\n * `signature`. This address can then be used for verification purposes.\n *\n * The `ecrecover` EVM opcode allows for malleable (non-unique) signatures:\n * this function rejects them by requiring the `s` value to be in the lower\n * half order, and the `v` value to be either 27 or 28.\n *\n * IMPORTANT: `hash` _must_ be the result of a hash operation for the\n * verification to be secure: it is possible to craft signatures that\n * recover to arbitrary addresses for non-hashed data. A safe way to ensure\n * this is by receiving a hash of the original message (which may otherwise\n * be too long), and then calling {toEthSignedMessageHash} on it.\n */\n function recover(bytes32 hash, bytes memory signature) internal pure returns (address) {\n (address recovered, RecoverError error) = tryRecover(hash, signature);\n _throwError(error);\n return recovered;\n }\n\n /**\n * @dev Overload of {ECDSA-tryRecover} that receives the `r` and `vs` short-signature fields separately.\n *\n * See https://eips.ethereum.org/EIPS/eip-2098[EIP-2098 short signatures]\n *\n * _Available since v4.3._\n */\n function tryRecover(bytes32 hash, bytes32 r, bytes32 vs) internal pure returns (address, RecoverError) {\n bytes32 s = vs & bytes32(0x7fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff);\n uint8 v = uint8((uint256(vs) >> 255) + 27);\n return tryRecover(hash, v, r, s);\n }\n\n /**\n * @dev Overload of {ECDSA-recover} that receives the `r and `vs` short-signature fields separately.\n *\n * _Available since v4.2._\n */\n function recover(bytes32 hash, bytes32 r, bytes32 vs) internal pure returns (address) {\n (address recovered, RecoverError error) = tryRecover(hash, r, vs);\n _throwError(error);\n return recovered;\n }\n\n /**\n * @dev Overload of {ECDSA-tryRecover} that receives the `v`,\n * `r` and `s` signature fields separately.\n *\n * _Available since v4.3._\n */\n function tryRecover(bytes32 hash, uint8 v, bytes32 r, bytes32 s) internal pure returns (address, RecoverError) {\n // EIP-2 still allows signature malleability for ecrecover(). Remove this possibility and make the signature\n // unique. Appendix F in the Ethereum Yellow paper (https://ethereum.github.io/yellowpaper/paper.pdf), defines\n // the valid range for s in (301): 0 < s < secp256k1n ÷ 2 + 1, and for v in (302): v ∈ {27, 28}. Most\n // signatures from current libraries generate a unique signature with an s-value in the lower half order.\n //\n // If your library generates malleable signatures, such as s-values in the upper range, calculate a new s-value\n // with 0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFEBAAEDCE6AF48A03BBFD25E8CD0364141 - s1 and flip v from 27 to 28 or\n // vice versa. If your library also generates signatures with 0/1 for v instead 27/28, add 27 to v to accept\n // these malleable signatures as well.\n if (uint256(s) > 0x7FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF5D576E7357A4501DDFE92F46681B20A0) {\n return (address(0), RecoverError.InvalidSignatureS);\n }\n\n // If the signature is valid (and not malleable), return the signer address\n address signer = ecrecover(hash, v, r, s);\n if (signer == address(0)) {\n return (address(0), RecoverError.InvalidSignature);\n }\n\n return (signer, RecoverError.NoError);\n }\n\n /**\n * @dev Overload of {ECDSA-recover} that receives the `v`,\n * `r` and `s` signature fields separately.\n */\n function recover(bytes32 hash, uint8 v, bytes32 r, bytes32 s) internal pure returns (address) {\n (address recovered, RecoverError error) = tryRecover(hash, v, r, s);\n _throwError(error);\n return recovered;\n }\n\n /**\n * @dev Returns an Ethereum Signed Message, created from a `hash`. This\n * produces hash corresponding to the one signed with the\n * https://eth.wiki/json-rpc/API#eth_sign[`eth_sign`]\n * JSON-RPC method as part of EIP-191.\n *\n * See {recover}.\n */\n function toEthSignedMessageHash(bytes32 hash) internal pure returns (bytes32 message) {\n // 32 is the length in bytes of hash,\n // enforced by the type signature above\n /// @solidity memory-safe-assembly\n assembly {\n mstore(0x00, \"\\x19Ethereum Signed Message:\\n32\")\n mstore(0x1c, hash)\n message := keccak256(0x00, 0x3c)\n }\n }\n\n /**\n * @dev Returns an Ethereum Signed Message, created from `s`. This\n * produces hash corresponding to the one signed with the\n * https://eth.wiki/json-rpc/API#eth_sign[`eth_sign`]\n * JSON-RPC method as part of EIP-191.\n *\n * See {recover}.\n */\n function toEthSignedMessageHash(bytes memory s) internal pure returns (bytes32) {\n return keccak256(abi.encodePacked(\"\\x19Ethereum Signed Message:\\n\", StringsUpgradeable.toString(s.length), s));\n }\n\n /**\n * @dev Returns an Ethereum Signed Typed Data, created from a\n * `domainSeparator` and a `structHash`. This produces hash corresponding\n * to the one signed with the\n * https://eips.ethereum.org/EIPS/eip-712[`eth_signTypedData`]\n * JSON-RPC method as part of EIP-712.\n *\n * See {recover}.\n */\n function toTypedDataHash(bytes32 domainSeparator, bytes32 structHash) internal pure returns (bytes32 data) {\n /// @solidity memory-safe-assembly\n assembly {\n let ptr := mload(0x40)\n mstore(ptr, \"\\x19\\x01\")\n mstore(add(ptr, 0x02), domainSeparator)\n mstore(add(ptr, 0x22), structHash)\n data := keccak256(ptr, 0x42)\n }\n }\n\n /**\n * @dev Returns an Ethereum Signed Data with intended validator, created from a\n * `validator` and `data` according to the version 0 of EIP-191.\n *\n * See {recover}.\n */\n function toDataWithIntendedValidatorHash(address validator, bytes memory data) internal pure returns (bytes32) {\n return keccak256(abi.encodePacked(\"\\x19\\x00\", validator, data));\n }\n}\n"
- },
- "@openzeppelin/contracts-upgradeable/utils/math/MathUpgradeable.sol": {
- "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (utils/math/Math.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @dev Standard math utilities missing in the Solidity language.\n */\nlibrary MathUpgradeable {\n enum Rounding {\n Down, // Toward negative infinity\n Up, // Toward infinity\n Zero // Toward zero\n }\n\n /**\n * @dev Returns the largest of two numbers.\n */\n function max(uint256 a, uint256 b) internal pure returns (uint256) {\n return a > b ? a : b;\n }\n\n /**\n * @dev Returns the smallest of two numbers.\n */\n function min(uint256 a, uint256 b) internal pure returns (uint256) {\n return a < b ? a : b;\n }\n\n /**\n * @dev Returns the average of two numbers. The result is rounded towards\n * zero.\n */\n function average(uint256 a, uint256 b) internal pure returns (uint256) {\n // (a + b) / 2 can overflow.\n return (a & b) + (a ^ b) / 2;\n }\n\n /**\n * @dev Returns the ceiling of the division of two numbers.\n *\n * This differs from standard division with `/` in that it rounds up instead\n * of rounding down.\n */\n function ceilDiv(uint256 a, uint256 b) internal pure returns (uint256) {\n // (a + b - 1) / b can overflow on addition, so we distribute.\n return a == 0 ? 0 : (a - 1) / b + 1;\n }\n\n /**\n * @notice Calculates floor(x * y / denominator) with full precision. Throws if result overflows a uint256 or denominator == 0\n * @dev Original credit to Remco Bloemen under MIT license (https://xn--2-umb.com/21/muldiv)\n * with further edits by Uniswap Labs also under MIT license.\n */\n function mulDiv(uint256 x, uint256 y, uint256 denominator) internal pure returns (uint256 result) {\n unchecked {\n // 512-bit multiply [prod1 prod0] = x * y. Compute the product mod 2^256 and mod 2^256 - 1, then use\n // use the Chinese Remainder Theorem to reconstruct the 512 bit result. The result is stored in two 256\n // variables such that product = prod1 * 2^256 + prod0.\n uint256 prod0; // Least significant 256 bits of the product\n uint256 prod1; // Most significant 256 bits of the product\n assembly {\n let mm := mulmod(x, y, not(0))\n prod0 := mul(x, y)\n prod1 := sub(sub(mm, prod0), lt(mm, prod0))\n }\n\n // Handle non-overflow cases, 256 by 256 division.\n if (prod1 == 0) {\n // Solidity will revert if denominator == 0, unlike the div opcode on its own.\n // The surrounding unchecked block does not change this fact.\n // See https://docs.soliditylang.org/en/latest/control-structures.html#checked-or-unchecked-arithmetic.\n return prod0 / denominator;\n }\n\n // Make sure the result is less than 2^256. Also prevents denominator == 0.\n require(denominator > prod1, \"Math: mulDiv overflow\");\n\n ///////////////////////////////////////////////\n // 512 by 256 division.\n ///////////////////////////////////////////////\n\n // Make division exact by subtracting the remainder from [prod1 prod0].\n uint256 remainder;\n assembly {\n // Compute remainder using mulmod.\n remainder := mulmod(x, y, denominator)\n\n // Subtract 256 bit number from 512 bit number.\n prod1 := sub(prod1, gt(remainder, prod0))\n prod0 := sub(prod0, remainder)\n }\n\n // Factor powers of two out of denominator and compute largest power of two divisor of denominator. Always >= 1.\n // See https://cs.stackexchange.com/q/138556/92363.\n\n // Does not overflow because the denominator cannot be zero at this stage in the function.\n uint256 twos = denominator & (~denominator + 1);\n assembly {\n // Divide denominator by twos.\n denominator := div(denominator, twos)\n\n // Divide [prod1 prod0] by twos.\n prod0 := div(prod0, twos)\n\n // Flip twos such that it is 2^256 / twos. If twos is zero, then it becomes one.\n twos := add(div(sub(0, twos), twos), 1)\n }\n\n // Shift in bits from prod1 into prod0.\n prod0 |= prod1 * twos;\n\n // Invert denominator mod 2^256. Now that denominator is an odd number, it has an inverse modulo 2^256 such\n // that denominator * inv = 1 mod 2^256. Compute the inverse by starting with a seed that is correct for\n // four bits. That is, denominator * inv = 1 mod 2^4.\n uint256 inverse = (3 * denominator) ^ 2;\n\n // Use the Newton-Raphson iteration to improve the precision. Thanks to Hensel's lifting lemma, this also works\n // in modular arithmetic, doubling the correct bits in each step.\n inverse *= 2 - denominator * inverse; // inverse mod 2^8\n inverse *= 2 - denominator * inverse; // inverse mod 2^16\n inverse *= 2 - denominator * inverse; // inverse mod 2^32\n inverse *= 2 - denominator * inverse; // inverse mod 2^64\n inverse *= 2 - denominator * inverse; // inverse mod 2^128\n inverse *= 2 - denominator * inverse; // inverse mod 2^256\n\n // Because the division is now exact we can divide by multiplying with the modular inverse of denominator.\n // This will give us the correct result modulo 2^256. Since the preconditions guarantee that the outcome is\n // less than 2^256, this is the final result. We don't need to compute the high bits of the result and prod1\n // is no longer required.\n result = prod0 * inverse;\n return result;\n }\n }\n\n /**\n * @notice Calculates x * y / denominator with full precision, following the selected rounding direction.\n */\n function mulDiv(uint256 x, uint256 y, uint256 denominator, Rounding rounding) internal pure returns (uint256) {\n uint256 result = mulDiv(x, y, denominator);\n if (rounding == Rounding.Up && mulmod(x, y, denominator) > 0) {\n result += 1;\n }\n return result;\n }\n\n /**\n * @dev Returns the square root of a number. If the number is not a perfect square, the value is rounded down.\n *\n * Inspired by Henry S. Warren, Jr.'s \"Hacker's Delight\" (Chapter 11).\n */\n function sqrt(uint256 a) internal pure returns (uint256) {\n if (a == 0) {\n return 0;\n }\n\n // For our first guess, we get the biggest power of 2 which is smaller than the square root of the target.\n //\n // We know that the \"msb\" (most significant bit) of our target number `a` is a power of 2 such that we have\n // `msb(a) <= a < 2*msb(a)`. This value can be written `msb(a)=2**k` with `k=log2(a)`.\n //\n // This can be rewritten `2**log2(a) <= a < 2**(log2(a) + 1)`\n // → `sqrt(2**k) <= sqrt(a) < sqrt(2**(k+1))`\n // → `2**(k/2) <= sqrt(a) < 2**((k+1)/2) <= 2**(k/2 + 1)`\n //\n // Consequently, `2**(log2(a) / 2)` is a good first approximation of `sqrt(a)` with at least 1 correct bit.\n uint256 result = 1 << (log2(a) >> 1);\n\n // At this point `result` is an estimation with one bit of precision. We know the true value is a uint128,\n // since it is the square root of a uint256. Newton's method converges quadratically (precision doubles at\n // every iteration). We thus need at most 7 iteration to turn our partial result with one bit of precision\n // into the expected uint128 result.\n unchecked {\n result = (result + a / result) >> 1;\n result = (result + a / result) >> 1;\n result = (result + a / result) >> 1;\n result = (result + a / result) >> 1;\n result = (result + a / result) >> 1;\n result = (result + a / result) >> 1;\n result = (result + a / result) >> 1;\n return min(result, a / result);\n }\n }\n\n /**\n * @notice Calculates sqrt(a), following the selected rounding direction.\n */\n function sqrt(uint256 a, Rounding rounding) internal pure returns (uint256) {\n unchecked {\n uint256 result = sqrt(a);\n return result + (rounding == Rounding.Up && result * result < a ? 1 : 0);\n }\n }\n\n /**\n * @dev Return the log in base 2, rounded down, of a positive value.\n * Returns 0 if given 0.\n */\n function log2(uint256 value) internal pure returns (uint256) {\n uint256 result = 0;\n unchecked {\n if (value >> 128 > 0) {\n value >>= 128;\n result += 128;\n }\n if (value >> 64 > 0) {\n value >>= 64;\n result += 64;\n }\n if (value >> 32 > 0) {\n value >>= 32;\n result += 32;\n }\n if (value >> 16 > 0) {\n value >>= 16;\n result += 16;\n }\n if (value >> 8 > 0) {\n value >>= 8;\n result += 8;\n }\n if (value >> 4 > 0) {\n value >>= 4;\n result += 4;\n }\n if (value >> 2 > 0) {\n value >>= 2;\n result += 2;\n }\n if (value >> 1 > 0) {\n result += 1;\n }\n }\n return result;\n }\n\n /**\n * @dev Return the log in base 2, following the selected rounding direction, of a positive value.\n * Returns 0 if given 0.\n */\n function log2(uint256 value, Rounding rounding) internal pure returns (uint256) {\n unchecked {\n uint256 result = log2(value);\n return result + (rounding == Rounding.Up && 1 << result < value ? 1 : 0);\n }\n }\n\n /**\n * @dev Return the log in base 10, rounded down, of a positive value.\n * Returns 0 if given 0.\n */\n function log10(uint256 value) internal pure returns (uint256) {\n uint256 result = 0;\n unchecked {\n if (value >= 10 ** 64) {\n value /= 10 ** 64;\n result += 64;\n }\n if (value >= 10 ** 32) {\n value /= 10 ** 32;\n result += 32;\n }\n if (value >= 10 ** 16) {\n value /= 10 ** 16;\n result += 16;\n }\n if (value >= 10 ** 8) {\n value /= 10 ** 8;\n result += 8;\n }\n if (value >= 10 ** 4) {\n value /= 10 ** 4;\n result += 4;\n }\n if (value >= 10 ** 2) {\n value /= 10 ** 2;\n result += 2;\n }\n if (value >= 10 ** 1) {\n result += 1;\n }\n }\n return result;\n }\n\n /**\n * @dev Return the log in base 10, following the selected rounding direction, of a positive value.\n * Returns 0 if given 0.\n */\n function log10(uint256 value, Rounding rounding) internal pure returns (uint256) {\n unchecked {\n uint256 result = log10(value);\n return result + (rounding == Rounding.Up && 10 ** result < value ? 1 : 0);\n }\n }\n\n /**\n * @dev Return the log in base 256, rounded down, of a positive value.\n * Returns 0 if given 0.\n *\n * Adding one to the result gives the number of pairs of hex symbols needed to represent `value` as a hex string.\n */\n function log256(uint256 value) internal pure returns (uint256) {\n uint256 result = 0;\n unchecked {\n if (value >> 128 > 0) {\n value >>= 128;\n result += 16;\n }\n if (value >> 64 > 0) {\n value >>= 64;\n result += 8;\n }\n if (value >> 32 > 0) {\n value >>= 32;\n result += 4;\n }\n if (value >> 16 > 0) {\n value >>= 16;\n result += 2;\n }\n if (value >> 8 > 0) {\n result += 1;\n }\n }\n return result;\n }\n\n /**\n * @dev Return the log in base 256, following the selected rounding direction, of a positive value.\n * Returns 0 if given 0.\n */\n function log256(uint256 value, Rounding rounding) internal pure returns (uint256) {\n unchecked {\n uint256 result = log256(value);\n return result + (rounding == Rounding.Up && 1 << (result << 3) < value ? 1 : 0);\n }\n }\n}\n"
- },
- "@openzeppelin/contracts-upgradeable/utils/math/SignedMathUpgradeable.sol": {
- "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.8.0) (utils/math/SignedMath.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @dev Standard signed math utilities missing in the Solidity language.\n */\nlibrary SignedMathUpgradeable {\n /**\n * @dev Returns the largest of two signed numbers.\n */\n function max(int256 a, int256 b) internal pure returns (int256) {\n return a > b ? a : b;\n }\n\n /**\n * @dev Returns the smallest of two signed numbers.\n */\n function min(int256 a, int256 b) internal pure returns (int256) {\n return a < b ? a : b;\n }\n\n /**\n * @dev Returns the average of two signed numbers without overflow.\n * The result is rounded towards zero.\n */\n function average(int256 a, int256 b) internal pure returns (int256) {\n // Formula from the book \"Hacker's Delight\"\n int256 x = (a & b) + ((a ^ b) >> 1);\n return x + (int256(uint256(x) >> 255) & (a ^ b));\n }\n\n /**\n * @dev Returns the absolute unsigned value of a signed value.\n */\n function abs(int256 n) internal pure returns (uint256) {\n unchecked {\n // must be unchecked in order to support `n = type(int256).min`\n return uint256(n >= 0 ? n : -n);\n }\n }\n}\n"
- },
- "@openzeppelin/contracts-upgradeable/utils/StorageSlotUpgradeable.sol": {
- "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (utils/StorageSlot.sol)\n// This file was procedurally generated from scripts/generate/templates/StorageSlot.js.\n\npragma solidity ^0.8.0;\n\n/**\n * @dev Library for reading and writing primitive types to specific storage slots.\n *\n * Storage slots are often used to avoid storage conflict when dealing with upgradeable contracts.\n * This library helps with reading and writing to such slots without the need for inline assembly.\n *\n * The functions in this library return Slot structs that contain a `value` member that can be used to read or write.\n *\n * Example usage to set ERC1967 implementation slot:\n * ```solidity\n * contract ERC1967 {\n * bytes32 internal constant _IMPLEMENTATION_SLOT = 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc;\n *\n * function _getImplementation() internal view returns (address) {\n * return StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value;\n * }\n *\n * function _setImplementation(address newImplementation) internal {\n * require(Address.isContract(newImplementation), \"ERC1967: new implementation is not a contract\");\n * StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value = newImplementation;\n * }\n * }\n * ```\n *\n * _Available since v4.1 for `address`, `bool`, `bytes32`, `uint256`._\n * _Available since v4.9 for `string`, `bytes`._\n */\nlibrary StorageSlotUpgradeable {\n struct AddressSlot {\n address value;\n }\n\n struct BooleanSlot {\n bool value;\n }\n\n struct Bytes32Slot {\n bytes32 value;\n }\n\n struct Uint256Slot {\n uint256 value;\n }\n\n struct StringSlot {\n string value;\n }\n\n struct BytesSlot {\n bytes value;\n }\n\n /**\n * @dev Returns an `AddressSlot` with member `value` located at `slot`.\n */\n function getAddressSlot(bytes32 slot) internal pure returns (AddressSlot storage r) {\n /// @solidity memory-safe-assembly\n assembly {\n r.slot := slot\n }\n }\n\n /**\n * @dev Returns an `BooleanSlot` with member `value` located at `slot`.\n */\n function getBooleanSlot(bytes32 slot) internal pure returns (BooleanSlot storage r) {\n /// @solidity memory-safe-assembly\n assembly {\n r.slot := slot\n }\n }\n\n /**\n * @dev Returns an `Bytes32Slot` with member `value` located at `slot`.\n */\n function getBytes32Slot(bytes32 slot) internal pure returns (Bytes32Slot storage r) {\n /// @solidity memory-safe-assembly\n assembly {\n r.slot := slot\n }\n }\n\n /**\n * @dev Returns an `Uint256Slot` with member `value` located at `slot`.\n */\n function getUint256Slot(bytes32 slot) internal pure returns (Uint256Slot storage r) {\n /// @solidity memory-safe-assembly\n assembly {\n r.slot := slot\n }\n }\n\n /**\n * @dev Returns an `StringSlot` with member `value` located at `slot`.\n */\n function getStringSlot(bytes32 slot) internal pure returns (StringSlot storage r) {\n /// @solidity memory-safe-assembly\n assembly {\n r.slot := slot\n }\n }\n\n /**\n * @dev Returns an `StringSlot` representation of the string storage pointer `store`.\n */\n function getStringSlot(string storage store) internal pure returns (StringSlot storage r) {\n /// @solidity memory-safe-assembly\n assembly {\n r.slot := store.slot\n }\n }\n\n /**\n * @dev Returns an `BytesSlot` with member `value` located at `slot`.\n */\n function getBytesSlot(bytes32 slot) internal pure returns (BytesSlot storage r) {\n /// @solidity memory-safe-assembly\n assembly {\n r.slot := slot\n }\n }\n\n /**\n * @dev Returns an `BytesSlot` representation of the bytes storage pointer `store`.\n */\n function getBytesSlot(bytes storage store) internal pure returns (BytesSlot storage r) {\n /// @solidity memory-safe-assembly\n assembly {\n r.slot := store.slot\n }\n }\n}\n"
- },
- "@openzeppelin/contracts-upgradeable/utils/StringsUpgradeable.sol": {
- "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (utils/Strings.sol)\n\npragma solidity ^0.8.0;\n\nimport \"./math/MathUpgradeable.sol\";\nimport \"./math/SignedMathUpgradeable.sol\";\n\n/**\n * @dev String operations.\n */\nlibrary StringsUpgradeable {\n bytes16 private constant _SYMBOLS = \"0123456789abcdef\";\n uint8 private constant _ADDRESS_LENGTH = 20;\n\n /**\n * @dev Converts a `uint256` to its ASCII `string` decimal representation.\n */\n function toString(uint256 value) internal pure returns (string memory) {\n unchecked {\n uint256 length = MathUpgradeable.log10(value) + 1;\n string memory buffer = new string(length);\n uint256 ptr;\n /// @solidity memory-safe-assembly\n assembly {\n ptr := add(buffer, add(32, length))\n }\n while (true) {\n ptr--;\n /// @solidity memory-safe-assembly\n assembly {\n mstore8(ptr, byte(mod(value, 10), _SYMBOLS))\n }\n value /= 10;\n if (value == 0) break;\n }\n return buffer;\n }\n }\n\n /**\n * @dev Converts a `int256` to its ASCII `string` decimal representation.\n */\n function toString(int256 value) internal pure returns (string memory) {\n return string(abi.encodePacked(value < 0 ? \"-\" : \"\", toString(SignedMathUpgradeable.abs(value))));\n }\n\n /**\n * @dev Converts a `uint256` to its ASCII `string` hexadecimal representation.\n */\n function toHexString(uint256 value) internal pure returns (string memory) {\n unchecked {\n return toHexString(value, MathUpgradeable.log256(value) + 1);\n }\n }\n\n /**\n * @dev Converts a `uint256` to its ASCII `string` hexadecimal representation with fixed length.\n */\n function toHexString(uint256 value, uint256 length) internal pure returns (string memory) {\n bytes memory buffer = new bytes(2 * length + 2);\n buffer[0] = \"0\";\n buffer[1] = \"x\";\n for (uint256 i = 2 * length + 1; i > 1; --i) {\n buffer[i] = _SYMBOLS[value & 0xf];\n value >>= 4;\n }\n require(value == 0, \"Strings: hex length insufficient\");\n return string(buffer);\n }\n\n /**\n * @dev Converts an `address` with fixed length of 20 bytes to its not checksummed ASCII `string` hexadecimal representation.\n */\n function toHexString(address addr) internal pure returns (string memory) {\n return toHexString(uint256(uint160(addr)), _ADDRESS_LENGTH);\n }\n\n /**\n * @dev Returns true if the two strings are equal.\n */\n function equal(string memory a, string memory b) internal pure returns (bool) {\n return keccak256(bytes(a)) == keccak256(bytes(b));\n }\n}\n"
- },
- "@openzeppelin/contracts-upgradeable/vendor/optimism/ICrossDomainMessengerUpgradeable.sol": {
- "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (vendor/optimism/ICrossDomainMessenger.sol)\npragma solidity >0.5.0 <0.9.0;\n\n/**\n * @title ICrossDomainMessenger\n */\ninterface ICrossDomainMessengerUpgradeable {\n /**********\n * Events *\n **********/\n\n event SentMessage(address indexed target, address sender, bytes message, uint256 messageNonce, uint256 gasLimit);\n event RelayedMessage(bytes32 indexed msgHash);\n event FailedRelayedMessage(bytes32 indexed msgHash);\n\n /*************\n * Variables *\n *************/\n\n function xDomainMessageSender() external view returns (address);\n\n /********************\n * Public Functions *\n ********************/\n\n /**\n * Sends a cross domain message to the target messenger.\n * @param _target Target contract address.\n * @param _message Message to send to the target.\n * @param _gasLimit Gas limit for the provided message.\n */\n function sendMessage(address _target, bytes calldata _message, uint32 _gasLimit) external;\n}\n"
- },
- "@openzeppelin/contracts/interfaces/IERC1271.sol": {
- "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts v4.4.1 (interfaces/IERC1271.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @dev Interface of the ERC1271 standard signature validation method for\n * contracts as defined in https://eips.ethereum.org/EIPS/eip-1271[ERC-1271].\n *\n * _Available since v4.1._\n */\ninterface IERC1271 {\n /**\n * @dev Should return whether the signature provided is valid for the provided data\n * @param hash Hash of the data to be signed\n * @param signature Signature byte array associated with _data\n */\n function isValidSignature(bytes32 hash, bytes memory signature) external view returns (bytes4 magicValue);\n}\n"
- },
- "@openzeppelin/contracts/token/ERC20/extensions/IERC20Permit.sol": {
- "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.4) (token/ERC20/extensions/IERC20Permit.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @dev Interface of the ERC20 Permit extension allowing approvals to be made via signatures, as defined in\n * https://eips.ethereum.org/EIPS/eip-2612[EIP-2612].\n *\n * Adds the {permit} method, which can be used to change an account's ERC20 allowance (see {IERC20-allowance}) by\n * presenting a message signed by the account. By not relying on {IERC20-approve}, the token holder account doesn't\n * need to send a transaction, and thus is not required to hold Ether at all.\n *\n * ==== Security Considerations\n *\n * There are two important considerations concerning the use of `permit`. The first is that a valid permit signature\n * expresses an allowance, and it should not be assumed to convey additional meaning. In particular, it should not be\n * considered as an intention to spend the allowance in any specific way. The second is that because permits have\n * built-in replay protection and can be submitted by anyone, they can be frontrun. A protocol that uses permits should\n * take this into consideration and allow a `permit` call to fail. Combining these two aspects, a pattern that may be\n * generally recommended is:\n *\n * ```solidity\n * function doThingWithPermit(..., uint256 value, uint256 deadline, uint8 v, bytes32 r, bytes32 s) public {\n * try token.permit(msg.sender, address(this), value, deadline, v, r, s) {} catch {}\n * doThing(..., value);\n * }\n *\n * function doThing(..., uint256 value) public {\n * token.safeTransferFrom(msg.sender, address(this), value);\n * ...\n * }\n * ```\n *\n * Observe that: 1) `msg.sender` is used as the owner, leaving no ambiguity as to the signer intent, and 2) the use of\n * `try/catch` allows the permit to fail and makes the code tolerant to frontrunning. (See also\n * {SafeERC20-safeTransferFrom}).\n *\n * Additionally, note that smart contract wallets (such as Argent or Safe) are not able to produce permit signatures, so\n * contracts should have entry points that don't rely on permit.\n */\ninterface IERC20Permit {\n /**\n * @dev Sets `value` as the allowance of `spender` over ``owner``'s tokens,\n * given ``owner``'s signed approval.\n *\n * IMPORTANT: The same issues {IERC20-approve} has related to transaction\n * ordering also apply here.\n *\n * Emits an {Approval} event.\n *\n * Requirements:\n *\n * - `spender` cannot be the zero address.\n * - `deadline` must be a timestamp in the future.\n * - `v`, `r` and `s` must be a valid `secp256k1` signature from `owner`\n * over the EIP712-formatted function arguments.\n * - the signature must use ``owner``'s current nonce (see {nonces}).\n *\n * For more information on the signature format, see the\n * https://eips.ethereum.org/EIPS/eip-2612#specification[relevant EIP\n * section].\n *\n * CAUTION: See Security Considerations above.\n */\n function permit(\n address owner,\n address spender,\n uint256 value,\n uint256 deadline,\n uint8 v,\n bytes32 r,\n bytes32 s\n ) external;\n\n /**\n * @dev Returns the current nonce for `owner`. This value must be\n * included whenever a signature is generated for {permit}.\n *\n * Every successful call to {permit} increases ``owner``'s nonce by one. This\n * prevents a signature from being used multiple times.\n */\n function nonces(address owner) external view returns (uint256);\n\n /**\n * @dev Returns the domain separator used in the encoding of the signature for {permit}, as defined by {EIP712}.\n */\n // solhint-disable-next-line func-name-mixedcase\n function DOMAIN_SEPARATOR() external view returns (bytes32);\n}\n"
- },
- "@openzeppelin/contracts/token/ERC20/IERC20.sol": {
- "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (token/ERC20/IERC20.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @dev Interface of the ERC20 standard as defined in the EIP.\n */\ninterface IERC20 {\n /**\n * @dev Emitted when `value` tokens are moved from one account (`from`) to\n * another (`to`).\n *\n * Note that `value` may be zero.\n */\n event Transfer(address indexed from, address indexed to, uint256 value);\n\n /**\n * @dev Emitted when the allowance of a `spender` for an `owner` is set by\n * a call to {approve}. `value` is the new allowance.\n */\n event Approval(address indexed owner, address indexed spender, uint256 value);\n\n /**\n * @dev Returns the amount of tokens in existence.\n */\n function totalSupply() external view returns (uint256);\n\n /**\n * @dev Returns the amount of tokens owned by `account`.\n */\n function balanceOf(address account) external view returns (uint256);\n\n /**\n * @dev Moves `amount` tokens from the caller's account to `to`.\n *\n * Returns a boolean value indicating whether the operation succeeded.\n *\n * Emits a {Transfer} event.\n */\n function transfer(address to, uint256 amount) external returns (bool);\n\n /**\n * @dev Returns the remaining number of tokens that `spender` will be\n * allowed to spend on behalf of `owner` through {transferFrom}. This is\n * zero by default.\n *\n * This value changes when {approve} or {transferFrom} are called.\n */\n function allowance(address owner, address spender) external view returns (uint256);\n\n /**\n * @dev Sets `amount` as the allowance of `spender` over the caller's tokens.\n *\n * Returns a boolean value indicating whether the operation succeeded.\n *\n * IMPORTANT: Beware that changing an allowance with this method brings the risk\n * that someone may use both the old and the new allowance by unfortunate\n * transaction ordering. One possible solution to mitigate this race\n * condition is to first reduce the spender's allowance to 0 and set the\n * desired value afterwards:\n * https://github.com/ethereum/EIPs/issues/20#issuecomment-263524729\n *\n * Emits an {Approval} event.\n */\n function approve(address spender, uint256 amount) external returns (bool);\n\n /**\n * @dev Moves `amount` tokens from `from` to `to` using the\n * allowance mechanism. `amount` is then deducted from the caller's\n * allowance.\n *\n * Returns a boolean value indicating whether the operation succeeded.\n *\n * Emits a {Transfer} event.\n */\n function transferFrom(address from, address to, uint256 amount) external returns (bool);\n}\n"
- },
- "@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol": {
- "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.3) (token/ERC20/utils/SafeERC20.sol)\n\npragma solidity ^0.8.0;\n\nimport \"../IERC20.sol\";\nimport \"../extensions/IERC20Permit.sol\";\nimport \"../../../utils/Address.sol\";\n\n/**\n * @title SafeERC20\n * @dev Wrappers around ERC20 operations that throw on failure (when the token\n * contract returns false). Tokens that return no value (and instead revert or\n * throw on failure) are also supported, non-reverting calls are assumed to be\n * successful.\n * To use this library you can add a `using SafeERC20 for IERC20;` statement to your contract,\n * which allows you to call the safe operations as `token.safeTransfer(...)`, etc.\n */\nlibrary SafeERC20 {\n using Address for address;\n\n /**\n * @dev Transfer `value` amount of `token` from the calling contract to `to`. If `token` returns no value,\n * non-reverting calls are assumed to be successful.\n */\n function safeTransfer(IERC20 token, address to, uint256 value) internal {\n _callOptionalReturn(token, abi.encodeWithSelector(token.transfer.selector, to, value));\n }\n\n /**\n * @dev Transfer `value` amount of `token` from `from` to `to`, spending the approval given by `from` to the\n * calling contract. If `token` returns no value, non-reverting calls are assumed to be successful.\n */\n function safeTransferFrom(IERC20 token, address from, address to, uint256 value) internal {\n _callOptionalReturn(token, abi.encodeWithSelector(token.transferFrom.selector, from, to, value));\n }\n\n /**\n * @dev Deprecated. This function has issues similar to the ones found in\n * {IERC20-approve}, and its usage is discouraged.\n *\n * Whenever possible, use {safeIncreaseAllowance} and\n * {safeDecreaseAllowance} instead.\n */\n function safeApprove(IERC20 token, address spender, uint256 value) internal {\n // safeApprove should only be called when setting an initial allowance,\n // or when resetting it to zero. To increase and decrease it, use\n // 'safeIncreaseAllowance' and 'safeDecreaseAllowance'\n require(\n (value == 0) || (token.allowance(address(this), spender) == 0),\n \"SafeERC20: approve from non-zero to non-zero allowance\"\n );\n _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, value));\n }\n\n /**\n * @dev Increase the calling contract's allowance toward `spender` by `value`. If `token` returns no value,\n * non-reverting calls are assumed to be successful.\n */\n function safeIncreaseAllowance(IERC20 token, address spender, uint256 value) internal {\n uint256 oldAllowance = token.allowance(address(this), spender);\n _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, oldAllowance + value));\n }\n\n /**\n * @dev Decrease the calling contract's allowance toward `spender` by `value`. If `token` returns no value,\n * non-reverting calls are assumed to be successful.\n */\n function safeDecreaseAllowance(IERC20 token, address spender, uint256 value) internal {\n unchecked {\n uint256 oldAllowance = token.allowance(address(this), spender);\n require(oldAllowance >= value, \"SafeERC20: decreased allowance below zero\");\n _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, oldAllowance - value));\n }\n }\n\n /**\n * @dev Set the calling contract's allowance toward `spender` to `value`. If `token` returns no value,\n * non-reverting calls are assumed to be successful. Meant to be used with tokens that require the approval\n * to be set to zero before setting it to a non-zero value, such as USDT.\n */\n function forceApprove(IERC20 token, address spender, uint256 value) internal {\n bytes memory approvalCall = abi.encodeWithSelector(token.approve.selector, spender, value);\n\n if (!_callOptionalReturnBool(token, approvalCall)) {\n _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, 0));\n _callOptionalReturn(token, approvalCall);\n }\n }\n\n /**\n * @dev Use a ERC-2612 signature to set the `owner` approval toward `spender` on `token`.\n * Revert on invalid signature.\n */\n function safePermit(\n IERC20Permit token,\n address owner,\n address spender,\n uint256 value,\n uint256 deadline,\n uint8 v,\n bytes32 r,\n bytes32 s\n ) internal {\n uint256 nonceBefore = token.nonces(owner);\n token.permit(owner, spender, value, deadline, v, r, s);\n uint256 nonceAfter = token.nonces(owner);\n require(nonceAfter == nonceBefore + 1, \"SafeERC20: permit did not succeed\");\n }\n\n /**\n * @dev Imitates a Solidity high-level call (i.e. a regular function call to a contract), relaxing the requirement\n * on the return value: the return value is optional (but if data is returned, it must not be false).\n * @param token The token targeted by the call.\n * @param data The call data (encoded using abi.encode or one of its variants).\n */\n function _callOptionalReturn(IERC20 token, bytes memory data) private {\n // We need to perform a low level call here, to bypass Solidity's return data size checking mechanism, since\n // we're implementing it ourselves. We use {Address-functionCall} to perform this call, which verifies that\n // the target address contains contract code and also asserts for success in the low-level call.\n\n bytes memory returndata = address(token).functionCall(data, \"SafeERC20: low-level call failed\");\n require(returndata.length == 0 || abi.decode(returndata, (bool)), \"SafeERC20: ERC20 operation did not succeed\");\n }\n\n /**\n * @dev Imitates a Solidity high-level call (i.e. a regular function call to a contract), relaxing the requirement\n * on the return value: the return value is optional (but if data is returned, it must not be false).\n * @param token The token targeted by the call.\n * @param data The call data (encoded using abi.encode or one of its variants).\n *\n * This is a variant of {_callOptionalReturn} that silents catches all reverts and returns a bool instead.\n */\n function _callOptionalReturnBool(IERC20 token, bytes memory data) private returns (bool) {\n // We need to perform a low level call here, to bypass Solidity's return data size checking mechanism, since\n // we're implementing it ourselves. We cannot use {Address-functionCall} here since this should return false\n // and not revert is the subcall reverts.\n\n (bool success, bytes memory returndata) = address(token).call(data);\n return\n success && (returndata.length == 0 || abi.decode(returndata, (bool))) && Address.isContract(address(token));\n }\n}\n"
- },
- "@openzeppelin/contracts/utils/Address.sol": {
- "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (utils/Address.sol)\n\npragma solidity ^0.8.1;\n\n/**\n * @dev Collection of functions related to the address type\n */\nlibrary Address {\n /**\n * @dev Returns true if `account` is a contract.\n *\n * [IMPORTANT]\n * ====\n * It is unsafe to assume that an address for which this function returns\n * false is an externally-owned account (EOA) and not a contract.\n *\n * Among others, `isContract` will return false for the following\n * types of addresses:\n *\n * - an externally-owned account\n * - a contract in construction\n * - an address where a contract will be created\n * - an address where a contract lived, but was destroyed\n *\n * Furthermore, `isContract` will also return true if the target contract within\n * the same transaction is already scheduled for destruction by `SELFDESTRUCT`,\n * which only has an effect at the end of a transaction.\n * ====\n *\n * [IMPORTANT]\n * ====\n * You shouldn't rely on `isContract` to protect against flash loan attacks!\n *\n * Preventing calls from contracts is highly discouraged. It breaks composability, breaks support for smart wallets\n * like Gnosis Safe, and does not provide security since it can be circumvented by calling from a contract\n * constructor.\n * ====\n */\n function isContract(address account) internal view returns (bool) {\n // This method relies on extcodesize/address.code.length, which returns 0\n // for contracts in construction, since the code is only stored at the end\n // of the constructor execution.\n\n return account.code.length > 0;\n }\n\n /**\n * @dev Replacement for Solidity's `transfer`: sends `amount` wei to\n * `recipient`, forwarding all available gas and reverting on errors.\n *\n * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost\n * of certain opcodes, possibly making contracts go over the 2300 gas limit\n * imposed by `transfer`, making them unable to receive funds via\n * `transfer`. {sendValue} removes this limitation.\n *\n * https://consensys.net/diligence/blog/2019/09/stop-using-soliditys-transfer-now/[Learn more].\n *\n * IMPORTANT: because control is transferred to `recipient`, care must be\n * taken to not create reentrancy vulnerabilities. Consider using\n * {ReentrancyGuard} or the\n * https://solidity.readthedocs.io/en/v0.8.0/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].\n */\n function sendValue(address payable recipient, uint256 amount) internal {\n require(address(this).balance >= amount, \"Address: insufficient balance\");\n\n (bool success, ) = recipient.call{value: amount}(\"\");\n require(success, \"Address: unable to send value, recipient may have reverted\");\n }\n\n /**\n * @dev Performs a Solidity function call using a low level `call`. A\n * plain `call` is an unsafe replacement for a function call: use this\n * function instead.\n *\n * If `target` reverts with a revert reason, it is bubbled up by this\n * function (like regular Solidity function calls).\n *\n * Returns the raw returned data. To convert to the expected return value,\n * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].\n *\n * Requirements:\n *\n * - `target` must be a contract.\n * - calling `target` with `data` must not revert.\n *\n * _Available since v3.1._\n */\n function functionCall(address target, bytes memory data) internal returns (bytes memory) {\n return functionCallWithValue(target, data, 0, \"Address: low-level call failed\");\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with\n * `errorMessage` as a fallback revert reason when `target` reverts.\n *\n * _Available since v3.1._\n */\n function functionCall(\n address target,\n bytes memory data,\n string memory errorMessage\n ) internal returns (bytes memory) {\n return functionCallWithValue(target, data, 0, errorMessage);\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\n * but also transferring `value` wei to `target`.\n *\n * Requirements:\n *\n * - the calling contract must have an ETH balance of at least `value`.\n * - the called Solidity function must be `payable`.\n *\n * _Available since v3.1._\n */\n function functionCallWithValue(address target, bytes memory data, uint256 value) internal returns (bytes memory) {\n return functionCallWithValue(target, data, value, \"Address: low-level call with value failed\");\n }\n\n /**\n * @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but\n * with `errorMessage` as a fallback revert reason when `target` reverts.\n *\n * _Available since v3.1._\n */\n function functionCallWithValue(\n address target,\n bytes memory data,\n uint256 value,\n string memory errorMessage\n ) internal returns (bytes memory) {\n require(address(this).balance >= value, \"Address: insufficient balance for call\");\n (bool success, bytes memory returndata) = target.call{value: value}(data);\n return verifyCallResultFromTarget(target, success, returndata, errorMessage);\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\n * but performing a static call.\n *\n * _Available since v3.3._\n */\n function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {\n return functionStaticCall(target, data, \"Address: low-level static call failed\");\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],\n * but performing a static call.\n *\n * _Available since v3.3._\n */\n function functionStaticCall(\n address target,\n bytes memory data,\n string memory errorMessage\n ) internal view returns (bytes memory) {\n (bool success, bytes memory returndata) = target.staticcall(data);\n return verifyCallResultFromTarget(target, success, returndata, errorMessage);\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\n * but performing a delegate call.\n *\n * _Available since v3.4._\n */\n function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) {\n return functionDelegateCall(target, data, \"Address: low-level delegate call failed\");\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],\n * but performing a delegate call.\n *\n * _Available since v3.4._\n */\n function functionDelegateCall(\n address target,\n bytes memory data,\n string memory errorMessage\n ) internal returns (bytes memory) {\n (bool success, bytes memory returndata) = target.delegatecall(data);\n return verifyCallResultFromTarget(target, success, returndata, errorMessage);\n }\n\n /**\n * @dev Tool to verify that a low level call to smart-contract was successful, and revert (either by bubbling\n * the revert reason or using the provided one) in case of unsuccessful call or if target was not a contract.\n *\n * _Available since v4.8._\n */\n function verifyCallResultFromTarget(\n address target,\n bool success,\n bytes memory returndata,\n string memory errorMessage\n ) internal view returns (bytes memory) {\n if (success) {\n if (returndata.length == 0) {\n // only check isContract if the call was successful and the return data is empty\n // otherwise we already know that it was a contract\n require(isContract(target), \"Address: call to non-contract\");\n }\n return returndata;\n } else {\n _revert(returndata, errorMessage);\n }\n }\n\n /**\n * @dev Tool to verify that a low level call was successful, and revert if it wasn't, either by bubbling the\n * revert reason or using the provided one.\n *\n * _Available since v4.3._\n */\n function verifyCallResult(\n bool success,\n bytes memory returndata,\n string memory errorMessage\n ) internal pure returns (bytes memory) {\n if (success) {\n return returndata;\n } else {\n _revert(returndata, errorMessage);\n }\n }\n\n function _revert(bytes memory returndata, string memory errorMessage) private pure {\n // Look for revert reason and bubble it up if present\n if (returndata.length > 0) {\n // The easiest way to bubble the revert reason is using memory via assembly\n /// @solidity memory-safe-assembly\n assembly {\n let returndata_size := mload(returndata)\n revert(add(32, returndata), returndata_size)\n }\n } else {\n revert(errorMessage);\n }\n }\n}\n"
- },
- "@openzeppelin/contracts/utils/cryptography/ECDSA.sol": {
- "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (utils/cryptography/ECDSA.sol)\n\npragma solidity ^0.8.0;\n\nimport \"../Strings.sol\";\n\n/**\n * @dev Elliptic Curve Digital Signature Algorithm (ECDSA) operations.\n *\n * These functions can be used to verify that a message was signed by the holder\n * of the private keys of a given address.\n */\nlibrary ECDSA {\n enum RecoverError {\n NoError,\n InvalidSignature,\n InvalidSignatureLength,\n InvalidSignatureS,\n InvalidSignatureV // Deprecated in v4.8\n }\n\n function _throwError(RecoverError error) private pure {\n if (error == RecoverError.NoError) {\n return; // no error: do nothing\n } else if (error == RecoverError.InvalidSignature) {\n revert(\"ECDSA: invalid signature\");\n } else if (error == RecoverError.InvalidSignatureLength) {\n revert(\"ECDSA: invalid signature length\");\n } else if (error == RecoverError.InvalidSignatureS) {\n revert(\"ECDSA: invalid signature 's' value\");\n }\n }\n\n /**\n * @dev Returns the address that signed a hashed message (`hash`) with\n * `signature` or error string. This address can then be used for verification purposes.\n *\n * The `ecrecover` EVM opcode allows for malleable (non-unique) signatures:\n * this function rejects them by requiring the `s` value to be in the lower\n * half order, and the `v` value to be either 27 or 28.\n *\n * IMPORTANT: `hash` _must_ be the result of a hash operation for the\n * verification to be secure: it is possible to craft signatures that\n * recover to arbitrary addresses for non-hashed data. A safe way to ensure\n * this is by receiving a hash of the original message (which may otherwise\n * be too long), and then calling {toEthSignedMessageHash} on it.\n *\n * Documentation for signature generation:\n * - with https://web3js.readthedocs.io/en/v1.3.4/web3-eth-accounts.html#sign[Web3.js]\n * - with https://docs.ethers.io/v5/api/signer/#Signer-signMessage[ethers]\n *\n * _Available since v4.3._\n */\n function tryRecover(bytes32 hash, bytes memory signature) internal pure returns (address, RecoverError) {\n if (signature.length == 65) {\n bytes32 r;\n bytes32 s;\n uint8 v;\n // ecrecover takes the signature parameters, and the only way to get them\n // currently is to use assembly.\n /// @solidity memory-safe-assembly\n assembly {\n r := mload(add(signature, 0x20))\n s := mload(add(signature, 0x40))\n v := byte(0, mload(add(signature, 0x60)))\n }\n return tryRecover(hash, v, r, s);\n } else {\n return (address(0), RecoverError.InvalidSignatureLength);\n }\n }\n\n /**\n * @dev Returns the address that signed a hashed message (`hash`) with\n * `signature`. This address can then be used for verification purposes.\n *\n * The `ecrecover` EVM opcode allows for malleable (non-unique) signatures:\n * this function rejects them by requiring the `s` value to be in the lower\n * half order, and the `v` value to be either 27 or 28.\n *\n * IMPORTANT: `hash` _must_ be the result of a hash operation for the\n * verification to be secure: it is possible to craft signatures that\n * recover to arbitrary addresses for non-hashed data. A safe way to ensure\n * this is by receiving a hash of the original message (which may otherwise\n * be too long), and then calling {toEthSignedMessageHash} on it.\n */\n function recover(bytes32 hash, bytes memory signature) internal pure returns (address) {\n (address recovered, RecoverError error) = tryRecover(hash, signature);\n _throwError(error);\n return recovered;\n }\n\n /**\n * @dev Overload of {ECDSA-tryRecover} that receives the `r` and `vs` short-signature fields separately.\n *\n * See https://eips.ethereum.org/EIPS/eip-2098[EIP-2098 short signatures]\n *\n * _Available since v4.3._\n */\n function tryRecover(bytes32 hash, bytes32 r, bytes32 vs) internal pure returns (address, RecoverError) {\n bytes32 s = vs & bytes32(0x7fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff);\n uint8 v = uint8((uint256(vs) >> 255) + 27);\n return tryRecover(hash, v, r, s);\n }\n\n /**\n * @dev Overload of {ECDSA-recover} that receives the `r and `vs` short-signature fields separately.\n *\n * _Available since v4.2._\n */\n function recover(bytes32 hash, bytes32 r, bytes32 vs) internal pure returns (address) {\n (address recovered, RecoverError error) = tryRecover(hash, r, vs);\n _throwError(error);\n return recovered;\n }\n\n /**\n * @dev Overload of {ECDSA-tryRecover} that receives the `v`,\n * `r` and `s` signature fields separately.\n *\n * _Available since v4.3._\n */\n function tryRecover(bytes32 hash, uint8 v, bytes32 r, bytes32 s) internal pure returns (address, RecoverError) {\n // EIP-2 still allows signature malleability for ecrecover(). Remove this possibility and make the signature\n // unique. Appendix F in the Ethereum Yellow paper (https://ethereum.github.io/yellowpaper/paper.pdf), defines\n // the valid range for s in (301): 0 < s < secp256k1n ÷ 2 + 1, and for v in (302): v ∈ {27, 28}. Most\n // signatures from current libraries generate a unique signature with an s-value in the lower half order.\n //\n // If your library generates malleable signatures, such as s-values in the upper range, calculate a new s-value\n // with 0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFEBAAEDCE6AF48A03BBFD25E8CD0364141 - s1 and flip v from 27 to 28 or\n // vice versa. If your library also generates signatures with 0/1 for v instead 27/28, add 27 to v to accept\n // these malleable signatures as well.\n if (uint256(s) > 0x7FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF5D576E7357A4501DDFE92F46681B20A0) {\n return (address(0), RecoverError.InvalidSignatureS);\n }\n\n // If the signature is valid (and not malleable), return the signer address\n address signer = ecrecover(hash, v, r, s);\n if (signer == address(0)) {\n return (address(0), RecoverError.InvalidSignature);\n }\n\n return (signer, RecoverError.NoError);\n }\n\n /**\n * @dev Overload of {ECDSA-recover} that receives the `v`,\n * `r` and `s` signature fields separately.\n */\n function recover(bytes32 hash, uint8 v, bytes32 r, bytes32 s) internal pure returns (address) {\n (address recovered, RecoverError error) = tryRecover(hash, v, r, s);\n _throwError(error);\n return recovered;\n }\n\n /**\n * @dev Returns an Ethereum Signed Message, created from a `hash`. This\n * produces hash corresponding to the one signed with the\n * https://eth.wiki/json-rpc/API#eth_sign[`eth_sign`]\n * JSON-RPC method as part of EIP-191.\n *\n * See {recover}.\n */\n function toEthSignedMessageHash(bytes32 hash) internal pure returns (bytes32 message) {\n // 32 is the length in bytes of hash,\n // enforced by the type signature above\n /// @solidity memory-safe-assembly\n assembly {\n mstore(0x00, \"\\x19Ethereum Signed Message:\\n32\")\n mstore(0x1c, hash)\n message := keccak256(0x00, 0x3c)\n }\n }\n\n /**\n * @dev Returns an Ethereum Signed Message, created from `s`. This\n * produces hash corresponding to the one signed with the\n * https://eth.wiki/json-rpc/API#eth_sign[`eth_sign`]\n * JSON-RPC method as part of EIP-191.\n *\n * See {recover}.\n */\n function toEthSignedMessageHash(bytes memory s) internal pure returns (bytes32) {\n return keccak256(abi.encodePacked(\"\\x19Ethereum Signed Message:\\n\", Strings.toString(s.length), s));\n }\n\n /**\n * @dev Returns an Ethereum Signed Typed Data, created from a\n * `domainSeparator` and a `structHash`. This produces hash corresponding\n * to the one signed with the\n * https://eips.ethereum.org/EIPS/eip-712[`eth_signTypedData`]\n * JSON-RPC method as part of EIP-712.\n *\n * See {recover}.\n */\n function toTypedDataHash(bytes32 domainSeparator, bytes32 structHash) internal pure returns (bytes32 data) {\n /// @solidity memory-safe-assembly\n assembly {\n let ptr := mload(0x40)\n mstore(ptr, \"\\x19\\x01\")\n mstore(add(ptr, 0x02), domainSeparator)\n mstore(add(ptr, 0x22), structHash)\n data := keccak256(ptr, 0x42)\n }\n }\n\n /**\n * @dev Returns an Ethereum Signed Data with intended validator, created from a\n * `validator` and `data` according to the version 0 of EIP-191.\n *\n * See {recover}.\n */\n function toDataWithIntendedValidatorHash(address validator, bytes memory data) internal pure returns (bytes32) {\n return keccak256(abi.encodePacked(\"\\x19\\x00\", validator, data));\n }\n}\n"
- },
- "@openzeppelin/contracts/utils/cryptography/MerkleProof.sol": {
- "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.2) (utils/cryptography/MerkleProof.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @dev These functions deal with verification of Merkle Tree proofs.\n *\n * The tree and the proofs can be generated using our\n * https://github.com/OpenZeppelin/merkle-tree[JavaScript library].\n * You will find a quickstart guide in the readme.\n *\n * WARNING: You should avoid using leaf values that are 64 bytes long prior to\n * hashing, or use a hash function other than keccak256 for hashing leaves.\n * This is because the concatenation of a sorted pair of internal nodes in\n * the merkle tree could be reinterpreted as a leaf value.\n * OpenZeppelin's JavaScript library generates merkle trees that are safe\n * against this attack out of the box.\n */\nlibrary MerkleProof {\n /**\n * @dev Returns true if a `leaf` can be proved to be a part of a Merkle tree\n * defined by `root`. For this, a `proof` must be provided, containing\n * sibling hashes on the branch from the leaf to the root of the tree. Each\n * pair of leaves and each pair of pre-images are assumed to be sorted.\n */\n function verify(bytes32[] memory proof, bytes32 root, bytes32 leaf) internal pure returns (bool) {\n return processProof(proof, leaf) == root;\n }\n\n /**\n * @dev Calldata version of {verify}\n *\n * _Available since v4.7._\n */\n function verifyCalldata(bytes32[] calldata proof, bytes32 root, bytes32 leaf) internal pure returns (bool) {\n return processProofCalldata(proof, leaf) == root;\n }\n\n /**\n * @dev Returns the rebuilt hash obtained by traversing a Merkle tree up\n * from `leaf` using `proof`. A `proof` is valid if and only if the rebuilt\n * hash matches the root of the tree. When processing the proof, the pairs\n * of leafs & pre-images are assumed to be sorted.\n *\n * _Available since v4.4._\n */\n function processProof(bytes32[] memory proof, bytes32 leaf) internal pure returns (bytes32) {\n bytes32 computedHash = leaf;\n for (uint256 i = 0; i < proof.length; i++) {\n computedHash = _hashPair(computedHash, proof[i]);\n }\n return computedHash;\n }\n\n /**\n * @dev Calldata version of {processProof}\n *\n * _Available since v4.7._\n */\n function processProofCalldata(bytes32[] calldata proof, bytes32 leaf) internal pure returns (bytes32) {\n bytes32 computedHash = leaf;\n for (uint256 i = 0; i < proof.length; i++) {\n computedHash = _hashPair(computedHash, proof[i]);\n }\n return computedHash;\n }\n\n /**\n * @dev Returns true if the `leaves` can be simultaneously proven to be a part of a merkle tree defined by\n * `root`, according to `proof` and `proofFlags` as described in {processMultiProof}.\n *\n * CAUTION: Not all merkle trees admit multiproofs. See {processMultiProof} for details.\n *\n * _Available since v4.7._\n */\n function multiProofVerify(\n bytes32[] memory proof,\n bool[] memory proofFlags,\n bytes32 root,\n bytes32[] memory leaves\n ) internal pure returns (bool) {\n return processMultiProof(proof, proofFlags, leaves) == root;\n }\n\n /**\n * @dev Calldata version of {multiProofVerify}\n *\n * CAUTION: Not all merkle trees admit multiproofs. See {processMultiProof} for details.\n *\n * _Available since v4.7._\n */\n function multiProofVerifyCalldata(\n bytes32[] calldata proof,\n bool[] calldata proofFlags,\n bytes32 root,\n bytes32[] memory leaves\n ) internal pure returns (bool) {\n return processMultiProofCalldata(proof, proofFlags, leaves) == root;\n }\n\n /**\n * @dev Returns the root of a tree reconstructed from `leaves` and sibling nodes in `proof`. The reconstruction\n * proceeds by incrementally reconstructing all inner nodes by combining a leaf/inner node with either another\n * leaf/inner node or a proof sibling node, depending on whether each `proofFlags` item is true or false\n * respectively.\n *\n * CAUTION: Not all merkle trees admit multiproofs. To use multiproofs, it is sufficient to ensure that: 1) the tree\n * is complete (but not necessarily perfect), 2) the leaves to be proven are in the opposite order they are in the\n * tree (i.e., as seen from right to left starting at the deepest layer and continuing at the next layer).\n *\n * _Available since v4.7._\n */\n function processMultiProof(\n bytes32[] memory proof,\n bool[] memory proofFlags,\n bytes32[] memory leaves\n ) internal pure returns (bytes32 merkleRoot) {\n // This function rebuilds the root hash by traversing the tree up from the leaves. The root is rebuilt by\n // consuming and producing values on a queue. The queue starts with the `leaves` array, then goes onto the\n // `hashes` array. At the end of the process, the last hash in the `hashes` array should contain the root of\n // the merkle tree.\n uint256 leavesLen = leaves.length;\n uint256 proofLen = proof.length;\n uint256 totalHashes = proofFlags.length;\n\n // Check proof validity.\n require(leavesLen + proofLen - 1 == totalHashes, \"MerkleProof: invalid multiproof\");\n\n // The xxxPos values are \"pointers\" to the next value to consume in each array. All accesses are done using\n // `xxx[xxxPos++]`, which return the current value and increment the pointer, thus mimicking a queue's \"pop\".\n bytes32[] memory hashes = new bytes32[](totalHashes);\n uint256 leafPos = 0;\n uint256 hashPos = 0;\n uint256 proofPos = 0;\n // At each step, we compute the next hash using two values:\n // - a value from the \"main queue\". If not all leaves have been consumed, we get the next leaf, otherwise we\n // get the next hash.\n // - depending on the flag, either another value from the \"main queue\" (merging branches) or an element from the\n // `proof` array.\n for (uint256 i = 0; i < totalHashes; i++) {\n bytes32 a = leafPos < leavesLen ? leaves[leafPos++] : hashes[hashPos++];\n bytes32 b = proofFlags[i]\n ? (leafPos < leavesLen ? leaves[leafPos++] : hashes[hashPos++])\n : proof[proofPos++];\n hashes[i] = _hashPair(a, b);\n }\n\n if (totalHashes > 0) {\n require(proofPos == proofLen, \"MerkleProof: invalid multiproof\");\n unchecked {\n return hashes[totalHashes - 1];\n }\n } else if (leavesLen > 0) {\n return leaves[0];\n } else {\n return proof[0];\n }\n }\n\n /**\n * @dev Calldata version of {processMultiProof}.\n *\n * CAUTION: Not all merkle trees admit multiproofs. See {processMultiProof} for details.\n *\n * _Available since v4.7._\n */\n function processMultiProofCalldata(\n bytes32[] calldata proof,\n bool[] calldata proofFlags,\n bytes32[] memory leaves\n ) internal pure returns (bytes32 merkleRoot) {\n // This function rebuilds the root hash by traversing the tree up from the leaves. The root is rebuilt by\n // consuming and producing values on a queue. The queue starts with the `leaves` array, then goes onto the\n // `hashes` array. At the end of the process, the last hash in the `hashes` array should contain the root of\n // the merkle tree.\n uint256 leavesLen = leaves.length;\n uint256 proofLen = proof.length;\n uint256 totalHashes = proofFlags.length;\n\n // Check proof validity.\n require(leavesLen + proofLen - 1 == totalHashes, \"MerkleProof: invalid multiproof\");\n\n // The xxxPos values are \"pointers\" to the next value to consume in each array. All accesses are done using\n // `xxx[xxxPos++]`, which return the current value and increment the pointer, thus mimicking a queue's \"pop\".\n bytes32[] memory hashes = new bytes32[](totalHashes);\n uint256 leafPos = 0;\n uint256 hashPos = 0;\n uint256 proofPos = 0;\n // At each step, we compute the next hash using two values:\n // - a value from the \"main queue\". If not all leaves have been consumed, we get the next leaf, otherwise we\n // get the next hash.\n // - depending on the flag, either another value from the \"main queue\" (merging branches) or an element from the\n // `proof` array.\n for (uint256 i = 0; i < totalHashes; i++) {\n bytes32 a = leafPos < leavesLen ? leaves[leafPos++] : hashes[hashPos++];\n bytes32 b = proofFlags[i]\n ? (leafPos < leavesLen ? leaves[leafPos++] : hashes[hashPos++])\n : proof[proofPos++];\n hashes[i] = _hashPair(a, b);\n }\n\n if (totalHashes > 0) {\n require(proofPos == proofLen, \"MerkleProof: invalid multiproof\");\n unchecked {\n return hashes[totalHashes - 1];\n }\n } else if (leavesLen > 0) {\n return leaves[0];\n } else {\n return proof[0];\n }\n }\n\n function _hashPair(bytes32 a, bytes32 b) private pure returns (bytes32) {\n return a < b ? _efficientHash(a, b) : _efficientHash(b, a);\n }\n\n function _efficientHash(bytes32 a, bytes32 b) private pure returns (bytes32 value) {\n /// @solidity memory-safe-assembly\n assembly {\n mstore(0x00, a)\n mstore(0x20, b)\n value := keccak256(0x00, 0x40)\n }\n }\n}\n"
- },
- "@openzeppelin/contracts/utils/cryptography/SignatureChecker.sol": {
- "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (utils/cryptography/SignatureChecker.sol)\n\npragma solidity ^0.8.0;\n\nimport \"./ECDSA.sol\";\nimport \"../../interfaces/IERC1271.sol\";\n\n/**\n * @dev Signature verification helper that can be used instead of `ECDSA.recover` to seamlessly support both ECDSA\n * signatures from externally owned accounts (EOAs) as well as ERC1271 signatures from smart contract wallets like\n * Argent and Gnosis Safe.\n *\n * _Available since v4.1._\n */\nlibrary SignatureChecker {\n /**\n * @dev Checks if a signature is valid for a given signer and data hash. If the signer is a smart contract, the\n * signature is validated against that smart contract using ERC1271, otherwise it's validated using `ECDSA.recover`.\n *\n * NOTE: Unlike ECDSA signatures, contract signatures are revocable, and the outcome of this function can thus\n * change through time. It could return true at block N and false at block N+1 (or the opposite).\n */\n function isValidSignatureNow(address signer, bytes32 hash, bytes memory signature) internal view returns (bool) {\n (address recovered, ECDSA.RecoverError error) = ECDSA.tryRecover(hash, signature);\n return\n (error == ECDSA.RecoverError.NoError && recovered == signer) ||\n isValidERC1271SignatureNow(signer, hash, signature);\n }\n\n /**\n * @dev Checks if a signature is valid for a given signer and data hash. The signature is validated\n * against the signer smart contract using ERC1271.\n *\n * NOTE: Unlike ECDSA signatures, contract signatures are revocable, and the outcome of this function can thus\n * change through time. It could return true at block N and false at block N+1 (or the opposite).\n */\n function isValidERC1271SignatureNow(\n address signer,\n bytes32 hash,\n bytes memory signature\n ) internal view returns (bool) {\n (bool success, bytes memory result) = signer.staticcall(\n abi.encodeWithSelector(IERC1271.isValidSignature.selector, hash, signature)\n );\n return (success &&\n result.length >= 32 &&\n abi.decode(result, (bytes32)) == bytes32(IERC1271.isValidSignature.selector));\n }\n}\n"
- },
- "@openzeppelin/contracts/utils/math/Math.sol": {
- "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (utils/math/Math.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @dev Standard math utilities missing in the Solidity language.\n */\nlibrary Math {\n enum Rounding {\n Down, // Toward negative infinity\n Up, // Toward infinity\n Zero // Toward zero\n }\n\n /**\n * @dev Returns the largest of two numbers.\n */\n function max(uint256 a, uint256 b) internal pure returns (uint256) {\n return a > b ? a : b;\n }\n\n /**\n * @dev Returns the smallest of two numbers.\n */\n function min(uint256 a, uint256 b) internal pure returns (uint256) {\n return a < b ? a : b;\n }\n\n /**\n * @dev Returns the average of two numbers. The result is rounded towards\n * zero.\n */\n function average(uint256 a, uint256 b) internal pure returns (uint256) {\n // (a + b) / 2 can overflow.\n return (a & b) + (a ^ b) / 2;\n }\n\n /**\n * @dev Returns the ceiling of the division of two numbers.\n *\n * This differs from standard division with `/` in that it rounds up instead\n * of rounding down.\n */\n function ceilDiv(uint256 a, uint256 b) internal pure returns (uint256) {\n // (a + b - 1) / b can overflow on addition, so we distribute.\n return a == 0 ? 0 : (a - 1) / b + 1;\n }\n\n /**\n * @notice Calculates floor(x * y / denominator) with full precision. Throws if result overflows a uint256 or denominator == 0\n * @dev Original credit to Remco Bloemen under MIT license (https://xn--2-umb.com/21/muldiv)\n * with further edits by Uniswap Labs also under MIT license.\n */\n function mulDiv(uint256 x, uint256 y, uint256 denominator) internal pure returns (uint256 result) {\n unchecked {\n // 512-bit multiply [prod1 prod0] = x * y. Compute the product mod 2^256 and mod 2^256 - 1, then use\n // use the Chinese Remainder Theorem to reconstruct the 512 bit result. The result is stored in two 256\n // variables such that product = prod1 * 2^256 + prod0.\n uint256 prod0; // Least significant 256 bits of the product\n uint256 prod1; // Most significant 256 bits of the product\n assembly {\n let mm := mulmod(x, y, not(0))\n prod0 := mul(x, y)\n prod1 := sub(sub(mm, prod0), lt(mm, prod0))\n }\n\n // Handle non-overflow cases, 256 by 256 division.\n if (prod1 == 0) {\n // Solidity will revert if denominator == 0, unlike the div opcode on its own.\n // The surrounding unchecked block does not change this fact.\n // See https://docs.soliditylang.org/en/latest/control-structures.html#checked-or-unchecked-arithmetic.\n return prod0 / denominator;\n }\n\n // Make sure the result is less than 2^256. Also prevents denominator == 0.\n require(denominator > prod1, \"Math: mulDiv overflow\");\n\n ///////////////////////////////////////////////\n // 512 by 256 division.\n ///////////////////////////////////////////////\n\n // Make division exact by subtracting the remainder from [prod1 prod0].\n uint256 remainder;\n assembly {\n // Compute remainder using mulmod.\n remainder := mulmod(x, y, denominator)\n\n // Subtract 256 bit number from 512 bit number.\n prod1 := sub(prod1, gt(remainder, prod0))\n prod0 := sub(prod0, remainder)\n }\n\n // Factor powers of two out of denominator and compute largest power of two divisor of denominator. Always >= 1.\n // See https://cs.stackexchange.com/q/138556/92363.\n\n // Does not overflow because the denominator cannot be zero at this stage in the function.\n uint256 twos = denominator & (~denominator + 1);\n assembly {\n // Divide denominator by twos.\n denominator := div(denominator, twos)\n\n // Divide [prod1 prod0] by twos.\n prod0 := div(prod0, twos)\n\n // Flip twos such that it is 2^256 / twos. If twos is zero, then it becomes one.\n twos := add(div(sub(0, twos), twos), 1)\n }\n\n // Shift in bits from prod1 into prod0.\n prod0 |= prod1 * twos;\n\n // Invert denominator mod 2^256. Now that denominator is an odd number, it has an inverse modulo 2^256 such\n // that denominator * inv = 1 mod 2^256. Compute the inverse by starting with a seed that is correct for\n // four bits. That is, denominator * inv = 1 mod 2^4.\n uint256 inverse = (3 * denominator) ^ 2;\n\n // Use the Newton-Raphson iteration to improve the precision. Thanks to Hensel's lifting lemma, this also works\n // in modular arithmetic, doubling the correct bits in each step.\n inverse *= 2 - denominator * inverse; // inverse mod 2^8\n inverse *= 2 - denominator * inverse; // inverse mod 2^16\n inverse *= 2 - denominator * inverse; // inverse mod 2^32\n inverse *= 2 - denominator * inverse; // inverse mod 2^64\n inverse *= 2 - denominator * inverse; // inverse mod 2^128\n inverse *= 2 - denominator * inverse; // inverse mod 2^256\n\n // Because the division is now exact we can divide by multiplying with the modular inverse of denominator.\n // This will give us the correct result modulo 2^256. Since the preconditions guarantee that the outcome is\n // less than 2^256, this is the final result. We don't need to compute the high bits of the result and prod1\n // is no longer required.\n result = prod0 * inverse;\n return result;\n }\n }\n\n /**\n * @notice Calculates x * y / denominator with full precision, following the selected rounding direction.\n */\n function mulDiv(uint256 x, uint256 y, uint256 denominator, Rounding rounding) internal pure returns (uint256) {\n uint256 result = mulDiv(x, y, denominator);\n if (rounding == Rounding.Up && mulmod(x, y, denominator) > 0) {\n result += 1;\n }\n return result;\n }\n\n /**\n * @dev Returns the square root of a number. If the number is not a perfect square, the value is rounded down.\n *\n * Inspired by Henry S. Warren, Jr.'s \"Hacker's Delight\" (Chapter 11).\n */\n function sqrt(uint256 a) internal pure returns (uint256) {\n if (a == 0) {\n return 0;\n }\n\n // For our first guess, we get the biggest power of 2 which is smaller than the square root of the target.\n //\n // We know that the \"msb\" (most significant bit) of our target number `a` is a power of 2 such that we have\n // `msb(a) <= a < 2*msb(a)`. This value can be written `msb(a)=2**k` with `k=log2(a)`.\n //\n // This can be rewritten `2**log2(a) <= a < 2**(log2(a) + 1)`\n // → `sqrt(2**k) <= sqrt(a) < sqrt(2**(k+1))`\n // → `2**(k/2) <= sqrt(a) < 2**((k+1)/2) <= 2**(k/2 + 1)`\n //\n // Consequently, `2**(log2(a) / 2)` is a good first approximation of `sqrt(a)` with at least 1 correct bit.\n uint256 result = 1 << (log2(a) >> 1);\n\n // At this point `result` is an estimation with one bit of precision. We know the true value is a uint128,\n // since it is the square root of a uint256. Newton's method converges quadratically (precision doubles at\n // every iteration). We thus need at most 7 iteration to turn our partial result with one bit of precision\n // into the expected uint128 result.\n unchecked {\n result = (result + a / result) >> 1;\n result = (result + a / result) >> 1;\n result = (result + a / result) >> 1;\n result = (result + a / result) >> 1;\n result = (result + a / result) >> 1;\n result = (result + a / result) >> 1;\n result = (result + a / result) >> 1;\n return min(result, a / result);\n }\n }\n\n /**\n * @notice Calculates sqrt(a), following the selected rounding direction.\n */\n function sqrt(uint256 a, Rounding rounding) internal pure returns (uint256) {\n unchecked {\n uint256 result = sqrt(a);\n return result + (rounding == Rounding.Up && result * result < a ? 1 : 0);\n }\n }\n\n /**\n * @dev Return the log in base 2, rounded down, of a positive value.\n * Returns 0 if given 0.\n */\n function log2(uint256 value) internal pure returns (uint256) {\n uint256 result = 0;\n unchecked {\n if (value >> 128 > 0) {\n value >>= 128;\n result += 128;\n }\n if (value >> 64 > 0) {\n value >>= 64;\n result += 64;\n }\n if (value >> 32 > 0) {\n value >>= 32;\n result += 32;\n }\n if (value >> 16 > 0) {\n value >>= 16;\n result += 16;\n }\n if (value >> 8 > 0) {\n value >>= 8;\n result += 8;\n }\n if (value >> 4 > 0) {\n value >>= 4;\n result += 4;\n }\n if (value >> 2 > 0) {\n value >>= 2;\n result += 2;\n }\n if (value >> 1 > 0) {\n result += 1;\n }\n }\n return result;\n }\n\n /**\n * @dev Return the log in base 2, following the selected rounding direction, of a positive value.\n * Returns 0 if given 0.\n */\n function log2(uint256 value, Rounding rounding) internal pure returns (uint256) {\n unchecked {\n uint256 result = log2(value);\n return result + (rounding == Rounding.Up && 1 << result < value ? 1 : 0);\n }\n }\n\n /**\n * @dev Return the log in base 10, rounded down, of a positive value.\n * Returns 0 if given 0.\n */\n function log10(uint256 value) internal pure returns (uint256) {\n uint256 result = 0;\n unchecked {\n if (value >= 10 ** 64) {\n value /= 10 ** 64;\n result += 64;\n }\n if (value >= 10 ** 32) {\n value /= 10 ** 32;\n result += 32;\n }\n if (value >= 10 ** 16) {\n value /= 10 ** 16;\n result += 16;\n }\n if (value >= 10 ** 8) {\n value /= 10 ** 8;\n result += 8;\n }\n if (value >= 10 ** 4) {\n value /= 10 ** 4;\n result += 4;\n }\n if (value >= 10 ** 2) {\n value /= 10 ** 2;\n result += 2;\n }\n if (value >= 10 ** 1) {\n result += 1;\n }\n }\n return result;\n }\n\n /**\n * @dev Return the log in base 10, following the selected rounding direction, of a positive value.\n * Returns 0 if given 0.\n */\n function log10(uint256 value, Rounding rounding) internal pure returns (uint256) {\n unchecked {\n uint256 result = log10(value);\n return result + (rounding == Rounding.Up && 10 ** result < value ? 1 : 0);\n }\n }\n\n /**\n * @dev Return the log in base 256, rounded down, of a positive value.\n * Returns 0 if given 0.\n *\n * Adding one to the result gives the number of pairs of hex symbols needed to represent `value` as a hex string.\n */\n function log256(uint256 value) internal pure returns (uint256) {\n uint256 result = 0;\n unchecked {\n if (value >> 128 > 0) {\n value >>= 128;\n result += 16;\n }\n if (value >> 64 > 0) {\n value >>= 64;\n result += 8;\n }\n if (value >> 32 > 0) {\n value >>= 32;\n result += 4;\n }\n if (value >> 16 > 0) {\n value >>= 16;\n result += 2;\n }\n if (value >> 8 > 0) {\n result += 1;\n }\n }\n return result;\n }\n\n /**\n * @dev Return the log in base 256, following the selected rounding direction, of a positive value.\n * Returns 0 if given 0.\n */\n function log256(uint256 value, Rounding rounding) internal pure returns (uint256) {\n unchecked {\n uint256 result = log256(value);\n return result + (rounding == Rounding.Up && 1 << (result << 3) < value ? 1 : 0);\n }\n }\n}\n"
- },
- "@openzeppelin/contracts/utils/math/SignedMath.sol": {
- "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.8.0) (utils/math/SignedMath.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @dev Standard signed math utilities missing in the Solidity language.\n */\nlibrary SignedMath {\n /**\n * @dev Returns the largest of two signed numbers.\n */\n function max(int256 a, int256 b) internal pure returns (int256) {\n return a > b ? a : b;\n }\n\n /**\n * @dev Returns the smallest of two signed numbers.\n */\n function min(int256 a, int256 b) internal pure returns (int256) {\n return a < b ? a : b;\n }\n\n /**\n * @dev Returns the average of two signed numbers without overflow.\n * The result is rounded towards zero.\n */\n function average(int256 a, int256 b) internal pure returns (int256) {\n // Formula from the book \"Hacker's Delight\"\n int256 x = (a & b) + ((a ^ b) >> 1);\n return x + (int256(uint256(x) >> 255) & (a ^ b));\n }\n\n /**\n * @dev Returns the absolute unsigned value of a signed value.\n */\n function abs(int256 n) internal pure returns (uint256) {\n unchecked {\n // must be unchecked in order to support `n = type(int256).min`\n return uint256(n >= 0 ? n : -n);\n }\n }\n}\n"
- },
- "@openzeppelin/contracts/utils/Strings.sol": {
- "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (utils/Strings.sol)\n\npragma solidity ^0.8.0;\n\nimport \"./math/Math.sol\";\nimport \"./math/SignedMath.sol\";\n\n/**\n * @dev String operations.\n */\nlibrary Strings {\n bytes16 private constant _SYMBOLS = \"0123456789abcdef\";\n uint8 private constant _ADDRESS_LENGTH = 20;\n\n /**\n * @dev Converts a `uint256` to its ASCII `string` decimal representation.\n */\n function toString(uint256 value) internal pure returns (string memory) {\n unchecked {\n uint256 length = Math.log10(value) + 1;\n string memory buffer = new string(length);\n uint256 ptr;\n /// @solidity memory-safe-assembly\n assembly {\n ptr := add(buffer, add(32, length))\n }\n while (true) {\n ptr--;\n /// @solidity memory-safe-assembly\n assembly {\n mstore8(ptr, byte(mod(value, 10), _SYMBOLS))\n }\n value /= 10;\n if (value == 0) break;\n }\n return buffer;\n }\n }\n\n /**\n * @dev Converts a `int256` to its ASCII `string` decimal representation.\n */\n function toString(int256 value) internal pure returns (string memory) {\n return string(abi.encodePacked(value < 0 ? \"-\" : \"\", toString(SignedMath.abs(value))));\n }\n\n /**\n * @dev Converts a `uint256` to its ASCII `string` hexadecimal representation.\n */\n function toHexString(uint256 value) internal pure returns (string memory) {\n unchecked {\n return toHexString(value, Math.log256(value) + 1);\n }\n }\n\n /**\n * @dev Converts a `uint256` to its ASCII `string` hexadecimal representation with fixed length.\n */\n function toHexString(uint256 value, uint256 length) internal pure returns (string memory) {\n bytes memory buffer = new bytes(2 * length + 2);\n buffer[0] = \"0\";\n buffer[1] = \"x\";\n for (uint256 i = 2 * length + 1; i > 1; --i) {\n buffer[i] = _SYMBOLS[value & 0xf];\n value >>= 4;\n }\n require(value == 0, \"Strings: hex length insufficient\");\n return string(buffer);\n }\n\n /**\n * @dev Converts an `address` with fixed length of 20 bytes to its not checksummed ASCII `string` hexadecimal representation.\n */\n function toHexString(address addr) internal pure returns (string memory) {\n return toHexString(uint256(uint160(addr)), _ADDRESS_LENGTH);\n }\n\n /**\n * @dev Returns true if the two strings are equal.\n */\n function equal(string memory a, string memory b) internal pure returns (bool) {\n return keccak256(bytes(a)) == keccak256(bytes(b));\n }\n}\n"
- },
- "contracts/erc7683/ERC7683.sol": {
- "content": "// SPDX-License-Identifier: GPL-3.0-or-later\npragma solidity ^0.8.0;\n\n/// @title GaslessCrossChainOrder CrossChainOrder type\n/// @notice Standard order struct to be signed by users, disseminated to fillers, and submitted to origin settler contracts\nstruct GaslessCrossChainOrder {\n /// @dev The contract address that the order is meant to be settled by.\n /// Fillers send this order to this contract address on the origin chain\n address originSettler;\n /// @dev The address of the user who is initiating the swap,\n /// whose input tokens will be taken and escrowed\n address user;\n /// @dev Nonce to be used as replay protection for the order\n uint256 nonce;\n /// @dev The chainId of the origin chain\n uint256 originChainId;\n /// @dev The timestamp by which the order must be opened\n uint32 openDeadline;\n /// @dev The timestamp by which the order must be filled on the destination chain\n uint32 fillDeadline;\n /// @dev Type identifier for the order data. This is an EIP-712 typehash.\n bytes32 orderDataType;\n /// @dev Arbitrary implementation-specific data\n /// Can be used to define tokens, amounts, destination chains, fees, settlement parameters,\n /// or any other order-type specific information\n bytes orderData;\n}\n\n/// @title OnchainCrossChainOrder CrossChainOrder type\n/// @notice Standard order struct for user-opened orders, where the user is the msg.sender.\nstruct OnchainCrossChainOrder {\n /// @dev The timestamp by which the order must be filled on the destination chain\n uint32 fillDeadline;\n /// @dev Type identifier for the order data. This is an EIP-712 typehash.\n bytes32 orderDataType;\n /// @dev Arbitrary implementation-specific data\n /// Can be used to define tokens, amounts, destination chains, fees, settlement parameters,\n /// or any other order-type specific information\n bytes orderData;\n}\n\n/// @title ResolvedCrossChainOrder type\n/// @notice An implementation-generic representation of an order intended for filler consumption\n/// @dev Defines all requirements for filling an order by unbundling the implementation-specific orderData.\n/// @dev Intended to improve integration generalization by allowing fillers to compute the exact input and output information of any order\nstruct ResolvedCrossChainOrder {\n /// @dev The address of the user who is initiating the transfer\n address user;\n /// @dev The chainId of the origin chain\n uint256 originChainId;\n /// @dev The timestamp by which the order must be opened\n uint32 openDeadline;\n /// @dev The timestamp by which the order must be filled on the destination chain(s)\n uint32 fillDeadline;\n /// @dev The unique identifier for this order within this settlement system\n bytes32 orderId;\n /// @dev The max outputs that the filler will send. It's possible the actual amount depends on the state of the destination\n /// chain (destination dutch auction, for instance), so these outputs should be considered a cap on filler liabilities.\n Output[] maxSpent;\n /// @dev The minimum outputs that must to be given to the filler as part of order settlement. Similar to maxSpent, it's possible\n /// that special order types may not be able to guarantee the exact amount at open time, so this should be considered\n /// a floor on filler receipts.\n Output[] minReceived;\n /// @dev Each instruction in this array is parameterizes a single leg of the fill. This provides the filler with the information\n /// necessary to perform the fill on the destination(s).\n FillInstruction[] fillInstructions;\n}\n\n/// @notice Tokens that must be receive for a valid order fulfillment\nstruct Output {\n /// @dev The address of the ERC20 token on the destination chain\n /// @dev address(0) used as a sentinel for the native token\n bytes32 token;\n /// @dev The amount of the token to be sent\n uint256 amount;\n /// @dev The address to receive the output tokens\n bytes32 recipient;\n /// @dev The destination chain for this output\n uint256 chainId;\n}\n\n/// @title FillInstruction type\n/// @notice Instructions to parameterize each leg of the fill\n/// @dev Provides all the origin-generated information required to produce a valid fill leg\nstruct FillInstruction {\n /// @dev The contract address that the order is meant to be settled by\n uint64 destinationChainId;\n /// @dev The contract address that the order is meant to be filled on\n bytes32 destinationSettler;\n /// @dev The data generated on the origin chain needed by the destinationSettler to process the fill\n bytes originData;\n}\n\n/// @title IOriginSettler\n/// @notice Standard interface for settlement contracts on the origin chain\ninterface IOriginSettler {\n /// @notice Signals that an order has been opened\n /// @param orderId a unique order identifier within this settlement system\n /// @param resolvedOrder resolved order that would be returned by resolve if called instead of Open\n event Open(bytes32 indexed orderId, ResolvedCrossChainOrder resolvedOrder);\n\n /// @notice Opens a gasless cross-chain order on behalf of a user.\n /// @dev To be called by the filler.\n /// @dev This method must emit the Open event\n /// @param order The GaslessCrossChainOrder definition\n /// @param signature The user's signature over the order\n /// @param originFillerData Any filler-defined data required by the settler\n function openFor(\n GaslessCrossChainOrder calldata order,\n bytes calldata signature,\n bytes calldata originFillerData\n ) external;\n\n /// @notice Opens a cross-chain order\n /// @dev To be called by the user\n /// @dev This method must emit the Open event\n /// @param order The OnchainCrossChainOrder definition\n function open(OnchainCrossChainOrder calldata order) external;\n\n /// @notice Resolves a specific GaslessCrossChainOrder into a generic ResolvedCrossChainOrder\n /// @dev Intended to improve standardized integration of various order types and settlement contracts\n /// @param order The GaslessCrossChainOrder definition\n /// @param originFillerData Any filler-defined data required by the settler\n /// @return ResolvedCrossChainOrder hydrated order data including the inputs and outputs of the order\n function resolveFor(GaslessCrossChainOrder calldata order, bytes calldata originFillerData)\n external\n view\n returns (ResolvedCrossChainOrder memory);\n\n /// @notice Resolves a specific OnchainCrossChainOrder into a generic ResolvedCrossChainOrder\n /// @dev Intended to improve standardized integration of various order types and settlement contracts\n /// @param order The OnchainCrossChainOrder definition\n /// @return ResolvedCrossChainOrder hydrated order data including the inputs and outputs of the order\n function resolve(OnchainCrossChainOrder calldata order) external view returns (ResolvedCrossChainOrder memory);\n}\n\n/// @title IDestinationSettler\n/// @notice Standard interface for settlement contracts on the destination chain\ninterface IDestinationSettler {\n /// @notice Fills a single leg of a particular order on the destination chain\n /// @param orderId Unique order identifier for this order\n /// @param originData Data emitted on the origin to parameterize the fill\n /// @param fillerData Data provided by the filler to inform the fill or express their preferences\n function fill(\n bytes32 orderId,\n bytes calldata originData,\n bytes calldata fillerData\n ) external;\n}\n"
- },
- "contracts/erc7683/ERC7683Permit2Lib.sol": {
- "content": "// SPDX-License-Identifier: UNLICENSED\npragma solidity ^0.8.0;\n\nimport \"../external/interfaces/IPermit2.sol\";\nimport { GaslessCrossChainOrder } from \"./ERC7683.sol\";\n\n// Data unique to every CrossChainOrder settled on Across\nstruct AcrossOrderData {\n address inputToken;\n uint256 inputAmount;\n address outputToken;\n uint256 outputAmount;\n uint256 destinationChainId;\n bytes32 recipient;\n address exclusiveRelayer;\n /// @notice User needs to be careful not to re-use a deposit nonce when depositing into Across otherwise the\n /// user risks their deposit being unfillable. See @across/contracts/SpokePool.sol#unsafeDeposit() for\n /// more details on this situation.\n uint256 depositNonce;\n uint32 exclusivityPeriod;\n bytes message;\n}\n\nstruct AcrossOriginFillerData {\n address exclusiveRelayer;\n}\n\nstruct AcrossDestinationFillerData {\n uint256 repaymentChainId;\n}\n\nbytes constant ACROSS_ORDER_DATA_TYPE = abi.encodePacked(\n \"AcrossOrderData(\",\n \"address inputToken,\",\n \"uint256 inputAmount,\",\n \"address outputToken,\",\n \"uint256 outputAmount,\",\n \"uint256 destinationChainId,\",\n \"bytes32 recipient,\",\n \"address exclusiveRelayer,\"\n \"uint256 depositNonce,\",\n \"uint32 exclusivityPeriod,\",\n \"bytes message)\"\n);\n\nbytes32 constant ACROSS_ORDER_DATA_TYPE_HASH = keccak256(ACROSS_ORDER_DATA_TYPE);\n\n/**\n * @notice ERC7683Permit2Lib knows how to process a particular type of external Permit2Order so that it can be used in Across.\n * @dev This library is responsible for definining the ERC712 type strings/hashes and performing hashes on the types.\n * @custom:security-contact bugs@across.to\n */\nlibrary ERC7683Permit2Lib {\n bytes internal constant GASLESS_CROSS_CHAIN_ORDER_TYPE =\n abi.encodePacked(\n \"GaslessCrossChainOrder(\",\n \"address originSettler,\",\n \"address user,\",\n \"uint256 nonce,\",\n \"uint256 originChainId,\",\n \"uint32 openDeadline,\",\n \"uint32 fillDeadline,\",\n \"bytes32 orderDataType,\",\n \"AcrossOrderData orderData)\"\n );\n\n bytes internal constant GASLESS_CROSS_CHAIN_ORDER_EIP712_TYPE =\n abi.encodePacked(GASLESS_CROSS_CHAIN_ORDER_TYPE, ACROSS_ORDER_DATA_TYPE);\n bytes32 internal constant GASLESS_CROSS_CHAIN_ORDER_TYPE_HASH = keccak256(GASLESS_CROSS_CHAIN_ORDER_EIP712_TYPE);\n\n string private constant TOKEN_PERMISSIONS_TYPE = \"TokenPermissions(address token,uint256 amount)\";\n string internal constant PERMIT2_ORDER_TYPE =\n string(\n abi.encodePacked(\n \"GaslessCrossChainOrder witness)\",\n ACROSS_ORDER_DATA_TYPE,\n GASLESS_CROSS_CHAIN_ORDER_TYPE,\n TOKEN_PERMISSIONS_TYPE\n )\n );\n\n // Hashes an order to get an order hash. Needed for permit2.\n function hashOrder(GaslessCrossChainOrder memory order, bytes32 orderDataHash) internal pure returns (bytes32) {\n return\n keccak256(\n abi.encode(\n GASLESS_CROSS_CHAIN_ORDER_TYPE_HASH,\n order.originSettler,\n order.user,\n order.nonce,\n order.originChainId,\n order.openDeadline,\n order.fillDeadline,\n order.orderDataType,\n orderDataHash\n )\n );\n }\n\n function hashOrderData(AcrossOrderData memory orderData) internal pure returns (bytes32) {\n return\n keccak256(\n abi.encode(\n ACROSS_ORDER_DATA_TYPE_HASH,\n orderData.inputToken,\n orderData.inputAmount,\n orderData.outputToken,\n orderData.outputAmount,\n orderData.destinationChainId,\n orderData.recipient,\n orderData.exclusiveRelayer,\n orderData.depositNonce,\n orderData.exclusivityPeriod,\n keccak256(orderData.message)\n )\n );\n }\n}\n"
- },
- "contracts/external/interfaces/CCTPInterfaces.sol": {
- "content": "/**\n * Copyright (C) 2015, 2016, 2017 Dapphub\n *\n * This program is free software: you can redistribute it and/or modify\n * it under the terms of the GNU General Public License as published by\n * the Free Software Foundation, either version 3 of the License, or\n * (at your option) any later version.\n *\n * This program is distributed in the hope that it will be useful,\n * but WITHOUT ANY WARRANTY; without even the implied warranty of\n * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the\n * GNU General Public License for more details.\n *\n * You should have received a copy of the GNU General Public License\n * along with this program. If not, see .\n */\n\n// SPDX-License-Identifier: GPL-3.0-or-later\npragma solidity ^0.8.0;\n\n/**\n * Imported as-is from commit 139d8d0ce3b5531d3c7ec284f89d946dfb720016 of:\n * * https://github.com/walkerq/evm-cctp-contracts/blob/139d8d0ce3b5531d3c7ec284f89d946dfb720016/src/TokenMessenger.sol\n * Changes applied post-import:\n * * Removed a majority of code from this contract and converted the needed function signatures in this interface.\n */\ninterface ITokenMessenger {\n /**\n * @notice Deposits and burns tokens from sender to be minted on destination domain.\n * Emits a `DepositForBurn` event.\n * @dev reverts if:\n * - given burnToken is not supported\n * - given destinationDomain has no TokenMessenger registered\n * - transferFrom() reverts. For example, if sender's burnToken balance or approved allowance\n * to this contract is less than `amount`.\n * - burn() reverts. For example, if `amount` is 0.\n * - MessageTransmitter returns false or reverts.\n * @param amount amount of tokens to burn\n * @param destinationDomain destination domain\n * @param mintRecipient address of mint recipient on destination domain\n * @param burnToken address of contract to burn deposited tokens, on local domain\n * @return _nonce unique nonce reserved by message\n */\n function depositForBurn(\n uint256 amount,\n uint32 destinationDomain,\n bytes32 mintRecipient,\n address burnToken\n ) external returns (uint64 _nonce);\n\n /**\n * @notice Minter responsible for minting and burning tokens on the local domain\n * @dev A TokenMessenger stores a TokenMinter contract which extends the TokenController contract.\n * https://github.com/circlefin/evm-cctp-contracts/blob/817397db0a12963accc08ff86065491577bbc0e5/src/TokenMessenger.sol#L110\n * @return minter Token Minter contract.\n */\n function localMinter() external view returns (ITokenMinter minter);\n}\n\n// Source: https://github.com/circlefin/evm-cctp-contracts/blob/63ab1f0ac06ce0793c0bbfbb8d09816bc211386d/src/v2/TokenMessengerV2.sol#L138C1-L166C15\ninterface ITokenMessengerV2 {\n /**\n * @notice Deposits and burns tokens from sender to be minted on destination domain.\n * Emits a `DepositForBurn` event.\n * @dev reverts if:\n * - given burnToken is not supported\n * - given destinationDomain has no TokenMessenger registered\n * - transferFrom() reverts. For example, if sender's burnToken balance or approved allowance\n * to this contract is less than `amount`.\n * - burn() reverts. For example, if `amount` is 0.\n * - maxFee is greater than or equal to `amount`.\n * - MessageTransmitterV2#sendMessage reverts.\n * @param amount amount of tokens to burn\n * @param destinationDomain destination domain to receive message on\n * @param mintRecipient address of mint recipient on destination domain\n * @param burnToken token to burn `amount` of, on local domain\n * @param destinationCaller authorized caller on the destination domain, as bytes32. If equal to bytes32(0),\n * any address can broadcast the message.\n * @param maxFee maximum fee to pay on the destination domain, specified in units of burnToken\n * @param minFinalityThreshold the minimum finality at which a burn message will be attested to.\n */\n function depositForBurn(\n uint256 amount,\n uint32 destinationDomain,\n bytes32 mintRecipient,\n address burnToken,\n bytes32 destinationCaller,\n uint256 maxFee,\n uint32 minFinalityThreshold\n ) external;\n}\n\n/**\n * A TokenMessenger stores a TokenMinter contract which extends the TokenController contract. The TokenController\n * contract has a burnLimitsPerMessage public mapping which can be queried to find the per-message burn limit\n * for a given token:\n * https://github.com/circlefin/evm-cctp-contracts/blob/817397db0a12963accc08ff86065491577bbc0e5/src/TokenMinter.sol#L33\n * https://github.com/circlefin/evm-cctp-contracts/blob/817397db0a12963accc08ff86065491577bbc0e5/src/roles/TokenController.sol#L69C40-L69C60\n *\n */\ninterface ITokenMinter {\n /**\n * @notice Supported burnable tokens on the local domain\n * local token (address) => maximum burn amounts per message\n * @param token address of token contract\n * @return burnLimit maximum burn amount per message for token\n */\n function burnLimitsPerMessage(address token) external view returns (uint256);\n}\n\n/**\n * IMessageTransmitter in CCTP inherits IRelayer and IReceiver, but here we only import sendMessage from IRelayer:\n * https://github.com/circlefin/evm-cctp-contracts/blob/377c9bd813fb86a42d900ae4003599d82aef635a/src/interfaces/IMessageTransmitter.sol#L25\n * https://github.com/circlefin/evm-cctp-contracts/blob/377c9bd813fb86a42d900ae4003599d82aef635a/src/interfaces/IRelayer.sol#L23-L35\n */\ninterface IMessageTransmitter {\n /**\n * @notice Sends an outgoing message from the source domain.\n * @dev Increment nonce, format the message, and emit `MessageSent` event with message information.\n * @param destinationDomain Domain of destination chain\n * @param recipient Address of message recipient on destination domain as bytes32\n * @param messageBody Raw bytes content of message\n * @return nonce reserved by message\n */\n function sendMessage(\n uint32 destinationDomain,\n bytes32 recipient,\n bytes calldata messageBody\n ) external returns (uint64);\n}\n"
- },
- "contracts/external/interfaces/IPermit2.sol": {
- "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\ninterface IPermit2 {\n struct TokenPermissions {\n address token;\n uint256 amount;\n }\n\n struct PermitTransferFrom {\n TokenPermissions permitted;\n uint256 nonce;\n uint256 deadline;\n }\n\n struct SignatureTransferDetails {\n address to;\n uint256 requestedAmount;\n }\n\n function permitWitnessTransferFrom(\n PermitTransferFrom memory permit,\n SignatureTransferDetails calldata transferDetails,\n address owner,\n bytes32 witness,\n string calldata witnessTypeString,\n bytes calldata signature\n ) external;\n\n function transferFrom(\n address from,\n address to,\n uint160 amount,\n address token\n ) external;\n}\n"
- },
- "contracts/external/interfaces/WETH9Interface.sol": {
- "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\n\n/**\n * @notice Interface for the WETH9 contract.\n */\ninterface WETH9Interface {\n /**\n * @notice Burn Wrapped Ether and receive native Ether.\n * @param wad Amount of WETH to unwrap and send to caller.\n */\n function withdraw(uint256 wad) external;\n\n /**\n * @notice Lock native Ether and mint Wrapped Ether ERC20\n * @dev msg.value is amount of Wrapped Ether to mint/Ether to lock.\n */\n function deposit() external payable;\n\n /**\n * @notice Get balance of WETH held by `guy`.\n * @param guy Address to get balance of.\n * @return wad Amount of WETH held by `guy`.\n */\n function balanceOf(address guy) external view returns (uint256 wad);\n\n /**\n * @notice Transfer `wad` of WETH from caller to `guy`.\n * @param guy Address to send WETH to.\n * @param wad Amount of WETH to send.\n * @return ok True if transfer succeeded.\n */\n function transfer(address guy, uint256 wad) external returns (bool);\n}\n"
- },
- "contracts/interfaces/HubPoolInterface.sol": {
- "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport \"@openzeppelin/contracts/token/ERC20/IERC20.sol\";\n\n/**\n * @notice Concise list of functions in HubPool implementation.\n */\ninterface HubPoolInterface {\n // This leaf is meant to be decoded in the HubPool to rebalance tokens between HubPool and SpokePool.\n struct PoolRebalanceLeaf {\n // This is used to know which chain to send cross-chain transactions to (and which SpokePool to send to).\n uint256 chainId;\n // Total LP fee amount per token in this bundle, encompassing all associated bundled relays.\n uint256[] bundleLpFees;\n // Represents the amount to push to or pull from the SpokePool. If +, the pool pays the SpokePool. If negative\n // the SpokePool pays the HubPool. There can be arbitrarily complex rebalancing rules defined offchain. This\n // number is only nonzero when the rules indicate that a rebalancing action should occur. When a rebalance does\n // occur, runningBalances must be set to zero for this token and netSendAmounts should be set to the previous\n // runningBalances + relays - deposits in this bundle. If non-zero then it must be set on the SpokePool's\n // RelayerRefundLeaf amountToReturn as -1 * this value to show if funds are being sent from or to the SpokePool.\n int256[] netSendAmounts;\n // This is only here to be emitted in an event to track a running unpaid balance between the L2 pool and the L1\n // pool. A positive number indicates that the HubPool owes the SpokePool funds. A negative number indicates that\n // the SpokePool owes the HubPool funds. See the comment above for the dynamics of this and netSendAmounts.\n int256[] runningBalances;\n // Used by data worker to mark which leaves should relay roots to SpokePools, and to otherwise organize leaves.\n // For example, each leaf should contain all the rebalance information for a single chain, but in the case where\n // the list of l1Tokens is very large such that they all can't fit into a single leaf that can be executed under\n // the block gas limit, then the data worker can use this groupIndex to organize them. Any leaves with\n // a groupIndex equal to 0 will relay roots to the SpokePool, so the data worker should ensure that only one\n // leaf for a specific chainId should have a groupIndex equal to 0.\n uint256 groupIndex;\n // Used as the index in the bitmap to track whether this leaf has been executed or not.\n uint8 leafId;\n // The bundleLpFees, netSendAmounts, and runningBalances are required to be the same length. They are parallel\n // arrays for the given chainId and should be ordered by the l1Tokens field. All whitelisted tokens with nonzero\n // relays on this chain in this bundle in the order of whitelisting.\n address[] l1Tokens;\n }\n\n // A data worker can optimistically store several merkle roots on this contract by staking a bond and calling\n // proposeRootBundle. By staking a bond, the data worker is alleging that the merkle roots all contain valid leaves\n // that can be executed later to:\n // - Send funds from this contract to a SpokePool or vice versa\n // - Send funds from a SpokePool to Relayer as a refund for a relayed deposit\n // - Send funds from a SpokePool to a deposit recipient to fulfill a \"slow\" relay\n // Anyone can dispute this struct if the merkle roots contain invalid leaves before the\n // challengePeriodEndTimestamp. Once the expiration timestamp is passed, executeRootBundle to execute a leaf\n // from the poolRebalanceRoot on this contract and it will simultaneously publish the relayerRefundRoot and\n // slowRelayRoot to a SpokePool. The latter two roots, once published to the SpokePool, contain\n // leaves that can be executed on the SpokePool to pay relayers or recipients.\n struct RootBundle {\n // Contains leaves instructing this contract to send funds to SpokePools.\n bytes32 poolRebalanceRoot;\n // Relayer refund merkle root to be published to a SpokePool.\n bytes32 relayerRefundRoot;\n // Slow relay merkle root to be published to a SpokePool.\n bytes32 slowRelayRoot;\n // This is a 1D bitmap, with max size of 256 elements, limiting us to 256 chainsIds.\n uint256 claimedBitMap;\n // Proposer of this root bundle.\n address proposer;\n // Number of pool rebalance leaves to execute in the poolRebalanceRoot. After this number\n // of leaves are executed, a new root bundle can be proposed\n uint8 unclaimedPoolRebalanceLeafCount;\n // When root bundle challenge period passes and this root bundle becomes executable.\n uint32 challengePeriodEndTimestamp;\n }\n\n // Each whitelisted L1 token has an associated pooledToken struct that contains all information used to track the\n // cumulative LP positions and if this token is enabled for deposits.\n struct PooledToken {\n // LP token given to LPs of a specific L1 token.\n address lpToken;\n // True if accepting new LP's.\n bool isEnabled;\n // Timestamp of last LP fee update.\n uint32 lastLpFeeUpdate;\n // Number of LP funds sent via pool rebalances to SpokePools and are expected to be sent\n // back later.\n int256 utilizedReserves;\n // Number of LP funds held in contract less utilized reserves.\n uint256 liquidReserves;\n // Number of LP funds reserved to pay out to LPs as fees.\n uint256 undistributedLpFees;\n }\n\n // Helper contracts to facilitate cross chain actions between HubPool and SpokePool for a specific network.\n struct CrossChainContract {\n address adapter;\n address spokePool;\n }\n\n function setPaused(bool pause) external;\n\n function emergencyDeleteProposal() external;\n\n function relaySpokePoolAdminFunction(uint256 chainId, bytes memory functionData) external;\n\n function setProtocolFeeCapture(address newProtocolFeeCaptureAddress, uint256 newProtocolFeeCapturePct) external;\n\n function setBond(IERC20 newBondToken, uint256 newBondAmount) external;\n\n function setLiveness(uint32 newLiveness) external;\n\n function setIdentifier(bytes32 newIdentifier) external;\n\n function setCrossChainContracts(\n uint256 l2ChainId,\n address adapter,\n address spokePool\n ) external;\n\n function enableL1TokenForLiquidityProvision(address l1Token) external;\n\n function disableL1TokenForLiquidityProvision(address l1Token) external;\n\n function addLiquidity(address l1Token, uint256 l1TokenAmount) external payable;\n\n function removeLiquidity(\n address l1Token,\n uint256 lpTokenAmount,\n bool sendEth\n ) external;\n\n function exchangeRateCurrent(address l1Token) external returns (uint256);\n\n function liquidityUtilizationCurrent(address l1Token) external returns (uint256);\n\n function liquidityUtilizationPostRelay(address l1Token, uint256 relayedAmount) external returns (uint256);\n\n function sync(address l1Token) external;\n\n function proposeRootBundle(\n uint256[] memory bundleEvaluationBlockNumbers,\n uint8 poolRebalanceLeafCount,\n bytes32 poolRebalanceRoot,\n bytes32 relayerRefundRoot,\n bytes32 slowRelayRoot\n ) external;\n\n function executeRootBundle(\n uint256 chainId,\n uint256 groupIndex,\n uint256[] memory bundleLpFees,\n int256[] memory netSendAmounts,\n int256[] memory runningBalances,\n uint8 leafId,\n address[] memory l1Tokens,\n bytes32[] memory proof\n ) external;\n\n function disputeRootBundle() external;\n\n function claimProtocolFeesCaptured(address l1Token) external;\n\n function setPoolRebalanceRoute(\n uint256 destinationChainId,\n address l1Token,\n address destinationToken\n ) external;\n\n function setDepositRoute(\n uint256 originChainId,\n uint256 destinationChainId,\n address originToken,\n bool depositsEnabled\n ) external;\n\n function poolRebalanceRoute(uint256 destinationChainId, address l1Token)\n external\n view\n returns (address destinationToken);\n\n function loadEthForL2Calls() external payable;\n}\n"
- },
- "contracts/interfaces/SpokePoolInterface.sol": {
- "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\n/**\n * @notice Contains common data structures and functions used by all SpokePool implementations.\n */\ninterface SpokePoolInterface {\n // This leaf is meant to be decoded in the SpokePool to pay out successful relayers.\n struct RelayerRefundLeaf {\n // This is the amount to return to the HubPool. This occurs when there is a PoolRebalanceLeaf netSendAmount that\n // is negative. This is just the negative of this value.\n uint256 amountToReturn;\n // Used to verify that this is being executed on the correct destination chainId.\n uint256 chainId;\n // This array designates how much each of those addresses should be refunded.\n uint256[] refundAmounts;\n // Used as the index in the bitmap to track whether this leaf has been executed or not.\n uint32 leafId;\n // The associated L2TokenAddress that these claims apply to.\n address l2TokenAddress;\n // Must be same length as refundAmounts and designates each address that must be refunded.\n address[] refundAddresses;\n }\n\n // Stores collection of merkle roots that can be published to this contract from the HubPool, which are referenced\n // by \"data workers\" via inclusion proofs to execute leaves in the roots.\n struct RootBundle {\n // Merkle root of slow relays that were not fully filled and whose recipient is still owed funds from the LP pool.\n bytes32 slowRelayRoot;\n // Merkle root of relayer refunds for successful relays.\n bytes32 relayerRefundRoot;\n // This is a 2D bitmap tracking which leaves in the relayer refund root have been claimed, with max size of\n // 256x(2^248) leaves per root.\n mapping(uint256 => uint256) claimedBitmap;\n }\n\n function setCrossDomainAdmin(address newCrossDomainAdmin) external;\n\n function setWithdrawalRecipient(address newWithdrawalRecipient) external;\n\n function pauseDeposits(bool pause) external;\n\n function pauseFills(bool pause) external;\n\n function relayRootBundle(bytes32 relayerRefundRoot, bytes32 slowRelayRoot) external;\n\n function emergencyDeleteRootBundle(uint256 rootBundleId) external;\n\n function depositDeprecated_5947912356(\n address recipient,\n address originToken,\n uint256 amount,\n uint256 destinationChainId,\n int64 relayerFeePct,\n uint32 quoteTimestamp,\n bytes memory message,\n uint256 maxCount\n ) external payable;\n\n function depositFor(\n address depositor,\n address recipient,\n address originToken,\n uint256 amount,\n uint256 destinationChainId,\n int64 relayerFeePct,\n uint32 quoteTimestamp,\n bytes memory message,\n uint256 maxCount\n ) external payable;\n\n function executeRelayerRefundLeaf(\n uint32 rootBundleId,\n SpokePoolInterface.RelayerRefundLeaf memory relayerRefundLeaf,\n bytes32[] memory proof\n ) external payable;\n\n function chainId() external view returns (uint256);\n\n error NotEOA();\n error InvalidDepositorSignature();\n error InvalidRelayerFeePct();\n error MaxTransferSizeExceeded();\n error InvalidCrossDomainAdmin();\n error InvalidWithdrawalRecipient();\n error DepositsArePaused();\n error FillsArePaused();\n}\n"
- },
- "contracts/interfaces/SpokePoolMessageHandler.sol": {
- "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\n// This interface is expected to be implemented by any contract that expects to receive messages from the SpokePool.\ninterface AcrossMessageHandler {\n function handleV3AcrossMessage(\n address tokenSent,\n uint256 amount,\n address relayer,\n bytes memory message\n ) external;\n}\n"
- },
- "contracts/interfaces/V3SpokePoolInterface.sol": {
- "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\n// Contains structs and functions used by SpokePool contracts to facilitate universal settlement.\ninterface V3SpokePoolInterface {\n /**************************************\n * ENUMS *\n **************************************/\n\n // Fill status tracks on-chain state of deposit, uniquely identified by relayHash.\n enum FillStatus {\n Unfilled,\n RequestedSlowFill,\n Filled\n }\n // Fill type is emitted in the FilledRelay event to assist Dataworker with determining which types of\n // fills to refund (e.g. only fast fills) and whether a fast fill created a sow fill excess.\n enum FillType {\n FastFill,\n // Fast fills are normal fills that do not replace a slow fill request.\n ReplacedSlowFill,\n // Replaced slow fills are fast fills that replace a slow fill request. This type is used by the Dataworker\n // to know when to send excess funds from the SpokePool to the HubPool because they can no longer be used\n // for a slow fill execution.\n SlowFill\n }\n // Slow fills are requested via requestSlowFill and executed by executeSlowRelayLeaf after a bundle containing\n // the slow fill is validated.\n\n /**************************************\n * STRUCTS *\n **************************************/\n\n // This struct represents the data to fully specify a **unique** relay submitted on this chain.\n // This data is hashed with the chainId() and saved by the SpokePool to prevent collisions and protect against\n // replay attacks on other chains. If any portion of this data differs, the relay is considered to be\n // completely distinct.\n struct V3RelayData {\n // The bytes32 that made the deposit on the origin chain.\n bytes32 depositor;\n // The recipient bytes32 on the destination chain.\n bytes32 recipient;\n // This is the exclusive relayer who can fill the deposit before the exclusivity deadline.\n bytes32 exclusiveRelayer;\n // Token that is deposited on origin chain by depositor.\n bytes32 inputToken;\n // Token that is received on destination chain by recipient.\n bytes32 outputToken;\n // The amount of input token deposited by depositor.\n uint256 inputAmount;\n // The amount of output token to be received by recipient.\n uint256 outputAmount;\n // Origin chain id.\n uint256 originChainId;\n // The id uniquely identifying this deposit on the origin chain.\n uint256 depositId;\n // The timestamp on the destination chain after which this deposit can no longer be filled.\n uint32 fillDeadline;\n // The timestamp on the destination chain after which any relayer can fill the deposit.\n uint32 exclusivityDeadline;\n // Data that is forwarded to the recipient.\n bytes message;\n }\n\n // Same as V3RelayData but using addresses instead of bytes32 & depositId is uint32.\n // Will be deprecated in favor of V3RelayData in the future.\n struct V3RelayDataLegacy {\n address depositor;\n address recipient;\n address exclusiveRelayer;\n address inputToken;\n address outputToken;\n uint256 inputAmount;\n uint256 outputAmount;\n uint256 originChainId;\n uint32 depositId;\n uint32 fillDeadline;\n uint32 exclusivityDeadline;\n bytes message;\n }\n\n // Contains parameters passed in by someone who wants to execute a slow relay leaf.\n struct V3SlowFill {\n V3RelayData relayData;\n uint256 chainId;\n uint256 updatedOutputAmount;\n }\n\n // Contains information about a relay to be sent along with additional information that is not unique to the\n // relay itself but is required to know how to process the relay. For example, \"updatedX\" fields can be used\n // by the relayer to modify fields of the relay with the depositor's permission, and \"repaymentChainId\" is specified\n // by the relayer to determine where to take a relayer refund, but doesn't affect the uniqueness of the relay.\n struct V3RelayExecutionParams {\n V3RelayData relay;\n bytes32 relayHash;\n uint256 updatedOutputAmount;\n bytes32 updatedRecipient;\n bytes updatedMessage;\n uint256 repaymentChainId;\n }\n\n // Packs together parameters emitted in FilledRelay because there are too many emitted otherwise.\n // Similar to V3RelayExecutionParams, these parameters are not used to uniquely identify the deposit being\n // filled so they don't have to be unpacked by all clients.\n struct V3RelayExecutionEventInfo {\n bytes32 updatedRecipient;\n bytes32 updatedMessageHash;\n uint256 updatedOutputAmount;\n FillType fillType;\n }\n\n // Represents the parameters required for a V3 deposit operation in the SpokePool.\n struct DepositV3Params {\n bytes32 depositor;\n bytes32 recipient;\n bytes32 inputToken;\n bytes32 outputToken;\n uint256 inputAmount;\n uint256 outputAmount;\n uint256 destinationChainId;\n bytes32 exclusiveRelayer;\n uint256 depositId;\n uint32 quoteTimestamp;\n uint32 fillDeadline;\n uint32 exclusivityParameter;\n bytes message;\n }\n\n /**************************************\n * EVENTS *\n **************************************/\n\n event FundsDeposited(\n bytes32 inputToken,\n bytes32 outputToken,\n uint256 inputAmount,\n uint256 outputAmount,\n uint256 indexed destinationChainId,\n uint256 indexed depositId,\n uint32 quoteTimestamp,\n uint32 fillDeadline,\n uint32 exclusivityDeadline,\n bytes32 indexed depositor,\n bytes32 recipient,\n bytes32 exclusiveRelayer,\n bytes message\n );\n\n event RequestedSpeedUpDeposit(\n uint256 updatedOutputAmount,\n uint256 indexed depositId,\n bytes32 indexed depositor,\n bytes32 updatedRecipient,\n bytes updatedMessage,\n bytes depositorSignature\n );\n\n event FilledRelay(\n bytes32 inputToken,\n bytes32 outputToken,\n uint256 inputAmount,\n uint256 outputAmount,\n uint256 repaymentChainId,\n uint256 indexed originChainId,\n uint256 indexed depositId,\n uint32 fillDeadline,\n uint32 exclusivityDeadline,\n bytes32 exclusiveRelayer,\n bytes32 indexed relayer,\n bytes32 depositor,\n bytes32 recipient,\n bytes32 messageHash,\n V3RelayExecutionEventInfo relayExecutionInfo\n );\n\n event RequestedSlowFill(\n bytes32 inputToken,\n bytes32 outputToken,\n uint256 inputAmount,\n uint256 outputAmount,\n uint256 indexed originChainId,\n uint256 indexed depositId,\n uint32 fillDeadline,\n uint32 exclusivityDeadline,\n bytes32 exclusiveRelayer,\n bytes32 depositor,\n bytes32 recipient,\n bytes32 messageHash\n );\n\n event ClaimedRelayerRefund(\n bytes32 indexed l2TokenAddress,\n bytes32 indexed refundAddress,\n uint256 amount,\n address indexed caller\n );\n\n /**************************************\n * FUNCTIONS *\n **************************************/\n\n function deposit(\n bytes32 depositor,\n bytes32 recipient,\n bytes32 inputToken,\n bytes32 outputToken,\n uint256 inputAmount,\n uint256 outputAmount,\n uint256 destinationChainId,\n bytes32 exclusiveRelayer,\n uint32 quoteTimestamp,\n uint32 fillDeadline,\n uint32 exclusivityDeadline,\n bytes calldata message\n ) external payable;\n\n function depositV3(\n address depositor,\n address recipient,\n address inputToken,\n address outputToken,\n uint256 inputAmount,\n uint256 outputAmount,\n uint256 destinationChainId,\n address exclusiveRelayer,\n uint32 quoteTimestamp,\n uint32 fillDeadline,\n uint32 exclusivityDeadline,\n bytes calldata message\n ) external payable;\n\n function depositNow(\n bytes32 depositor,\n bytes32 recipient,\n bytes32 inputToken,\n bytes32 outputToken,\n uint256 inputAmount,\n uint256 outputAmount,\n uint256 destinationChainId,\n bytes32 exclusiveRelayer,\n uint32 fillDeadlineOffset,\n uint32 exclusivityDeadline,\n bytes calldata message\n ) external payable;\n\n function depositV3Now(\n address depositor,\n address recipient,\n address inputToken,\n address outputToken,\n uint256 inputAmount,\n uint256 outputAmount,\n uint256 destinationChainId,\n address exclusiveRelayer,\n uint32 fillDeadlineOffset,\n uint32 exclusivityDeadline,\n bytes calldata message\n ) external payable;\n\n function unsafeDeposit(\n bytes32 depositor,\n bytes32 recipient,\n bytes32 inputToken,\n bytes32 outputToken,\n uint256 inputAmount,\n uint256 outputAmount,\n uint256 destinationChainId,\n bytes32 exclusiveRelayer,\n uint256 depositNonce,\n uint32 quoteTimestamp,\n uint32 fillDeadline,\n uint32 exclusivityParameter,\n bytes calldata message\n ) external payable;\n\n function speedUpDeposit(\n bytes32 depositor,\n uint256 depositId,\n uint256 updatedOutputAmount,\n bytes32 updatedRecipient,\n bytes calldata updatedMessage,\n bytes calldata depositorSignature\n ) external;\n\n function speedUpV3Deposit(\n address depositor,\n uint256 depositId,\n uint256 updatedOutputAmount,\n address updatedRecipient,\n bytes calldata updatedMessage,\n bytes calldata depositorSignature\n ) external;\n\n function fillRelay(\n V3RelayData calldata relayData,\n uint256 repaymentChainId,\n bytes32 repaymentAddress\n ) external;\n\n function fillV3Relay(V3RelayDataLegacy calldata relayData, uint256 repaymentChainId) external;\n\n function fillRelayWithUpdatedDeposit(\n V3RelayData calldata relayData,\n uint256 repaymentChainId,\n bytes32 repaymentAddress,\n uint256 updatedOutputAmount,\n bytes32 updatedRecipient,\n bytes calldata updatedMessage,\n bytes calldata depositorSignature\n ) external;\n\n function requestSlowFill(V3RelayData calldata relayData) external;\n\n function executeSlowRelayLeaf(\n V3SlowFill calldata slowFillLeaf,\n uint32 rootBundleId,\n bytes32[] calldata proof\n ) external;\n\n function claimRelayerRefund(bytes32 l2TokenAddress, bytes32 refundAddress) external;\n\n /**************************************\n * ERRORS *\n **************************************/\n\n error DisabledRoute();\n error InvalidQuoteTimestamp();\n error InvalidFillDeadline();\n error InvalidExclusiveRelayer();\n error MsgValueDoesNotMatchInputAmount();\n error NotExclusiveRelayer();\n error NoSlowFillsInExclusivityWindow();\n error RelayFilled();\n error InvalidSlowFillRequest();\n error ExpiredFillDeadline();\n error InvalidMerkleProof();\n error InvalidChainId();\n error InvalidMerkleLeaf();\n error ClaimedMerkleLeaf();\n error InvalidPayoutAdjustmentPct();\n error WrongERC7683OrderId();\n error LowLevelCallFailed(bytes data);\n error InsufficientSpokePoolBalanceToExecuteLeaf();\n error NoRelayerRefundToClaim();\n\n /**************************************\n * LEGACY EVENTS *\n **************************************/\n\n // Note: these events are unused, but included in the ABI for ease of migration.\n event V3FundsDeposited(\n address inputToken,\n address outputToken,\n uint256 inputAmount,\n uint256 outputAmount,\n uint256 indexed destinationChainId,\n uint32 indexed depositId,\n uint32 quoteTimestamp,\n uint32 fillDeadline,\n uint32 exclusivityDeadline,\n address indexed depositor,\n address recipient,\n address exclusiveRelayer,\n bytes message\n );\n\n event RequestedSpeedUpV3Deposit(\n uint256 updatedOutputAmount,\n uint32 indexed depositId,\n address indexed depositor,\n address updatedRecipient,\n bytes updatedMessage,\n bytes depositorSignature\n );\n\n // Legacy struct only used to preserve the FilledV3Relay event definition.\n struct LegacyV3RelayExecutionEventInfo {\n address updatedRecipient;\n bytes updatedMessage;\n uint256 updatedOutputAmount;\n FillType fillType;\n }\n\n event FilledV3Relay(\n address inputToken,\n address outputToken,\n uint256 inputAmount,\n uint256 outputAmount,\n uint256 repaymentChainId,\n uint256 indexed originChainId,\n uint32 indexed depositId,\n uint32 fillDeadline,\n uint32 exclusivityDeadline,\n address exclusiveRelayer,\n address indexed relayer,\n address depositor,\n address recipient,\n bytes message,\n LegacyV3RelayExecutionEventInfo relayExecutionInfo\n );\n\n event RequestedV3SlowFill(\n address inputToken,\n address outputToken,\n uint256 inputAmount,\n uint256 outputAmount,\n uint256 indexed originChainId,\n uint32 indexed depositId,\n uint32 fillDeadline,\n uint32 exclusivityDeadline,\n address exclusiveRelayer,\n address depositor,\n address recipient,\n bytes message\n );\n}\n"
- },
- "contracts/libraries/AddressConverters.sol": {
- "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\n\nlibrary Bytes32ToAddress {\n /**************************************\n * ERRORS *\n **************************************/\n error InvalidBytes32();\n\n function toAddress(bytes32 _bytes32) internal pure returns (address) {\n checkAddress(_bytes32);\n return address(uint160(uint256(_bytes32)));\n }\n\n function toAddressUnchecked(bytes32 _bytes32) internal pure returns (address) {\n return address(uint160(uint256(_bytes32)));\n }\n\n function checkAddress(bytes32 _bytes32) internal pure {\n if (uint256(_bytes32) >> 160 != 0) {\n revert InvalidBytes32();\n }\n }\n}\n\nlibrary AddressToBytes32 {\n function toBytes32(address _address) internal pure returns (bytes32) {\n return bytes32(uint256(uint160(_address)));\n }\n}\n"
- },
- "contracts/libraries/CircleCCTPAdapter.sol": {
- "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\n\nimport \"@openzeppelin/contracts/token/ERC20/IERC20.sol\";\nimport \"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\";\nimport \"../external/interfaces/CCTPInterfaces.sol\";\nimport { AddressToBytes32 } from \"../libraries/AddressConverters.sol\";\n\nlibrary CircleDomainIds {\n uint32 public constant Ethereum = 0;\n uint32 public constant Optimism = 2;\n uint32 public constant Arbitrum = 3;\n uint32 public constant Solana = 5;\n uint32 public constant Base = 6;\n uint32 public constant Polygon = 7;\n uint32 public constant DoctorWho = 10;\n uint32 public constant Linea = 11;\n uint32 public constant UNINITIALIZED = type(uint32).max;\n}\n\n/**\n * @notice Facilitate bridging USDC via Circle's CCTP.\n * @dev This contract is intended to be inherited by other chain-specific adapters and spoke pools.\n * @custom:security-contact bugs@across.to\n */\nabstract contract CircleCCTPAdapter {\n using SafeERC20 for IERC20;\n using AddressToBytes32 for address;\n /**\n * @notice The domain ID that CCTP will transfer funds to.\n * @dev This identifier is assigned by Circle and is not related to a chain ID.\n * @dev Official domain list can be found here: https://developers.circle.com/stablecoins/docs/supported-domains\n */\n /// @custom:oz-upgrades-unsafe-allow state-variable-immutable\n\n uint32 public immutable recipientCircleDomainId;\n\n /**\n * @notice The official USDC contract address on this chain.\n * @dev Posted officially here: https://developers.circle.com/stablecoins/docs/usdc-on-main-networks\n */\n /// @custom:oz-upgrades-unsafe-allow state-variable-immutable\n IERC20 public immutable usdcToken;\n\n /**\n * @notice The official Circle CCTP token bridge contract endpoint.\n * @dev Posted officially here: https://developers.circle.com/stablecoins/docs/evm-smart-contracts\n */\n /// @custom:oz-upgrades-unsafe-allow state-variable-immutable\n ITokenMessenger public immutable cctpTokenMessenger;\n\n /**\n * @notice Indicates if the CCTP V2 TokenMessenger is being used.\n * @dev This is determined by checking if the feeRecipient() function exists and returns a non-zero address.\n */\n /// @custom:oz-upgrades-unsafe-allow state-variable-immutable\n bool public immutable cctpV2;\n\n /**\n * @notice intiailizes the CircleCCTPAdapter contract.\n * @param _usdcToken USDC address on the current chain.\n * @param _cctpTokenMessenger TokenMessenger contract to bridge via CCTP. If the zero address is passed, CCTP bridging will be disabled.\n * @param _recipientCircleDomainId The domain ID that CCTP will transfer funds to.\n */\n /// @custom:oz-upgrades-unsafe-allow constructor\n constructor(\n IERC20 _usdcToken,\n /// @dev This should ideally be an address but it's kept as an ITokenMessenger to avoid rippling changes to the\n /// constructors for every SpokePool/Adapter.\n ITokenMessenger _cctpTokenMessenger,\n uint32 _recipientCircleDomainId\n ) {\n usdcToken = _usdcToken;\n cctpTokenMessenger = _cctpTokenMessenger;\n recipientCircleDomainId = _recipientCircleDomainId;\n\n // Only the CCTP V2 TokenMessenger has a feeRecipient() function, so we use it to\n // figure out if we are using CCTP V2 or V1. `success` can be true even if the contract doesn't\n // implement feeRecipient but it has a fallback function so to be extra safe, we check the return value\n // of feeRecipient() as well.\n (bool success, bytes memory feeRecipient) = address(cctpTokenMessenger).staticcall(\n abi.encodeWithSignature(\"feeRecipient()\")\n );\n // In case of a call to nonexistent contract or a call to a contract with a fallback function which\n // doesn't return any data, feeRecipient can be empty so check its length.\n // Even with this check, it's possible that the contract has implemented a fallback function that returns\n // 32 bytes of data but its not actually the feeRecipient address. This is extremely low risk but worth\n // mentioning that the following check is not 100% safe.\n cctpV2 = (success &&\n feeRecipient.length == 32 &&\n address(uint160(uint256(bytes32(feeRecipient)))) != address(0));\n }\n\n /**\n * @notice Returns whether or not the CCTP bridge is enabled.\n * @dev If the CCTPTokenMessenger is the zero address, CCTP bridging is disabled.\n */\n function _isCCTPEnabled() internal view returns (bool) {\n return address(cctpTokenMessenger) != address(0);\n }\n\n /**\n * @notice Transfers USDC from the current domain to the given address on the new domain.\n * @dev This function will revert if the CCTP bridge is disabled. I.e. if the zero address is passed to the constructor for the cctpTokenMessenger.\n * @param to Address to receive USDC on the new domain.\n * @param amount Amount of USDC to transfer.\n */\n function _transferUsdc(address to, uint256 amount) internal {\n _transferUsdc(to.toBytes32(), amount);\n }\n\n /**\n * @notice Transfers USDC from the current domain to the given address on the new domain.\n * @dev This function will revert if the CCTP bridge is disabled. I.e. if the zero address is passed to the constructor for the cctpTokenMessenger.\n * @param to Address to receive USDC on the new domain represented as bytes32.\n * @param amount Amount of USDC to transfer.\n */\n function _transferUsdc(bytes32 to, uint256 amount) internal {\n // Only approve the exact amount to be transferred\n usdcToken.safeIncreaseAllowance(address(cctpTokenMessenger), amount);\n // Submit the amount to be transferred to bridge via the TokenMessenger.\n // If the amount to send exceeds the burn limit per message, then split the message into smaller parts.\n // @dev We do not care about casting cctpTokenMessenger to ITokenMessengerV2 since both V1 and V2\n // expose a localMinter() view function that returns either an ITokenMinterV1 or ITokenMinterV2. Regardless,\n // we only care about the burnLimitsPerMessage function which is available in both versions and performs\n // the same logic, therefore we purposefully do not re-cast the cctpTokenMessenger and cctpMinter\n // to the specific version.\n ITokenMinter cctpMinter = cctpTokenMessenger.localMinter();\n uint256 burnLimit = cctpMinter.burnLimitsPerMessage(address(usdcToken));\n uint256 remainingAmount = amount;\n while (remainingAmount > 0) {\n uint256 partAmount = remainingAmount > burnLimit ? burnLimit : remainingAmount;\n if (cctpV2) {\n // Uses the CCTP V2 \"standard transfer\" speed and\n // therefore pays no additional fee for the transfer to be sped up.\n ITokenMessengerV2(address(cctpTokenMessenger)).depositForBurn(\n partAmount,\n recipientCircleDomainId,\n to,\n address(usdcToken),\n // The following parameters are new in this function from V2 to V1, can read more here:\n // https://developers.circle.com/stablecoins/evm-smart-contracts\n bytes32(0), // destinationCaller is set to bytes32(0) to indicate that anyone can call\n // receiveMessage on the destination to finalize the transfer\n 0, // maxFee can be set to 0 for a \"standard transfer\"\n 2000 // minFinalityThreshold can be set to 2000 for a \"standard transfer\",\n // https://github.com/circlefin/evm-cctp-contracts/blob/63ab1f0ac06ce0793c0bbfbb8d09816bc211386d/src/v2/FinalityThresholds.sol#L21\n );\n } else {\n cctpTokenMessenger.depositForBurn(partAmount, recipientCircleDomainId, to, address(usdcToken));\n }\n remainingAmount -= partAmount;\n }\n }\n}\n"
- },
- "contracts/MerkleLib.sol": {
- "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\n\nimport \"./interfaces/SpokePoolInterface.sol\";\nimport \"./interfaces/V3SpokePoolInterface.sol\";\nimport \"./interfaces/HubPoolInterface.sol\";\n\nimport \"@openzeppelin/contracts/utils/cryptography/MerkleProof.sol\";\n\n/**\n * @notice Library to help with merkle roots, proofs, and claims.\n * @custom:security-contact bugs@across.to\n */\nlibrary MerkleLib {\n /**\n * @notice Verifies that a repayment is contained within a merkle root.\n * @param root the merkle root.\n * @param rebalance the rebalance struct.\n * @param proof the merkle proof.\n * @return bool to signal if the pool rebalance proof correctly shows inclusion of the rebalance within the tree.\n */\n function verifyPoolRebalance(\n bytes32 root,\n HubPoolInterface.PoolRebalanceLeaf memory rebalance,\n bytes32[] memory proof\n ) internal pure returns (bool) {\n return MerkleProof.verify(proof, root, keccak256(abi.encode(rebalance)));\n }\n\n /**\n * @notice Verifies that a relayer refund is contained within a merkle root.\n * @param root the merkle root.\n * @param refund the refund struct.\n * @param proof the merkle proof.\n * @return bool to signal if the relayer refund proof correctly shows inclusion of the refund within the tree.\n */\n function verifyRelayerRefund(\n bytes32 root,\n SpokePoolInterface.RelayerRefundLeaf memory refund,\n bytes32[] memory proof\n ) internal pure returns (bool) {\n return MerkleProof.verify(proof, root, keccak256(abi.encode(refund)));\n }\n\n function verifyV3SlowRelayFulfillment(\n bytes32 root,\n V3SpokePoolInterface.V3SlowFill memory slowRelayFulfillment,\n bytes32[] memory proof\n ) internal pure returns (bool) {\n return MerkleProof.verify(proof, root, keccak256(abi.encode(slowRelayFulfillment)));\n }\n\n // The following functions are primarily copied from\n // https://github.com/Uniswap/merkle-distributor/blob/master/contracts/MerkleDistributor.sol with minor changes.\n\n /**\n * @notice Tests whether a claim is contained within a claimedBitMap mapping.\n * @param claimedBitMap a simple uint256 mapping in storage used as a bitmap.\n * @param index the index to check in the bitmap.\n * @return bool indicating if the index within the claimedBitMap has been marked as claimed.\n */\n function isClaimed(mapping(uint256 => uint256) storage claimedBitMap, uint256 index) internal view returns (bool) {\n uint256 claimedWordIndex = index / 256;\n uint256 claimedBitIndex = index % 256;\n uint256 claimedWord = claimedBitMap[claimedWordIndex];\n uint256 mask = (1 << claimedBitIndex);\n return claimedWord & mask == mask;\n }\n\n /**\n * @notice Marks an index in a claimedBitMap as claimed.\n * @param claimedBitMap a simple uint256 mapping in storage used as a bitmap.\n * @param index the index to mark in the bitmap.\n */\n function setClaimed(mapping(uint256 => uint256) storage claimedBitMap, uint256 index) internal {\n uint256 claimedWordIndex = index / 256;\n uint256 claimedBitIndex = index % 256;\n claimedBitMap[claimedWordIndex] = claimedBitMap[claimedWordIndex] | (1 << claimedBitIndex);\n }\n\n /**\n * @notice Tests whether a claim is contained within a 1D claimedBitMap mapping.\n * @param claimedBitMap a simple uint256 value, encoding a 1D bitmap.\n * @param index the index to check in the bitmap. Uint8 type enforces that index can't be > 255.\n * @return bool indicating if the index within the claimedBitMap has been marked as claimed.\n */\n function isClaimed1D(uint256 claimedBitMap, uint8 index) internal pure returns (bool) {\n uint256 mask = (1 << index);\n return claimedBitMap & mask == mask;\n }\n\n /**\n * @notice Marks an index in a claimedBitMap as claimed.\n * @param claimedBitMap a simple uint256 mapping in storage used as a bitmap. Uint8 type enforces that index\n * can't be > 255.\n * @param index the index to mark in the bitmap.\n * @return uint256 representing the modified input claimedBitMap with the index set to true.\n */\n function setClaimed1D(uint256 claimedBitMap, uint8 index) internal pure returns (uint256) {\n return claimedBitMap | (1 << index);\n }\n}\n"
- },
- "contracts/Ovm_SpokePool.sol": {
- "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\n\nimport \"./SpokePool.sol\";\nimport \"./external/interfaces/WETH9Interface.sol\";\nimport \"./libraries/CircleCCTPAdapter.sol\";\n\nimport \"@openzeppelin/contracts-upgradeable/crosschain/optimism/LibOptimismUpgradeable.sol\";\nimport \"@eth-optimism/contracts/libraries/constants/Lib_PredeployAddresses.sol\";\n\n// https://github.com/ethereum-optimism/optimism/blob/bf51c4935261634120f31827c3910aa631f6bf9c/packages/contracts-bedrock/contracts/L2/L2StandardBridge.sol\ninterface IL2ERC20Bridge {\n function withdrawTo(\n address _l2Token,\n address _to,\n uint256 _amount,\n uint32 _minGasLimit,\n bytes calldata _extraData\n ) external payable;\n\n function bridgeERC20To(\n address _localToken,\n address _remoteToken,\n address _to,\n uint256 _amount,\n uint32 _minGasLimit,\n bytes calldata _extraData\n ) external;\n}\n\n/**\n * @notice OVM specific SpokePool. Uses OVM cross-domain-enabled logic to implement admin only access to functions. * Optimism, Base, and Boba each implement this spoke pool and set their chain specific contract addresses for l2Eth and l2Weth.\n * @custom:security-contact bugs@across.to\n */\ncontract Ovm_SpokePool is SpokePool, CircleCCTPAdapter {\n using SafeERC20 for IERC20;\n // \"l1Gas\" parameter used in call to bridge tokens from this contract back to L1 via IL2ERC20Bridge. Currently\n // unused by bridge but included for future compatibility.\n uint32 public l1Gas;\n\n // ETH is an ERC20 on OVM.\n address public l2Eth;\n\n // Address of the Optimism L2 messenger.\n address public constant MESSENGER = Lib_PredeployAddresses.L2_CROSS_DOMAIN_MESSENGER;\n // @dev This storage slot is reserved to replace the old messenger public variable that has now been\n // replaced by the above constant.\n address private __deprecated_messenger;\n\n // Stores alternative token bridges to use for L2 tokens that don't go over the standard bridge. This is needed\n // to support non-standard ERC20 tokens on Optimism, such as DAI which uses a custom bridge with the same\n // interface as the standard bridge.\n mapping(address => address) public tokenBridges;\n\n // Stores mapping of L2 tokens to L1 equivalent tokens. If a mapping is defined for a given L2 token, then\n // the mapped L1 token can be used in _bridgeTokensToHubPool which can then call bridgeERC20To, which\n // requires specfiying an L1 token.\n mapping(address => address) public remoteL1Tokens;\n\n event SetL1Gas(uint32 indexed newL1Gas);\n event SetL2TokenBridge(address indexed l2Token, address indexed tokenBridge);\n event SetRemoteL1Token(address indexed l2Token, address indexed l1Token);\n\n error NotCrossDomainAdmin();\n\n /// @custom:oz-upgrades-unsafe-allow constructor\n constructor(\n address _wrappedNativeTokenAddress,\n uint32 _depositQuoteTimeBuffer,\n uint32 _fillDeadlineBuffer,\n IERC20 _l2Usdc,\n ITokenMessenger _cctpTokenMessenger\n )\n SpokePool(_wrappedNativeTokenAddress, _depositQuoteTimeBuffer, _fillDeadlineBuffer)\n CircleCCTPAdapter(_l2Usdc, _cctpTokenMessenger, CircleDomainIds.Ethereum)\n {} // solhint-disable-line no-empty-blocks\n\n /**\n * @notice Construct the OVM SpokePool.\n * @param _initialDepositId Starting deposit ID. Set to 0 unless this is a re-deployment in order to mitigate\n * relay hash collisions.\n * @param _crossDomainAdmin Cross domain admin to set. Can be changed by admin.\n * @param _withdrawalRecipient Address which receives token withdrawals. Can be changed by admin. For Spoke Pools on L2, this will\n * likely be the hub pool.\n * @param _l2Eth Address of L2 ETH token. Usually should be Lib_PreeployAddresses.OVM_ETH but sometimes this can\n * be different, like with Boba which flips the WETH and OVM_ETH addresses.\n */\n function __OvmSpokePool_init(\n uint32 _initialDepositId,\n address _crossDomainAdmin,\n address _withdrawalRecipient,\n address _l2Eth\n ) public onlyInitializing {\n l1Gas = 5_000_000;\n __SpokePool_init(_initialDepositId, _crossDomainAdmin, _withdrawalRecipient);\n //slither-disable-next-line missing-zero-check\n l2Eth = _l2Eth;\n }\n\n /*******************************************\n * OPTIMISM-SPECIFIC ADMIN FUNCTIONS *\n *******************************************/\n\n /**\n * @notice Change L1 gas limit. Callable only by admin.\n * @param newl1Gas New L1 gas limit to set.\n */\n function setL1GasLimit(uint32 newl1Gas) public onlyAdmin nonReentrant {\n l1Gas = newl1Gas;\n emit SetL1Gas(newl1Gas);\n }\n\n function setRemoteL1Token(address l2Token, address l1Token) public onlyAdmin nonReentrant {\n remoteL1Tokens[l2Token] = l1Token;\n emit SetRemoteL1Token(l2Token, l1Token);\n }\n\n /**\n * @notice Set bridge contract for L2 token used to withdraw back to L1.\n * @dev If this mapping isn't set for an L2 token, then the standard bridge will be used to bridge this token.\n * @param tokenBridge Address of token bridge\n */\n function setTokenBridge(address l2Token, address tokenBridge) public onlyAdmin nonReentrant {\n tokenBridges[l2Token] = tokenBridge;\n emit SetL2TokenBridge(l2Token, tokenBridge);\n }\n\n /**************************************\n * INTERNAL FUNCTIONS *\n **************************************/\n\n /**\n * @notice Wraps any ETH into WETH before executing leaves. This is necessary because SpokePool receives\n * ETH over the canonical token bridge instead of WETH.\n */\n function _preExecuteLeafHook(address l2TokenAddress) internal override {\n if (l2TokenAddress == address(wrappedNativeToken)) _depositEthToWeth();\n }\n\n // Wrap any ETH owned by this contract so we can send expected L2 token to recipient. This is necessary because\n // this SpokePool will receive ETH from the canonical token bridge instead of WETH. Its not sufficient to execute\n // this logic inside a fallback method that executes when this contract receives ETH because ETH is an ERC20\n // on the OVM.\n function _depositEthToWeth() internal {\n //slither-disable-next-line arbitrary-send-eth\n if (address(this).balance > 0) wrappedNativeToken.deposit{ value: address(this).balance }();\n }\n\n function _bridgeTokensToHubPool(uint256 amountToReturn, address l2TokenAddress) internal virtual override {\n // If the token being bridged is WETH then we need to first unwrap it to ETH and then send ETH over the\n // canonical bridge. On Optimism, this is address 0xDeadDeAddeAddEAddeadDEaDDEAdDeaDDeAD0000.\n if (l2TokenAddress == address(wrappedNativeToken)) {\n WETH9Interface(l2TokenAddress).withdraw(amountToReturn); // Unwrap into ETH.\n l2TokenAddress = l2Eth; // Set the l2TokenAddress to ETH.\n IL2ERC20Bridge(Lib_PredeployAddresses.L2_STANDARD_BRIDGE).withdrawTo{ value: amountToReturn }(\n l2TokenAddress, // _l2Token. Address of the L2 token to bridge over.\n withdrawalRecipient, // _to. Withdraw, over the bridge, to the l1 pool contract.\n amountToReturn, // _amount.\n l1Gas, // _l1Gas. Unused, but included for potential forward compatibility considerations\n \"\" // _data. We don't need to send any data for the bridging action.\n );\n }\n // If the token is USDC && CCTP bridge is enabled, then bridge USDC via CCTP.\n else if (_isCCTPEnabled() && l2TokenAddress == address(usdcToken)) {\n _transferUsdc(withdrawalRecipient, amountToReturn);\n }\n // Note we'll default to withdrawTo instead of bridgeERC20To unless the remoteL1Tokens mapping is set for\n // the l2TokenAddress. withdrawTo should be used to bridge back non-native L2 tokens\n // (i.e. non-native L2 tokens have a canonical L1 token). If we should bridge \"native L2\" tokens then\n // we'd need to call bridgeERC20To and give allowance to the tokenBridge to spend l2Token from this contract.\n // Therefore for native tokens we should set ensure that remoteL1Tokens is set for the l2TokenAddress.\n else {\n IL2ERC20Bridge tokenBridge = IL2ERC20Bridge(\n tokenBridges[l2TokenAddress] == address(0)\n ? Lib_PredeployAddresses.L2_STANDARD_BRIDGE\n : tokenBridges[l2TokenAddress]\n );\n if (remoteL1Tokens[l2TokenAddress] != address(0)) {\n // If there is a mapping for this L2 token to an L1 token, then use the L1 token address and\n // call bridgeERC20To.\n IERC20(l2TokenAddress).safeIncreaseAllowance(address(tokenBridge), amountToReturn);\n address remoteL1Token = remoteL1Tokens[l2TokenAddress];\n tokenBridge.bridgeERC20To(\n l2TokenAddress, // _l2Token. Address of the L2 token to bridge over.\n remoteL1Token, // Remote token to be received on L1 side. If the\n // remoteL1Token on the other chain does not recognize the local token as the correct\n // pair token, the ERC20 bridge will fail and the tokens will be returned to sender on\n // this chain.\n withdrawalRecipient, // _to\n amountToReturn, // _amount\n l1Gas, // _l1Gas\n \"\" // _data\n );\n } else {\n tokenBridge.withdrawTo(\n l2TokenAddress, // _l2Token. Address of the L2 token to bridge over.\n withdrawalRecipient, // _to. Withdraw, over the bridge, to the l1 pool contract.\n amountToReturn, // _amount.\n l1Gas, // _l1Gas. Unused, but included for potential forward compatibility considerations\n \"\" // _data. We don't need to send any data for the bridging action.\n );\n }\n }\n }\n\n // Apply OVM-specific transformation to cross domain admin address on L1.\n function _requireAdminSender() internal view override {\n if (LibOptimismUpgradeable.crossChainSender(MESSENGER) != crossDomainAdmin) revert NotCrossDomainAdmin();\n }\n\n // Reserve storage slots for future versions of this base contract to add state variables without\n // affecting the storage layout of child contracts. Decrement the size of __gap whenever state variables\n // are added. This is at bottom of contract to make sure its always at the end of storage.\n uint256[999] private __gap;\n}\n"
- },
- "contracts/SpokePool.sol": {
- "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\n\nimport \"./MerkleLib.sol\";\nimport \"./erc7683/ERC7683.sol\";\nimport \"./erc7683/ERC7683Permit2Lib.sol\";\nimport \"./external/interfaces/WETH9Interface.sol\";\nimport \"./interfaces/SpokePoolMessageHandler.sol\";\nimport \"./interfaces/SpokePoolInterface.sol\";\nimport \"./interfaces/V3SpokePoolInterface.sol\";\nimport \"./upgradeable/MultiCallerUpgradeable.sol\";\nimport \"./upgradeable/EIP712CrossChainUpgradeable.sol\";\nimport \"./upgradeable/AddressLibUpgradeable.sol\";\nimport \"./libraries/AddressConverters.sol\";\n\nimport \"@openzeppelin/contracts-upgradeable/token/ERC20/IERC20Upgradeable.sol\";\nimport \"@openzeppelin/contracts-upgradeable/token/ERC20/utils/SafeERC20Upgradeable.sol\";\nimport \"@openzeppelin/contracts/utils/cryptography/SignatureChecker.sol\";\nimport \"@openzeppelin/contracts-upgradeable/proxy/utils/UUPSUpgradeable.sol\";\nimport \"@openzeppelin/contracts-upgradeable/security/ReentrancyGuardUpgradeable.sol\";\nimport \"@openzeppelin/contracts/utils/math/SignedMath.sol\";\n\n/**\n * @title SpokePool\n * @notice Base contract deployed on source and destination chains enabling depositors to transfer assets from source to\n * destination. Deposit orders are fulfilled by off-chain relayers who also interact with this contract. Deposited\n * tokens are locked on the source chain and relayers send the recipient the desired token currency and amount\n * on the destination chain. Locked source chain tokens are later sent over the canonical token bridge to L1 HubPool.\n * Relayers are refunded with destination tokens out of this contract after another off-chain actor, a \"data worker\",\n * submits a proof that the relayer correctly submitted a relay on this SpokePool.\n * @custom:security-contact bugs@across.to\n */\nabstract contract SpokePool is\n V3SpokePoolInterface,\n SpokePoolInterface,\n UUPSUpgradeable,\n ReentrancyGuardUpgradeable,\n MultiCallerUpgradeable,\n EIP712CrossChainUpgradeable,\n IDestinationSettler\n{\n using SafeERC20Upgradeable for IERC20Upgradeable;\n using AddressLibUpgradeable for address;\n using Bytes32ToAddress for bytes32;\n using AddressToBytes32 for address;\n\n // Address of the L1 contract that acts as the owner of this SpokePool. This should normally be set to the HubPool\n // address. The crossDomainAdmin address is unused when the SpokePool is deployed to the same chain as the HubPool.\n address public crossDomainAdmin;\n\n // Address of the L1 contract that will send tokens to and receive tokens from this contract to fund relayer\n // refunds and slow relays.\n address public withdrawalRecipient;\n\n // Note: The following two storage variables prefixed with DEPRECATED used to be variables that could be set by\n // the cross-domain admin. Admins ended up not changing these in production, so to reduce\n // gas in deposit/fill functions, we are converting them to private variables to maintain the contract\n // storage layout and replacing them with immutable or constant variables, because retrieving a constant\n // value is cheaper than retrieving a storage variable. Please see out the immutable/constant variable section.\n WETH9Interface private DEPRECATED_wrappedNativeToken;\n uint32 private DEPRECATED_depositQuoteTimeBuffer;\n\n // `numberOfDeposits` acts as a counter to generate unique deposit identifiers for this spoke pool.\n // It is a uint32 that increments with each `depositV3` call. In the `FundsDeposited` event, it is\n // implicitly cast to uint256 by setting its most significant bits to 0, reducing the risk of ID collisions\n // with unsafe deposits. However, this variable's name could be improved (e.g., `depositNonceCounter`)\n // since it does not accurately reflect the total number of deposits, as `unsafeDeposit` can bypass this increment.\n uint32 public numberOfDeposits;\n\n // Whether deposits and fills are disabled.\n bool public pausedFills;\n bool public pausedDeposits;\n\n // This contract can store as many root bundles as the HubPool chooses to publish here.\n RootBundle[] public rootBundles;\n\n // Origin token to destination token routings can be turned on or off, which can enable or disable deposits.\n mapping(address => mapping(uint256 => bool)) private DEPRECATED_enabledDepositRoutes;\n\n // Each relay is associated with the hash of parameters that uniquely identify the original deposit and a relay\n // attempt for that deposit. The relay itself is just represented as the amount filled so far. The total amount to\n // relay, the fees, and the agents are all parameters included in the hash key.\n mapping(bytes32 => uint256) private DEPRECATED_relayFills;\n\n // Note: We will likely un-deprecate the fill and deposit counters to implement a better\n // dynamic LP fee mechanism but for now we'll deprecate it to reduce bytecode\n // in deposit/fill functions. These counters are designed to implement a fee mechanism that is based on a\n // canonical history of deposit and fill events and how they update a virtual running balance of liabilities and\n // assets, which then determines the LP fee charged to relays.\n\n // This keeps track of the worst-case liabilities due to fills.\n // It is never reset. Users should only rely on it to determine the worst-case increase in liabilities between\n // two points. This is used to provide frontrunning protection to ensure the relayer's assumptions about the state\n // upon which their expected repayments are based will not change before their transaction is mined.\n mapping(address => uint256) private DEPRECATED_fillCounter;\n\n // This keeps track of the total running deposits for each token. This allows depositors to protect themselves from\n // frontrunning that might change their worst-case quote.\n mapping(address => uint256) private DEPRECATED_depositCounter;\n\n // This tracks the number of identical refunds that have been requested.\n // The intention is to allow an off-chain system to know when this could be a duplicate and ensure that the other\n // requests are known and accounted for.\n mapping(bytes32 => uint256) private DEPRECATED_refundsRequested;\n\n // Mapping of V3 relay hashes to fill statuses. Distinguished from relayFills\n // to eliminate any chance of collision between pre and post V3 relay hashes.\n mapping(bytes32 => uint256) public fillStatuses;\n\n // Mapping of L2TokenAddress to relayer to outstanding refund amount. Used when a relayer repayment fails for some\n // reason (eg blacklist) to track their outstanding liability, thereby letting them claim it later.\n mapping(address => mapping(address => uint256)) public relayerRefund;\n\n /**************************************************************\n * CONSTANT/IMMUTABLE VARIABLES *\n **************************************************************/\n // Constant and immutable variables do not take up storage slots and are instead added to the contract bytecode\n // at compile time. The difference between them is that constant variables must be declared inline, meaning\n // that they cannot be changed in production without changing the contract code, while immutable variables\n // can be set in the constructor. Therefore we use the immutable keyword for variables that we might want to be\n // different for each child contract (one obvious example of this is the wrappedNativeToken) or that we might\n // want to update in the future like depositQuoteTimeBuffer. Constants are unlikely to ever be changed.\n\n // Address of wrappedNativeToken contract for this network. If an origin token matches this, then the caller can\n // optionally instruct this contract to wrap native tokens when depositing (ie ETH->WETH or MATIC->WMATIC).\n /// @custom:oz-upgrades-unsafe-allow state-variable-immutable\n WETH9Interface public immutable wrappedNativeToken;\n\n // Any deposit quote times greater than or less than this value to the current contract time is blocked. Forces\n // caller to use an approximately \"current\" realized fee.\n /// @custom:oz-upgrades-unsafe-allow state-variable-immutable\n uint32 public immutable depositQuoteTimeBuffer;\n\n // The fill deadline can only be set this far into the future from the timestamp of the deposit on this contract.\n /// @custom:oz-upgrades-unsafe-allow state-variable-immutable\n uint32 public immutable fillDeadlineBuffer;\n\n uint256 public constant MAX_TRANSFER_SIZE = 1e36;\n\n bytes32 public constant UPDATE_BYTES32_DEPOSIT_DETAILS_HASH =\n keccak256(\n \"UpdateDepositDetails(uint256 depositId,uint256 originChainId,uint256 updatedOutputAmount,bytes32 updatedRecipient,bytes updatedMessage)\"\n );\n // Default chain Id used to signify that no repayment is requested, for example when executing a slow fill.\n uint256 public constant EMPTY_REPAYMENT_CHAIN_ID = 0;\n // Default address used to signify that no relayer should be credited with a refund, for example\n // when executing a slow fill.\n bytes32 public constant EMPTY_RELAYER = bytes32(0);\n // This is the magic value that signals to the off-chain validator\n // that this deposit can never expire. A deposit with this fill deadline should always be eligible for a\n // slow fill, meaning that its output token and input token must be \"equivalent\". Therefore, this value is only\n // used as a fillDeadline in deposit(), a soon to be deprecated function that also hardcodes outputToken to\n // the zero address, which forces the off-chain validator to replace the output token with the equivalent\n // token for the input token. By using this magic value, off-chain validators do not have to keep\n // this event in their lookback window when querying for expired deposits.\n uint32 public constant INFINITE_FILL_DEADLINE = type(uint32).max;\n\n // One year in seconds. If `exclusivityParameter` is set to a value less than this, then the emitted\n // exclusivityDeadline in a deposit event will be set to the current time plus this value.\n uint32 public constant MAX_EXCLUSIVITY_PERIOD_SECONDS = 31_536_000;\n /****************************************\n * EVENTS *\n ****************************************/\n event SetXDomainAdmin(address indexed newAdmin);\n event SetWithdrawalRecipient(address indexed newWithdrawalRecipient);\n event EnabledDepositRoute(address indexed originToken, uint256 indexed destinationChainId, bool enabled);\n event RelayedRootBundle(\n uint32 indexed rootBundleId,\n bytes32 indexed relayerRefundRoot,\n bytes32 indexed slowRelayRoot\n );\n event ExecutedRelayerRefundRoot(\n uint256 amountToReturn,\n uint256 indexed chainId,\n uint256[] refundAmounts,\n uint32 indexed rootBundleId,\n uint32 indexed leafId,\n address l2TokenAddress,\n address[] refundAddresses,\n bool deferredRefunds,\n address caller\n );\n event TokensBridged(\n uint256 amountToReturn,\n uint256 indexed chainId,\n uint32 indexed leafId,\n bytes32 indexed l2TokenAddress,\n address caller\n );\n event EmergencyDeletedRootBundle(uint256 indexed rootBundleId);\n event PausedDeposits(bool isPaused);\n event PausedFills(bool isPaused);\n\n /**\n * @notice Construct the SpokePool. Normally, logic contracts used in upgradeable proxies shouldn't\n * have constructors since the following code will be executed within the logic contract's state, not the\n * proxy contract's state. However, if we restrict the constructor to setting only immutable variables, then\n * we are safe because immutable variables are included in the logic contract's bytecode rather than its storage.\n * @dev Do not leave an implementation contract uninitialized. An uninitialized implementation contract can be\n * taken over by an attacker, which may impact the proxy. To prevent the implementation contract from being\n * used, you should invoke the _disableInitializers function in the constructor to automatically lock it when\n * it is deployed:\n * @param _wrappedNativeTokenAddress wrappedNativeToken address for this network to set.\n * @param _depositQuoteTimeBuffer depositQuoteTimeBuffer to set. Quote timestamps can't be set more than this amount\n * into the past from the block time of the deposit.\n * @param _fillDeadlineBuffer fillDeadlineBuffer to set. Fill deadlines can't be set more than this amount\n * into the future from the block time of the deposit.\n */\n /// @custom:oz-upgrades-unsafe-allow constructor\n constructor(\n address _wrappedNativeTokenAddress,\n uint32 _depositQuoteTimeBuffer,\n uint32 _fillDeadlineBuffer\n ) {\n wrappedNativeToken = WETH9Interface(_wrappedNativeTokenAddress);\n depositQuoteTimeBuffer = _depositQuoteTimeBuffer;\n fillDeadlineBuffer = _fillDeadlineBuffer;\n _disableInitializers();\n }\n\n /**\n * @notice Construct the base SpokePool.\n * @param _initialDepositId Starting deposit ID. Set to 0 unless this is a re-deployment in order to mitigate\n * relay hash collisions.\n * @param _crossDomainAdmin Cross domain admin to set. Can be changed by admin.\n * @param _withdrawalRecipient Address which receives token withdrawals. Can be changed by admin. For Spoke Pools on L2, this will\n * likely be the hub pool.\n */\n function __SpokePool_init(\n uint32 _initialDepositId,\n address _crossDomainAdmin,\n address _withdrawalRecipient\n ) public onlyInitializing {\n numberOfDeposits = _initialDepositId;\n __EIP712_init(\"ACROSS-V2\", \"1.0.0\");\n __UUPSUpgradeable_init();\n __ReentrancyGuard_init();\n _setCrossDomainAdmin(_crossDomainAdmin);\n _setWithdrawalRecipient(_withdrawalRecipient);\n }\n\n /****************************************\n * MODIFIERS *\n ****************************************/\n\n /**\n * @dev Function that should revert when `msg.sender` is not authorized to upgrade the contract. Called by\n * {upgradeTo} and {upgradeToAndCall}.\n * @dev This should be set to cross domain admin for specific SpokePool.\n */\n modifier onlyAdmin() {\n _requireAdminSender();\n _;\n }\n\n modifier unpausedDeposits() {\n if (pausedDeposits) revert DepositsArePaused();\n _;\n }\n\n modifier unpausedFills() {\n if (pausedFills) revert FillsArePaused();\n _;\n }\n\n /**************************************\n * ADMIN FUNCTIONS *\n **************************************/\n\n // Allows cross domain admin to upgrade UUPS proxy implementation.\n function _authorizeUpgrade(address newImplementation) internal override onlyAdmin {}\n\n /**\n * @notice Pauses deposit-related functions. This is intended to be used if this contract is deprecated or when\n * something goes awry.\n * @dev Affects `deposit()` but not `speedUpDeposit()`, so that existing deposits can be sped up and still\n * relayed.\n * @param pause true if the call is meant to pause the system, false if the call is meant to unpause it.\n */\n function pauseDeposits(bool pause) public override onlyAdmin nonReentrant {\n pausedDeposits = pause;\n emit PausedDeposits(pause);\n }\n\n /**\n * @notice Pauses fill-related functions. This is intended to be used if this contract is deprecated or when\n * something goes awry.\n * @dev Affects fillRelayWithUpdatedDeposit() and fillRelay().\n * @param pause true if the call is meant to pause the system, false if the call is meant to unpause it.\n */\n function pauseFills(bool pause) public override onlyAdmin nonReentrant {\n pausedFills = pause;\n emit PausedFills(pause);\n }\n\n /**\n * @notice Change cross domain admin address. Callable by admin only.\n * @param newCrossDomainAdmin New cross domain admin.\n */\n function setCrossDomainAdmin(address newCrossDomainAdmin) public override onlyAdmin nonReentrant {\n _setCrossDomainAdmin(newCrossDomainAdmin);\n }\n\n /**\n * @notice Change L1 withdrawal recipient address. Callable by admin only.\n * @param newWithdrawalRecipient New withdrawal recipient address.\n */\n function setWithdrawalRecipient(address newWithdrawalRecipient) public override onlyAdmin nonReentrant {\n _setWithdrawalRecipient(newWithdrawalRecipient);\n }\n\n /**\n * @notice This method stores a new root bundle in this contract that can be executed to refund relayers, fulfill\n * slow relays, and send funds back to the HubPool on L1. This method can only be called by the admin and is\n * designed to be called as part of a cross-chain message from the HubPool's executeRootBundle method.\n * @param relayerRefundRoot Merkle root containing relayer refund leaves that can be individually executed via\n * executeRelayerRefundLeaf().\n * @param slowRelayRoot Merkle root containing slow relay fulfillment leaves that can be individually executed via\n * executeSlowRelayLeaf().\n */\n function relayRootBundle(bytes32 relayerRefundRoot, bytes32 slowRelayRoot) public override onlyAdmin nonReentrant {\n uint32 rootBundleId = uint32(rootBundles.length);\n RootBundle storage rootBundle = rootBundles.push();\n rootBundle.relayerRefundRoot = relayerRefundRoot;\n rootBundle.slowRelayRoot = slowRelayRoot;\n emit RelayedRootBundle(rootBundleId, relayerRefundRoot, slowRelayRoot);\n }\n\n /**\n * @notice This method is intended to only be used in emergencies where a bad root bundle has reached the\n * SpokePool.\n * @param rootBundleId Index of the root bundle that needs to be deleted. Note: this is intentionally a uint256\n * to ensure that a small input range doesn't limit which indices this method is able to reach.\n */\n function emergencyDeleteRootBundle(uint256 rootBundleId) public override onlyAdmin nonReentrant {\n // Deleting a struct containing a mapping does not delete the mapping in Solidity, therefore the bitmap's\n // data will still remain potentially leading to vulnerabilities down the line. The way around this would\n // be to iterate through every key in the mapping and resetting the value to 0, but this seems expensive and\n // would require a new list in storage to keep track of keys.\n //slither-disable-next-line mapping-deletion\n delete rootBundles[rootBundleId];\n emit EmergencyDeletedRootBundle(rootBundleId);\n }\n\n /**************************************\n * LEGACY DEPOSITOR FUNCTIONS *\n **************************************/\n\n /**\n * @dev DEPRECATION NOTICE: this function is deprecated and will be removed in the future.\n * Please use deposit (under DEPOSITOR FUNCTIONS below) or depositV3 instead.\n * @notice Called by user to bridge funds from origin to destination chain. Depositor will effectively lock\n * tokens in this contract and receive a destination token on the destination chain. The origin => destination\n * token mapping is stored on the L1 HubPool.\n * @notice The caller must first approve this contract to spend amount of originToken.\n * @notice The originToken => destinationChainId must be enabled.\n * @notice This method is payable because the caller is able to deposit native token if the originToken is\n * wrappedNativeToken and this function will handle wrapping the native token to wrappedNativeToken.\n * @dev Produces a FundsDeposited event with an infinite expiry, meaning that this deposit can never expire.\n * Moreover, the event's outputToken is set to 0x0 meaning that this deposit can always be slow filled.\n * @param recipient Address to receive funds at on destination chain.\n * @param originToken Token to lock into this contract to initiate deposit.\n * @param amount Amount of tokens to deposit. Will be amount of tokens to receive less fees.\n * @param destinationChainId Denotes network where user will receive funds from SpokePool by a relayer.\n * @param relayerFeePct % of deposit amount taken out to incentivize a fast relayer.\n * @param quoteTimestamp Timestamp used by relayers to compute this deposit's realizedLPFeePct which is paid\n * to LP pool on HubPool.\n * @param message Arbitrary data that can be used to pass additional information to the recipient along with the tokens.\n * Note: this is intended to be used to pass along instructions for how a contract should use or allocate the tokens.\n */\n function depositDeprecated_5947912356(\n address recipient,\n address originToken,\n uint256 amount,\n uint256 destinationChainId,\n int64 relayerFeePct,\n uint32 quoteTimestamp,\n bytes memory message,\n uint256 // maxCount. Deprecated.\n ) public payable nonReentrant unpausedDeposits {\n _deposit(\n msg.sender,\n recipient,\n originToken,\n amount,\n destinationChainId,\n relayerFeePct,\n quoteTimestamp,\n message\n );\n }\n\n /**\n * @dev DEPRECATION NOTICE: this function is deprecated and will be removed in the future.\n * Please use the other deposit or depositV3 instead.\n * @notice The only difference between depositFor and deposit is that the depositor address stored\n * in the relay hash can be overridden by the caller. This means that the passed in depositor\n * can speed up the deposit, which is useful if the deposit is taken from the end user to a middle layer\n * contract, like an aggregator or the SpokePoolVerifier, before calling deposit on this contract.\n * @notice The caller must first approve this contract to spend amount of originToken.\n * @notice The originToken => destinationChainId must be enabled.\n * @notice This method is payable because the caller is able to deposit native token if the originToken is\n * wrappedNativeToken and this function will handle wrapping the native token to wrappedNativeToken.\n * @param depositor Address who is credited for depositing funds on origin chain and can speed up the deposit.\n * @param recipient Address to receive funds at on destination chain.\n * @param originToken Token to lock into this contract to initiate deposit.\n * @param amount Amount of tokens to deposit. Will be amount of tokens to receive less fees.\n * @param destinationChainId Denotes network where user will receive funds from SpokePool by a relayer.\n * @param relayerFeePct % of deposit amount taken out to incentivize a fast relayer.\n * @param quoteTimestamp Timestamp used by relayers to compute this deposit's realizedLPFeePct which is paid\n * to LP pool on HubPool.\n * @param message Arbitrary data that can be used to pass additional information to the recipient along with the tokens.\n * Note: this is intended to be used to pass along instructions for how a contract should use or allocate the tokens.\n */\n function depositFor(\n address depositor,\n address recipient,\n address originToken,\n uint256 amount,\n uint256 destinationChainId,\n int64 relayerFeePct,\n uint32 quoteTimestamp,\n bytes memory message,\n uint256 // maxCount. Deprecated.\n ) public payable nonReentrant unpausedDeposits {\n _deposit(depositor, recipient, originToken, amount, destinationChainId, relayerFeePct, quoteTimestamp, message);\n }\n\n /********************************************\n * DEPOSITOR FUNCTIONS *\n ********************************************/\n\n /**\n * @notice Previously, this function allowed the caller to specify the exclusivityDeadline, otherwise known as the\n * as exact timestamp on the destination chain before which only the exclusiveRelayer could fill the deposit. Now,\n * the caller is expected to pass in a number that will be interpreted either as an offset or a fixed\n * timestamp depending on its value.\n * @notice Request to bridge input token cross chain to a destination chain and receive a specified amount\n * of output tokens. The fee paid to relayers and the system should be captured in the spread between output\n * amount and input amount when adjusted to be denominated in the input token. A relayer on the destination\n * chain will send outputAmount of outputTokens to the recipient and receive inputTokens on a repayment\n * chain of their choice. Therefore, the fee should account for destination fee transaction costs,\n * the relayer's opportunity cost of capital while they wait to be refunded following an optimistic challenge\n * window in the HubPool, and the system fee that they'll be charged.\n * @dev On the destination chain, the hash of the deposit data will be used to uniquely identify this deposit, so\n * modifying any params in it will result in a different hash and a different deposit. The hash will comprise\n * all parameters to this function along with this chain's chainId(). Relayers are only refunded for filling\n * deposits with deposit hashes that map exactly to the one emitted by this contract.\n * @param depositor The account credited with the deposit who can request to \"speed up\" this deposit by modifying\n * the output amount, recipient, and message.\n * @param recipient The account receiving funds on the destination chain. Can be an EOA or a contract. If\n * the output token is the wrapped native token for the chain, then the recipient will receive native token if\n * an EOA or wrapped native token if a contract.\n * @param inputToken The token pulled from the caller's account and locked into this contract to\n * initiate the deposit. The equivalent of this token on the relayer's repayment chain of choice will be sent\n * as a refund. If this is equal to the wrapped native token then the caller can optionally pass in native token as\n * msg.value, as long as msg.value = inputTokenAmount.\n * @param outputToken The token that the relayer will send to the recipient on the destination chain. Must be an\n * ERC20.\n * @param inputAmount The amount of input tokens to pull from the caller's account and lock into this contract.\n * This amount will be sent to the relayer on their repayment chain of choice as a refund following an optimistic\n * challenge window in the HubPool, less a system fee.\n * @param outputAmount The amount of output tokens that the relayer will send to the recipient on the destination.\n * @param destinationChainId The destination chain identifier. Must be enabled along with the input token\n * as a valid deposit route from this spoke pool or this transaction will revert.\n * @param exclusiveRelayer The relayer that will be exclusively allowed to fill this deposit before the\n * exclusivity deadline timestamp. This must be a valid, non-zero address if the exclusivity deadline is\n * greater than the current block.timestamp. If the exclusivity deadline is < currentTime, then this must be\n * address(0), and vice versa if this is address(0).\n * @param quoteTimestamp The HubPool timestamp that is used to determine the system fee paid by the depositor.\n * This must be set to some time between [currentTime - depositQuoteTimeBuffer, currentTime]\n * where currentTime is block.timestamp on this chain or this transaction will revert.\n * @param fillDeadline The deadline for the relayer to fill the deposit. After this destination chain timestamp,\n * the fill will revert on the destination chain. Must be set before currentTime + fillDeadlineBuffer, where\n * currentTime is block.timestamp on this chain or this transaction will revert.\n * @param exclusivityParameter This value is used to set the exclusivity deadline timestamp in the emitted deposit\n * event. Before this destination chain timestamp, only the exclusiveRelayer (if set to a non-zero address),\n * can fill this deposit. There are three ways to use this parameter:\n * 1. NO EXCLUSIVITY: If this value is set to 0, then a timestamp of 0 will be emitted,\n * meaning that there is no exclusivity period.\n * 2. OFFSET: If this value is less than MAX_EXCLUSIVITY_PERIOD_SECONDS, then add this value to\n * the block.timestamp to derive the exclusive relayer deadline. Note that using the parameter in this way\n * will expose the filler of the deposit to the risk that the block.timestamp of this event gets changed\n * due to a chain-reorg, which would also change the exclusivity timestamp.\n * 3. TIMESTAMP: Otherwise, set this value as the exclusivity deadline timestamp.\n * which is the deadline for the exclusiveRelayer to fill the deposit.\n * @param message The message to send to the recipient on the destination chain if the recipient is a contract.\n * If the message is not empty, the recipient contract must implement handleV3AcrossMessage() or the fill will revert.\n */\n function deposit(\n bytes32 depositor,\n bytes32 recipient,\n bytes32 inputToken,\n bytes32 outputToken,\n uint256 inputAmount,\n uint256 outputAmount,\n uint256 destinationChainId,\n bytes32 exclusiveRelayer,\n uint32 quoteTimestamp,\n uint32 fillDeadline,\n uint32 exclusivityParameter,\n bytes calldata message\n ) public payable override nonReentrant unpausedDeposits {\n // Increment the `numberOfDeposits` counter to ensure a unique deposit ID for this spoke pool.\n DepositV3Params memory params = DepositV3Params({\n depositor: depositor,\n recipient: recipient,\n inputToken: inputToken,\n outputToken: outputToken,\n inputAmount: inputAmount,\n outputAmount: outputAmount,\n destinationChainId: destinationChainId,\n exclusiveRelayer: exclusiveRelayer,\n depositId: numberOfDeposits++,\n quoteTimestamp: quoteTimestamp,\n fillDeadline: fillDeadline,\n exclusivityParameter: exclusivityParameter,\n message: message\n });\n _depositV3(params);\n }\n\n /**\n * @notice A version of `deposit` that accepts `address` types for backward compatibility.\n * This function allows bridging of input tokens cross-chain to a destination chain, receiving a specified amount of output tokens.\n * The relayer is refunded in input tokens on a repayment chain of their choice, minus system fees, after an optimistic challenge\n * window. The exclusivity period is specified as an offset from the current block timestamp.\n *\n * @dev This version mirrors the original `depositV3` function, but uses `address` types for `depositor`, `recipient`,\n * `inputToken`, `outputToken`, and `exclusiveRelayer` for compatibility with contracts using the `address` type.\n *\n * The key functionality and logic remain identical, ensuring interoperability across both versions.\n *\n * @param depositor The account credited with the deposit who can request to \"speed up\" this deposit by modifying\n * the output amount, recipient, and message.\n * @param recipient The account receiving funds on the destination chain. Can be an EOA or a contract. If\n * the output token is the wrapped native token for the chain, then the recipient will receive native token if\n * an EOA or wrapped native token if a contract.\n * @param inputToken The token pulled from the caller's account and locked into this contract to initiate the deposit.\n * The equivalent of this token on the relayer's repayment chain of choice will be sent as a refund. If this is equal\n * to the wrapped native token, the caller can optionally pass in native token as msg.value, provided msg.value = inputTokenAmount.\n * @param outputToken The token that the relayer will send to the recipient on the destination chain. Must be an ERC20.\n * @param inputAmount The amount of input tokens pulled from the caller's account and locked into this contract. This\n * amount will be sent to the relayer as a refund following an optimistic challenge window in the HubPool, less a system fee.\n * @param outputAmount The amount of output tokens that the relayer will send to the recipient on the destination.\n * @param destinationChainId The destination chain identifier. Must be enabled along with the input token as a valid\n * deposit route from this spoke pool or this transaction will revert.\n * @param exclusiveRelayer The relayer exclusively allowed to fill this deposit before the exclusivity deadline.\n * @param quoteTimestamp The HubPool timestamp that determines the system fee paid by the depositor. This must be set\n * between [currentTime - depositQuoteTimeBuffer, currentTime] where currentTime is block.timestamp on this chain.\n * @param fillDeadline The deadline for the relayer to fill the deposit. After this destination chain timestamp, the fill will\n * revert on the destination chain. Must be set before currentTime + fillDeadlineBuffer, where currentTime is block.timestamp\n * on this chain.\n * @param exclusivityParameter This value is used to set the exclusivity deadline timestamp in the emitted deposit\n * event. Before this destination chain timestamp, only the exclusiveRelayer (if set to a non-zero address),\n * can fill this deposit. There are three ways to use this parameter:\n * 1. NO EXCLUSIVITY: If this value is set to 0, then a timestamp of 0 will be emitted,\n * meaning that there is no exclusivity period.\n * 2. OFFSET: If this value is less than MAX_EXCLUSIVITY_PERIOD_SECONDS, then add this value to\n * the block.timestamp to derive the exclusive relayer deadline. Note that using the parameter in this way\n * will expose the filler of the deposit to the risk that the block.timestamp of this event gets changed\n * due to a chain-reorg, which would also change the exclusivity timestamp.\n * 3. TIMESTAMP: Otherwise, set this value as the exclusivity deadline timestamp.\n * which is the deadline for the exclusiveRelayer to fill the deposit.\n * @param message The message to send to the recipient on the destination chain if the recipient is a contract. If the\n * message is not empty, the recipient contract must implement `handleV3AcrossMessage()` or the fill will revert.\n */\n function depositV3(\n address depositor,\n address recipient,\n address inputToken,\n address outputToken,\n uint256 inputAmount,\n uint256 outputAmount,\n uint256 destinationChainId,\n address exclusiveRelayer,\n uint32 quoteTimestamp,\n uint32 fillDeadline,\n uint32 exclusivityParameter,\n bytes calldata message\n ) public payable override {\n deposit(\n depositor.toBytes32(),\n recipient.toBytes32(),\n inputToken.toBytes32(),\n outputToken.toBytes32(),\n inputAmount,\n outputAmount,\n destinationChainId,\n exclusiveRelayer.toBytes32(),\n quoteTimestamp,\n fillDeadline,\n exclusivityParameter,\n message\n );\n }\n\n /**\n * @notice See deposit for details. This function is identical to deposit except that it does not use the\n * global deposit ID counter as a deposit nonce, instead allowing the caller to pass in a deposit nonce. This\n * function is designed to be used by anyone who wants to pre-compute their resultant relay data hash, which\n * could be useful for filling a deposit faster and avoiding any risk of a relay hash unexpectedly changing\n * due to another deposit front-running this one and incrementing the global deposit ID counter.\n * @dev This is labeled \"unsafe\" because there is no guarantee that the depositId emitted in the resultant\n * FundsDeposited event is unique which means that the\n * corresponding fill might collide with an existing relay hash on the destination chain SpokePool,\n * which would make this deposit unfillable. In this case, the depositor would subsequently receive a refund\n * of `inputAmount` of `inputToken` on the origin chain after the fill deadline. Re-using a depositNonce is very\n * dangerous when combined with `speedUpDeposit`, as a speed up signature can be re-used for any deposits\n * with the same deposit ID.\n * @dev On the destination chain, the hash of the deposit data will be used to uniquely identify this deposit, so\n * modifying any params in it will result in a different hash and a different deposit. The hash will comprise\n * all parameters to this function along with this chain's chainId(). Relayers are only refunded for filling\n * deposits with deposit hashes that map exactly to the one emitted by this contract.\n * @param depositNonce The nonce that uniquely identifies this deposit. This function will combine this parameter\n * with the msg.sender address to create a unique uint256 depositNonce and ensure that the msg.sender cannot\n * use this function to front-run another depositor's unsafe deposit. This function guarantees that the resultant\n * deposit nonce will not collide with a safe uint256 deposit nonce whose 24 most significant bytes are always 0.\n * @param depositor See identically named parameter in depositV3() comments.\n * @param recipient See identically named parameter in depositV3() comments.\n * @param inputToken See identically named parameter in depositV3() comments.\n * @param outputToken See identically named parameter in depositV3() comments.\n * @param inputAmount See identically named parameter in depositV3() comments.\n * @param outputAmount See identically named parameter in depositV3() comments.\n * @param destinationChainId See identically named parameter in depositV3() comments.\n * @param exclusiveRelayer See identically named parameter in depositV3() comments.\n * @param quoteTimestamp See identically named parameter in depositV3() comments.\n * @param fillDeadline See identically named parameter in depositV3() comments.\n * @param exclusivityParameter See identically named parameter in depositV3() comments.\n * @param message See identically named parameter in depositV3() comments.\n */\n function unsafeDeposit(\n bytes32 depositor,\n bytes32 recipient,\n bytes32 inputToken,\n bytes32 outputToken,\n uint256 inputAmount,\n uint256 outputAmount,\n uint256 destinationChainId,\n bytes32 exclusiveRelayer,\n uint256 depositNonce,\n uint32 quoteTimestamp,\n uint32 fillDeadline,\n uint32 exclusivityParameter,\n bytes calldata message\n ) public payable nonReentrant unpausedDeposits {\n // @dev Create the uint256 deposit ID by concatenating the msg.sender and depositor address with the inputted\n // depositNonce parameter. The resultant 32 byte string will be hashed and then casted to an \"unsafe\"\n // uint256 deposit ID. The probability that the resultant ID collides with a \"safe\" deposit ID is\n // equal to the chance that the first 28 bytes of the hash are 0, which is too small for us to consider.\n\n uint256 depositId = getUnsafeDepositId(msg.sender, depositor, depositNonce);\n DepositV3Params memory params = DepositV3Params({\n depositor: depositor,\n recipient: recipient,\n inputToken: inputToken,\n outputToken: outputToken,\n inputAmount: inputAmount,\n outputAmount: outputAmount,\n destinationChainId: destinationChainId,\n exclusiveRelayer: exclusiveRelayer,\n depositId: depositId,\n quoteTimestamp: quoteTimestamp,\n fillDeadline: fillDeadline,\n exclusivityParameter: exclusivityParameter,\n message: message\n });\n _depositV3(params);\n }\n\n /**\n * @notice Submits deposit and sets quoteTimestamp to current Time. Sets fill and exclusivity\n * deadlines as offsets added to the current time. This function is designed to be called by users\n * such as Multisig contracts who do not have certainty when their transaction will mine.\n * @param depositor The account credited with the deposit who can request to \"speed up\" this deposit by modifying\n * the output amount, recipient, and message.\n * @param recipient The account receiving funds on the destination chain. Can be an EOA or a contract. If\n * the output token is the wrapped native token for the chain, then the recipient will receive native token if\n * an EOA or wrapped native token if a contract.\n * @param inputToken The token pulled from the caller's account and locked into this contract to\n * initiate the deposit. The equivalent of this token on the relayer's repayment chain of choice will be sent\n * as a refund. If this is equal to the wrapped native token then the caller can optionally pass in native token as\n * msg.value, as long as msg.value = inputTokenAmount.\n * @param outputToken The token that the relayer will send to the recipient on the destination chain. Must be an\n * ERC20.\n * @param inputAmount The amount of input tokens to pull from the caller's account and lock into this contract.\n * This amount will be sent to the relayer on their repayment chain of choice as a refund following an optimistic\n * challenge window in the HubPool, plus a system fee.\n * @param outputAmount The amount of output tokens that the relayer will send to the recipient on the destination.\n * @param destinationChainId The destination chain identifier. Must be enabled along with the input token\n * as a valid deposit route from this spoke pool or this transaction will revert.\n * @param exclusiveRelayer The relayer that will be exclusively allowed to fill this deposit before the\n * exclusivity deadline timestamp.\n * @param fillDeadlineOffset Added to the current time to set the fill deadline, which is the deadline for the\n * relayer to fill the deposit. After this destination chain timestamp, the fill will revert on the\n * destination chain.\n * @param exclusivityParameter See identically named parameter in deposit() comments.\n * @param message The message to send to the recipient on the destination chain if the recipient is a contract.\n * If the message is not empty, the recipient contract must implement handleV3AcrossMessage() or the fill will revert.\n */\n function depositNow(\n bytes32 depositor,\n bytes32 recipient,\n bytes32 inputToken,\n bytes32 outputToken,\n uint256 inputAmount,\n uint256 outputAmount,\n uint256 destinationChainId,\n bytes32 exclusiveRelayer,\n uint32 fillDeadlineOffset,\n uint32 exclusivityParameter,\n bytes calldata message\n ) external payable override {\n deposit(\n depositor,\n recipient,\n inputToken,\n outputToken,\n inputAmount,\n outputAmount,\n destinationChainId,\n exclusiveRelayer,\n uint32(getCurrentTime()),\n uint32(getCurrentTime()) + fillDeadlineOffset,\n exclusivityParameter,\n message\n );\n }\n\n /**\n * @notice A version of `depositNow` that supports addresses as input types for backward compatibility.\n * This function submits a deposit and sets `quoteTimestamp` to the current time. The `fill` and `exclusivity` deadlines\n * are set as offsets added to the current time. It is designed to be called by users, including Multisig contracts, who may\n * not have certainty when their transaction will be mined.\n *\n * @dev This version is identical to the original `depositV3Now` but uses `address` types for `depositor`, `recipient`,\n * `inputToken`, `outputToken`, and `exclusiveRelayer` to support compatibility with older systems.\n * It maintains the same logic and purpose, ensuring interoperability with both versions.\n *\n * @param depositor The account credited with the deposit, who can request to \"speed up\" this deposit by modifying\n * the output amount, recipient, and message.\n * @param recipient The account receiving funds on the destination chain. Can be an EOA or a contract. If\n * the output token is the wrapped native token for the chain, then the recipient will receive the native token if\n * an EOA or wrapped native token if a contract.\n * @param inputToken The token pulled from the caller's account and locked into this contract to initiate the deposit.\n * Equivalent tokens on the relayer's repayment chain will be sent as a refund. If this is the wrapped native token,\n * msg.value must equal inputTokenAmount when passed.\n * @param outputToken The token the relayer will send to the recipient on the destination chain. Must be an ERC20.\n * @param inputAmount The amount of input tokens pulled from the caller's account and locked into this contract.\n * This amount will be sent to the relayer as a refund following an optimistic challenge window in the HubPool, plus a system fee.\n * @param outputAmount The amount of output tokens the relayer will send to the recipient on the destination.\n * @param destinationChainId The destination chain identifier. Must be enabled with the input token as a valid deposit route\n * from this spoke pool, or the transaction will revert.\n * @param exclusiveRelayer The relayer exclusively allowed to fill the deposit before the exclusivity deadline.\n * @param fillDeadlineOffset Added to the current time to set the fill deadline. After this timestamp, fills on the\n * destination chain will revert.\n * @param exclusivityParameter See identically named parameter in deposit() comments.\n * @param message The message to send to the recipient on the destination chain. If the recipient is a contract, it must\n * implement `handleV3AcrossMessage()` if the message is not empty, or the fill will revert.\n */\n function depositV3Now(\n address depositor,\n address recipient,\n address inputToken,\n address outputToken,\n uint256 inputAmount,\n uint256 outputAmount,\n uint256 destinationChainId,\n address exclusiveRelayer,\n uint32 fillDeadlineOffset,\n uint32 exclusivityParameter,\n bytes calldata message\n ) external payable override {\n depositV3(\n depositor,\n recipient,\n inputToken,\n outputToken,\n inputAmount,\n outputAmount,\n destinationChainId,\n exclusiveRelayer,\n uint32(getCurrentTime()),\n uint32(getCurrentTime()) + fillDeadlineOffset,\n exclusivityParameter,\n message\n );\n }\n\n /**\n * @notice Depositor can use this function to signal to relayer to use updated output amount, recipient,\n * and/or message. The speed up signature uniquely identifies the speed up based only on\n * depositor, deposit ID and origin chain, so using this function in conjunction with unsafeDeposit is risky\n * due to the chance of repeating a deposit ID.\n * @dev the depositor and depositId must match the params in a FundsDeposited event that the depositor\n * wants to speed up. The relayer has the option but not the obligation to use this updated information\n * when filling the deposit via fillRelayWithUpdatedDeposit().\n * @param depositor Depositor that must sign the depositorSignature and was the original depositor.\n * @param depositId Deposit ID to speed up.\n * @param updatedOutputAmount New output amount to use for this deposit. Should be lower than previous value\n * otherwise relayer has no incentive to use this updated value.\n * @param updatedRecipient New recipient to use for this deposit. Can be modified if the recipient is a contract\n * that expects to receive a message from the relay and for some reason needs to be modified.\n * @param updatedMessage New message to use for this deposit. Can be modified if the recipient is a contract\n * that expects to receive a message from the relay and for some reason needs to be modified.\n * @param depositorSignature Signed EIP712 hashstruct containing the deposit ID. Should be signed by the depositor\n * account. If depositor is a contract, then should implement EIP1271 to sign as a contract. See\n * _verifyUpdateV3DepositMessage() for more details about how this signature should be constructed.\n */\n function speedUpDeposit(\n bytes32 depositor,\n uint256 depositId,\n uint256 updatedOutputAmount,\n bytes32 updatedRecipient,\n bytes calldata updatedMessage,\n bytes calldata depositorSignature\n ) public override nonReentrant {\n _verifyUpdateV3DepositMessage(\n depositor.toAddress(),\n depositId,\n chainId(),\n updatedOutputAmount,\n updatedRecipient,\n updatedMessage,\n depositorSignature,\n UPDATE_BYTES32_DEPOSIT_DETAILS_HASH\n );\n\n // Assuming the above checks passed, a relayer can take the signature and the updated deposit information\n // from the following event to submit a fill with updated relay data.\n emit RequestedSpeedUpDeposit(\n updatedOutputAmount,\n depositId,\n depositor,\n updatedRecipient,\n updatedMessage,\n depositorSignature\n );\n }\n\n /**\n * @notice A version of `speedUpDeposit` using `address` types for backward compatibility.\n * This function allows the depositor to signal to the relayer to use updated output amount, recipient, and/or message\n * when filling a deposit. This can be useful when the deposit needs to be modified after the original transaction has\n * been mined.\n *\n * @dev The `depositor` and `depositId` must match the parameters in a `FundsDeposited` event that the depositor wants to speed up.\n * The relayer is not obligated but has the option to use this updated information when filling the deposit using\n * `fillRelayWithUpdatedDeposit()`. This version uses `address` types for compatibility with systems relying on\n * `address`-based implementations.\n *\n * @param depositor The depositor that must sign the `depositorSignature` and was the original depositor.\n * @param depositId The deposit ID to speed up.\n * @param updatedOutputAmount The new output amount to use for this deposit. It should be lower than the previous value,\n * otherwise the relayer has no incentive to use this updated value.\n * @param updatedRecipient The new recipient for this deposit. Can be modified if the original recipient is a contract that\n * expects to receive a message from the relay and needs to be changed.\n * @param updatedMessage The new message for this deposit. Can be modified if the recipient is a contract that expects\n * to receive a message from the relay and needs to be updated.\n * @param depositorSignature The signed EIP712 hashstruct containing the deposit ID. Should be signed by the depositor account.\n * If the depositor is a contract, it should implement EIP1271 to sign as a contract. See `_verifyUpdateV3DepositMessage()`\n * for more details on how the signature should be constructed.\n */\n function speedUpV3Deposit(\n address depositor,\n uint256 depositId,\n uint256 updatedOutputAmount,\n address updatedRecipient,\n bytes calldata updatedMessage,\n bytes calldata depositorSignature\n ) public {\n _verifyUpdateV3DepositMessage(\n depositor,\n depositId,\n chainId(),\n updatedOutputAmount,\n updatedRecipient.toBytes32(),\n updatedMessage,\n depositorSignature,\n UPDATE_BYTES32_DEPOSIT_DETAILS_HASH\n );\n\n // Assuming the above checks passed, a relayer can take the signature and the updated deposit information\n // from the following event to submit a fill with updated relay data.\n emit RequestedSpeedUpDeposit(\n updatedOutputAmount,\n depositId,\n depositor.toBytes32(),\n updatedRecipient.toBytes32(),\n updatedMessage,\n depositorSignature\n );\n }\n\n /**************************************\n * RELAYER FUNCTIONS *\n **************************************/\n\n /**\n * @notice Fulfill request to bridge cross chain by sending specified output tokens to the recipient.\n * @dev The fee paid to relayers and the system should be captured in the spread between output\n * amount and input amount when adjusted to be denominated in the input token. A relayer on the destination\n * chain will send outputAmount of outputTokens to the recipient and receive inputTokens on a repayment\n * chain of their choice. Therefore, the fee should account for destination fee transaction costs, the\n * relayer's opportunity cost of capital while they wait to be refunded following an optimistic challenge\n * window in the HubPool, and a system fee charged to relayers.\n * @dev The hash of the relayData will be used to uniquely identify the deposit to fill, so\n * modifying any params in it will result in a different hash and a different deposit. The hash will comprise\n * all parameters passed to deposit() on the origin chain along with that chain's chainId(). This chain's\n * chainId() must therefore match the destinationChainId passed into deposit.\n * Relayers are only refunded for filling deposits with deposit hashes that map exactly to the one emitted by the\n * origin SpokePool therefore the relayer should not modify any params in relayData.\n * @dev Cannot fill more than once. Partial fills are not supported.\n * @param relayData struct containing all the data needed to identify the deposit to be filled. Should match\n * all the same-named parameters emitted in the origin chain FundsDeposited event.\n * - depositor: The account credited with the deposit who can request to \"speed up\" this deposit by modifying\n * the output amount, recipient, and message.\n * - recipient The account receiving funds on this chain. Can be an EOA or a contract. If\n * the output token is the wrapped native token for the chain, then the recipient will receive native token if\n * an EOA or wrapped native token if a contract.\n * - inputToken: The token pulled from the caller's account to initiate the deposit. The equivalent of this\n * token on the repayment chain will be sent as a refund to the caller.\n * - outputToken The token that the caller will send to the recipient on the destination chain. Must be an\n * ERC20.\n * - inputAmount: This amount, less a system fee, will be sent to the caller on their repayment chain of choice as a refund\n * following an optimistic challenge window in the HubPool.\n * - outputAmount: The amount of output tokens that the caller will send to the recipient.\n * - originChainId: The origin chain identifier.\n * - exclusiveRelayer The relayer that will be exclusively allowed to fill this deposit before the\n * exclusivity deadline timestamp.\n * - fillDeadline The deadline for the caller to fill the deposit. After this timestamp,\n * the fill will revert on the destination chain.\n * - exclusivityDeadline: The deadline for the exclusive relayer to fill the deposit. After this\n * timestamp, anyone can fill this deposit. Note that if this value was set in deposit by adding an offset\n * to the deposit's block.timestamp, there is re-org risk for the caller of this method because the event's\n * block.timestamp can change. Read the comments in `deposit` about the `exclusivityParameter` for more details.\n * - message The message to send to the recipient if the recipient is a contract that implements a\n * handleV3AcrossMessage() public function\n * @param repaymentChainId Chain of SpokePool where relayer wants to be refunded after the challenge window has\n * passed. Will receive inputAmount of the equivalent token to inputToken on the repayment chain.\n * @param repaymentAddress Address the relayer wants to be receive their refund at.\n */\n function fillRelay(\n V3RelayData memory relayData,\n uint256 repaymentChainId,\n bytes32 repaymentAddress\n ) public override nonReentrant unpausedFills {\n // Exclusivity deadline is inclusive and is the latest timestamp that the exclusive relayer has sole right\n // to fill the relay.\n if (\n _fillIsExclusive(relayData.exclusivityDeadline, uint32(getCurrentTime())) &&\n relayData.exclusiveRelayer.toAddress() != msg.sender\n ) {\n revert NotExclusiveRelayer();\n }\n\n V3RelayExecutionParams memory relayExecution = V3RelayExecutionParams({\n relay: relayData,\n relayHash: getV3RelayHash(relayData),\n updatedOutputAmount: relayData.outputAmount,\n updatedRecipient: relayData.recipient,\n updatedMessage: relayData.message,\n repaymentChainId: repaymentChainId\n });\n\n _fillRelayV3(relayExecution, repaymentAddress, false);\n }\n\n // Exposes the same function as fillRelay but with a legacy V3RelayData struct that takes in address types. Inner\n // function fillV3Relay() applies reentrancy & non-paused checks.\n function fillV3Relay(V3RelayDataLegacy calldata relayData, uint256 repaymentChainId) public override {\n // Convert V3RelayDataLegacy to V3RelayData using the .toBytes32() method.\n V3RelayData memory convertedRelayData = V3RelayData({\n depositor: relayData.depositor.toBytes32(),\n recipient: relayData.recipient.toBytes32(),\n exclusiveRelayer: relayData.exclusiveRelayer.toBytes32(),\n inputToken: relayData.inputToken.toBytes32(),\n outputToken: relayData.outputToken.toBytes32(),\n inputAmount: relayData.inputAmount,\n outputAmount: relayData.outputAmount,\n originChainId: relayData.originChainId,\n depositId: relayData.depositId,\n fillDeadline: relayData.fillDeadline,\n exclusivityDeadline: relayData.exclusivityDeadline,\n message: relayData.message\n });\n\n fillRelay(convertedRelayData, repaymentChainId, msg.sender.toBytes32());\n }\n\n /**\n * @notice Identical to fillV3Relay except that the relayer wants to use a depositor's updated output amount,\n * recipient, and/or message. The relayer should only use this function if they can supply a message signed\n * by the depositor that contains the fill's matching deposit ID along with updated relay parameters.\n * If the signature can be verified, then this function will emit a FilledV3Event that will be used by\n * the system for refund verification purposes. In other words, this function is an alternative way to fill a\n * a deposit than fillV3Relay.\n * @dev Subject to same exclusivity deadline rules as fillV3Relay().\n * @param relayData struct containing all the data needed to identify the deposit to be filled. See fillV3Relay().\n * @param repaymentChainId Chain of SpokePool where relayer wants to be refunded after the challenge window has\n * passed. See fillV3Relay().\n * @param repaymentAddress Address the relayer wants to be receive their refund at.\n * @param updatedOutputAmount New output amount to use for this deposit.\n * @param updatedRecipient New recipient to use for this deposit.\n * @param updatedMessage New message to use for this deposit.\n * @param depositorSignature Signed EIP712 hashstruct containing the deposit ID. Should be signed by the depositor\n * account.\n */\n function fillRelayWithUpdatedDeposit(\n V3RelayData calldata relayData,\n uint256 repaymentChainId,\n bytes32 repaymentAddress,\n uint256 updatedOutputAmount,\n bytes32 updatedRecipient,\n bytes calldata updatedMessage,\n bytes calldata depositorSignature\n ) public override nonReentrant unpausedFills {\n // Exclusivity deadline is inclusive and is the latest timestamp that the exclusive relayer has sole right\n // to fill the relay.\n if (\n _fillIsExclusive(relayData.exclusivityDeadline, uint32(getCurrentTime())) &&\n relayData.exclusiveRelayer.toAddress() != msg.sender\n ) {\n revert NotExclusiveRelayer();\n }\n\n V3RelayExecutionParams memory relayExecution = V3RelayExecutionParams({\n relay: relayData,\n relayHash: getV3RelayHash(relayData),\n updatedOutputAmount: updatedOutputAmount,\n updatedRecipient: updatedRecipient,\n updatedMessage: updatedMessage,\n repaymentChainId: repaymentChainId\n });\n\n _verifyUpdateV3DepositMessage(\n relayData.depositor.toAddress(),\n relayData.depositId,\n relayData.originChainId,\n updatedOutputAmount,\n updatedRecipient,\n updatedMessage,\n depositorSignature,\n UPDATE_BYTES32_DEPOSIT_DETAILS_HASH\n );\n\n _fillRelayV3(relayExecution, repaymentAddress, false);\n }\n\n /**\n * @notice Request Across to send LP funds to this contract to fulfill a slow fill relay\n * for a deposit in the next bundle.\n * @dev Slow fills are not possible unless the input and output tokens are \"equivalent\", i.e.\n * they route to the same L1 token via PoolRebalanceRoutes.\n * @dev Slow fills are created by inserting slow fill objects into a merkle tree that is included\n * in the next HubPool \"root bundle\". Once the optimistic challenge window has passed, the HubPool\n * will relay the slow root to this chain via relayRootBundle(). Once the slow root is relayed,\n * the slow fill can be executed by anyone who calls executeSlowRelayLeaf().\n * @dev Cannot request a slow fill if the fill deadline has passed.\n * @dev Cannot request a slow fill if the relay has already been filled or a slow fill has already been requested.\n * @param relayData struct containing all the data needed to identify the deposit that should be\n * slow filled. If any of the params are missing or different from the origin chain deposit,\n * then Across will not include a slow fill for the intended deposit.\n */\n function requestSlowFill(V3RelayData calldata relayData) public override nonReentrant unpausedFills {\n uint32 currentTime = uint32(getCurrentTime());\n // If a depositor has set an exclusivity deadline, then only the exclusive relayer should be able to\n // fast fill within this deadline. Moreover, the depositor should expect to get *fast* filled within\n // this deadline, not slow filled. As a simplifying assumption, we will not allow slow fills to be requested\n // during this exclusivity period.\n if (_fillIsExclusive(relayData.exclusivityDeadline, currentTime)) {\n revert NoSlowFillsInExclusivityWindow();\n }\n if (relayData.fillDeadline < currentTime) revert ExpiredFillDeadline();\n\n bytes32 relayHash = getV3RelayHash(relayData);\n if (fillStatuses[relayHash] != uint256(FillStatus.Unfilled)) revert InvalidSlowFillRequest();\n fillStatuses[relayHash] = uint256(FillStatus.RequestedSlowFill);\n\n emit RequestedSlowFill(\n relayData.inputToken,\n relayData.outputToken,\n relayData.inputAmount,\n relayData.outputAmount,\n relayData.originChainId,\n relayData.depositId,\n relayData.fillDeadline,\n relayData.exclusivityDeadline,\n relayData.exclusiveRelayer,\n relayData.depositor,\n relayData.recipient,\n _hashNonEmptyMessage(relayData.message)\n );\n }\n\n /**\n * @notice Fills a single leg of a particular order on the destination chain\n * @dev ERC-7683 fill function.\n * @param orderId Unique order identifier for this order\n * @param originData Data emitted on the origin to parameterize the fill\n * @param fillerData Data provided by the filler to inform the fill or express their preferences\n */\n function fill(\n bytes32 orderId,\n bytes calldata originData,\n bytes calldata fillerData\n ) external {\n if (keccak256(abi.encode(originData, chainId())) != orderId) {\n revert WrongERC7683OrderId();\n }\n\n // Ensure that the call is not malformed. If the call is malformed, abi.decode will fail.\n V3SpokePoolInterface.V3RelayData memory relayData = abi.decode(originData, (V3SpokePoolInterface.V3RelayData));\n AcrossDestinationFillerData memory destinationFillerData = abi.decode(\n fillerData,\n (AcrossDestinationFillerData)\n );\n\n // Must do a delegatecall because the function requires the inputs to be calldata.\n (bool success, bytes memory data) = address(this).delegatecall(\n abi.encodeCall(\n V3SpokePoolInterface.fillRelay,\n (relayData, destinationFillerData.repaymentChainId, msg.sender.toBytes32())\n )\n );\n if (!success) {\n revert LowLevelCallFailed(data);\n }\n }\n\n /**************************************\n * DATA WORKER FUNCTIONS *\n **************************************/\n\n /**\n * @notice Executes a slow relay leaf stored as part of a root bundle relayed by the HubPool.\n * @dev Executing a slow fill leaf is equivalent to filling the relayData so this function cannot be used to\n * double fill a recipient. The relayData that is filled is included in the slowFillLeaf and is hashed\n * like any other fill sent through a fill method.\n * @dev There is no relayer credited with filling this relay since funds are sent directly out of this contract.\n * @param slowFillLeaf Contains all data necessary to uniquely identify a relay for this chain. This struct is\n * hashed and included in a merkle root that is relayed to all spoke pools.\n * - relayData: struct containing all the data needed to identify the original deposit to be slow filled.\n * - chainId: chain identifier where slow fill leaf should be executed. If this doesn't match this chain's\n * chainId, then this function will revert.\n * - updatedOutputAmount: Amount to be sent to recipient out of this contract's balance. Can be set differently\n * from relayData.outputAmount to charge a different fee because this deposit was \"slow\" filled. Usually,\n * this will be set higher to reimburse the recipient for waiting for the slow fill.\n * @param rootBundleId Unique ID of root bundle containing slow relay root that this leaf is contained in.\n * @param proof Inclusion proof for this leaf in slow relay root in root bundle.\n */\n function executeSlowRelayLeaf(\n V3SlowFill calldata slowFillLeaf,\n uint32 rootBundleId,\n bytes32[] calldata proof\n ) public override nonReentrant {\n V3RelayData memory relayData = slowFillLeaf.relayData;\n\n _preExecuteLeafHook(relayData.outputToken.toAddress());\n\n // @TODO In the future consider allowing way for slow fill leaf to be created with updated\n // deposit params like outputAmount, message and recipient.\n V3RelayExecutionParams memory relayExecution = V3RelayExecutionParams({\n relay: relayData,\n relayHash: getV3RelayHash(relayData),\n updatedOutputAmount: slowFillLeaf.updatedOutputAmount,\n updatedRecipient: relayData.recipient,\n updatedMessage: relayData.message,\n repaymentChainId: EMPTY_REPAYMENT_CHAIN_ID // Repayment not relevant for slow fills.\n });\n\n _verifyV3SlowFill(relayExecution, rootBundleId, proof);\n\n // - No relayer to refund for slow fill executions.\n _fillRelayV3(relayExecution, EMPTY_RELAYER, true);\n }\n\n /**\n * @notice Executes a relayer refund leaf stored as part of a root bundle. Will send the relayer the amount they\n * sent to the recipient plus a relayer fee.\n * @param rootBundleId Unique ID of root bundle containing relayer refund root that this leaf is contained in.\n * @param relayerRefundLeaf Contains all data necessary to reconstruct leaf contained in root bundle and to\n * refund relayer. This data structure is explained in detail in the SpokePoolInterface.\n * @param proof Inclusion proof for this leaf in relayer refund root in root bundle.\n */\n function executeRelayerRefundLeaf(\n uint32 rootBundleId,\n SpokePoolInterface.RelayerRefundLeaf memory relayerRefundLeaf,\n bytes32[] memory proof\n ) public payable virtual override nonReentrant {\n _preExecuteLeafHook(relayerRefundLeaf.l2TokenAddress);\n\n if (relayerRefundLeaf.chainId != chainId()) revert InvalidChainId();\n\n RootBundle storage rootBundle = rootBundles[rootBundleId];\n\n // Check that proof proves that relayerRefundLeaf is contained within the relayer refund root.\n // Note: This should revert if the relayerRefundRoot is uninitialized.\n if (!MerkleLib.verifyRelayerRefund(rootBundle.relayerRefundRoot, relayerRefundLeaf, proof)) {\n revert InvalidMerkleProof();\n }\n\n _setClaimedLeaf(rootBundleId, relayerRefundLeaf.leafId);\n\n bool deferredRefunds = _distributeRelayerRefunds(\n relayerRefundLeaf.chainId,\n relayerRefundLeaf.amountToReturn,\n relayerRefundLeaf.refundAmounts,\n relayerRefundLeaf.leafId,\n relayerRefundLeaf.l2TokenAddress,\n relayerRefundLeaf.refundAddresses\n );\n\n emit ExecutedRelayerRefundRoot(\n relayerRefundLeaf.amountToReturn,\n relayerRefundLeaf.chainId,\n relayerRefundLeaf.refundAmounts,\n rootBundleId,\n relayerRefundLeaf.leafId,\n relayerRefundLeaf.l2TokenAddress,\n relayerRefundLeaf.refundAddresses,\n deferredRefunds,\n msg.sender\n );\n }\n\n /**\n * @notice Enables a relayer to claim outstanding repayments. Should virtually never be used, unless for some reason\n * relayer repayment transfer fails for reasons such as token transfer reverts due to blacklisting. In this case,\n * the relayer can still call this method and claim the tokens to a new address.\n * @param l2TokenAddress Address of the L2 token to claim refunds for.\n * @param refundAddress Address to send the refund to.\n */\n function claimRelayerRefund(bytes32 l2TokenAddress, bytes32 refundAddress) external {\n uint256 refund = relayerRefund[l2TokenAddress.toAddress()][msg.sender];\n if (refund == 0) revert NoRelayerRefundToClaim();\n relayerRefund[l2TokenAddress.toAddress()][msg.sender] = 0;\n IERC20Upgradeable(l2TokenAddress.toAddress()).safeTransfer(refundAddress.toAddress(), refund);\n\n emit ClaimedRelayerRefund(l2TokenAddress, refundAddress, refund, msg.sender);\n }\n\n /**************************************\n * VIEW FUNCTIONS *\n **************************************/\n\n /**\n * @notice Returns chain ID for this network.\n * @dev Some L2s like ZKSync don't support the CHAIN_ID opcode so we allow the implementer to override this.\n */\n function chainId() public view virtual override returns (uint256) {\n return block.chainid;\n }\n\n /**\n * @notice Gets the current time.\n * @return uint for the current timestamp.\n */\n function getCurrentTime() public view virtual returns (uint256) {\n return block.timestamp; // solhint-disable-line not-rely-on-time\n }\n\n /**\n * @notice Returns the deposit ID for an unsafe deposit. This function is used to compute the deposit ID\n * in unsafeDeposit and is provided as a convenience.\n * @dev msgSender and depositor are both used as inputs to allow passthrough depositors to create unique\n * deposit hash spaces for unique depositors.\n * @param msgSender The caller of the transaction used as input to produce the deposit ID.\n * @param depositor The depositor address used as input to produce the deposit ID.\n * @param depositNonce The nonce used as input to produce the deposit ID.\n * @return The deposit ID for the unsafe deposit.\n */\n function getUnsafeDepositId(\n address msgSender,\n bytes32 depositor,\n uint256 depositNonce\n ) public pure returns (uint256) {\n return uint256(keccak256(abi.encodePacked(msgSender, depositor, depositNonce)));\n }\n\n function getRelayerRefund(address l2TokenAddress, address refundAddress) public view returns (uint256) {\n return relayerRefund[l2TokenAddress][refundAddress];\n }\n\n function getV3RelayHash(V3RelayData memory relayData) public view returns (bytes32) {\n return keccak256(abi.encode(relayData, chainId()));\n }\n\n /**************************************\n * INTERNAL FUNCTIONS *\n **************************************/\n\n function _depositV3(DepositV3Params memory params) internal {\n // Verify depositor is a valid EVM address.\n params.depositor.checkAddress();\n\n // Require that quoteTimestamp has a maximum age so that depositors pay an LP fee based on recent HubPool usage.\n // It is assumed that cross-chain timestamps are normally loosely in-sync, but clock drift can occur. If the\n // SpokePool time stalls or lags significantly, it is still possible to make deposits by setting quoteTimestamp\n // within the configured buffer. The owner should pause deposits/fills if this is undesirable.\n // This will underflow if quoteTimestamp is more than depositQuoteTimeBuffer;\n // this is safe but will throw an unintuitive error.\n\n // slither-disable-next-line timestamp\n uint256 currentTime = getCurrentTime();\n if (currentTime < params.quoteTimestamp || currentTime - params.quoteTimestamp > depositQuoteTimeBuffer)\n revert InvalidQuoteTimestamp();\n\n // fillDeadline is relative to the destination chain.\n // Don’t allow fillDeadline to be more than several bundles into the future.\n // This limits the maximum required lookback for dataworker and relayer instances.\n if (params.fillDeadline > currentTime + fillDeadlineBuffer) revert InvalidFillDeadline();\n\n // There are three cases for setting the exclusivity deadline using the exclusivity parameter:\n // 1. If this parameter is 0, then there is no exclusivity period and emit 0 for the deadline. This\n // means that fillers of this deposit do not have to worry about the block.timestamp of this event changing\n // due to re-orgs when filling this deposit.\n // 2. If the exclusivity parameter is less than or equal to MAX_EXCLUSIVITY_PERIOD_SECONDS, then the exclusivity\n // deadline is set to the block.timestamp of this event plus the exclusivity parameter. This means that the\n // filler of this deposit assumes re-org risk when filling this deposit because the block.timestamp of this\n // event affects the exclusivity deadline.\n // 3. Otherwise, interpret this parameter as a timestamp and emit it as the exclusivity deadline. This means\n // that the filler of this deposit will not assume re-org risk related to the block.timestamp of this\n // event changing.\n uint32 exclusivityDeadline = params.exclusivityParameter;\n if (exclusivityDeadline > 0) {\n if (exclusivityDeadline <= MAX_EXCLUSIVITY_PERIOD_SECONDS) {\n exclusivityDeadline += uint32(currentTime);\n }\n\n // As a safety measure, prevent caller from inadvertently locking funds during exclusivity period\n // by forcing them to specify an exclusive relayer.\n if (params.exclusiveRelayer == bytes32(0)) revert InvalidExclusiveRelayer();\n }\n\n // If the address of the origin token is a wrappedNativeToken contract and there is a msg.value with the\n // transaction then the user is sending the native token. In this case, the native token should be\n // wrapped.\n if (params.inputToken == address(wrappedNativeToken).toBytes32() && msg.value > 0) {\n if (msg.value != params.inputAmount) revert MsgValueDoesNotMatchInputAmount();\n wrappedNativeToken.deposit{ value: msg.value }();\n // Else, it is a normal ERC20. In this case pull the token from the caller as per normal.\n // Note: this includes the case where the L2 caller has WETH (already wrapped ETH) and wants to bridge them.\n // In this case the msg.value will be set to 0, indicating a \"normal\" ERC20 bridging action.\n } else {\n // msg.value should be 0 if input token isn't the wrapped native token.\n if (msg.value != 0) revert MsgValueDoesNotMatchInputAmount();\n IERC20Upgradeable(params.inputToken.toAddress()).safeTransferFrom(\n msg.sender,\n address(this),\n params.inputAmount\n );\n }\n\n emit FundsDeposited(\n params.inputToken,\n params.outputToken,\n params.inputAmount,\n params.outputAmount,\n params.destinationChainId,\n params.depositId,\n params.quoteTimestamp,\n params.fillDeadline,\n exclusivityDeadline,\n params.depositor,\n params.recipient,\n params.exclusiveRelayer,\n params.message\n );\n }\n\n function _deposit(\n address depositor,\n address recipient,\n address originToken,\n uint256 amount,\n uint256 destinationChainId,\n int64 relayerFeePct,\n uint32 quoteTimestamp,\n bytes memory message\n ) internal {\n // We limit the relay fees to prevent the user spending all their funds on fees.\n if (SignedMath.abs(relayerFeePct) >= 0.5e18) revert InvalidRelayerFeePct();\n if (amount > MAX_TRANSFER_SIZE) revert MaxTransferSizeExceeded();\n\n // Require that quoteTimestamp has a maximum age so that depositors pay an LP fee based on recent HubPool usage.\n // It is assumed that cross-chain timestamps are normally loosely in-sync, but clock drift can occur. If the\n // SpokePool time stalls or lags significantly, it is still possible to make deposits by setting quoteTimestamp\n // within the configured buffer. The owner should pause deposits if this is undesirable. This will underflow if\n // quoteTimestamp is more than depositQuoteTimeBuffer; this is safe but will throw an unintuitive error.\n\n // slither-disable-next-line timestamp\n if (getCurrentTime() - quoteTimestamp > depositQuoteTimeBuffer) revert InvalidQuoteTimestamp();\n\n // Increment count of deposits so that deposit ID for this spoke pool is unique.\n uint32 newDepositId = numberOfDeposits++;\n\n // If the address of the origin token is a wrappedNativeToken contract and there is a msg.value with the\n // transaction then the user is sending ETH. In this case, the ETH should be deposited to wrappedNativeToken.\n if (originToken == address(wrappedNativeToken) && msg.value > 0) {\n if (msg.value != amount) revert MsgValueDoesNotMatchInputAmount();\n wrappedNativeToken.deposit{ value: msg.value }();\n // Else, it is a normal ERC20. In this case pull the token from the user's wallet as per normal.\n // Note: this includes the case where the L2 user has WETH (already wrapped ETH) and wants to bridge them.\n // In this case the msg.value will be set to 0, indicating a \"normal\" ERC20 bridging action.\n } else {\n IERC20Upgradeable(originToken).safeTransferFrom(msg.sender, address(this), amount);\n }\n\n emit FundsDeposited(\n originToken.toBytes32(), // inputToken\n bytes32(0), // outputToken. Setting this to 0x0 means that the outputToken should be assumed to be the\n // canonical token for the destination chain matching the inputToken. Therefore, this deposit\n // can always be slow filled.\n // - setting token to 0x0 will signal to off-chain validator that the \"equivalent\"\n // token as the inputToken for the destination chain should be replaced here.\n amount, // inputAmount\n _computeAmountPostFees(amount, relayerFeePct), // outputAmount\n // - output amount will be the deposit amount less relayerFeePct, which should now be set\n // equal to realizedLpFeePct + gasFeePct + capitalCostFeePct where (gasFeePct + capitalCostFeePct)\n // is equal to the old usage of `relayerFeePct`.\n destinationChainId,\n newDepositId,\n quoteTimestamp,\n INFINITE_FILL_DEADLINE, // fillDeadline. Default to infinite expiry because\n // expired deposits refunds could be a breaking change for existing users of this function.\n 0, // exclusivityDeadline. Setting this to 0 along with the exclusiveRelayer to 0x0 means that there\n // is no exclusive deadline\n depositor.toBytes32(),\n recipient.toBytes32(),\n bytes32(0), // exclusiveRelayer. Setting this to 0x0 will signal to off-chain validator that there\n // is no exclusive relayer.\n message\n );\n }\n\n function _distributeRelayerRefunds(\n uint256 _chainId,\n uint256 amountToReturn,\n uint256[] memory refundAmounts,\n uint32 leafId,\n address l2TokenAddress,\n address[] memory refundAddresses\n ) internal returns (bool deferredRefunds) {\n uint256 numRefunds = refundAmounts.length;\n if (refundAddresses.length != numRefunds) revert InvalidMerkleLeaf();\n\n if (numRefunds > 0) {\n uint256 spokeStartBalance = IERC20Upgradeable(l2TokenAddress).balanceOf(address(this));\n uint256 totalRefundedAmount = 0; // Track the total amount refunded.\n\n // Send each relayer refund address the associated refundAmount for the L2 token address.\n // Note: Even if the L2 token is not enabled on this spoke pool, we should still refund relayers.\n for (uint256 i = 0; i < numRefunds; ++i) {\n if (refundAmounts[i] > 0) {\n totalRefundedAmount += refundAmounts[i];\n\n // Only if the total refunded amount exceeds the spoke starting balance, should we revert. This\n // ensures that bundles are atomic, if we have sufficient balance to refund all relayers and\n // prevents can only re-pay some of the relayers.\n if (totalRefundedAmount > spokeStartBalance) revert InsufficientSpokePoolBalanceToExecuteLeaf();\n\n bool success = _noRevertTransfer(l2TokenAddress, refundAddresses[i], refundAmounts[i]);\n\n // If the transfer failed then track a deferred transfer for the relayer. Given this function would\n // have reverted if there was insufficient balance, this will only happen if the transfer call\n // reverts. This will only occur if the underlying transfer method on the l2Token reverts due to\n // recipient blacklisting or other related modifications to the l2Token.transfer method.\n if (!success) {\n relayerRefund[l2TokenAddress][refundAddresses[i]] += refundAmounts[i];\n deferredRefunds = true;\n }\n }\n }\n }\n // If leaf's amountToReturn is positive, then send L2 --> L1 message to bridge tokens back via\n // chain-specific bridging method.\n if (amountToReturn > 0) {\n _bridgeTokensToHubPool(amountToReturn, l2TokenAddress);\n\n emit TokensBridged(amountToReturn, _chainId, leafId, l2TokenAddress.toBytes32(), msg.sender);\n }\n }\n\n // Re-implementation of OZ _callOptionalReturnBool to use private logic. Function executes a transfer and returns a\n // bool indicating if the external call was successful, rather than reverting. Original method:\n // https://github.com/OpenZeppelin/openzeppelin-contracts/blob/28aed34dc5e025e61ea0390c18cac875bfde1a78/contracts/token/ERC20/utils/SafeERC20.sol#L188\n function _noRevertTransfer(\n address token,\n address to,\n uint256 amount\n ) internal returns (bool) {\n bool success;\n uint256 returnSize;\n uint256 returnValue;\n bytes memory data = abi.encodeCall(IERC20Upgradeable.transfer, (to, amount));\n assembly {\n success := call(gas(), token, 0, add(data, 0x20), mload(data), 0, 0x20)\n returnSize := returndatasize()\n returnValue := mload(0)\n }\n return success && (returnSize == 0 ? address(token).code.length > 0 : returnValue == 1);\n }\n\n function _setCrossDomainAdmin(address newCrossDomainAdmin) internal {\n if (newCrossDomainAdmin == address(0)) revert InvalidCrossDomainAdmin();\n crossDomainAdmin = newCrossDomainAdmin;\n emit SetXDomainAdmin(newCrossDomainAdmin);\n }\n\n function _setWithdrawalRecipient(address newWithdrawalRecipient) internal {\n if (newWithdrawalRecipient == address(0)) revert InvalidWithdrawalRecipient();\n withdrawalRecipient = newWithdrawalRecipient;\n emit SetWithdrawalRecipient(newWithdrawalRecipient);\n }\n\n function _preExecuteLeafHook(address) internal virtual {\n // This method by default is a no-op. Different child spoke pools might want to execute functionality here\n // such as wrapping any native tokens owned by the contract into wrapped tokens before proceeding with\n // executing the leaf.\n }\n\n // Should be overriden by implementing contract depending on how L2 handles sending tokens to L1.\n function _bridgeTokensToHubPool(uint256 amountToReturn, address l2TokenAddress) internal virtual;\n\n function _setClaimedLeaf(uint32 rootBundleId, uint32 leafId) internal {\n RootBundle storage rootBundle = rootBundles[rootBundleId];\n\n // Verify the leafId in the leaf has not yet been claimed.\n if (MerkleLib.isClaimed(rootBundle.claimedBitmap, leafId)) revert ClaimedMerkleLeaf();\n\n // Set leaf as claimed in bitmap. This is passed by reference to the storage rootBundle.\n MerkleLib.setClaimed(rootBundle.claimedBitmap, leafId);\n }\n\n function _verifyUpdateV3DepositMessage(\n address depositor,\n uint256 depositId,\n uint256 originChainId,\n uint256 updatedOutputAmount,\n bytes32 updatedRecipient,\n bytes memory updatedMessage,\n bytes memory depositorSignature,\n bytes32 hashType\n ) internal view {\n // A depositor can request to modify an un-relayed deposit by signing a hash containing the updated\n // details and information uniquely identifying the deposit to relay. This information ensures\n // that this signature cannot be re-used for other deposits.\n bytes32 expectedTypedDataV4Hash = _hashTypedDataV4(\n keccak256(\n abi.encode(\n hashType,\n depositId,\n originChainId,\n updatedOutputAmount,\n updatedRecipient,\n keccak256(updatedMessage)\n )\n ),\n originChainId\n );\n _verifyDepositorSignature(depositor, expectedTypedDataV4Hash, depositorSignature);\n }\n\n // This function is isolated and made virtual to allow different L2's to implement chain specific recovery of\n // signers from signatures because some L2s might not support ecrecover. To be safe, consider always reverting\n // this function for L2s where ecrecover is different from how it works on Ethereum, otherwise there is the\n // potential to forge a signature from the depositor using a different private key than the original depositor's.\n function _verifyDepositorSignature(\n address depositor,\n bytes32 ethSignedMessageHash,\n bytes memory depositorSignature\n ) internal view virtual {\n // Note:\n // - We don't need to worry about re-entrancy from a contract deployed at the depositor address since the method\n // `SignatureChecker.isValidSignatureNow` is a view method. Re-entrancy can happen, but it cannot affect state.\n // - EIP-1271 signatures are supported. This means that a signature valid now, may not be valid later and vice-versa.\n // - For an EIP-1271 signature to work, the depositor contract address must map to a deployed contract on the destination\n // chain that can validate the signature.\n // - Regular signatures from an EOA are also supported.\n bool isValid = SignatureChecker.isValidSignatureNow(depositor, ethSignedMessageHash, depositorSignature);\n if (!isValid) revert InvalidDepositorSignature();\n }\n\n function _verifyV3SlowFill(\n V3RelayExecutionParams memory relayExecution,\n uint32 rootBundleId,\n bytes32[] memory proof\n ) internal view {\n V3SlowFill memory slowFill = V3SlowFill({\n relayData: relayExecution.relay,\n chainId: chainId(),\n updatedOutputAmount: relayExecution.updatedOutputAmount\n });\n\n if (!MerkleLib.verifyV3SlowRelayFulfillment(rootBundles[rootBundleId].slowRelayRoot, slowFill, proof)) {\n revert InvalidMerkleProof();\n }\n }\n\n function _computeAmountPostFees(uint256 amount, int256 feesPct) private pure returns (uint256) {\n return (amount * uint256(int256(1e18) - feesPct)) / 1e18;\n }\n\n // Unwraps ETH and does a transfer to a recipient address. If the recipient is a smart contract then sends wrappedNativeToken.\n function _unwrapwrappedNativeTokenTo(address payable to, uint256 amount) internal {\n if (address(to).isContract()) {\n IERC20Upgradeable(address(wrappedNativeToken)).safeTransfer(to, amount);\n } else {\n wrappedNativeToken.withdraw(amount);\n AddressLibUpgradeable.sendValue(to, amount);\n }\n }\n\n // @param relayer: relayer who is actually credited as filling this deposit. Can be different from\n // exclusiveRelayer if passed exclusivityDeadline or if slow fill.\n function _fillRelayV3(\n V3RelayExecutionParams memory relayExecution,\n bytes32 relayer,\n bool isSlowFill\n ) internal {\n V3RelayData memory relayData = relayExecution.relay;\n\n if (relayData.fillDeadline < getCurrentTime()) revert ExpiredFillDeadline();\n\n bytes32 relayHash = relayExecution.relayHash;\n\n // If a slow fill for this fill was requested then the relayFills value for this hash will be\n // FillStatus.RequestedSlowFill. Therefore, if this is the status, then this fast fill\n // will be replacing the slow fill. If this is a slow fill execution, then the following variable\n // is trivially true. We'll emit this value in the FilledRelay\n // event to assist the Dataworker in knowing when to return funds back to the HubPool that can no longer\n // be used for a slow fill execution.\n FillType fillType = isSlowFill\n ? FillType.SlowFill // The following is true if this is a fast fill that was sent after a slow fill request.\n : (\n fillStatuses[relayExecution.relayHash] == uint256(FillStatus.RequestedSlowFill)\n ? FillType.ReplacedSlowFill\n : FillType.FastFill\n );\n\n // @dev This function doesn't support partial fills. Therefore, we associate the relay hash with\n // an enum tracking its fill status. All filled relays, whether slow or fast fills, are set to the Filled\n // status. However, we also use this slot to track whether this fill had a slow fill requested. Therefore\n // we can include a bool in the FilledRelay event making it easy for the dataworker to compute if this\n // fill was a fast fill that replaced a slow fill and therefore this SpokePool has excess funds that it\n // needs to send back to the HubPool.\n if (fillStatuses[relayHash] == uint256(FillStatus.Filled)) revert RelayFilled();\n fillStatuses[relayHash] = uint256(FillStatus.Filled);\n\n // @dev Before returning early, emit events to assist the dataworker in being able to know which fills were\n // successful.\n emit FilledRelay(\n relayData.inputToken,\n relayData.outputToken,\n relayData.inputAmount,\n relayData.outputAmount,\n relayExecution.repaymentChainId,\n relayData.originChainId,\n relayData.depositId,\n relayData.fillDeadline,\n relayData.exclusivityDeadline,\n relayData.exclusiveRelayer,\n relayer,\n relayData.depositor,\n relayData.recipient,\n _hashNonEmptyMessage(relayData.message),\n V3RelayExecutionEventInfo({\n updatedRecipient: relayExecution.updatedRecipient,\n updatedMessageHash: _hashNonEmptyMessage(relayExecution.updatedMessage),\n updatedOutputAmount: relayExecution.updatedOutputAmount,\n fillType: fillType\n })\n );\n\n address outputToken = relayData.outputToken.toAddress();\n uint256 amountToSend = relayExecution.updatedOutputAmount;\n address recipientToSend = relayExecution.updatedRecipient.toAddress();\n // If relay token is wrappedNativeToken then unwrap and send native token.\n // Stack too deep.\n if (relayData.outputToken.toAddress() == address(wrappedNativeToken)) {\n // Note: useContractFunds is True if we want to send funds to the recipient directly out of this contract,\n // otherwise we expect the caller to send funds to the recipient. If useContractFunds is True and the\n // recipient wants wrappedNativeToken, then we can assume that wrappedNativeToken is already in the\n // contract, otherwise we'll need the user to send wrappedNativeToken to this contract. Regardless, we'll\n // need to unwrap it to native token before sending to the user.\n if (!isSlowFill) IERC20Upgradeable(outputToken).safeTransferFrom(msg.sender, address(this), amountToSend);\n _unwrapwrappedNativeTokenTo(payable(recipientToSend), amountToSend);\n // Else, this is a normal ERC20 token. Send to recipient.\n } else {\n // Note: Similar to note above, send token directly from the contract to the user in the slow relay case.\n if (!isSlowFill) IERC20Upgradeable(outputToken).safeTransferFrom(msg.sender, recipientToSend, amountToSend);\n else IERC20Upgradeable(outputToken).safeTransfer(recipientToSend, amountToSend);\n }\n\n bytes memory updatedMessage = relayExecution.updatedMessage;\n if (updatedMessage.length > 0 && recipientToSend.isContract()) {\n AcrossMessageHandler(recipientToSend).handleV3AcrossMessage(\n outputToken,\n amountToSend,\n msg.sender,\n updatedMessage\n );\n }\n }\n\n // Determine whether the exclusivityDeadline implies active exclusivity.\n function _fillIsExclusive(uint32 exclusivityDeadline, uint32 currentTime) internal pure returns (bool) {\n return exclusivityDeadline >= currentTime;\n }\n\n // Helper for emitting message hash. For easier easier human readability we return bytes32(0) for empty message.\n function _hashNonEmptyMessage(bytes memory message) internal pure returns (bytes32) {\n if (message.length == 0) return bytes32(0);\n else return keccak256(message);\n }\n\n // Implementing contract needs to override this to ensure that only the appropriate cross chain admin can execute\n // certain admin functions. For L2 contracts, the cross chain admin refers to some L1 address or contract, and for\n // L1, this would just be the same admin of the HubPool.\n function _requireAdminSender() internal virtual;\n\n // Added to enable the this contract to receive native token (ETH). Used when unwrapping wrappedNativeToken.\n receive() external payable {}\n\n // Reserve storage slots for future versions of this base contract to add state variables without\n // affecting the storage layout of child contracts. Decrement the size of __gap whenever state variables\n // are added. This is at bottom of contract to make sure it's always at the end of storage.\n uint256[998] private __gap;\n}\n"
- },
- "contracts/upgradeable/AddressLibUpgradeable.sol": {
- "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (utils/Address.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @title AddressUpgradeable\n * @dev Collection of functions related to the address type\n * @notice Logic is 100% copied from \"@openzeppelin/contracts-upgradeable/contracts/utils/AddressUpgradeable.sol\" but one\n * comment is added to clarify why we allow delegatecall() in this contract, which is typically unsafe for use in\n * upgradeable implementation contracts.\n * @dev See https://docs.openzeppelin.com/upgrades-plugins/1.x/faq#delegatecall-selfdestruct for more details.\n * @custom:security-contact bugs@across.to\n */\nlibrary AddressLibUpgradeable {\n /**\n * @dev Returns true if `account` is a contract.\n *\n * [IMPORTANT]\n * ====\n * It is unsafe to assume that an address for which this function returns\n * false is an externally-owned account (EOA) and not a contract.\n *\n * Among others, `isContract` will return false for the following\n * types of addresses:\n *\n * - an externally-owned account\n * - a contract in construction\n * - an address where a contract will be created\n * - an address where a contract lived, but was destroyed\n *\n * Furthermore, `isContract` will also return true if the target contract within\n * the same transaction is already scheduled for destruction by `SELFDESTRUCT`,\n * which only has an effect at the end of a transaction.\n * ====\n *\n * [IMPORTANT]\n * ====\n * You shouldn't rely on `isContract` to protect against flash loan attacks!\n *\n * Preventing calls from contracts is highly discouraged. It breaks composability, breaks support for smart wallets\n * like Gnosis Safe, and does not provide security since it can be circumvented by calling from a contract\n * constructor.\n * ====\n */\n function isContract(address account) internal view returns (bool) {\n // This method relies on extcodesize/address.code.length, which returns 0\n // for contracts in construction, since the code is only stored at the end\n // of the constructor execution.\n\n return account.code.length > 0;\n }\n\n /**\n * @dev Replacement for Solidity's `transfer`: sends `amount` wei to\n * `recipient`, forwarding all available gas and reverting on errors.\n *\n * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost\n * of certain opcodes, possibly making contracts go over the 2300 gas limit\n * imposed by `transfer`, making them unable to receive funds via\n * `transfer`. {sendValue} removes this limitation.\n *\n * https://consensys.net/diligence/blog/2019/09/stop-using-soliditys-transfer-now/[Learn more].\n *\n * IMPORTANT: because control is transferred to `recipient`, care must be\n * taken to not create reentrancy vulnerabilities. Consider using\n * {ReentrancyGuard} or the\n * https://solidity.readthedocs.io/en/v0.8.0/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].\n */\n function sendValue(address payable recipient, uint256 amount) internal {\n require(address(this).balance >= amount, \"Address: insufficient balance\");\n\n (bool success, ) = recipient.call{ value: amount }(\"\");\n require(success, \"Address: unable to send value, recipient may have reverted\");\n }\n\n /**\n * @dev Performs a Solidity function call using a low level `call`. A\n * plain `call` is an unsafe replacement for a function call: use this\n * function instead.\n *\n * If `target` reverts with a revert reason, it is bubbled up by this\n * function (like regular Solidity function calls).\n *\n * Returns the raw returned data. To convert to the expected return value,\n * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].\n *\n * Requirements:\n *\n * - `target` must be a contract.\n * - calling `target` with `data` must not revert.\n *\n * _Available since v3.1._\n */\n function functionCall(address target, bytes memory data) internal returns (bytes memory) {\n return functionCallWithValue(target, data, 0, \"Address: low-level call failed\");\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with\n * `errorMessage` as a fallback revert reason when `target` reverts.\n *\n * _Available since v3.1._\n */\n function functionCall(\n address target,\n bytes memory data,\n string memory errorMessage\n ) internal returns (bytes memory) {\n return functionCallWithValue(target, data, 0, errorMessage);\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\n * but also transferring `value` wei to `target`.\n *\n * Requirements:\n *\n * - the calling contract must have an ETH balance of at least `value`.\n * - the called Solidity function must be `payable`.\n *\n * _Available since v3.1._\n */\n function functionCallWithValue(\n address target,\n bytes memory data,\n uint256 value\n ) internal returns (bytes memory) {\n return functionCallWithValue(target, data, value, \"Address: low-level call with value failed\");\n }\n\n /**\n * @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but\n * with `errorMessage` as a fallback revert reason when `target` reverts.\n *\n * _Available since v3.1._\n */\n function functionCallWithValue(\n address target,\n bytes memory data,\n uint256 value,\n string memory errorMessage\n ) internal returns (bytes memory) {\n require(address(this).balance >= value, \"Address: insufficient balance for call\");\n (bool success, bytes memory returndata) = target.call{ value: value }(data);\n return verifyCallResultFromTarget(target, success, returndata, errorMessage);\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\n * but performing a static call.\n *\n * _Available since v3.3._\n */\n function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {\n return functionStaticCall(target, data, \"Address: low-level static call failed\");\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],\n * but performing a static call.\n *\n * _Available since v3.3._\n */\n function functionStaticCall(\n address target,\n bytes memory data,\n string memory errorMessage\n ) internal view returns (bytes memory) {\n (bool success, bytes memory returndata) = target.staticcall(data);\n return verifyCallResultFromTarget(target, success, returndata, errorMessage);\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\n * but performing a delegate call.\n *\n * _Available since v3.4._\n */\n function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) {\n return functionDelegateCall(target, data, \"Address: low-level delegate call failed\");\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],\n * but performing a delegate call.\n *\n * _Available since v3.4._\n */\n function functionDelegateCall(\n address target,\n bytes memory data,\n string memory errorMessage\n ) internal returns (bytes memory) {\n /// @custom:oz-upgrades-unsafe-allow delegatecall\n (bool success, bytes memory returndata) = target.delegatecall(data);\n return verifyCallResultFromTarget(target, success, returndata, errorMessage);\n }\n\n /**\n * @dev Tool to verify that a low level call to smart-contract was successful, and revert (either by bubbling\n * the revert reason or using the provided one) in case of unsuccessful call or if target was not a contract.\n *\n * _Available since v4.8._\n */\n function verifyCallResultFromTarget(\n address target,\n bool success,\n bytes memory returndata,\n string memory errorMessage\n ) internal view returns (bytes memory) {\n if (success) {\n if (returndata.length == 0) {\n // only check isContract if the call was successful and the return data is empty\n // otherwise we already know that it was a contract\n require(isContract(target), \"Address: call to non-contract\");\n }\n return returndata;\n } else {\n _revert(returndata, errorMessage);\n }\n }\n\n /**\n * @dev Tool to verify that a low level call was successful, and revert if it wasn't, either by bubbling the\n * revert reason or using the provided one.\n *\n * _Available since v4.3._\n */\n function verifyCallResult(\n bool success,\n bytes memory returndata,\n string memory errorMessage\n ) internal pure returns (bytes memory) {\n if (success) {\n return returndata;\n } else {\n _revert(returndata, errorMessage);\n }\n }\n\n function _revert(bytes memory returndata, string memory errorMessage) private pure {\n // Look for revert reason and bubble it up if present\n if (returndata.length > 0) {\n // The easiest way to bubble the revert reason is using memory via assembly\n /// @solidity memory-safe-assembly\n assembly {\n let returndata_size := mload(returndata)\n revert(add(32, returndata), returndata_size)\n }\n } else {\n revert(errorMessage);\n }\n }\n}\n"
- },
- "contracts/upgradeable/EIP712CrossChainUpgradeable.sol": {
- "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\n\nimport \"@openzeppelin/contracts-upgradeable/utils/cryptography/ECDSAUpgradeable.sol\";\nimport \"@openzeppelin/contracts-upgradeable/proxy/utils/Initializable.sol\";\n\n/**\n * @dev https://eips.ethereum.org/EIPS/eip-712[EIP 712] is a standard for hashing and signing of typed structured data.\n *\n * This contract is based on OpenZeppelin's implementation:\n * https://github.com/OpenZeppelin/openzeppelin-contracts-upgradeable/blob/master/contracts/utils/cryptography/EIP712Upgradeable.sol\n *\n * NOTE: Modified version that allows to build a domain separator that relies on a different chain id than the chain this\n * contract is deployed to. An example use case we want to support is:\n * - User A signs a message on chain with id = 1\n * - User B executes a method by verifying user A's EIP-712 compliant signature on a chain with id != 1\n * @custom:security-contact bugs@across.to\n */\nabstract contract EIP712CrossChainUpgradeable is Initializable {\n /* solhint-disable var-name-mixedcase */\n bytes32 private _HASHED_NAME;\n bytes32 private _HASHED_VERSION;\n bytes32 private constant _TYPE_HASH = keccak256(\"EIP712Domain(string name,string version,uint256 chainId)\");\n\n /* solhint-enable var-name-mixedcase */\n\n /**\n * @dev Initializes the domain separator and parameter caches.\n *\n * The meaning of `name` and `version` is specified in\n * https://eips.ethereum.org/EIPS/eip-712#definition-of-domainseparator[EIP 712]:\n *\n * - `name`: the user readable name of the signing domain, i.e. the name of the DApp or the protocol.\n * - `version`: the current major version of the signing domain.\n *\n * NOTE: These parameters cannot be changed except through a xref:learn::upgrading-smart-contracts.adoc[smart\n * contract upgrade].\n */\n function __EIP712_init(string memory name, string memory version) internal onlyInitializing {\n __EIP712_init_unchained(name, version);\n }\n\n function __EIP712_init_unchained(string memory name, string memory version) internal onlyInitializing {\n bytes32 hashedName = keccak256(bytes(name));\n bytes32 hashedVersion = keccak256(bytes(version));\n _HASHED_NAME = hashedName;\n _HASHED_VERSION = hashedVersion;\n }\n\n /**\n * @dev Returns the domain separator depending on the `originChainId`.\n * @param originChainId Chain id of network where message originates from.\n * @return bytes32 EIP-712-compliant domain separator.\n */\n function _domainSeparatorV4(uint256 originChainId) internal view returns (bytes32) {\n return keccak256(abi.encode(_TYPE_HASH, _HASHED_NAME, _HASHED_VERSION, originChainId));\n }\n\n /**\n * @dev Given an already https://eips.ethereum.org/EIPS/eip-712#definition-of-hashstruct[hashed struct], this\n * function returns the hash of the fully encoded EIP712 message for this domain.\n *\n * This hash can be used together with {ECDSA-recover} to obtain the signer of a message. For example:\n *\n * ```solidity\n * bytes32 structHash = keccak256(abi.encode(\n * keccak256(\"Mail(address to,string contents)\"),\n * mailTo,\n * keccak256(bytes(mailContents))\n * ));\n * bytes32 digest = _hashTypedDataV4(structHash, originChainId);\n * address signer = ECDSA.recover(digest, signature);\n * ```\n * @param structHash Hashed struct as defined in https://eips.ethereum.org/EIPS/eip-712#definition-of-hashstruct.\n * @param originChainId Chain id of network where message originates from.\n * @return bytes32 Hash digest that is recoverable via `EDCSA.recover`.\n */\n function _hashTypedDataV4(bytes32 structHash, uint256 originChainId) internal view virtual returns (bytes32) {\n return ECDSAUpgradeable.toTypedDataHash(_domainSeparatorV4(originChainId), structHash);\n }\n\n // Reserve storage slots for future versions of this base contract to add state variables without\n // affecting the storage layout of child contracts. Decrement the size of __gap whenever state variables\n // are added. This is at bottom of contract to make sure it's always at the end of storage.\n uint256[1000] private __gap;\n}\n"
- },
- "contracts/upgradeable/MultiCallerUpgradeable.sol": {
- "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\n\n/**\n * @title MultiCallerUpgradeable\n * @notice Logic is 100% copied from \"@uma/core/contracts/common/implementation/MultiCaller.sol\" but one\n * comment is added to clarify why we allow delegatecall() in this contract, which is typically unsafe for use in\n * upgradeable implementation contracts.\n * @dev See https://docs.openzeppelin.com/upgrades-plugins/1.x/faq#delegatecall-selfdestruct for more details.\n * @custom:security-contact bugs@across.to\n */\ncontract MultiCallerUpgradeable {\n struct Result {\n bool success;\n bytes returnData;\n }\n\n function _validateMulticallData(bytes[] calldata data) internal virtual {\n // no-op\n }\n\n function multicall(bytes[] calldata data) external returns (bytes[] memory results) {\n _validateMulticallData(data);\n\n uint256 dataLength = data.length;\n results = new bytes[](dataLength);\n\n //slither-disable-start calls-loop\n for (uint256 i = 0; i < dataLength; ++i) {\n // Typically, implementation contracts used in the upgradeable proxy pattern shouldn't call `delegatecall`\n // because it could allow a malicious actor to call this implementation contract directly (rather than\n // through a proxy contract) and then selfdestruct() the contract, thereby freezing the upgradeable\n // proxy. However, since we're only delegatecall-ing into this contract, then we can consider this\n // use of delegatecall() safe.\n\n //slither-disable-start low-level-calls\n /// @custom:oz-upgrades-unsafe-allow delegatecall\n (bool success, bytes memory result) = address(this).delegatecall(data[i]);\n //slither-disable-end low-level-calls\n\n if (!success) {\n // Next 5 lines from https://ethereum.stackexchange.com/a/83577\n if (result.length < 68) revert();\n //slither-disable-next-line assembly\n assembly {\n result := add(result, 0x04)\n }\n revert(abi.decode(result, (string)));\n }\n\n results[i] = result;\n }\n //slither-disable-end calls-loop\n }\n\n function tryMulticall(bytes[] calldata data) external returns (Result[] memory results) {\n _validateMulticallData(data);\n\n uint256 dataLength = data.length;\n results = new Result[](dataLength);\n\n //slither-disable-start calls-loop\n for (uint256 i = 0; i < dataLength; ++i) {\n // The delegatecall here is safe for the same reasons outlined in the first multicall function.\n Result memory result = results[i];\n //slither-disable-start low-level-calls\n /// @custom:oz-upgrades-unsafe-allow delegatecall\n (result.success, result.returnData) = address(this).delegatecall(data[i]);\n //slither-disable-end low-level-calls\n }\n //slither-disable-end calls-loop\n }\n\n // Reserve storage slots for future versions of this base contract to add state variables without\n // affecting the storage layout of child contracts. Decrement the size of __gap whenever state variables\n // are added. This is at bottom of contract to make sure its always at the end of storage.\n uint256[1000] private __gap;\n}\n"
- },
- "contracts/WorldChain_SpokePool.sol": {
- "content": "// SPDX-License-Identifier: BUSL-1.1\npragma solidity ^0.8.0;\nimport \"@eth-optimism/contracts/libraries/constants/Lib_PredeployAddresses.sol\";\n\nimport \"./Ovm_SpokePool.sol\";\nimport \"./external/interfaces/CCTPInterfaces.sol\";\n\n/**\n * @notice World Chain Spoke pool.\n * @custom:security-contact bugs@across.to\n */\ncontract WorldChain_SpokePool is Ovm_SpokePool {\n using SafeERC20 for IERC20;\n\n /// @custom:oz-upgrades-unsafe-allow constructor\n constructor(\n address _wrappedNativeTokenAddress,\n uint32 _depositQuoteTimeBuffer,\n uint32 _fillDeadlineBuffer,\n IERC20 _l2Usdc,\n ITokenMessenger _cctpTokenMessenger\n )\n Ovm_SpokePool(\n _wrappedNativeTokenAddress,\n _depositQuoteTimeBuffer,\n _fillDeadlineBuffer,\n _l2Usdc,\n _cctpTokenMessenger\n )\n {} // solhint-disable-line no-empty-blocks\n\n /**\n * @notice Construct the OVM SpokePool.\n * @param _initialDepositId Starting deposit ID. Set to 0 unless this is a re-deployment in order to mitigate\n * relay hash collisions.\n * @param _crossDomainAdmin Cross domain admin to set. Can be changed by admin.\n * @param _withdrawalRecipient Address which receives token withdrawals. Can be changed by admin. For Spoke Pools on L2,\n * this will likely be the hub pool.\n */\n function initialize(\n uint32 _initialDepositId,\n address _crossDomainAdmin,\n address _withdrawalRecipient\n ) public initializer {\n __OvmSpokePool_init(_initialDepositId, _crossDomainAdmin, _withdrawalRecipient, Lib_PredeployAddresses.OVM_ETH);\n }\n}\n"
- }
- },
- "settings": {
- "optimizer": {
- "enabled": true,
- "runs": 800
- },
- "viaIR": true,
- "debug": {
- "revertStrings": "strip"
- },
- "outputSelection": {
- "*": {
- "*": ["abi", "evm.bytecode", "evm.deployedBytecode", "evm.methodIdentifiers", "metadata"],
- "": ["ast"]
- }
- }
- }
-}
From 4a29dc8bb7cbd92b609fb618c5f97e7041bf3ef2 Mon Sep 17 00:00:00 2001
From: Paul <108695806+pxrl@users.noreply.github.com>
Date: Tue, 23 Dec 2025 13:45:13 +0000
Subject: [PATCH 6/6] v4
---
.../chain-adapters/WorldChain_Adapter.sol | 11 +--
.../worldchain/WorldChain_SpokePool.json | 85 +++++--------------
2 files changed, 22 insertions(+), 74 deletions(-)
diff --git a/contracts/chain-adapters/WorldChain_Adapter.sol b/contracts/chain-adapters/WorldChain_Adapter.sol
index db481c523..5e618b5fe 100644
--- a/contracts/chain-adapters/WorldChain_Adapter.sol
+++ b/contracts/chain-adapters/WorldChain_Adapter.sol
@@ -9,8 +9,8 @@ import "../external/interfaces/WETH9Interface.sol";
import "./CrossDomainEnabled.sol";
import "@eth-optimism/contracts/L1/messaging/IL1StandardBridge.sol";
-import "@openzeppelin/contracts/token/ERC20/IERC20.sol";
-import "@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol";
+import "@openzeppelin/contracts-v4/token/ERC20/IERC20.sol";
+import "@openzeppelin/contracts-v4/token/ERC20/utils/SafeERC20.sol";
import "../libraries/CircleCCTPAdapter.sol";
import "../external/interfaces/CCTPInterfaces.sol";
@@ -73,12 +73,7 @@ contract WorldChain_Adapter is CrossDomainEnabled, AdapterInterface, CircleCCTPA
* @param amount Amount of L1 tokens to deposit and L2 tokens to receive.
* @param to Bridge recipient.
*/
- function relayTokens(
- address l1Token,
- address l2Token,
- uint256 amount,
- address to
- ) external payable override {
+ function relayTokens(address l1Token, address l2Token, uint256 amount, address to) external payable override {
// If the l1Token is weth then unwrap it to ETH then send the ETH to the standard bridge.
if (l1Token == address(L1_WETH)) {
L1_WETH.withdraw(amount);
diff --git a/deployments/worldchain/WorldChain_SpokePool.json b/deployments/worldchain/WorldChain_SpokePool.json
index 4414f9a6e..ac7eea77a 100644
--- a/deployments/worldchain/WorldChain_SpokePool.json
+++ b/deployments/worldchain/WorldChain_SpokePool.json
@@ -1,5 +1,5 @@
{
- "address": "0xAcDE84590A2ba1aCfEbB220997Eb41B7A01f271f",
+ "address": "0x1771c470d41b8c39338450C380bf2C080a2CEdD8",
"abi": [
{
"inputs": [
@@ -1271,19 +1271,6 @@
"stateMutability": "view",
"type": "function"
},
- {
- "inputs": [],
- "name": "UPDATE_ADDRESS_DEPOSIT_DETAILS_HASH",
- "outputs": [
- {
- "internalType": "bytes32",
- "name": "",
- "type": "bytes32"
- }
- ],
- "stateMutability": "view",
- "type": "function"
- },
{
"inputs": [],
"name": "UPDATE_BYTES32_DEPOSIT_DETAILS_HASH",
@@ -1361,6 +1348,19 @@
"stateMutability": "view",
"type": "function"
},
+ {
+ "inputs": [],
+ "name": "cctpV2",
+ "outputs": [
+ {
+ "internalType": "bool",
+ "name": "",
+ "type": "bool"
+ }
+ ],
+ "stateMutability": "view",
+ "type": "function"
+ },
{
"inputs": [],
"name": "chainId",
@@ -1794,30 +1794,6 @@
"stateMutability": "nonpayable",
"type": "function"
},
- {
- "inputs": [
- {
- "internalType": "address",
- "name": "",
- "type": "address"
- },
- {
- "internalType": "uint256",
- "name": "",
- "type": "uint256"
- }
- ],
- "name": "enabledDepositRoutes",
- "outputs": [
- {
- "internalType": "bool",
- "name": "",
- "type": "bool"
- }
- ],
- "stateMutability": "view",
- "type": "function"
- },
{
"inputs": [
{
@@ -2779,29 +2755,6 @@
"stateMutability": "nonpayable",
"type": "function"
},
- {
- "inputs": [
- {
- "internalType": "address",
- "name": "originToken",
- "type": "address"
- },
- {
- "internalType": "uint256",
- "name": "destinationChainId",
- "type": "uint256"
- },
- {
- "internalType": "bool",
- "name": "enabled",
- "type": "bool"
- }
- ],
- "name": "setEnableRoute",
- "outputs": [],
- "stateMutability": "nonpayable",
- "type": "function"
- },
{
"inputs": [
{
@@ -3138,9 +3091,9 @@
"type": "receive"
}
],
- "numDeployments": 5,
- "solcInputHash": "9ca5938cf4c090d09521d58c1a5ad038",
- "metadata": "{\"compiler\":{\"version\":\"0.8.23+commit.f704f362\"},\"language\":\"Solidity\",\"output\":{\"abi\":[{\"inputs\":[{\"internalType\":\"address\",\"name\":\"_wrappedNativeTokenAddress\",\"type\":\"address\"},{\"internalType\":\"uint32\",\"name\":\"_depositQuoteTimeBuffer\",\"type\":\"uint32\"},{\"internalType\":\"uint32\",\"name\":\"_fillDeadlineBuffer\",\"type\":\"uint32\"},{\"internalType\":\"contract IERC20\",\"name\":\"_l2Usdc\",\"type\":\"address\"},{\"internalType\":\"contract ITokenMessenger\",\"name\":\"_cctpTokenMessenger\",\"type\":\"address\"}],\"stateMutability\":\"nonpayable\",\"type\":\"constructor\"},{\"inputs\":[],\"name\":\"ClaimedMerkleLeaf\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"DepositsArePaused\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"DisabledRoute\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"ExpiredFillDeadline\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"FillsArePaused\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"InsufficientSpokePoolBalanceToExecuteLeaf\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"InvalidBytes32\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"InvalidChainId\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"InvalidCrossDomainAdmin\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"InvalidDepositorSignature\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"InvalidExclusiveRelayer\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"InvalidFillDeadline\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"InvalidMerkleLeaf\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"InvalidMerkleProof\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"InvalidPayoutAdjustmentPct\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"InvalidQuoteTimestamp\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"InvalidRelayerFeePct\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"InvalidSlowFillRequest\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"InvalidWithdrawalRecipient\",\"type\":\"error\"},{\"inputs\":[{\"internalType\":\"bytes\",\"name\":\"data\",\"type\":\"bytes\"}],\"name\":\"LowLevelCallFailed\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"MaxTransferSizeExceeded\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"MsgValueDoesNotMatchInputAmount\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"NoRelayerRefundToClaim\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"NoSlowFillsInExclusivityWindow\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"NotCrossChainCall\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"NotCrossDomainAdmin\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"NotEOA\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"NotExclusiveRelayer\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"RelayFilled\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"WrongERC7683OrderId\",\"type\":\"error\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address\",\"name\":\"previousAdmin\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"newAdmin\",\"type\":\"address\"}],\"name\":\"AdminChanged\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"beacon\",\"type\":\"address\"}],\"name\":\"BeaconUpgraded\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"bytes32\",\"name\":\"l2TokenAddress\",\"type\":\"bytes32\"},{\"indexed\":true,\"internalType\":\"bytes32\",\"name\":\"refundAddress\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"amount\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"address\",\"name\":\"caller\",\"type\":\"address\"}],\"name\":\"ClaimedRelayerRefund\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"uint256\",\"name\":\"rootBundleId\",\"type\":\"uint256\"}],\"name\":\"EmergencyDeletedRootBundle\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"originToken\",\"type\":\"address\"},{\"indexed\":true,\"internalType\":\"uint256\",\"name\":\"destinationChainId\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"bool\",\"name\":\"enabled\",\"type\":\"bool\"}],\"name\":\"EnabledDepositRoute\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"amountToReturn\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"uint256\",\"name\":\"chainId\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"uint256[]\",\"name\":\"refundAmounts\",\"type\":\"uint256[]\"},{\"indexed\":true,\"internalType\":\"uint32\",\"name\":\"rootBundleId\",\"type\":\"uint32\"},{\"indexed\":true,\"internalType\":\"uint32\",\"name\":\"leafId\",\"type\":\"uint32\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"l2TokenAddress\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"address[]\",\"name\":\"refundAddresses\",\"type\":\"address[]\"},{\"indexed\":false,\"internalType\":\"bool\",\"name\":\"deferredRefunds\",\"type\":\"bool\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"caller\",\"type\":\"address\"}],\"name\":\"ExecutedRelayerRefundRoot\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"bytes32\",\"name\":\"inputToken\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"bytes32\",\"name\":\"outputToken\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"inputAmount\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"outputAmount\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"repaymentChainId\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"uint256\",\"name\":\"originChainId\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"uint256\",\"name\":\"depositId\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"uint32\",\"name\":\"fillDeadline\",\"type\":\"uint32\"},{\"indexed\":false,\"internalType\":\"uint32\",\"name\":\"exclusivityDeadline\",\"type\":\"uint32\"},{\"indexed\":false,\"internalType\":\"bytes32\",\"name\":\"exclusiveRelayer\",\"type\":\"bytes32\"},{\"indexed\":true,\"internalType\":\"bytes32\",\"name\":\"relayer\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"bytes32\",\"name\":\"depositor\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"bytes32\",\"name\":\"recipient\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"bytes32\",\"name\":\"messageHash\",\"type\":\"bytes32\"},{\"components\":[{\"internalType\":\"bytes32\",\"name\":\"updatedRecipient\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"updatedMessageHash\",\"type\":\"bytes32\"},{\"internalType\":\"uint256\",\"name\":\"updatedOutputAmount\",\"type\":\"uint256\"},{\"internalType\":\"enum V3SpokePoolInterface.FillType\",\"name\":\"fillType\",\"type\":\"uint8\"}],\"indexed\":false,\"internalType\":\"struct V3SpokePoolInterface.V3RelayExecutionEventInfo\",\"name\":\"relayExecutionInfo\",\"type\":\"tuple\"}],\"name\":\"FilledRelay\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address\",\"name\":\"inputToken\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"outputToken\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"inputAmount\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"outputAmount\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"repaymentChainId\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"uint256\",\"name\":\"originChainId\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"uint32\",\"name\":\"depositId\",\"type\":\"uint32\"},{\"indexed\":false,\"internalType\":\"uint32\",\"name\":\"fillDeadline\",\"type\":\"uint32\"},{\"indexed\":false,\"internalType\":\"uint32\",\"name\":\"exclusivityDeadline\",\"type\":\"uint32\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"exclusiveRelayer\",\"type\":\"address\"},{\"indexed\":true,\"internalType\":\"address\",\"name\":\"relayer\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"depositor\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"recipient\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"},{\"components\":[{\"internalType\":\"address\",\"name\":\"updatedRecipient\",\"type\":\"address\"},{\"internalType\":\"bytes\",\"name\":\"updatedMessage\",\"type\":\"bytes\"},{\"internalType\":\"uint256\",\"name\":\"updatedOutputAmount\",\"type\":\"uint256\"},{\"internalType\":\"enum V3SpokePoolInterface.FillType\",\"name\":\"fillType\",\"type\":\"uint8\"}],\"indexed\":false,\"internalType\":\"struct V3SpokePoolInterface.LegacyV3RelayExecutionEventInfo\",\"name\":\"relayExecutionInfo\",\"type\":\"tuple\"}],\"name\":\"FilledV3Relay\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"bytes32\",\"name\":\"inputToken\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"bytes32\",\"name\":\"outputToken\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"inputAmount\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"outputAmount\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"uint256\",\"name\":\"destinationChainId\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"uint256\",\"name\":\"depositId\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"uint32\",\"name\":\"quoteTimestamp\",\"type\":\"uint32\"},{\"indexed\":false,\"internalType\":\"uint32\",\"name\":\"fillDeadline\",\"type\":\"uint32\"},{\"indexed\":false,\"internalType\":\"uint32\",\"name\":\"exclusivityDeadline\",\"type\":\"uint32\"},{\"indexed\":true,\"internalType\":\"bytes32\",\"name\":\"depositor\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"bytes32\",\"name\":\"recipient\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"bytes32\",\"name\":\"exclusiveRelayer\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"}],\"name\":\"FundsDeposited\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"uint8\",\"name\":\"version\",\"type\":\"uint8\"}],\"name\":\"Initialized\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"bool\",\"name\":\"isPaused\",\"type\":\"bool\"}],\"name\":\"PausedDeposits\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"bool\",\"name\":\"isPaused\",\"type\":\"bool\"}],\"name\":\"PausedFills\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"uint32\",\"name\":\"rootBundleId\",\"type\":\"uint32\"},{\"indexed\":true,\"internalType\":\"bytes32\",\"name\":\"relayerRefundRoot\",\"type\":\"bytes32\"},{\"indexed\":true,\"internalType\":\"bytes32\",\"name\":\"slowRelayRoot\",\"type\":\"bytes32\"}],\"name\":\"RelayedRootBundle\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"bytes32\",\"name\":\"inputToken\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"bytes32\",\"name\":\"outputToken\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"inputAmount\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"outputAmount\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"uint256\",\"name\":\"originChainId\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"uint256\",\"name\":\"depositId\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"uint32\",\"name\":\"fillDeadline\",\"type\":\"uint32\"},{\"indexed\":false,\"internalType\":\"uint32\",\"name\":\"exclusivityDeadline\",\"type\":\"uint32\"},{\"indexed\":false,\"internalType\":\"bytes32\",\"name\":\"exclusiveRelayer\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"bytes32\",\"name\":\"depositor\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"bytes32\",\"name\":\"recipient\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"bytes32\",\"name\":\"messageHash\",\"type\":\"bytes32\"}],\"name\":\"RequestedSlowFill\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"updatedOutputAmount\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"uint256\",\"name\":\"depositId\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"bytes32\",\"name\":\"depositor\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"bytes32\",\"name\":\"updatedRecipient\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"bytes\",\"name\":\"updatedMessage\",\"type\":\"bytes\"},{\"indexed\":false,\"internalType\":\"bytes\",\"name\":\"depositorSignature\",\"type\":\"bytes\"}],\"name\":\"RequestedSpeedUpDeposit\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"updatedOutputAmount\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"uint32\",\"name\":\"depositId\",\"type\":\"uint32\"},{\"indexed\":true,\"internalType\":\"address\",\"name\":\"depositor\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"updatedRecipient\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"bytes\",\"name\":\"updatedMessage\",\"type\":\"bytes\"},{\"indexed\":false,\"internalType\":\"bytes\",\"name\":\"depositorSignature\",\"type\":\"bytes\"}],\"name\":\"RequestedSpeedUpV3Deposit\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address\",\"name\":\"inputToken\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"outputToken\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"inputAmount\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"outputAmount\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"uint256\",\"name\":\"originChainId\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"uint32\",\"name\":\"depositId\",\"type\":\"uint32\"},{\"indexed\":false,\"internalType\":\"uint32\",\"name\":\"fillDeadline\",\"type\":\"uint32\"},{\"indexed\":false,\"internalType\":\"uint32\",\"name\":\"exclusivityDeadline\",\"type\":\"uint32\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"exclusiveRelayer\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"depositor\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"recipient\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"}],\"name\":\"RequestedV3SlowFill\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"uint32\",\"name\":\"newL1Gas\",\"type\":\"uint32\"}],\"name\":\"SetL1Gas\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"l2Token\",\"type\":\"address\"},{\"indexed\":true,\"internalType\":\"address\",\"name\":\"tokenBridge\",\"type\":\"address\"}],\"name\":\"SetL2TokenBridge\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"l2Token\",\"type\":\"address\"},{\"indexed\":true,\"internalType\":\"address\",\"name\":\"l1Token\",\"type\":\"address\"}],\"name\":\"SetRemoteL1Token\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"newWithdrawalRecipient\",\"type\":\"address\"}],\"name\":\"SetWithdrawalRecipient\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"newAdmin\",\"type\":\"address\"}],\"name\":\"SetXDomainAdmin\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"amountToReturn\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"uint256\",\"name\":\"chainId\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"uint32\",\"name\":\"leafId\",\"type\":\"uint32\"},{\"indexed\":true,\"internalType\":\"bytes32\",\"name\":\"l2TokenAddress\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"caller\",\"type\":\"address\"}],\"name\":\"TokensBridged\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"implementation\",\"type\":\"address\"}],\"name\":\"Upgraded\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address\",\"name\":\"inputToken\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"outputToken\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"inputAmount\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"outputAmount\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"uint256\",\"name\":\"destinationChainId\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"uint32\",\"name\":\"depositId\",\"type\":\"uint32\"},{\"indexed\":false,\"internalType\":\"uint32\",\"name\":\"quoteTimestamp\",\"type\":\"uint32\"},{\"indexed\":false,\"internalType\":\"uint32\",\"name\":\"fillDeadline\",\"type\":\"uint32\"},{\"indexed\":false,\"internalType\":\"uint32\",\"name\":\"exclusivityDeadline\",\"type\":\"uint32\"},{\"indexed\":true,\"internalType\":\"address\",\"name\":\"depositor\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"recipient\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"exclusiveRelayer\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"}],\"name\":\"V3FundsDeposited\",\"type\":\"event\"},{\"inputs\":[],\"name\":\"EMPTY_RELAYER\",\"outputs\":[{\"internalType\":\"bytes32\",\"name\":\"\",\"type\":\"bytes32\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"EMPTY_REPAYMENT_CHAIN_ID\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"INFINITE_FILL_DEADLINE\",\"outputs\":[{\"internalType\":\"uint32\",\"name\":\"\",\"type\":\"uint32\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"MAX_EXCLUSIVITY_PERIOD_SECONDS\",\"outputs\":[{\"internalType\":\"uint32\",\"name\":\"\",\"type\":\"uint32\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"MAX_TRANSFER_SIZE\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"MESSENGER\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"UPDATE_ADDRESS_DEPOSIT_DETAILS_HASH\",\"outputs\":[{\"internalType\":\"bytes32\",\"name\":\"\",\"type\":\"bytes32\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"UPDATE_BYTES32_DEPOSIT_DETAILS_HASH\",\"outputs\":[{\"internalType\":\"bytes32\",\"name\":\"\",\"type\":\"bytes32\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint32\",\"name\":\"_initialDepositId\",\"type\":\"uint32\"},{\"internalType\":\"address\",\"name\":\"_crossDomainAdmin\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"_withdrawalRecipient\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"_l2Eth\",\"type\":\"address\"}],\"name\":\"__OvmSpokePool_init\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint32\",\"name\":\"_initialDepositId\",\"type\":\"uint32\"},{\"internalType\":\"address\",\"name\":\"_crossDomainAdmin\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"_withdrawalRecipient\",\"type\":\"address\"}],\"name\":\"__SpokePool_init\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"cctpTokenMessenger\",\"outputs\":[{\"internalType\":\"contract ITokenMessenger\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"chainId\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"bytes32\",\"name\":\"l2TokenAddress\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"refundAddress\",\"type\":\"bytes32\"}],\"name\":\"claimRelayerRefund\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"crossDomainAdmin\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"bytes32\",\"name\":\"depositor\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"recipient\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"inputToken\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"outputToken\",\"type\":\"bytes32\"},{\"internalType\":\"uint256\",\"name\":\"inputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"outputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"destinationChainId\",\"type\":\"uint256\"},{\"internalType\":\"bytes32\",\"name\":\"exclusiveRelayer\",\"type\":\"bytes32\"},{\"internalType\":\"uint32\",\"name\":\"quoteTimestamp\",\"type\":\"uint32\"},{\"internalType\":\"uint32\",\"name\":\"fillDeadline\",\"type\":\"uint32\"},{\"internalType\":\"uint32\",\"name\":\"exclusivityParameter\",\"type\":\"uint32\"},{\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"}],\"name\":\"deposit\",\"outputs\":[],\"stateMutability\":\"payable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"recipient\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"originToken\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"amount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"destinationChainId\",\"type\":\"uint256\"},{\"internalType\":\"int64\",\"name\":\"relayerFeePct\",\"type\":\"int64\"},{\"internalType\":\"uint32\",\"name\":\"quoteTimestamp\",\"type\":\"uint32\"},{\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"},{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"name\":\"depositDeprecated_5947912356\",\"outputs\":[],\"stateMutability\":\"payable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"depositor\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"recipient\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"originToken\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"amount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"destinationChainId\",\"type\":\"uint256\"},{\"internalType\":\"int64\",\"name\":\"relayerFeePct\",\"type\":\"int64\"},{\"internalType\":\"uint32\",\"name\":\"quoteTimestamp\",\"type\":\"uint32\"},{\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"},{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"name\":\"depositFor\",\"outputs\":[],\"stateMutability\":\"payable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"bytes32\",\"name\":\"depositor\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"recipient\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"inputToken\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"outputToken\",\"type\":\"bytes32\"},{\"internalType\":\"uint256\",\"name\":\"inputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"outputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"destinationChainId\",\"type\":\"uint256\"},{\"internalType\":\"bytes32\",\"name\":\"exclusiveRelayer\",\"type\":\"bytes32\"},{\"internalType\":\"uint32\",\"name\":\"fillDeadlineOffset\",\"type\":\"uint32\"},{\"internalType\":\"uint32\",\"name\":\"exclusivityParameter\",\"type\":\"uint32\"},{\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"}],\"name\":\"depositNow\",\"outputs\":[],\"stateMutability\":\"payable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"depositQuoteTimeBuffer\",\"outputs\":[{\"internalType\":\"uint32\",\"name\":\"\",\"type\":\"uint32\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"depositor\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"recipient\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"inputToken\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"outputToken\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"inputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"outputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"destinationChainId\",\"type\":\"uint256\"},{\"internalType\":\"address\",\"name\":\"exclusiveRelayer\",\"type\":\"address\"},{\"internalType\":\"uint32\",\"name\":\"quoteTimestamp\",\"type\":\"uint32\"},{\"internalType\":\"uint32\",\"name\":\"fillDeadline\",\"type\":\"uint32\"},{\"internalType\":\"uint32\",\"name\":\"exclusivityParameter\",\"type\":\"uint32\"},{\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"}],\"name\":\"depositV3\",\"outputs\":[],\"stateMutability\":\"payable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"depositor\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"recipient\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"inputToken\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"outputToken\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"inputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"outputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"destinationChainId\",\"type\":\"uint256\"},{\"internalType\":\"address\",\"name\":\"exclusiveRelayer\",\"type\":\"address\"},{\"internalType\":\"uint32\",\"name\":\"fillDeadlineOffset\",\"type\":\"uint32\"},{\"internalType\":\"uint32\",\"name\":\"exclusivityParameter\",\"type\":\"uint32\"},{\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"}],\"name\":\"depositV3Now\",\"outputs\":[],\"stateMutability\":\"payable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint256\",\"name\":\"rootBundleId\",\"type\":\"uint256\"}],\"name\":\"emergencyDeleteRootBundle\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"name\":\"enabledDepositRoutes\",\"outputs\":[{\"internalType\":\"bool\",\"name\":\"\",\"type\":\"bool\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint32\",\"name\":\"rootBundleId\",\"type\":\"uint32\"},{\"components\":[{\"internalType\":\"uint256\",\"name\":\"amountToReturn\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"chainId\",\"type\":\"uint256\"},{\"internalType\":\"uint256[]\",\"name\":\"refundAmounts\",\"type\":\"uint256[]\"},{\"internalType\":\"uint32\",\"name\":\"leafId\",\"type\":\"uint32\"},{\"internalType\":\"address\",\"name\":\"l2TokenAddress\",\"type\":\"address\"},{\"internalType\":\"address[]\",\"name\":\"refundAddresses\",\"type\":\"address[]\"}],\"internalType\":\"struct SpokePoolInterface.RelayerRefundLeaf\",\"name\":\"relayerRefundLeaf\",\"type\":\"tuple\"},{\"internalType\":\"bytes32[]\",\"name\":\"proof\",\"type\":\"bytes32[]\"}],\"name\":\"executeRelayerRefundLeaf\",\"outputs\":[],\"stateMutability\":\"payable\",\"type\":\"function\"},{\"inputs\":[{\"components\":[{\"components\":[{\"internalType\":\"bytes32\",\"name\":\"depositor\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"recipient\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"exclusiveRelayer\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"inputToken\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"outputToken\",\"type\":\"bytes32\"},{\"internalType\":\"uint256\",\"name\":\"inputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"outputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"originChainId\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"depositId\",\"type\":\"uint256\"},{\"internalType\":\"uint32\",\"name\":\"fillDeadline\",\"type\":\"uint32\"},{\"internalType\":\"uint32\",\"name\":\"exclusivityDeadline\",\"type\":\"uint32\"},{\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"}],\"internalType\":\"struct V3SpokePoolInterface.V3RelayData\",\"name\":\"relayData\",\"type\":\"tuple\"},{\"internalType\":\"uint256\",\"name\":\"chainId\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"updatedOutputAmount\",\"type\":\"uint256\"}],\"internalType\":\"struct V3SpokePoolInterface.V3SlowFill\",\"name\":\"slowFillLeaf\",\"type\":\"tuple\"},{\"internalType\":\"uint32\",\"name\":\"rootBundleId\",\"type\":\"uint32\"},{\"internalType\":\"bytes32[]\",\"name\":\"proof\",\"type\":\"bytes32[]\"}],\"name\":\"executeSlowRelayLeaf\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"bytes32\",\"name\":\"orderId\",\"type\":\"bytes32\"},{\"internalType\":\"bytes\",\"name\":\"originData\",\"type\":\"bytes\"},{\"internalType\":\"bytes\",\"name\":\"fillerData\",\"type\":\"bytes\"}],\"name\":\"fill\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"fillDeadlineBuffer\",\"outputs\":[{\"internalType\":\"uint32\",\"name\":\"\",\"type\":\"uint32\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"components\":[{\"internalType\":\"bytes32\",\"name\":\"depositor\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"recipient\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"exclusiveRelayer\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"inputToken\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"outputToken\",\"type\":\"bytes32\"},{\"internalType\":\"uint256\",\"name\":\"inputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"outputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"originChainId\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"depositId\",\"type\":\"uint256\"},{\"internalType\":\"uint32\",\"name\":\"fillDeadline\",\"type\":\"uint32\"},{\"internalType\":\"uint32\",\"name\":\"exclusivityDeadline\",\"type\":\"uint32\"},{\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"}],\"internalType\":\"struct V3SpokePoolInterface.V3RelayData\",\"name\":\"relayData\",\"type\":\"tuple\"},{\"internalType\":\"uint256\",\"name\":\"repaymentChainId\",\"type\":\"uint256\"},{\"internalType\":\"bytes32\",\"name\":\"repaymentAddress\",\"type\":\"bytes32\"}],\"name\":\"fillRelay\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"components\":[{\"internalType\":\"bytes32\",\"name\":\"depositor\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"recipient\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"exclusiveRelayer\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"inputToken\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"outputToken\",\"type\":\"bytes32\"},{\"internalType\":\"uint256\",\"name\":\"inputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"outputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"originChainId\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"depositId\",\"type\":\"uint256\"},{\"internalType\":\"uint32\",\"name\":\"fillDeadline\",\"type\":\"uint32\"},{\"internalType\":\"uint32\",\"name\":\"exclusivityDeadline\",\"type\":\"uint32\"},{\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"}],\"internalType\":\"struct V3SpokePoolInterface.V3RelayData\",\"name\":\"relayData\",\"type\":\"tuple\"},{\"internalType\":\"uint256\",\"name\":\"repaymentChainId\",\"type\":\"uint256\"},{\"internalType\":\"bytes32\",\"name\":\"repaymentAddress\",\"type\":\"bytes32\"},{\"internalType\":\"uint256\",\"name\":\"updatedOutputAmount\",\"type\":\"uint256\"},{\"internalType\":\"bytes32\",\"name\":\"updatedRecipient\",\"type\":\"bytes32\"},{\"internalType\":\"bytes\",\"name\":\"updatedMessage\",\"type\":\"bytes\"},{\"internalType\":\"bytes\",\"name\":\"depositorSignature\",\"type\":\"bytes\"}],\"name\":\"fillRelayWithUpdatedDeposit\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"bytes32\",\"name\":\"\",\"type\":\"bytes32\"}],\"name\":\"fillStatuses\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"components\":[{\"internalType\":\"address\",\"name\":\"depositor\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"recipient\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"exclusiveRelayer\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"inputToken\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"outputToken\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"inputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"outputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"originChainId\",\"type\":\"uint256\"},{\"internalType\":\"uint32\",\"name\":\"depositId\",\"type\":\"uint32\"},{\"internalType\":\"uint32\",\"name\":\"fillDeadline\",\"type\":\"uint32\"},{\"internalType\":\"uint32\",\"name\":\"exclusivityDeadline\",\"type\":\"uint32\"},{\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"}],\"internalType\":\"struct V3SpokePoolInterface.V3RelayDataLegacy\",\"name\":\"relayData\",\"type\":\"tuple\"},{\"internalType\":\"uint256\",\"name\":\"repaymentChainId\",\"type\":\"uint256\"}],\"name\":\"fillV3Relay\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"getCurrentTime\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"l2TokenAddress\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"refundAddress\",\"type\":\"address\"}],\"name\":\"getRelayerRefund\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"msgSender\",\"type\":\"address\"},{\"internalType\":\"bytes32\",\"name\":\"depositor\",\"type\":\"bytes32\"},{\"internalType\":\"uint256\",\"name\":\"depositNonce\",\"type\":\"uint256\"}],\"name\":\"getUnsafeDepositId\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"pure\",\"type\":\"function\"},{\"inputs\":[{\"components\":[{\"internalType\":\"bytes32\",\"name\":\"depositor\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"recipient\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"exclusiveRelayer\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"inputToken\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"outputToken\",\"type\":\"bytes32\"},{\"internalType\":\"uint256\",\"name\":\"inputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"outputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"originChainId\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"depositId\",\"type\":\"uint256\"},{\"internalType\":\"uint32\",\"name\":\"fillDeadline\",\"type\":\"uint32\"},{\"internalType\":\"uint32\",\"name\":\"exclusivityDeadline\",\"type\":\"uint32\"},{\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"}],\"internalType\":\"struct V3SpokePoolInterface.V3RelayData\",\"name\":\"relayData\",\"type\":\"tuple\"}],\"name\":\"getV3RelayHash\",\"outputs\":[{\"internalType\":\"bytes32\",\"name\":\"\",\"type\":\"bytes32\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint32\",\"name\":\"_initialDepositId\",\"type\":\"uint32\"},{\"internalType\":\"address\",\"name\":\"_crossDomainAdmin\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"_withdrawalRecipient\",\"type\":\"address\"}],\"name\":\"initialize\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"l1Gas\",\"outputs\":[{\"internalType\":\"uint32\",\"name\":\"\",\"type\":\"uint32\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"l2Eth\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"bytes[]\",\"name\":\"data\",\"type\":\"bytes[]\"}],\"name\":\"multicall\",\"outputs\":[{\"internalType\":\"bytes[]\",\"name\":\"results\",\"type\":\"bytes[]\"}],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"numberOfDeposits\",\"outputs\":[{\"internalType\":\"uint32\",\"name\":\"\",\"type\":\"uint32\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"bool\",\"name\":\"pause\",\"type\":\"bool\"}],\"name\":\"pauseDeposits\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"bool\",\"name\":\"pause\",\"type\":\"bool\"}],\"name\":\"pauseFills\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"pausedDeposits\",\"outputs\":[{\"internalType\":\"bool\",\"name\":\"\",\"type\":\"bool\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"pausedFills\",\"outputs\":[{\"internalType\":\"bool\",\"name\":\"\",\"type\":\"bool\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"proxiableUUID\",\"outputs\":[{\"internalType\":\"bytes32\",\"name\":\"\",\"type\":\"bytes32\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"recipientCircleDomainId\",\"outputs\":[{\"internalType\":\"uint32\",\"name\":\"\",\"type\":\"uint32\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"bytes32\",\"name\":\"relayerRefundRoot\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"slowRelayRoot\",\"type\":\"bytes32\"}],\"name\":\"relayRootBundle\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"name\":\"relayerRefund\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"name\":\"remoteL1Tokens\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"components\":[{\"internalType\":\"bytes32\",\"name\":\"depositor\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"recipient\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"exclusiveRelayer\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"inputToken\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"outputToken\",\"type\":\"bytes32\"},{\"internalType\":\"uint256\",\"name\":\"inputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"outputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"originChainId\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"depositId\",\"type\":\"uint256\"},{\"internalType\":\"uint32\",\"name\":\"fillDeadline\",\"type\":\"uint32\"},{\"internalType\":\"uint32\",\"name\":\"exclusivityDeadline\",\"type\":\"uint32\"},{\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"}],\"internalType\":\"struct V3SpokePoolInterface.V3RelayData\",\"name\":\"relayData\",\"type\":\"tuple\"}],\"name\":\"requestSlowFill\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"name\":\"rootBundles\",\"outputs\":[{\"internalType\":\"bytes32\",\"name\":\"slowRelayRoot\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"relayerRefundRoot\",\"type\":\"bytes32\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"newCrossDomainAdmin\",\"type\":\"address\"}],\"name\":\"setCrossDomainAdmin\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"originToken\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"destinationChainId\",\"type\":\"uint256\"},{\"internalType\":\"bool\",\"name\":\"enabled\",\"type\":\"bool\"}],\"name\":\"setEnableRoute\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint32\",\"name\":\"newl1Gas\",\"type\":\"uint32\"}],\"name\":\"setL1GasLimit\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"l2Token\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"l1Token\",\"type\":\"address\"}],\"name\":\"setRemoteL1Token\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"l2Token\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"tokenBridge\",\"type\":\"address\"}],\"name\":\"setTokenBridge\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"newWithdrawalRecipient\",\"type\":\"address\"}],\"name\":\"setWithdrawalRecipient\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"bytes32\",\"name\":\"depositor\",\"type\":\"bytes32\"},{\"internalType\":\"uint256\",\"name\":\"depositId\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"updatedOutputAmount\",\"type\":\"uint256\"},{\"internalType\":\"bytes32\",\"name\":\"updatedRecipient\",\"type\":\"bytes32\"},{\"internalType\":\"bytes\",\"name\":\"updatedMessage\",\"type\":\"bytes\"},{\"internalType\":\"bytes\",\"name\":\"depositorSignature\",\"type\":\"bytes\"}],\"name\":\"speedUpDeposit\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"depositor\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"depositId\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"updatedOutputAmount\",\"type\":\"uint256\"},{\"internalType\":\"address\",\"name\":\"updatedRecipient\",\"type\":\"address\"},{\"internalType\":\"bytes\",\"name\":\"updatedMessage\",\"type\":\"bytes\"},{\"internalType\":\"bytes\",\"name\":\"depositorSignature\",\"type\":\"bytes\"}],\"name\":\"speedUpV3Deposit\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"name\":\"tokenBridges\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"bytes[]\",\"name\":\"data\",\"type\":\"bytes[]\"}],\"name\":\"tryMulticall\",\"outputs\":[{\"components\":[{\"internalType\":\"bool\",\"name\":\"success\",\"type\":\"bool\"},{\"internalType\":\"bytes\",\"name\":\"returnData\",\"type\":\"bytes\"}],\"internalType\":\"struct MultiCallerUpgradeable.Result[]\",\"name\":\"results\",\"type\":\"tuple[]\"}],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"bytes32\",\"name\":\"depositor\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"recipient\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"inputToken\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"outputToken\",\"type\":\"bytes32\"},{\"internalType\":\"uint256\",\"name\":\"inputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"outputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"destinationChainId\",\"type\":\"uint256\"},{\"internalType\":\"bytes32\",\"name\":\"exclusiveRelayer\",\"type\":\"bytes32\"},{\"internalType\":\"uint256\",\"name\":\"depositNonce\",\"type\":\"uint256\"},{\"internalType\":\"uint32\",\"name\":\"quoteTimestamp\",\"type\":\"uint32\"},{\"internalType\":\"uint32\",\"name\":\"fillDeadline\",\"type\":\"uint32\"},{\"internalType\":\"uint32\",\"name\":\"exclusivityParameter\",\"type\":\"uint32\"},{\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"}],\"name\":\"unsafeDeposit\",\"outputs\":[],\"stateMutability\":\"payable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"newImplementation\",\"type\":\"address\"}],\"name\":\"upgradeTo\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"newImplementation\",\"type\":\"address\"},{\"internalType\":\"bytes\",\"name\":\"data\",\"type\":\"bytes\"}],\"name\":\"upgradeToAndCall\",\"outputs\":[],\"stateMutability\":\"payable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"usdcToken\",\"outputs\":[{\"internalType\":\"contract IERC20\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"withdrawalRecipient\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"wrappedNativeToken\",\"outputs\":[{\"internalType\":\"contract WETH9Interface\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"stateMutability\":\"payable\",\"type\":\"receive\"}],\"devdoc\":{\"custom:security-contact\":\"bugs@across.to\",\"events\":{\"AdminChanged(address,address)\":{\"details\":\"Emitted when the admin account has changed.\"},\"BeaconUpgraded(address)\":{\"details\":\"Emitted when the beacon is changed.\"},\"Initialized(uint8)\":{\"details\":\"Triggered when the contract has been initialized or reinitialized.\"},\"Upgraded(address)\":{\"details\":\"Emitted when the implementation is upgraded.\"}},\"kind\":\"dev\",\"methods\":{\"__OvmSpokePool_init(uint32,address,address,address)\":{\"params\":{\"_crossDomainAdmin\":\"Cross domain admin to set. Can be changed by admin.\",\"_initialDepositId\":\"Starting deposit ID. Set to 0 unless this is a re-deployment in order to mitigate relay hash collisions.\",\"_l2Eth\":\"Address of L2 ETH token. Usually should be Lib_PreeployAddresses.OVM_ETH but sometimes this can be different, like with Boba which flips the WETH and OVM_ETH addresses.\",\"_withdrawalRecipient\":\"Address which receives token withdrawals. Can be changed by admin. For Spoke Pools on L2, this will likely be the hub pool.\"}},\"__SpokePool_init(uint32,address,address)\":{\"params\":{\"_crossDomainAdmin\":\"Cross domain admin to set. Can be changed by admin.\",\"_initialDepositId\":\"Starting deposit ID. Set to 0 unless this is a re-deployment in order to mitigate relay hash collisions.\",\"_withdrawalRecipient\":\"Address which receives token withdrawals. Can be changed by admin. For Spoke Pools on L2, this will likely be the hub pool.\"}},\"chainId()\":{\"details\":\"Some L2s like ZKSync don't support the CHAIN_ID opcode so we allow the implementer to override this.\"},\"claimRelayerRefund(bytes32,bytes32)\":{\"params\":{\"l2TokenAddress\":\"Address of the L2 token to claim refunds for.\",\"refundAddress\":\"Address to send the refund to.\"}},\"constructor\":{\"custom:oz-upgrades-unsafe-allow\":\"constructor\"},\"deposit(bytes32,bytes32,bytes32,bytes32,uint256,uint256,uint256,bytes32,uint32,uint32,uint32,bytes)\":{\"details\":\"On the destination chain, the hash of the deposit data will be used to uniquely identify this deposit, so modifying any params in it will result in a different hash and a different deposit. The hash will comprise all parameters to this function along with this chain's chainId(). Relayers are only refunded for filling deposits with deposit hashes that map exactly to the one emitted by this contract.\",\"params\":{\"depositor\":\"The account credited with the deposit who can request to \\\"speed up\\\" this deposit by modifying the output amount, recipient, and message.\",\"destinationChainId\":\"The destination chain identifier. Must be enabled along with the input token as a valid deposit route from this spoke pool or this transaction will revert.\",\"exclusiveRelayer\":\"The relayer that will be exclusively allowed to fill this deposit before the exclusivity deadline timestamp. This must be a valid, non-zero address if the exclusivity deadline is greater than the current block.timestamp. If the exclusivity deadline is < currentTime, then this must be address(0), and vice versa if this is address(0).\",\"exclusivityParameter\":\"This value is used to set the exclusivity deadline timestamp in the emitted deposit event. Before this destination chain timestamp, only the exclusiveRelayer (if set to a non-zero address), can fill this deposit. There are three ways to use this parameter: 1. NO EXCLUSIVITY: If this value is set to 0, then a timestamp of 0 will be emitted, meaning that there is no exclusivity period. 2. OFFSET: If this value is less than MAX_EXCLUSIVITY_PERIOD_SECONDS, then add this value to the block.timestamp to derive the exclusive relayer deadline. Note that using the parameter in this way will expose the filler of the deposit to the risk that the block.timestamp of this event gets changed due to a chain-reorg, which would also change the exclusivity timestamp. 3. TIMESTAMP: Otherwise, set this value as the exclusivity deadline timestamp. which is the deadline for the exclusiveRelayer to fill the deposit.\",\"fillDeadline\":\"The deadline for the relayer to fill the deposit. After this destination chain timestamp, the fill will revert on the destination chain. Must be set before currentTime + fillDeadlineBuffer, where currentTime is block.timestamp on this chain or this transaction will revert.\",\"inputAmount\":\"The amount of input tokens to pull from the caller's account and lock into this contract. This amount will be sent to the relayer on their repayment chain of choice as a refund following an optimistic challenge window in the HubPool, less a system fee.\",\"inputToken\":\"The token pulled from the caller's account and locked into this contract to initiate the deposit. The equivalent of this token on the relayer's repayment chain of choice will be sent as a refund. If this is equal to the wrapped native token then the caller can optionally pass in native token as msg.value, as long as msg.value = inputTokenAmount.\",\"message\":\"The message to send to the recipient on the destination chain if the recipient is a contract. If the message is not empty, the recipient contract must implement handleV3AcrossMessage() or the fill will revert.\",\"outputAmount\":\"The amount of output tokens that the relayer will send to the recipient on the destination.\",\"outputToken\":\"The token that the relayer will send to the recipient on the destination chain. Must be an ERC20.\",\"quoteTimestamp\":\"The HubPool timestamp that is used to determine the system fee paid by the depositor. This must be set to some time between [currentTime - depositQuoteTimeBuffer, currentTime] where currentTime is block.timestamp on this chain or this transaction will revert.\",\"recipient\":\"The account receiving funds on the destination chain. Can be an EOA or a contract. If the output token is the wrapped native token for the chain, then the recipient will receive native token if an EOA or wrapped native token if a contract.\"}},\"depositDeprecated_5947912356(address,address,uint256,uint256,int64,uint32,bytes,uint256)\":{\"details\":\"DEPRECATION NOTICE: this function is deprecated and will be removed in the future. Please use deposit (under DEPOSITOR FUNCTIONS below) or depositV3 instead.Produces a FundsDeposited event with an infinite expiry, meaning that this deposit can never expire. Moreover, the event's outputToken is set to 0x0 meaning that this deposit can always be slow filled.\",\"params\":{\"amount\":\"Amount of tokens to deposit. Will be amount of tokens to receive less fees.\",\"destinationChainId\":\"Denotes network where user will receive funds from SpokePool by a relayer.\",\"message\":\"Arbitrary data that can be used to pass additional information to the recipient along with the tokens. Note: this is intended to be used to pass along instructions for how a contract should use or allocate the tokens.\",\"originToken\":\"Token to lock into this contract to initiate deposit.\",\"quoteTimestamp\":\"Timestamp used by relayers to compute this deposit's realizedLPFeePct which is paid to LP pool on HubPool.\",\"recipient\":\"Address to receive funds at on destination chain.\",\"relayerFeePct\":\"% of deposit amount taken out to incentivize a fast relayer.\"}},\"depositFor(address,address,address,uint256,uint256,int64,uint32,bytes,uint256)\":{\"details\":\"DEPRECATION NOTICE: this function is deprecated and will be removed in the future. Please use the other deposit or depositV3 instead.\",\"params\":{\"amount\":\"Amount of tokens to deposit. Will be amount of tokens to receive less fees.\",\"depositor\":\"Address who is credited for depositing funds on origin chain and can speed up the deposit.\",\"destinationChainId\":\"Denotes network where user will receive funds from SpokePool by a relayer.\",\"message\":\"Arbitrary data that can be used to pass additional information to the recipient along with the tokens. Note: this is intended to be used to pass along instructions for how a contract should use or allocate the tokens.\",\"originToken\":\"Token to lock into this contract to initiate deposit.\",\"quoteTimestamp\":\"Timestamp used by relayers to compute this deposit's realizedLPFeePct which is paid to LP pool on HubPool.\",\"recipient\":\"Address to receive funds at on destination chain.\",\"relayerFeePct\":\"% of deposit amount taken out to incentivize a fast relayer.\"}},\"depositNow(bytes32,bytes32,bytes32,bytes32,uint256,uint256,uint256,bytes32,uint32,uint32,bytes)\":{\"params\":{\"depositor\":\"The account credited with the deposit who can request to \\\"speed up\\\" this deposit by modifying the output amount, recipient, and message.\",\"destinationChainId\":\"The destination chain identifier. Must be enabled along with the input token as a valid deposit route from this spoke pool or this transaction will revert.\",\"exclusiveRelayer\":\"The relayer that will be exclusively allowed to fill this deposit before the exclusivity deadline timestamp.\",\"exclusivityParameter\":\"See identically named parameter in deposit() comments.\",\"fillDeadlineOffset\":\"Added to the current time to set the fill deadline, which is the deadline for the relayer to fill the deposit. After this destination chain timestamp, the fill will revert on the destination chain.\",\"inputAmount\":\"The amount of input tokens to pull from the caller's account and lock into this contract. This amount will be sent to the relayer on their repayment chain of choice as a refund following an optimistic challenge window in the HubPool, plus a system fee.\",\"inputToken\":\"The token pulled from the caller's account and locked into this contract to initiate the deposit. The equivalent of this token on the relayer's repayment chain of choice will be sent as a refund. If this is equal to the wrapped native token then the caller can optionally pass in native token as msg.value, as long as msg.value = inputTokenAmount.\",\"message\":\"The message to send to the recipient on the destination chain if the recipient is a contract. If the message is not empty, the recipient contract must implement handleV3AcrossMessage() or the fill will revert.\",\"outputAmount\":\"The amount of output tokens that the relayer will send to the recipient on the destination.\",\"outputToken\":\"The token that the relayer will send to the recipient on the destination chain. Must be an ERC20.\",\"recipient\":\"The account receiving funds on the destination chain. Can be an EOA or a contract. If the output token is the wrapped native token for the chain, then the recipient will receive native token if an EOA or wrapped native token if a contract.\"}},\"depositV3(address,address,address,address,uint256,uint256,uint256,address,uint32,uint32,uint32,bytes)\":{\"details\":\"This version mirrors the original `depositV3` function, but uses `address` types for `depositor`, `recipient`, `inputToken`, `outputToken`, and `exclusiveRelayer` for compatibility with contracts using the `address` type. The key functionality and logic remain identical, ensuring interoperability across both versions.\",\"params\":{\"depositor\":\"The account credited with the deposit who can request to \\\"speed up\\\" this deposit by modifying the output amount, recipient, and message.\",\"destinationChainId\":\"The destination chain identifier. Must be enabled along with the input token as a valid deposit route from this spoke pool or this transaction will revert.\",\"exclusiveRelayer\":\"The relayer exclusively allowed to fill this deposit before the exclusivity deadline.\",\"exclusivityParameter\":\"This value is used to set the exclusivity deadline timestamp in the emitted deposit event. Before this destination chain timestamp, only the exclusiveRelayer (if set to a non-zero address), can fill this deposit. There are three ways to use this parameter: 1. NO EXCLUSIVITY: If this value is set to 0, then a timestamp of 0 will be emitted, meaning that there is no exclusivity period. 2. OFFSET: If this value is less than MAX_EXCLUSIVITY_PERIOD_SECONDS, then add this value to the block.timestamp to derive the exclusive relayer deadline. Note that using the parameter in this way will expose the filler of the deposit to the risk that the block.timestamp of this event gets changed due to a chain-reorg, which would also change the exclusivity timestamp. 3. TIMESTAMP: Otherwise, set this value as the exclusivity deadline timestamp. which is the deadline for the exclusiveRelayer to fill the deposit.\",\"fillDeadline\":\"The deadline for the relayer to fill the deposit. After this destination chain timestamp, the fill will revert on the destination chain. Must be set before currentTime + fillDeadlineBuffer, where currentTime is block.timestamp on this chain.\",\"inputAmount\":\"The amount of input tokens pulled from the caller's account and locked into this contract. This amount will be sent to the relayer as a refund following an optimistic challenge window in the HubPool, less a system fee.\",\"inputToken\":\"The token pulled from the caller's account and locked into this contract to initiate the deposit. The equivalent of this token on the relayer's repayment chain of choice will be sent as a refund. If this is equal to the wrapped native token, the caller can optionally pass in native token as msg.value, provided msg.value = inputTokenAmount.\",\"message\":\"The message to send to the recipient on the destination chain if the recipient is a contract. If the message is not empty, the recipient contract must implement `handleV3AcrossMessage()` or the fill will revert.\",\"outputAmount\":\"The amount of output tokens that the relayer will send to the recipient on the destination.\",\"outputToken\":\"The token that the relayer will send to the recipient on the destination chain. Must be an ERC20.\",\"quoteTimestamp\":\"The HubPool timestamp that determines the system fee paid by the depositor. This must be set between [currentTime - depositQuoteTimeBuffer, currentTime] where currentTime is block.timestamp on this chain.\",\"recipient\":\"The account receiving funds on the destination chain. Can be an EOA or a contract. If the output token is the wrapped native token for the chain, then the recipient will receive native token if an EOA or wrapped native token if a contract.\"}},\"depositV3Now(address,address,address,address,uint256,uint256,uint256,address,uint32,uint32,bytes)\":{\"details\":\"This version is identical to the original `depositV3Now` but uses `address` types for `depositor`, `recipient`, `inputToken`, `outputToken`, and `exclusiveRelayer` to support compatibility with older systems. It maintains the same logic and purpose, ensuring interoperability with both versions.\",\"params\":{\"depositor\":\"The account credited with the deposit, who can request to \\\"speed up\\\" this deposit by modifying the output amount, recipient, and message.\",\"destinationChainId\":\"The destination chain identifier. Must be enabled with the input token as a valid deposit route from this spoke pool, or the transaction will revert.\",\"exclusiveRelayer\":\"The relayer exclusively allowed to fill the deposit before the exclusivity deadline.\",\"exclusivityParameter\":\"See identically named parameter in deposit() comments.\",\"fillDeadlineOffset\":\"Added to the current time to set the fill deadline. After this timestamp, fills on the destination chain will revert.\",\"inputAmount\":\"The amount of input tokens pulled from the caller's account and locked into this contract. This amount will be sent to the relayer as a refund following an optimistic challenge window in the HubPool, plus a system fee.\",\"inputToken\":\"The token pulled from the caller's account and locked into this contract to initiate the deposit. Equivalent tokens on the relayer's repayment chain will be sent as a refund. If this is the wrapped native token, msg.value must equal inputTokenAmount when passed.\",\"message\":\"The message to send to the recipient on the destination chain. If the recipient is a contract, it must implement `handleV3AcrossMessage()` if the message is not empty, or the fill will revert.\",\"outputAmount\":\"The amount of output tokens the relayer will send to the recipient on the destination.\",\"outputToken\":\"The token the relayer will send to the recipient on the destination chain. Must be an ERC20.\",\"recipient\":\"The account receiving funds on the destination chain. Can be an EOA or a contract. If the output token is the wrapped native token for the chain, then the recipient will receive the native token if an EOA or wrapped native token if a contract.\"}},\"emergencyDeleteRootBundle(uint256)\":{\"params\":{\"rootBundleId\":\"Index of the root bundle that needs to be deleted. Note: this is intentionally a uint256 to ensure that a small input range doesn't limit which indices this method is able to reach.\"}},\"executeRelayerRefundLeaf(uint32,(uint256,uint256,uint256[],uint32,address,address[]),bytes32[])\":{\"params\":{\"proof\":\"Inclusion proof for this leaf in relayer refund root in root bundle.\",\"relayerRefundLeaf\":\"Contains all data necessary to reconstruct leaf contained in root bundle and to refund relayer. This data structure is explained in detail in the SpokePoolInterface.\",\"rootBundleId\":\"Unique ID of root bundle containing relayer refund root that this leaf is contained in.\"}},\"executeSlowRelayLeaf(((bytes32,bytes32,bytes32,bytes32,bytes32,uint256,uint256,uint256,uint256,uint32,uint32,bytes),uint256,uint256),uint32,bytes32[])\":{\"details\":\"Executing a slow fill leaf is equivalent to filling the relayData so this function cannot be used to double fill a recipient. The relayData that is filled is included in the slowFillLeaf and is hashed like any other fill sent through a fill method.There is no relayer credited with filling this relay since funds are sent directly out of this contract.\",\"params\":{\"proof\":\"Inclusion proof for this leaf in slow relay root in root bundle.\",\"rootBundleId\":\"Unique ID of root bundle containing slow relay root that this leaf is contained in.\",\"slowFillLeaf\":\"Contains all data necessary to uniquely identify a relay for this chain. This struct is hashed and included in a merkle root that is relayed to all spoke pools. - relayData: struct containing all the data needed to identify the original deposit to be slow filled. - chainId: chain identifier where slow fill leaf should be executed. If this doesn't match this chain's chainId, then this function will revert. - updatedOutputAmount: Amount to be sent to recipient out of this contract's balance. Can be set differently from relayData.outputAmount to charge a different fee because this deposit was \\\"slow\\\" filled. Usually, this will be set higher to reimburse the recipient for waiting for the slow fill.\"}},\"fill(bytes32,bytes,bytes)\":{\"details\":\"ERC-7683 fill function.\",\"params\":{\"fillerData\":\"Data provided by the filler to inform the fill or express their preferences\",\"orderId\":\"Unique order identifier for this order\",\"originData\":\"Data emitted on the origin to parameterize the fill\"}},\"fillRelay((bytes32,bytes32,bytes32,bytes32,bytes32,uint256,uint256,uint256,uint256,uint32,uint32,bytes),uint256,bytes32)\":{\"details\":\"The fee paid to relayers and the system should be captured in the spread between output amount and input amount when adjusted to be denominated in the input token. A relayer on the destination chain will send outputAmount of outputTokens to the recipient and receive inputTokens on a repayment chain of their choice. Therefore, the fee should account for destination fee transaction costs, the relayer's opportunity cost of capital while they wait to be refunded following an optimistic challenge window in the HubPool, and a system fee charged to relayers.The hash of the relayData will be used to uniquely identify the deposit to fill, so modifying any params in it will result in a different hash and a different deposit. The hash will comprise all parameters passed to deposit() on the origin chain along with that chain's chainId(). This chain's chainId() must therefore match the destinationChainId passed into deposit. Relayers are only refunded for filling deposits with deposit hashes that map exactly to the one emitted by the origin SpokePool therefore the relayer should not modify any params in relayData.Cannot fill more than once. Partial fills are not supported.\",\"params\":{\"relayData\":\"struct containing all the data needed to identify the deposit to be filled. Should match all the same-named parameters emitted in the origin chain FundsDeposited event. - depositor: The account credited with the deposit who can request to \\\"speed up\\\" this deposit by modifying the output amount, recipient, and message. - recipient The account receiving funds on this chain. Can be an EOA or a contract. If the output token is the wrapped native token for the chain, then the recipient will receive native token if an EOA or wrapped native token if a contract. - inputToken: The token pulled from the caller's account to initiate the deposit. The equivalent of this token on the repayment chain will be sent as a refund to the caller. - outputToken The token that the caller will send to the recipient on the destination chain. Must be an ERC20. - inputAmount: This amount, less a system fee, will be sent to the caller on their repayment chain of choice as a refund following an optimistic challenge window in the HubPool. - outputAmount: The amount of output tokens that the caller will send to the recipient. - originChainId: The origin chain identifier. - exclusiveRelayer The relayer that will be exclusively allowed to fill this deposit before the exclusivity deadline timestamp. - fillDeadline The deadline for the caller to fill the deposit. After this timestamp, the fill will revert on the destination chain. - exclusivityDeadline: The deadline for the exclusive relayer to fill the deposit. After this timestamp, anyone can fill this deposit. Note that if this value was set in deposit by adding an offset to the deposit's block.timestamp, there is re-org risk for the caller of this method because the event's block.timestamp can change. Read the comments in `deposit` about the `exclusivityParameter` for more details. - message The message to send to the recipient if the recipient is a contract that implements a handleV3AcrossMessage() public function\",\"repaymentAddress\":\"Address the relayer wants to be receive their refund at.\",\"repaymentChainId\":\"Chain of SpokePool where relayer wants to be refunded after the challenge window has passed. Will receive inputAmount of the equivalent token to inputToken on the repayment chain.\"}},\"fillRelayWithUpdatedDeposit((bytes32,bytes32,bytes32,bytes32,bytes32,uint256,uint256,uint256,uint256,uint32,uint32,bytes),uint256,bytes32,uint256,bytes32,bytes,bytes)\":{\"details\":\"Subject to same exclusivity deadline rules as fillV3Relay().\",\"params\":{\"depositorSignature\":\"Signed EIP712 hashstruct containing the deposit ID. Should be signed by the depositor account.\",\"relayData\":\"struct containing all the data needed to identify the deposit to be filled. See fillV3Relay().\",\"repaymentAddress\":\"Address the relayer wants to be receive their refund at.\",\"repaymentChainId\":\"Chain of SpokePool where relayer wants to be refunded after the challenge window has passed. See fillV3Relay().\",\"updatedMessage\":\"New message to use for this deposit.\",\"updatedOutputAmount\":\"New output amount to use for this deposit.\",\"updatedRecipient\":\"New recipient to use for this deposit.\"}},\"getCurrentTime()\":{\"returns\":{\"_0\":\"uint for the current timestamp.\"}},\"getUnsafeDepositId(address,bytes32,uint256)\":{\"details\":\"msgSender and depositor are both used as inputs to allow passthrough depositors to create unique deposit hash spaces for unique depositors.\",\"params\":{\"depositNonce\":\"The nonce used as input to produce the deposit ID.\",\"depositor\":\"The depositor address used as input to produce the deposit ID.\",\"msgSender\":\"The caller of the transaction used as input to produce the deposit ID.\"},\"returns\":{\"_0\":\"The deposit ID for the unsafe deposit.\"}},\"initialize(uint32,address,address)\":{\"params\":{\"_crossDomainAdmin\":\"Cross domain admin to set. Can be changed by admin.\",\"_initialDepositId\":\"Starting deposit ID. Set to 0 unless this is a re-deployment in order to mitigate relay hash collisions.\",\"_withdrawalRecipient\":\"Address which receives token withdrawals. Can be changed by admin. For Spoke Pools on L2, this will\"}},\"pauseDeposits(bool)\":{\"details\":\"Affects `deposit()` but not `speedUpDeposit()`, so that existing deposits can be sped up and still relayed.\",\"params\":{\"pause\":\"true if the call is meant to pause the system, false if the call is meant to unpause it.\"}},\"pauseFills(bool)\":{\"details\":\"Affects fillRelayWithUpdatedDeposit() and fillRelay().\",\"params\":{\"pause\":\"true if the call is meant to pause the system, false if the call is meant to unpause it.\"}},\"proxiableUUID()\":{\"details\":\"Implementation of the ERC1822 {proxiableUUID} function. This returns the storage slot used by the implementation. It is used to validate the implementation's compatibility when performing an upgrade. IMPORTANT: A proxy pointing at a proxiable contract should not be considered proxiable itself, because this risks bricking a proxy that upgrades to it, by delegating to itself until out of gas. Thus it is critical that this function revert if invoked through a proxy. This is guaranteed by the `notDelegated` modifier.\"},\"relayRootBundle(bytes32,bytes32)\":{\"params\":{\"relayerRefundRoot\":\"Merkle root containing relayer refund leaves that can be individually executed via executeRelayerRefundLeaf().\",\"slowRelayRoot\":\"Merkle root containing slow relay fulfillment leaves that can be individually executed via executeSlowRelayLeaf().\"}},\"requestSlowFill((bytes32,bytes32,bytes32,bytes32,bytes32,uint256,uint256,uint256,uint256,uint32,uint32,bytes))\":{\"details\":\"Slow fills are not possible unless the input and output tokens are \\\"equivalent\\\", i.e. they route to the same L1 token via PoolRebalanceRoutes.Slow fills are created by inserting slow fill objects into a merkle tree that is included in the next HubPool \\\"root bundle\\\". Once the optimistic challenge window has passed, the HubPool will relay the slow root to this chain via relayRootBundle(). Once the slow root is relayed, the slow fill can be executed by anyone who calls executeSlowRelayLeaf().Cannot request a slow fill if the fill deadline has passed.Cannot request a slow fill if the relay has already been filled or a slow fill has already been requested.\",\"params\":{\"relayData\":\"struct containing all the data needed to identify the deposit that should be slow filled. If any of the params are missing or different from the origin chain deposit, then Across will not include a slow fill for the intended deposit.\"}},\"setCrossDomainAdmin(address)\":{\"params\":{\"newCrossDomainAdmin\":\"New cross domain admin.\"}},\"setEnableRoute(address,uint256,bool)\":{\"params\":{\"destinationChainId\":\"Chain ID for where depositor wants to receive funds.\",\"enabled\":\"True to enable deposits, False otherwise.\",\"originToken\":\"Token that depositor can deposit to this contract.\"}},\"setL1GasLimit(uint32)\":{\"params\":{\"newl1Gas\":\"New L1 gas limit to set.\"}},\"setTokenBridge(address,address)\":{\"details\":\"If this mapping isn't set for an L2 token, then the standard bridge will be used to bridge this token.\",\"params\":{\"tokenBridge\":\"Address of token bridge\"}},\"setWithdrawalRecipient(address)\":{\"params\":{\"newWithdrawalRecipient\":\"New withdrawal recipient address.\"}},\"speedUpDeposit(bytes32,uint256,uint256,bytes32,bytes,bytes)\":{\"details\":\"the depositor and depositId must match the params in a FundsDeposited event that the depositor wants to speed up. The relayer has the option but not the obligation to use this updated information when filling the deposit via fillRelayWithUpdatedDeposit().\",\"params\":{\"depositId\":\"Deposit ID to speed up.\",\"depositor\":\"Depositor that must sign the depositorSignature and was the original depositor.\",\"depositorSignature\":\"Signed EIP712 hashstruct containing the deposit ID. Should be signed by the depositor account. If depositor is a contract, then should implement EIP1271 to sign as a contract. See _verifyUpdateV3DepositMessage() for more details about how this signature should be constructed.\",\"updatedMessage\":\"New message to use for this deposit. Can be modified if the recipient is a contract that expects to receive a message from the relay and for some reason needs to be modified.\",\"updatedOutputAmount\":\"New output amount to use for this deposit. Should be lower than previous value otherwise relayer has no incentive to use this updated value.\",\"updatedRecipient\":\"New recipient to use for this deposit. Can be modified if the recipient is a contract that expects to receive a message from the relay and for some reason needs to be modified.\"}},\"speedUpV3Deposit(address,uint256,uint256,address,bytes,bytes)\":{\"details\":\"The `depositor` and `depositId` must match the parameters in a `FundsDeposited` event that the depositor wants to speed up. The relayer is not obligated but has the option to use this updated information when filling the deposit using `fillRelayWithUpdatedDeposit()`. This version uses `address` types for compatibility with systems relying on `address`-based implementations.\",\"params\":{\"depositId\":\"The deposit ID to speed up.\",\"depositor\":\"The depositor that must sign the `depositorSignature` and was the original depositor.\",\"depositorSignature\":\"The signed EIP712 hashstruct containing the deposit ID. Should be signed by the depositor account. If the depositor is a contract, it should implement EIP1271 to sign as a contract. See `_verifyUpdateV3DepositMessage()` for more details on how the signature should be constructed.\",\"updatedMessage\":\"The new message for this deposit. Can be modified if the recipient is a contract that expects to receive a message from the relay and needs to be updated.\",\"updatedOutputAmount\":\"The new output amount to use for this deposit. It should be lower than the previous value, otherwise the relayer has no incentive to use this updated value.\",\"updatedRecipient\":\"The new recipient for this deposit. Can be modified if the original recipient is a contract that expects to receive a message from the relay and needs to be changed.\"}},\"unsafeDeposit(bytes32,bytes32,bytes32,bytes32,uint256,uint256,uint256,bytes32,uint256,uint32,uint32,uint32,bytes)\":{\"details\":\"This is labeled \\\"unsafe\\\" because there is no guarantee that the depositId emitted in the resultant FundsDeposited event is unique which means that the corresponding fill might collide with an existing relay hash on the destination chain SpokePool, which would make this deposit unfillable. In this case, the depositor would subsequently receive a refund of `inputAmount` of `inputToken` on the origin chain after the fill deadline.On the destination chain, the hash of the deposit data will be used to uniquely identify this deposit, so modifying any params in it will result in a different hash and a different deposit. The hash will comprise all parameters to this function along with this chain's chainId(). Relayers are only refunded for filling deposits with deposit hashes that map exactly to the one emitted by this contract.\",\"params\":{\"depositNonce\":\"The nonce that uniquely identifies this deposit. This function will combine this parameter with the msg.sender address to create a unique uint256 depositNonce and ensure that the msg.sender cannot use this function to front-run another depositor's unsafe deposit. This function guarantees that the resultant deposit nonce will not collide with a safe uint256 deposit nonce whose 24 most significant bytes are always 0.\",\"depositor\":\"See identically named parameter in depositV3() comments.\",\"destinationChainId\":\"See identically named parameter in depositV3() comments.\",\"exclusiveRelayer\":\"See identically named parameter in depositV3() comments.\",\"exclusivityParameter\":\"See identically named parameter in depositV3() comments.\",\"fillDeadline\":\"See identically named parameter in depositV3() comments.\",\"inputAmount\":\"See identically named parameter in depositV3() comments.\",\"inputToken\":\"See identically named parameter in depositV3() comments.\",\"message\":\"See identically named parameter in depositV3() comments.\",\"outputAmount\":\"See identically named parameter in depositV3() comments.\",\"outputToken\":\"See identically named parameter in depositV3() comments.\",\"quoteTimestamp\":\"See identically named parameter in depositV3() comments.\",\"recipient\":\"See identically named parameter in depositV3() comments.\"}},\"upgradeTo(address)\":{\"custom:oz-upgrades-unsafe-allow-reachable\":\"delegatecall\",\"details\":\"Upgrade the implementation of the proxy to `newImplementation`. Calls {_authorizeUpgrade}. Emits an {Upgraded} event.\"},\"upgradeToAndCall(address,bytes)\":{\"custom:oz-upgrades-unsafe-allow-reachable\":\"delegatecall\",\"details\":\"Upgrade the implementation of the proxy to `newImplementation`, and subsequently execute the function call encoded in `data`. Calls {_authorizeUpgrade}. Emits an {Upgraded} event.\"}},\"version\":1},\"userdoc\":{\"kind\":\"user\",\"methods\":{\"__OvmSpokePool_init(uint32,address,address,address)\":{\"notice\":\"Construct the OVM SpokePool.\"},\"__SpokePool_init(uint32,address,address)\":{\"notice\":\"Construct the base SpokePool.\"},\"chainId()\":{\"notice\":\"Returns chain ID for this network.\"},\"claimRelayerRefund(bytes32,bytes32)\":{\"notice\":\"Enables a relayer to claim outstanding repayments. Should virtually never be used, unless for some reason relayer repayment transfer fails for reasons such as token transfer reverts due to blacklisting. In this case, the relayer can still call this method and claim the tokens to a new address.\"},\"deposit(bytes32,bytes32,bytes32,bytes32,uint256,uint256,uint256,bytes32,uint32,uint32,uint32,bytes)\":{\"notice\":\"Previously, this function allowed the caller to specify the exclusivityDeadline, otherwise known as the as exact timestamp on the destination chain before which only the exclusiveRelayer could fill the deposit. Now, the caller is expected to pass in a number that will be interpreted either as an offset or a fixed timestamp depending on its value.Request to bridge input token cross chain to a destination chain and receive a specified amount of output tokens. The fee paid to relayers and the system should be captured in the spread between output amount and input amount when adjusted to be denominated in the input token. A relayer on the destination chain will send outputAmount of outputTokens to the recipient and receive inputTokens on a repayment chain of their choice. Therefore, the fee should account for destination fee transaction costs, the relayer's opportunity cost of capital while they wait to be refunded following an optimistic challenge window in the HubPool, and the system fee that they'll be charged.\"},\"depositDeprecated_5947912356(address,address,uint256,uint256,int64,uint32,bytes,uint256)\":{\"notice\":\"Called by user to bridge funds from origin to destination chain. Depositor will effectively lock tokens in this contract and receive a destination token on the destination chain. The origin => destination token mapping is stored on the L1 HubPool.The caller must first approve this contract to spend amount of originToken.The originToken => destinationChainId must be enabled.This method is payable because the caller is able to deposit native token if the originToken is wrappedNativeToken and this function will handle wrapping the native token to wrappedNativeToken.\"},\"depositFor(address,address,address,uint256,uint256,int64,uint32,bytes,uint256)\":{\"notice\":\"The only difference between depositFor and deposit is that the depositor address stored in the relay hash can be overridden by the caller. This means that the passed in depositor can speed up the deposit, which is useful if the deposit is taken from the end user to a middle layer contract, like an aggregator or the SpokePoolVerifier, before calling deposit on this contract.The caller must first approve this contract to spend amount of originToken.The originToken => destinationChainId must be enabled.This method is payable because the caller is able to deposit native token if the originToken is wrappedNativeToken and this function will handle wrapping the native token to wrappedNativeToken.\"},\"depositNow(bytes32,bytes32,bytes32,bytes32,uint256,uint256,uint256,bytes32,uint32,uint32,bytes)\":{\"notice\":\"Submits deposit and sets quoteTimestamp to current Time. Sets fill and exclusivity deadlines as offsets added to the current time. This function is designed to be called by users such as Multisig contracts who do not have certainty when their transaction will mine.\"},\"depositV3(address,address,address,address,uint256,uint256,uint256,address,uint32,uint32,uint32,bytes)\":{\"notice\":\"A version of `deposit` that accepts `address` types for backward compatibility. This function allows bridging of input tokens cross-chain to a destination chain, receiving a specified amount of output tokens. The relayer is refunded in input tokens on a repayment chain of their choice, minus system fees, after an optimistic challenge window. The exclusivity period is specified as an offset from the current block timestamp.\"},\"depositV3Now(address,address,address,address,uint256,uint256,uint256,address,uint32,uint32,bytes)\":{\"notice\":\"A version of `depositNow` that supports addresses as input types for backward compatibility. This function submits a deposit and sets `quoteTimestamp` to the current time. The `fill` and `exclusivity` deadlines are set as offsets added to the current time. It is designed to be called by users, including Multisig contracts, who may not have certainty when their transaction will be mined.\"},\"emergencyDeleteRootBundle(uint256)\":{\"notice\":\"This method is intended to only be used in emergencies where a bad root bundle has reached the SpokePool.\"},\"executeRelayerRefundLeaf(uint32,(uint256,uint256,uint256[],uint32,address,address[]),bytes32[])\":{\"notice\":\"Executes a relayer refund leaf stored as part of a root bundle. Will send the relayer the amount they sent to the recipient plus a relayer fee.\"},\"executeSlowRelayLeaf(((bytes32,bytes32,bytes32,bytes32,bytes32,uint256,uint256,uint256,uint256,uint32,uint32,bytes),uint256,uint256),uint32,bytes32[])\":{\"notice\":\"Executes a slow relay leaf stored as part of a root bundle relayed by the HubPool.\"},\"fill(bytes32,bytes,bytes)\":{\"notice\":\"Fills a single leg of a particular order on the destination chain\"},\"fillRelay((bytes32,bytes32,bytes32,bytes32,bytes32,uint256,uint256,uint256,uint256,uint32,uint32,bytes),uint256,bytes32)\":{\"notice\":\"Fulfill request to bridge cross chain by sending specified output tokens to the recipient.\"},\"fillRelayWithUpdatedDeposit((bytes32,bytes32,bytes32,bytes32,bytes32,uint256,uint256,uint256,uint256,uint32,uint32,bytes),uint256,bytes32,uint256,bytes32,bytes,bytes)\":{\"notice\":\"Identical to fillV3Relay except that the relayer wants to use a depositor's updated output amount, recipient, and/or message. The relayer should only use this function if they can supply a message signed by the depositor that contains the fill's matching deposit ID along with updated relay parameters. If the signature can be verified, then this function will emit a FilledV3Event that will be used by the system for refund verification purposes. In other words, this function is an alternative way to fill a a deposit than fillV3Relay.\"},\"getCurrentTime()\":{\"notice\":\"Gets the current time.\"},\"getUnsafeDepositId(address,bytes32,uint256)\":{\"notice\":\"Returns the deposit ID for an unsafe deposit. This function is used to compute the deposit ID in unsafeDeposit and is provided as a convenience.\"},\"initialize(uint32,address,address)\":{\"notice\":\"Construct the OVM World Chain SpokePool.\"},\"pauseDeposits(bool)\":{\"notice\":\"Pauses deposit-related functions. This is intended to be used if this contract is deprecated or when something goes awry.\"},\"pauseFills(bool)\":{\"notice\":\"Pauses fill-related functions. This is intended to be used if this contract is deprecated or when something goes awry.\"},\"relayRootBundle(bytes32,bytes32)\":{\"notice\":\"This method stores a new root bundle in this contract that can be executed to refund relayers, fulfill slow relays, and send funds back to the HubPool on L1. This method can only be called by the admin and is designed to be called as part of a cross-chain message from the HubPool's executeRootBundle method.\"},\"requestSlowFill((bytes32,bytes32,bytes32,bytes32,bytes32,uint256,uint256,uint256,uint256,uint32,uint32,bytes))\":{\"notice\":\"Request Across to send LP funds to this contract to fulfill a slow fill relay for a deposit in the next bundle.\"},\"setCrossDomainAdmin(address)\":{\"notice\":\"Change cross domain admin address. Callable by admin only.\"},\"setEnableRoute(address,uint256,bool)\":{\"notice\":\"Enable/Disable an origin token => destination chain ID route for deposits. Callable by admin only.\"},\"setL1GasLimit(uint32)\":{\"notice\":\"Change L1 gas limit. Callable only by admin.\"},\"setTokenBridge(address,address)\":{\"notice\":\"Set bridge contract for L2 token used to withdraw back to L1.\"},\"setWithdrawalRecipient(address)\":{\"notice\":\"Change L1 withdrawal recipient address. Callable by admin only.\"},\"speedUpDeposit(bytes32,uint256,uint256,bytes32,bytes,bytes)\":{\"notice\":\"Depositor can use this function to signal to relayer to use updated output amount, recipient, and/or message.\"},\"speedUpV3Deposit(address,uint256,uint256,address,bytes,bytes)\":{\"notice\":\"A version of `speedUpDeposit` using `address` types for backward compatibility. This function allows the depositor to signal to the relayer to use updated output amount, recipient, and/or message when filling a deposit. This can be useful when the deposit needs to be modified after the original transaction has been mined.\"},\"unsafeDeposit(bytes32,bytes32,bytes32,bytes32,uint256,uint256,uint256,bytes32,uint256,uint32,uint32,uint32,bytes)\":{\"notice\":\"See deposit for details. This function is identical to deposit except that it does not use the global deposit ID counter as a deposit nonce, instead allowing the caller to pass in a deposit nonce. This function is designed to be used by anyone who wants to pre-compute their resultant relay data hash, which could be useful for filling a deposit faster and avoiding any risk of a relay hash unexpectedly changing due to another deposit front-running this one and incrementing the global deposit ID counter.\"}},\"notice\":\"World Chain Spoke pool.\",\"version\":1}},\"settings\":{\"compilationTarget\":{\"contracts/WorldChain_SpokePool.sol\":\"WorldChain_SpokePool\"},\"debug\":{\"revertStrings\":\"strip\"},\"evmVersion\":\"shanghai\",\"libraries\":{},\"metadata\":{\"bytecodeHash\":\"ipfs\"},\"optimizer\":{\"enabled\":true,\"runs\":800},\"remappings\":[],\"viaIR\":true},\"sources\":{\"@eth-optimism/contracts/libraries/constants/Lib_PredeployAddresses.sol\":{\"keccak256\":\"0x2bc28307af93e9716151a41a81694b56cbe513ef5eb335fb1d81f35e5db8edfa\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://bbdde142b16f7e0301b7b6a331b35ce609eaf5c9127f14f60c0008abb36e100f\",\"dweb:/ipfs/QmdKUiY6U2vh5egW1bYtvrNhpEmo4Jo4DEwUUmBCfW4eLy\"]},\"@openzeppelin/contracts-upgradeable/crosschain/errorsUpgradeable.sol\":{\"keccak256\":\"0xa1e9b651a2427925598b49ef35da5930abc07859cfac5b9dfb1912f063a024b3\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://c514518c36a3fb1c5f1a99d88857e93160c72ea1fd728c443406ad1acb43ae9a\",\"dweb:/ipfs/Qmc3oXjBNhdeM5cfWpsvewXZAhH34Scgna2W3MvLaiiapQ\"]},\"@openzeppelin/contracts-upgradeable/crosschain/optimism/LibOptimismUpgradeable.sol\":{\"keccak256\":\"0x4e749e196701e221283db53ccaafd372434cdaed2a0b1f5a81b23e36b826b3e8\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://c12147f335d1f8cfee08c853de86d06f63534fe8395f4f0c3c202c045f2ef4d2\",\"dweb:/ipfs/QmNnJzZGLymFtaaKn9zQAtxeNAGmXCDPFyjxzthkUTrKre\"]},\"@openzeppelin/contracts-upgradeable/interfaces/IERC1967Upgradeable.sol\":{\"keccak256\":\"0x47d6e06872b12e72c79d1b5eb55842f860b5fb1207b2317c2358d2766b950a7b\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://ac55bf6f92fc7b90c6d79d346163a0a02bd5c648c7fede08b20e5da96d4ae2a0\",\"dweb:/ipfs/QmQoSrHhka35iKDK5iyNt8cuXXS5ANXVPjLhfsJjktB8V9\"]},\"@openzeppelin/contracts-upgradeable/interfaces/draft-IERC1822Upgradeable.sol\":{\"keccak256\":\"0x77c89f893e403efc6929ba842b7ccf6534d4ffe03afe31670b4a528c0ad78c0f\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://496bd9b3df2455d571018c09f0c6badd29713fdeb907c6aa09d8d28cb603f053\",\"dweb:/ipfs/QmXdJDyYs6WMwMh21dez2BYPxhSUaUYFMDtVNcn2cgFR79\"]},\"@openzeppelin/contracts-upgradeable/proxy/ERC1967/ERC1967UpgradeUpgradeable.sol\":{\"keccak256\":\"0x7795808e3899c805254e3ae58074b20f799b466e3f43e057e47bedee5fb771f8\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://319853a2a682f3f72411507242669ef5e76e0ad3457be53102439709ee8948f0\",\"dweb:/ipfs/QmRtm4Ese9u4jfxXyuWPXLwzenwFotuQjAWV7rXtZTB1E9\"]},\"@openzeppelin/contracts-upgradeable/proxy/beacon/IBeaconUpgradeable.sol\":{\"keccak256\":\"0x24b86ac8c005b8c654fbf6ac34a5a4f61580d7273541e83e013e89d66fbf0908\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://4dbfe1a3b3b3fb64294ce41fd2ad362e7b7012208117864f42c1a67620a6d5c1\",\"dweb:/ipfs/QmVMU5tWt7zBQMmf5cpMX8UMHV86T3kFeTxBTBjFqVWfoJ\"]},\"@openzeppelin/contracts-upgradeable/proxy/utils/Initializable.sol\":{\"keccak256\":\"0x89be10e757d242e9b18d5a32c9fbe2019f6d63052bbe46397a430a1d60d7f794\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://f103ee2e4aecd37aac6ceefe670709cdd7613dee25fa2d4d9feaf7fc0aaa155e\",\"dweb:/ipfs/QmRiNZLoJk5k3HPMYGPGjZFd2ke1ZxjhJZkM45Ec9GH9hv\"]},\"@openzeppelin/contracts-upgradeable/proxy/utils/UUPSUpgradeable.sol\":{\"keccak256\":\"0xefb41f5c1a00249b7a99f0782f8c557865605426a3fb6e5fe9ae334293ae4f33\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://90def55e5782595aabc13f57780c02d3613e5226f20ce6c1709503a63fdeb58f\",\"dweb:/ipfs/Qmb5vcymmNEZUJMaHmYxnhvGJDEsGMae4YjcHwkA74jy99\"]},\"@openzeppelin/contracts-upgradeable/security/ReentrancyGuardUpgradeable.sol\":{\"keccak256\":\"0x2025ccf05f6f1f2fd4e078e552836f525a1864e3854ed555047cd732320ab29b\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://d27f4b23c2dee42394aebaf42bf238285230f472dfd3282a39c3f000ec28214f\",\"dweb:/ipfs/QmQa3DnvccwdWJeWrjgXPnFMTWbzWQWR39hVqC7eEwo2PC\"]},\"@openzeppelin/contracts-upgradeable/token/ERC20/IERC20Upgradeable.sol\":{\"keccak256\":\"0x0e1f0f5f62f67a881cd1a9597acbc0a5e4071f3c2c10449a183b922ae7272e3f\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://c25f742ff154998d19a669e2508c3597b363e123ce9144cd0fcf6521229f401f\",\"dweb:/ipfs/QmQXRuFzStEWqeEPbhQU6cAg9PaSowxJVo4PDKyRod7dco\"]},\"@openzeppelin/contracts-upgradeable/token/ERC20/extensions/IERC20PermitUpgradeable.sol\":{\"keccak256\":\"0x07e881de3b9f6d2c07909f193f24b96c7fe4ea60013260f3f25aecd8bab3c2f8\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://1fed09b97ccb0ff9ba9b6a94224f1d489026bf6b4b7279bfe64fb6e8749dee4d\",\"dweb:/ipfs/QmcRAzaSP1UnGr4vrGkfJmB2L9aiTYoXfV1Lg9gqrVRWn8\"]},\"@openzeppelin/contracts-upgradeable/token/ERC20/utils/SafeERC20Upgradeable.sol\":{\"keccak256\":\"0x23b997be73d3dd46885262704f0f8cfc7273fdadfe303d37969a9561373972b5\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://d03ebe5406134f0c4a017dee625ff615031194493bd1e88504e5c8fae55bc166\",\"dweb:/ipfs/QmUZV5bMbgk2PAkV3coouSeSainHN2jhqaQDJaA7hQRyu2\"]},\"@openzeppelin/contracts-upgradeable/utils/AddressUpgradeable.sol\":{\"keccak256\":\"0x9c80f545915582e63fe206c6ce27cbe85a86fc10b9cd2a0e8c9488fb7c2ee422\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://310136ad60820af4177a11a61d77a3686faf5fca4942b600e08fc940db38396b\",\"dweb:/ipfs/QmbCzMNSTL7Zi7M4UCSqBrkHtp4jjxUnGbkneCZKdR1qeq\"]},\"@openzeppelin/contracts-upgradeable/utils/StorageSlotUpgradeable.sol\":{\"keccak256\":\"0x07ac95acad040f1fb1f6120dd0aa5f702db69446e95f82613721879d30de0908\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://a9df9de7b5da1d1bd3d4b6c073d0174bc4211db60e794a321c8cb5d4eae34685\",\"dweb:/ipfs/QmWe49zj65jayrCe9jZpoWhYUZ1RiwSxyU2s7SBZnMztVy\"]},\"@openzeppelin/contracts-upgradeable/utils/StringsUpgradeable.sol\":{\"keccak256\":\"0xb96dc79b65b7c37937919dcdb356a969ce0aa2e8338322bf4dc027a3c9c9a7eb\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://f8613145881436fc0480fff22da4868d611e2b0c0c3da083334eb4362ce1945a\",\"dweb:/ipfs/QmPqpP3YeRbBdTJRe6Gv2eGsUaANf4J6RwTNRW36iYahfV\"]},\"@openzeppelin/contracts-upgradeable/utils/cryptography/ECDSAUpgradeable.sol\":{\"keccak256\":\"0xa014f65d84b02827055d99993ccdbfb4b56b2c9e91eb278d82a93330659d06e4\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://50a7e716a74f3d48a7f549086faa94afcd58b9f18ac8e9f74af4571f3a1d8d5c\",\"dweb:/ipfs/QmTkDNWkq5o9Cv2jS7s6JvSmsPBkeunZhPe7Z2njGL31wo\"]},\"@openzeppelin/contracts-upgradeable/utils/math/MathUpgradeable.sol\":{\"keccak256\":\"0x2bc0007987c229ae7624eb29be6a9b84f6a6a5872f76248b15208b131ea41c4e\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://2b2835c737d073ef8b82a4cc246495a9740f43e7ff2cf130906b2449ff9bfb91\",\"dweb:/ipfs/QmSCWfNoSvvTN57ic7o1RW6NqSxxGAqbBTnLKc7QHe27qB\"]},\"@openzeppelin/contracts-upgradeable/utils/math/SignedMathUpgradeable.sol\":{\"keccak256\":\"0x88f6b7bba3ee33eeb741f9a0f5bc98b6e6e352d0fe4905377bb328590f84095a\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://88ace2d60f265752f18903d839910be4e4e104340b2957678585b812447825d4\",\"dweb:/ipfs/QmXFkNxMc3AAGzhs2wUEZyErWQjsvoTGyYjuU5oZkFki5Z\"]},\"@openzeppelin/contracts-upgradeable/vendor/optimism/ICrossDomainMessengerUpgradeable.sol\":{\"keccak256\":\"0xb531a6941d55a97d0db7af85c19b6aaf7fc634e550b513daa28e874b2c9b2dfa\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://23b0ce75313d9863512271a51940f6876051a5cb6dce60dd06bc03e565631b9d\",\"dweb:/ipfs/QmZobv3VixcvPxVF6hZgWxo8ELd9nXK935aiBpyHypYSoL\"]},\"@openzeppelin/contracts/interfaces/IERC1271.sol\":{\"keccak256\":\"0x0705a4b1b86d7b0bd8432118f226ba139c44b9dcaba0a6eafba2dd7d0639c544\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://c45b821ef9e882e57c256697a152e108f0f2ad6997609af8904cae99c9bd422e\",\"dweb:/ipfs/QmRKCJW6jjzR5UYZcLpGnhEJ75UVbH6EHkEa49sWx2SKng\"]},\"@openzeppelin/contracts/token/ERC20/IERC20.sol\":{\"keccak256\":\"0x287b55befed2961a7eabd7d7b1b2839cbca8a5b80ef8dcbb25ed3d4c2002c305\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://bd39944e8fc06be6dbe2dd1d8449b5336e23c6a7ba3e8e9ae5ae0f37f35283f5\",\"dweb:/ipfs/QmPV3FGYjVwvKSgAXKUN3r9T9GwniZz83CxBpM7vyj2G53\"]},\"@openzeppelin/contracts/token/ERC20/extensions/IERC20Permit.sol\":{\"keccak256\":\"0xb264c03a3442eb37a68ad620cefd1182766b58bee6cec40343480392d6b14d69\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://28879d01fd22c07b44f006612775f8577defbe459cb01685c5e25cd518c91a71\",\"dweb:/ipfs/QmVgfkwv2Fxw6hhTcDUZhE7NkoSKjab3ipM7UaRbt6uXb5\"]},\"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\":{\"keccak256\":\"0xabefac93435967b4d36a4fabcbdbb918d1f0b7ae3c3d85bc30923b326c927ed1\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://9d213d3befca47da33f6db0310826bcdb148299805c10d77175ecfe1d06a9a68\",\"dweb:/ipfs/QmRgCn6SP1hbBkExUADFuDo8xkT4UU47yjNF5FhCeRbQmS\"]},\"@openzeppelin/contracts/utils/Address.sol\":{\"keccak256\":\"0x006dd67219697fe68d7fbfdea512e7c4cb64a43565ed86171d67e844982da6fa\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://2455248c8ddd9cc6a7af76a13973cddf222072427e7b0e2a7d1aff345145e931\",\"dweb:/ipfs/QmfYjnjRbWqYpuxurqveE6HtzsY1Xx323J428AKQgtBJZm\"]},\"@openzeppelin/contracts/utils/Strings.sol\":{\"keccak256\":\"0x3088eb2868e8d13d89d16670b5f8612c4ab9ff8956272837d8e90106c59c14a0\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://b81d9ff6559ea5c47fc573e17ece6d9ba5d6839e213e6ebc3b4c5c8fe4199d7f\",\"dweb:/ipfs/QmPCW1bFisUzJkyjroY3yipwfism9RRCigCcK1hbXtVM8n\"]},\"@openzeppelin/contracts/utils/cryptography/ECDSA.sol\":{\"keccak256\":\"0x809bc3edb4bcbef8263fa616c1b60ee0004b50a8a1bfa164d8f57fd31f520c58\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://8b93a1e39a4a19eba1600b92c96f435442db88cac91e315c8291547a2a7bcfe2\",\"dweb:/ipfs/QmTm34KVe6uZBZwq8dZDNWwPcm24qBJdxqL3rPxBJ4LrMv\"]},\"@openzeppelin/contracts/utils/cryptography/MerkleProof.sol\":{\"keccak256\":\"0xcf688741f79f4838d5301dcf72d0af9eff11bbab6ab0bb112ad144c7fb672dac\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://85d9c87a481fe99fd28a146c205da0867ef7e1b7edbe0036abc86d2e64eb1f04\",\"dweb:/ipfs/QmR7m1zWQNfZHUKTtqnjoCjCBbNFcjCxV27rxf6iMfhVtG\"]},\"@openzeppelin/contracts/utils/cryptography/SignatureChecker.sol\":{\"keccak256\":\"0x3af3ca86df39aac39a0514c84459d691434a108d2151c8ce9d69f32e315cab80\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://77d1f1cf302cd5e1dfbbb4ce3b281b28e8c52942d4319fce43df2e1b6f02a52d\",\"dweb:/ipfs/QmT6ZXStmK3Knhh9BokeVHQ9HXTBZNgL3Eb1ar1cYg1hWy\"]},\"@openzeppelin/contracts/utils/math/Math.sol\":{\"keccak256\":\"0xe4455ac1eb7fc497bb7402579e7b4d64d928b846fce7d2b6fde06d366f21c2b3\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://cc8841b3cd48ad125e2f46323c8bad3aa0e88e399ec62acb9e57efa7e7c8058c\",\"dweb:/ipfs/QmSqE4mXHA2BXW58deDbXE8MTcsL5JSKNDbm23sVQxRLPS\"]},\"@openzeppelin/contracts/utils/math/SignedMath.sol\":{\"keccak256\":\"0xf92515413956f529d95977adc9b0567d583c6203fc31ab1c23824c35187e3ddc\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://c50fcc459e49a9858b6d8ad5f911295cb7c9ab57567845a250bf0153f84a95c7\",\"dweb:/ipfs/QmcEW85JRzvDkQggxiBBLVAasXWdkhEysqypj9EaB6H2g6\"]},\"contracts/MerkleLib.sol\":{\"keccak256\":\"0xdaf19fdc82593b79a608af8f691aec89a3c0e47b210770deabbe66ece7c35bb1\",\"license\":\"BUSL-1.1\",\"urls\":[\"bzz-raw://03c37f78657beed37257187e237d74492de0199734aa03272a419f66161c0dca\",\"dweb:/ipfs/QmdcXMAoRLZejhh2xcVMWR3WfUvXcArKrCFEE82JDYiJbh\"]},\"contracts/Ovm_SpokePool.sol\":{\"keccak256\":\"0xc46d3c3c1b493137eca6fbe8cd9eae2381cb792945e7ede376cbe15ef95b5454\",\"license\":\"BUSL-1.1\",\"urls\":[\"bzz-raw://7e76ca618799ea810d1fce4449d55ec3bbfbe7482374cf4259755e0103a91c19\",\"dweb:/ipfs/QmVoiCjM4yKCLxe2TNL9i9QViYFCd4f2v9wB37ogtwb6Md\"]},\"contracts/SpokePool.sol\":{\"keccak256\":\"0x62c641e112f07f831e4141dcb6b2f5dade3e60b2c85ebb72d553e036742126fd\",\"license\":\"BUSL-1.1\",\"urls\":[\"bzz-raw://b2b4069889cdac14059dc0452dd352e8d899e85ac6a37886500fcb0608351739\",\"dweb:/ipfs/QmaLeMZevVxtrzxFd4ZER8Ukjk3HRTQ7da7QzzokKB6VMz\"]},\"contracts/WorldChain_SpokePool.sol\":{\"keccak256\":\"0xca2c33ecde7c11a115fac777e053aa03a096d39595778ee59dcc99248ead365f\",\"license\":\"BUSL-1.1\",\"urls\":[\"bzz-raw://c4f6577186f64b911880558c487434fd2f7347aa766be4f5f9cb807d874ab5c2\",\"dweb:/ipfs/QmcAAkTdakUqdz4TUEXYK28moXK8tQQ4ryZmQWb81AUU1t\"]},\"contracts/erc7683/ERC7683.sol\":{\"keccak256\":\"0x726d0426b0f3a11ff59d3a5bbe433c182c0feac9ea2c8c75377fcc2693eccded\",\"license\":\"GPL-3.0-or-later\",\"urls\":[\"bzz-raw://99336cc59dd5923815a8fad6e200b7b265e8446414b099e9b17e3f15f094b774\",\"dweb:/ipfs/QmWCrqefGqEpKsvfn1oBzTTUAFBjscjHc6g1EX2ab51bGA\"]},\"contracts/erc7683/ERC7683Permit2Lib.sol\":{\"keccak256\":\"0x12d0e6dd7e394b75067157ccbe3e8756db138b8f48b3c69494da2e2f294d582f\",\"license\":\"UNLICENSED\",\"urls\":[\"bzz-raw://f4185b2e3396fdb6ce934e462fcdca2c1be29caaa7949ab22072f2105354220e\",\"dweb:/ipfs/QmbPwAQK6K32ENZeytLkPi41TWiWXzFzpJ7Ah67hU8kvjw\"]},\"contracts/external/interfaces/CCTPInterfaces.sol\":{\"keccak256\":\"0xd9d9ecaf4617ec19f7c30f6ed94d15f656d8fc59eb7c757aca406331ba20424c\",\"license\":\"GPL-3.0-or-later\",\"urls\":[\"bzz-raw://19c87a9dfa12eccbfd8da0c5ad064608b0214536ad5fe5456725c8545b2d7372\",\"dweb:/ipfs/QmcaDCLq7bdk2EGi67Z9GfRe8pW77jZqveJvwyGJG5dnw3\"]},\"contracts/external/interfaces/IOpUSDCBridgeAdapter.sol\":{\"keccak256\":\"0x2a088bfda506fd767c796d29c049ac51f2a49bcd61a7f5b57110e55138b8cdc3\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://d97c8b596348a3dd2879d890d20cfb87262c8a3435a7e66927edf571796ee692\",\"dweb:/ipfs/Qmd8KSEvNZzVHpcngkGrahq8C3o9PcHkUtv89HLACYenGc\"]},\"contracts/external/interfaces/IPermit2.sol\":{\"keccak256\":\"0x68f40961ee44fbc71eff2037f2c88ba9bfbccf35b9b1eae5a527b71d19bf3a71\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://2281f309f1b0df4d1c9beeeaa2673152c73e6e20991438420a9de18c51269ea7\",\"dweb:/ipfs/QmafDC3g5yBqPvSof5FmGKv4gMR3TXT5Xj3tULDA5CKmaE\"]},\"contracts/external/interfaces/WETH9Interface.sol\":{\"keccak256\":\"0x3f7892554ec7f54681fdd3cc18a41346c246c9c1afba016c52990ef77741f718\",\"license\":\"BUSL-1.1\",\"urls\":[\"bzz-raw://76e901f8da798eb2fdef8fd0083a51088103269f08ee751598c5a6eba407785f\",\"dweb:/ipfs/QmcAHbwbwCZd78teaK4cHuAvXq71aWX1r9vTGkSRRBDJV1\"]},\"contracts/interfaces/HubPoolInterface.sol\":{\"keccak256\":\"0xefd509ab379b94004b5767d67971e5c0bda4ca1e9f376b5aea75a0297b5d7bd6\",\"license\":\"BUSL-1.1\",\"urls\":[\"bzz-raw://0b7e509e90bcca9b96bf55e92498b17bbb548359c470b17285740080a6c0d9de\",\"dweb:/ipfs/QmdviQBbB58H9HR3tKQepEuYcMKXZthyTThGXUgQDAC828\"]},\"contracts/interfaces/SpokePoolInterface.sol\":{\"keccak256\":\"0x4fefc97b3446f957f2679869ee7d8e8cc319a189f3fe47584b8203256a0d703b\",\"license\":\"BUSL-1.1\",\"urls\":[\"bzz-raw://0a73f80d7737c1a15f4d54225c66b7ffaf69fb85b0e9ef5a06a730f60d43ac13\",\"dweb:/ipfs/QmXegUowEkfsEraUYK2TgweT8j4uKVWxbQCiKV1qtDRKbt\"]},\"contracts/interfaces/SpokePoolMessageHandler.sol\":{\"keccak256\":\"0xef7377f05d40e665eb346fb1647e1341558ce5fd1e03768d81a41a579365ff47\",\"license\":\"BUSL-1.1\",\"urls\":[\"bzz-raw://6689551ad226c66bbab84387f193445ab209bf795f17ce4cf1be9ab5c1984e5d\",\"dweb:/ipfs/Qme3XnW4RZJruCDJTV8MNQsjJj14qPWZHLQZJhY4rh1iV6\"]},\"contracts/interfaces/V3SpokePoolInterface.sol\":{\"keccak256\":\"0x28d33b34690ea41eea70c5cce5db8c5f1066d74b59a23e28c7b4d9afddef7608\",\"license\":\"BUSL-1.1\",\"urls\":[\"bzz-raw://8098952a936841bb3616849c8ee96cf82328998a9cd739030f2ce57cf90d32ee\",\"dweb:/ipfs/Qmb1PpC5RkNsasyjyZrrmbMwXmKzMiSYfzm2B9Kutg6Bmf\"]},\"contracts/libraries/AddressConverters.sol\":{\"keccak256\":\"0x378f28bb4a17a5c47457cb9341086b2140f7faf6c048f702d3528166f0d74453\",\"license\":\"BUSL-1.1\",\"urls\":[\"bzz-raw://0fa273e028c9555202cac439ddf458d074b66c6f74778b2b0e5e17a0e331dc38\",\"dweb:/ipfs/QmYqEaWXgiJnsH8wRAuTKF41bxkxxvY947wdKoZrjM7HVx\"]},\"contracts/libraries/CircleCCTPAdapter.sol\":{\"keccak256\":\"0xf2d4f9d84b80259be516be7e543ea9a504ed665070d8105fbd7c84e7f79f8a32\",\"license\":\"BUSL-1.1\",\"urls\":[\"bzz-raw://42e842b241966fe9e0e612228e4ea43004d02d327bd67749b40fab2edde311bb\",\"dweb:/ipfs/QmafDiwZsycjYjsF32i5suqPTCCNEN3MQvxbvBskBJWggy\"]},\"contracts/upgradeable/AddressLibUpgradeable.sol\":{\"keccak256\":\"0x655040da45a857cf609d7176c7b0647bf76d36e73e856af79d511014c7e8ef81\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://5c17767f34d57380767b49f8584d62598964fc813e6f3587d76b51ec2357bb4e\",\"dweb:/ipfs/QmSyoTa1Snn3KiJD7KjCwsPmNqpJzusXterbEXxbYCZoJK\"]},\"contracts/upgradeable/EIP712CrossChainUpgradeable.sol\":{\"keccak256\":\"0xff617722706d1c0a6d346e56e4598cc5f60adea99b4ac1d2347dcd69270a14f6\",\"license\":\"BUSL-1.1\",\"urls\":[\"bzz-raw://e2d04649c09bad766c5632da2e3a4f1deed1e013e8b713fad1f101e06f4b56a3\",\"dweb:/ipfs/QmfCewdTDr2krzvNY5rH5BprngEtBmxPXCZf6JKavxw2Sb\"]},\"contracts/upgradeable/MultiCallerUpgradeable.sol\":{\"keccak256\":\"0xc1378a7d63785d9381b8fb6e42962499ab26a243292e20981c2792511a4697f3\",\"license\":\"BUSL-1.1\",\"urls\":[\"bzz-raw://2ec8d733e528d6e79732409eb04aa5f8a8bcdf5888e677919a07d8b84afb1598\",\"dweb:/ipfs/QmQF23Gf9vHb6Ne6kaEZmQTjobWzasEWWr5YaBFkuEypz4\"]}},\"version\":1}",
- "bytecode": "0x61016034620001e257601f6200596d38819003918201601f19168301916001600160401b03831184841017620001e65780849260a094604052833981010312620001e25780516001600160a01b03919082811690819003620001e2576200006960208301620001fa565b6200007760408401620001fa565b916060840151938585168503620001e257608001519485168503620001e2573060805260a05260c05260e0525f5460ff8160081c16620001e25760ff80821603620001a7575b50610120908152610140918252610100915f83526040519161576093846200020d8539608051848181611088015281816115a4015261171e015260a051848181610880015281816138e601528181613a57015281816140780152818161430a0152818161462201528181614c0601528181614c2d0152614f86015260c0518481816119eb0152818161389a0152614810015260e05184818161046e01526145d0015251838181611b94015261552001525182818161082301528181614ac5015281816152b8015261545701525181818161204e01528181614ba90152818161508d015261547a0152f35b60ff90811916175f557f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb3847402498602060405160ff8152a15f620000bd565b5f80fd5b634e487b7160e01b5f52604160045260245ffd5b519063ffffffff82168203620001e25756fe6080604052600436101561001a575b3615610018575f80fd5b005b5f3560e01c8063079bd2c71461043f5780630c5d5f731461043a5780630eaac9f0146104355780631186ec331461043057806311eac8551461042b57806315348e44146103b357806317fcb39b146104265780631b3d5559146104215780631fab657c1461041c578063272751c71461041757806329cb924d146104125780632e3781151461040d5780632e63e59a1461040857806333a84ff0146104035780633659cfe6146103fe578063431023b8146103f9578063437b9116146103f4578063490e49ef146103ef578063493a4f84146103ea5780634f1ef286146103e55780635249fef1146103e05780635285e058146103db57806352d1902d146103d6578063541f4f14146103d1578063577f51f8146103cc57806357f6dcb8146103c75780636068d6cb146103c2578063647c576c146103bd578063670fa8ac146103b85780636bbbcd2e146103b35780636e400983146103ae578063738b62e5146103a9578063766e0703146103a45780637aef642c1461039f5780637b9392321461039a5780637ef413e11461039557806382e2c43f146103905780638a7860ce1461038b5780638b15788e14610386578063927ede2d146103815780639748cf7c1461037c57806397943aa914610377578063979f2bc21461037257806399cc29681461036d5780639a8a059214610368578063a1244c6714610363578063a18a096e1461035e578063ac9650d814610359578063ad5425c614610354578063adb5a6a614610309578063b27a43001461034f578063b370b7f51461034a578063babb6aac14610345578063bf10268d14610340578063c35c83fc1461033b578063ceb4c98714610336578063d7e1583a14610331578063dda521131461032c578063ddd224f114610327578063de7eba7814610322578063deff4b241461031d578063e322921114610318578063ea86bd4614610313578063ee2a53f81461030e578063f79f29ed14610309578063fbbba9ac146103045763fc8a584f0361000e57612cc3565b612c3f565b6125fe565b612c01565b612afe565b612ad5565b6129e0565b6129b0565b612987565b612961565b61292b565b612831565b612806565b612782565b6126ab565b612684565b612645565b61249d565b6123fd565b612296565b61226f565b612255565b6121c0565b6120f2565b612072565b61202f565b612001565b611f83565b611f0b565b611df0565b611db9565b611d11565b611c71565b611c4d565b611bb8565b611b78565b610847565b611b3e565b611a67565b611a0f565b6119cf565b611831565b61176e565b611704565b6116dd565b61168f565b611561565b6114da565b6114bc565b6113ef565b611192565b611060565b611026565b610e2c565b610ccc565b610ca3565b610c04565b610af8565b6109ef565b610861565b610804565b610763565b610516565b6104b0565b610452565b5f91031261044e57565b5f80fd5b3461044e575f36600319011261044e57602060405163ffffffff7f0000000000000000000000000000000000000000000000000000000000000000168152f35b6001600160a01b0381160361044e57565b35906104ae82610492565b565b3461044e57602036600319011261044e5760206004356104cf81610492565b6001600160a01b038091165f52610c5d825260405f205416604051908152f35b63ffffffff81160361044e57565b61014435906104ae826104ef565b35906104ae826104ef565b3461044e57602036600319011261044e5763ffffffff600435610538816104ef565b6105406136d1565b610548613793565b16610c5a8163ffffffff198254161790557fe486a5c4bd7b36eabbfe274c99b39130277417be8d2209b4dae04c4fba64ee3a5f80a26001606555005b634e487b7160e01b5f52604160045260245ffd5b6040810190811067ffffffffffffffff8211176105b457604052565b610584565b6101a0810190811067ffffffffffffffff8211176105b457604052565b67ffffffffffffffff81116105b457604052565b6060810190811067ffffffffffffffff8211176105b457604052565b6080810190811067ffffffffffffffff8211176105b457604052565b6020810190811067ffffffffffffffff8211176105b457604052565b60e0810190811067ffffffffffffffff8211176105b457604052565b60a0810190811067ffffffffffffffff8211176105b457604052565b90601f8019910116810190811067ffffffffffffffff8211176105b457604052565b6040519060c0820182811067ffffffffffffffff8211176105b457604052565b60405190610180820182811067ffffffffffffffff8211176105b457604052565b604051906104ae826105b9565b604051906104ae82610606565b67ffffffffffffffff81116105b457601f01601f191660200190565b92919261071b826106f3565b916107296040519384610676565b82948184528183011161044e578281602093845f960137010152565b9080601f8301121561044e578160206107609335910161070f565b90565b61010036600319011261044e5760043561077c81610492565b60243561078881610492565b6084358060070b810361044e5760a435906107a2826104ef565b60c43567ffffffffffffffff811161044e576107c2903690600401610745565b926107cb613793565b60ff61086b5460e81c166107f2576107eb9460643591604435913361380e565b6001606555005b604051630b4cba3160e31b8152600490fd5b3461044e575f36600319011261044e5760206040516001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000168152f35b3461044e575f36600319011261044e5760206040515f8152f35b3461044e575f36600319011261044e5760206040516001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000168152f35b67ffffffffffffffff81116105b45760051b60200190565b9080601f8301121561044e5760209082356108d6816108a4565b936108e46040519586610676565b81855260208086019260051b82010192831161044e57602001905b82821061090d575050505090565b813581529083019083016108ff565b9080601f8301121561044e576020908235610936816108a4565b936109446040519586610676565b81855260208086019260051b82010192831161044e57602001905b82821061096d575050505090565b838091833561097b81610492565b81520191019061095f565b9291610991826108a4565b9161099f6040519384610676565b829481845260208094019160051b810192831161044e57905b8282106109c55750505050565b813581529083019083016109b8565b9080601f8301121561044e5781602061076093359101610986565b60031960603682011261044e57600435610a08816104ef565b60243567ffffffffffffffff9283821161044e5760c090823603011261044e57610a30610698565b908060040135825260248101356020830152604481013584811161044e57610a5e90600436918401016108bc565b6040830152610a6f6064820161050b565b6060830152610a80608482016104a3565b608083015260a48101359084821161044e576004610aa1923692010161091c565b60a082015260443592831161044e57610ac16100189336906004016109d4565b91612cf3565b9181601f8401121561044e5782359167ffffffffffffffff831161044e576020808501948460051b01011161044e57565b3461044e5760031960603682011261044e5760043567ffffffffffffffff80821161044e5760608236039384011261044e5760243590610b37826104ef565b60443590811161044e57610b4f903690600401610ac7565b919093610b5a613793565b600484013590610182190181121561044e57610bf094610beb93610b87610be4936004369189010161284f565b95610b9d610b986080890151613da4565b613a4d565b610ba687613604565b9060446020890151916101608a015193610bbe610698565b9a8b5260208b015201356040890152606088015260808701525f60a08701523691610986565b9083613dba565b613f0b565b6100186001606555565b8015150361044e57565b3461044e57606036600319011261044e57600435610c2181610492565b602435907f0a21fdd43d0ad0c62689ee7230a47309a050755bcc52eba00310add65297692a60206001600160a01b0360443593610c5d85610bfa565b610c656136d1565b610c6d613793565b1692835f5261086d825260405f20855f52825260405f209015159060ff1981541660ff8316179055604051908152a36001606555005b3461044e575f36600319011261044e576020604051428152f35b908161018091031261044e5790565b3461044e57604036600319011261044e5760043567ffffffffffffffff811161044e57610cfd903690600401610cbd565b610d0681612eeb565b6001600160a01b031690610d1c60208201612eeb565b6001600160a01b031691610d3260408301612eeb565b6001600160a01b0316610d4760608401612eeb565b6001600160a01b031692610d5d60808201612eeb565b6001600160a01b031690610100610d75818301612ef5565b9061012090610d85848301612ef5565b9261014094858101610d9690612ef5565b966101609a8b8301610da89084612eff565b9a909b610db36106b8565b9e8f91825260208201526040015260608d015260808c015260a081013560a08c015260c081013560c08c015260e0013560e08b015263ffffffff1690890152870190610e04919063ffffffff169052565b63ffffffff909116908501523690610e1b9261070f565b908201523360243561001892613635565b3461044e57602036600319011261044e576004803567ffffffffffffffff811161044e57610e5d9036908301610cbd565b610e65613793565b60ff61086b5460e01c166110165763ffffffff80421692610140830193610e9e81610e8f87612ef5565b63ffffffff9182169116101590565b61100657610120840192610eb184612ef5565b1610610ff757610ec9610ec4368561284f565b613604565b90610edd825f5261087260205260405f2090565b54610fe95750610f2c7f3cee3e290f36226751cd0b3321b213890fe9c768e922f267fa6111836ce05c3292610f27610f21610f32945f5261087260205260405f2090565b60019055565b612ef5565b93612ef5565b610f52610f4d610f46610160860186612eff565b369161070f565b6143e0565b90610fdc6040519283926101008701359760e08801359760208101359281359260408301359260c08101359060a081013590606060808201359101358b9693909a999895919261012098959361014089019c895260208901526040880152606087015263ffffffff80921660808701521660a085015260c084015260e08301526101008201520152565b0390a36100186001606555565b604051624be79160e21b8152fd5b60405163d642b7d960e01b8152fd5b50604051630277ae7b60e21b8152fd5b50604051633d90fc5560e11b8152fd5b3461044e575f36600319011261044e5760206040517f9c6dfd61d811b9950a4f2b9adf46357b717c816d22c420d0bde8f2360148f7cd8152f35b3461044e57602036600319011261044e5760043561107d81610492565b6001600160a01b03807f00000000000000000000000000000000000000000000000000000000000000001680301461044e577f360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc90828254160361044e576110e26136d1565b604051916110ef83610622565b5f83527f4910fdfa16fed3260ed0e7147f7cc6da11a60208b5b9406d12a635614ffd91435460ff16156111285750505061001890614dc5565b6020600491604051928380926352d1902d60e01b825288165afa5f9181611161575b50611153575f80fd5b0361044e5761001891614cac565b61118491925060203d60201161118b575b61117c8183610676565b810190613ba7565b905f61114a565b503d611172565b3461044e57608036600319011261044e576004356111af816104ef565b602435906111bc82610492565b6044356111c881610492565b606435916111d583610492565b60ff5f5460081c161561044e5761121c90610c5a624c4b4063ffffffff1982541617905561086b9063ffffffff60c01b1963ffffffff60c01b83549260c01b169116179055565b6040519061122982610598565b6009825260208201916820a1a927a9a996ab1960b91b8352640312e302e360dc1b602060405161125881610598565b60058152015260ff5f5460081c161561044e57610018946112bd936112b89251902061047f557f06c015bd22b4c69690933c1058878ebdfef31f9aaae40bbe86d8a09fe1b2972c610480556112ab614847565b6112b3614856565b61486a565b6148c4565b610c5a9077ffffffffffffffffffffffffffffffffffffffff000000001977ffffffffffffffffffffffffffffffffffffffff0000000083549260201b169116179055565b602060031982011261044e576004359067ffffffffffffffff821161044e5761132d91600401610ac7565b9091565b5f5b8381106113425750505f910152565b8181015183820152602001611333565b9060209161136b81518092818552858086019101611331565b601f01601f1916010190565b6020808201908083528351809252604092604081018260408560051b8401019601945f925b8584106113ad575050505050505090565b9091929394959685806113de600193603f1986820301885286838d5180511515845201519181858201520190611352565b99019401940192959493919061139c565b3461044e576113fd36611302565b611406816108a4565b9160406114166040519485610676565b828452601f19611425846108a4565b015f5b8181106114995750505f5b83811061144c57604051806114488782611377565b0390f35b8061149361145c60019388612f55565b515f8061146a858a8a612f69565b90611479895180938193612f80565b0390305af490611487612f8d565b60208201529015159052565b01611433565b60209083516114a781610598565b5f815282606081830152828901015201611428565b3461044e575f36600319011261044e5760206040516301e133808152f35b3461044e57604036600319011261044e576024356004356114f96136d1565b611501613793565b61086c8054680100000000000000008110156105b45763ffffffff916001820190558361152d82612bc2565b5084600182015555167fc86ba04c55bc5eb2f2876b91c438849a296dbec7b08751c3074d92e04f0a77af5f80a46001606555005b604036600319011261044e5760043561157981610492565b60243567ffffffffffffffff811161044e57611599903690600401610745565b6001600160a01b03807f0000000000000000000000000000000000000000000000000000000000000000169081301461044e577f360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc91818354160361044e576115ff6136d1565b7f4910fdfa16fed3260ed0e7147f7cc6da11a60208b5b9406d12a635614ffd91435460ff16156116355750505061001890614dc5565b6020600491604051928380926352d1902d60e01b825288165afa5f918161166e575b50611660575f80fd5b0361044e5761001891614d74565b61168891925060203d60201161118b5761117c8183610676565b905f611657565b3461044e57604036600319011261044e576001600160a01b036004356116b481610492565b165f5261086d60205260405f206024355f52602052602060ff60405f2054166040519015158152f35b3461044e575f36600319011261044e5760206001600160a01b036108695416604051908152f35b3461044e575f36600319011261044e576001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016300361044e5760206040517f360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc8152f35b61012036600319011261044e5760043561178781610492565b6024359061179482610492565b604435916117a183610492565b60a4358060070b810361044e5760c435916117bb836104ef565b60e43567ffffffffffffffff811161044e576117db903690600401610745565b936117e4613793565b60ff61086b5460e81c166107f2576107eb95608435926064359261380e565b9181601f8401121561044e5782359167ffffffffffffffff831161044e576020838186019501011161044e57565b3461044e5760c036600319011261044e5760043561184e81610492565b6024356044359160643561186181610492565b67ffffffffffffffff9160843583811161044e57611883903690600401611803565b60a49491943591821161044e577f45e04bc8f121ba11466985789ca2822a91109f31bb8ac85504a37b7eaf873c26946118c36119ca933690600401611803565b9290916001600160a01b038097168a6119be6118e036868661070f565b60428d6118ee368b8b61070f565b92602081519101209460409586519160208301937f9c6dfd61d811b9950a4f2b9adf46357b717c816d22c420d0bde8f2360148f7cd85528884015246606084015260808301528760a083015260c082015260c0815261194c8161063e565b51902061047f546104805486519060208201927fc2f8787176b8ac6bf7215b4adcc1e069bf4ab82d9ab1df05a57a91d425935b6e84528883015260608201524660808201526080815261199e8161065a565b5190209085519161190160f01b835260028301526022820152208a614e08565b51978897169a87612fdc565b0390a3005b3461044e575f36600319011261044e57602060405163ffffffff7f0000000000000000000000000000000000000000000000000000000000000000168152f35b3461044e575f36600319011261044e57602060ff61086b5460e81c166040519015158152f35b606090600319011261044e57600435611a4d816104ef565b90602435611a5a81610492565b9060443561076081610492565b3461044e57611a7536611a35565b5f54600881901c60ff1615939290849081611b30575b8115611b10575b501561044e57611ab69284611aad600160ff195f5416175f55565b611af95761300f565b611abc57005b611aca61ff00195f54165f55565b604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb384740249890602090a1005b611b0b61010061ff00195f5416175f55565b61300f565b303b15915081611b22575b505f611a92565b6001915060ff16145f611b1b565b600160ff8216109150611a8b565b3461044e575f36600319011261044e5760206040517f8d1994e2bbbd77564cdca06dd819e7ee2a5efa06c80dcb59a4a7b6e39edc538f8152f35b3461044e575f36600319011261044e57602060405163ffffffff7f0000000000000000000000000000000000000000000000000000000000000000168152f35b3461044e57602036600319011261044e577fe88463c2f254e2b070013a2dc7ee1e099f9bc00534cbdf03af551dc26ae492196020600435611bf881610bfa565b611c006136d1565b611c08613793565b151561086b80547fffff00ffffffffffffffffffffffffffffffffffffffffffffffffffffffffff60ff60e81b8460e81b169116179055604051908152a16001606555005b3461044e575f36600319011261044e57602063ffffffff610c5a5416604051908152f35b61016036600319011261044e57600435611c8a81610492565b60243590611c9782610492565b604435611ca381610492565b60643590611cb082610492565b60e435611cbc81610492565b6101043590611cca826104ef565b6101243592611cd8846104ef565b610144359667ffffffffffffffff881161044e57611cfd610018983690600401611803565b97909660c4359360a4359360843593613155565b61018036600319011261044e57600435611d2a81610492565b60243590611d3782610492565b604435611d4381610492565b60643590611d5082610492565b60e435611d5c81610492565b61010435611d69816104ef565b6101243591611d77836104ef565b611d7f6104fd565b93610164359767ffffffffffffffff891161044e57611da5610018993690600401611803565b98909760c4359360a4359360843593613177565b3461044e57606036600319011261044e576020611de8600435611ddb81610492565b6044359060243590613292565b604051908152f35b3461044e57606036600319011261044e5767ffffffffffffffff60243581811161044e57611e22903690600401611803565b9160443590811161044e57611e3b903690600401611803565b9060405193602085019480611e524684888a6132ce565b0395611e66601f1997888101845283610676565b6004359151902003611ef9575f94611e95611eb793611e8c87611ec3958a990190612905565b958101906132eb565b519360405193849160208301966337bfd2c960e21b88523391602485016133b3565b03908101835282610676565b5190305af4611ed0612f8d565b9015611ed857005b60405163b8fe37a760e01b8152908190611ef590600483016133d5565b0390fd5b604051630f0c8f4760e11b8152600490fd5b3461044e57602036600319011261044e57600435611f276136d1565b611f2f613793565b611f3881612bc2565b611f70576001815f80935501557f7c1af0646963afc3343245b103731965735a893347bfa0d58a5dc77a77ae691c5f80a26001606555005b634e487b7160e01b5f525f60045260245ffd5b6101a036600319011261044e5761012435611f9d816104ef565b61014435611faa816104ef565b6101643591611fb8836104ef565b610184359267ffffffffffffffff841161044e57611fdd610018943690600401611803565b9390926101043560e43560c43560a4356084356064356044356024356004356133e6565b3461044e575f36600319011261044e5760206040517342000000000000000000000000000000000000078152f35b3461044e575f36600319011261044e5760206040516001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000168152f35b3461044e5760e036600319011261044e5767ffffffffffffffff60043581811161044e576120a4903690600401610cbd565b60a43582811161044e576120bc903690600401611803565b60c49291923593841161044e576120da610018943690600401611803565b9390926084359060643590604435906024359061345e565b3461044e5761210036611a35565b909160ff5f5460081c161561044e576121369061086b9063ffffffff60c01b1963ffffffff60c01b83549260c01b169116179055565b60405161214281610598565b6009815260208101926820a1a927a9a996ab1960b91b8452640312e302e360dc1b602060405161217181610598565b60058152015260ff5f5460081c161561044e57610018936112b89251902061047f557f06c015bd22b4c69690933c1058878ebdfef31f9aaae40bbe86d8a09fe1b2972c610480556112ab614847565b3461044e57602036600319011261044e577f2d5b62420992e5a4afce0e77742636ca2608ef58289fd2e1baa5161ef6e7e41e602060043561220081610bfa565b6122086136d1565b612210613793565b151561086b80547fffffff00ffffffffffffffffffffffffffffffffffffffffffffffffffffffff60ff60e01b8460e01b169116179055604051908152a16001606555005b3461044e575f36600319011261044e576020604051468152f35b3461044e575f36600319011261044e57602063ffffffff61086b5460c01c16604051908152f35b3461044e57604036600319011261044e576004356024356122b682614bd0565b6001600160a01b0382165f526108736020526122e560405f20336001600160a01b03165f5260205260405f2090565b54918215612388575f61232c336123166122fe85613da4565b6001600160a01b03165f5261087360205260405f2090565b906001600160a01b03165f5260205260405f2090565b556123588361234961233d84613da4565b6001600160a01b031690565b61235285613da4565b9061491e565b60405192835233927f6c172ea51018fb2eb2118f3f8a507c4df71eb519b8c0052834dc3c920182fef490602090a4005b6040516336542bf760e21b8152600490fd5b6020808201906020835283518092526040830192602060408460051b8301019501935f915b8483106123cf5750505050505090565b90919293949584806123ed600193603f198682030187528a51611352565b98019301930191949392906123bf565b3461044e5761240b36611302565b9061241582613547565b915f5b81811061242d5760405180611448868261239a565b5f8061243a838587612f69565b9061244a60405180938193612f80565b0390305af4612457612f8d565b901561247d579060019161246b8287612f55565b526124768186612f55565b5001612418565b604481511061044e5780600461044e920151602480918301019101613590565b6101808060031936011261044e57610104356124b8816104ef565b61012435916124c6836104ef565b61014435926124d4846104ef565b6101643567ffffffffffffffff811161044e576124f5903690600401611803565b6124fd613793565b61086b549260ff8460e81c166107f257610bf0966125c2610f46926125b463ffffffff6125d09860c01c16996125586125358c6135ef565b61086b9063ffffffff60c01b1963ffffffff60c01b83549260c01b169116179055565b6125606106d9565b9a6004358c5260243560208d015260443560408d015260643560608d015260843560808d015260a43560a08d015260c43560c08d015260e43560e08d01526101008c01526101208b019063ffffffff169052565b63ffffffff16610140890152565b63ffffffff16610160870152565b90820152614527565b604090600319011261044e576004356125f181610492565b9060243561076081610492565b3461044e57602061263c6001600160a01b03612619366125d9565b91165f52610873835260405f20906001600160a01b03165f5260205260405f2090565b54604051908152f35b3461044e57602036600319011261044e57602060043561266481610492565b6001600160a01b038091165f52610c5c825260405f205416604051908152f35b3461044e575f36600319011261044e5760206001600160a01b0361086a5416604051908152f35b3461044e5760c036600319011261044e5760043560243567ffffffffffffffff60643560443560843583811161044e576126e9903690600401611803565b60a49491943591821161044e577f45e04bc8f121ba11466985789ca2822a91109f31bb8ac85504a37b7eaf873c2694612729612778933690600401611803565b929091612734613793565b61273d8a614bd0565b61276c898b898961274f36888861070f565b9261275b368b8b61070f565b946001600160a01b034692166143f5565b60405196879687612fdc565b0390a36001606555005b3461044e57612790366125d9565b906127996136d1565b6127a1613793565b6001600160a01b0380911691825f52610c5d6020526127d98160405f20906001600160a01b03166001600160a01b0319825416179055565b16907fcb84c2022106a6f2b6f805d446f32fbfd2a528474364fa755f37dac1c0c1b6c85f80a36001606555005b3461044e57602036600319011261044e576004355f52610872602052602060405f2054604051908152f35b3461044e575f36600319011261044e57602060405163ffffffff8152f35b91906101808382031261044e576128646106b8565b92803584526020810135602085015260408101356040850152606081013560608501526080810135608085015260a081013560a085015260c081013560c085015260e081013560e085015261010080820135908501526101206128c881830161050b565b908501526101406128da81830161050b565b90850152610160918282013567ffffffffffffffff811161044e576128ff9201610745565b90830152565b9060208282031261044e57813567ffffffffffffffff811161044e57610760920161284f565b3461044e57602036600319011261044e5760043567ffffffffffffffff811161044e57611de8610ec4602092369060040161284f565b3461044e575f36600319011261044e57602060ff61086b5460e01c166040519015158152f35b3461044e575f36600319011261044e5760206040516ec097ce7bc90715b34b9f10000000008152f35b3461044e57602036600319011261044e576107eb6004356129d081610492565b6129d86136d1565b6112b3613793565b3461044e57606036600319011261044e5760043567ffffffffffffffff811161044e57612a1190369060040161284f565b612a19613793565b60ff61086b5460e01c16612ac35761014081015163ffffffff4281169116101580612aa4575b612a925780612a50610bf092613604565b60c082015160208301519061016084015192612a6a610698565b948552602085015260408401526060830152608082015260243560a08201526044359061417f565b604051630c3a9b9d60e41b8152600490fd5b50612ab26040820151613da4565b6001600160a01b0316331415612a3f565b604051633d90fc5560e11b8152600490fd5b3461044e575f36600319011261044e576020610c5a546001600160a01b0360405191831c168152f35b6101608060031936011261044e5761010435612b19816104ef565b61012435612b26816104ef565b6101443567ffffffffffffffff811161044e57612b47903690600401611803565b63ffffffff94612b5a8642169586613138565b93612b63613793565b61086b549160ff8360e81c166107f257612b96612ba3966125b4610bf09a610f469660c01c16996125586125358c6135ef565b86019063ffffffff169052565b610180820152614527565b634e487b7160e01b5f52603260045260245ffd5b61086c908154811015612bfc576003915f52027f71cd7344f4eb2efc8e30291f6dbdb44d618ca368ea5425d217c1d604bf26b84d01905f90565b612bae565b3461044e57602036600319011261044e5760043561086c5481101561044e57612c2b604091612bc2565b506001815491015482519182526020820152f35b3461044e57612c4d366125d9565b90612c566136d1565b612c5e613793565b6001600160a01b0380911691825f52610c5c602052612c968160405f20906001600160a01b03166001600160a01b0319825416179055565b16907ff3dc137d2246f9b8abd0bb821e185ba01122c9b3ea3745ffca6208037674d6705f80a36001606555005b3461044e57602036600319011261044e576107eb600435612ce381610492565b612ceb6136d1565b6112b8613793565b91612cfc613793565b6080820191612d15610b9884516001600160a01b031690565b602081019182514603612e1c57612d3d612d4191836001612d3589612bc2565b500154613ac0565b1590565b612e0a578060607ff4ad92585b1bc117fbdd644990adf0827bc4c95baeae8a23322af807b6d0020e920193612d83612d7d865163ffffffff1690565b87613b52565b612dfd845194835193612de2612dd4612dc360408401998a51612daa8d5163ffffffff1690565b89516001600160a01b03169160a088019b8c5194613bc3565b925193519851995163ffffffff1690565b94516001600160a01b031690565b945163ffffffff9586604051978897169b1699339487612e9d565b0390a46104ae6001606555565b60405163582f497d60e11b8152600490fd5b604051633d23e4d160e11b8152600490fd5b9081518082526020808093019301915f5b828110612e4d575050505090565b835185529381019392810192600101612e3f565b9081518082526020808093019301915f5b828110612e80575050505090565b83516001600160a01b031685529381019392810192600101612e72565b9496959193612ebf60a095612edd93885260c0602089015260c0880190612e2e565b906001600160a01b0380951660408801528682036060880152612e61565b951515608085015216910152565b3561076081610492565b35610760816104ef565b903590601e198136030182121561044e570180359067ffffffffffffffff821161044e5760200191813603831361044e57565b634e487b7160e01b5f52602160045260245ffd5b60031115612f5057565b612f32565b8051821015612bfc5760209160051b010190565b90821015612bfc5761132d9160051b810190612eff565b908092918237015f815290565b3d15612fb7573d90612f9e826106f3565b91612fac6040519384610676565b82523d5f602084013e565b606090565b908060209392818452848401375f828201840152601f01601f1916010190565b9492909361300192610760979587526020870152608060408701526080860191612fbc565b926060818503910152612fbc565b91909160ff5f5460081c161561044e5761305990610c5a624c4b4063ffffffff1982541617905561086b9063ffffffff60c01b1963ffffffff60c01b83549260c01b169116179055565b60405161306581610598565b6009815260208101926820a1a927a9a996ab1960b91b8452640312e302e360dc1b602060405161309481610598565b60058152015260ff5f5460081c161561044e576130e3936112b89251902061047f557f06c015bd22b4c69690933c1058878ebdfef31f9aaae40bbe86d8a09fe1b2972c610480556112ab614847565b6104ae610c5a77deaddeaddeaddeaddeaddeaddeaddeaddead00000000000077ffffffffffffffffffffffffffffffffffffffff0000000019825416179055565b634e487b7160e01b5f52601160045260245ffd5b91909163ffffffff8080941691160191821161315057565b613124565b96949290916104ae9b9a999896949261317563ffffffff42169889613138565b985b9593919b999897969492909b61318b613793565b61086b549660ff8860e81c166107f2578760c01c63ffffffff166131ae906135ef565b6131d59061086b9063ffffffff60c01b1963ffffffff60c01b83549260c01b169116179055565b6131dd6106d9565b9d6001600160a01b038f921682526001600160a01b031690602001526001600160a01b031660408d01526001600160a01b031660608c015260808b015260a08a015260c08901526001600160a01b031660e088015260c01c63ffffffff16610100870152610120860190613256919063ffffffff169052565b63ffffffff1661014085015263ffffffff1661016084015236906132799261070f565b61018082015261328890614527565b6104ae6001606555565b916040519160208301936bffffffffffffffffffffffff199060601b16845260348301526054820152605481526132c881610606565b51902090565b9392916020916132e691604087526040870191612fbc565b930152565b9081602091031261044e57604051906020820182811067ffffffffffffffff8211176105b45760405235815290565b6107609161018090825181526020830151602082015260408301516040820152606083015160608201526080830151608082015260a083015160a082015260c083015160c082015260e083015160e0820152610100808401519082015261338f610120808501519083019063ffffffff169052565b6101408381015163ffffffff16908201528161016080940151938201520190611352565b6133cb6040929594939560608352606083019061331a565b9460208201520152565b906020610760928181520190611352565b9c9a99989796959493929190966133fb613793565b60ff61086b5460e81c166107f257613414908e33613292565b96604051809e613423826105b9565b81526020015260408d015260608c015260808b015260a08a015260c089015260e088015261010087015263ffffffff16610120860152613256565b97929095939196949761346f613793565b60ff61086b5460e01c16612ac35761348a6101408201612ef5565b63ffffffff8042169116101580613528575b612a9257613511613523966135096132889b6134bb610ec4368761284f565b9a6134c4610698565b9b6134cf368861284f565b8d5260208d01528660408d01528760608d01526134ed368b8461070f565b60808d015260a08c01526135018535613da4565b98369161070f565b95369161070f565b9461010060e0830135920135906143f5565b61417f565b506135366040820135613da4565b6001600160a01b031633141561349c565b90613551826108a4565b61355e6040519182610676565b828152809261356f601f19916108a4565b01905f5b82811061357f57505050565b806060602080938501015201613573565b60208183031261044e5780519067ffffffffffffffff821161044e570181601f8201121561044e5780516135c3816106f3565b926135d16040519485610676565b8184526020828401011161044e576107609160208085019101611331565b63ffffffff8091169081146131505760010190565b6040516132c881613621602082019460408652606083019061331a565b46604083015203601f198101835282610676565b919091613640613793565b60ff61086b5460e01c16612ac35761014081015163ffffffff42811691161015806136b2575b612a92576132889261367782613604565b60c083015160208401519061016085015192613691610698565b958652602086015260408501526060840152608083015260a082015261417f565b506136c06040820151613da4565b6001600160a01b0316331415613666565b73420000000000000000000000000000000000000780330361378157602060049160405192838092636e296e4560e01b82525afa90811561377c575f9161374d575b506001600160a01b0361373261233d610869546001600160a01b031690565b91160361373b57565b6040516336a816d960e01b8152600490fd5b61376f915060203d602011613775575b6137678183610676565b810190614966565b5f613713565b503d61375d565b6137b1565b60405163253a6fc960e11b8152600490fd5b60026065541461044e576002606555565b9190820391821161315057565b6040513d5f823e3d90fd5b926107609695929491946101409585525f60208601526040850152606084015263ffffffff809116608084015260a08301525f60c083015260e08201525f610100820152816101208201520190611352565b9193949690959661384f612d3d6138488861383b896001600160a01b03165f5261086d60205260405f2090565b905f5260205260405f2090565b5460ff1690565b613a3b5760070b906706f05b59d3b200006138698361497b565b1015613a29576ec097ce7bc90715b34b9f10000000008411613a175763ffffffff93613897858a16426137a4565b857f00000000000000000000000000000000000000000000000000000000000000001610613a055761086b5460c01c63ffffffff16986138d96125358b6135ef565b6001600160a01b039586807f000000000000000000000000000000000000000000000000000000000000000016981692888414806139fc575b156139c0578034036139ae57883b1561044e575f6004996040519a8b8092630d0e30db60e41b825234905af198891561377c5761397d613990978a927f32ed1a409ef04c7b0227189c3a103dc5ac10e775a15b785dcc510201f7c25ad39c613995575b505b836149c9565b92604051998a99169d169b1693876137bc565b0390a4565b806139a26139a8926105d6565b80610444565b5f613975565b604051636452a35d60e01b8152600490fd5b7f32ed1a409ef04c7b0227189c3a103dc5ac10e775a15b785dcc510201f7c25ad398508761397d613990976139f78430338a61498a565b613977565b50341515613912565b60405163f722177f60e01b8152600490fd5b60405163622db5a960e11b8152600490fd5b60405163284f109760e21b8152600490fd5b604051632a58c4f360e01b8152600490fd5b6001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000811691168114613a84575b50565b47613a8c5750565b4790803b1561044e575f90600460405180948193630d0e30db60e41b83525af1801561377c5715613a81576104ae906105d6565b6107609291604051613b4981613b3b602082019460208652805160408401526020810151606084015260a0613b05604083015160c06080870152610100860190612e2e565b606083015163ffffffff168583015260808301516001600160a01b031660c0860152910151838203603f190160e0850152612e61565b03601f198101835282610676565b519020916149ff565b613b5d600291612bc2565b500162ffffff8260081c16805f5281602052600160ff60405f205494161b8080941614613b95575f5260205260405f20908154179055565b60405163954476d960e01b8152600490fd5b9081602091031261044e575190565b9190820180921161315057565b91959495939092935f9681519081815103613d925781613c42575b50505082613bed575b50505050565b6001600160a01b0381613c217ffa7fa7cf6d7dde5f9be65a67e6a1a747e7aa864dcd2d793353c722d80fbbb3579386614ac2565b6040805195865233602087015291169463ffffffff1693a45f808080613be7565b604080516370a0823160e01b81523060048083019190915291906020816024816001600160a01b038b165afa90811561377c575f91613d73575b505f805b868110613c91575050505050613bde565b613c9b8189612f55565b51613ca9575b600101613c80565b90613cbf90613cb8838a612f55565b5190613bb6565b90828211613d6357613cf9612d3d613ce7613cda848a612f55565b516001600160a01b031690565b613cf1848c612f55565b51908c614a50565b15613ca1579c5087613d59613d518f613d3c613cda613d35613d1b848f612f55565b51966001600160a01b03165f5261087360205260405f2090565b928b612f55565b6001600160a01b03165f5260205260405f2090565b918254613bb6565b905560019c613ca1565b50505051632ddaa83160e11b8152fd5b613d8c915060203d60201161118b5761117c8183610676565b5f613c7c565b6040516319a5316760e31b8152600490fd5b6001600160a01b0390613db681614bd0565b1690565b91612d3d90613e3392845160408096015191865191613dd8836105ea565b8252613b49613df36020840192468452898501958652612bc2565b5054938851928391613e186020840196602088525160608d86015260a085019061331a565b9151606084015251608083015203601f198101835282610676565b613e3a5750565b5163582f497d60e11b8152600490fd5b613e5382612f46565b52565b9a989693919c9b9997959492909c6101e08c019d8c5260208c015260408b015260608a0152608089015263ffffffff80921660a08901521660c087015260e08601526101008501526101208401526101408301528051610160830152602081015161018083015260408101516101a08301526060015190613ed682612f46565b6101c00152565b9061076094936080936001600160a01b03809316845260208401521660408201528160608201520190611352565b905f82516101208101613f22815163ffffffff1690565b63ffffffff4291161061416d576020850151906002613f4a835f5261087260205260405f2090565b541461415b57613f6486925f5261087260205260405f2090565b6002905560608301519060808401519160a08501519260c0860151918560a0810151938860e0810151956101008201519751613fa39063ffffffff1690565b61014083015163ffffffff166040840151918451936020860151956101600151613fcc906143e0565b966060890151986080019e8f51613fe2906143e0565b906040015190613ff06106e6565b9a8b5260208b015260408a0152600260608a01526040519d8e9b6140149b8d613e56565b037f44b559f101f8fbcc8a0ea43fa91a05a729a5ea6e14a7c75aa750374690137208905f94a4608082015161404890613da4565b906040860151956060015161405c90613da4565b926080015161406a90613da4565b6001600160a01b03919082167f00000000000000000000000000000000000000000000000000000000000000008316036141465784614133575b6140b087838616614beb565b51928351151580614129575b6140ca575b50505050509050565b1690813b1561412557836140f8959660405196879586948593633a5be8cb60e01b8552339160048601613edd565b03925af1801561377c57614112575b8080808085946140c1565b806139a261411f926105d6565b5f614107565b8380fd5b50803b15156140bc565b61414187303385871661498a565b6140a4565b5f9450614156878585851661491e565b6140b0565b604051630479306360e51b8152600490fd5b60405163d642b7d960e01b8152600490fd5b8051916101208301614195815163ffffffff1690565b63ffffffff4291161061416d57602083015160016141bc825f5261087260205260405f2090565b54036143d9576001905b60026141db825f5261087260205260405f2090565b541461415b576141f76141fd915f5261087260205260405f2090565b60029055565b7f44b559f101f8fbcc8a0ea43fa91a05a729a5ea6e14a7c75aa75037469013720860608601516080870151906142ca8760a08a0151958a60c08101519760a08401519860e08301519961425a6101008501519c5163ffffffff1690565b61014085015163ffffffff16916040860151938651956142be61428661016060208b01519a01516143e0565b9960608c01519b604061429c60808301516143e0565b9101519060206142aa6106e6565b9e8f528e015260408d015260608c01613e4a565b6040519c8d9c8d613e56565b0390a46142da6080830151613da4565b9160408201519160806142fc816142f46060850151613da4565b940151613da4565b6001600160a01b03929083167f00000000000000000000000000000000000000000000000000000000000000008416036143c65761433e853033868a1661498a565b61434a85848616614beb565b01519182511515806143bc575b614363575b5050505050565b16803b1561044e57614391935f809460405196879586948593633a5be8cb60e01b8552339160048601613edd565b03925af1801561377c576143a9575b8080808061435c565b806139a26143b6926105d6565b5f6143a0565b50803b1515614357565b6143d4858533868a1661498a565b61434a565b5f906141c6565b805190816143ee5750505f90565b6020012090565b93926042936104ae979660208151910120906040519260208401947f8d1994e2bbbd77564cdca06dd819e7ee2a5efa06c80dcb59a4a7b6e39edc538f86526040850152856060850152608084015260a083015260c082015260c0815261445a8161063e565b5190209061047f549061048054906040519160208301937fc2f8787176b8ac6bf7215b4adcc1e069bf4ab82d9ab1df05a57a91d425935b6e8552604084015260608301526080820152608081526144b08161065a565b519020906040519161190160f01b8352600283015260228201522090614e08565b96926107609a9996949198959261014099895260208901526040880152606087015263ffffffff928380921660808801521660a08601521660c084015260e0830152610100820152816101208201520190611352565b6145318151614bd0565b6040908181019061455d6145458351613da4565b6001600160a01b03165f5261086d60205260405f2090565b9261457a612d3d61384860c085019687515f5260205260405f2090565b6148375761012082019261459e614595855163ffffffff1690565b63ffffffff1690565b8042109081156147fe575b506147ed576101408301926145c2845163ffffffff1690565b9163ffffffff92836145f6817f00000000000000000000000000000000000000000000000000000000000000001642613bb6565b9116116147dc5761016082015163ffffffff169280841680614798575b50508051936001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000168095148061478f575b15614729576080830151340361471957843b1561044e575f600495825196878092630d0e30db60e41b825234905af191821561377c577f32ed1a409ef04c7b0227189c3a103dc5ac10e775a15b785dcc510201f7c25ad39561399093614706575b505b519260608101519460808201519060a08301519a51986146e66146db6101008601519c5163ffffffff1690565b915163ffffffff1690565b9084519c60208601519461018060e088015197015197519a8b9a8b6144d1565b806139a2614713926105d6565b5f6146ac565b51636452a35d60e01b8152600490fd5b919293503461477e577f32ed1a409ef04c7b0227189c3a103dc5ac10e775a15b785dcc510201f7c25ad39392918161477961476a61233d6139909551613da4565b6080860151903090339061498a565b6146ae565b8151636452a35d60e01b8152600490fd5b5034151561464b565b6301e1338010156147c7575b5060e0820151156147b6575f80614613565b835163495d907f60e01b8152600490fd5b926147d59193421690613138565b915f6147a4565b835163582e388960e01b8152600490fd5b815163f722177f60e01b8152600490fd5b6148099150426137a4565b63ffffffff7f000000000000000000000000000000000000000000000000000000000000000016105f6145a9565b51632a58c4f360e01b8152600490fd5b60ff5f5460081c161561044e57565b60ff5f5460081c161561044e576001606555565b6001600160a01b031680156148b257610869816001600160a01b03198254161790557fa9e8c42c9e7fca7f62755189a16b2f5314d43d8fb24e91ba54e6d65f9314e8495f80a2565b60405163ba97b39d60e01b8152600490fd5b6001600160a01b0316801561490c5761086a816001600160a01b03198254161790557fa73e8909f8616742d7fe701153d82666f7b7cd480552e23ebb05d358c22fd04e5f80a2565b604051635b03092b60e11b8152600490fd5b60405163a9059cbb60e01b60208201526001600160a01b03909216602483015260448201929092526104ae9161496182606481015b03601f198101845283610676565b614ee6565b9081602091031261044e575161076081610492565b5f81126149855790565b5f0390565b90926104ae93604051936323b872dd60e01b60208601526001600160a01b0380921660248601521660448401526064830152606482526149618261065a565b90670de0b6b3a7640000915f82840392128383128116908484139015161761315057818102918183041490151715613150570490565b929091905f915b8451831015614a4857614a198386612f55565b519081811015614a37575f52602052600160405f205b920191614a06565b905f52602052600160405f20614a2f565b915092501490565b60405163a9059cbb60e01b60208281019182526001600160a01b039094166024830152604482019490945290925f91614a8c8160648101613b3b565b519082855af1903d5f519083614aa3575b50505090565b91925090614ab857503b15155b5f8080614a9d565b6001915014614ab0565b907f0000000000000000000000000000000000000000000000000000000000000000906001600160a01b03808316818316149081614ba5575b5015614b9a575081614b0c916152df565b61086a546001600160a01b0316610c5a5463ffffffff1673bd80b06d3dbd0801132c6689429ac09ca6d27f82803b1561044e5760405163262cc5ab60e11b81526001600160a01b039093166004840152602483019390935263ffffffff166044820152905f908290818381606481015b03925af1801561377c57614b8d5750565b806139a26104ae926105d6565b90506104ae91614f76565b90507f000000000000000000000000000000000000000000000000000000000000000016155f614afb565b60a01c614bd957565b6040516379ec0ed760e11b8152600490fd5b6001600160a01b0390811690813b15614c2b57906104ae92917f00000000000000000000000000000000000000000000000000000000000000001661491e565b7f000000000000000000000000000000000000000000000000000000000000000016803b1561044e575f8091602460405180948193632e1a7d4d60e01b83528860048401525af1801561377c57614c9d575b5081471061044e575f80809381935af1614c95612f8d565b501561044e57565b614ca6906105d6565b5f614c7d565b614cb581614dc5565b6001600160a01b0381167fbc7cd75a20ee27fd9adebab32041f755214dbc6bffa90cc0225b39da2e5c2d3b5f80a2815115801590614d6d575b614cf6575050565b5f80613a81937f206661696c65640000000000000000000000000000000000000000000000000060408051614d2a816105ea565b602781527f416464726573733a206c6f772d6c6576656c2064656c65676174652063616c6c60208201520152602081519101845af4614d67612f8d565b91615686565b505f614cee565b614d7d81614dc5565b6001600160a01b0381167fbc7cd75a20ee27fd9adebab32041f755214dbc6bffa90cc0225b39da2e5c2d3b5f80a2815115801590614dbd57614cf6575050565b506001614cee565b803b1561044e576001600160a01b037f360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc91166001600160a01b0319825416179055565b614e128383615635565b6005819592951015612f5057159384614ed0575b508315614e4a575b50505015614e3857565b60405163938a182160e01b8152600490fd5b5f929350908291604051614e8281613b3b6020820194630b135d3f60e11b998a87526024840152604060448401526064830190611352565b51915afa90614e8f612f8d565b82614ec2575b82614ea5575b50505f8080614e2e565b614eba91925060208082518301019101613ba7565b145f80614e9b565b915060208251101591614e95565b6001600160a01b0383811691161493505f614e26565b905f806001600160a01b03614f3d9416927f5361666545524332303a206c6f772d6c6576656c2063616c6c206661696c65646020604051614f2681610598565b818152015260208151910182855af1614d67612f8d565b8051908115918215614f53575b50501561044e57565b819250906020918101031261044e5760200151614f6f81610bfa565b5f80614f4a565b906001600160a01b0390818116907f0000000000000000000000000000000000000000000000000000000000000000831682036150895750803b1561044e57604051632e1a7d4d60e01b815260048101849052905f908290602490829084905af1801561377c57615076575b50610c5a5491614ffb61086a546001600160a01b031690565b73420000000000000000000000000000000000001090813b1561044e57604051631474f2a960e31b81526001600160a01b03602087901c90951685166004820152931660248401526044830182905263ffffffff909316606483015260a060848301525f60a483018190529192839182908160c48101614b7c565b806139a2615083926105d6565b5f614fe2565b91807f0000000000000000000000000000000000000000000000000000000000000000161515806152b4575b156150d9575050506104ae906150d461086a546001600160a01b031690565b615449565b806151066150f9856001600160a01b03165f52610c5c60205260405f2090565b546001600160a01b031690565b16615290577342000000000000000000000000000000000000105b169061514561233d6150f9856001600160a01b03165f52610c5d60205260405f2090565b1561520a5783826151559261539c565b6151746150f9836001600160a01b03165f52610c5d60205260405f2090565b9061518861086a546001600160a01b031690565b91615199610c5a5463ffffffff1690565b823b1561044e5760405163540abf7360e01b81526001600160a01b0395861660048201529185166024830152929093166044840152606483019390935263ffffffff16608482015260c060a48201525f60c482018190529091829060e490829084905af1801561377c57614b8d5750565b509161521f61086a546001600160a01b031690565b92615230610c5a5463ffffffff1690565b93813b1561044e57604051631474f2a960e31b81526001600160a01b03948516600482015293166024840152604483019190915263ffffffff909216606482015260a060848201525f60a482018190529091829081838160c48101614b7c565b6152af6150f9846001600160a01b03165f52610c5c60205260405f2090565b615121565b50807f00000000000000000000000000000000000000000000000000000000000000001682146150b5565b604051636eb1769f60e11b815230600482015273bd80b06d3dbd0801132c6689429ac09ca6d27f82602482015290916020826044816001600160a01b0387165afa91821561377c575f9261537b575b5081018091116131505760405163095ea7b360e01b602082015273bd80b06d3dbd0801132c6689429ac09ca6d27f82602482015260448101919091526104ae916149618260648101614953565b61539591925060203d60201161118b5761117c8183610676565b905f61532e565b604051636eb1769f60e11b81523060048201526001600160a01b03831660248201529192602083806044810103816001600160a01b0386165afa92831561377c575f93615428575b5082018092116131505760405163095ea7b360e01b60208201526001600160a01b03909316602484015260448301919091526104ae91906149618260648101614953565b61544291935060203d60201161118b5761117c8183610676565b915f6153e4565b6001600160a01b03809116917f000000000000000000000000000000000000000000000000000000000000000090827f0000000000000000000000000000000000000000000000000000000000000000166154a582828561539c565b604090604051916332dd704760e21b83526020936004958585600481875afa94851561377c57869189915f97615616575b501697604051958680926352b7631960e11b8252816155088d600483019190916001600160a01b036020820193169052565b0392165afa93841561377c575f946155f7575b5092947f000000000000000000000000000000000000000000000000000000000000000093805b61555157505050505050505050565b6155a290878111156155f15787905b84516337e9a82760e11b815284810183815263ffffffff89166020820152604081018d90526001600160a01b038c166060820152909389918591829160800190565b03815f8a5af192831561377c576155be936155c4575b506137a4565b80615542565b6155e390893d8b116155ea575b6155db8183610676565b810190615666565b505f6155b8565b503d6155d1565b80615560565b61560f919450853d871161118b5761117c8183610676565b925f61551b565b61562e919750833d8511613775576137678183610676565b955f6154d6565b9060418151145f1461565d5761132d91602082015190606060408401519301515f1a906156af565b50505f90600290565b9081602091031261044e575167ffffffffffffffff8116810361044e5790565b90156156a057815115615697575090565b3b1561044e5790565b50805190811561044e57602001fd5b7f7fffffffffffffffffffffffffffffff5d576e7357a4501ddfe92f46681b20a0841161571f576020935f9360ff60809460405194855216868401526040830152606082015282805260015afa1561377c575f516001600160a01b0381161561571757905f90565b505f90600190565b505050505f9060039056fea264697066735822122081de8cafbdfc055aa138e7706e83912b790d1c719a65b618b872483c2da3859c64736f6c63430008170033",
- "deployedBytecode": "0x6080604052600436101561001a575b3615610018575f80fd5b005b5f3560e01c8063079bd2c71461043f5780630c5d5f731461043a5780630eaac9f0146104355780631186ec331461043057806311eac8551461042b57806315348e44146103b357806317fcb39b146104265780631b3d5559146104215780631fab657c1461041c578063272751c71461041757806329cb924d146104125780632e3781151461040d5780632e63e59a1461040857806333a84ff0146104035780633659cfe6146103fe578063431023b8146103f9578063437b9116146103f4578063490e49ef146103ef578063493a4f84146103ea5780634f1ef286146103e55780635249fef1146103e05780635285e058146103db57806352d1902d146103d6578063541f4f14146103d1578063577f51f8146103cc57806357f6dcb8146103c75780636068d6cb146103c2578063647c576c146103bd578063670fa8ac146103b85780636bbbcd2e146103b35780636e400983146103ae578063738b62e5146103a9578063766e0703146103a45780637aef642c1461039f5780637b9392321461039a5780637ef413e11461039557806382e2c43f146103905780638a7860ce1461038b5780638b15788e14610386578063927ede2d146103815780639748cf7c1461037c57806397943aa914610377578063979f2bc21461037257806399cc29681461036d5780639a8a059214610368578063a1244c6714610363578063a18a096e1461035e578063ac9650d814610359578063ad5425c614610354578063adb5a6a614610309578063b27a43001461034f578063b370b7f51461034a578063babb6aac14610345578063bf10268d14610340578063c35c83fc1461033b578063ceb4c98714610336578063d7e1583a14610331578063dda521131461032c578063ddd224f114610327578063de7eba7814610322578063deff4b241461031d578063e322921114610318578063ea86bd4614610313578063ee2a53f81461030e578063f79f29ed14610309578063fbbba9ac146103045763fc8a584f0361000e57612cc3565b612c3f565b6125fe565b612c01565b612afe565b612ad5565b6129e0565b6129b0565b612987565b612961565b61292b565b612831565b612806565b612782565b6126ab565b612684565b612645565b61249d565b6123fd565b612296565b61226f565b612255565b6121c0565b6120f2565b612072565b61202f565b612001565b611f83565b611f0b565b611df0565b611db9565b611d11565b611c71565b611c4d565b611bb8565b611b78565b610847565b611b3e565b611a67565b611a0f565b6119cf565b611831565b61176e565b611704565b6116dd565b61168f565b611561565b6114da565b6114bc565b6113ef565b611192565b611060565b611026565b610e2c565b610ccc565b610ca3565b610c04565b610af8565b6109ef565b610861565b610804565b610763565b610516565b6104b0565b610452565b5f91031261044e57565b5f80fd5b3461044e575f36600319011261044e57602060405163ffffffff7f0000000000000000000000000000000000000000000000000000000000000000168152f35b6001600160a01b0381160361044e57565b35906104ae82610492565b565b3461044e57602036600319011261044e5760206004356104cf81610492565b6001600160a01b038091165f52610c5d825260405f205416604051908152f35b63ffffffff81160361044e57565b61014435906104ae826104ef565b35906104ae826104ef565b3461044e57602036600319011261044e5763ffffffff600435610538816104ef565b6105406136d1565b610548613793565b16610c5a8163ffffffff198254161790557fe486a5c4bd7b36eabbfe274c99b39130277417be8d2209b4dae04c4fba64ee3a5f80a26001606555005b634e487b7160e01b5f52604160045260245ffd5b6040810190811067ffffffffffffffff8211176105b457604052565b610584565b6101a0810190811067ffffffffffffffff8211176105b457604052565b67ffffffffffffffff81116105b457604052565b6060810190811067ffffffffffffffff8211176105b457604052565b6080810190811067ffffffffffffffff8211176105b457604052565b6020810190811067ffffffffffffffff8211176105b457604052565b60e0810190811067ffffffffffffffff8211176105b457604052565b60a0810190811067ffffffffffffffff8211176105b457604052565b90601f8019910116810190811067ffffffffffffffff8211176105b457604052565b6040519060c0820182811067ffffffffffffffff8211176105b457604052565b60405190610180820182811067ffffffffffffffff8211176105b457604052565b604051906104ae826105b9565b604051906104ae82610606565b67ffffffffffffffff81116105b457601f01601f191660200190565b92919261071b826106f3565b916107296040519384610676565b82948184528183011161044e578281602093845f960137010152565b9080601f8301121561044e578160206107609335910161070f565b90565b61010036600319011261044e5760043561077c81610492565b60243561078881610492565b6084358060070b810361044e5760a435906107a2826104ef565b60c43567ffffffffffffffff811161044e576107c2903690600401610745565b926107cb613793565b60ff61086b5460e81c166107f2576107eb9460643591604435913361380e565b6001606555005b604051630b4cba3160e31b8152600490fd5b3461044e575f36600319011261044e5760206040516001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000168152f35b3461044e575f36600319011261044e5760206040515f8152f35b3461044e575f36600319011261044e5760206040516001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000168152f35b67ffffffffffffffff81116105b45760051b60200190565b9080601f8301121561044e5760209082356108d6816108a4565b936108e46040519586610676565b81855260208086019260051b82010192831161044e57602001905b82821061090d575050505090565b813581529083019083016108ff565b9080601f8301121561044e576020908235610936816108a4565b936109446040519586610676565b81855260208086019260051b82010192831161044e57602001905b82821061096d575050505090565b838091833561097b81610492565b81520191019061095f565b9291610991826108a4565b9161099f6040519384610676565b829481845260208094019160051b810192831161044e57905b8282106109c55750505050565b813581529083019083016109b8565b9080601f8301121561044e5781602061076093359101610986565b60031960603682011261044e57600435610a08816104ef565b60243567ffffffffffffffff9283821161044e5760c090823603011261044e57610a30610698565b908060040135825260248101356020830152604481013584811161044e57610a5e90600436918401016108bc565b6040830152610a6f6064820161050b565b6060830152610a80608482016104a3565b608083015260a48101359084821161044e576004610aa1923692010161091c565b60a082015260443592831161044e57610ac16100189336906004016109d4565b91612cf3565b9181601f8401121561044e5782359167ffffffffffffffff831161044e576020808501948460051b01011161044e57565b3461044e5760031960603682011261044e5760043567ffffffffffffffff80821161044e5760608236039384011261044e5760243590610b37826104ef565b60443590811161044e57610b4f903690600401610ac7565b919093610b5a613793565b600484013590610182190181121561044e57610bf094610beb93610b87610be4936004369189010161284f565b95610b9d610b986080890151613da4565b613a4d565b610ba687613604565b9060446020890151916101608a015193610bbe610698565b9a8b5260208b015201356040890152606088015260808701525f60a08701523691610986565b9083613dba565b613f0b565b6100186001606555565b8015150361044e57565b3461044e57606036600319011261044e57600435610c2181610492565b602435907f0a21fdd43d0ad0c62689ee7230a47309a050755bcc52eba00310add65297692a60206001600160a01b0360443593610c5d85610bfa565b610c656136d1565b610c6d613793565b1692835f5261086d825260405f20855f52825260405f209015159060ff1981541660ff8316179055604051908152a36001606555005b3461044e575f36600319011261044e576020604051428152f35b908161018091031261044e5790565b3461044e57604036600319011261044e5760043567ffffffffffffffff811161044e57610cfd903690600401610cbd565b610d0681612eeb565b6001600160a01b031690610d1c60208201612eeb565b6001600160a01b031691610d3260408301612eeb565b6001600160a01b0316610d4760608401612eeb565b6001600160a01b031692610d5d60808201612eeb565b6001600160a01b031690610100610d75818301612ef5565b9061012090610d85848301612ef5565b9261014094858101610d9690612ef5565b966101609a8b8301610da89084612eff565b9a909b610db36106b8565b9e8f91825260208201526040015260608d015260808c015260a081013560a08c015260c081013560c08c015260e0013560e08b015263ffffffff1690890152870190610e04919063ffffffff169052565b63ffffffff909116908501523690610e1b9261070f565b908201523360243561001892613635565b3461044e57602036600319011261044e576004803567ffffffffffffffff811161044e57610e5d9036908301610cbd565b610e65613793565b60ff61086b5460e01c166110165763ffffffff80421692610140830193610e9e81610e8f87612ef5565b63ffffffff9182169116101590565b61100657610120840192610eb184612ef5565b1610610ff757610ec9610ec4368561284f565b613604565b90610edd825f5261087260205260405f2090565b54610fe95750610f2c7f3cee3e290f36226751cd0b3321b213890fe9c768e922f267fa6111836ce05c3292610f27610f21610f32945f5261087260205260405f2090565b60019055565b612ef5565b93612ef5565b610f52610f4d610f46610160860186612eff565b369161070f565b6143e0565b90610fdc6040519283926101008701359760e08801359760208101359281359260408301359260c08101359060a081013590606060808201359101358b9693909a999895919261012098959361014089019c895260208901526040880152606087015263ffffffff80921660808701521660a085015260c084015260e08301526101008201520152565b0390a36100186001606555565b604051624be79160e21b8152fd5b60405163d642b7d960e01b8152fd5b50604051630277ae7b60e21b8152fd5b50604051633d90fc5560e11b8152fd5b3461044e575f36600319011261044e5760206040517f9c6dfd61d811b9950a4f2b9adf46357b717c816d22c420d0bde8f2360148f7cd8152f35b3461044e57602036600319011261044e5760043561107d81610492565b6001600160a01b03807f00000000000000000000000000000000000000000000000000000000000000001680301461044e577f360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc90828254160361044e576110e26136d1565b604051916110ef83610622565b5f83527f4910fdfa16fed3260ed0e7147f7cc6da11a60208b5b9406d12a635614ffd91435460ff16156111285750505061001890614dc5565b6020600491604051928380926352d1902d60e01b825288165afa5f9181611161575b50611153575f80fd5b0361044e5761001891614cac565b61118491925060203d60201161118b575b61117c8183610676565b810190613ba7565b905f61114a565b503d611172565b3461044e57608036600319011261044e576004356111af816104ef565b602435906111bc82610492565b6044356111c881610492565b606435916111d583610492565b60ff5f5460081c161561044e5761121c90610c5a624c4b4063ffffffff1982541617905561086b9063ffffffff60c01b1963ffffffff60c01b83549260c01b169116179055565b6040519061122982610598565b6009825260208201916820a1a927a9a996ab1960b91b8352640312e302e360dc1b602060405161125881610598565b60058152015260ff5f5460081c161561044e57610018946112bd936112b89251902061047f557f06c015bd22b4c69690933c1058878ebdfef31f9aaae40bbe86d8a09fe1b2972c610480556112ab614847565b6112b3614856565b61486a565b6148c4565b610c5a9077ffffffffffffffffffffffffffffffffffffffff000000001977ffffffffffffffffffffffffffffffffffffffff0000000083549260201b169116179055565b602060031982011261044e576004359067ffffffffffffffff821161044e5761132d91600401610ac7565b9091565b5f5b8381106113425750505f910152565b8181015183820152602001611333565b9060209161136b81518092818552858086019101611331565b601f01601f1916010190565b6020808201908083528351809252604092604081018260408560051b8401019601945f925b8584106113ad575050505050505090565b9091929394959685806113de600193603f1986820301885286838d5180511515845201519181858201520190611352565b99019401940192959493919061139c565b3461044e576113fd36611302565b611406816108a4565b9160406114166040519485610676565b828452601f19611425846108a4565b015f5b8181106114995750505f5b83811061144c57604051806114488782611377565b0390f35b8061149361145c60019388612f55565b515f8061146a858a8a612f69565b90611479895180938193612f80565b0390305af490611487612f8d565b60208201529015159052565b01611433565b60209083516114a781610598565b5f815282606081830152828901015201611428565b3461044e575f36600319011261044e5760206040516301e133808152f35b3461044e57604036600319011261044e576024356004356114f96136d1565b611501613793565b61086c8054680100000000000000008110156105b45763ffffffff916001820190558361152d82612bc2565b5084600182015555167fc86ba04c55bc5eb2f2876b91c438849a296dbec7b08751c3074d92e04f0a77af5f80a46001606555005b604036600319011261044e5760043561157981610492565b60243567ffffffffffffffff811161044e57611599903690600401610745565b6001600160a01b03807f0000000000000000000000000000000000000000000000000000000000000000169081301461044e577f360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc91818354160361044e576115ff6136d1565b7f4910fdfa16fed3260ed0e7147f7cc6da11a60208b5b9406d12a635614ffd91435460ff16156116355750505061001890614dc5565b6020600491604051928380926352d1902d60e01b825288165afa5f918161166e575b50611660575f80fd5b0361044e5761001891614d74565b61168891925060203d60201161118b5761117c8183610676565b905f611657565b3461044e57604036600319011261044e576001600160a01b036004356116b481610492565b165f5261086d60205260405f206024355f52602052602060ff60405f2054166040519015158152f35b3461044e575f36600319011261044e5760206001600160a01b036108695416604051908152f35b3461044e575f36600319011261044e576001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016300361044e5760206040517f360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc8152f35b61012036600319011261044e5760043561178781610492565b6024359061179482610492565b604435916117a183610492565b60a4358060070b810361044e5760c435916117bb836104ef565b60e43567ffffffffffffffff811161044e576117db903690600401610745565b936117e4613793565b60ff61086b5460e81c166107f2576107eb95608435926064359261380e565b9181601f8401121561044e5782359167ffffffffffffffff831161044e576020838186019501011161044e57565b3461044e5760c036600319011261044e5760043561184e81610492565b6024356044359160643561186181610492565b67ffffffffffffffff9160843583811161044e57611883903690600401611803565b60a49491943591821161044e577f45e04bc8f121ba11466985789ca2822a91109f31bb8ac85504a37b7eaf873c26946118c36119ca933690600401611803565b9290916001600160a01b038097168a6119be6118e036868661070f565b60428d6118ee368b8b61070f565b92602081519101209460409586519160208301937f9c6dfd61d811b9950a4f2b9adf46357b717c816d22c420d0bde8f2360148f7cd85528884015246606084015260808301528760a083015260c082015260c0815261194c8161063e565b51902061047f546104805486519060208201927fc2f8787176b8ac6bf7215b4adcc1e069bf4ab82d9ab1df05a57a91d425935b6e84528883015260608201524660808201526080815261199e8161065a565b5190209085519161190160f01b835260028301526022820152208a614e08565b51978897169a87612fdc565b0390a3005b3461044e575f36600319011261044e57602060405163ffffffff7f0000000000000000000000000000000000000000000000000000000000000000168152f35b3461044e575f36600319011261044e57602060ff61086b5460e81c166040519015158152f35b606090600319011261044e57600435611a4d816104ef565b90602435611a5a81610492565b9060443561076081610492565b3461044e57611a7536611a35565b5f54600881901c60ff1615939290849081611b30575b8115611b10575b501561044e57611ab69284611aad600160ff195f5416175f55565b611af95761300f565b611abc57005b611aca61ff00195f54165f55565b604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb384740249890602090a1005b611b0b61010061ff00195f5416175f55565b61300f565b303b15915081611b22575b505f611a92565b6001915060ff16145f611b1b565b600160ff8216109150611a8b565b3461044e575f36600319011261044e5760206040517f8d1994e2bbbd77564cdca06dd819e7ee2a5efa06c80dcb59a4a7b6e39edc538f8152f35b3461044e575f36600319011261044e57602060405163ffffffff7f0000000000000000000000000000000000000000000000000000000000000000168152f35b3461044e57602036600319011261044e577fe88463c2f254e2b070013a2dc7ee1e099f9bc00534cbdf03af551dc26ae492196020600435611bf881610bfa565b611c006136d1565b611c08613793565b151561086b80547fffff00ffffffffffffffffffffffffffffffffffffffffffffffffffffffffff60ff60e81b8460e81b169116179055604051908152a16001606555005b3461044e575f36600319011261044e57602063ffffffff610c5a5416604051908152f35b61016036600319011261044e57600435611c8a81610492565b60243590611c9782610492565b604435611ca381610492565b60643590611cb082610492565b60e435611cbc81610492565b6101043590611cca826104ef565b6101243592611cd8846104ef565b610144359667ffffffffffffffff881161044e57611cfd610018983690600401611803565b97909660c4359360a4359360843593613155565b61018036600319011261044e57600435611d2a81610492565b60243590611d3782610492565b604435611d4381610492565b60643590611d5082610492565b60e435611d5c81610492565b61010435611d69816104ef565b6101243591611d77836104ef565b611d7f6104fd565b93610164359767ffffffffffffffff891161044e57611da5610018993690600401611803565b98909760c4359360a4359360843593613177565b3461044e57606036600319011261044e576020611de8600435611ddb81610492565b6044359060243590613292565b604051908152f35b3461044e57606036600319011261044e5767ffffffffffffffff60243581811161044e57611e22903690600401611803565b9160443590811161044e57611e3b903690600401611803565b9060405193602085019480611e524684888a6132ce565b0395611e66601f1997888101845283610676565b6004359151902003611ef9575f94611e95611eb793611e8c87611ec3958a990190612905565b958101906132eb565b519360405193849160208301966337bfd2c960e21b88523391602485016133b3565b03908101835282610676565b5190305af4611ed0612f8d565b9015611ed857005b60405163b8fe37a760e01b8152908190611ef590600483016133d5565b0390fd5b604051630f0c8f4760e11b8152600490fd5b3461044e57602036600319011261044e57600435611f276136d1565b611f2f613793565b611f3881612bc2565b611f70576001815f80935501557f7c1af0646963afc3343245b103731965735a893347bfa0d58a5dc77a77ae691c5f80a26001606555005b634e487b7160e01b5f525f60045260245ffd5b6101a036600319011261044e5761012435611f9d816104ef565b61014435611faa816104ef565b6101643591611fb8836104ef565b610184359267ffffffffffffffff841161044e57611fdd610018943690600401611803565b9390926101043560e43560c43560a4356084356064356044356024356004356133e6565b3461044e575f36600319011261044e5760206040517342000000000000000000000000000000000000078152f35b3461044e575f36600319011261044e5760206040516001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000168152f35b3461044e5760e036600319011261044e5767ffffffffffffffff60043581811161044e576120a4903690600401610cbd565b60a43582811161044e576120bc903690600401611803565b60c49291923593841161044e576120da610018943690600401611803565b9390926084359060643590604435906024359061345e565b3461044e5761210036611a35565b909160ff5f5460081c161561044e576121369061086b9063ffffffff60c01b1963ffffffff60c01b83549260c01b169116179055565b60405161214281610598565b6009815260208101926820a1a927a9a996ab1960b91b8452640312e302e360dc1b602060405161217181610598565b60058152015260ff5f5460081c161561044e57610018936112b89251902061047f557f06c015bd22b4c69690933c1058878ebdfef31f9aaae40bbe86d8a09fe1b2972c610480556112ab614847565b3461044e57602036600319011261044e577f2d5b62420992e5a4afce0e77742636ca2608ef58289fd2e1baa5161ef6e7e41e602060043561220081610bfa565b6122086136d1565b612210613793565b151561086b80547fffffff00ffffffffffffffffffffffffffffffffffffffffffffffffffffffff60ff60e01b8460e01b169116179055604051908152a16001606555005b3461044e575f36600319011261044e576020604051468152f35b3461044e575f36600319011261044e57602063ffffffff61086b5460c01c16604051908152f35b3461044e57604036600319011261044e576004356024356122b682614bd0565b6001600160a01b0382165f526108736020526122e560405f20336001600160a01b03165f5260205260405f2090565b54918215612388575f61232c336123166122fe85613da4565b6001600160a01b03165f5261087360205260405f2090565b906001600160a01b03165f5260205260405f2090565b556123588361234961233d84613da4565b6001600160a01b031690565b61235285613da4565b9061491e565b60405192835233927f6c172ea51018fb2eb2118f3f8a507c4df71eb519b8c0052834dc3c920182fef490602090a4005b6040516336542bf760e21b8152600490fd5b6020808201906020835283518092526040830192602060408460051b8301019501935f915b8483106123cf5750505050505090565b90919293949584806123ed600193603f198682030187528a51611352565b98019301930191949392906123bf565b3461044e5761240b36611302565b9061241582613547565b915f5b81811061242d5760405180611448868261239a565b5f8061243a838587612f69565b9061244a60405180938193612f80565b0390305af4612457612f8d565b901561247d579060019161246b8287612f55565b526124768186612f55565b5001612418565b604481511061044e5780600461044e920151602480918301019101613590565b6101808060031936011261044e57610104356124b8816104ef565b61012435916124c6836104ef565b61014435926124d4846104ef565b6101643567ffffffffffffffff811161044e576124f5903690600401611803565b6124fd613793565b61086b549260ff8460e81c166107f257610bf0966125c2610f46926125b463ffffffff6125d09860c01c16996125586125358c6135ef565b61086b9063ffffffff60c01b1963ffffffff60c01b83549260c01b169116179055565b6125606106d9565b9a6004358c5260243560208d015260443560408d015260643560608d015260843560808d015260a43560a08d015260c43560c08d015260e43560e08d01526101008c01526101208b019063ffffffff169052565b63ffffffff16610140890152565b63ffffffff16610160870152565b90820152614527565b604090600319011261044e576004356125f181610492565b9060243561076081610492565b3461044e57602061263c6001600160a01b03612619366125d9565b91165f52610873835260405f20906001600160a01b03165f5260205260405f2090565b54604051908152f35b3461044e57602036600319011261044e57602060043561266481610492565b6001600160a01b038091165f52610c5c825260405f205416604051908152f35b3461044e575f36600319011261044e5760206001600160a01b0361086a5416604051908152f35b3461044e5760c036600319011261044e5760043560243567ffffffffffffffff60643560443560843583811161044e576126e9903690600401611803565b60a49491943591821161044e577f45e04bc8f121ba11466985789ca2822a91109f31bb8ac85504a37b7eaf873c2694612729612778933690600401611803565b929091612734613793565b61273d8a614bd0565b61276c898b898961274f36888861070f565b9261275b368b8b61070f565b946001600160a01b034692166143f5565b60405196879687612fdc565b0390a36001606555005b3461044e57612790366125d9565b906127996136d1565b6127a1613793565b6001600160a01b0380911691825f52610c5d6020526127d98160405f20906001600160a01b03166001600160a01b0319825416179055565b16907fcb84c2022106a6f2b6f805d446f32fbfd2a528474364fa755f37dac1c0c1b6c85f80a36001606555005b3461044e57602036600319011261044e576004355f52610872602052602060405f2054604051908152f35b3461044e575f36600319011261044e57602060405163ffffffff8152f35b91906101808382031261044e576128646106b8565b92803584526020810135602085015260408101356040850152606081013560608501526080810135608085015260a081013560a085015260c081013560c085015260e081013560e085015261010080820135908501526101206128c881830161050b565b908501526101406128da81830161050b565b90850152610160918282013567ffffffffffffffff811161044e576128ff9201610745565b90830152565b9060208282031261044e57813567ffffffffffffffff811161044e57610760920161284f565b3461044e57602036600319011261044e5760043567ffffffffffffffff811161044e57611de8610ec4602092369060040161284f565b3461044e575f36600319011261044e57602060ff61086b5460e01c166040519015158152f35b3461044e575f36600319011261044e5760206040516ec097ce7bc90715b34b9f10000000008152f35b3461044e57602036600319011261044e576107eb6004356129d081610492565b6129d86136d1565b6112b3613793565b3461044e57606036600319011261044e5760043567ffffffffffffffff811161044e57612a1190369060040161284f565b612a19613793565b60ff61086b5460e01c16612ac35761014081015163ffffffff4281169116101580612aa4575b612a925780612a50610bf092613604565b60c082015160208301519061016084015192612a6a610698565b948552602085015260408401526060830152608082015260243560a08201526044359061417f565b604051630c3a9b9d60e41b8152600490fd5b50612ab26040820151613da4565b6001600160a01b0316331415612a3f565b604051633d90fc5560e11b8152600490fd5b3461044e575f36600319011261044e576020610c5a546001600160a01b0360405191831c168152f35b6101608060031936011261044e5761010435612b19816104ef565b61012435612b26816104ef565b6101443567ffffffffffffffff811161044e57612b47903690600401611803565b63ffffffff94612b5a8642169586613138565b93612b63613793565b61086b549160ff8360e81c166107f257612b96612ba3966125b4610bf09a610f469660c01c16996125586125358c6135ef565b86019063ffffffff169052565b610180820152614527565b634e487b7160e01b5f52603260045260245ffd5b61086c908154811015612bfc576003915f52027f71cd7344f4eb2efc8e30291f6dbdb44d618ca368ea5425d217c1d604bf26b84d01905f90565b612bae565b3461044e57602036600319011261044e5760043561086c5481101561044e57612c2b604091612bc2565b506001815491015482519182526020820152f35b3461044e57612c4d366125d9565b90612c566136d1565b612c5e613793565b6001600160a01b0380911691825f52610c5c602052612c968160405f20906001600160a01b03166001600160a01b0319825416179055565b16907ff3dc137d2246f9b8abd0bb821e185ba01122c9b3ea3745ffca6208037674d6705f80a36001606555005b3461044e57602036600319011261044e576107eb600435612ce381610492565b612ceb6136d1565b6112b8613793565b91612cfc613793565b6080820191612d15610b9884516001600160a01b031690565b602081019182514603612e1c57612d3d612d4191836001612d3589612bc2565b500154613ac0565b1590565b612e0a578060607ff4ad92585b1bc117fbdd644990adf0827bc4c95baeae8a23322af807b6d0020e920193612d83612d7d865163ffffffff1690565b87613b52565b612dfd845194835193612de2612dd4612dc360408401998a51612daa8d5163ffffffff1690565b89516001600160a01b03169160a088019b8c5194613bc3565b925193519851995163ffffffff1690565b94516001600160a01b031690565b945163ffffffff9586604051978897169b1699339487612e9d565b0390a46104ae6001606555565b60405163582f497d60e11b8152600490fd5b604051633d23e4d160e11b8152600490fd5b9081518082526020808093019301915f5b828110612e4d575050505090565b835185529381019392810192600101612e3f565b9081518082526020808093019301915f5b828110612e80575050505090565b83516001600160a01b031685529381019392810192600101612e72565b9496959193612ebf60a095612edd93885260c0602089015260c0880190612e2e565b906001600160a01b0380951660408801528682036060880152612e61565b951515608085015216910152565b3561076081610492565b35610760816104ef565b903590601e198136030182121561044e570180359067ffffffffffffffff821161044e5760200191813603831361044e57565b634e487b7160e01b5f52602160045260245ffd5b60031115612f5057565b612f32565b8051821015612bfc5760209160051b010190565b90821015612bfc5761132d9160051b810190612eff565b908092918237015f815290565b3d15612fb7573d90612f9e826106f3565b91612fac6040519384610676565b82523d5f602084013e565b606090565b908060209392818452848401375f828201840152601f01601f1916010190565b9492909361300192610760979587526020870152608060408701526080860191612fbc565b926060818503910152612fbc565b91909160ff5f5460081c161561044e5761305990610c5a624c4b4063ffffffff1982541617905561086b9063ffffffff60c01b1963ffffffff60c01b83549260c01b169116179055565b60405161306581610598565b6009815260208101926820a1a927a9a996ab1960b91b8452640312e302e360dc1b602060405161309481610598565b60058152015260ff5f5460081c161561044e576130e3936112b89251902061047f557f06c015bd22b4c69690933c1058878ebdfef31f9aaae40bbe86d8a09fe1b2972c610480556112ab614847565b6104ae610c5a77deaddeaddeaddeaddeaddeaddeaddeaddead00000000000077ffffffffffffffffffffffffffffffffffffffff0000000019825416179055565b634e487b7160e01b5f52601160045260245ffd5b91909163ffffffff8080941691160191821161315057565b613124565b96949290916104ae9b9a999896949261317563ffffffff42169889613138565b985b9593919b999897969492909b61318b613793565b61086b549660ff8860e81c166107f2578760c01c63ffffffff166131ae906135ef565b6131d59061086b9063ffffffff60c01b1963ffffffff60c01b83549260c01b169116179055565b6131dd6106d9565b9d6001600160a01b038f921682526001600160a01b031690602001526001600160a01b031660408d01526001600160a01b031660608c015260808b015260a08a015260c08901526001600160a01b031660e088015260c01c63ffffffff16610100870152610120860190613256919063ffffffff169052565b63ffffffff1661014085015263ffffffff1661016084015236906132799261070f565b61018082015261328890614527565b6104ae6001606555565b916040519160208301936bffffffffffffffffffffffff199060601b16845260348301526054820152605481526132c881610606565b51902090565b9392916020916132e691604087526040870191612fbc565b930152565b9081602091031261044e57604051906020820182811067ffffffffffffffff8211176105b45760405235815290565b6107609161018090825181526020830151602082015260408301516040820152606083015160608201526080830151608082015260a083015160a082015260c083015160c082015260e083015160e0820152610100808401519082015261338f610120808501519083019063ffffffff169052565b6101408381015163ffffffff16908201528161016080940151938201520190611352565b6133cb6040929594939560608352606083019061331a565b9460208201520152565b906020610760928181520190611352565b9c9a99989796959493929190966133fb613793565b60ff61086b5460e81c166107f257613414908e33613292565b96604051809e613423826105b9565b81526020015260408d015260608c015260808b015260a08a015260c089015260e088015261010087015263ffffffff16610120860152613256565b97929095939196949761346f613793565b60ff61086b5460e01c16612ac35761348a6101408201612ef5565b63ffffffff8042169116101580613528575b612a9257613511613523966135096132889b6134bb610ec4368761284f565b9a6134c4610698565b9b6134cf368861284f565b8d5260208d01528660408d01528760608d01526134ed368b8461070f565b60808d015260a08c01526135018535613da4565b98369161070f565b95369161070f565b9461010060e0830135920135906143f5565b61417f565b506135366040820135613da4565b6001600160a01b031633141561349c565b90613551826108a4565b61355e6040519182610676565b828152809261356f601f19916108a4565b01905f5b82811061357f57505050565b806060602080938501015201613573565b60208183031261044e5780519067ffffffffffffffff821161044e570181601f8201121561044e5780516135c3816106f3565b926135d16040519485610676565b8184526020828401011161044e576107609160208085019101611331565b63ffffffff8091169081146131505760010190565b6040516132c881613621602082019460408652606083019061331a565b46604083015203601f198101835282610676565b919091613640613793565b60ff61086b5460e01c16612ac35761014081015163ffffffff42811691161015806136b2575b612a92576132889261367782613604565b60c083015160208401519061016085015192613691610698565b958652602086015260408501526060840152608083015260a082015261417f565b506136c06040820151613da4565b6001600160a01b0316331415613666565b73420000000000000000000000000000000000000780330361378157602060049160405192838092636e296e4560e01b82525afa90811561377c575f9161374d575b506001600160a01b0361373261233d610869546001600160a01b031690565b91160361373b57565b6040516336a816d960e01b8152600490fd5b61376f915060203d602011613775575b6137678183610676565b810190614966565b5f613713565b503d61375d565b6137b1565b60405163253a6fc960e11b8152600490fd5b60026065541461044e576002606555565b9190820391821161315057565b6040513d5f823e3d90fd5b926107609695929491946101409585525f60208601526040850152606084015263ffffffff809116608084015260a08301525f60c083015260e08201525f610100820152816101208201520190611352565b9193949690959661384f612d3d6138488861383b896001600160a01b03165f5261086d60205260405f2090565b905f5260205260405f2090565b5460ff1690565b613a3b5760070b906706f05b59d3b200006138698361497b565b1015613a29576ec097ce7bc90715b34b9f10000000008411613a175763ffffffff93613897858a16426137a4565b857f00000000000000000000000000000000000000000000000000000000000000001610613a055761086b5460c01c63ffffffff16986138d96125358b6135ef565b6001600160a01b039586807f000000000000000000000000000000000000000000000000000000000000000016981692888414806139fc575b156139c0578034036139ae57883b1561044e575f6004996040519a8b8092630d0e30db60e41b825234905af198891561377c5761397d613990978a927f32ed1a409ef04c7b0227189c3a103dc5ac10e775a15b785dcc510201f7c25ad39c613995575b505b836149c9565b92604051998a99169d169b1693876137bc565b0390a4565b806139a26139a8926105d6565b80610444565b5f613975565b604051636452a35d60e01b8152600490fd5b7f32ed1a409ef04c7b0227189c3a103dc5ac10e775a15b785dcc510201f7c25ad398508761397d613990976139f78430338a61498a565b613977565b50341515613912565b60405163f722177f60e01b8152600490fd5b60405163622db5a960e11b8152600490fd5b60405163284f109760e21b8152600490fd5b604051632a58c4f360e01b8152600490fd5b6001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000811691168114613a84575b50565b47613a8c5750565b4790803b1561044e575f90600460405180948193630d0e30db60e41b83525af1801561377c5715613a81576104ae906105d6565b6107609291604051613b4981613b3b602082019460208652805160408401526020810151606084015260a0613b05604083015160c06080870152610100860190612e2e565b606083015163ffffffff168583015260808301516001600160a01b031660c0860152910151838203603f190160e0850152612e61565b03601f198101835282610676565b519020916149ff565b613b5d600291612bc2565b500162ffffff8260081c16805f5281602052600160ff60405f205494161b8080941614613b95575f5260205260405f20908154179055565b60405163954476d960e01b8152600490fd5b9081602091031261044e575190565b9190820180921161315057565b91959495939092935f9681519081815103613d925781613c42575b50505082613bed575b50505050565b6001600160a01b0381613c217ffa7fa7cf6d7dde5f9be65a67e6a1a747e7aa864dcd2d793353c722d80fbbb3579386614ac2565b6040805195865233602087015291169463ffffffff1693a45f808080613be7565b604080516370a0823160e01b81523060048083019190915291906020816024816001600160a01b038b165afa90811561377c575f91613d73575b505f805b868110613c91575050505050613bde565b613c9b8189612f55565b51613ca9575b600101613c80565b90613cbf90613cb8838a612f55565b5190613bb6565b90828211613d6357613cf9612d3d613ce7613cda848a612f55565b516001600160a01b031690565b613cf1848c612f55565b51908c614a50565b15613ca1579c5087613d59613d518f613d3c613cda613d35613d1b848f612f55565b51966001600160a01b03165f5261087360205260405f2090565b928b612f55565b6001600160a01b03165f5260205260405f2090565b918254613bb6565b905560019c613ca1565b50505051632ddaa83160e11b8152fd5b613d8c915060203d60201161118b5761117c8183610676565b5f613c7c565b6040516319a5316760e31b8152600490fd5b6001600160a01b0390613db681614bd0565b1690565b91612d3d90613e3392845160408096015191865191613dd8836105ea565b8252613b49613df36020840192468452898501958652612bc2565b5054938851928391613e186020840196602088525160608d86015260a085019061331a565b9151606084015251608083015203601f198101835282610676565b613e3a5750565b5163582f497d60e11b8152600490fd5b613e5382612f46565b52565b9a989693919c9b9997959492909c6101e08c019d8c5260208c015260408b015260608a0152608089015263ffffffff80921660a08901521660c087015260e08601526101008501526101208401526101408301528051610160830152602081015161018083015260408101516101a08301526060015190613ed682612f46565b6101c00152565b9061076094936080936001600160a01b03809316845260208401521660408201528160608201520190611352565b905f82516101208101613f22815163ffffffff1690565b63ffffffff4291161061416d576020850151906002613f4a835f5261087260205260405f2090565b541461415b57613f6486925f5261087260205260405f2090565b6002905560608301519060808401519160a08501519260c0860151918560a0810151938860e0810151956101008201519751613fa39063ffffffff1690565b61014083015163ffffffff166040840151918451936020860151956101600151613fcc906143e0565b966060890151986080019e8f51613fe2906143e0565b906040015190613ff06106e6565b9a8b5260208b015260408a0152600260608a01526040519d8e9b6140149b8d613e56565b037f44b559f101f8fbcc8a0ea43fa91a05a729a5ea6e14a7c75aa750374690137208905f94a4608082015161404890613da4565b906040860151956060015161405c90613da4565b926080015161406a90613da4565b6001600160a01b03919082167f00000000000000000000000000000000000000000000000000000000000000008316036141465784614133575b6140b087838616614beb565b51928351151580614129575b6140ca575b50505050509050565b1690813b1561412557836140f8959660405196879586948593633a5be8cb60e01b8552339160048601613edd565b03925af1801561377c57614112575b8080808085946140c1565b806139a261411f926105d6565b5f614107565b8380fd5b50803b15156140bc565b61414187303385871661498a565b6140a4565b5f9450614156878585851661491e565b6140b0565b604051630479306360e51b8152600490fd5b60405163d642b7d960e01b8152600490fd5b8051916101208301614195815163ffffffff1690565b63ffffffff4291161061416d57602083015160016141bc825f5261087260205260405f2090565b54036143d9576001905b60026141db825f5261087260205260405f2090565b541461415b576141f76141fd915f5261087260205260405f2090565b60029055565b7f44b559f101f8fbcc8a0ea43fa91a05a729a5ea6e14a7c75aa75037469013720860608601516080870151906142ca8760a08a0151958a60c08101519760a08401519860e08301519961425a6101008501519c5163ffffffff1690565b61014085015163ffffffff16916040860151938651956142be61428661016060208b01519a01516143e0565b9960608c01519b604061429c60808301516143e0565b9101519060206142aa6106e6565b9e8f528e015260408d015260608c01613e4a565b6040519c8d9c8d613e56565b0390a46142da6080830151613da4565b9160408201519160806142fc816142f46060850151613da4565b940151613da4565b6001600160a01b03929083167f00000000000000000000000000000000000000000000000000000000000000008416036143c65761433e853033868a1661498a565b61434a85848616614beb565b01519182511515806143bc575b614363575b5050505050565b16803b1561044e57614391935f809460405196879586948593633a5be8cb60e01b8552339160048601613edd565b03925af1801561377c576143a9575b8080808061435c565b806139a26143b6926105d6565b5f6143a0565b50803b1515614357565b6143d4858533868a1661498a565b61434a565b5f906141c6565b805190816143ee5750505f90565b6020012090565b93926042936104ae979660208151910120906040519260208401947f8d1994e2bbbd77564cdca06dd819e7ee2a5efa06c80dcb59a4a7b6e39edc538f86526040850152856060850152608084015260a083015260c082015260c0815261445a8161063e565b5190209061047f549061048054906040519160208301937fc2f8787176b8ac6bf7215b4adcc1e069bf4ab82d9ab1df05a57a91d425935b6e8552604084015260608301526080820152608081526144b08161065a565b519020906040519161190160f01b8352600283015260228201522090614e08565b96926107609a9996949198959261014099895260208901526040880152606087015263ffffffff928380921660808801521660a08601521660c084015260e0830152610100820152816101208201520190611352565b6145318151614bd0565b6040908181019061455d6145458351613da4565b6001600160a01b03165f5261086d60205260405f2090565b9261457a612d3d61384860c085019687515f5260205260405f2090565b6148375761012082019261459e614595855163ffffffff1690565b63ffffffff1690565b8042109081156147fe575b506147ed576101408301926145c2845163ffffffff1690565b9163ffffffff92836145f6817f00000000000000000000000000000000000000000000000000000000000000001642613bb6565b9116116147dc5761016082015163ffffffff169280841680614798575b50508051936001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000168095148061478f575b15614729576080830151340361471957843b1561044e575f600495825196878092630d0e30db60e41b825234905af191821561377c577f32ed1a409ef04c7b0227189c3a103dc5ac10e775a15b785dcc510201f7c25ad39561399093614706575b505b519260608101519460808201519060a08301519a51986146e66146db6101008601519c5163ffffffff1690565b915163ffffffff1690565b9084519c60208601519461018060e088015197015197519a8b9a8b6144d1565b806139a2614713926105d6565b5f6146ac565b51636452a35d60e01b8152600490fd5b919293503461477e577f32ed1a409ef04c7b0227189c3a103dc5ac10e775a15b785dcc510201f7c25ad39392918161477961476a61233d6139909551613da4565b6080860151903090339061498a565b6146ae565b8151636452a35d60e01b8152600490fd5b5034151561464b565b6301e1338010156147c7575b5060e0820151156147b6575f80614613565b835163495d907f60e01b8152600490fd5b926147d59193421690613138565b915f6147a4565b835163582e388960e01b8152600490fd5b815163f722177f60e01b8152600490fd5b6148099150426137a4565b63ffffffff7f000000000000000000000000000000000000000000000000000000000000000016105f6145a9565b51632a58c4f360e01b8152600490fd5b60ff5f5460081c161561044e57565b60ff5f5460081c161561044e576001606555565b6001600160a01b031680156148b257610869816001600160a01b03198254161790557fa9e8c42c9e7fca7f62755189a16b2f5314d43d8fb24e91ba54e6d65f9314e8495f80a2565b60405163ba97b39d60e01b8152600490fd5b6001600160a01b0316801561490c5761086a816001600160a01b03198254161790557fa73e8909f8616742d7fe701153d82666f7b7cd480552e23ebb05d358c22fd04e5f80a2565b604051635b03092b60e11b8152600490fd5b60405163a9059cbb60e01b60208201526001600160a01b03909216602483015260448201929092526104ae9161496182606481015b03601f198101845283610676565b614ee6565b9081602091031261044e575161076081610492565b5f81126149855790565b5f0390565b90926104ae93604051936323b872dd60e01b60208601526001600160a01b0380921660248601521660448401526064830152606482526149618261065a565b90670de0b6b3a7640000915f82840392128383128116908484139015161761315057818102918183041490151715613150570490565b929091905f915b8451831015614a4857614a198386612f55565b519081811015614a37575f52602052600160405f205b920191614a06565b905f52602052600160405f20614a2f565b915092501490565b60405163a9059cbb60e01b60208281019182526001600160a01b039094166024830152604482019490945290925f91614a8c8160648101613b3b565b519082855af1903d5f519083614aa3575b50505090565b91925090614ab857503b15155b5f8080614a9d565b6001915014614ab0565b907f0000000000000000000000000000000000000000000000000000000000000000906001600160a01b03808316818316149081614ba5575b5015614b9a575081614b0c916152df565b61086a546001600160a01b0316610c5a5463ffffffff1673bd80b06d3dbd0801132c6689429ac09ca6d27f82803b1561044e5760405163262cc5ab60e11b81526001600160a01b039093166004840152602483019390935263ffffffff166044820152905f908290818381606481015b03925af1801561377c57614b8d5750565b806139a26104ae926105d6565b90506104ae91614f76565b90507f000000000000000000000000000000000000000000000000000000000000000016155f614afb565b60a01c614bd957565b6040516379ec0ed760e11b8152600490fd5b6001600160a01b0390811690813b15614c2b57906104ae92917f00000000000000000000000000000000000000000000000000000000000000001661491e565b7f000000000000000000000000000000000000000000000000000000000000000016803b1561044e575f8091602460405180948193632e1a7d4d60e01b83528860048401525af1801561377c57614c9d575b5081471061044e575f80809381935af1614c95612f8d565b501561044e57565b614ca6906105d6565b5f614c7d565b614cb581614dc5565b6001600160a01b0381167fbc7cd75a20ee27fd9adebab32041f755214dbc6bffa90cc0225b39da2e5c2d3b5f80a2815115801590614d6d575b614cf6575050565b5f80613a81937f206661696c65640000000000000000000000000000000000000000000000000060408051614d2a816105ea565b602781527f416464726573733a206c6f772d6c6576656c2064656c65676174652063616c6c60208201520152602081519101845af4614d67612f8d565b91615686565b505f614cee565b614d7d81614dc5565b6001600160a01b0381167fbc7cd75a20ee27fd9adebab32041f755214dbc6bffa90cc0225b39da2e5c2d3b5f80a2815115801590614dbd57614cf6575050565b506001614cee565b803b1561044e576001600160a01b037f360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc91166001600160a01b0319825416179055565b614e128383615635565b6005819592951015612f5057159384614ed0575b508315614e4a575b50505015614e3857565b60405163938a182160e01b8152600490fd5b5f929350908291604051614e8281613b3b6020820194630b135d3f60e11b998a87526024840152604060448401526064830190611352565b51915afa90614e8f612f8d565b82614ec2575b82614ea5575b50505f8080614e2e565b614eba91925060208082518301019101613ba7565b145f80614e9b565b915060208251101591614e95565b6001600160a01b0383811691161493505f614e26565b905f806001600160a01b03614f3d9416927f5361666545524332303a206c6f772d6c6576656c2063616c6c206661696c65646020604051614f2681610598565b818152015260208151910182855af1614d67612f8d565b8051908115918215614f53575b50501561044e57565b819250906020918101031261044e5760200151614f6f81610bfa565b5f80614f4a565b906001600160a01b0390818116907f0000000000000000000000000000000000000000000000000000000000000000831682036150895750803b1561044e57604051632e1a7d4d60e01b815260048101849052905f908290602490829084905af1801561377c57615076575b50610c5a5491614ffb61086a546001600160a01b031690565b73420000000000000000000000000000000000001090813b1561044e57604051631474f2a960e31b81526001600160a01b03602087901c90951685166004820152931660248401526044830182905263ffffffff909316606483015260a060848301525f60a483018190529192839182908160c48101614b7c565b806139a2615083926105d6565b5f614fe2565b91807f0000000000000000000000000000000000000000000000000000000000000000161515806152b4575b156150d9575050506104ae906150d461086a546001600160a01b031690565b615449565b806151066150f9856001600160a01b03165f52610c5c60205260405f2090565b546001600160a01b031690565b16615290577342000000000000000000000000000000000000105b169061514561233d6150f9856001600160a01b03165f52610c5d60205260405f2090565b1561520a5783826151559261539c565b6151746150f9836001600160a01b03165f52610c5d60205260405f2090565b9061518861086a546001600160a01b031690565b91615199610c5a5463ffffffff1690565b823b1561044e5760405163540abf7360e01b81526001600160a01b0395861660048201529185166024830152929093166044840152606483019390935263ffffffff16608482015260c060a48201525f60c482018190529091829060e490829084905af1801561377c57614b8d5750565b509161521f61086a546001600160a01b031690565b92615230610c5a5463ffffffff1690565b93813b1561044e57604051631474f2a960e31b81526001600160a01b03948516600482015293166024840152604483019190915263ffffffff909216606482015260a060848201525f60a482018190529091829081838160c48101614b7c565b6152af6150f9846001600160a01b03165f52610c5c60205260405f2090565b615121565b50807f00000000000000000000000000000000000000000000000000000000000000001682146150b5565b604051636eb1769f60e11b815230600482015273bd80b06d3dbd0801132c6689429ac09ca6d27f82602482015290916020826044816001600160a01b0387165afa91821561377c575f9261537b575b5081018091116131505760405163095ea7b360e01b602082015273bd80b06d3dbd0801132c6689429ac09ca6d27f82602482015260448101919091526104ae916149618260648101614953565b61539591925060203d60201161118b5761117c8183610676565b905f61532e565b604051636eb1769f60e11b81523060048201526001600160a01b03831660248201529192602083806044810103816001600160a01b0386165afa92831561377c575f93615428575b5082018092116131505760405163095ea7b360e01b60208201526001600160a01b03909316602484015260448301919091526104ae91906149618260648101614953565b61544291935060203d60201161118b5761117c8183610676565b915f6153e4565b6001600160a01b03809116917f000000000000000000000000000000000000000000000000000000000000000090827f0000000000000000000000000000000000000000000000000000000000000000166154a582828561539c565b604090604051916332dd704760e21b83526020936004958585600481875afa94851561377c57869189915f97615616575b501697604051958680926352b7631960e11b8252816155088d600483019190916001600160a01b036020820193169052565b0392165afa93841561377c575f946155f7575b5092947f000000000000000000000000000000000000000000000000000000000000000093805b61555157505050505050505050565b6155a290878111156155f15787905b84516337e9a82760e11b815284810183815263ffffffff89166020820152604081018d90526001600160a01b038c166060820152909389918591829160800190565b03815f8a5af192831561377c576155be936155c4575b506137a4565b80615542565b6155e390893d8b116155ea575b6155db8183610676565b810190615666565b505f6155b8565b503d6155d1565b80615560565b61560f919450853d871161118b5761117c8183610676565b925f61551b565b61562e919750833d8511613775576137678183610676565b955f6154d6565b9060418151145f1461565d5761132d91602082015190606060408401519301515f1a906156af565b50505f90600290565b9081602091031261044e575167ffffffffffffffff8116810361044e5790565b90156156a057815115615697575090565b3b1561044e5790565b50805190811561044e57602001fd5b7f7fffffffffffffffffffffffffffffff5d576e7357a4501ddfe92f46681b20a0841161571f576020935f9360ff60809460405194855216868401526040830152606082015282805260015afa1561377c575f516001600160a01b0381161561571757905f90565b505f90600190565b505050505f9060039056fea264697066735822122081de8cafbdfc055aa138e7706e83912b790d1c719a65b618b872483c2da3859c64736f6c63430008170033"
+ "numDeployments": 6,
+ "solcInputHash": "f6db5bcc09d996b0e542155af45c1220",
+ "metadata": "{\"compiler\":{\"version\":\"0.8.23+commit.f704f362\"},\"language\":\"Solidity\",\"output\":{\"abi\":[{\"inputs\":[{\"internalType\":\"address\",\"name\":\"_wrappedNativeTokenAddress\",\"type\":\"address\"},{\"internalType\":\"uint32\",\"name\":\"_depositQuoteTimeBuffer\",\"type\":\"uint32\"},{\"internalType\":\"uint32\",\"name\":\"_fillDeadlineBuffer\",\"type\":\"uint32\"},{\"internalType\":\"contract IERC20\",\"name\":\"_l2Usdc\",\"type\":\"address\"},{\"internalType\":\"contract ITokenMessenger\",\"name\":\"_cctpTokenMessenger\",\"type\":\"address\"}],\"stateMutability\":\"nonpayable\",\"type\":\"constructor\"},{\"inputs\":[],\"name\":\"ClaimedMerkleLeaf\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"DepositsArePaused\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"DisabledRoute\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"ExpiredFillDeadline\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"FillsArePaused\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"InsufficientSpokePoolBalanceToExecuteLeaf\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"InvalidBytes32\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"InvalidChainId\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"InvalidCrossDomainAdmin\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"InvalidDepositorSignature\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"InvalidExclusiveRelayer\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"InvalidFillDeadline\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"InvalidMerkleLeaf\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"InvalidMerkleProof\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"InvalidPayoutAdjustmentPct\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"InvalidQuoteTimestamp\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"InvalidRelayerFeePct\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"InvalidSlowFillRequest\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"InvalidWithdrawalRecipient\",\"type\":\"error\"},{\"inputs\":[{\"internalType\":\"bytes\",\"name\":\"data\",\"type\":\"bytes\"}],\"name\":\"LowLevelCallFailed\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"MaxTransferSizeExceeded\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"MsgValueDoesNotMatchInputAmount\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"NoRelayerRefundToClaim\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"NoSlowFillsInExclusivityWindow\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"NotCrossChainCall\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"NotCrossDomainAdmin\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"NotEOA\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"NotExclusiveRelayer\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"RelayFilled\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"WrongERC7683OrderId\",\"type\":\"error\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address\",\"name\":\"previousAdmin\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"newAdmin\",\"type\":\"address\"}],\"name\":\"AdminChanged\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"beacon\",\"type\":\"address\"}],\"name\":\"BeaconUpgraded\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"bytes32\",\"name\":\"l2TokenAddress\",\"type\":\"bytes32\"},{\"indexed\":true,\"internalType\":\"bytes32\",\"name\":\"refundAddress\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"amount\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"address\",\"name\":\"caller\",\"type\":\"address\"}],\"name\":\"ClaimedRelayerRefund\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"uint256\",\"name\":\"rootBundleId\",\"type\":\"uint256\"}],\"name\":\"EmergencyDeletedRootBundle\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"originToken\",\"type\":\"address\"},{\"indexed\":true,\"internalType\":\"uint256\",\"name\":\"destinationChainId\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"bool\",\"name\":\"enabled\",\"type\":\"bool\"}],\"name\":\"EnabledDepositRoute\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"amountToReturn\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"uint256\",\"name\":\"chainId\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"uint256[]\",\"name\":\"refundAmounts\",\"type\":\"uint256[]\"},{\"indexed\":true,\"internalType\":\"uint32\",\"name\":\"rootBundleId\",\"type\":\"uint32\"},{\"indexed\":true,\"internalType\":\"uint32\",\"name\":\"leafId\",\"type\":\"uint32\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"l2TokenAddress\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"address[]\",\"name\":\"refundAddresses\",\"type\":\"address[]\"},{\"indexed\":false,\"internalType\":\"bool\",\"name\":\"deferredRefunds\",\"type\":\"bool\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"caller\",\"type\":\"address\"}],\"name\":\"ExecutedRelayerRefundRoot\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"bytes32\",\"name\":\"inputToken\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"bytes32\",\"name\":\"outputToken\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"inputAmount\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"outputAmount\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"repaymentChainId\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"uint256\",\"name\":\"originChainId\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"uint256\",\"name\":\"depositId\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"uint32\",\"name\":\"fillDeadline\",\"type\":\"uint32\"},{\"indexed\":false,\"internalType\":\"uint32\",\"name\":\"exclusivityDeadline\",\"type\":\"uint32\"},{\"indexed\":false,\"internalType\":\"bytes32\",\"name\":\"exclusiveRelayer\",\"type\":\"bytes32\"},{\"indexed\":true,\"internalType\":\"bytes32\",\"name\":\"relayer\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"bytes32\",\"name\":\"depositor\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"bytes32\",\"name\":\"recipient\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"bytes32\",\"name\":\"messageHash\",\"type\":\"bytes32\"},{\"components\":[{\"internalType\":\"bytes32\",\"name\":\"updatedRecipient\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"updatedMessageHash\",\"type\":\"bytes32\"},{\"internalType\":\"uint256\",\"name\":\"updatedOutputAmount\",\"type\":\"uint256\"},{\"internalType\":\"enum V3SpokePoolInterface.FillType\",\"name\":\"fillType\",\"type\":\"uint8\"}],\"indexed\":false,\"internalType\":\"struct V3SpokePoolInterface.V3RelayExecutionEventInfo\",\"name\":\"relayExecutionInfo\",\"type\":\"tuple\"}],\"name\":\"FilledRelay\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address\",\"name\":\"inputToken\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"outputToken\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"inputAmount\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"outputAmount\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"repaymentChainId\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"uint256\",\"name\":\"originChainId\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"uint32\",\"name\":\"depositId\",\"type\":\"uint32\"},{\"indexed\":false,\"internalType\":\"uint32\",\"name\":\"fillDeadline\",\"type\":\"uint32\"},{\"indexed\":false,\"internalType\":\"uint32\",\"name\":\"exclusivityDeadline\",\"type\":\"uint32\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"exclusiveRelayer\",\"type\":\"address\"},{\"indexed\":true,\"internalType\":\"address\",\"name\":\"relayer\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"depositor\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"recipient\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"},{\"components\":[{\"internalType\":\"address\",\"name\":\"updatedRecipient\",\"type\":\"address\"},{\"internalType\":\"bytes\",\"name\":\"updatedMessage\",\"type\":\"bytes\"},{\"internalType\":\"uint256\",\"name\":\"updatedOutputAmount\",\"type\":\"uint256\"},{\"internalType\":\"enum V3SpokePoolInterface.FillType\",\"name\":\"fillType\",\"type\":\"uint8\"}],\"indexed\":false,\"internalType\":\"struct V3SpokePoolInterface.LegacyV3RelayExecutionEventInfo\",\"name\":\"relayExecutionInfo\",\"type\":\"tuple\"}],\"name\":\"FilledV3Relay\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"bytes32\",\"name\":\"inputToken\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"bytes32\",\"name\":\"outputToken\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"inputAmount\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"outputAmount\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"uint256\",\"name\":\"destinationChainId\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"uint256\",\"name\":\"depositId\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"uint32\",\"name\":\"quoteTimestamp\",\"type\":\"uint32\"},{\"indexed\":false,\"internalType\":\"uint32\",\"name\":\"fillDeadline\",\"type\":\"uint32\"},{\"indexed\":false,\"internalType\":\"uint32\",\"name\":\"exclusivityDeadline\",\"type\":\"uint32\"},{\"indexed\":true,\"internalType\":\"bytes32\",\"name\":\"depositor\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"bytes32\",\"name\":\"recipient\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"bytes32\",\"name\":\"exclusiveRelayer\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"}],\"name\":\"FundsDeposited\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"uint8\",\"name\":\"version\",\"type\":\"uint8\"}],\"name\":\"Initialized\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"bool\",\"name\":\"isPaused\",\"type\":\"bool\"}],\"name\":\"PausedDeposits\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"bool\",\"name\":\"isPaused\",\"type\":\"bool\"}],\"name\":\"PausedFills\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"uint32\",\"name\":\"rootBundleId\",\"type\":\"uint32\"},{\"indexed\":true,\"internalType\":\"bytes32\",\"name\":\"relayerRefundRoot\",\"type\":\"bytes32\"},{\"indexed\":true,\"internalType\":\"bytes32\",\"name\":\"slowRelayRoot\",\"type\":\"bytes32\"}],\"name\":\"RelayedRootBundle\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"bytes32\",\"name\":\"inputToken\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"bytes32\",\"name\":\"outputToken\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"inputAmount\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"outputAmount\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"uint256\",\"name\":\"originChainId\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"uint256\",\"name\":\"depositId\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"uint32\",\"name\":\"fillDeadline\",\"type\":\"uint32\"},{\"indexed\":false,\"internalType\":\"uint32\",\"name\":\"exclusivityDeadline\",\"type\":\"uint32\"},{\"indexed\":false,\"internalType\":\"bytes32\",\"name\":\"exclusiveRelayer\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"bytes32\",\"name\":\"depositor\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"bytes32\",\"name\":\"recipient\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"bytes32\",\"name\":\"messageHash\",\"type\":\"bytes32\"}],\"name\":\"RequestedSlowFill\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"updatedOutputAmount\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"uint256\",\"name\":\"depositId\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"bytes32\",\"name\":\"depositor\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"bytes32\",\"name\":\"updatedRecipient\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"bytes\",\"name\":\"updatedMessage\",\"type\":\"bytes\"},{\"indexed\":false,\"internalType\":\"bytes\",\"name\":\"depositorSignature\",\"type\":\"bytes\"}],\"name\":\"RequestedSpeedUpDeposit\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"updatedOutputAmount\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"uint32\",\"name\":\"depositId\",\"type\":\"uint32\"},{\"indexed\":true,\"internalType\":\"address\",\"name\":\"depositor\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"updatedRecipient\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"bytes\",\"name\":\"updatedMessage\",\"type\":\"bytes\"},{\"indexed\":false,\"internalType\":\"bytes\",\"name\":\"depositorSignature\",\"type\":\"bytes\"}],\"name\":\"RequestedSpeedUpV3Deposit\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address\",\"name\":\"inputToken\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"outputToken\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"inputAmount\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"outputAmount\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"uint256\",\"name\":\"originChainId\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"uint32\",\"name\":\"depositId\",\"type\":\"uint32\"},{\"indexed\":false,\"internalType\":\"uint32\",\"name\":\"fillDeadline\",\"type\":\"uint32\"},{\"indexed\":false,\"internalType\":\"uint32\",\"name\":\"exclusivityDeadline\",\"type\":\"uint32\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"exclusiveRelayer\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"depositor\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"recipient\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"}],\"name\":\"RequestedV3SlowFill\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"uint32\",\"name\":\"newL1Gas\",\"type\":\"uint32\"}],\"name\":\"SetL1Gas\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"l2Token\",\"type\":\"address\"},{\"indexed\":true,\"internalType\":\"address\",\"name\":\"tokenBridge\",\"type\":\"address\"}],\"name\":\"SetL2TokenBridge\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"l2Token\",\"type\":\"address\"},{\"indexed\":true,\"internalType\":\"address\",\"name\":\"l1Token\",\"type\":\"address\"}],\"name\":\"SetRemoteL1Token\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"newWithdrawalRecipient\",\"type\":\"address\"}],\"name\":\"SetWithdrawalRecipient\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"newAdmin\",\"type\":\"address\"}],\"name\":\"SetXDomainAdmin\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"amountToReturn\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"uint256\",\"name\":\"chainId\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"uint32\",\"name\":\"leafId\",\"type\":\"uint32\"},{\"indexed\":true,\"internalType\":\"bytes32\",\"name\":\"l2TokenAddress\",\"type\":\"bytes32\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"caller\",\"type\":\"address\"}],\"name\":\"TokensBridged\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"implementation\",\"type\":\"address\"}],\"name\":\"Upgraded\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address\",\"name\":\"inputToken\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"outputToken\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"inputAmount\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"outputAmount\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"uint256\",\"name\":\"destinationChainId\",\"type\":\"uint256\"},{\"indexed\":true,\"internalType\":\"uint32\",\"name\":\"depositId\",\"type\":\"uint32\"},{\"indexed\":false,\"internalType\":\"uint32\",\"name\":\"quoteTimestamp\",\"type\":\"uint32\"},{\"indexed\":false,\"internalType\":\"uint32\",\"name\":\"fillDeadline\",\"type\":\"uint32\"},{\"indexed\":false,\"internalType\":\"uint32\",\"name\":\"exclusivityDeadline\",\"type\":\"uint32\"},{\"indexed\":true,\"internalType\":\"address\",\"name\":\"depositor\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"recipient\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"exclusiveRelayer\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"}],\"name\":\"V3FundsDeposited\",\"type\":\"event\"},{\"inputs\":[],\"name\":\"EMPTY_RELAYER\",\"outputs\":[{\"internalType\":\"bytes32\",\"name\":\"\",\"type\":\"bytes32\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"EMPTY_REPAYMENT_CHAIN_ID\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"INFINITE_FILL_DEADLINE\",\"outputs\":[{\"internalType\":\"uint32\",\"name\":\"\",\"type\":\"uint32\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"MAX_EXCLUSIVITY_PERIOD_SECONDS\",\"outputs\":[{\"internalType\":\"uint32\",\"name\":\"\",\"type\":\"uint32\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"MAX_TRANSFER_SIZE\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"MESSENGER\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"UPDATE_BYTES32_DEPOSIT_DETAILS_HASH\",\"outputs\":[{\"internalType\":\"bytes32\",\"name\":\"\",\"type\":\"bytes32\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint32\",\"name\":\"_initialDepositId\",\"type\":\"uint32\"},{\"internalType\":\"address\",\"name\":\"_crossDomainAdmin\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"_withdrawalRecipient\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"_l2Eth\",\"type\":\"address\"}],\"name\":\"__OvmSpokePool_init\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint32\",\"name\":\"_initialDepositId\",\"type\":\"uint32\"},{\"internalType\":\"address\",\"name\":\"_crossDomainAdmin\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"_withdrawalRecipient\",\"type\":\"address\"}],\"name\":\"__SpokePool_init\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"cctpTokenMessenger\",\"outputs\":[{\"internalType\":\"contract ITokenMessenger\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"cctpV2\",\"outputs\":[{\"internalType\":\"bool\",\"name\":\"\",\"type\":\"bool\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"chainId\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"bytes32\",\"name\":\"l2TokenAddress\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"refundAddress\",\"type\":\"bytes32\"}],\"name\":\"claimRelayerRefund\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"crossDomainAdmin\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"bytes32\",\"name\":\"depositor\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"recipient\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"inputToken\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"outputToken\",\"type\":\"bytes32\"},{\"internalType\":\"uint256\",\"name\":\"inputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"outputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"destinationChainId\",\"type\":\"uint256\"},{\"internalType\":\"bytes32\",\"name\":\"exclusiveRelayer\",\"type\":\"bytes32\"},{\"internalType\":\"uint32\",\"name\":\"quoteTimestamp\",\"type\":\"uint32\"},{\"internalType\":\"uint32\",\"name\":\"fillDeadline\",\"type\":\"uint32\"},{\"internalType\":\"uint32\",\"name\":\"exclusivityParameter\",\"type\":\"uint32\"},{\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"}],\"name\":\"deposit\",\"outputs\":[],\"stateMutability\":\"payable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"recipient\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"originToken\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"amount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"destinationChainId\",\"type\":\"uint256\"},{\"internalType\":\"int64\",\"name\":\"relayerFeePct\",\"type\":\"int64\"},{\"internalType\":\"uint32\",\"name\":\"quoteTimestamp\",\"type\":\"uint32\"},{\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"},{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"name\":\"depositDeprecated_5947912356\",\"outputs\":[],\"stateMutability\":\"payable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"depositor\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"recipient\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"originToken\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"amount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"destinationChainId\",\"type\":\"uint256\"},{\"internalType\":\"int64\",\"name\":\"relayerFeePct\",\"type\":\"int64\"},{\"internalType\":\"uint32\",\"name\":\"quoteTimestamp\",\"type\":\"uint32\"},{\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"},{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"name\":\"depositFor\",\"outputs\":[],\"stateMutability\":\"payable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"bytes32\",\"name\":\"depositor\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"recipient\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"inputToken\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"outputToken\",\"type\":\"bytes32\"},{\"internalType\":\"uint256\",\"name\":\"inputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"outputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"destinationChainId\",\"type\":\"uint256\"},{\"internalType\":\"bytes32\",\"name\":\"exclusiveRelayer\",\"type\":\"bytes32\"},{\"internalType\":\"uint32\",\"name\":\"fillDeadlineOffset\",\"type\":\"uint32\"},{\"internalType\":\"uint32\",\"name\":\"exclusivityParameter\",\"type\":\"uint32\"},{\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"}],\"name\":\"depositNow\",\"outputs\":[],\"stateMutability\":\"payable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"depositQuoteTimeBuffer\",\"outputs\":[{\"internalType\":\"uint32\",\"name\":\"\",\"type\":\"uint32\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"depositor\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"recipient\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"inputToken\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"outputToken\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"inputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"outputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"destinationChainId\",\"type\":\"uint256\"},{\"internalType\":\"address\",\"name\":\"exclusiveRelayer\",\"type\":\"address\"},{\"internalType\":\"uint32\",\"name\":\"quoteTimestamp\",\"type\":\"uint32\"},{\"internalType\":\"uint32\",\"name\":\"fillDeadline\",\"type\":\"uint32\"},{\"internalType\":\"uint32\",\"name\":\"exclusivityParameter\",\"type\":\"uint32\"},{\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"}],\"name\":\"depositV3\",\"outputs\":[],\"stateMutability\":\"payable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"depositor\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"recipient\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"inputToken\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"outputToken\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"inputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"outputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"destinationChainId\",\"type\":\"uint256\"},{\"internalType\":\"address\",\"name\":\"exclusiveRelayer\",\"type\":\"address\"},{\"internalType\":\"uint32\",\"name\":\"fillDeadlineOffset\",\"type\":\"uint32\"},{\"internalType\":\"uint32\",\"name\":\"exclusivityParameter\",\"type\":\"uint32\"},{\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"}],\"name\":\"depositV3Now\",\"outputs\":[],\"stateMutability\":\"payable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint256\",\"name\":\"rootBundleId\",\"type\":\"uint256\"}],\"name\":\"emergencyDeleteRootBundle\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint32\",\"name\":\"rootBundleId\",\"type\":\"uint32\"},{\"components\":[{\"internalType\":\"uint256\",\"name\":\"amountToReturn\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"chainId\",\"type\":\"uint256\"},{\"internalType\":\"uint256[]\",\"name\":\"refundAmounts\",\"type\":\"uint256[]\"},{\"internalType\":\"uint32\",\"name\":\"leafId\",\"type\":\"uint32\"},{\"internalType\":\"address\",\"name\":\"l2TokenAddress\",\"type\":\"address\"},{\"internalType\":\"address[]\",\"name\":\"refundAddresses\",\"type\":\"address[]\"}],\"internalType\":\"struct SpokePoolInterface.RelayerRefundLeaf\",\"name\":\"relayerRefundLeaf\",\"type\":\"tuple\"},{\"internalType\":\"bytes32[]\",\"name\":\"proof\",\"type\":\"bytes32[]\"}],\"name\":\"executeRelayerRefundLeaf\",\"outputs\":[],\"stateMutability\":\"payable\",\"type\":\"function\"},{\"inputs\":[{\"components\":[{\"components\":[{\"internalType\":\"bytes32\",\"name\":\"depositor\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"recipient\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"exclusiveRelayer\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"inputToken\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"outputToken\",\"type\":\"bytes32\"},{\"internalType\":\"uint256\",\"name\":\"inputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"outputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"originChainId\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"depositId\",\"type\":\"uint256\"},{\"internalType\":\"uint32\",\"name\":\"fillDeadline\",\"type\":\"uint32\"},{\"internalType\":\"uint32\",\"name\":\"exclusivityDeadline\",\"type\":\"uint32\"},{\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"}],\"internalType\":\"struct V3SpokePoolInterface.V3RelayData\",\"name\":\"relayData\",\"type\":\"tuple\"},{\"internalType\":\"uint256\",\"name\":\"chainId\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"updatedOutputAmount\",\"type\":\"uint256\"}],\"internalType\":\"struct V3SpokePoolInterface.V3SlowFill\",\"name\":\"slowFillLeaf\",\"type\":\"tuple\"},{\"internalType\":\"uint32\",\"name\":\"rootBundleId\",\"type\":\"uint32\"},{\"internalType\":\"bytes32[]\",\"name\":\"proof\",\"type\":\"bytes32[]\"}],\"name\":\"executeSlowRelayLeaf\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"bytes32\",\"name\":\"orderId\",\"type\":\"bytes32\"},{\"internalType\":\"bytes\",\"name\":\"originData\",\"type\":\"bytes\"},{\"internalType\":\"bytes\",\"name\":\"fillerData\",\"type\":\"bytes\"}],\"name\":\"fill\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"fillDeadlineBuffer\",\"outputs\":[{\"internalType\":\"uint32\",\"name\":\"\",\"type\":\"uint32\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"components\":[{\"internalType\":\"bytes32\",\"name\":\"depositor\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"recipient\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"exclusiveRelayer\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"inputToken\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"outputToken\",\"type\":\"bytes32\"},{\"internalType\":\"uint256\",\"name\":\"inputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"outputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"originChainId\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"depositId\",\"type\":\"uint256\"},{\"internalType\":\"uint32\",\"name\":\"fillDeadline\",\"type\":\"uint32\"},{\"internalType\":\"uint32\",\"name\":\"exclusivityDeadline\",\"type\":\"uint32\"},{\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"}],\"internalType\":\"struct V3SpokePoolInterface.V3RelayData\",\"name\":\"relayData\",\"type\":\"tuple\"},{\"internalType\":\"uint256\",\"name\":\"repaymentChainId\",\"type\":\"uint256\"},{\"internalType\":\"bytes32\",\"name\":\"repaymentAddress\",\"type\":\"bytes32\"}],\"name\":\"fillRelay\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"components\":[{\"internalType\":\"bytes32\",\"name\":\"depositor\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"recipient\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"exclusiveRelayer\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"inputToken\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"outputToken\",\"type\":\"bytes32\"},{\"internalType\":\"uint256\",\"name\":\"inputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"outputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"originChainId\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"depositId\",\"type\":\"uint256\"},{\"internalType\":\"uint32\",\"name\":\"fillDeadline\",\"type\":\"uint32\"},{\"internalType\":\"uint32\",\"name\":\"exclusivityDeadline\",\"type\":\"uint32\"},{\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"}],\"internalType\":\"struct V3SpokePoolInterface.V3RelayData\",\"name\":\"relayData\",\"type\":\"tuple\"},{\"internalType\":\"uint256\",\"name\":\"repaymentChainId\",\"type\":\"uint256\"},{\"internalType\":\"bytes32\",\"name\":\"repaymentAddress\",\"type\":\"bytes32\"},{\"internalType\":\"uint256\",\"name\":\"updatedOutputAmount\",\"type\":\"uint256\"},{\"internalType\":\"bytes32\",\"name\":\"updatedRecipient\",\"type\":\"bytes32\"},{\"internalType\":\"bytes\",\"name\":\"updatedMessage\",\"type\":\"bytes\"},{\"internalType\":\"bytes\",\"name\":\"depositorSignature\",\"type\":\"bytes\"}],\"name\":\"fillRelayWithUpdatedDeposit\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"bytes32\",\"name\":\"\",\"type\":\"bytes32\"}],\"name\":\"fillStatuses\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"components\":[{\"internalType\":\"address\",\"name\":\"depositor\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"recipient\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"exclusiveRelayer\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"inputToken\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"outputToken\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"inputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"outputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"originChainId\",\"type\":\"uint256\"},{\"internalType\":\"uint32\",\"name\":\"depositId\",\"type\":\"uint32\"},{\"internalType\":\"uint32\",\"name\":\"fillDeadline\",\"type\":\"uint32\"},{\"internalType\":\"uint32\",\"name\":\"exclusivityDeadline\",\"type\":\"uint32\"},{\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"}],\"internalType\":\"struct V3SpokePoolInterface.V3RelayDataLegacy\",\"name\":\"relayData\",\"type\":\"tuple\"},{\"internalType\":\"uint256\",\"name\":\"repaymentChainId\",\"type\":\"uint256\"}],\"name\":\"fillV3Relay\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"getCurrentTime\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"l2TokenAddress\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"refundAddress\",\"type\":\"address\"}],\"name\":\"getRelayerRefund\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"msgSender\",\"type\":\"address\"},{\"internalType\":\"bytes32\",\"name\":\"depositor\",\"type\":\"bytes32\"},{\"internalType\":\"uint256\",\"name\":\"depositNonce\",\"type\":\"uint256\"}],\"name\":\"getUnsafeDepositId\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"pure\",\"type\":\"function\"},{\"inputs\":[{\"components\":[{\"internalType\":\"bytes32\",\"name\":\"depositor\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"recipient\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"exclusiveRelayer\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"inputToken\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"outputToken\",\"type\":\"bytes32\"},{\"internalType\":\"uint256\",\"name\":\"inputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"outputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"originChainId\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"depositId\",\"type\":\"uint256\"},{\"internalType\":\"uint32\",\"name\":\"fillDeadline\",\"type\":\"uint32\"},{\"internalType\":\"uint32\",\"name\":\"exclusivityDeadline\",\"type\":\"uint32\"},{\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"}],\"internalType\":\"struct V3SpokePoolInterface.V3RelayData\",\"name\":\"relayData\",\"type\":\"tuple\"}],\"name\":\"getV3RelayHash\",\"outputs\":[{\"internalType\":\"bytes32\",\"name\":\"\",\"type\":\"bytes32\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint32\",\"name\":\"_initialDepositId\",\"type\":\"uint32\"},{\"internalType\":\"address\",\"name\":\"_crossDomainAdmin\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"_withdrawalRecipient\",\"type\":\"address\"}],\"name\":\"initialize\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"l1Gas\",\"outputs\":[{\"internalType\":\"uint32\",\"name\":\"\",\"type\":\"uint32\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"l2Eth\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"bytes[]\",\"name\":\"data\",\"type\":\"bytes[]\"}],\"name\":\"multicall\",\"outputs\":[{\"internalType\":\"bytes[]\",\"name\":\"results\",\"type\":\"bytes[]\"}],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"numberOfDeposits\",\"outputs\":[{\"internalType\":\"uint32\",\"name\":\"\",\"type\":\"uint32\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"bool\",\"name\":\"pause\",\"type\":\"bool\"}],\"name\":\"pauseDeposits\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"bool\",\"name\":\"pause\",\"type\":\"bool\"}],\"name\":\"pauseFills\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"pausedDeposits\",\"outputs\":[{\"internalType\":\"bool\",\"name\":\"\",\"type\":\"bool\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"pausedFills\",\"outputs\":[{\"internalType\":\"bool\",\"name\":\"\",\"type\":\"bool\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"proxiableUUID\",\"outputs\":[{\"internalType\":\"bytes32\",\"name\":\"\",\"type\":\"bytes32\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"recipientCircleDomainId\",\"outputs\":[{\"internalType\":\"uint32\",\"name\":\"\",\"type\":\"uint32\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"bytes32\",\"name\":\"relayerRefundRoot\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"slowRelayRoot\",\"type\":\"bytes32\"}],\"name\":\"relayRootBundle\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"name\":\"relayerRefund\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"name\":\"remoteL1Tokens\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"components\":[{\"internalType\":\"bytes32\",\"name\":\"depositor\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"recipient\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"exclusiveRelayer\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"inputToken\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"outputToken\",\"type\":\"bytes32\"},{\"internalType\":\"uint256\",\"name\":\"inputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"outputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"originChainId\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"depositId\",\"type\":\"uint256\"},{\"internalType\":\"uint32\",\"name\":\"fillDeadline\",\"type\":\"uint32\"},{\"internalType\":\"uint32\",\"name\":\"exclusivityDeadline\",\"type\":\"uint32\"},{\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"}],\"internalType\":\"struct V3SpokePoolInterface.V3RelayData\",\"name\":\"relayData\",\"type\":\"tuple\"}],\"name\":\"requestSlowFill\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"name\":\"rootBundles\",\"outputs\":[{\"internalType\":\"bytes32\",\"name\":\"slowRelayRoot\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"relayerRefundRoot\",\"type\":\"bytes32\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"newCrossDomainAdmin\",\"type\":\"address\"}],\"name\":\"setCrossDomainAdmin\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint32\",\"name\":\"newl1Gas\",\"type\":\"uint32\"}],\"name\":\"setL1GasLimit\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"l2Token\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"l1Token\",\"type\":\"address\"}],\"name\":\"setRemoteL1Token\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"l2Token\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"tokenBridge\",\"type\":\"address\"}],\"name\":\"setTokenBridge\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"newWithdrawalRecipient\",\"type\":\"address\"}],\"name\":\"setWithdrawalRecipient\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"bytes32\",\"name\":\"depositor\",\"type\":\"bytes32\"},{\"internalType\":\"uint256\",\"name\":\"depositId\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"updatedOutputAmount\",\"type\":\"uint256\"},{\"internalType\":\"bytes32\",\"name\":\"updatedRecipient\",\"type\":\"bytes32\"},{\"internalType\":\"bytes\",\"name\":\"updatedMessage\",\"type\":\"bytes\"},{\"internalType\":\"bytes\",\"name\":\"depositorSignature\",\"type\":\"bytes\"}],\"name\":\"speedUpDeposit\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"depositor\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"depositId\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"updatedOutputAmount\",\"type\":\"uint256\"},{\"internalType\":\"address\",\"name\":\"updatedRecipient\",\"type\":\"address\"},{\"internalType\":\"bytes\",\"name\":\"updatedMessage\",\"type\":\"bytes\"},{\"internalType\":\"bytes\",\"name\":\"depositorSignature\",\"type\":\"bytes\"}],\"name\":\"speedUpV3Deposit\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"name\":\"tokenBridges\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"bytes[]\",\"name\":\"data\",\"type\":\"bytes[]\"}],\"name\":\"tryMulticall\",\"outputs\":[{\"components\":[{\"internalType\":\"bool\",\"name\":\"success\",\"type\":\"bool\"},{\"internalType\":\"bytes\",\"name\":\"returnData\",\"type\":\"bytes\"}],\"internalType\":\"struct MultiCallerUpgradeable.Result[]\",\"name\":\"results\",\"type\":\"tuple[]\"}],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"bytes32\",\"name\":\"depositor\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"recipient\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"inputToken\",\"type\":\"bytes32\"},{\"internalType\":\"bytes32\",\"name\":\"outputToken\",\"type\":\"bytes32\"},{\"internalType\":\"uint256\",\"name\":\"inputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"outputAmount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"destinationChainId\",\"type\":\"uint256\"},{\"internalType\":\"bytes32\",\"name\":\"exclusiveRelayer\",\"type\":\"bytes32\"},{\"internalType\":\"uint256\",\"name\":\"depositNonce\",\"type\":\"uint256\"},{\"internalType\":\"uint32\",\"name\":\"quoteTimestamp\",\"type\":\"uint32\"},{\"internalType\":\"uint32\",\"name\":\"fillDeadline\",\"type\":\"uint32\"},{\"internalType\":\"uint32\",\"name\":\"exclusivityParameter\",\"type\":\"uint32\"},{\"internalType\":\"bytes\",\"name\":\"message\",\"type\":\"bytes\"}],\"name\":\"unsafeDeposit\",\"outputs\":[],\"stateMutability\":\"payable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"newImplementation\",\"type\":\"address\"}],\"name\":\"upgradeTo\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"newImplementation\",\"type\":\"address\"},{\"internalType\":\"bytes\",\"name\":\"data\",\"type\":\"bytes\"}],\"name\":\"upgradeToAndCall\",\"outputs\":[],\"stateMutability\":\"payable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"usdcToken\",\"outputs\":[{\"internalType\":\"contract IERC20\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"withdrawalRecipient\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"wrappedNativeToken\",\"outputs\":[{\"internalType\":\"contract WETH9Interface\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"stateMutability\":\"payable\",\"type\":\"receive\"}],\"devdoc\":{\"custom:security-contact\":\"bugs@across.to\",\"events\":{\"AdminChanged(address,address)\":{\"details\":\"Emitted when the admin account has changed.\"},\"BeaconUpgraded(address)\":{\"details\":\"Emitted when the beacon is changed.\"},\"Initialized(uint8)\":{\"details\":\"Triggered when the contract has been initialized or reinitialized.\"},\"Upgraded(address)\":{\"details\":\"Emitted when the implementation is upgraded.\"}},\"kind\":\"dev\",\"methods\":{\"__OvmSpokePool_init(uint32,address,address,address)\":{\"params\":{\"_crossDomainAdmin\":\"Cross domain admin to set. Can be changed by admin.\",\"_initialDepositId\":\"Starting deposit ID. Set to 0 unless this is a re-deployment in order to mitigate relay hash collisions.\",\"_l2Eth\":\"Address of L2 ETH token. Usually should be Lib_PreeployAddresses.OVM_ETH but sometimes this can be different, like with Boba which flips the WETH and OVM_ETH addresses.\",\"_withdrawalRecipient\":\"Address which receives token withdrawals. Can be changed by admin. For Spoke Pools on L2, this will likely be the hub pool.\"}},\"__SpokePool_init(uint32,address,address)\":{\"params\":{\"_crossDomainAdmin\":\"Cross domain admin to set. Can be changed by admin.\",\"_initialDepositId\":\"Starting deposit ID. Set to 0 unless this is a re-deployment in order to mitigate relay hash collisions.\",\"_withdrawalRecipient\":\"Address which receives token withdrawals. Can be changed by admin. For Spoke Pools on L2, this will likely be the hub pool.\"}},\"chainId()\":{\"details\":\"Some L2s like ZKSync don't support the CHAIN_ID opcode so we allow the implementer to override this.\"},\"claimRelayerRefund(bytes32,bytes32)\":{\"params\":{\"l2TokenAddress\":\"Address of the L2 token to claim refunds for.\",\"refundAddress\":\"Address to send the refund to.\"}},\"constructor\":{\"custom:oz-upgrades-unsafe-allow\":\"constructor\"},\"deposit(bytes32,bytes32,bytes32,bytes32,uint256,uint256,uint256,bytes32,uint32,uint32,uint32,bytes)\":{\"details\":\"On the destination chain, the hash of the deposit data will be used to uniquely identify this deposit, so modifying any params in it will result in a different hash and a different deposit. The hash will comprise all parameters to this function along with this chain's chainId(). Relayers are only refunded for filling deposits with deposit hashes that map exactly to the one emitted by this contract.\",\"params\":{\"depositor\":\"The account credited with the deposit who can request to \\\"speed up\\\" this deposit by modifying the output amount, recipient, and message.\",\"destinationChainId\":\"The destination chain identifier. Must be enabled along with the input token as a valid deposit route from this spoke pool or this transaction will revert.\",\"exclusiveRelayer\":\"The relayer that will be exclusively allowed to fill this deposit before the exclusivity deadline timestamp. This must be a valid, non-zero address if the exclusivity deadline is greater than the current block.timestamp. If the exclusivity deadline is < currentTime, then this must be address(0), and vice versa if this is address(0).\",\"exclusivityParameter\":\"This value is used to set the exclusivity deadline timestamp in the emitted deposit event. Before this destination chain timestamp, only the exclusiveRelayer (if set to a non-zero address), can fill this deposit. There are three ways to use this parameter: 1. NO EXCLUSIVITY: If this value is set to 0, then a timestamp of 0 will be emitted, meaning that there is no exclusivity period. 2. OFFSET: If this value is less than MAX_EXCLUSIVITY_PERIOD_SECONDS, then add this value to the block.timestamp to derive the exclusive relayer deadline. Note that using the parameter in this way will expose the filler of the deposit to the risk that the block.timestamp of this event gets changed due to a chain-reorg, which would also change the exclusivity timestamp. 3. TIMESTAMP: Otherwise, set this value as the exclusivity deadline timestamp. which is the deadline for the exclusiveRelayer to fill the deposit.\",\"fillDeadline\":\"The deadline for the relayer to fill the deposit. After this destination chain timestamp, the fill will revert on the destination chain. Must be set before currentTime + fillDeadlineBuffer, where currentTime is block.timestamp on this chain or this transaction will revert.\",\"inputAmount\":\"The amount of input tokens to pull from the caller's account and lock into this contract. This amount will be sent to the relayer on their repayment chain of choice as a refund following an optimistic challenge window in the HubPool, less a system fee.\",\"inputToken\":\"The token pulled from the caller's account and locked into this contract to initiate the deposit. The equivalent of this token on the relayer's repayment chain of choice will be sent as a refund. If this is equal to the wrapped native token then the caller can optionally pass in native token as msg.value, as long as msg.value = inputTokenAmount.\",\"message\":\"The message to send to the recipient on the destination chain if the recipient is a contract. If the message is not empty, the recipient contract must implement handleV3AcrossMessage() or the fill will revert.\",\"outputAmount\":\"The amount of output tokens that the relayer will send to the recipient on the destination.\",\"outputToken\":\"The token that the relayer will send to the recipient on the destination chain. Must be an ERC20.\",\"quoteTimestamp\":\"The HubPool timestamp that is used to determine the system fee paid by the depositor. This must be set to some time between [currentTime - depositQuoteTimeBuffer, currentTime] where currentTime is block.timestamp on this chain or this transaction will revert.\",\"recipient\":\"The account receiving funds on the destination chain. Can be an EOA or a contract. If the output token is the wrapped native token for the chain, then the recipient will receive native token if an EOA or wrapped native token if a contract.\"}},\"depositDeprecated_5947912356(address,address,uint256,uint256,int64,uint32,bytes,uint256)\":{\"details\":\"DEPRECATION NOTICE: this function is deprecated and will be removed in the future. Please use deposit (under DEPOSITOR FUNCTIONS below) or depositV3 instead.Produces a FundsDeposited event with an infinite expiry, meaning that this deposit can never expire. Moreover, the event's outputToken is set to 0x0 meaning that this deposit can always be slow filled.\",\"params\":{\"amount\":\"Amount of tokens to deposit. Will be amount of tokens to receive less fees.\",\"destinationChainId\":\"Denotes network where user will receive funds from SpokePool by a relayer.\",\"message\":\"Arbitrary data that can be used to pass additional information to the recipient along with the tokens. Note: this is intended to be used to pass along instructions for how a contract should use or allocate the tokens.\",\"originToken\":\"Token to lock into this contract to initiate deposit.\",\"quoteTimestamp\":\"Timestamp used by relayers to compute this deposit's realizedLPFeePct which is paid to LP pool on HubPool.\",\"recipient\":\"Address to receive funds at on destination chain.\",\"relayerFeePct\":\"% of deposit amount taken out to incentivize a fast relayer.\"}},\"depositFor(address,address,address,uint256,uint256,int64,uint32,bytes,uint256)\":{\"details\":\"DEPRECATION NOTICE: this function is deprecated and will be removed in the future. Please use the other deposit or depositV3 instead.\",\"params\":{\"amount\":\"Amount of tokens to deposit. Will be amount of tokens to receive less fees.\",\"depositor\":\"Address who is credited for depositing funds on origin chain and can speed up the deposit.\",\"destinationChainId\":\"Denotes network where user will receive funds from SpokePool by a relayer.\",\"message\":\"Arbitrary data that can be used to pass additional information to the recipient along with the tokens. Note: this is intended to be used to pass along instructions for how a contract should use or allocate the tokens.\",\"originToken\":\"Token to lock into this contract to initiate deposit.\",\"quoteTimestamp\":\"Timestamp used by relayers to compute this deposit's realizedLPFeePct which is paid to LP pool on HubPool.\",\"recipient\":\"Address to receive funds at on destination chain.\",\"relayerFeePct\":\"% of deposit amount taken out to incentivize a fast relayer.\"}},\"depositNow(bytes32,bytes32,bytes32,bytes32,uint256,uint256,uint256,bytes32,uint32,uint32,bytes)\":{\"params\":{\"depositor\":\"The account credited with the deposit who can request to \\\"speed up\\\" this deposit by modifying the output amount, recipient, and message.\",\"destinationChainId\":\"The destination chain identifier. Must be enabled along with the input token as a valid deposit route from this spoke pool or this transaction will revert.\",\"exclusiveRelayer\":\"The relayer that will be exclusively allowed to fill this deposit before the exclusivity deadline timestamp.\",\"exclusivityParameter\":\"See identically named parameter in deposit() comments.\",\"fillDeadlineOffset\":\"Added to the current time to set the fill deadline, which is the deadline for the relayer to fill the deposit. After this destination chain timestamp, the fill will revert on the destination chain.\",\"inputAmount\":\"The amount of input tokens to pull from the caller's account and lock into this contract. This amount will be sent to the relayer on their repayment chain of choice as a refund following an optimistic challenge window in the HubPool, plus a system fee.\",\"inputToken\":\"The token pulled from the caller's account and locked into this contract to initiate the deposit. The equivalent of this token on the relayer's repayment chain of choice will be sent as a refund. If this is equal to the wrapped native token then the caller can optionally pass in native token as msg.value, as long as msg.value = inputTokenAmount.\",\"message\":\"The message to send to the recipient on the destination chain if the recipient is a contract. If the message is not empty, the recipient contract must implement handleV3AcrossMessage() or the fill will revert.\",\"outputAmount\":\"The amount of output tokens that the relayer will send to the recipient on the destination.\",\"outputToken\":\"The token that the relayer will send to the recipient on the destination chain. Must be an ERC20.\",\"recipient\":\"The account receiving funds on the destination chain. Can be an EOA or a contract. If the output token is the wrapped native token for the chain, then the recipient will receive native token if an EOA or wrapped native token if a contract.\"}},\"depositV3(address,address,address,address,uint256,uint256,uint256,address,uint32,uint32,uint32,bytes)\":{\"details\":\"This version mirrors the original `depositV3` function, but uses `address` types for `depositor`, `recipient`, `inputToken`, `outputToken`, and `exclusiveRelayer` for compatibility with contracts using the `address` type. The key functionality and logic remain identical, ensuring interoperability across both versions.\",\"params\":{\"depositor\":\"The account credited with the deposit who can request to \\\"speed up\\\" this deposit by modifying the output amount, recipient, and message.\",\"destinationChainId\":\"The destination chain identifier. Must be enabled along with the input token as a valid deposit route from this spoke pool or this transaction will revert.\",\"exclusiveRelayer\":\"The relayer exclusively allowed to fill this deposit before the exclusivity deadline.\",\"exclusivityParameter\":\"This value is used to set the exclusivity deadline timestamp in the emitted deposit event. Before this destination chain timestamp, only the exclusiveRelayer (if set to a non-zero address), can fill this deposit. There are three ways to use this parameter: 1. NO EXCLUSIVITY: If this value is set to 0, then a timestamp of 0 will be emitted, meaning that there is no exclusivity period. 2. OFFSET: If this value is less than MAX_EXCLUSIVITY_PERIOD_SECONDS, then add this value to the block.timestamp to derive the exclusive relayer deadline. Note that using the parameter in this way will expose the filler of the deposit to the risk that the block.timestamp of this event gets changed due to a chain-reorg, which would also change the exclusivity timestamp. 3. TIMESTAMP: Otherwise, set this value as the exclusivity deadline timestamp. which is the deadline for the exclusiveRelayer to fill the deposit.\",\"fillDeadline\":\"The deadline for the relayer to fill the deposit. After this destination chain timestamp, the fill will revert on the destination chain. Must be set before currentTime + fillDeadlineBuffer, where currentTime is block.timestamp on this chain.\",\"inputAmount\":\"The amount of input tokens pulled from the caller's account and locked into this contract. This amount will be sent to the relayer as a refund following an optimistic challenge window in the HubPool, less a system fee.\",\"inputToken\":\"The token pulled from the caller's account and locked into this contract to initiate the deposit. The equivalent of this token on the relayer's repayment chain of choice will be sent as a refund. If this is equal to the wrapped native token, the caller can optionally pass in native token as msg.value, provided msg.value = inputTokenAmount.\",\"message\":\"The message to send to the recipient on the destination chain if the recipient is a contract. If the message is not empty, the recipient contract must implement `handleV3AcrossMessage()` or the fill will revert.\",\"outputAmount\":\"The amount of output tokens that the relayer will send to the recipient on the destination.\",\"outputToken\":\"The token that the relayer will send to the recipient on the destination chain. Must be an ERC20.\",\"quoteTimestamp\":\"The HubPool timestamp that determines the system fee paid by the depositor. This must be set between [currentTime - depositQuoteTimeBuffer, currentTime] where currentTime is block.timestamp on this chain.\",\"recipient\":\"The account receiving funds on the destination chain. Can be an EOA or a contract. If the output token is the wrapped native token for the chain, then the recipient will receive native token if an EOA or wrapped native token if a contract.\"}},\"depositV3Now(address,address,address,address,uint256,uint256,uint256,address,uint32,uint32,bytes)\":{\"details\":\"This version is identical to the original `depositV3Now` but uses `address` types for `depositor`, `recipient`, `inputToken`, `outputToken`, and `exclusiveRelayer` to support compatibility with older systems. It maintains the same logic and purpose, ensuring interoperability with both versions.\",\"params\":{\"depositor\":\"The account credited with the deposit, who can request to \\\"speed up\\\" this deposit by modifying the output amount, recipient, and message.\",\"destinationChainId\":\"The destination chain identifier. Must be enabled with the input token as a valid deposit route from this spoke pool, or the transaction will revert.\",\"exclusiveRelayer\":\"The relayer exclusively allowed to fill the deposit before the exclusivity deadline.\",\"exclusivityParameter\":\"See identically named parameter in deposit() comments.\",\"fillDeadlineOffset\":\"Added to the current time to set the fill deadline. After this timestamp, fills on the destination chain will revert.\",\"inputAmount\":\"The amount of input tokens pulled from the caller's account and locked into this contract. This amount will be sent to the relayer as a refund following an optimistic challenge window in the HubPool, plus a system fee.\",\"inputToken\":\"The token pulled from the caller's account and locked into this contract to initiate the deposit. Equivalent tokens on the relayer's repayment chain will be sent as a refund. If this is the wrapped native token, msg.value must equal inputTokenAmount when passed.\",\"message\":\"The message to send to the recipient on the destination chain. If the recipient is a contract, it must implement `handleV3AcrossMessage()` if the message is not empty, or the fill will revert.\",\"outputAmount\":\"The amount of output tokens the relayer will send to the recipient on the destination.\",\"outputToken\":\"The token the relayer will send to the recipient on the destination chain. Must be an ERC20.\",\"recipient\":\"The account receiving funds on the destination chain. Can be an EOA or a contract. If the output token is the wrapped native token for the chain, then the recipient will receive the native token if an EOA or wrapped native token if a contract.\"}},\"emergencyDeleteRootBundle(uint256)\":{\"params\":{\"rootBundleId\":\"Index of the root bundle that needs to be deleted. Note: this is intentionally a uint256 to ensure that a small input range doesn't limit which indices this method is able to reach.\"}},\"executeRelayerRefundLeaf(uint32,(uint256,uint256,uint256[],uint32,address,address[]),bytes32[])\":{\"params\":{\"proof\":\"Inclusion proof for this leaf in relayer refund root in root bundle.\",\"relayerRefundLeaf\":\"Contains all data necessary to reconstruct leaf contained in root bundle and to refund relayer. This data structure is explained in detail in the SpokePoolInterface.\",\"rootBundleId\":\"Unique ID of root bundle containing relayer refund root that this leaf is contained in.\"}},\"executeSlowRelayLeaf(((bytes32,bytes32,bytes32,bytes32,bytes32,uint256,uint256,uint256,uint256,uint32,uint32,bytes),uint256,uint256),uint32,bytes32[])\":{\"details\":\"Executing a slow fill leaf is equivalent to filling the relayData so this function cannot be used to double fill a recipient. The relayData that is filled is included in the slowFillLeaf and is hashed like any other fill sent through a fill method.There is no relayer credited with filling this relay since funds are sent directly out of this contract.\",\"params\":{\"proof\":\"Inclusion proof for this leaf in slow relay root in root bundle.\",\"rootBundleId\":\"Unique ID of root bundle containing slow relay root that this leaf is contained in.\",\"slowFillLeaf\":\"Contains all data necessary to uniquely identify a relay for this chain. This struct is hashed and included in a merkle root that is relayed to all spoke pools. - relayData: struct containing all the data needed to identify the original deposit to be slow filled. - chainId: chain identifier where slow fill leaf should be executed. If this doesn't match this chain's chainId, then this function will revert. - updatedOutputAmount: Amount to be sent to recipient out of this contract's balance. Can be set differently from relayData.outputAmount to charge a different fee because this deposit was \\\"slow\\\" filled. Usually, this will be set higher to reimburse the recipient for waiting for the slow fill.\"}},\"fill(bytes32,bytes,bytes)\":{\"details\":\"ERC-7683 fill function.\",\"params\":{\"fillerData\":\"Data provided by the filler to inform the fill or express their preferences\",\"orderId\":\"Unique order identifier for this order\",\"originData\":\"Data emitted on the origin to parameterize the fill\"}},\"fillRelay((bytes32,bytes32,bytes32,bytes32,bytes32,uint256,uint256,uint256,uint256,uint32,uint32,bytes),uint256,bytes32)\":{\"details\":\"The fee paid to relayers and the system should be captured in the spread between output amount and input amount when adjusted to be denominated in the input token. A relayer on the destination chain will send outputAmount of outputTokens to the recipient and receive inputTokens on a repayment chain of their choice. Therefore, the fee should account for destination fee transaction costs, the relayer's opportunity cost of capital while they wait to be refunded following an optimistic challenge window in the HubPool, and a system fee charged to relayers.The hash of the relayData will be used to uniquely identify the deposit to fill, so modifying any params in it will result in a different hash and a different deposit. The hash will comprise all parameters passed to deposit() on the origin chain along with that chain's chainId(). This chain's chainId() must therefore match the destinationChainId passed into deposit. Relayers are only refunded for filling deposits with deposit hashes that map exactly to the one emitted by the origin SpokePool therefore the relayer should not modify any params in relayData.Cannot fill more than once. Partial fills are not supported.\",\"params\":{\"relayData\":\"struct containing all the data needed to identify the deposit to be filled. Should match all the same-named parameters emitted in the origin chain FundsDeposited event. - depositor: The account credited with the deposit who can request to \\\"speed up\\\" this deposit by modifying the output amount, recipient, and message. - recipient The account receiving funds on this chain. Can be an EOA or a contract. If the output token is the wrapped native token for the chain, then the recipient will receive native token if an EOA or wrapped native token if a contract. - inputToken: The token pulled from the caller's account to initiate the deposit. The equivalent of this token on the repayment chain will be sent as a refund to the caller. - outputToken The token that the caller will send to the recipient on the destination chain. Must be an ERC20. - inputAmount: This amount, less a system fee, will be sent to the caller on their repayment chain of choice as a refund following an optimistic challenge window in the HubPool. - outputAmount: The amount of output tokens that the caller will send to the recipient. - originChainId: The origin chain identifier. - exclusiveRelayer The relayer that will be exclusively allowed to fill this deposit before the exclusivity deadline timestamp. - fillDeadline The deadline for the caller to fill the deposit. After this timestamp, the fill will revert on the destination chain. - exclusivityDeadline: The deadline for the exclusive relayer to fill the deposit. After this timestamp, anyone can fill this deposit. Note that if this value was set in deposit by adding an offset to the deposit's block.timestamp, there is re-org risk for the caller of this method because the event's block.timestamp can change. Read the comments in `deposit` about the `exclusivityParameter` for more details. - message The message to send to the recipient if the recipient is a contract that implements a handleV3AcrossMessage() public function\",\"repaymentAddress\":\"Address the relayer wants to be receive their refund at.\",\"repaymentChainId\":\"Chain of SpokePool where relayer wants to be refunded after the challenge window has passed. Will receive inputAmount of the equivalent token to inputToken on the repayment chain.\"}},\"fillRelayWithUpdatedDeposit((bytes32,bytes32,bytes32,bytes32,bytes32,uint256,uint256,uint256,uint256,uint32,uint32,bytes),uint256,bytes32,uint256,bytes32,bytes,bytes)\":{\"details\":\"Subject to same exclusivity deadline rules as fillV3Relay().\",\"params\":{\"depositorSignature\":\"Signed EIP712 hashstruct containing the deposit ID. Should be signed by the depositor account.\",\"relayData\":\"struct containing all the data needed to identify the deposit to be filled. See fillV3Relay().\",\"repaymentAddress\":\"Address the relayer wants to be receive their refund at.\",\"repaymentChainId\":\"Chain of SpokePool where relayer wants to be refunded after the challenge window has passed. See fillV3Relay().\",\"updatedMessage\":\"New message to use for this deposit.\",\"updatedOutputAmount\":\"New output amount to use for this deposit.\",\"updatedRecipient\":\"New recipient to use for this deposit.\"}},\"getCurrentTime()\":{\"returns\":{\"_0\":\"uint for the current timestamp.\"}},\"getUnsafeDepositId(address,bytes32,uint256)\":{\"details\":\"msgSender and depositor are both used as inputs to allow passthrough depositors to create unique deposit hash spaces for unique depositors.\",\"params\":{\"depositNonce\":\"The nonce used as input to produce the deposit ID.\",\"depositor\":\"The depositor address used as input to produce the deposit ID.\",\"msgSender\":\"The caller of the transaction used as input to produce the deposit ID.\"},\"returns\":{\"_0\":\"The deposit ID for the unsafe deposit.\"}},\"initialize(uint32,address,address)\":{\"params\":{\"_crossDomainAdmin\":\"Cross domain admin to set. Can be changed by admin.\",\"_initialDepositId\":\"Starting deposit ID. Set to 0 unless this is a re-deployment in order to mitigate relay hash collisions.\",\"_withdrawalRecipient\":\"Address which receives token withdrawals. Can be changed by admin. For Spoke Pools on L2, this will likely be the hub pool.\"}},\"pauseDeposits(bool)\":{\"details\":\"Affects `deposit()` but not `speedUpDeposit()`, so that existing deposits can be sped up and still relayed.\",\"params\":{\"pause\":\"true if the call is meant to pause the system, false if the call is meant to unpause it.\"}},\"pauseFills(bool)\":{\"details\":\"Affects fillRelayWithUpdatedDeposit() and fillRelay().\",\"params\":{\"pause\":\"true if the call is meant to pause the system, false if the call is meant to unpause it.\"}},\"proxiableUUID()\":{\"details\":\"Implementation of the ERC1822 {proxiableUUID} function. This returns the storage slot used by the implementation. It is used to validate the implementation's compatibility when performing an upgrade. IMPORTANT: A proxy pointing at a proxiable contract should not be considered proxiable itself, because this risks bricking a proxy that upgrades to it, by delegating to itself until out of gas. Thus it is critical that this function revert if invoked through a proxy. This is guaranteed by the `notDelegated` modifier.\"},\"relayRootBundle(bytes32,bytes32)\":{\"params\":{\"relayerRefundRoot\":\"Merkle root containing relayer refund leaves that can be individually executed via executeRelayerRefundLeaf().\",\"slowRelayRoot\":\"Merkle root containing slow relay fulfillment leaves that can be individually executed via executeSlowRelayLeaf().\"}},\"requestSlowFill((bytes32,bytes32,bytes32,bytes32,bytes32,uint256,uint256,uint256,uint256,uint32,uint32,bytes))\":{\"details\":\"Slow fills are not possible unless the input and output tokens are \\\"equivalent\\\", i.e. they route to the same L1 token via PoolRebalanceRoutes.Slow fills are created by inserting slow fill objects into a merkle tree that is included in the next HubPool \\\"root bundle\\\". Once the optimistic challenge window has passed, the HubPool will relay the slow root to this chain via relayRootBundle(). Once the slow root is relayed, the slow fill can be executed by anyone who calls executeSlowRelayLeaf().Cannot request a slow fill if the fill deadline has passed.Cannot request a slow fill if the relay has already been filled or a slow fill has already been requested.\",\"params\":{\"relayData\":\"struct containing all the data needed to identify the deposit that should be slow filled. If any of the params are missing or different from the origin chain deposit, then Across will not include a slow fill for the intended deposit.\"}},\"setCrossDomainAdmin(address)\":{\"params\":{\"newCrossDomainAdmin\":\"New cross domain admin.\"}},\"setL1GasLimit(uint32)\":{\"params\":{\"newl1Gas\":\"New L1 gas limit to set.\"}},\"setTokenBridge(address,address)\":{\"details\":\"If this mapping isn't set for an L2 token, then the standard bridge will be used to bridge this token.\",\"params\":{\"tokenBridge\":\"Address of token bridge\"}},\"setWithdrawalRecipient(address)\":{\"params\":{\"newWithdrawalRecipient\":\"New withdrawal recipient address.\"}},\"speedUpDeposit(bytes32,uint256,uint256,bytes32,bytes,bytes)\":{\"details\":\"the depositor and depositId must match the params in a FundsDeposited event that the depositor wants to speed up. The relayer has the option but not the obligation to use this updated information when filling the deposit via fillRelayWithUpdatedDeposit().\",\"params\":{\"depositId\":\"Deposit ID to speed up.\",\"depositor\":\"Depositor that must sign the depositorSignature and was the original depositor.\",\"depositorSignature\":\"Signed EIP712 hashstruct containing the deposit ID. Should be signed by the depositor account. If depositor is a contract, then should implement EIP1271 to sign as a contract. See _verifyUpdateV3DepositMessage() for more details about how this signature should be constructed.\",\"updatedMessage\":\"New message to use for this deposit. Can be modified if the recipient is a contract that expects to receive a message from the relay and for some reason needs to be modified.\",\"updatedOutputAmount\":\"New output amount to use for this deposit. Should be lower than previous value otherwise relayer has no incentive to use this updated value.\",\"updatedRecipient\":\"New recipient to use for this deposit. Can be modified if the recipient is a contract that expects to receive a message from the relay and for some reason needs to be modified.\"}},\"speedUpV3Deposit(address,uint256,uint256,address,bytes,bytes)\":{\"details\":\"The `depositor` and `depositId` must match the parameters in a `FundsDeposited` event that the depositor wants to speed up. The relayer is not obligated but has the option to use this updated information when filling the deposit using `fillRelayWithUpdatedDeposit()`. This version uses `address` types for compatibility with systems relying on `address`-based implementations.\",\"params\":{\"depositId\":\"The deposit ID to speed up.\",\"depositor\":\"The depositor that must sign the `depositorSignature` and was the original depositor.\",\"depositorSignature\":\"The signed EIP712 hashstruct containing the deposit ID. Should be signed by the depositor account. If the depositor is a contract, it should implement EIP1271 to sign as a contract. See `_verifyUpdateV3DepositMessage()` for more details on how the signature should be constructed.\",\"updatedMessage\":\"The new message for this deposit. Can be modified if the recipient is a contract that expects to receive a message from the relay and needs to be updated.\",\"updatedOutputAmount\":\"The new output amount to use for this deposit. It should be lower than the previous value, otherwise the relayer has no incentive to use this updated value.\",\"updatedRecipient\":\"The new recipient for this deposit. Can be modified if the original recipient is a contract that expects to receive a message from the relay and needs to be changed.\"}},\"unsafeDeposit(bytes32,bytes32,bytes32,bytes32,uint256,uint256,uint256,bytes32,uint256,uint32,uint32,uint32,bytes)\":{\"details\":\"This is labeled \\\"unsafe\\\" because there is no guarantee that the depositId emitted in the resultant FundsDeposited event is unique which means that the corresponding fill might collide with an existing relay hash on the destination chain SpokePool, which would make this deposit unfillable. In this case, the depositor would subsequently receive a refund of `inputAmount` of `inputToken` on the origin chain after the fill deadline. Re-using a depositNonce is very dangerous when combined with `speedUpDeposit`, as a speed up signature can be re-used for any deposits with the same deposit ID.On the destination chain, the hash of the deposit data will be used to uniquely identify this deposit, so modifying any params in it will result in a different hash and a different deposit. The hash will comprise all parameters to this function along with this chain's chainId(). Relayers are only refunded for filling deposits with deposit hashes that map exactly to the one emitted by this contract.\",\"params\":{\"depositNonce\":\"The nonce that uniquely identifies this deposit. This function will combine this parameter with the msg.sender address to create a unique uint256 depositNonce and ensure that the msg.sender cannot use this function to front-run another depositor's unsafe deposit. This function guarantees that the resultant deposit nonce will not collide with a safe uint256 deposit nonce whose 24 most significant bytes are always 0.\",\"depositor\":\"See identically named parameter in depositV3() comments.\",\"destinationChainId\":\"See identically named parameter in depositV3() comments.\",\"exclusiveRelayer\":\"See identically named parameter in depositV3() comments.\",\"exclusivityParameter\":\"See identically named parameter in depositV3() comments.\",\"fillDeadline\":\"See identically named parameter in depositV3() comments.\",\"inputAmount\":\"See identically named parameter in depositV3() comments.\",\"inputToken\":\"See identically named parameter in depositV3() comments.\",\"message\":\"See identically named parameter in depositV3() comments.\",\"outputAmount\":\"See identically named parameter in depositV3() comments.\",\"outputToken\":\"See identically named parameter in depositV3() comments.\",\"quoteTimestamp\":\"See identically named parameter in depositV3() comments.\",\"recipient\":\"See identically named parameter in depositV3() comments.\"}},\"upgradeTo(address)\":{\"custom:oz-upgrades-unsafe-allow-reachable\":\"delegatecall\",\"details\":\"Upgrade the implementation of the proxy to `newImplementation`. Calls {_authorizeUpgrade}. Emits an {Upgraded} event.\"},\"upgradeToAndCall(address,bytes)\":{\"custom:oz-upgrades-unsafe-allow-reachable\":\"delegatecall\",\"details\":\"Upgrade the implementation of the proxy to `newImplementation`, and subsequently execute the function call encoded in `data`. Calls {_authorizeUpgrade}. Emits an {Upgraded} event.\"}},\"version\":1},\"userdoc\":{\"kind\":\"user\",\"methods\":{\"__OvmSpokePool_init(uint32,address,address,address)\":{\"notice\":\"Construct the OVM SpokePool.\"},\"__SpokePool_init(uint32,address,address)\":{\"notice\":\"Construct the base SpokePool.\"},\"chainId()\":{\"notice\":\"Returns chain ID for this network.\"},\"claimRelayerRefund(bytes32,bytes32)\":{\"notice\":\"Enables a relayer to claim outstanding repayments. Should virtually never be used, unless for some reason relayer repayment transfer fails for reasons such as token transfer reverts due to blacklisting. In this case, the relayer can still call this method and claim the tokens to a new address.\"},\"deposit(bytes32,bytes32,bytes32,bytes32,uint256,uint256,uint256,bytes32,uint32,uint32,uint32,bytes)\":{\"notice\":\"Previously, this function allowed the caller to specify the exclusivityDeadline, otherwise known as the as exact timestamp on the destination chain before which only the exclusiveRelayer could fill the deposit. Now, the caller is expected to pass in a number that will be interpreted either as an offset or a fixed timestamp depending on its value.Request to bridge input token cross chain to a destination chain and receive a specified amount of output tokens. The fee paid to relayers and the system should be captured in the spread between output amount and input amount when adjusted to be denominated in the input token. A relayer on the destination chain will send outputAmount of outputTokens to the recipient and receive inputTokens on a repayment chain of their choice. Therefore, the fee should account for destination fee transaction costs, the relayer's opportunity cost of capital while they wait to be refunded following an optimistic challenge window in the HubPool, and the system fee that they'll be charged.\"},\"depositDeprecated_5947912356(address,address,uint256,uint256,int64,uint32,bytes,uint256)\":{\"notice\":\"Called by user to bridge funds from origin to destination chain. Depositor will effectively lock tokens in this contract and receive a destination token on the destination chain. The origin => destination token mapping is stored on the L1 HubPool.The caller must first approve this contract to spend amount of originToken.The originToken => destinationChainId must be enabled.This method is payable because the caller is able to deposit native token if the originToken is wrappedNativeToken and this function will handle wrapping the native token to wrappedNativeToken.\"},\"depositFor(address,address,address,uint256,uint256,int64,uint32,bytes,uint256)\":{\"notice\":\"The only difference between depositFor and deposit is that the depositor address stored in the relay hash can be overridden by the caller. This means that the passed in depositor can speed up the deposit, which is useful if the deposit is taken from the end user to a middle layer contract, like an aggregator or the SpokePoolVerifier, before calling deposit on this contract.The caller must first approve this contract to spend amount of originToken.The originToken => destinationChainId must be enabled.This method is payable because the caller is able to deposit native token if the originToken is wrappedNativeToken and this function will handle wrapping the native token to wrappedNativeToken.\"},\"depositNow(bytes32,bytes32,bytes32,bytes32,uint256,uint256,uint256,bytes32,uint32,uint32,bytes)\":{\"notice\":\"Submits deposit and sets quoteTimestamp to current Time. Sets fill and exclusivity deadlines as offsets added to the current time. This function is designed to be called by users such as Multisig contracts who do not have certainty when their transaction will mine.\"},\"depositV3(address,address,address,address,uint256,uint256,uint256,address,uint32,uint32,uint32,bytes)\":{\"notice\":\"A version of `deposit` that accepts `address` types for backward compatibility. This function allows bridging of input tokens cross-chain to a destination chain, receiving a specified amount of output tokens. The relayer is refunded in input tokens on a repayment chain of their choice, minus system fees, after an optimistic challenge window. The exclusivity period is specified as an offset from the current block timestamp.\"},\"depositV3Now(address,address,address,address,uint256,uint256,uint256,address,uint32,uint32,bytes)\":{\"notice\":\"A version of `depositNow` that supports addresses as input types for backward compatibility. This function submits a deposit and sets `quoteTimestamp` to the current time. The `fill` and `exclusivity` deadlines are set as offsets added to the current time. It is designed to be called by users, including Multisig contracts, who may not have certainty when their transaction will be mined.\"},\"emergencyDeleteRootBundle(uint256)\":{\"notice\":\"This method is intended to only be used in emergencies where a bad root bundle has reached the SpokePool.\"},\"executeRelayerRefundLeaf(uint32,(uint256,uint256,uint256[],uint32,address,address[]),bytes32[])\":{\"notice\":\"Executes a relayer refund leaf stored as part of a root bundle. Will send the relayer the amount they sent to the recipient plus a relayer fee.\"},\"executeSlowRelayLeaf(((bytes32,bytes32,bytes32,bytes32,bytes32,uint256,uint256,uint256,uint256,uint32,uint32,bytes),uint256,uint256),uint32,bytes32[])\":{\"notice\":\"Executes a slow relay leaf stored as part of a root bundle relayed by the HubPool.\"},\"fill(bytes32,bytes,bytes)\":{\"notice\":\"Fills a single leg of a particular order on the destination chain\"},\"fillRelay((bytes32,bytes32,bytes32,bytes32,bytes32,uint256,uint256,uint256,uint256,uint32,uint32,bytes),uint256,bytes32)\":{\"notice\":\"Fulfill request to bridge cross chain by sending specified output tokens to the recipient.\"},\"fillRelayWithUpdatedDeposit((bytes32,bytes32,bytes32,bytes32,bytes32,uint256,uint256,uint256,uint256,uint32,uint32,bytes),uint256,bytes32,uint256,bytes32,bytes,bytes)\":{\"notice\":\"Identical to fillV3Relay except that the relayer wants to use a depositor's updated output amount, recipient, and/or message. The relayer should only use this function if they can supply a message signed by the depositor that contains the fill's matching deposit ID along with updated relay parameters. If the signature can be verified, then this function will emit a FilledV3Event that will be used by the system for refund verification purposes. In other words, this function is an alternative way to fill a a deposit than fillV3Relay.\"},\"getCurrentTime()\":{\"notice\":\"Gets the current time.\"},\"getUnsafeDepositId(address,bytes32,uint256)\":{\"notice\":\"Returns the deposit ID for an unsafe deposit. This function is used to compute the deposit ID in unsafeDeposit and is provided as a convenience.\"},\"initialize(uint32,address,address)\":{\"notice\":\"Construct the OVM SpokePool.\"},\"pauseDeposits(bool)\":{\"notice\":\"Pauses deposit-related functions. This is intended to be used if this contract is deprecated or when something goes awry.\"},\"pauseFills(bool)\":{\"notice\":\"Pauses fill-related functions. This is intended to be used if this contract is deprecated or when something goes awry.\"},\"relayRootBundle(bytes32,bytes32)\":{\"notice\":\"This method stores a new root bundle in this contract that can be executed to refund relayers, fulfill slow relays, and send funds back to the HubPool on L1. This method can only be called by the admin and is designed to be called as part of a cross-chain message from the HubPool's executeRootBundle method.\"},\"requestSlowFill((bytes32,bytes32,bytes32,bytes32,bytes32,uint256,uint256,uint256,uint256,uint32,uint32,bytes))\":{\"notice\":\"Request Across to send LP funds to this contract to fulfill a slow fill relay for a deposit in the next bundle.\"},\"setCrossDomainAdmin(address)\":{\"notice\":\"Change cross domain admin address. Callable by admin only.\"},\"setL1GasLimit(uint32)\":{\"notice\":\"Change L1 gas limit. Callable only by admin.\"},\"setTokenBridge(address,address)\":{\"notice\":\"Set bridge contract for L2 token used to withdraw back to L1.\"},\"setWithdrawalRecipient(address)\":{\"notice\":\"Change L1 withdrawal recipient address. Callable by admin only.\"},\"speedUpDeposit(bytes32,uint256,uint256,bytes32,bytes,bytes)\":{\"notice\":\"Depositor can use this function to signal to relayer to use updated output amount, recipient, and/or message. The speed up signature uniquely identifies the speed up based only on depositor, deposit ID and origin chain, so using this function in conjunction with unsafeDeposit is risky due to the chance of repeating a deposit ID.\"},\"speedUpV3Deposit(address,uint256,uint256,address,bytes,bytes)\":{\"notice\":\"A version of `speedUpDeposit` using `address` types for backward compatibility. This function allows the depositor to signal to the relayer to use updated output amount, recipient, and/or message when filling a deposit. This can be useful when the deposit needs to be modified after the original transaction has been mined.\"},\"unsafeDeposit(bytes32,bytes32,bytes32,bytes32,uint256,uint256,uint256,bytes32,uint256,uint32,uint32,uint32,bytes)\":{\"notice\":\"See deposit for details. This function is identical to deposit except that it does not use the global deposit ID counter as a deposit nonce, instead allowing the caller to pass in a deposit nonce. This function is designed to be used by anyone who wants to pre-compute their resultant relay data hash, which could be useful for filling a deposit faster and avoiding any risk of a relay hash unexpectedly changing due to another deposit front-running this one and incrementing the global deposit ID counter.\"}},\"notice\":\"World Chain Spoke pool.\",\"version\":1}},\"settings\":{\"compilationTarget\":{\"contracts/WorldChain_SpokePool.sol\":\"WorldChain_SpokePool\"},\"debug\":{\"revertStrings\":\"strip\"},\"evmVersion\":\"shanghai\",\"libraries\":{},\"metadata\":{\"bytecodeHash\":\"ipfs\"},\"optimizer\":{\"enabled\":true,\"runs\":800},\"remappings\":[],\"viaIR\":true},\"sources\":{\"@eth-optimism/contracts/libraries/constants/Lib_PredeployAddresses.sol\":{\"keccak256\":\"0x2bc28307af93e9716151a41a81694b56cbe513ef5eb335fb1d81f35e5db8edfa\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://bbdde142b16f7e0301b7b6a331b35ce609eaf5c9127f14f60c0008abb36e100f\",\"dweb:/ipfs/QmdKUiY6U2vh5egW1bYtvrNhpEmo4Jo4DEwUUmBCfW4eLy\"]},\"@openzeppelin/contracts-upgradeable/crosschain/errorsUpgradeable.sol\":{\"keccak256\":\"0xa1e9b651a2427925598b49ef35da5930abc07859cfac5b9dfb1912f063a024b3\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://c514518c36a3fb1c5f1a99d88857e93160c72ea1fd728c443406ad1acb43ae9a\",\"dweb:/ipfs/Qmc3oXjBNhdeM5cfWpsvewXZAhH34Scgna2W3MvLaiiapQ\"]},\"@openzeppelin/contracts-upgradeable/crosschain/optimism/LibOptimismUpgradeable.sol\":{\"keccak256\":\"0x4e749e196701e221283db53ccaafd372434cdaed2a0b1f5a81b23e36b826b3e8\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://c12147f335d1f8cfee08c853de86d06f63534fe8395f4f0c3c202c045f2ef4d2\",\"dweb:/ipfs/QmNnJzZGLymFtaaKn9zQAtxeNAGmXCDPFyjxzthkUTrKre\"]},\"@openzeppelin/contracts-upgradeable/interfaces/IERC1967Upgradeable.sol\":{\"keccak256\":\"0x47d6e06872b12e72c79d1b5eb55842f860b5fb1207b2317c2358d2766b950a7b\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://ac55bf6f92fc7b90c6d79d346163a0a02bd5c648c7fede08b20e5da96d4ae2a0\",\"dweb:/ipfs/QmQoSrHhka35iKDK5iyNt8cuXXS5ANXVPjLhfsJjktB8V9\"]},\"@openzeppelin/contracts-upgradeable/interfaces/draft-IERC1822Upgradeable.sol\":{\"keccak256\":\"0x77c89f893e403efc6929ba842b7ccf6534d4ffe03afe31670b4a528c0ad78c0f\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://496bd9b3df2455d571018c09f0c6badd29713fdeb907c6aa09d8d28cb603f053\",\"dweb:/ipfs/QmXdJDyYs6WMwMh21dez2BYPxhSUaUYFMDtVNcn2cgFR79\"]},\"@openzeppelin/contracts-upgradeable/proxy/ERC1967/ERC1967UpgradeUpgradeable.sol\":{\"keccak256\":\"0x7795808e3899c805254e3ae58074b20f799b466e3f43e057e47bedee5fb771f8\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://319853a2a682f3f72411507242669ef5e76e0ad3457be53102439709ee8948f0\",\"dweb:/ipfs/QmRtm4Ese9u4jfxXyuWPXLwzenwFotuQjAWV7rXtZTB1E9\"]},\"@openzeppelin/contracts-upgradeable/proxy/beacon/IBeaconUpgradeable.sol\":{\"keccak256\":\"0x24b86ac8c005b8c654fbf6ac34a5a4f61580d7273541e83e013e89d66fbf0908\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://4dbfe1a3b3b3fb64294ce41fd2ad362e7b7012208117864f42c1a67620a6d5c1\",\"dweb:/ipfs/QmVMU5tWt7zBQMmf5cpMX8UMHV86T3kFeTxBTBjFqVWfoJ\"]},\"@openzeppelin/contracts-upgradeable/proxy/utils/Initializable.sol\":{\"keccak256\":\"0x89be10e757d242e9b18d5a32c9fbe2019f6d63052bbe46397a430a1d60d7f794\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://f103ee2e4aecd37aac6ceefe670709cdd7613dee25fa2d4d9feaf7fc0aaa155e\",\"dweb:/ipfs/QmRiNZLoJk5k3HPMYGPGjZFd2ke1ZxjhJZkM45Ec9GH9hv\"]},\"@openzeppelin/contracts-upgradeable/proxy/utils/UUPSUpgradeable.sol\":{\"keccak256\":\"0xefb41f5c1a00249b7a99f0782f8c557865605426a3fb6e5fe9ae334293ae4f33\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://90def55e5782595aabc13f57780c02d3613e5226f20ce6c1709503a63fdeb58f\",\"dweb:/ipfs/Qmb5vcymmNEZUJMaHmYxnhvGJDEsGMae4YjcHwkA74jy99\"]},\"@openzeppelin/contracts-upgradeable/security/ReentrancyGuardUpgradeable.sol\":{\"keccak256\":\"0x2025ccf05f6f1f2fd4e078e552836f525a1864e3854ed555047cd732320ab29b\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://d27f4b23c2dee42394aebaf42bf238285230f472dfd3282a39c3f000ec28214f\",\"dweb:/ipfs/QmQa3DnvccwdWJeWrjgXPnFMTWbzWQWR39hVqC7eEwo2PC\"]},\"@openzeppelin/contracts-upgradeable/token/ERC20/IERC20Upgradeable.sol\":{\"keccak256\":\"0x0e1f0f5f62f67a881cd1a9597acbc0a5e4071f3c2c10449a183b922ae7272e3f\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://c25f742ff154998d19a669e2508c3597b363e123ce9144cd0fcf6521229f401f\",\"dweb:/ipfs/QmQXRuFzStEWqeEPbhQU6cAg9PaSowxJVo4PDKyRod7dco\"]},\"@openzeppelin/contracts-upgradeable/token/ERC20/extensions/IERC20PermitUpgradeable.sol\":{\"keccak256\":\"0x07e881de3b9f6d2c07909f193f24b96c7fe4ea60013260f3f25aecd8bab3c2f8\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://1fed09b97ccb0ff9ba9b6a94224f1d489026bf6b4b7279bfe64fb6e8749dee4d\",\"dweb:/ipfs/QmcRAzaSP1UnGr4vrGkfJmB2L9aiTYoXfV1Lg9gqrVRWn8\"]},\"@openzeppelin/contracts-upgradeable/token/ERC20/utils/SafeERC20Upgradeable.sol\":{\"keccak256\":\"0x23b997be73d3dd46885262704f0f8cfc7273fdadfe303d37969a9561373972b5\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://d03ebe5406134f0c4a017dee625ff615031194493bd1e88504e5c8fae55bc166\",\"dweb:/ipfs/QmUZV5bMbgk2PAkV3coouSeSainHN2jhqaQDJaA7hQRyu2\"]},\"@openzeppelin/contracts-upgradeable/utils/AddressUpgradeable.sol\":{\"keccak256\":\"0x9c80f545915582e63fe206c6ce27cbe85a86fc10b9cd2a0e8c9488fb7c2ee422\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://310136ad60820af4177a11a61d77a3686faf5fca4942b600e08fc940db38396b\",\"dweb:/ipfs/QmbCzMNSTL7Zi7M4UCSqBrkHtp4jjxUnGbkneCZKdR1qeq\"]},\"@openzeppelin/contracts-upgradeable/utils/StorageSlotUpgradeable.sol\":{\"keccak256\":\"0x07ac95acad040f1fb1f6120dd0aa5f702db69446e95f82613721879d30de0908\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://a9df9de7b5da1d1bd3d4b6c073d0174bc4211db60e794a321c8cb5d4eae34685\",\"dweb:/ipfs/QmWe49zj65jayrCe9jZpoWhYUZ1RiwSxyU2s7SBZnMztVy\"]},\"@openzeppelin/contracts-upgradeable/utils/StringsUpgradeable.sol\":{\"keccak256\":\"0xb96dc79b65b7c37937919dcdb356a969ce0aa2e8338322bf4dc027a3c9c9a7eb\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://f8613145881436fc0480fff22da4868d611e2b0c0c3da083334eb4362ce1945a\",\"dweb:/ipfs/QmPqpP3YeRbBdTJRe6Gv2eGsUaANf4J6RwTNRW36iYahfV\"]},\"@openzeppelin/contracts-upgradeable/utils/cryptography/ECDSAUpgradeable.sol\":{\"keccak256\":\"0xa014f65d84b02827055d99993ccdbfb4b56b2c9e91eb278d82a93330659d06e4\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://50a7e716a74f3d48a7f549086faa94afcd58b9f18ac8e9f74af4571f3a1d8d5c\",\"dweb:/ipfs/QmTkDNWkq5o9Cv2jS7s6JvSmsPBkeunZhPe7Z2njGL31wo\"]},\"@openzeppelin/contracts-upgradeable/utils/math/MathUpgradeable.sol\":{\"keccak256\":\"0x2bc0007987c229ae7624eb29be6a9b84f6a6a5872f76248b15208b131ea41c4e\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://2b2835c737d073ef8b82a4cc246495a9740f43e7ff2cf130906b2449ff9bfb91\",\"dweb:/ipfs/QmSCWfNoSvvTN57ic7o1RW6NqSxxGAqbBTnLKc7QHe27qB\"]},\"@openzeppelin/contracts-upgradeable/utils/math/SignedMathUpgradeable.sol\":{\"keccak256\":\"0x88f6b7bba3ee33eeb741f9a0f5bc98b6e6e352d0fe4905377bb328590f84095a\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://88ace2d60f265752f18903d839910be4e4e104340b2957678585b812447825d4\",\"dweb:/ipfs/QmXFkNxMc3AAGzhs2wUEZyErWQjsvoTGyYjuU5oZkFki5Z\"]},\"@openzeppelin/contracts-upgradeable/vendor/optimism/ICrossDomainMessengerUpgradeable.sol\":{\"keccak256\":\"0xb531a6941d55a97d0db7af85c19b6aaf7fc634e550b513daa28e874b2c9b2dfa\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://23b0ce75313d9863512271a51940f6876051a5cb6dce60dd06bc03e565631b9d\",\"dweb:/ipfs/QmZobv3VixcvPxVF6hZgWxo8ELd9nXK935aiBpyHypYSoL\"]},\"@openzeppelin/contracts/interfaces/IERC1271.sol\":{\"keccak256\":\"0x0705a4b1b86d7b0bd8432118f226ba139c44b9dcaba0a6eafba2dd7d0639c544\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://c45b821ef9e882e57c256697a152e108f0f2ad6997609af8904cae99c9bd422e\",\"dweb:/ipfs/QmRKCJW6jjzR5UYZcLpGnhEJ75UVbH6EHkEa49sWx2SKng\"]},\"@openzeppelin/contracts/token/ERC20/IERC20.sol\":{\"keccak256\":\"0x287b55befed2961a7eabd7d7b1b2839cbca8a5b80ef8dcbb25ed3d4c2002c305\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://bd39944e8fc06be6dbe2dd1d8449b5336e23c6a7ba3e8e9ae5ae0f37f35283f5\",\"dweb:/ipfs/QmPV3FGYjVwvKSgAXKUN3r9T9GwniZz83CxBpM7vyj2G53\"]},\"@openzeppelin/contracts/token/ERC20/extensions/IERC20Permit.sol\":{\"keccak256\":\"0xb264c03a3442eb37a68ad620cefd1182766b58bee6cec40343480392d6b14d69\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://28879d01fd22c07b44f006612775f8577defbe459cb01685c5e25cd518c91a71\",\"dweb:/ipfs/QmVgfkwv2Fxw6hhTcDUZhE7NkoSKjab3ipM7UaRbt6uXb5\"]},\"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\":{\"keccak256\":\"0xabefac93435967b4d36a4fabcbdbb918d1f0b7ae3c3d85bc30923b326c927ed1\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://9d213d3befca47da33f6db0310826bcdb148299805c10d77175ecfe1d06a9a68\",\"dweb:/ipfs/QmRgCn6SP1hbBkExUADFuDo8xkT4UU47yjNF5FhCeRbQmS\"]},\"@openzeppelin/contracts/utils/Address.sol\":{\"keccak256\":\"0x006dd67219697fe68d7fbfdea512e7c4cb64a43565ed86171d67e844982da6fa\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://2455248c8ddd9cc6a7af76a13973cddf222072427e7b0e2a7d1aff345145e931\",\"dweb:/ipfs/QmfYjnjRbWqYpuxurqveE6HtzsY1Xx323J428AKQgtBJZm\"]},\"@openzeppelin/contracts/utils/Strings.sol\":{\"keccak256\":\"0x3088eb2868e8d13d89d16670b5f8612c4ab9ff8956272837d8e90106c59c14a0\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://b81d9ff6559ea5c47fc573e17ece6d9ba5d6839e213e6ebc3b4c5c8fe4199d7f\",\"dweb:/ipfs/QmPCW1bFisUzJkyjroY3yipwfism9RRCigCcK1hbXtVM8n\"]},\"@openzeppelin/contracts/utils/cryptography/ECDSA.sol\":{\"keccak256\":\"0x809bc3edb4bcbef8263fa616c1b60ee0004b50a8a1bfa164d8f57fd31f520c58\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://8b93a1e39a4a19eba1600b92c96f435442db88cac91e315c8291547a2a7bcfe2\",\"dweb:/ipfs/QmTm34KVe6uZBZwq8dZDNWwPcm24qBJdxqL3rPxBJ4LrMv\"]},\"@openzeppelin/contracts/utils/cryptography/MerkleProof.sol\":{\"keccak256\":\"0xcf688741f79f4838d5301dcf72d0af9eff11bbab6ab0bb112ad144c7fb672dac\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://85d9c87a481fe99fd28a146c205da0867ef7e1b7edbe0036abc86d2e64eb1f04\",\"dweb:/ipfs/QmR7m1zWQNfZHUKTtqnjoCjCBbNFcjCxV27rxf6iMfhVtG\"]},\"@openzeppelin/contracts/utils/cryptography/SignatureChecker.sol\":{\"keccak256\":\"0x3af3ca86df39aac39a0514c84459d691434a108d2151c8ce9d69f32e315cab80\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://77d1f1cf302cd5e1dfbbb4ce3b281b28e8c52942d4319fce43df2e1b6f02a52d\",\"dweb:/ipfs/QmT6ZXStmK3Knhh9BokeVHQ9HXTBZNgL3Eb1ar1cYg1hWy\"]},\"@openzeppelin/contracts/utils/math/Math.sol\":{\"keccak256\":\"0xe4455ac1eb7fc497bb7402579e7b4d64d928b846fce7d2b6fde06d366f21c2b3\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://cc8841b3cd48ad125e2f46323c8bad3aa0e88e399ec62acb9e57efa7e7c8058c\",\"dweb:/ipfs/QmSqE4mXHA2BXW58deDbXE8MTcsL5JSKNDbm23sVQxRLPS\"]},\"@openzeppelin/contracts/utils/math/SignedMath.sol\":{\"keccak256\":\"0xf92515413956f529d95977adc9b0567d583c6203fc31ab1c23824c35187e3ddc\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://c50fcc459e49a9858b6d8ad5f911295cb7c9ab57567845a250bf0153f84a95c7\",\"dweb:/ipfs/QmcEW85JRzvDkQggxiBBLVAasXWdkhEysqypj9EaB6H2g6\"]},\"contracts/MerkleLib.sol\":{\"keccak256\":\"0xdaf19fdc82593b79a608af8f691aec89a3c0e47b210770deabbe66ece7c35bb1\",\"license\":\"BUSL-1.1\",\"urls\":[\"bzz-raw://03c37f78657beed37257187e237d74492de0199734aa03272a419f66161c0dca\",\"dweb:/ipfs/QmdcXMAoRLZejhh2xcVMWR3WfUvXcArKrCFEE82JDYiJbh\"]},\"contracts/Ovm_SpokePool.sol\":{\"keccak256\":\"0xc46d3c3c1b493137eca6fbe8cd9eae2381cb792945e7ede376cbe15ef95b5454\",\"license\":\"BUSL-1.1\",\"urls\":[\"bzz-raw://7e76ca618799ea810d1fce4449d55ec3bbfbe7482374cf4259755e0103a91c19\",\"dweb:/ipfs/QmVoiCjM4yKCLxe2TNL9i9QViYFCd4f2v9wB37ogtwb6Md\"]},\"contracts/SpokePool.sol\":{\"keccak256\":\"0xc3ef7fff0c2985702bfd44a22f6b3b8b7e6150d37dd3e1db1bc966e892d629a9\",\"license\":\"BUSL-1.1\",\"urls\":[\"bzz-raw://be57513109cc0282ca1c307188c1b03595d547d66ced6d64cdc9040f19171f2a\",\"dweb:/ipfs/QmcoNGPYJk6e24Ma5T5wPaz2nXtPxqd1WQHjfXUXVHKegX\"]},\"contracts/WorldChain_SpokePool.sol\":{\"keccak256\":\"0xb70316e7560e04c79acdb9e4550567b0d96877d6d62637effa5c3ff7443af8bd\",\"license\":\"BUSL-1.1\",\"urls\":[\"bzz-raw://010c34b5e1df625843a129b5503cb99a1db910ab96542fbbf6731ec81b86bb5e\",\"dweb:/ipfs/QmPztgbFieX6axTtLPc15NusRZcKKu3dWxh63DeyaAhTub\"]},\"contracts/erc7683/ERC7683.sol\":{\"keccak256\":\"0x726d0426b0f3a11ff59d3a5bbe433c182c0feac9ea2c8c75377fcc2693eccded\",\"license\":\"GPL-3.0-or-later\",\"urls\":[\"bzz-raw://99336cc59dd5923815a8fad6e200b7b265e8446414b099e9b17e3f15f094b774\",\"dweb:/ipfs/QmWCrqefGqEpKsvfn1oBzTTUAFBjscjHc6g1EX2ab51bGA\"]},\"contracts/erc7683/ERC7683Permit2Lib.sol\":{\"keccak256\":\"0x47bf69c597fd6735fd4bb24c42d78a2c967d9bce0c303fe0a8ddafe6d2321f94\",\"license\":\"UNLICENSED\",\"urls\":[\"bzz-raw://d37b60c5b94d9bb29c42d41dd18dacbc54649921d5cdf85d8c20bb4e43c415b9\",\"dweb:/ipfs/QmZFhiKWztX7UTG6w4wrcK5LSaMHFKH7NxVgrzkxV24bEs\"]},\"contracts/external/interfaces/CCTPInterfaces.sol\":{\"keccak256\":\"0x69059bd91cdb9bea59242c543a167e38a9f3a7788687d4194f68420a956c7608\",\"license\":\"GPL-3.0-or-later\",\"urls\":[\"bzz-raw://0d0781aeb87d7f860ab9ff49c6c6af60b0e93fb547108b98ba8c8501c3980104\",\"dweb:/ipfs/QmY9H7YiXn3a8jdQgcADboxSEsi5V4F7CPcJrWNbxGToAu\"]},\"contracts/external/interfaces/IPermit2.sol\":{\"keccak256\":\"0x68f40961ee44fbc71eff2037f2c88ba9bfbccf35b9b1eae5a527b71d19bf3a71\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://2281f309f1b0df4d1c9beeeaa2673152c73e6e20991438420a9de18c51269ea7\",\"dweb:/ipfs/QmafDC3g5yBqPvSof5FmGKv4gMR3TXT5Xj3tULDA5CKmaE\"]},\"contracts/external/interfaces/WETH9Interface.sol\":{\"keccak256\":\"0x3f7892554ec7f54681fdd3cc18a41346c246c9c1afba016c52990ef77741f718\",\"license\":\"BUSL-1.1\",\"urls\":[\"bzz-raw://76e901f8da798eb2fdef8fd0083a51088103269f08ee751598c5a6eba407785f\",\"dweb:/ipfs/QmcAHbwbwCZd78teaK4cHuAvXq71aWX1r9vTGkSRRBDJV1\"]},\"contracts/interfaces/HubPoolInterface.sol\":{\"keccak256\":\"0xd8cfdded5db9bf29099e91abd8c8992b4deba1a22d4ffaed94c43ff3d47dcf33\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://aeefb0b7816fbfe2f63968f34726155d30b0428558df9a20f839042795b24c82\",\"dweb:/ipfs/QmT5uYJenMLkiBEWtzdEZ4SnsysAhQ9uyHdx3pKNU1gyVy\"]},\"contracts/interfaces/SpokePoolInterface.sol\":{\"keccak256\":\"0x67734f330d9b5eb5f7ea7f9f32d2d1cc107879154e9c9424623c6df1709b48e0\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://d80f8ef8f10046624d7ab588538f041bab0c18e475e90b287505d5feae52578f\",\"dweb:/ipfs/QmS7QbHqygik4H6BSm1Cvypx8cWB6QxoHSPZ3FAVDkgYQj\"]},\"contracts/interfaces/SpokePoolMessageHandler.sol\":{\"keccak256\":\"0xc522e2ee6d874df26cae297fc23fc6e8b5216fc8d1901299bb147a25a8c6c259\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://8942693e1cef207ae68750884e9e3c221df24dafe897af0ae6a1339e17391c29\",\"dweb:/ipfs/QmSCSQ5DNBetH8xUa73vWXR3D4CdsV6hHFmDqtT2QwLuWt\"]},\"contracts/interfaces/V3SpokePoolInterface.sol\":{\"keccak256\":\"0x15819fd7ff7b33d3fc55de30a5eb1136dfbcf953be2a962dddc550d77e1823fe\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://4f8c43279c38b718fe471171f8dd2eb9f6e8550b939ce65c7c71f0aa6233c421\",\"dweb:/ipfs/QmXFCLp8jWNKi7QRYTN9ZyNoxsTL1RZfJPLMYzUN9xQC9K\"]},\"contracts/libraries/AddressConverters.sol\":{\"keccak256\":\"0x378f28bb4a17a5c47457cb9341086b2140f7faf6c048f702d3528166f0d74453\",\"license\":\"BUSL-1.1\",\"urls\":[\"bzz-raw://0fa273e028c9555202cac439ddf458d074b66c6f74778b2b0e5e17a0e331dc38\",\"dweb:/ipfs/QmYqEaWXgiJnsH8wRAuTKF41bxkxxvY947wdKoZrjM7HVx\"]},\"contracts/libraries/CircleCCTPAdapter.sol\":{\"keccak256\":\"0x5007254d87c41857f737ddee8b06ef5838182acf6c593f8cc7ced972e03feecb\",\"license\":\"BUSL-1.1\",\"urls\":[\"bzz-raw://6559694d840b3fdbef6da3079478e0ffc168fef81a568633ecb2b9fb860caf34\",\"dweb:/ipfs/QmNnnB5pr745DFZTfDsFSq3BJi2DooaRM8f31qGwXNjLrb\"]},\"contracts/upgradeable/AddressLibUpgradeable.sol\":{\"keccak256\":\"0x655040da45a857cf609d7176c7b0647bf76d36e73e856af79d511014c7e8ef81\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://5c17767f34d57380767b49f8584d62598964fc813e6f3587d76b51ec2357bb4e\",\"dweb:/ipfs/QmSyoTa1Snn3KiJD7KjCwsPmNqpJzusXterbEXxbYCZoJK\"]},\"contracts/upgradeable/EIP712CrossChainUpgradeable.sol\":{\"keccak256\":\"0xff617722706d1c0a6d346e56e4598cc5f60adea99b4ac1d2347dcd69270a14f6\",\"license\":\"BUSL-1.1\",\"urls\":[\"bzz-raw://e2d04649c09bad766c5632da2e3a4f1deed1e013e8b713fad1f101e06f4b56a3\",\"dweb:/ipfs/QmfCewdTDr2krzvNY5rH5BprngEtBmxPXCZf6JKavxw2Sb\"]},\"contracts/upgradeable/MultiCallerUpgradeable.sol\":{\"keccak256\":\"0xc1378a7d63785d9381b8fb6e42962499ab26a243292e20981c2792511a4697f3\",\"license\":\"BUSL-1.1\",\"urls\":[\"bzz-raw://2ec8d733e528d6e79732409eb04aa5f8a8bcdf5888e677919a07d8b84afb1598\",\"dweb:/ipfs/QmQF23Gf9vHb6Ne6kaEZmQTjobWzasEWWr5YaBFkuEypz4\"]}},\"version\":1}",
+ "bytecode": "0x61018060409080825234620002b85760a081620056ac8038038091620000268285620002bc565b833981010312620002b85780516001600160a01b038082169391849003620002b85760209162000058838501620002e0565b9162000066828601620002e0565b6060860151958287168703620002b857608001519382851697888603620002b8573060805260a05260c05260e0525f5460ff8160081c16620002b85760ff808216036200027f575b506101209485526101409283525f610100908152825163011a412160e61b8682019081526004825291976001600160401b039282860191908483118484101762000261575f938493885251915afa943d1562000275573d918211620002615783519162000125601f8201601f1916830184620002bc565b82523d5f8284013e5b8562000255575b8562000220575b50505061016092835251926153b99485620002f38639608051858181610f85015281816114a101526115cd015260a051858181610860015281816136d80152818161383701528181613e58015281816140ea015281816143b90152818161482401528181614bcd0152614bf4015260c0518581816117d50152818161368c0152614572015260e05185818161044e015261436201525184818161197e0152818161510e01526151b901525183818161080301528181614b700152614fef015251828181611e7e015281816149420152615012015251818181611a7c01526150ae0152f35b90919294508082519201519181811062000244575b5050161515915f80806200013c565b5f19910360031b1b165f8062000235565b81518114955062000135565b634e487b7160e01b5f52604160045260245ffd5b606091506200012e565b60ff90811916175f557f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb384740249884835160ff8152a15f620000ae565b5f80fd5b601f909101601f19168101906001600160401b038211908210176200026157604052565b519063ffffffff82168203620002b85756fe6080604052600436101561001a575b3615610018575f80fd5b005b5f3560e01c8063079bd2c71461041f5780630c5d5f731461041a5780630eaac9f0146104155780631186ec331461041057806311eac8551461040b57806315348e44146103a257806317fcb39b146104065780631b3d5559146104015780631fab657c146103fc57806329cb924d146103f75780632e378115146103f25780632e63e59a146103ed5780633659cfe6146103e8578063431023b8146103e3578063437b9116146103de578063490e49ef146103d9578063493a4f84146103d45780634f1ef286146103cf5780635285e058146103ca57806352d1902d146103c5578063541f4f14146103c0578063577f51f8146103bb57806357f6dcb8146103b65780636068d6cb146103b1578063647c576c146103ac578063670fa8ac146103a75780636bbbcd2e146103a25780636e4009831461039d578063738b62e514610398578063766e070314610393578063775c0d031461038e5780637aef642c146103895780637b939232146103845780637ef413e11461037f57806382e2c43f1461037a5780638a7860ce146103755780638b15788e14610370578063927ede2d1461036b5780639748cf7c1461036657806397943aa914610361578063979f2bc21461035c57806399cc2968146103575780639a8a059214610352578063a1244c671461034d578063a18a096e14610348578063ac9650d814610343578063ad5425c61461033e578063adb5a6a6146102f3578063b27a430014610339578063b370b7f514610334578063babb6aac1461032f578063bf10268d1461032a578063c35c83fc14610325578063ceb4c98714610320578063d7e1583a1461031b578063dda5211314610316578063ddd224f114610311578063de7eba781461030c578063deff4b2414610307578063e322921114610302578063ea86bd46146102fd578063ee2a53f8146102f8578063f79f29ed146102f3578063fbbba9ac146102ee5763fc8a584f0361000e57612af3565b612a6f565b61242e565b612a31565b61292e565b612905565b612810565b6127e0565b6127b7565b612791565b61275b565b612661565b612636565b6125b2565b6124db565b6124b4565b612475565b6122cd565b61222d565b6120c6565b61209f565b612085565b611ff0565b611f22565b611ea2565b611e5f565b611e31565b611db3565b611d3b565b611c20565b611be9565b611b41565b611aa1565b611a65565b611a41565b6119ac565b611962565b610827565b611928565b611851565b6117f9565b6117b9565b6116e0565b61161d565b6115b3565b61158c565b61145e565b6113d7565b6113b9565b6112ec565b61108f565b610f5d565b610d63565b610c03565b610bda565b610ad8565b6109cf565b610841565b6107e4565b610743565b6104f6565b610490565b610432565b5f91031261042e57565b5f80fd5b3461042e575f36600319011261042e57602060405163ffffffff7f0000000000000000000000000000000000000000000000000000000000000000168152f35b6001600160a01b0381160361042e57565b359061048e82610472565b565b3461042e57602036600319011261042e5760206004356104af81610472565b6001600160a01b038091165f52610c5d825260405f205416604051908152f35b63ffffffff81160361042e57565b610144359061048e826104cf565b359061048e826104cf565b3461042e57602036600319011261042e5763ffffffff600435610518816104cf565b610520613501565b6105286135c3565b16610c5a8163ffffffff198254161790557fe486a5c4bd7b36eabbfe274c99b39130277417be8d2209b4dae04c4fba64ee3a5f80a26001606555005b634e487b7160e01b5f52604160045260245ffd5b6040810190811067ffffffffffffffff82111761059457604052565b610564565b6101a0810190811067ffffffffffffffff82111761059457604052565b67ffffffffffffffff811161059457604052565b6060810190811067ffffffffffffffff82111761059457604052565b6080810190811067ffffffffffffffff82111761059457604052565b6020810190811067ffffffffffffffff82111761059457604052565b60e0810190811067ffffffffffffffff82111761059457604052565b60a0810190811067ffffffffffffffff82111761059457604052565b90601f8019910116810190811067ffffffffffffffff82111761059457604052565b6040519060c0820182811067ffffffffffffffff82111761059457604052565b60405190610180820182811067ffffffffffffffff82111761059457604052565b6040519061048e82610599565b6040519061048e826105e6565b67ffffffffffffffff811161059457601f01601f191660200190565b9291926106fb826106d3565b916107096040519384610656565b82948184528183011161042e578281602093845f960137010152565b9080601f8301121561042e57816020610740933591016106ef565b90565b61010036600319011261042e5760043561075c81610472565b60243561076881610472565b6084358060070b810361042e5760a43590610782826104cf565b60c43567ffffffffffffffff811161042e576107a2903690600401610725565b926107ab6135c3565b60ff61086b5460e81c166107d2576107cb9460643591604435913361363e565b6001606555005b604051630b4cba3160e31b8152600490fd5b3461042e575f36600319011261042e5760206040516001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000168152f35b3461042e575f36600319011261042e5760206040515f8152f35b3461042e575f36600319011261042e5760206040516001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000168152f35b67ffffffffffffffff81116105945760051b60200190565b9080601f8301121561042e5760209082356108b681610884565b936108c46040519586610656565b81855260208086019260051b82010192831161042e57602001905b8282106108ed575050505090565b813581529083019083016108df565b9080601f8301121561042e57602090823561091681610884565b936109246040519586610656565b81855260208086019260051b82010192831161042e57602001905b82821061094d575050505090565b838091833561095b81610472565b81520191019061093f565b929161097182610884565b9161097f6040519384610656565b829481845260208094019160051b810192831161042e57905b8282106109a55750505050565b81358152908301908301610998565b9080601f8301121561042e5781602061074093359101610966565b60031960603682011261042e576004356109e8816104cf565b60243567ffffffffffffffff9283821161042e5760c090823603011261042e57610a10610678565b908060040135825260248101356020830152604481013584811161042e57610a3e906004369184010161089c565b6040830152610a4f606482016104eb565b6060830152610a6060848201610483565b608083015260a48101359084821161042e576004610a8192369201016108fc565b60a082015260443592831161042e57610aa16100189336906004016109b4565b91612b23565b9181601f8401121561042e5782359167ffffffffffffffff831161042e576020808501948460051b01011161042e57565b3461042e5760031960603682011261042e5760043567ffffffffffffffff80821161042e5760608236039384011261042e5760243590610b17826104cf565b60443590811161042e57610b2f903690600401610aa7565b919093610b3a6135c3565b600484013590610182190181121561042e57610bd094610bcb93610b67610bc4936004369189010161267f565b95610b7d610b786080890151613b84565b61382d565b610b8687613434565b9060446020890151916101608a015193610b9e610678565b9a8b5260208b015201356040890152606088015260808701525f60a08701523691610966565b9083613b9a565b613ceb565b6100186001606555565b3461042e575f36600319011261042e576020604051428152f35b908161018091031261042e5790565b3461042e57604036600319011261042e5760043567ffffffffffffffff811161042e57610c34903690600401610bf4565b610c3d81612d1b565b6001600160a01b031690610c5360208201612d1b565b6001600160a01b031691610c6960408301612d1b565b6001600160a01b0316610c7e60608401612d1b565b6001600160a01b031692610c9460808201612d1b565b6001600160a01b031690610100610cac818301612d25565b9061012090610cbc848301612d25565b9261014094858101610ccd90612d25565b966101609a8b8301610cdf9084612d2f565b9a909b610cea610698565b9e8f91825260208201526040015260608d015260808c015260a081013560a08c015260c081013560c08c015260e0013560e08b015263ffffffff1690890152870190610d3b919063ffffffff169052565b63ffffffff909116908501523690610d52926106ef565b908201523360243561001892613465565b3461042e57602036600319011261042e576004803567ffffffffffffffff811161042e57610d949036908301610bf4565b610d9c6135c3565b60ff61086b5460e01c16610f4d5763ffffffff80421692610140830193610dd581610dc687612d25565b63ffffffff9182169116101590565b610f3d57610120840192610de884612d25565b1610610f2e57610e00610dfb368561267f565b613434565b90610e14825f5261087260205260405f2090565b54610f205750610e637f3cee3e290f36226751cd0b3321b213890fe9c768e922f267fa6111836ce05c3292610e5e610e58610e69945f5261087260205260405f2090565b60019055565b612d25565b93612d25565b610e89610e84610e7d610160860186612d2f565b36916106ef565b6141c0565b90610f136040519283926101008701359760e08801359760208101359281359260408301359260c08101359060a081013590606060808201359101358b9693909a999895919261012098959361014089019c895260208901526040880152606087015263ffffffff80921660808701521660a085015260c084015260e08301526101008201520152565b0390a36100186001606555565b604051624be79160e21b8152fd5b60405163d642b7d960e01b8152fd5b50604051630277ae7b60e21b8152fd5b50604051633d90fc5560e11b8152fd5b3461042e57602036600319011261042e57600435610f7a81610472565b6001600160a01b03807f00000000000000000000000000000000000000000000000000000000000000001680301461042e577f360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc90828254160361042e57610fdf613501565b60405191610fec83610602565b5f83527f4910fdfa16fed3260ed0e7147f7cc6da11a60208b5b9406d12a635614ffd91435460ff16156110255750505061001890614d8c565b6020600491604051928380926352d1902d60e01b825288165afa5f918161105e575b50611050575f80fd5b0361042e5761001891614c73565b61108191925060203d602011611088575b6110798183610656565b810190613987565b905f611047565b503d61106f565b3461042e57608036600319011261042e576004356110ac816104cf565b602435906110b982610472565b6044356110c581610472565b606435916110d283610472565b60ff5f5460081c161561042e5761111990610c5a624c4b4063ffffffff1982541617905561086b9063ffffffff60c01b1963ffffffff60c01b83549260c01b169116179055565b6040519061112682610578565b6009825260208201916820a1a927a9a996ab1960b91b8352640312e302e360dc1b602060405161115581610578565b60058152015260ff5f5460081c161561042e57610018946111ba936111b59251902061047f557f06c015bd22b4c69690933c1058878ebdfef31f9aaae40bbe86d8a09fe1b2972c610480556111a8614599565b6111b06145a8565b6145bc565b614616565b610c5a9077ffffffffffffffffffffffffffffffffffffffff000000001977ffffffffffffffffffffffffffffffffffffffff0000000083549260201b169116179055565b602060031982011261042e576004359067ffffffffffffffff821161042e5761122a91600401610aa7565b9091565b5f5b83811061123f5750505f910152565b8181015183820152602001611230565b906020916112688151809281855285808601910161122e565b601f01601f1916010190565b6020808201908083528351809252604092604081018260408560051b8401019601945f925b8584106112aa575050505050505090565b9091929394959685806112db600193603f1986820301885286838d518051151584520151918185820152019061124f565b990194019401929594939190611299565b3461042e576112fa366111ff565b61130381610884565b9160406113136040519485610656565b828452601f1961132284610884565b015f5b8181106113965750505f5b83811061134957604051806113458782611274565b0390f35b8061139061135960019388612d85565b515f80611367858a8a612d99565b90611376895180938193612db0565b0390305af490611384612dbd565b60208201529015159052565b01611330565b60209083516113a481610578565b5f815282606081830152828901015201611325565b3461042e575f36600319011261042e5760206040516301e133808152f35b3461042e57604036600319011261042e576024356004356113f6613501565b6113fe6135c3565b61086c8054680100000000000000008110156105945763ffffffff916001820190558361142a826129f2565b5084600182015555167fc86ba04c55bc5eb2f2876b91c438849a296dbec7b08751c3074d92e04f0a77af5f80a46001606555005b604036600319011261042e5760043561147681610472565b60243567ffffffffffffffff811161042e57611496903690600401610725565b6001600160a01b03807f0000000000000000000000000000000000000000000000000000000000000000169081301461042e577f360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc91818354160361042e576114fc613501565b7f4910fdfa16fed3260ed0e7147f7cc6da11a60208b5b9406d12a635614ffd91435460ff16156115325750505061001890614d8c565b6020600491604051928380926352d1902d60e01b825288165afa5f918161156b575b5061155d575f80fd5b0361042e5761001891614d3b565b61158591925060203d602011611088576110798183610656565b905f611554565b3461042e575f36600319011261042e5760206001600160a01b036108695416604051908152f35b3461042e575f36600319011261042e576001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016300361042e5760206040517f360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc8152f35b61012036600319011261042e5760043561163681610472565b6024359061164382610472565b6044359161165083610472565b60a4358060070b810361042e5760c4359161166a836104cf565b60e43567ffffffffffffffff811161042e5761168a903690600401610725565b936116936135c3565b60ff61086b5460e81c166107d2576107cb95608435926064359261363e565b9181601f8401121561042e5782359167ffffffffffffffff831161042e576020838186019501011161042e57565b3461042e5760c036600319011261042e576004356116fd81610472565b6024356044359160643561171081610472565b67ffffffffffffffff9160843583811161042e576117329036906004016116b2565b60a49491943591821161042e577f45e04bc8f121ba11466985789ca2822a91109f31bb8ac85504a37b7eaf873c26946117726117b49336906004016116b2565b9290916001600160a01b038097166117a68a8c836117913688886106ef565b9161179d368b8b6106ef565b9346908d6141d5565b604051978897169a87612e0c565b0390a3005b3461042e575f36600319011261042e57602060405163ffffffff7f0000000000000000000000000000000000000000000000000000000000000000168152f35b3461042e575f36600319011261042e57602060ff61086b5460e81c166040519015158152f35b606090600319011261042e57600435611837816104cf565b9060243561184481610472565b9060443561074081610472565b3461042e5761185f3661181f565b5f54600881901c60ff161593929084908161191a575b81156118fa575b501561042e576118a09284611897600160ff195f5416175f55565b6118e357612e3f565b6118a657005b6118b461ff00195f54165f55565b604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb384740249890602090a1005b6118f561010061ff00195f5416175f55565b612e3f565b303b1591508161190c575b505f61187c565b6001915060ff16145f611905565b600160ff8216109150611875565b3461042e575f36600319011261042e5760206040517f8d1994e2bbbd77564cdca06dd819e7ee2a5efa06c80dcb59a4a7b6e39edc538f8152f35b3461042e575f36600319011261042e57602060405163ffffffff7f0000000000000000000000000000000000000000000000000000000000000000168152f35b8015150361042e57565b3461042e57602036600319011261042e577fe88463c2f254e2b070013a2dc7ee1e099f9bc00534cbdf03af551dc26ae4921960206004356119ec816119a2565b6119f4613501565b6119fc6135c3565b151561086b80547fffff00ffffffffffffffffffffffffffffffffffffffffffffffffffffffffff60ff60e81b8460e81b169116179055604051908152a16001606555005b3461042e575f36600319011261042e57602063ffffffff610c5a5416604051908152f35b3461042e575f36600319011261042e5760206040517f000000000000000000000000000000000000000000000000000000000000000015158152f35b61016036600319011261042e57600435611aba81610472565b60243590611ac782610472565b604435611ad381610472565b60643590611ae082610472565b60e435611aec81610472565b6101043590611afa826104cf565b6101243592611b08846104cf565b610144359667ffffffffffffffff881161042e57611b2d6100189836906004016116b2565b97909660c4359360a4359360843593612f85565b61018036600319011261042e57600435611b5a81610472565b60243590611b6782610472565b604435611b7381610472565b60643590611b8082610472565b60e435611b8c81610472565b61010435611b99816104cf565b6101243591611ba7836104cf565b611baf6104dd565b93610164359767ffffffffffffffff891161042e57611bd56100189936906004016116b2565b98909760c4359360a4359360843593612fa7565b3461042e57606036600319011261042e576020611c18600435611c0b81610472565b60443590602435906130c2565b604051908152f35b3461042e57606036600319011261042e5767ffffffffffffffff60243581811161042e57611c529036906004016116b2565b9160443590811161042e57611c6b9036906004016116b2565b9060405193602085019480611c824684888a6130fe565b0395611c96601f1997888101845283610656565b6004359151902003611d29575f94611cc5611ce793611cbc87611cf3958a990190612735565b9581019061311b565b519360405193849160208301966337bfd2c960e21b88523391602485016131e3565b03908101835282610656565b5190305af4611d00612dbd565b9015611d0857005b60405163b8fe37a760e01b8152908190611d259060048301613205565b0390fd5b604051630f0c8f4760e11b8152600490fd5b3461042e57602036600319011261042e57600435611d57613501565b611d5f6135c3565b611d68816129f2565b611da0576001815f80935501557f7c1af0646963afc3343245b103731965735a893347bfa0d58a5dc77a77ae691c5f80a26001606555005b634e487b7160e01b5f525f60045260245ffd5b6101a036600319011261042e5761012435611dcd816104cf565b61014435611dda816104cf565b6101643591611de8836104cf565b610184359267ffffffffffffffff841161042e57611e0d6100189436906004016116b2565b9390926101043560e43560c43560a435608435606435604435602435600435613216565b3461042e575f36600319011261042e5760206040517342000000000000000000000000000000000000078152f35b3461042e575f36600319011261042e5760206040516001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000168152f35b3461042e5760e036600319011261042e5767ffffffffffffffff60043581811161042e57611ed4903690600401610bf4565b60a43582811161042e57611eec9036906004016116b2565b60c49291923593841161042e57611f0a6100189436906004016116b2565b9390926084359060643590604435906024359061328e565b3461042e57611f303661181f565b909160ff5f5460081c161561042e57611f669061086b9063ffffffff60c01b1963ffffffff60c01b83549260c01b169116179055565b604051611f7281610578565b6009815260208101926820a1a927a9a996ab1960b91b8452640312e302e360dc1b6020604051611fa181610578565b60058152015260ff5f5460081c161561042e57610018936111b59251902061047f557f06c015bd22b4c69690933c1058878ebdfef31f9aaae40bbe86d8a09fe1b2972c610480556111a8614599565b3461042e57602036600319011261042e577f2d5b62420992e5a4afce0e77742636ca2608ef58289fd2e1baa5161ef6e7e41e6020600435612030816119a2565b612038613501565b6120406135c3565b151561086b80547fffffff00ffffffffffffffffffffffffffffffffffffffffffffffffffffffff60ff60e01b8460e01b169116179055604051908152a16001606555005b3461042e575f36600319011261042e576020604051468152f35b3461042e575f36600319011261042e57602063ffffffff61086b5460c01c16604051908152f35b3461042e57604036600319011261042e576004356024356120e682614b97565b6001600160a01b0382165f5261087360205261211560405f20336001600160a01b03165f5260205260405f2090565b549182156121b8575f61215c3361214661212e85613b84565b6001600160a01b03165f5261087360205260405f2090565b906001600160a01b03165f5260205260405f2090565b556121888361217961216d84613b84565b6001600160a01b031690565b61218285613b84565b90614670565b60405192835233927f6c172ea51018fb2eb2118f3f8a507c4df71eb519b8c0052834dc3c920182fef490602090a4005b6040516336542bf760e21b8152600490fd5b6020808201906020835283518092526040830192602060408460051b8301019501935f915b8483106121ff5750505050505090565b909192939495848061221d600193603f198682030187528a5161124f565b98019301930191949392906121ef565b3461042e5761223b366111ff565b9061224582613377565b915f5b81811061225d576040518061134586826121ca565b5f8061226a838587612d99565b9061227a60405180938193612db0565b0390305af4612287612dbd565b90156122ad579060019161229b8287612d85565b526122a68186612d85565b5001612248565b604481511061042e5780600461042e9201516024809183010191016133c0565b6101808060031936011261042e57610104356122e8816104cf565b61012435916122f6836104cf565b6101443592612304846104cf565b6101643567ffffffffffffffff811161042e576123259036906004016116b2565b61232d6135c3565b61086b549260ff8460e81c166107d257610bd0966123f2610e7d926123e463ffffffff6124009860c01c16996123886123658c61341f565b61086b9063ffffffff60c01b1963ffffffff60c01b83549260c01b169116179055565b6123906106b9565b9a6004358c5260243560208d015260443560408d015260643560608d015260843560808d015260a43560a08d015260c43560c08d015260e43560e08d01526101008c01526101208b019063ffffffff169052565b63ffffffff16610140890152565b63ffffffff16610160870152565b90820152614307565b604090600319011261042e5760043561242181610472565b9060243561074081610472565b3461042e57602061246c6001600160a01b0361244936612409565b91165f52610873835260405f20906001600160a01b03165f5260205260405f2090565b54604051908152f35b3461042e57602036600319011261042e57602060043561249481610472565b6001600160a01b038091165f52610c5c825260405f205416604051908152f35b3461042e575f36600319011261042e5760206001600160a01b0361086a5416604051908152f35b3461042e5760c036600319011261042e5760043560243567ffffffffffffffff60643560443560843583811161042e576125199036906004016116b2565b60a49491943591821161042e577f45e04bc8f121ba11466985789ca2822a91109f31bb8ac85504a37b7eaf873c26946125596125a89336906004016116b2565b9290916125646135c3565b61256d8a614b97565b61259c898b898961257f3688886106ef565b9261258b368b8b6106ef565b946001600160a01b034692166141d5565b60405196879687612e0c565b0390a36001606555005b3461042e576125c036612409565b906125c9613501565b6125d16135c3565b6001600160a01b0380911691825f52610c5d6020526126098160405f20906001600160a01b03166001600160a01b0319825416179055565b16907fcb84c2022106a6f2b6f805d446f32fbfd2a528474364fa755f37dac1c0c1b6c85f80a36001606555005b3461042e57602036600319011261042e576004355f52610872602052602060405f2054604051908152f35b3461042e575f36600319011261042e57602060405163ffffffff8152f35b91906101808382031261042e57612694610698565b92803584526020810135602085015260408101356040850152606081013560608501526080810135608085015260a081013560a085015260c081013560c085015260e081013560e085015261010080820135908501526101206126f88183016104eb565b9085015261014061270a8183016104eb565b90850152610160918282013567ffffffffffffffff811161042e5761272f9201610725565b90830152565b9060208282031261042e57813567ffffffffffffffff811161042e57610740920161267f565b3461042e57602036600319011261042e5760043567ffffffffffffffff811161042e57611c18610dfb602092369060040161267f565b3461042e575f36600319011261042e57602060ff61086b5460e01c166040519015158152f35b3461042e575f36600319011261042e5760206040516ec097ce7bc90715b34b9f10000000008152f35b3461042e57602036600319011261042e576107cb60043561280081610472565b612808613501565b6111b06135c3565b3461042e57606036600319011261042e5760043567ffffffffffffffff811161042e5761284190369060040161267f565b6128496135c3565b60ff61086b5460e01c166128f35761014081015163ffffffff42811691161015806128d4575b6128c25780612880610bd092613434565b60c08201516020830151906101608401519261289a610678565b948552602085015260408401526060830152608082015260243560a082015260443590613f5f565b604051630c3a9b9d60e41b8152600490fd5b506128e26040820151613b84565b6001600160a01b031633141561286f565b604051633d90fc5560e11b8152600490fd5b3461042e575f36600319011261042e576020610c5a546001600160a01b0360405191831c168152f35b6101608060031936011261042e5761010435612949816104cf565b61012435612956816104cf565b6101443567ffffffffffffffff811161042e576129779036906004016116b2565b63ffffffff9461298a8642169586612f68565b936129936135c3565b61086b549160ff8360e81c166107d2576129c66129d3966123e4610bd09a610e7d9660c01c16996123886123658c61341f565b86019063ffffffff169052565b610180820152614307565b634e487b7160e01b5f52603260045260245ffd5b61086c908154811015612a2c576003915f52027f71cd7344f4eb2efc8e30291f6dbdb44d618ca368ea5425d217c1d604bf26b84d01905f90565b6129de565b3461042e57602036600319011261042e5760043561086c5481101561042e57612a5b6040916129f2565b506001815491015482519182526020820152f35b3461042e57612a7d36612409565b90612a86613501565b612a8e6135c3565b6001600160a01b0380911691825f52610c5c602052612ac68160405f20906001600160a01b03166001600160a01b0319825416179055565b16907ff3dc137d2246f9b8abd0bb821e185ba01122c9b3ea3745ffca6208037674d6705f80a36001606555005b3461042e57602036600319011261042e576107cb600435612b1381610472565b612b1b613501565b6111b56135c3565b91612b2c6135c3565b6080820191612b45610b7884516001600160a01b031690565b602081019182514603612c4c57612b6d612b7191836001612b65896129f2565b5001546138a0565b1590565b612c3a578060607ff4ad92585b1bc117fbdd644990adf0827bc4c95baeae8a23322af807b6d0020e920193612bb3612bad865163ffffffff1690565b87613932565b612c2d845194835193612c12612c04612bf360408401998a51612bda8d5163ffffffff1690565b89516001600160a01b03169160a088019b8c51946139a3565b925193519851995163ffffffff1690565b94516001600160a01b031690565b945163ffffffff9586604051978897169b1699339487612ccd565b0390a461048e6001606555565b60405163582f497d60e11b8152600490fd5b604051633d23e4d160e11b8152600490fd5b9081518082526020808093019301915f5b828110612c7d575050505090565b835185529381019392810192600101612c6f565b9081518082526020808093019301915f5b828110612cb0575050505090565b83516001600160a01b031685529381019392810192600101612ca2565b9496959193612cef60a095612d0d93885260c0602089015260c0880190612c5e565b906001600160a01b0380951660408801528682036060880152612c91565b951515608085015216910152565b3561074081610472565b35610740816104cf565b903590601e198136030182121561042e570180359067ffffffffffffffff821161042e5760200191813603831361042e57565b634e487b7160e01b5f52602160045260245ffd5b60031115612d8057565b612d62565b8051821015612a2c5760209160051b010190565b90821015612a2c5761122a9160051b810190612d2f565b908092918237015f815290565b3d15612de7573d90612dce826106d3565b91612ddc6040519384610656565b82523d5f602084013e565b606090565b908060209392818452848401375f828201840152601f01601f1916010190565b94929093612e3192610740979587526020870152608060408701526080860191612dec565b926060818503910152612dec565b91909160ff5f5460081c161561042e57612e8990610c5a624c4b4063ffffffff1982541617905561086b9063ffffffff60c01b1963ffffffff60c01b83549260c01b169116179055565b604051612e9581610578565b6009815260208101926820a1a927a9a996ab1960b91b8452640312e302e360dc1b6020604051612ec481610578565b60058152015260ff5f5460081c161561042e57612f13936111b59251902061047f557f06c015bd22b4c69690933c1058878ebdfef31f9aaae40bbe86d8a09fe1b2972c610480556111a8614599565b61048e610c5a77deaddeaddeaddeaddeaddeaddeaddeaddead00000000000077ffffffffffffffffffffffffffffffffffffffff0000000019825416179055565b634e487b7160e01b5f52601160045260245ffd5b91909163ffffffff80809416911601918211612f8057565b612f54565b969492909161048e9b9a9998969492612fa563ffffffff42169889612f68565b985b9593919b999897969492909b612fbb6135c3565b61086b549660ff8860e81c166107d2578760c01c63ffffffff16612fde9061341f565b6130059061086b9063ffffffff60c01b1963ffffffff60c01b83549260c01b169116179055565b61300d6106b9565b9d6001600160a01b038f921682526001600160a01b031690602001526001600160a01b031660408d01526001600160a01b031660608c015260808b015260a08a015260c08901526001600160a01b031660e088015260c01c63ffffffff16610100870152610120860190613086919063ffffffff169052565b63ffffffff1661014085015263ffffffff1661016084015236906130a9926106ef565b6101808201526130b890614307565b61048e6001606555565b916040519160208301936bffffffffffffffffffffffff199060601b16845260348301526054820152605481526130f8816105e6565b51902090565b93929160209161311691604087526040870191612dec565b930152565b9081602091031261042e57604051906020820182811067ffffffffffffffff8211176105945760405235815290565b6107409161018090825181526020830151602082015260408301516040820152606083015160608201526080830151608082015260a083015160a082015260c083015160c082015260e083015160e082015261010080840151908201526131bf610120808501519083019063ffffffff169052565b6101408381015163ffffffff1690820152816101608094015193820152019061124f565b6131fb6040929594939560608352606083019061314a565b9460208201520152565b90602061074092818152019061124f565b9c9a999897969594939291909661322b6135c3565b60ff61086b5460e81c166107d257613244908e336130c2565b96604051809e61325382610599565b81526020015260408d015260608c015260808b015260a08a015260c089015260e088015261010087015263ffffffff16610120860152613086565b97929095939196949761329f6135c3565b60ff61086b5460e01c166128f3576132ba6101408201612d25565b63ffffffff8042169116101580613358575b6128c257613341613353966133396130b89b6132eb610dfb368761267f565b9a6132f4610678565b9b6132ff368861267f565b8d5260208d01528660408d01528760608d015261331d368b846106ef565b60808d015260a08c01526133318535613b84565b9836916106ef565b9536916106ef565b9461010060e0830135920135906141d5565b613f5f565b506133666040820135613b84565b6001600160a01b03163314156132cc565b9061338182610884565b61338e6040519182610656565b828152809261339f601f1991610884565b01905f5b8281106133af57505050565b8060606020809385010152016133a3565b60208183031261042e5780519067ffffffffffffffff821161042e570181601f8201121561042e5780516133f3816106d3565b926134016040519485610656565b8184526020828401011161042e57610740916020808501910161122e565b63ffffffff809116908114612f805760010190565b6040516130f881613451602082019460408652606083019061314a565b46604083015203601f198101835282610656565b9190916134706135c3565b60ff61086b5460e01c166128f35761014081015163ffffffff42811691161015806134e2575b6128c2576130b8926134a782613434565b60c0830151602084015190610160850151926134c1610678565b958652602086015260408501526060840152608083015260a0820152613f5f565b506134f06040820151613b84565b6001600160a01b0316331415613496565b7342000000000000000000000000000000000000078033036135b157602060049160405192838092636e296e4560e01b82525afa9081156135ac575f9161357d575b506001600160a01b0361356261216d610869546001600160a01b031690565b91160361356b57565b6040516336a816d960e01b8152600490fd5b61359f915060203d6020116135a5575b6135978183610656565b8101906146b8565b5f613543565b503d61358d565b6135e1565b60405163253a6fc960e11b8152600490fd5b60026065541461042e576002606555565b91908203918211612f8057565b6040513d5f823e3d90fd5b926107409695929491946101409585525f60208601526040850152606084015263ffffffff809116608084015260a08301525f60c083015260e08201525f61010082015281610120820152019061124f565b9193949690959660070b906706f05b59d3b2000061365b836146cd565b101561381b576ec097ce7bc90715b34b9f100000000084116138095763ffffffff93613689858a16426135d4565b857f000000000000000000000000000000000000000000000000000000000000000016106137f75761086b5460c01c63ffffffff16986136cb6123658b61341f565b6001600160a01b039586807f000000000000000000000000000000000000000000000000000000000000000016981692888414806137ee575b156137b2578034036137a057883b1561042e575f6004996040519a8b8092630d0e30db60e41b825234905af19889156135ac5761376f613782978a927f32ed1a409ef04c7b0227189c3a103dc5ac10e775a15b785dcc510201f7c25ad39c613787575b505b8361471b565b92604051998a99169d169b1693876135ec565b0390a4565b8061379461379a926105b6565b80610424565b5f613767565b604051636452a35d60e01b8152600490fd5b7f32ed1a409ef04c7b0227189c3a103dc5ac10e775a15b785dcc510201f7c25ad398508761376f613782976137e98430338a6146dc565b613769565b50341515613704565b60405163f722177f60e01b8152600490fd5b60405163622db5a960e11b8152600490fd5b60405163284f109760e21b8152600490fd5b6001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000811691168114613864575b50565b4761386c5750565b4790803b1561042e575f90600460405180948193630d0e30db60e41b83525af180156135ac57156138615761048e906105b6565b61074092916040516139298161391b602082019460208652805160408401526020810151606084015260a06138e5604083015160c06080870152610100860190612c5e565b606083015163ffffffff168583015260808301516001600160a01b031660c0860152910151838203603f190160e0850152612c91565b03601f198101835282610656565b51902091614751565b61393d6002916129f2565b500162ffffff8260081c16805f5281602052600160ff60405f205494161b8080941614613975575f5260205260405f20908154179055565b60405163954476d960e01b8152600490fd5b9081602091031261042e575190565b91908201809211612f8057565b91959495939092935f9681519081815103613b725781613a22575b505050826139cd575b50505050565b6001600160a01b0381613a017ffa7fa7cf6d7dde5f9be65a67e6a1a747e7aa864dcd2d793353c722d80fbbb3579386614814565b6040805195865233602087015291169463ffffffff1693a45f8080806139c7565b604080516370a0823160e01b81523060048083019190915291906020816024816001600160a01b038b165afa9081156135ac575f91613b53575b505f805b868110613a715750505050506139be565b613a7b8189612d85565b51613a89575b600101613a60565b90613a9f90613a98838a612d85565b5190613996565b90828211613b4357613ad9612b6d613ac7613aba848a612d85565b516001600160a01b031690565b613ad1848c612d85565b51908c6147a2565b15613a81579c5087613b39613b318f613b1c613aba613b15613afb848f612d85565b51966001600160a01b03165f5261087360205260405f2090565b928b612d85565b6001600160a01b03165f5260205260405f2090565b918254613996565b905560019c613a81565b50505051632ddaa83160e11b8152fd5b613b6c915060203d602011611088576110798183610656565b5f613a5c565b6040516319a5316760e31b8152600490fd5b6001600160a01b0390613b9681614b97565b1690565b91612b6d90613c1392845160408096015191865191613bb8836105ca565b8252613929613bd360208401924684528985019586526129f2565b5054938851928391613bf86020840196602088525160608d86015260a085019061314a565b9151606084015251608083015203601f198101835282610656565b613c1a5750565b5163582f497d60e11b8152600490fd5b613c3382612d76565b52565b9a989693919c9b9997959492909c6101e08c019d8c5260208c015260408b015260608a0152608089015263ffffffff80921660a08901521660c087015260e08601526101008501526101208401526101408301528051610160830152602081015161018083015260408101516101a08301526060015190613cb682612d76565b6101c00152565b9061074094936080936001600160a01b0380931684526020840152166040820152816060820152019061124f565b905f82516101208101613d02815163ffffffff1690565b63ffffffff42911610613f4d576020850151906002613d2a835f5261087260205260405f2090565b5414613f3b57613d4486925f5261087260205260405f2090565b6002905560608301519060808401519160a08501519260c0860151918560a0810151938860e0810151956101008201519751613d839063ffffffff1690565b61014083015163ffffffff166040840151918451936020860151956101600151613dac906141c0565b966060890151986080019e8f51613dc2906141c0565b906040015190613dd06106c6565b9a8b5260208b015260408a0152600260608a01526040519d8e9b613df49b8d613c36565b037f44b559f101f8fbcc8a0ea43fa91a05a729a5ea6e14a7c75aa750374690137208905f94a46080820151613e2890613b84565b9060408601519560600151613e3c90613b84565b9260800151613e4a90613b84565b6001600160a01b03919082167f0000000000000000000000000000000000000000000000000000000000000000831603613f265784613f13575b613e9087838616614bb2565b51928351151580613f09575b613eaa575b50505050509050565b1690813b15613f055783613ed8959660405196879586948593633a5be8cb60e01b8552339160048601613cbd565b03925af180156135ac57613ef2575b808080808594613ea1565b80613794613eff926105b6565b5f613ee7565b8380fd5b50803b1515613e9c565b613f218730338587166146dc565b613e84565b5f9450613f368785858516614670565b613e90565b604051630479306360e51b8152600490fd5b60405163d642b7d960e01b8152600490fd5b8051916101208301613f75815163ffffffff1690565b63ffffffff42911610613f4d5760208301516001613f9c825f5261087260205260405f2090565b54036141b9576001905b6002613fbb825f5261087260205260405f2090565b5414613f3b57613fd7613fdd915f5261087260205260405f2090565b60029055565b7f44b559f101f8fbcc8a0ea43fa91a05a729a5ea6e14a7c75aa75037469013720860608601516080870151906140aa8760a08a0151958a60c08101519760a08401519860e08301519961403a6101008501519c5163ffffffff1690565b61014085015163ffffffff169160408601519386519561409e61406661016060208b01519a01516141c0565b9960608c01519b604061407c60808301516141c0565b91015190602061408a6106c6565b9e8f528e015260408d015260608c01613c2a565b6040519c8d9c8d613c36565b0390a46140ba6080830151613b84565b9160408201519160806140dc816140d46060850151613b84565b940151613b84565b6001600160a01b03929083167f00000000000000000000000000000000000000000000000000000000000000008416036141a65761411e853033868a166146dc565b61412a85848616614bb2565b015191825115158061419c575b614143575b5050505050565b16803b1561042e57614171935f809460405196879586948593633a5be8cb60e01b8552339160048601613cbd565b03925af180156135ac57614189575b8080808061413c565b80613794614196926105b6565b5f614180565b50803b1515614137565b6141b4858533868a166146dc565b61412a565b5f90613fa6565b805190816141ce5750505f90565b6020012090565b939260429361048e979660208151910120906040519260208401947f8d1994e2bbbd77564cdca06dd819e7ee2a5efa06c80dcb59a4a7b6e39edc538f86526040850152856060850152608084015260a083015260c082015260c0815261423a8161061e565b5190209061047f549061048054906040519160208301937fc2f8787176b8ac6bf7215b4adcc1e069bf4ab82d9ab1df05a57a91d425935b6e8552604084015260608301526080820152608081526142908161063a565b519020906040519161190160f01b8352600283015260228201522090614dcf565b96926107409a9996949198959261014099895260208901526040880152606087015263ffffffff928380921660808801521660a08601521660c084015260e083015261010082015281610120820152019061124f565b6143118151614b97565b6101208101614330614327825163ffffffff1690565b63ffffffff1690565b804210908115614560575b506137f757610140820191614354835163ffffffff1690565b9063ffffffff9182614388817f00000000000000000000000000000000000000000000000000000000000000001642613996565b91161161454e5761016081015163ffffffff169180831680614509575b505060408101908151916001600160a01b037f00000000000000000000000000000000000000000000000000000000000000001680931480614500575b156144b357608082015134036137a057823b1561042e575f60049360405194858092630d0e30db60e41b825234905af19283156135ac577f32ed1a409ef04c7b0227189c3a103dc5ac10e775a15b785dcc510201f7c25ad3936144a0575b505b5161378260608301519260808101519060a081015160c08201519761447f6144746101008501519b5163ffffffff1690565b9b5163ffffffff1690565b83519b60208501519361018060e0870151960151966040519a8b9a8b6142b1565b806137946144ad926105b6565b5f614440565b9150346137a057816144fb6144ec61216d7f32ed1a409ef04c7b0227189c3a103dc5ac10e775a15b785dcc510201f7c25ad39551613b84565b608084015190309033906146dc565b614442565b503415156143e2565b6301e133801015614539575b5060e081015115614527575f806143a5565b60405163495d907f60e01b8152600490fd5b916145479192421690612f68565b905f614515565b60405163582e388960e01b8152600490fd5b61456b9150426135d4565b63ffffffff7f000000000000000000000000000000000000000000000000000000000000000016105f61433b565b60ff5f5460081c161561042e57565b60ff5f5460081c161561042e576001606555565b6001600160a01b0316801561460457610869816001600160a01b03198254161790557fa9e8c42c9e7fca7f62755189a16b2f5314d43d8fb24e91ba54e6d65f9314e8495f80a2565b60405163ba97b39d60e01b8152600490fd5b6001600160a01b0316801561465e5761086a816001600160a01b03198254161790557fa73e8909f8616742d7fe701153d82666f7b7cd480552e23ebb05d358c22fd04e5f80a2565b604051635b03092b60e11b8152600490fd5b60405163a9059cbb60e01b60208201526001600160a01b039092166024830152604482019290925261048e916146b382606481015b03601f198101845283610656565b614ead565b9081602091031261042e575161074081610472565b5f81126146d75790565b5f0390565b909261048e93604051936323b872dd60e01b60208601526001600160a01b0380921660248601521660448401526064830152606482526146b38261063a565b90670de0b6b3a7640000915f828403921283831281169084841390151617612f8057818102918183041490151715612f80570490565b929091905f915b845183101561479a5761476b8386612d85565b519081811015614789575f52602052600160405f205b920191614758565b905f52602052600160405f20614781565b915092501490565b60405163a9059cbb60e01b60208281019182526001600160a01b039094166024830152604482019490945290925f916147de816064810161391b565b519082855af1903d5f5190836147f5575b50505090565b9192509061480a57503b15155b5f80806147ef565b6001915014614802565b906001600160a01b0390818116907f00000000000000000000000000000000000000000000000000000000000000008316820361493e5750803b1561042e57604051632e1a7d4d60e01b815260048101849052905f908290602490829084905af180156135ac5761492b575b50610c5a549161489961086a546001600160a01b031690565b73420000000000000000000000000000000000001090813b1561042e57604051631474f2a960e31b8152602086901c949094166001600160a01b0390811660048601521660248401526044830182905263ffffffff909316606483015260a060848301525f60a483018190529192839160c4918391905af180156135ac5761491e5750565b8061379461048e926105b6565b80613794614938926105b6565b5f614880565b91807f000000000000000000000000000000000000000000000000000000000000000016151580614b6c575b1561498e5750505061048e9061498961086a546001600160a01b031690565b614fe1565b806149bb6149ae856001600160a01b03165f52610c5c60205260405f2090565b546001600160a01b031690565b16614b48577342000000000000000000000000000000000000105b16906149fa61216d6149ae856001600160a01b03165f52610c5d60205260405f2090565b15614ac2578382614a0a92614f3d565b614a296149ae836001600160a01b03165f52610c5d60205260405f2090565b90614a3d61086a546001600160a01b031690565b91614a4e610c5a5463ffffffff1690565b823b1561042e5760405163540abf7360e01b81526001600160a01b0395861660048201529185166024830152929093166044840152606483019390935263ffffffff16608482015260c060a48201525f60c482018190529091829081838160e481015b03925af180156135ac5761491e5750565b5091614ad761086a546001600160a01b031690565b92614ae8610c5a5463ffffffff1690565b93813b1561042e57604051631474f2a960e31b81526001600160a01b03948516600482015293166024840152604483019190915263ffffffff909216606482015260a060848201525f60a482018190529091829081838160c48101614ab1565b614b676149ae846001600160a01b03165f52610c5c60205260405f2090565b6149d6565b50807f000000000000000000000000000000000000000000000000000000000000000016821461496a565b60a01c614ba057565b6040516379ec0ed760e11b8152600490fd5b6001600160a01b0390811690813b15614bf2579061048e92917f000000000000000000000000000000000000000000000000000000000000000016614670565b7f000000000000000000000000000000000000000000000000000000000000000016803b1561042e575f8091602460405180948193632e1a7d4d60e01b83528860048401525af180156135ac57614c64575b5081471061042e575f80809381935af1614c5c612dbd565b501561042e57565b614c6d906105b6565b5f614c44565b614c7c81614d8c565b6001600160a01b0381167fbc7cd75a20ee27fd9adebab32041f755214dbc6bffa90cc0225b39da2e5c2d3b5f80a2815115801590614d34575b614cbd575050565b5f80613861937f206661696c65640000000000000000000000000000000000000000000000000060408051614cf1816105ca565b602781527f416464726573733a206c6f772d6c6576656c2064656c65676174652063616c6c60208201520152602081519101845af4614d2e612dbd565b916152df565b505f614cb5565b614d4481614d8c565b6001600160a01b0381167fbc7cd75a20ee27fd9adebab32041f755214dbc6bffa90cc0225b39da2e5c2d3b5f80a2815115801590614d8457614cbd575050565b506001614cb5565b803b1561042e576001600160a01b037f360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc91166001600160a01b0319825416179055565b614dd983836152ae565b6005819592951015612d8057159384614e97575b508315614e11575b50505015614dff57565b60405163938a182160e01b8152600490fd5b5f929350908291604051614e498161391b6020820194630b135d3f60e11b998a8752602484015260406044840152606483019061124f565b51915afa90614e56612dbd565b82614e89575b82614e6c575b50505f8080614df5565b614e8191925060208082518301019101613987565b145f80614e62565b915060208251101591614e5c565b6001600160a01b0383811691161493505f614ded565b905f806001600160a01b03614f049416927f5361666545524332303a206c6f772d6c6576656c2063616c6c206661696c65646020604051614eed81610578565b818152015260208151910182855af1614d2e612dbd565b8051908115918215614f1a575b50501561042e57565b819250906020918101031261042e5760200151614f36816119a2565b5f80614f11565b6044919260206001600160a01b0360405194858092636eb1769f60e11b8252306004830152808916602483015286165afa9283156135ac575f93614fc0575b508201809211612f805760405163095ea7b360e01b60208201526001600160a01b039093166024840152604483019190915261048e91906146b382606481016146a5565b614fda91935060203d602011611088576110798183610656565b915f614f7c565b906001600160a01b038092167f000000000000000000000000000000000000000000000000000000000000000090837f0000000000000000000000000000000000000000000000000000000000000000169361503e848685614f3d565b604094604051926332dd704760e21b84526020956004948781600481875afa9687156135ac5788915f9861526d575b506040516352b7631960e11b81529086166001600160a01b03811660048301529097909588916024918391165afa9586156135ac575f9661524e575b5095867f0000000000000000000000000000000000000000000000000000000000000000975b6150de57505050505050505050565b8681111561524857865b88156151a057843b1561042e578951634701287760e11b815287810182815263ffffffff7f0000000000000000000000000000000000000000000000000000000000000000166020820152604081018690526001600160a01b03881660608201525f6080820181905260a082018190526107d060c0830152919391908490819060e0010381838a5af19283156135ac576151879361518d575b506135d4565b806150cf565b8061379461519a926105b6565b5f615181565b89516337e9a82760e11b815287810182815263ffffffff7f0000000000000000000000000000000000000000000000000000000000000000166020820152604081018690526001600160a01b038816606082015290929084908490819060800103815f8a5af19283156135ac576151879361521b57506135d4565b61523a90853d8711615241575b6152328183610656565b81019061528e565b505f615181565b503d615228565b806150e8565b615266919650873d8911611088576110798183610656565b945f6150a9565b8691985061528790833d85116135a5576135978183610656565b979061506d565b9081602091031261042e575167ffffffffffffffff8116810361042e5790565b9060418151145f146152d65761122a91602082015190606060408401519301515f1a90615308565b50505f90600290565b90156152f9578151156152f0575090565b3b1561042e5790565b50805190811561042e57602001fd5b7f7fffffffffffffffffffffffffffffff5d576e7357a4501ddfe92f46681b20a08411615378576020935f9360ff60809460405194855216868401526040830152606082015282805260015afa156135ac575f516001600160a01b0381161561537057905f90565b505f90600190565b505050505f9060039056fea264697066735822122055ad2af729c797abdaca5785a9aa033a3c01eebb02e628fb93e9a77e28791a2964736f6c63430008170033",
+ "deployedBytecode": "0x6080604052600436101561001a575b3615610018575f80fd5b005b5f3560e01c8063079bd2c71461041f5780630c5d5f731461041a5780630eaac9f0146104155780631186ec331461041057806311eac8551461040b57806315348e44146103a257806317fcb39b146104065780631b3d5559146104015780631fab657c146103fc57806329cb924d146103f75780632e378115146103f25780632e63e59a146103ed5780633659cfe6146103e8578063431023b8146103e3578063437b9116146103de578063490e49ef146103d9578063493a4f84146103d45780634f1ef286146103cf5780635285e058146103ca57806352d1902d146103c5578063541f4f14146103c0578063577f51f8146103bb57806357f6dcb8146103b65780636068d6cb146103b1578063647c576c146103ac578063670fa8ac146103a75780636bbbcd2e146103a25780636e4009831461039d578063738b62e514610398578063766e070314610393578063775c0d031461038e5780637aef642c146103895780637b939232146103845780637ef413e11461037f57806382e2c43f1461037a5780638a7860ce146103755780638b15788e14610370578063927ede2d1461036b5780639748cf7c1461036657806397943aa914610361578063979f2bc21461035c57806399cc2968146103575780639a8a059214610352578063a1244c671461034d578063a18a096e14610348578063ac9650d814610343578063ad5425c61461033e578063adb5a6a6146102f3578063b27a430014610339578063b370b7f514610334578063babb6aac1461032f578063bf10268d1461032a578063c35c83fc14610325578063ceb4c98714610320578063d7e1583a1461031b578063dda5211314610316578063ddd224f114610311578063de7eba781461030c578063deff4b2414610307578063e322921114610302578063ea86bd46146102fd578063ee2a53f8146102f8578063f79f29ed146102f3578063fbbba9ac146102ee5763fc8a584f0361000e57612af3565b612a6f565b61242e565b612a31565b61292e565b612905565b612810565b6127e0565b6127b7565b612791565b61275b565b612661565b612636565b6125b2565b6124db565b6124b4565b612475565b6122cd565b61222d565b6120c6565b61209f565b612085565b611ff0565b611f22565b611ea2565b611e5f565b611e31565b611db3565b611d3b565b611c20565b611be9565b611b41565b611aa1565b611a65565b611a41565b6119ac565b611962565b610827565b611928565b611851565b6117f9565b6117b9565b6116e0565b61161d565b6115b3565b61158c565b61145e565b6113d7565b6113b9565b6112ec565b61108f565b610f5d565b610d63565b610c03565b610bda565b610ad8565b6109cf565b610841565b6107e4565b610743565b6104f6565b610490565b610432565b5f91031261042e57565b5f80fd5b3461042e575f36600319011261042e57602060405163ffffffff7f0000000000000000000000000000000000000000000000000000000000000000168152f35b6001600160a01b0381160361042e57565b359061048e82610472565b565b3461042e57602036600319011261042e5760206004356104af81610472565b6001600160a01b038091165f52610c5d825260405f205416604051908152f35b63ffffffff81160361042e57565b610144359061048e826104cf565b359061048e826104cf565b3461042e57602036600319011261042e5763ffffffff600435610518816104cf565b610520613501565b6105286135c3565b16610c5a8163ffffffff198254161790557fe486a5c4bd7b36eabbfe274c99b39130277417be8d2209b4dae04c4fba64ee3a5f80a26001606555005b634e487b7160e01b5f52604160045260245ffd5b6040810190811067ffffffffffffffff82111761059457604052565b610564565b6101a0810190811067ffffffffffffffff82111761059457604052565b67ffffffffffffffff811161059457604052565b6060810190811067ffffffffffffffff82111761059457604052565b6080810190811067ffffffffffffffff82111761059457604052565b6020810190811067ffffffffffffffff82111761059457604052565b60e0810190811067ffffffffffffffff82111761059457604052565b60a0810190811067ffffffffffffffff82111761059457604052565b90601f8019910116810190811067ffffffffffffffff82111761059457604052565b6040519060c0820182811067ffffffffffffffff82111761059457604052565b60405190610180820182811067ffffffffffffffff82111761059457604052565b6040519061048e82610599565b6040519061048e826105e6565b67ffffffffffffffff811161059457601f01601f191660200190565b9291926106fb826106d3565b916107096040519384610656565b82948184528183011161042e578281602093845f960137010152565b9080601f8301121561042e57816020610740933591016106ef565b90565b61010036600319011261042e5760043561075c81610472565b60243561076881610472565b6084358060070b810361042e5760a43590610782826104cf565b60c43567ffffffffffffffff811161042e576107a2903690600401610725565b926107ab6135c3565b60ff61086b5460e81c166107d2576107cb9460643591604435913361363e565b6001606555005b604051630b4cba3160e31b8152600490fd5b3461042e575f36600319011261042e5760206040516001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000168152f35b3461042e575f36600319011261042e5760206040515f8152f35b3461042e575f36600319011261042e5760206040516001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000168152f35b67ffffffffffffffff81116105945760051b60200190565b9080601f8301121561042e5760209082356108b681610884565b936108c46040519586610656565b81855260208086019260051b82010192831161042e57602001905b8282106108ed575050505090565b813581529083019083016108df565b9080601f8301121561042e57602090823561091681610884565b936109246040519586610656565b81855260208086019260051b82010192831161042e57602001905b82821061094d575050505090565b838091833561095b81610472565b81520191019061093f565b929161097182610884565b9161097f6040519384610656565b829481845260208094019160051b810192831161042e57905b8282106109a55750505050565b81358152908301908301610998565b9080601f8301121561042e5781602061074093359101610966565b60031960603682011261042e576004356109e8816104cf565b60243567ffffffffffffffff9283821161042e5760c090823603011261042e57610a10610678565b908060040135825260248101356020830152604481013584811161042e57610a3e906004369184010161089c565b6040830152610a4f606482016104eb565b6060830152610a6060848201610483565b608083015260a48101359084821161042e576004610a8192369201016108fc565b60a082015260443592831161042e57610aa16100189336906004016109b4565b91612b23565b9181601f8401121561042e5782359167ffffffffffffffff831161042e576020808501948460051b01011161042e57565b3461042e5760031960603682011261042e5760043567ffffffffffffffff80821161042e5760608236039384011261042e5760243590610b17826104cf565b60443590811161042e57610b2f903690600401610aa7565b919093610b3a6135c3565b600484013590610182190181121561042e57610bd094610bcb93610b67610bc4936004369189010161267f565b95610b7d610b786080890151613b84565b61382d565b610b8687613434565b9060446020890151916101608a015193610b9e610678565b9a8b5260208b015201356040890152606088015260808701525f60a08701523691610966565b9083613b9a565b613ceb565b6100186001606555565b3461042e575f36600319011261042e576020604051428152f35b908161018091031261042e5790565b3461042e57604036600319011261042e5760043567ffffffffffffffff811161042e57610c34903690600401610bf4565b610c3d81612d1b565b6001600160a01b031690610c5360208201612d1b565b6001600160a01b031691610c6960408301612d1b565b6001600160a01b0316610c7e60608401612d1b565b6001600160a01b031692610c9460808201612d1b565b6001600160a01b031690610100610cac818301612d25565b9061012090610cbc848301612d25565b9261014094858101610ccd90612d25565b966101609a8b8301610cdf9084612d2f565b9a909b610cea610698565b9e8f91825260208201526040015260608d015260808c015260a081013560a08c015260c081013560c08c015260e0013560e08b015263ffffffff1690890152870190610d3b919063ffffffff169052565b63ffffffff909116908501523690610d52926106ef565b908201523360243561001892613465565b3461042e57602036600319011261042e576004803567ffffffffffffffff811161042e57610d949036908301610bf4565b610d9c6135c3565b60ff61086b5460e01c16610f4d5763ffffffff80421692610140830193610dd581610dc687612d25565b63ffffffff9182169116101590565b610f3d57610120840192610de884612d25565b1610610f2e57610e00610dfb368561267f565b613434565b90610e14825f5261087260205260405f2090565b54610f205750610e637f3cee3e290f36226751cd0b3321b213890fe9c768e922f267fa6111836ce05c3292610e5e610e58610e69945f5261087260205260405f2090565b60019055565b612d25565b93612d25565b610e89610e84610e7d610160860186612d2f565b36916106ef565b6141c0565b90610f136040519283926101008701359760e08801359760208101359281359260408301359260c08101359060a081013590606060808201359101358b9693909a999895919261012098959361014089019c895260208901526040880152606087015263ffffffff80921660808701521660a085015260c084015260e08301526101008201520152565b0390a36100186001606555565b604051624be79160e21b8152fd5b60405163d642b7d960e01b8152fd5b50604051630277ae7b60e21b8152fd5b50604051633d90fc5560e11b8152fd5b3461042e57602036600319011261042e57600435610f7a81610472565b6001600160a01b03807f00000000000000000000000000000000000000000000000000000000000000001680301461042e577f360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc90828254160361042e57610fdf613501565b60405191610fec83610602565b5f83527f4910fdfa16fed3260ed0e7147f7cc6da11a60208b5b9406d12a635614ffd91435460ff16156110255750505061001890614d8c565b6020600491604051928380926352d1902d60e01b825288165afa5f918161105e575b50611050575f80fd5b0361042e5761001891614c73565b61108191925060203d602011611088575b6110798183610656565b810190613987565b905f611047565b503d61106f565b3461042e57608036600319011261042e576004356110ac816104cf565b602435906110b982610472565b6044356110c581610472565b606435916110d283610472565b60ff5f5460081c161561042e5761111990610c5a624c4b4063ffffffff1982541617905561086b9063ffffffff60c01b1963ffffffff60c01b83549260c01b169116179055565b6040519061112682610578565b6009825260208201916820a1a927a9a996ab1960b91b8352640312e302e360dc1b602060405161115581610578565b60058152015260ff5f5460081c161561042e57610018946111ba936111b59251902061047f557f06c015bd22b4c69690933c1058878ebdfef31f9aaae40bbe86d8a09fe1b2972c610480556111a8614599565b6111b06145a8565b6145bc565b614616565b610c5a9077ffffffffffffffffffffffffffffffffffffffff000000001977ffffffffffffffffffffffffffffffffffffffff0000000083549260201b169116179055565b602060031982011261042e576004359067ffffffffffffffff821161042e5761122a91600401610aa7565b9091565b5f5b83811061123f5750505f910152565b8181015183820152602001611230565b906020916112688151809281855285808601910161122e565b601f01601f1916010190565b6020808201908083528351809252604092604081018260408560051b8401019601945f925b8584106112aa575050505050505090565b9091929394959685806112db600193603f1986820301885286838d518051151584520151918185820152019061124f565b990194019401929594939190611299565b3461042e576112fa366111ff565b61130381610884565b9160406113136040519485610656565b828452601f1961132284610884565b015f5b8181106113965750505f5b83811061134957604051806113458782611274565b0390f35b8061139061135960019388612d85565b515f80611367858a8a612d99565b90611376895180938193612db0565b0390305af490611384612dbd565b60208201529015159052565b01611330565b60209083516113a481610578565b5f815282606081830152828901015201611325565b3461042e575f36600319011261042e5760206040516301e133808152f35b3461042e57604036600319011261042e576024356004356113f6613501565b6113fe6135c3565b61086c8054680100000000000000008110156105945763ffffffff916001820190558361142a826129f2565b5084600182015555167fc86ba04c55bc5eb2f2876b91c438849a296dbec7b08751c3074d92e04f0a77af5f80a46001606555005b604036600319011261042e5760043561147681610472565b60243567ffffffffffffffff811161042e57611496903690600401610725565b6001600160a01b03807f0000000000000000000000000000000000000000000000000000000000000000169081301461042e577f360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc91818354160361042e576114fc613501565b7f4910fdfa16fed3260ed0e7147f7cc6da11a60208b5b9406d12a635614ffd91435460ff16156115325750505061001890614d8c565b6020600491604051928380926352d1902d60e01b825288165afa5f918161156b575b5061155d575f80fd5b0361042e5761001891614d3b565b61158591925060203d602011611088576110798183610656565b905f611554565b3461042e575f36600319011261042e5760206001600160a01b036108695416604051908152f35b3461042e575f36600319011261042e576001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016300361042e5760206040517f360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc8152f35b61012036600319011261042e5760043561163681610472565b6024359061164382610472565b6044359161165083610472565b60a4358060070b810361042e5760c4359161166a836104cf565b60e43567ffffffffffffffff811161042e5761168a903690600401610725565b936116936135c3565b60ff61086b5460e81c166107d2576107cb95608435926064359261363e565b9181601f8401121561042e5782359167ffffffffffffffff831161042e576020838186019501011161042e57565b3461042e5760c036600319011261042e576004356116fd81610472565b6024356044359160643561171081610472565b67ffffffffffffffff9160843583811161042e576117329036906004016116b2565b60a49491943591821161042e577f45e04bc8f121ba11466985789ca2822a91109f31bb8ac85504a37b7eaf873c26946117726117b49336906004016116b2565b9290916001600160a01b038097166117a68a8c836117913688886106ef565b9161179d368b8b6106ef565b9346908d6141d5565b604051978897169a87612e0c565b0390a3005b3461042e575f36600319011261042e57602060405163ffffffff7f0000000000000000000000000000000000000000000000000000000000000000168152f35b3461042e575f36600319011261042e57602060ff61086b5460e81c166040519015158152f35b606090600319011261042e57600435611837816104cf565b9060243561184481610472565b9060443561074081610472565b3461042e5761185f3661181f565b5f54600881901c60ff161593929084908161191a575b81156118fa575b501561042e576118a09284611897600160ff195f5416175f55565b6118e357612e3f565b6118a657005b6118b461ff00195f54165f55565b604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb384740249890602090a1005b6118f561010061ff00195f5416175f55565b612e3f565b303b1591508161190c575b505f61187c565b6001915060ff16145f611905565b600160ff8216109150611875565b3461042e575f36600319011261042e5760206040517f8d1994e2bbbd77564cdca06dd819e7ee2a5efa06c80dcb59a4a7b6e39edc538f8152f35b3461042e575f36600319011261042e57602060405163ffffffff7f0000000000000000000000000000000000000000000000000000000000000000168152f35b8015150361042e57565b3461042e57602036600319011261042e577fe88463c2f254e2b070013a2dc7ee1e099f9bc00534cbdf03af551dc26ae4921960206004356119ec816119a2565b6119f4613501565b6119fc6135c3565b151561086b80547fffff00ffffffffffffffffffffffffffffffffffffffffffffffffffffffffff60ff60e81b8460e81b169116179055604051908152a16001606555005b3461042e575f36600319011261042e57602063ffffffff610c5a5416604051908152f35b3461042e575f36600319011261042e5760206040517f000000000000000000000000000000000000000000000000000000000000000015158152f35b61016036600319011261042e57600435611aba81610472565b60243590611ac782610472565b604435611ad381610472565b60643590611ae082610472565b60e435611aec81610472565b6101043590611afa826104cf565b6101243592611b08846104cf565b610144359667ffffffffffffffff881161042e57611b2d6100189836906004016116b2565b97909660c4359360a4359360843593612f85565b61018036600319011261042e57600435611b5a81610472565b60243590611b6782610472565b604435611b7381610472565b60643590611b8082610472565b60e435611b8c81610472565b61010435611b99816104cf565b6101243591611ba7836104cf565b611baf6104dd565b93610164359767ffffffffffffffff891161042e57611bd56100189936906004016116b2565b98909760c4359360a4359360843593612fa7565b3461042e57606036600319011261042e576020611c18600435611c0b81610472565b60443590602435906130c2565b604051908152f35b3461042e57606036600319011261042e5767ffffffffffffffff60243581811161042e57611c529036906004016116b2565b9160443590811161042e57611c6b9036906004016116b2565b9060405193602085019480611c824684888a6130fe565b0395611c96601f1997888101845283610656565b6004359151902003611d29575f94611cc5611ce793611cbc87611cf3958a990190612735565b9581019061311b565b519360405193849160208301966337bfd2c960e21b88523391602485016131e3565b03908101835282610656565b5190305af4611d00612dbd565b9015611d0857005b60405163b8fe37a760e01b8152908190611d259060048301613205565b0390fd5b604051630f0c8f4760e11b8152600490fd5b3461042e57602036600319011261042e57600435611d57613501565b611d5f6135c3565b611d68816129f2565b611da0576001815f80935501557f7c1af0646963afc3343245b103731965735a893347bfa0d58a5dc77a77ae691c5f80a26001606555005b634e487b7160e01b5f525f60045260245ffd5b6101a036600319011261042e5761012435611dcd816104cf565b61014435611dda816104cf565b6101643591611de8836104cf565b610184359267ffffffffffffffff841161042e57611e0d6100189436906004016116b2565b9390926101043560e43560c43560a435608435606435604435602435600435613216565b3461042e575f36600319011261042e5760206040517342000000000000000000000000000000000000078152f35b3461042e575f36600319011261042e5760206040516001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000168152f35b3461042e5760e036600319011261042e5767ffffffffffffffff60043581811161042e57611ed4903690600401610bf4565b60a43582811161042e57611eec9036906004016116b2565b60c49291923593841161042e57611f0a6100189436906004016116b2565b9390926084359060643590604435906024359061328e565b3461042e57611f303661181f565b909160ff5f5460081c161561042e57611f669061086b9063ffffffff60c01b1963ffffffff60c01b83549260c01b169116179055565b604051611f7281610578565b6009815260208101926820a1a927a9a996ab1960b91b8452640312e302e360dc1b6020604051611fa181610578565b60058152015260ff5f5460081c161561042e57610018936111b59251902061047f557f06c015bd22b4c69690933c1058878ebdfef31f9aaae40bbe86d8a09fe1b2972c610480556111a8614599565b3461042e57602036600319011261042e577f2d5b62420992e5a4afce0e77742636ca2608ef58289fd2e1baa5161ef6e7e41e6020600435612030816119a2565b612038613501565b6120406135c3565b151561086b80547fffffff00ffffffffffffffffffffffffffffffffffffffffffffffffffffffff60ff60e01b8460e01b169116179055604051908152a16001606555005b3461042e575f36600319011261042e576020604051468152f35b3461042e575f36600319011261042e57602063ffffffff61086b5460c01c16604051908152f35b3461042e57604036600319011261042e576004356024356120e682614b97565b6001600160a01b0382165f5261087360205261211560405f20336001600160a01b03165f5260205260405f2090565b549182156121b8575f61215c3361214661212e85613b84565b6001600160a01b03165f5261087360205260405f2090565b906001600160a01b03165f5260205260405f2090565b556121888361217961216d84613b84565b6001600160a01b031690565b61218285613b84565b90614670565b60405192835233927f6c172ea51018fb2eb2118f3f8a507c4df71eb519b8c0052834dc3c920182fef490602090a4005b6040516336542bf760e21b8152600490fd5b6020808201906020835283518092526040830192602060408460051b8301019501935f915b8483106121ff5750505050505090565b909192939495848061221d600193603f198682030187528a5161124f565b98019301930191949392906121ef565b3461042e5761223b366111ff565b9061224582613377565b915f5b81811061225d576040518061134586826121ca565b5f8061226a838587612d99565b9061227a60405180938193612db0565b0390305af4612287612dbd565b90156122ad579060019161229b8287612d85565b526122a68186612d85565b5001612248565b604481511061042e5780600461042e9201516024809183010191016133c0565b6101808060031936011261042e57610104356122e8816104cf565b61012435916122f6836104cf565b6101443592612304846104cf565b6101643567ffffffffffffffff811161042e576123259036906004016116b2565b61232d6135c3565b61086b549260ff8460e81c166107d257610bd0966123f2610e7d926123e463ffffffff6124009860c01c16996123886123658c61341f565b61086b9063ffffffff60c01b1963ffffffff60c01b83549260c01b169116179055565b6123906106b9565b9a6004358c5260243560208d015260443560408d015260643560608d015260843560808d015260a43560a08d015260c43560c08d015260e43560e08d01526101008c01526101208b019063ffffffff169052565b63ffffffff16610140890152565b63ffffffff16610160870152565b90820152614307565b604090600319011261042e5760043561242181610472565b9060243561074081610472565b3461042e57602061246c6001600160a01b0361244936612409565b91165f52610873835260405f20906001600160a01b03165f5260205260405f2090565b54604051908152f35b3461042e57602036600319011261042e57602060043561249481610472565b6001600160a01b038091165f52610c5c825260405f205416604051908152f35b3461042e575f36600319011261042e5760206001600160a01b0361086a5416604051908152f35b3461042e5760c036600319011261042e5760043560243567ffffffffffffffff60643560443560843583811161042e576125199036906004016116b2565b60a49491943591821161042e577f45e04bc8f121ba11466985789ca2822a91109f31bb8ac85504a37b7eaf873c26946125596125a89336906004016116b2565b9290916125646135c3565b61256d8a614b97565b61259c898b898961257f3688886106ef565b9261258b368b8b6106ef565b946001600160a01b034692166141d5565b60405196879687612e0c565b0390a36001606555005b3461042e576125c036612409565b906125c9613501565b6125d16135c3565b6001600160a01b0380911691825f52610c5d6020526126098160405f20906001600160a01b03166001600160a01b0319825416179055565b16907fcb84c2022106a6f2b6f805d446f32fbfd2a528474364fa755f37dac1c0c1b6c85f80a36001606555005b3461042e57602036600319011261042e576004355f52610872602052602060405f2054604051908152f35b3461042e575f36600319011261042e57602060405163ffffffff8152f35b91906101808382031261042e57612694610698565b92803584526020810135602085015260408101356040850152606081013560608501526080810135608085015260a081013560a085015260c081013560c085015260e081013560e085015261010080820135908501526101206126f88183016104eb565b9085015261014061270a8183016104eb565b90850152610160918282013567ffffffffffffffff811161042e5761272f9201610725565b90830152565b9060208282031261042e57813567ffffffffffffffff811161042e57610740920161267f565b3461042e57602036600319011261042e5760043567ffffffffffffffff811161042e57611c18610dfb602092369060040161267f565b3461042e575f36600319011261042e57602060ff61086b5460e01c166040519015158152f35b3461042e575f36600319011261042e5760206040516ec097ce7bc90715b34b9f10000000008152f35b3461042e57602036600319011261042e576107cb60043561280081610472565b612808613501565b6111b06135c3565b3461042e57606036600319011261042e5760043567ffffffffffffffff811161042e5761284190369060040161267f565b6128496135c3565b60ff61086b5460e01c166128f35761014081015163ffffffff42811691161015806128d4575b6128c25780612880610bd092613434565b60c08201516020830151906101608401519261289a610678565b948552602085015260408401526060830152608082015260243560a082015260443590613f5f565b604051630c3a9b9d60e41b8152600490fd5b506128e26040820151613b84565b6001600160a01b031633141561286f565b604051633d90fc5560e11b8152600490fd5b3461042e575f36600319011261042e576020610c5a546001600160a01b0360405191831c168152f35b6101608060031936011261042e5761010435612949816104cf565b61012435612956816104cf565b6101443567ffffffffffffffff811161042e576129779036906004016116b2565b63ffffffff9461298a8642169586612f68565b936129936135c3565b61086b549160ff8360e81c166107d2576129c66129d3966123e4610bd09a610e7d9660c01c16996123886123658c61341f565b86019063ffffffff169052565b610180820152614307565b634e487b7160e01b5f52603260045260245ffd5b61086c908154811015612a2c576003915f52027f71cd7344f4eb2efc8e30291f6dbdb44d618ca368ea5425d217c1d604bf26b84d01905f90565b6129de565b3461042e57602036600319011261042e5760043561086c5481101561042e57612a5b6040916129f2565b506001815491015482519182526020820152f35b3461042e57612a7d36612409565b90612a86613501565b612a8e6135c3565b6001600160a01b0380911691825f52610c5c602052612ac68160405f20906001600160a01b03166001600160a01b0319825416179055565b16907ff3dc137d2246f9b8abd0bb821e185ba01122c9b3ea3745ffca6208037674d6705f80a36001606555005b3461042e57602036600319011261042e576107cb600435612b1381610472565b612b1b613501565b6111b56135c3565b91612b2c6135c3565b6080820191612b45610b7884516001600160a01b031690565b602081019182514603612c4c57612b6d612b7191836001612b65896129f2565b5001546138a0565b1590565b612c3a578060607ff4ad92585b1bc117fbdd644990adf0827bc4c95baeae8a23322af807b6d0020e920193612bb3612bad865163ffffffff1690565b87613932565b612c2d845194835193612c12612c04612bf360408401998a51612bda8d5163ffffffff1690565b89516001600160a01b03169160a088019b8c51946139a3565b925193519851995163ffffffff1690565b94516001600160a01b031690565b945163ffffffff9586604051978897169b1699339487612ccd565b0390a461048e6001606555565b60405163582f497d60e11b8152600490fd5b604051633d23e4d160e11b8152600490fd5b9081518082526020808093019301915f5b828110612c7d575050505090565b835185529381019392810192600101612c6f565b9081518082526020808093019301915f5b828110612cb0575050505090565b83516001600160a01b031685529381019392810192600101612ca2565b9496959193612cef60a095612d0d93885260c0602089015260c0880190612c5e565b906001600160a01b0380951660408801528682036060880152612c91565b951515608085015216910152565b3561074081610472565b35610740816104cf565b903590601e198136030182121561042e570180359067ffffffffffffffff821161042e5760200191813603831361042e57565b634e487b7160e01b5f52602160045260245ffd5b60031115612d8057565b612d62565b8051821015612a2c5760209160051b010190565b90821015612a2c5761122a9160051b810190612d2f565b908092918237015f815290565b3d15612de7573d90612dce826106d3565b91612ddc6040519384610656565b82523d5f602084013e565b606090565b908060209392818452848401375f828201840152601f01601f1916010190565b94929093612e3192610740979587526020870152608060408701526080860191612dec565b926060818503910152612dec565b91909160ff5f5460081c161561042e57612e8990610c5a624c4b4063ffffffff1982541617905561086b9063ffffffff60c01b1963ffffffff60c01b83549260c01b169116179055565b604051612e9581610578565b6009815260208101926820a1a927a9a996ab1960b91b8452640312e302e360dc1b6020604051612ec481610578565b60058152015260ff5f5460081c161561042e57612f13936111b59251902061047f557f06c015bd22b4c69690933c1058878ebdfef31f9aaae40bbe86d8a09fe1b2972c610480556111a8614599565b61048e610c5a77deaddeaddeaddeaddeaddeaddeaddeaddead00000000000077ffffffffffffffffffffffffffffffffffffffff0000000019825416179055565b634e487b7160e01b5f52601160045260245ffd5b91909163ffffffff80809416911601918211612f8057565b612f54565b969492909161048e9b9a9998969492612fa563ffffffff42169889612f68565b985b9593919b999897969492909b612fbb6135c3565b61086b549660ff8860e81c166107d2578760c01c63ffffffff16612fde9061341f565b6130059061086b9063ffffffff60c01b1963ffffffff60c01b83549260c01b169116179055565b61300d6106b9565b9d6001600160a01b038f921682526001600160a01b031690602001526001600160a01b031660408d01526001600160a01b031660608c015260808b015260a08a015260c08901526001600160a01b031660e088015260c01c63ffffffff16610100870152610120860190613086919063ffffffff169052565b63ffffffff1661014085015263ffffffff1661016084015236906130a9926106ef565b6101808201526130b890614307565b61048e6001606555565b916040519160208301936bffffffffffffffffffffffff199060601b16845260348301526054820152605481526130f8816105e6565b51902090565b93929160209161311691604087526040870191612dec565b930152565b9081602091031261042e57604051906020820182811067ffffffffffffffff8211176105945760405235815290565b6107409161018090825181526020830151602082015260408301516040820152606083015160608201526080830151608082015260a083015160a082015260c083015160c082015260e083015160e082015261010080840151908201526131bf610120808501519083019063ffffffff169052565b6101408381015163ffffffff1690820152816101608094015193820152019061124f565b6131fb6040929594939560608352606083019061314a565b9460208201520152565b90602061074092818152019061124f565b9c9a999897969594939291909661322b6135c3565b60ff61086b5460e81c166107d257613244908e336130c2565b96604051809e61325382610599565b81526020015260408d015260608c015260808b015260a08a015260c089015260e088015261010087015263ffffffff16610120860152613086565b97929095939196949761329f6135c3565b60ff61086b5460e01c166128f3576132ba6101408201612d25565b63ffffffff8042169116101580613358575b6128c257613341613353966133396130b89b6132eb610dfb368761267f565b9a6132f4610678565b9b6132ff368861267f565b8d5260208d01528660408d01528760608d015261331d368b846106ef565b60808d015260a08c01526133318535613b84565b9836916106ef565b9536916106ef565b9461010060e0830135920135906141d5565b613f5f565b506133666040820135613b84565b6001600160a01b03163314156132cc565b9061338182610884565b61338e6040519182610656565b828152809261339f601f1991610884565b01905f5b8281106133af57505050565b8060606020809385010152016133a3565b60208183031261042e5780519067ffffffffffffffff821161042e570181601f8201121561042e5780516133f3816106d3565b926134016040519485610656565b8184526020828401011161042e57610740916020808501910161122e565b63ffffffff809116908114612f805760010190565b6040516130f881613451602082019460408652606083019061314a565b46604083015203601f198101835282610656565b9190916134706135c3565b60ff61086b5460e01c166128f35761014081015163ffffffff42811691161015806134e2575b6128c2576130b8926134a782613434565b60c0830151602084015190610160850151926134c1610678565b958652602086015260408501526060840152608083015260a0820152613f5f565b506134f06040820151613b84565b6001600160a01b0316331415613496565b7342000000000000000000000000000000000000078033036135b157602060049160405192838092636e296e4560e01b82525afa9081156135ac575f9161357d575b506001600160a01b0361356261216d610869546001600160a01b031690565b91160361356b57565b6040516336a816d960e01b8152600490fd5b61359f915060203d6020116135a5575b6135978183610656565b8101906146b8565b5f613543565b503d61358d565b6135e1565b60405163253a6fc960e11b8152600490fd5b60026065541461042e576002606555565b91908203918211612f8057565b6040513d5f823e3d90fd5b926107409695929491946101409585525f60208601526040850152606084015263ffffffff809116608084015260a08301525f60c083015260e08201525f61010082015281610120820152019061124f565b9193949690959660070b906706f05b59d3b2000061365b836146cd565b101561381b576ec097ce7bc90715b34b9f100000000084116138095763ffffffff93613689858a16426135d4565b857f000000000000000000000000000000000000000000000000000000000000000016106137f75761086b5460c01c63ffffffff16986136cb6123658b61341f565b6001600160a01b039586807f000000000000000000000000000000000000000000000000000000000000000016981692888414806137ee575b156137b2578034036137a057883b1561042e575f6004996040519a8b8092630d0e30db60e41b825234905af19889156135ac5761376f613782978a927f32ed1a409ef04c7b0227189c3a103dc5ac10e775a15b785dcc510201f7c25ad39c613787575b505b8361471b565b92604051998a99169d169b1693876135ec565b0390a4565b8061379461379a926105b6565b80610424565b5f613767565b604051636452a35d60e01b8152600490fd5b7f32ed1a409ef04c7b0227189c3a103dc5ac10e775a15b785dcc510201f7c25ad398508761376f613782976137e98430338a6146dc565b613769565b50341515613704565b60405163f722177f60e01b8152600490fd5b60405163622db5a960e11b8152600490fd5b60405163284f109760e21b8152600490fd5b6001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000811691168114613864575b50565b4761386c5750565b4790803b1561042e575f90600460405180948193630d0e30db60e41b83525af180156135ac57156138615761048e906105b6565b61074092916040516139298161391b602082019460208652805160408401526020810151606084015260a06138e5604083015160c06080870152610100860190612c5e565b606083015163ffffffff168583015260808301516001600160a01b031660c0860152910151838203603f190160e0850152612c91565b03601f198101835282610656565b51902091614751565b61393d6002916129f2565b500162ffffff8260081c16805f5281602052600160ff60405f205494161b8080941614613975575f5260205260405f20908154179055565b60405163954476d960e01b8152600490fd5b9081602091031261042e575190565b91908201809211612f8057565b91959495939092935f9681519081815103613b725781613a22575b505050826139cd575b50505050565b6001600160a01b0381613a017ffa7fa7cf6d7dde5f9be65a67e6a1a747e7aa864dcd2d793353c722d80fbbb3579386614814565b6040805195865233602087015291169463ffffffff1693a45f8080806139c7565b604080516370a0823160e01b81523060048083019190915291906020816024816001600160a01b038b165afa9081156135ac575f91613b53575b505f805b868110613a715750505050506139be565b613a7b8189612d85565b51613a89575b600101613a60565b90613a9f90613a98838a612d85565b5190613996565b90828211613b4357613ad9612b6d613ac7613aba848a612d85565b516001600160a01b031690565b613ad1848c612d85565b51908c6147a2565b15613a81579c5087613b39613b318f613b1c613aba613b15613afb848f612d85565b51966001600160a01b03165f5261087360205260405f2090565b928b612d85565b6001600160a01b03165f5260205260405f2090565b918254613996565b905560019c613a81565b50505051632ddaa83160e11b8152fd5b613b6c915060203d602011611088576110798183610656565b5f613a5c565b6040516319a5316760e31b8152600490fd5b6001600160a01b0390613b9681614b97565b1690565b91612b6d90613c1392845160408096015191865191613bb8836105ca565b8252613929613bd360208401924684528985019586526129f2565b5054938851928391613bf86020840196602088525160608d86015260a085019061314a565b9151606084015251608083015203601f198101835282610656565b613c1a5750565b5163582f497d60e11b8152600490fd5b613c3382612d76565b52565b9a989693919c9b9997959492909c6101e08c019d8c5260208c015260408b015260608a0152608089015263ffffffff80921660a08901521660c087015260e08601526101008501526101208401526101408301528051610160830152602081015161018083015260408101516101a08301526060015190613cb682612d76565b6101c00152565b9061074094936080936001600160a01b0380931684526020840152166040820152816060820152019061124f565b905f82516101208101613d02815163ffffffff1690565b63ffffffff42911610613f4d576020850151906002613d2a835f5261087260205260405f2090565b5414613f3b57613d4486925f5261087260205260405f2090565b6002905560608301519060808401519160a08501519260c0860151918560a0810151938860e0810151956101008201519751613d839063ffffffff1690565b61014083015163ffffffff166040840151918451936020860151956101600151613dac906141c0565b966060890151986080019e8f51613dc2906141c0565b906040015190613dd06106c6565b9a8b5260208b015260408a0152600260608a01526040519d8e9b613df49b8d613c36565b037f44b559f101f8fbcc8a0ea43fa91a05a729a5ea6e14a7c75aa750374690137208905f94a46080820151613e2890613b84565b9060408601519560600151613e3c90613b84565b9260800151613e4a90613b84565b6001600160a01b03919082167f0000000000000000000000000000000000000000000000000000000000000000831603613f265784613f13575b613e9087838616614bb2565b51928351151580613f09575b613eaa575b50505050509050565b1690813b15613f055783613ed8959660405196879586948593633a5be8cb60e01b8552339160048601613cbd565b03925af180156135ac57613ef2575b808080808594613ea1565b80613794613eff926105b6565b5f613ee7565b8380fd5b50803b1515613e9c565b613f218730338587166146dc565b613e84565b5f9450613f368785858516614670565b613e90565b604051630479306360e51b8152600490fd5b60405163d642b7d960e01b8152600490fd5b8051916101208301613f75815163ffffffff1690565b63ffffffff42911610613f4d5760208301516001613f9c825f5261087260205260405f2090565b54036141b9576001905b6002613fbb825f5261087260205260405f2090565b5414613f3b57613fd7613fdd915f5261087260205260405f2090565b60029055565b7f44b559f101f8fbcc8a0ea43fa91a05a729a5ea6e14a7c75aa75037469013720860608601516080870151906140aa8760a08a0151958a60c08101519760a08401519860e08301519961403a6101008501519c5163ffffffff1690565b61014085015163ffffffff169160408601519386519561409e61406661016060208b01519a01516141c0565b9960608c01519b604061407c60808301516141c0565b91015190602061408a6106c6565b9e8f528e015260408d015260608c01613c2a565b6040519c8d9c8d613c36565b0390a46140ba6080830151613b84565b9160408201519160806140dc816140d46060850151613b84565b940151613b84565b6001600160a01b03929083167f00000000000000000000000000000000000000000000000000000000000000008416036141a65761411e853033868a166146dc565b61412a85848616614bb2565b015191825115158061419c575b614143575b5050505050565b16803b1561042e57614171935f809460405196879586948593633a5be8cb60e01b8552339160048601613cbd565b03925af180156135ac57614189575b8080808061413c565b80613794614196926105b6565b5f614180565b50803b1515614137565b6141b4858533868a166146dc565b61412a565b5f90613fa6565b805190816141ce5750505f90565b6020012090565b939260429361048e979660208151910120906040519260208401947f8d1994e2bbbd77564cdca06dd819e7ee2a5efa06c80dcb59a4a7b6e39edc538f86526040850152856060850152608084015260a083015260c082015260c0815261423a8161061e565b5190209061047f549061048054906040519160208301937fc2f8787176b8ac6bf7215b4adcc1e069bf4ab82d9ab1df05a57a91d425935b6e8552604084015260608301526080820152608081526142908161063a565b519020906040519161190160f01b8352600283015260228201522090614dcf565b96926107409a9996949198959261014099895260208901526040880152606087015263ffffffff928380921660808801521660a08601521660c084015260e083015261010082015281610120820152019061124f565b6143118151614b97565b6101208101614330614327825163ffffffff1690565b63ffffffff1690565b804210908115614560575b506137f757610140820191614354835163ffffffff1690565b9063ffffffff9182614388817f00000000000000000000000000000000000000000000000000000000000000001642613996565b91161161454e5761016081015163ffffffff169180831680614509575b505060408101908151916001600160a01b037f00000000000000000000000000000000000000000000000000000000000000001680931480614500575b156144b357608082015134036137a057823b1561042e575f60049360405194858092630d0e30db60e41b825234905af19283156135ac577f32ed1a409ef04c7b0227189c3a103dc5ac10e775a15b785dcc510201f7c25ad3936144a0575b505b5161378260608301519260808101519060a081015160c08201519761447f6144746101008501519b5163ffffffff1690565b9b5163ffffffff1690565b83519b60208501519361018060e0870151960151966040519a8b9a8b6142b1565b806137946144ad926105b6565b5f614440565b9150346137a057816144fb6144ec61216d7f32ed1a409ef04c7b0227189c3a103dc5ac10e775a15b785dcc510201f7c25ad39551613b84565b608084015190309033906146dc565b614442565b503415156143e2565b6301e133801015614539575b5060e081015115614527575f806143a5565b60405163495d907f60e01b8152600490fd5b916145479192421690612f68565b905f614515565b60405163582e388960e01b8152600490fd5b61456b9150426135d4565b63ffffffff7f000000000000000000000000000000000000000000000000000000000000000016105f61433b565b60ff5f5460081c161561042e57565b60ff5f5460081c161561042e576001606555565b6001600160a01b0316801561460457610869816001600160a01b03198254161790557fa9e8c42c9e7fca7f62755189a16b2f5314d43d8fb24e91ba54e6d65f9314e8495f80a2565b60405163ba97b39d60e01b8152600490fd5b6001600160a01b0316801561465e5761086a816001600160a01b03198254161790557fa73e8909f8616742d7fe701153d82666f7b7cd480552e23ebb05d358c22fd04e5f80a2565b604051635b03092b60e11b8152600490fd5b60405163a9059cbb60e01b60208201526001600160a01b039092166024830152604482019290925261048e916146b382606481015b03601f198101845283610656565b614ead565b9081602091031261042e575161074081610472565b5f81126146d75790565b5f0390565b909261048e93604051936323b872dd60e01b60208601526001600160a01b0380921660248601521660448401526064830152606482526146b38261063a565b90670de0b6b3a7640000915f828403921283831281169084841390151617612f8057818102918183041490151715612f80570490565b929091905f915b845183101561479a5761476b8386612d85565b519081811015614789575f52602052600160405f205b920191614758565b905f52602052600160405f20614781565b915092501490565b60405163a9059cbb60e01b60208281019182526001600160a01b039094166024830152604482019490945290925f916147de816064810161391b565b519082855af1903d5f5190836147f5575b50505090565b9192509061480a57503b15155b5f80806147ef565b6001915014614802565b906001600160a01b0390818116907f00000000000000000000000000000000000000000000000000000000000000008316820361493e5750803b1561042e57604051632e1a7d4d60e01b815260048101849052905f908290602490829084905af180156135ac5761492b575b50610c5a549161489961086a546001600160a01b031690565b73420000000000000000000000000000000000001090813b1561042e57604051631474f2a960e31b8152602086901c949094166001600160a01b0390811660048601521660248401526044830182905263ffffffff909316606483015260a060848301525f60a483018190529192839160c4918391905af180156135ac5761491e5750565b8061379461048e926105b6565b80613794614938926105b6565b5f614880565b91807f000000000000000000000000000000000000000000000000000000000000000016151580614b6c575b1561498e5750505061048e9061498961086a546001600160a01b031690565b614fe1565b806149bb6149ae856001600160a01b03165f52610c5c60205260405f2090565b546001600160a01b031690565b16614b48577342000000000000000000000000000000000000105b16906149fa61216d6149ae856001600160a01b03165f52610c5d60205260405f2090565b15614ac2578382614a0a92614f3d565b614a296149ae836001600160a01b03165f52610c5d60205260405f2090565b90614a3d61086a546001600160a01b031690565b91614a4e610c5a5463ffffffff1690565b823b1561042e5760405163540abf7360e01b81526001600160a01b0395861660048201529185166024830152929093166044840152606483019390935263ffffffff16608482015260c060a48201525f60c482018190529091829081838160e481015b03925af180156135ac5761491e5750565b5091614ad761086a546001600160a01b031690565b92614ae8610c5a5463ffffffff1690565b93813b1561042e57604051631474f2a960e31b81526001600160a01b03948516600482015293166024840152604483019190915263ffffffff909216606482015260a060848201525f60a482018190529091829081838160c48101614ab1565b614b676149ae846001600160a01b03165f52610c5c60205260405f2090565b6149d6565b50807f000000000000000000000000000000000000000000000000000000000000000016821461496a565b60a01c614ba057565b6040516379ec0ed760e11b8152600490fd5b6001600160a01b0390811690813b15614bf2579061048e92917f000000000000000000000000000000000000000000000000000000000000000016614670565b7f000000000000000000000000000000000000000000000000000000000000000016803b1561042e575f8091602460405180948193632e1a7d4d60e01b83528860048401525af180156135ac57614c64575b5081471061042e575f80809381935af1614c5c612dbd565b501561042e57565b614c6d906105b6565b5f614c44565b614c7c81614d8c565b6001600160a01b0381167fbc7cd75a20ee27fd9adebab32041f755214dbc6bffa90cc0225b39da2e5c2d3b5f80a2815115801590614d34575b614cbd575050565b5f80613861937f206661696c65640000000000000000000000000000000000000000000000000060408051614cf1816105ca565b602781527f416464726573733a206c6f772d6c6576656c2064656c65676174652063616c6c60208201520152602081519101845af4614d2e612dbd565b916152df565b505f614cb5565b614d4481614d8c565b6001600160a01b0381167fbc7cd75a20ee27fd9adebab32041f755214dbc6bffa90cc0225b39da2e5c2d3b5f80a2815115801590614d8457614cbd575050565b506001614cb5565b803b1561042e576001600160a01b037f360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc91166001600160a01b0319825416179055565b614dd983836152ae565b6005819592951015612d8057159384614e97575b508315614e11575b50505015614dff57565b60405163938a182160e01b8152600490fd5b5f929350908291604051614e498161391b6020820194630b135d3f60e11b998a8752602484015260406044840152606483019061124f565b51915afa90614e56612dbd565b82614e89575b82614e6c575b50505f8080614df5565b614e8191925060208082518301019101613987565b145f80614e62565b915060208251101591614e5c565b6001600160a01b0383811691161493505f614ded565b905f806001600160a01b03614f049416927f5361666545524332303a206c6f772d6c6576656c2063616c6c206661696c65646020604051614eed81610578565b818152015260208151910182855af1614d2e612dbd565b8051908115918215614f1a575b50501561042e57565b819250906020918101031261042e5760200151614f36816119a2565b5f80614f11565b6044919260206001600160a01b0360405194858092636eb1769f60e11b8252306004830152808916602483015286165afa9283156135ac575f93614fc0575b508201809211612f805760405163095ea7b360e01b60208201526001600160a01b039093166024840152604483019190915261048e91906146b382606481016146a5565b614fda91935060203d602011611088576110798183610656565b915f614f7c565b906001600160a01b038092167f000000000000000000000000000000000000000000000000000000000000000090837f0000000000000000000000000000000000000000000000000000000000000000169361503e848685614f3d565b604094604051926332dd704760e21b84526020956004948781600481875afa9687156135ac5788915f9861526d575b506040516352b7631960e11b81529086166001600160a01b03811660048301529097909588916024918391165afa9586156135ac575f9661524e575b5095867f0000000000000000000000000000000000000000000000000000000000000000975b6150de57505050505050505050565b8681111561524857865b88156151a057843b1561042e578951634701287760e11b815287810182815263ffffffff7f0000000000000000000000000000000000000000000000000000000000000000166020820152604081018690526001600160a01b03881660608201525f6080820181905260a082018190526107d060c0830152919391908490819060e0010381838a5af19283156135ac576151879361518d575b506135d4565b806150cf565b8061379461519a926105b6565b5f615181565b89516337e9a82760e11b815287810182815263ffffffff7f0000000000000000000000000000000000000000000000000000000000000000166020820152604081018690526001600160a01b038816606082015290929084908490819060800103815f8a5af19283156135ac576151879361521b57506135d4565b61523a90853d8711615241575b6152328183610656565b81019061528e565b505f615181565b503d615228565b806150e8565b615266919650873d8911611088576110798183610656565b945f6150a9565b8691985061528790833d85116135a5576135978183610656565b979061506d565b9081602091031261042e575167ffffffffffffffff8116810361042e5790565b9060418151145f146152d65761122a91602082015190606060408401519301515f1a90615308565b50505f90600290565b90156152f9578151156152f0575090565b3b1561042e5790565b50805190811561042e57602001fd5b7f7fffffffffffffffffffffffffffffff5d576e7357a4501ddfe92f46681b20a08411615378576020935f9360ff60809460405194855216868401526040830152606082015282805260015afa156135ac575f516001600160a01b0381161561537057905f90565b505f90600190565b505050505f9060039056fea264697066735822122055ad2af729c797abdaca5785a9aa033a3c01eebb02e628fb93e9a77e28791a2964736f6c63430008170033"
}