ETH Price: $2,053.09 (-1.64%)

Transaction Decoder

Block:
14729533 at May-07-2022 11:29:41 AM +UTC
Transaction Fee:
0.002806674422909147 ETH $5.76
Gas Used:
104,303 Gas / 26.908856149 Gwei

Emitted Events:

84 FiatTokenProxy.0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef( 0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef, 0x000000000000000000000000bc3ed6b537f2980e66f396fe14210a56ba3f72c4, 0x0000000000000000000000003666f603cc164936c1b87e207f36beba4ac5f18a, 0000000000000000000000000000000000000000000000000000000017e6c640 )
85 StateSender.StateSynced( id=2044413, contractAddress=0x8397259c...a11afa28a, data=0x0000000000000000000000004E9840F3C1FF368A10731D15C11516B9FE7E18980000000000000000000000002E929203D8F2FCF88C4FF7B7362D08169B6F661C000000000000000000000000000000000000000000000000000000000000006000000000000000000000000000000000000000000000000000000000000001400000000000000000000000003666F603CC164936C1B87E207F36BEBA4AC5F18A000000000000000000000000000000000000000000000000000000000000004000000000000000000000000000000000000000000000000000000000000000C4CC29A306000000000000000000000000BC3ED6B537F2980E66F396FE14210A56BA3F72C40000000000000000000000000000000000000000000000000000000017E6C6400000000000000000000000000000000000000000000000000000000017C4A38300000000000000000000000000000000000000000000000000000000627F929E0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000 )
86 L1_ERC20_Bridge.TransferSentToL2( chainId=137, recipient=[Sender] 0xbc3ed6b537f2980e66f396fe14210a56ba3f72c4, amount=401000000, amountOutMin=398762883, deadline=1652527774, relayer=0x00000000...000000000, relayerFee=0 )

Account State Difference:

  Address   Before After State Difference Code
0x28e4F3a7...189A5bFbE
(Polygon (Matic): State Syncer)
0x3666f603...a4AC5f18a
(Hop Protocol: USDC Bridge)
0xA0b86991...E3606eB48
0xbc3ed6B5...6ba3f72C4
0.27629903245954275 Eth
Nonce: 270
0.273492358036633603 Eth
Nonce: 271
0.002806674422909147
(Ethermine)
1,465.936664741909367073 Eth1,465.936821196409367073 Eth0.0001564545

Execution Trace

L1_ERC20_Bridge.sendToL2( chainId=137, recipient=0xbc3ed6B537f2980e66f396Fe14210A56ba3f72C4, amount=401000000, amountOutMin=398762883, deadline=1652527774, relayer=0x0000000000000000000000000000000000000000, relayerFee=0 )
  • FiatTokenProxy.23b872dd( )
    • FiatTokenV2_1.transferFrom( from=0xbc3ed6B537f2980e66f396Fe14210A56ba3f72C4, to=0x3666f603Cc164936C1b87e207F36BEBa4AC5f18a, value=401000000 ) => ( True )
    • PolygonMessengerWrapper.sendCrossDomainMessage( _calldata=0xCC29A306000000000000000000000000BC3ED6B537F2980E66F396FE14210A56BA3F72C40000000000000000000000000000000000000000000000000000000017E6C6400000000000000000000000000000000000000000000000000000000017C4A38300000000000000000000000000000000000000000000000000000000627F929E00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000 )
      • FxRoot.sendMessageToChild( _receiver=0x2e929203D8F2Fcf88C4Ff7b7362d08169b6F661c, _data=0x0000000000000000000000003666F603CC164936C1B87E207F36BEBA4AC5F18A000000000000000000000000000000000000000000000000000000000000004000000000000000000000000000000000000000000000000000000000000000C4CC29A306000000000000000000000000BC3ED6B537F2980E66F396FE14210A56BA3F72C40000000000000000000000000000000000000000000000000000000017E6C6400000000000000000000000000000000000000000000000000000000017C4A38300000000000000000000000000000000000000000000000000000000627F929E0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000 )
        • StateSender.syncState( receiver=0x8397259c983751DAf40400790063935a11afa28a, data=0x0000000000000000000000004E9840F3C1FF368A10731D15C11516B9FE7E18980000000000000000000000002E929203D8F2FCF88C4FF7B7362D08169B6F661C000000000000000000000000000000000000000000000000000000000000006000000000000000000000000000000000000000000000000000000000000001400000000000000000000000003666F603CC164936C1B87E207F36BEBA4AC5F18A000000000000000000000000000000000000000000000000000000000000004000000000000000000000000000000000000000000000000000000000000000C4CC29A306000000000000000000000000BC3ED6B537F2980E66F396FE14210A56BA3F72C40000000000000000000000000000000000000000000000000000000017E6C6400000000000000000000000000000000000000000000000000000000017C4A38300000000000000000000000000000000000000000000000000000000627F929E0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000 )
          sendToL2[L1_Bridge (ln:245)]
          File 1 of 6: L1_ERC20_Bridge
          // SPDX-License-Identifier: MIT
          pragma solidity 0.6.12;
          pragma experimental ABIEncoderV2;
          import "@openzeppelin/contracts/token/ERC20/IERC20.sol";
          import "@openzeppelin/contracts/token/ERC20/SafeERC20.sol";
          import "./L1_Bridge.sol";
          /**
           * @dev A L1_Bridge that uses an ERC20 as the canonical token
           */
          contract L1_ERC20_Bridge is L1_Bridge {
              using SafeERC20 for IERC20;
              IERC20 public immutable l1CanonicalToken;
              constructor (IERC20 _l1CanonicalToken, address[] memory bonders, address _governance) public L1_Bridge(bonders, _governance) {
                  l1CanonicalToken = _l1CanonicalToken;
              }
              /* ========== Override Functions ========== */
              function _transferFromBridge(address recipient, uint256 amount) internal override {
                  l1CanonicalToken.safeTransfer(recipient, amount);
              }
              function _transferToBridge(address from, uint256 amount) internal override {
                  l1CanonicalToken.safeTransferFrom(from, address(this), amount);
              }
          }
          // SPDX-License-Identifier: MIT
          pragma solidity >=0.6.0 <0.8.0;
          /**
           * @dev Interface of the ERC20 standard as defined in the EIP.
           */
          interface IERC20 {
              /**
               * @dev Returns the amount of tokens in existence.
               */
              function totalSupply() external view returns (uint256);
              /**
               * @dev Returns the amount of tokens owned by `account`.
               */
              function balanceOf(address account) external view returns (uint256);
              /**
               * @dev Moves `amount` tokens from the caller's account to `recipient`.
               *
               * Returns a boolean value indicating whether the operation succeeded.
               *
               * Emits a {Transfer} event.
               */
              function transfer(address recipient, uint256 amount) external returns (bool);
              /**
               * @dev Returns the remaining number of tokens that `spender` will be
               * allowed to spend on behalf of `owner` through {transferFrom}. This is
               * zero by default.
               *
               * This value changes when {approve} or {transferFrom} are called.
               */
              function allowance(address owner, address spender) external view returns (uint256);
              /**
               * @dev Sets `amount` as the allowance of `spender` over the caller's tokens.
               *
               * Returns a boolean value indicating whether the operation succeeded.
               *
               * IMPORTANT: Beware that changing an allowance with this method brings the risk
               * that someone may use both the old and the new allowance by unfortunate
               * transaction ordering. One possible solution to mitigate this race
               * condition is to first reduce the spender's allowance to 0 and set the
               * desired value afterwards:
               * https://github.com/ethereum/EIPs/issues/20#issuecomment-263524729
               *
               * Emits an {Approval} event.
               */
              function approve(address spender, uint256 amount) external returns (bool);
              /**
               * @dev Moves `amount` tokens from `sender` to `recipient` using the
               * allowance mechanism. `amount` is then deducted from the caller's
               * allowance.
               *
               * Returns a boolean value indicating whether the operation succeeded.
               *
               * Emits a {Transfer} event.
               */
              function transferFrom(address sender, address recipient, uint256 amount) external returns (bool);
              /**
               * @dev Emitted when `value` tokens are moved from one account (`from`) to
               * another (`to`).
               *
               * Note that `value` may be zero.
               */
              event Transfer(address indexed from, address indexed to, uint256 value);
              /**
               * @dev Emitted when the allowance of a `spender` for an `owner` is set by
               * a call to {approve}. `value` is the new allowance.
               */
              event Approval(address indexed owner, address indexed spender, uint256 value);
          }
          // SPDX-License-Identifier: MIT
          pragma solidity >=0.6.0 <0.8.0;
          import "./IERC20.sol";
          import "../../math/SafeMath.sol";
          import "../../utils/Address.sol";
          /**
           * @title SafeERC20
           * @dev Wrappers around ERC20 operations that throw on failure (when the token
           * contract returns false). Tokens that return no value (and instead revert or
           * throw on failure) are also supported, non-reverting calls are assumed to be
           * successful.
           * To use this library you can add a `using SafeERC20 for IERC20;` statement to your contract,
           * which allows you to call the safe operations as `token.safeTransfer(...)`, etc.
           */
          library SafeERC20 {
              using SafeMath for uint256;
              using Address for address;
              function safeTransfer(IERC20 token, address to, uint256 value) internal {
                  _callOptionalReturn(token, abi.encodeWithSelector(token.transfer.selector, to, value));
              }
              function safeTransferFrom(IERC20 token, address from, address to, uint256 value) internal {
                  _callOptionalReturn(token, abi.encodeWithSelector(token.transferFrom.selector, from, to, value));
              }
              /**
               * @dev Deprecated. This function has issues similar to the ones found in
               * {IERC20-approve}, and its usage is discouraged.
               *
               * Whenever possible, use {safeIncreaseAllowance} and
               * {safeDecreaseAllowance} instead.
               */
              function safeApprove(IERC20 token, address spender, uint256 value) internal {
                  // safeApprove should only be called when setting an initial allowance,
                  // or when resetting it to zero. To increase and decrease it, use
                  // 'safeIncreaseAllowance' and 'safeDecreaseAllowance'
                  // solhint-disable-next-line max-line-length
                  require((value == 0) || (token.allowance(address(this), spender) == 0),
                      "SafeERC20: approve from non-zero to non-zero allowance"
                  );
                  _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, value));
              }
              function safeIncreaseAllowance(IERC20 token, address spender, uint256 value) internal {
                  uint256 newAllowance = token.allowance(address(this), spender).add(value);
                  _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, newAllowance));
              }
              function safeDecreaseAllowance(IERC20 token, address spender, uint256 value) internal {
                  uint256 newAllowance = token.allowance(address(this), spender).sub(value, "SafeERC20: decreased allowance below zero");
                  _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, newAllowance));
              }
              /**
               * @dev Imitates a Solidity high-level call (i.e. a regular function call to a contract), relaxing the requirement
               * on the return value: the return value is optional (but if data is returned, it must not be false).
               * @param token The token targeted by the call.
               * @param data The call data (encoded using abi.encode or one of its variants).
               */
              function _callOptionalReturn(IERC20 token, bytes memory data) private {
                  // We need to perform a low level call here, to bypass Solidity's return data size checking mechanism, since
                  // we're implementing it ourselves. We use {Address.functionCall} to perform this call, which verifies that
                  // the target address contains contract code and also asserts for success in the low-level call.
                  bytes memory returndata = address(token).functionCall(data, "SafeERC20: low-level call failed");
                  if (returndata.length > 0) { // Return data is optional
                      // solhint-disable-next-line max-line-length
                      require(abi.decode(returndata, (bool)), "SafeERC20: ERC20 operation did not succeed");
                  }
              }
          }
          // SPDX-License-Identifier: MIT
          pragma solidity 0.6.12;
          pragma experimental ABIEncoderV2;
          import "./Bridge.sol";
          import "../interfaces/IMessengerWrapper.sol";
          /**
           * @dev L1_Bridge is responsible for the bonding and challenging of TransferRoots. All TransferRoots
           * originate in the L1_Bridge through `bondTransferRoot` and are propagated up to destination L2s.
           */
          abstract contract L1_Bridge is Bridge {
              struct TransferBond {
                  address bonder;
                  uint256 createdAt;
                  uint256 totalAmount;
                  uint256 challengeStartTime;
                  address challenger;
                  bool challengeResolved;
              }
              /* ========== State ========== */
              mapping(bytes32 => uint256) public transferRootCommittedAt;
              mapping(bytes32 => TransferBond) public transferBonds;
              mapping(uint256 => mapping(address => uint256)) public timeSlotToAmountBonded;
              mapping(uint256 => uint256) public chainBalance;
              /* ========== Config State ========== */
              address public governance;
              mapping(uint256 => IMessengerWrapper) public crossDomainMessengerWrappers;
              mapping(uint256 => bool) public isChainIdPaused;
              uint256 public challengePeriod = 1 days;
              uint256 public challengeResolutionPeriod = 10 days;
              uint256 public minTransferRootBondDelay = 15 minutes;
              
              uint256 public constant CHALLENGE_AMOUNT_DIVISOR = 10;
              uint256 public constant TIME_SLOT_SIZE = 4 hours;
              /* ========== Events ========== */
              event TransferSentToL2(
                  uint256 indexed chainId,
                  address indexed recipient,
                  uint256 amount,
                  uint256 amountOutMin,
                  uint256 deadline,
                  address indexed relayer,
                  uint256 relayerFee
              );
              event TransferRootBonded (
                  bytes32 indexed root,
                  uint256 amount
              );
              event TransferRootConfirmed(
                  uint256 indexed originChainId,
                  uint256 indexed destinationChainId,
                  bytes32 indexed rootHash,
                  uint256 totalAmount
              );
              event TransferBondChallenged(
                  bytes32 indexed transferRootId,
                  bytes32 indexed rootHash,
                  uint256 originalAmount
              );
              event ChallengeResolved(
                  bytes32 indexed transferRootId,
                  bytes32 indexed rootHash,
                  uint256 originalAmount
              );
              /* ========== Modifiers ========== */
              modifier onlyL2Bridge(uint256 chainId) {
                  IMessengerWrapper messengerWrapper = crossDomainMessengerWrappers[chainId];
                  messengerWrapper.verifySender(msg.sender, msg.data);
                  _;
              }
              constructor (address[] memory bonders, address _governance) public Bridge(bonders) {
                  governance = _governance;
              }
              /* ========== Send Functions ========== */
              /**
               * @notice `amountOutMin` and `deadline` should be 0 when no swap is intended at the destination.
               * @notice `amount` is the total amount the user wants to send including the relayer fee
               * @dev Send tokens to a supported layer-2 to mint hToken and optionally swap the hToken in the
               * AMM at the destination.
               * @param chainId The chainId of the destination chain
               * @param recipient The address receiving funds at the destination
               * @param amount The amount being sent
               * @param amountOutMin The minimum amount received after attempting to swap in the destination
               * AMM market. 0 if no swap is intended.
               * @param deadline The deadline for swapping in the destination AMM market. 0 if no
               * swap is intended.
               * @param relayer The address of the relayer at the destination.
               * @param relayerFee The amount distributed to the relayer at the destination. This is subtracted from the `amount`.
               */
              function sendToL2(
                  uint256 chainId,
                  address recipient,
                  uint256 amount,
                  uint256 amountOutMin,
                  uint256 deadline,
                  address relayer,
                  uint256 relayerFee
              )
                  external
                  payable
              {
                  IMessengerWrapper messengerWrapper = crossDomainMessengerWrappers[chainId];
                  require(messengerWrapper != IMessengerWrapper(0), "L1_BRG: chainId not supported");
                  require(isChainIdPaused[chainId] == false, "L1_BRG: Sends to this chainId are paused");
                  require(amount > 0, "L1_BRG: Must transfer a non-zero amount");
                  require(amount >= relayerFee, "L1_BRG: Relayer fee cannot exceed amount");
                  _transferToBridge(msg.sender, amount);
                  bytes memory message = abi.encodeWithSignature(
                      "distribute(address,uint256,uint256,uint256,address,uint256)",
                      recipient,
                      amount,
                      amountOutMin,
                      deadline,
                      relayer,
                      relayerFee
                  );
                  chainBalance[chainId] = chainBalance[chainId].add(amount);
                  messengerWrapper.sendCrossDomainMessage(message);
                  emit TransferSentToL2(
                      chainId,
                      recipient,
                      amount,
                      amountOutMin,
                      deadline,
                      relayer,
                      relayerFee
                  );
              }
              /* ========== TransferRoot Functions ========== */
              /**
               * @dev Setting a TransferRoot is a two step process.
               * @dev   1. The TransferRoot is bonded with `bondTransferRoot`. Withdrawals can now begin on L1
               * @dev      and recipient L2's
               * @dev   2. The TransferRoot is confirmed after `confirmTransferRoot` is called by the l2 bridge
               * @dev      where the TransferRoot originated.
               */
              /**
               * @dev Used by the Bonder to bond a TransferRoot and propagate it up to destination L2s
               * @param rootHash The Merkle root of the TransferRoot Merkle tree
               * @param destinationChainId The id of the destination chain
               * @param totalAmount The amount destined for the destination chain
               */
              function bondTransferRoot(
                  bytes32 rootHash,
                  uint256 destinationChainId,
                  uint256 totalAmount
              )
                  external
                  onlyBonder
                  requirePositiveBalance
              {
                  bytes32 transferRootId = getTransferRootId(rootHash, totalAmount);
                  require(transferRootCommittedAt[transferRootId] == 0, "L1_BRG: TransferRoot has already been confirmed");
                  require(transferBonds[transferRootId].createdAt == 0, "L1_BRG: TransferRoot has already been bonded");
                  uint256 currentTimeSlot = getTimeSlot(block.timestamp);
                  uint256 bondAmount = getBondForTransferAmount(totalAmount);
                  timeSlotToAmountBonded[currentTimeSlot][msg.sender] = timeSlotToAmountBonded[currentTimeSlot][msg.sender].add(bondAmount);
                  transferBonds[transferRootId] = TransferBond(
                      msg.sender,
                      block.timestamp,
                      totalAmount,
                      uint256(0),
                      address(0),
                      false
                  );
                  _distributeTransferRoot(rootHash, destinationChainId, totalAmount);
                  emit TransferRootBonded(rootHash, totalAmount);
              }
              /**
               * @dev Used by an L2 bridge to confirm a TransferRoot via cross-domain message. Once a TransferRoot
               * has been confirmed, any challenge against that TransferRoot can be resolved as unsuccessful.
               * @param originChainId The id of the origin chain
               * @param rootHash The Merkle root of the TransferRoot Merkle tree
               * @param destinationChainId The id of the destination chain
               * @param totalAmount The amount destined for each destination chain
               * @param rootCommittedAt The block timestamp when the TransferRoot was committed on its origin chain
               */
              function confirmTransferRoot(
                  uint256 originChainId,
                  bytes32 rootHash,
                  uint256 destinationChainId,
                  uint256 totalAmount,
                  uint256 rootCommittedAt
              )
                  external
                  onlyL2Bridge(originChainId)
              {
                  bytes32 transferRootId = getTransferRootId(rootHash, totalAmount);
                  require(transferRootCommittedAt[transferRootId] == 0, "L1_BRG: TransferRoot already confirmed");
                  require(rootCommittedAt > 0, "L1_BRG: rootCommittedAt must be greater than 0");
                  transferRootCommittedAt[transferRootId] = rootCommittedAt;
                  chainBalance[originChainId] = chainBalance[originChainId].sub(totalAmount, "L1_BRG: Amount exceeds chainBalance. This indicates a layer-2 failure.");
                  // If the TransferRoot was never bonded, distribute the TransferRoot.
                  TransferBond storage transferBond = transferBonds[transferRootId];
                  if (transferBond.createdAt == 0) {
                      _distributeTransferRoot(rootHash, destinationChainId, totalAmount);
                  }
                  emit TransferRootConfirmed(originChainId, destinationChainId, rootHash, totalAmount);
              }
              function _distributeTransferRoot(
                  bytes32 rootHash,
                  uint256 chainId,
                  uint256 totalAmount
              )
                  internal
              {
                  // Set TransferRoot on recipient Bridge
                  if (chainId == getChainId()) {
                      // Set L1 TransferRoot
                      _setTransferRoot(rootHash, totalAmount);
                  } else {
                      chainBalance[chainId] = chainBalance[chainId].add(totalAmount);
                      IMessengerWrapper messengerWrapper = crossDomainMessengerWrappers[chainId];
                      require(messengerWrapper != IMessengerWrapper(0), "L1_BRG: chainId not supported");
                      // Set L2 TransferRoot
                      bytes memory setTransferRootMessage = abi.encodeWithSignature(
                          "setTransferRoot(bytes32,uint256)",
                          rootHash,
                          totalAmount
                      );
                      messengerWrapper.sendCrossDomainMessage(setTransferRootMessage);
                  }
              }
              /* ========== External TransferRoot Challenges ========== */
              /**
               * @dev Challenge a TransferRoot believed to be fraudulent
               * @param rootHash The Merkle root of the TransferRoot Merkle tree
               * @param originalAmount The total amount bonded for this TransferRoot
               */
              function challengeTransferBond(bytes32 rootHash, uint256 originalAmount) external payable {
                  bytes32 transferRootId = getTransferRootId(rootHash, originalAmount);
                  TransferBond storage transferBond = transferBonds[transferRootId];
                  require(transferRootCommittedAt[transferRootId] == 0, "L1_BRG: TransferRoot has already been confirmed");
                  require(transferBond.createdAt != 0, "L1_BRG: TransferRoot has not been bonded");
                  uint256 challengePeriodEnd = transferBond.createdAt.add(challengePeriod);
                  require(challengePeriodEnd >= block.timestamp, "L1_BRG: TransferRoot cannot be challenged after challenge period");
                  require(transferBond.challengeStartTime == 0, "L1_BRG: TransferRoot already challenged");
                  transferBond.challengeStartTime = block.timestamp;
                  transferBond.challenger = msg.sender;
                  // Move amount from timeSlotToAmountBonded to debit
                  uint256 timeSlot = getTimeSlot(transferBond.createdAt);
                  uint256 bondAmount = getBondForTransferAmount(originalAmount);
                  address bonder = transferBond.bonder;
                  timeSlotToAmountBonded[timeSlot][bonder] = timeSlotToAmountBonded[timeSlot][bonder].sub(bondAmount);
                  _addDebit(transferBond.bonder, bondAmount);
                  // Get stake for challenge
                  uint256 challengeStakeAmount = getChallengeAmountForTransferAmount(originalAmount);
                  _transferToBridge(msg.sender, challengeStakeAmount);
                  emit TransferBondChallenged(transferRootId, rootHash, originalAmount);
              }
              /**
               * @dev Resolve a challenge after the `challengeResolutionPeriod` has passed
               * @param rootHash The Merkle root of the TransferRoot Merkle tree
               * @param originalAmount The total amount originally bonded for this TransferRoot
               */
              function resolveChallenge(bytes32 rootHash, uint256 originalAmount) external {
                  bytes32 transferRootId = getTransferRootId(rootHash, originalAmount);
                  TransferBond storage transferBond = transferBonds[transferRootId];
                  require(transferBond.challengeStartTime != 0, "L1_BRG: TransferRoot has not been challenged");
                  require(block.timestamp > transferBond.challengeStartTime.add(challengeResolutionPeriod), "L1_BRG: Challenge period has not ended");
                  require(transferBond.challengeResolved == false, "L1_BRG: TransferRoot already resolved");
                  transferBond.challengeResolved = true;
                  uint256 challengeStakeAmount = getChallengeAmountForTransferAmount(originalAmount);
                  if (transferRootCommittedAt[transferRootId] > 0) {
                      // Invalid challenge
                      if (transferBond.createdAt > transferRootCommittedAt[transferRootId].add(minTransferRootBondDelay)) {
                          // Credit the bonder back with the bond amount plus the challenger's stake
                          _addCredit(transferBond.bonder, getBondForTransferAmount(originalAmount).add(challengeStakeAmount));
                      } else {
                          // If the TransferRoot was bonded before it was committed, the challenger and Bonder
                          // get their stake back. This discourages Bonders from tricking challengers into
                          // challenging a valid TransferRoots that haven't yet been committed. It also ensures
                          // that Bonders are not punished if a TransferRoot is bonded too soon in error.
                          // Return the challenger's stake
                          _addCredit(transferBond.challenger, challengeStakeAmount);
                          // Credit the bonder back with the bond amount
                          _addCredit(transferBond.bonder, getBondForTransferAmount(originalAmount));
                      }
                  } else {
                      // Valid challenge
                      // Burn 25% of the challengers stake
                      _transferFromBridge(address(0xdead), challengeStakeAmount.mul(1).div(4));
                      // Reward challenger with the remaining 75% of their stake plus 100% of the Bonder's stake
                      _addCredit(transferBond.challenger, challengeStakeAmount.mul(7).div(4));
                  }
                  emit ChallengeResolved(transferRootId, rootHash, originalAmount);
              }
              /* ========== Override Functions ========== */
              function _additionalDebit(address bonder) internal view override returns (uint256) {
                  uint256 currentTimeSlot = getTimeSlot(block.timestamp);
                  uint256 bonded = 0;
                  uint256 numTimeSlots = challengePeriod / TIME_SLOT_SIZE;
                  for (uint256 i = 0; i < numTimeSlots; i++) {
                      bonded = bonded.add(timeSlotToAmountBonded[currentTimeSlot - i][bonder]);
                  }
                  return bonded;
              }
              function _requireIsGovernance() internal override {
                  require(governance == msg.sender, "L1_BRG: Caller is not the owner");
              }
              /* ========== External Config Management Setters ========== */
              function setGovernance(address _newGovernance) external onlyGovernance {
                  require(_newGovernance != address(0), "L1_BRG: _newGovernance cannot be address(0)");
                  governance = _newGovernance;
              }
              function setCrossDomainMessengerWrapper(uint256 chainId, IMessengerWrapper _crossDomainMessengerWrapper) external onlyGovernance {
                  crossDomainMessengerWrappers[chainId] = _crossDomainMessengerWrapper;
              }
              function setChainIdDepositsPaused(uint256 chainId, bool isPaused) external onlyGovernance {
                  isChainIdPaused[chainId] = isPaused;
              }
              function setChallengePeriod(uint256 _challengePeriod) external onlyGovernance {
                  require(_challengePeriod % TIME_SLOT_SIZE == 0, "L1_BRG: challengePeriod must be divisible by TIME_SLOT_SIZE");
                  challengePeriod = _challengePeriod;
              }
              function setChallengeResolutionPeriod(uint256 _challengeResolutionPeriod) external onlyGovernance {
                  challengeResolutionPeriod = _challengeResolutionPeriod;
              }
              function setMinTransferRootBondDelay(uint256 _minTransferRootBondDelay) external onlyGovernance {
                  minTransferRootBondDelay = _minTransferRootBondDelay;
              }
              /* ========== Public Getters ========== */
              function getBondForTransferAmount(uint256 amount) public pure returns (uint256) {
                  // Bond covers amount plus a bounty to pay a potential challenger
                  return amount.add(getChallengeAmountForTransferAmount(amount));
              }
              function getChallengeAmountForTransferAmount(uint256 amount) public pure returns (uint256) {
                  // Bond covers amount plus a bounty to pay a potential challenger
                  return amount.div(CHALLENGE_AMOUNT_DIVISOR);
              }
              function getTimeSlot(uint256 time) public pure returns (uint256) {
                  return time / TIME_SLOT_SIZE;
              }
          }
          // SPDX-License-Identifier: MIT
          pragma solidity >=0.6.0 <0.8.0;
          /**
           * @dev Wrappers over Solidity's arithmetic operations with added overflow
           * checks.
           *
           * Arithmetic operations in Solidity wrap on overflow. This can easily result
           * in bugs, because programmers usually assume that an overflow raises an
           * error, which is the standard behavior in high level programming languages.
           * `SafeMath` restores this intuition by reverting the transaction when an
           * operation overflows.
           *
           * Using this library instead of the unchecked operations eliminates an entire
           * class of bugs, so it's recommended to use it always.
           */
          library SafeMath {
              /**
               * @dev Returns the addition of two unsigned integers, with an overflow flag.
               *
               * _Available since v3.4._
               */
              function tryAdd(uint256 a, uint256 b) internal pure returns (bool, uint256) {
                  uint256 c = a + b;
                  if (c < a) return (false, 0);
                  return (true, c);
              }
              /**
               * @dev Returns the substraction of two unsigned integers, with an overflow flag.
               *
               * _Available since v3.4._
               */
              function trySub(uint256 a, uint256 b) internal pure returns (bool, uint256) {
                  if (b > a) return (false, 0);
                  return (true, a - b);
              }
              /**
               * @dev Returns the multiplication of two unsigned integers, with an overflow flag.
               *
               * _Available since v3.4._
               */
              function tryMul(uint256 a, uint256 b) internal pure returns (bool, uint256) {
                  // Gas optimization: this is cheaper than requiring 'a' not being zero, but the
                  // benefit is lost if 'b' is also tested.
                  // See: https://github.com/OpenZeppelin/openzeppelin-contracts/pull/522
                  if (a == 0) return (true, 0);
                  uint256 c = a * b;
                  if (c / a != b) return (false, 0);
                  return (true, c);
              }
              /**
               * @dev Returns the division of two unsigned integers, with a division by zero flag.
               *
               * _Available since v3.4._
               */
              function tryDiv(uint256 a, uint256 b) internal pure returns (bool, uint256) {
                  if (b == 0) return (false, 0);
                  return (true, a / b);
              }
              /**
               * @dev Returns the remainder of dividing two unsigned integers, with a division by zero flag.
               *
               * _Available since v3.4._
               */
              function tryMod(uint256 a, uint256 b) internal pure returns (bool, uint256) {
                  if (b == 0) return (false, 0);
                  return (true, a % b);
              }
              /**
               * @dev Returns the addition of two unsigned integers, reverting on
               * overflow.
               *
               * Counterpart to Solidity's `+` operator.
               *
               * Requirements:
               *
               * - Addition cannot overflow.
               */
              function add(uint256 a, uint256 b) internal pure returns (uint256) {
                  uint256 c = a + b;
                  require(c >= a, "SafeMath: addition overflow");
                  return c;
              }
              /**
               * @dev Returns the subtraction of two unsigned integers, reverting on
               * overflow (when the result is negative).
               *
               * Counterpart to Solidity's `-` operator.
               *
               * Requirements:
               *
               * - Subtraction cannot overflow.
               */
              function sub(uint256 a, uint256 b) internal pure returns (uint256) {
                  require(b <= a, "SafeMath: subtraction overflow");
                  return a - b;
              }
              /**
               * @dev Returns the multiplication of two unsigned integers, reverting on
               * overflow.
               *
               * Counterpart to Solidity's `*` operator.
               *
               * Requirements:
               *
               * - Multiplication cannot overflow.
               */
              function mul(uint256 a, uint256 b) internal pure returns (uint256) {
                  if (a == 0) return 0;
                  uint256 c = a * b;
                  require(c / a == b, "SafeMath: multiplication overflow");
                  return c;
              }
              /**
               * @dev Returns the integer division of two unsigned integers, reverting on
               * division by zero. The result is rounded towards zero.
               *
               * Counterpart to Solidity's `/` operator. Note: this function uses a
               * `revert` opcode (which leaves remaining gas untouched) while Solidity
               * uses an invalid opcode to revert (consuming all remaining gas).
               *
               * Requirements:
               *
               * - The divisor cannot be zero.
               */
              function div(uint256 a, uint256 b) internal pure returns (uint256) {
                  require(b > 0, "SafeMath: division by zero");
                  return a / b;
              }
              /**
               * @dev Returns the remainder of dividing two unsigned integers. (unsigned integer modulo),
               * reverting when dividing by zero.
               *
               * Counterpart to Solidity's `%` operator. This function uses a `revert`
               * opcode (which leaves remaining gas untouched) while Solidity uses an
               * invalid opcode to revert (consuming all remaining gas).
               *
               * Requirements:
               *
               * - The divisor cannot be zero.
               */
              function mod(uint256 a, uint256 b) internal pure returns (uint256) {
                  require(b > 0, "SafeMath: modulo by zero");
                  return a % b;
              }
              /**
               * @dev Returns the subtraction of two unsigned integers, reverting with custom message on
               * overflow (when the result is negative).
               *
               * CAUTION: This function is deprecated because it requires allocating memory for the error
               * message unnecessarily. For custom revert reasons use {trySub}.
               *
               * Counterpart to Solidity's `-` operator.
               *
               * Requirements:
               *
               * - Subtraction cannot overflow.
               */
              function sub(uint256 a, uint256 b, string memory errorMessage) internal pure returns (uint256) {
                  require(b <= a, errorMessage);
                  return a - b;
              }
              /**
               * @dev Returns the integer division of two unsigned integers, reverting with custom message on
               * division by zero. The result is rounded towards zero.
               *
               * CAUTION: This function is deprecated because it requires allocating memory for the error
               * message unnecessarily. For custom revert reasons use {tryDiv}.
               *
               * Counterpart to Solidity's `/` operator. Note: this function uses a
               * `revert` opcode (which leaves remaining gas untouched) while Solidity
               * uses an invalid opcode to revert (consuming all remaining gas).
               *
               * Requirements:
               *
               * - The divisor cannot be zero.
               */
              function div(uint256 a, uint256 b, string memory errorMessage) internal pure returns (uint256) {
                  require(b > 0, errorMessage);
                  return a / b;
              }
              /**
               * @dev Returns the remainder of dividing two unsigned integers. (unsigned integer modulo),
               * reverting with custom message when dividing by zero.
               *
               * CAUTION: This function is deprecated because it requires allocating memory for the error
               * message unnecessarily. For custom revert reasons use {tryMod}.
               *
               * Counterpart to Solidity's `%` operator. This function uses a `revert`
               * opcode (which leaves remaining gas untouched) while Solidity uses an
               * invalid opcode to revert (consuming all remaining gas).
               *
               * Requirements:
               *
               * - The divisor cannot be zero.
               */
              function mod(uint256 a, uint256 b, string memory errorMessage) internal pure returns (uint256) {
                  require(b > 0, errorMessage);
                  return a % b;
              }
          }
          // SPDX-License-Identifier: MIT
          pragma solidity >=0.6.2 <0.8.0;
          /**
           * @dev Collection of functions related to the address type
           */
          library Address {
              /**
               * @dev Returns true if `account` is a contract.
               *
               * [IMPORTANT]
               * ====
               * It is unsafe to assume that an address for which this function returns
               * false is an externally-owned account (EOA) and not a contract.
               *
               * Among others, `isContract` will return false for the following
               * types of addresses:
               *
               *  - an externally-owned account
               *  - a contract in construction
               *  - an address where a contract will be created
               *  - an address where a contract lived, but was destroyed
               * ====
               */
              function isContract(address account) internal view returns (bool) {
                  // This method relies on extcodesize, which returns 0 for contracts in
                  // construction, since the code is only stored at the end of the
                  // constructor execution.
                  uint256 size;
                  // solhint-disable-next-line no-inline-assembly
                  assembly { size := extcodesize(account) }
                  return size > 0;
              }
              /**
               * @dev Replacement for Solidity's `transfer`: sends `amount` wei to
               * `recipient`, forwarding all available gas and reverting on errors.
               *
               * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost
               * of certain opcodes, possibly making contracts go over the 2300 gas limit
               * imposed by `transfer`, making them unable to receive funds via
               * `transfer`. {sendValue} removes this limitation.
               *
               * https://diligence.consensys.net/posts/2019/09/stop-using-soliditys-transfer-now/[Learn more].
               *
               * IMPORTANT: because control is transferred to `recipient`, care must be
               * taken to not create reentrancy vulnerabilities. Consider using
               * {ReentrancyGuard} or the
               * https://solidity.readthedocs.io/en/v0.5.11/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].
               */
              function sendValue(address payable recipient, uint256 amount) internal {
                  require(address(this).balance >= amount, "Address: insufficient balance");
                  // solhint-disable-next-line avoid-low-level-calls, avoid-call-value
                  (bool success, ) = recipient.call{ value: amount }("");
                  require(success, "Address: unable to send value, recipient may have reverted");
              }
              /**
               * @dev Performs a Solidity function call using a low level `call`. A
               * plain`call` is an unsafe replacement for a function call: use this
               * function instead.
               *
               * If `target` reverts with a revert reason, it is bubbled up by this
               * function (like regular Solidity function calls).
               *
               * Returns the raw returned data. To convert to the expected return value,
               * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].
               *
               * Requirements:
               *
               * - `target` must be a contract.
               * - calling `target` with `data` must not revert.
               *
               * _Available since v3.1._
               */
              function functionCall(address target, bytes memory data) internal returns (bytes memory) {
                return functionCall(target, data, "Address: low-level call failed");
              }
              /**
               * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with
               * `errorMessage` as a fallback revert reason when `target` reverts.
               *
               * _Available since v3.1._
               */
              function functionCall(address target, bytes memory data, string memory errorMessage) internal returns (bytes memory) {
                  return functionCallWithValue(target, data, 0, errorMessage);
              }
              /**
               * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
               * but also transferring `value` wei to `target`.
               *
               * Requirements:
               *
               * - the calling contract must have an ETH balance of at least `value`.
               * - the called Solidity function must be `payable`.
               *
               * _Available since v3.1._
               */
              function functionCallWithValue(address target, bytes memory data, uint256 value) internal returns (bytes memory) {
                  return functionCallWithValue(target, data, value, "Address: low-level call with value failed");
              }
              /**
               * @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but
               * with `errorMessage` as a fallback revert reason when `target` reverts.
               *
               * _Available since v3.1._
               */
              function functionCallWithValue(address target, bytes memory data, uint256 value, string memory errorMessage) internal returns (bytes memory) {
                  require(address(this).balance >= value, "Address: insufficient balance for call");
                  require(isContract(target), "Address: call to non-contract");
                  // solhint-disable-next-line avoid-low-level-calls
                  (bool success, bytes memory returndata) = target.call{ value: value }(data);
                  return _verifyCallResult(success, returndata, errorMessage);
              }
              /**
               * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
               * but performing a static call.
               *
               * _Available since v3.3._
               */
              function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {
                  return functionStaticCall(target, data, "Address: low-level static call failed");
              }
              /**
               * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],
               * but performing a static call.
               *
               * _Available since v3.3._
               */
              function functionStaticCall(address target, bytes memory data, string memory errorMessage) internal view returns (bytes memory) {
                  require(isContract(target), "Address: static call to non-contract");
                  // solhint-disable-next-line avoid-low-level-calls
                  (bool success, bytes memory returndata) = target.staticcall(data);
                  return _verifyCallResult(success, returndata, errorMessage);
              }
              /**
               * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
               * but performing a delegate call.
               *
               * _Available since v3.4._
               */
              function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) {
                  return functionDelegateCall(target, data, "Address: low-level delegate call failed");
              }
              /**
               * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],
               * but performing a delegate call.
               *
               * _Available since v3.4._
               */
              function functionDelegateCall(address target, bytes memory data, string memory errorMessage) internal returns (bytes memory) {
                  require(isContract(target), "Address: delegate call to non-contract");
                  // solhint-disable-next-line avoid-low-level-calls
                  (bool success, bytes memory returndata) = target.delegatecall(data);
                  return _verifyCallResult(success, returndata, errorMessage);
              }
              function _verifyCallResult(bool success, bytes memory returndata, string memory errorMessage) private pure returns(bytes memory) {
                  if (success) {
                      return returndata;
                  } else {
                      // Look for revert reason and bubble it up if present
                      if (returndata.length > 0) {
                          // The easiest way to bubble the revert reason is using memory via assembly
                          // solhint-disable-next-line no-inline-assembly
                          assembly {
                              let returndata_size := mload(returndata)
                              revert(add(32, returndata), returndata_size)
                          }
                      } else {
                          revert(errorMessage);
                      }
                  }
              }
          }
          // SPDX-License-Identifier: MIT
          pragma solidity 0.6.12;
          pragma experimental ABIEncoderV2;
          import "./Accounting.sol";
          import "../libraries/Lib_MerkleTree.sol";
          /**
           * @dev Bridge extends the accounting system and encapsulates the logic that is shared by both the
           * L1 and L2 Bridges. It allows to TransferRoots to be set by parent contracts and for those
           * TransferRoots to be withdrawn against. It also allows the bonder to bond and withdraw Transfers
           * directly through `bondWithdrawal` and then settle those bonds against their TransferRoot once it
           * has been set.
           */
          abstract contract Bridge is Accounting {
              using Lib_MerkleTree for bytes32;
              struct TransferRoot {
                  uint256 total;
                  uint256 amountWithdrawn;
                  uint256 createdAt;
              }
              /* ========== Events ========== */
              event Withdrew(
                  bytes32 indexed transferId,
                  address indexed recipient,
                  uint256 amount,
                  bytes32 transferNonce
              );
              event WithdrawalBonded(
                  bytes32 indexed transferId,
                  uint256 amount
              );
              event WithdrawalBondSettled(
                  address indexed bonder,
                  bytes32 indexed transferId,
                  bytes32 indexed rootHash
              );
              event MultipleWithdrawalsSettled(
                  address indexed bonder,
                  bytes32 indexed rootHash,
                  uint256 totalBondsSettled
              );
              event TransferRootSet(
                  bytes32 indexed rootHash,
                  uint256 totalAmount
              );
              /* ========== State ========== */
              mapping(bytes32 => TransferRoot) private _transferRoots;
              mapping(bytes32 => bool) private _spentTransferIds;
              mapping(address => mapping(bytes32 => uint256)) private _bondedWithdrawalAmounts;
              uint256 constant RESCUE_DELAY = 8 weeks;
              constructor(address[] memory bonders) public Accounting(bonders) {}
              /* ========== Public Getters ========== */
              /**
               * @dev Get the hash that represents an individual Transfer.
               * @param chainId The id of the destination chain
               * @param recipient The address receiving the Transfer
               * @param amount The amount being transferred including the `_bonderFee`
               * @param transferNonce Used to avoid transferId collisions
               * @param bonderFee The amount paid to the address that withdraws the Transfer
               * @param amountOutMin The minimum amount received after attempting to swap in the destination
               * AMM market. 0 if no swap is intended.
               * @param deadline The deadline for swapping in the destination AMM market. 0 if no
               * swap is intended.
               */
              function getTransferId(
                  uint256 chainId,
                  address recipient,
                  uint256 amount,
                  bytes32 transferNonce,
                  uint256 bonderFee,
                  uint256 amountOutMin,
                  uint256 deadline
              )
                  public
                  pure
                  returns (bytes32)
              {
                  return keccak256(abi.encode(
                      chainId,
                      recipient,
                      amount,
                      transferNonce,
                      bonderFee,
                      amountOutMin,
                      deadline
                  ));
              }
              /**
               * @notice getChainId can be overridden by subclasses if needed for compatibility or testing purposes.
               * @dev Get the current chainId
               * @return chainId The current chainId
               */
              function getChainId() public virtual view returns (uint256 chainId) {
                  this; // Silence state mutability warning without generating any additional byte code
                  assembly {
                      chainId := chainid()
                  }
              }
              /**
               * @dev Get the TransferRoot id for a given rootHash and totalAmount
               * @param rootHash The Merkle root of the TransferRoot
               * @param totalAmount The total of all Transfers in the TransferRoot
               * @return The calculated transferRootId
               */
              function getTransferRootId(bytes32 rootHash, uint256 totalAmount) public pure returns (bytes32) {
                  return keccak256(abi.encodePacked(rootHash, totalAmount));
              }
              /**
               * @dev Get the TransferRoot for a given rootHash and totalAmount
               * @param rootHash The Merkle root of the TransferRoot
               * @param totalAmount The total of all Transfers in the TransferRoot
               * @return The TransferRoot with the calculated transferRootId
               */
              function getTransferRoot(bytes32 rootHash, uint256 totalAmount) public view returns (TransferRoot memory) {
                  return _transferRoots[getTransferRootId(rootHash, totalAmount)];
              }
              /**
               * @dev Get the amount bonded for the withdrawal of a transfer
               * @param bonder The Bonder of the withdrawal
               * @param transferId The Transfer's unique identifier
               * @return The amount bonded for a Transfer withdrawal
               */
              function getBondedWithdrawalAmount(address bonder, bytes32 transferId) external view returns (uint256) {
                  return _bondedWithdrawalAmounts[bonder][transferId];
              }
              /**
               * @dev Get the spent status of a transfer ID
               * @param transferId The transfer's unique identifier
               * @return True if the transferId has been spent
               */
              function isTransferIdSpent(bytes32 transferId) external view returns (bool) {
                  return _spentTransferIds[transferId];
              }
              /* ========== User/Relayer External Functions ========== */
              /**
               * @notice Can be called by anyone (recipient or relayer)
               * @dev Withdraw a Transfer from its destination bridge
               * @param recipient The address receiving the Transfer
               * @param amount The amount being transferred including the `_bonderFee`
               * @param transferNonce Used to avoid transferId collisions
               * @param bonderFee The amount paid to the address that withdraws the Transfer
               * @param amountOutMin The minimum amount received after attempting to swap in the destination
               * AMM market. 0 if no swap is intended. (only used to calculate `transferId` in this function)
               * @param deadline The deadline for swapping in the destination AMM market. 0 if no
               * swap is intended. (only used to calculate `transferId` in this function)
               * @param rootHash The Merkle root of the TransferRoot
               * @param transferRootTotalAmount The total amount being transferred in a TransferRoot
               * @param transferIdTreeIndex The index of the transferId in the Merkle tree
               * @param siblings The siblings of the transferId in the Merkle tree
               * @param totalLeaves The total number of leaves in the Merkle tree
               */
              function withdraw(
                  address recipient,
                  uint256 amount,
                  bytes32 transferNonce,
                  uint256 bonderFee,
                  uint256 amountOutMin,
                  uint256 deadline,
                  bytes32 rootHash,
                  uint256 transferRootTotalAmount,
                  uint256 transferIdTreeIndex,
                  bytes32[] calldata siblings,
                  uint256 totalLeaves
              )
                  external
                  nonReentrant
              {
                  bytes32 transferId = getTransferId(
                      getChainId(),
                      recipient,
                      amount,
                      transferNonce,
                      bonderFee,
                      amountOutMin,
                      deadline
                  );
                  require(
                      rootHash.verify(
                          transferId,
                          transferIdTreeIndex,
                          siblings,
                          totalLeaves
                      )
                  , "BRG: Invalid transfer proof");
                  bytes32 transferRootId = getTransferRootId(rootHash, transferRootTotalAmount);
                  _addToAmountWithdrawn(transferRootId, amount);
                  _fulfillWithdraw(transferId, recipient, amount, uint256(0));
                  emit Withdrew(transferId, recipient, amount, transferNonce);
              }
              /**
               * @dev Allows the bonder to bond individual withdrawals before their TransferRoot has been committed.
               * @param recipient The address receiving the Transfer
               * @param amount The amount being transferred including the `_bonderFee`
               * @param transferNonce Used to avoid transferId collisions
               * @param bonderFee The amount paid to the address that withdraws the Transfer
               */
              function bondWithdrawal(
                  address recipient,
                  uint256 amount,
                  bytes32 transferNonce,
                  uint256 bonderFee
              )
                  external
                  onlyBonder
                  requirePositiveBalance
                  nonReentrant
              {
                  bytes32 transferId = getTransferId(
                      getChainId(),
                      recipient,
                      amount,
                      transferNonce,
                      bonderFee,
                      0,
                      0
                  );
                  _bondWithdrawal(transferId, amount);
                  _fulfillWithdraw(transferId, recipient, amount, bonderFee);
              }
              /**
               * @dev Refunds the Bonder's stake from a bonded withdrawal and counts that withdrawal against
               * its TransferRoot.
               * @param bonder The Bonder of the withdrawal
               * @param transferId The Transfer's unique identifier
               * @param rootHash The Merkle root of the TransferRoot
               * @param transferRootTotalAmount The total amount being transferred in a TransferRoot
               * @param transferIdTreeIndex The index of the transferId in the Merkle tree
               * @param siblings The siblings of the transferId in the Merkle tree
               * @param totalLeaves The total number of leaves in the Merkle tree
               */
              function settleBondedWithdrawal(
                  address bonder,
                  bytes32 transferId,
                  bytes32 rootHash,
                  uint256 transferRootTotalAmount,
                  uint256 transferIdTreeIndex,
                  bytes32[] calldata siblings,
                  uint256 totalLeaves
              )
                  external
              {
                  require(
                      rootHash.verify(
                          transferId,
                          transferIdTreeIndex,
                          siblings,
                          totalLeaves
                      )
                  , "BRG: Invalid transfer proof");
                  bytes32 transferRootId = getTransferRootId(rootHash, transferRootTotalAmount);
                  uint256 amount = _bondedWithdrawalAmounts[bonder][transferId];
                  require(amount > 0, "L2_BRG: transferId has no bond");
                  _bondedWithdrawalAmounts[bonder][transferId] = 0;
                  _addToAmountWithdrawn(transferRootId, amount);
                  _addCredit(bonder, amount);
                  emit WithdrawalBondSettled(bonder, transferId, rootHash);
              }
              /**
               * @dev Refunds the Bonder for all withdrawals that they bonded in a TransferRoot.
               * @param bonder The address of the Bonder being refunded
               * @param transferIds All transferIds in the TransferRoot in order
               * @param totalAmount The totalAmount of the TransferRoot
               */
              function settleBondedWithdrawals(
                  address bonder,
                  // transferIds _must_ be calldata or it will be mutated by Lib_MerkleTree.getMerkleRoot
                  bytes32[] calldata transferIds,
                  uint256 totalAmount
              )
                  external
              {
                  bytes32 rootHash = Lib_MerkleTree.getMerkleRoot(transferIds);
                  bytes32 transferRootId = getTransferRootId(rootHash, totalAmount);
                  uint256 totalBondsSettled = 0;
                  for(uint256 i = 0; i < transferIds.length; i++) {
                      uint256 transferBondAmount = _bondedWithdrawalAmounts[bonder][transferIds[i]];
                      if (transferBondAmount > 0) {
                          totalBondsSettled = totalBondsSettled.add(transferBondAmount);
                          _bondedWithdrawalAmounts[bonder][transferIds[i]] = 0;
                      }
                  }
                  _addToAmountWithdrawn(transferRootId, totalBondsSettled);
                  _addCredit(bonder, totalBondsSettled);
                  emit MultipleWithdrawalsSettled(bonder, rootHash, totalBondsSettled);
              }
              /* ========== External TransferRoot Rescue ========== */
              /**
               * @dev Allows governance to withdraw the remaining amount from a TransferRoot after the rescue delay has passed.
               * @param rootHash the Merkle root of the TransferRoot
               * @param originalAmount The TransferRoot's recorded total
               * @param recipient The address receiving the remaining balance
               */
              function rescueTransferRoot(bytes32 rootHash, uint256 originalAmount, address recipient) external onlyGovernance {
                  bytes32 transferRootId = getTransferRootId(rootHash, originalAmount);
                  TransferRoot memory transferRoot = getTransferRoot(rootHash, originalAmount);
                  require(transferRoot.createdAt != 0, "BRG: TransferRoot not found");
                  assert(transferRoot.total == originalAmount);
                  uint256 rescueDelayEnd = transferRoot.createdAt.add(RESCUE_DELAY);
                  require(block.timestamp >= rescueDelayEnd, "BRG: TransferRoot cannot be rescued before the Rescue Delay");
                  uint256 remainingAmount = transferRoot.total.sub(transferRoot.amountWithdrawn);
                  _addToAmountWithdrawn(transferRootId, remainingAmount);
                  _transferFromBridge(recipient, remainingAmount);
              }
              /* ========== Internal Functions ========== */
              function _markTransferSpent(bytes32 transferId) internal {
                  require(!_spentTransferIds[transferId], "BRG: The transfer has already been withdrawn");
                  _spentTransferIds[transferId] = true;
              }
              function _addToAmountWithdrawn(bytes32 transferRootId, uint256 amount) internal {
                  TransferRoot storage transferRoot = _transferRoots[transferRootId];
                  require(transferRoot.total > 0, "BRG: Transfer root not found");
                  uint256 newAmountWithdrawn = transferRoot.amountWithdrawn.add(amount);
                  require(newAmountWithdrawn <= transferRoot.total, "BRG: Withdrawal exceeds TransferRoot total");
                  transferRoot.amountWithdrawn = newAmountWithdrawn;
              }
              function _setTransferRoot(bytes32 rootHash, uint256 totalAmount) internal {
                  bytes32 transferRootId = getTransferRootId(rootHash, totalAmount);
                  require(_transferRoots[transferRootId].total == 0, "BRG: Transfer root already set");
                  require(totalAmount > 0, "BRG: Cannot set TransferRoot totalAmount of 0");
                  _transferRoots[transferRootId] = TransferRoot(totalAmount, 0, block.timestamp);
                  emit TransferRootSet(rootHash, totalAmount);
              }
              function _bondWithdrawal(bytes32 transferId, uint256 amount) internal {
                  require(_bondedWithdrawalAmounts[msg.sender][transferId] == 0, "BRG: Withdrawal has already been bonded");
                  _addDebit(msg.sender, amount);
                  _bondedWithdrawalAmounts[msg.sender][transferId] = amount;
                  emit WithdrawalBonded(transferId, amount);
              }
              /* ========== Private Functions ========== */
              /// @dev Completes the Transfer, distributes the Bonder fee and marks the Transfer as spent.
              function _fulfillWithdraw(
                  bytes32 transferId,
                  address recipient,
                  uint256 amount,
                  uint256 bonderFee
              ) private {
                  _markTransferSpent(transferId);
                  _transferFromBridge(recipient, amount.sub(bonderFee));
                  if (bonderFee > 0) {
                      _transferFromBridge(msg.sender, bonderFee);
                  }
              }
          }
          // SPDX-License-Identifier: MIT
          pragma solidity >=0.6.12 <0.8.0;
          pragma experimental ABIEncoderV2;
          interface IMessengerWrapper {
              function sendCrossDomainMessage(bytes memory _calldata) external;
              function verifySender(address l1BridgeCaller, bytes memory _data) external;
          }
          // SPDX-License-Identifier: MIT
          pragma solidity 0.6.12;
          pragma experimental ABIEncoderV2;
          import "@openzeppelin/contracts/math/SafeMath.sol";
          import "@openzeppelin/contracts/utils/ReentrancyGuard.sol";
          /**
           * @dev Accounting is an abstract contract that encapsulates the most critical logic in the Hop contracts.
           * The accounting system works by using two balances that can only increase `_credit` and `_debit`.
           * A bonder's available balance is the total credit minus the total debit. The contract exposes
           * two external functions that allows a bonder to stake and unstake and exposes two internal
           * functions to its child contracts that allow the child contract to add to the credit 
           * and debit balance. In addition, child contracts can override `_additionalDebit` to account
           * for any additional debit balance in an alternative way. Lastly, it exposes a modifier,
           * `requirePositiveBalance`, that can be used by child contracts to ensure the bonder does not
           * use more than its available stake.
           */
          abstract contract Accounting is ReentrancyGuard {
              using SafeMath for uint256;
              mapping(address => bool) private _isBonder;
              mapping(address => uint256) private _credit;
              mapping(address => uint256) private _debit;
              event Stake (
                  address indexed account,
                  uint256 amount
              );
              event Unstake (
                  address indexed account,
                  uint256 amount
              );
              event BonderAdded (
                  address indexed newBonder
              );
              event BonderRemoved (
                  address indexed previousBonder
              );
              /* ========== Modifiers ========== */
              modifier onlyBonder {
                  require(_isBonder[msg.sender], "ACT: Caller is not bonder");
                  _;
              }
              modifier onlyGovernance {
                  _requireIsGovernance();
                  _;
              }
              /// @dev Used by parent contract to ensure that the Bonder is solvent at the end of the transaction.
              modifier requirePositiveBalance {
                  _;
                  require(getCredit(msg.sender) >= getDebitAndAdditionalDebit(msg.sender), "ACT: Not enough available credit");
              }
              /// @dev Sets the Bonder addresses
              constructor(address[] memory bonders) public {
                  for (uint256 i = 0; i < bonders.length; i++) {
                      require(_isBonder[bonders[i]] == false, "ACT: Cannot add duplicate bonder");
                      _isBonder[bonders[i]] = true;
                      emit BonderAdded(bonders[i]);
                  }
              }
              /* ========== Virtual functions ========== */
              /**
               * @dev The following functions are overridden in L1_Bridge and L2_Bridge
               */
              function _transferFromBridge(address recipient, uint256 amount) internal virtual;
              function _transferToBridge(address from, uint256 amount) internal virtual;
              function _requireIsGovernance() internal virtual;
              /**
               * @dev This function can be optionally overridden by a parent contract to track any additional
               * debit balance in an alternative way.
               */
              function _additionalDebit(address /*bonder*/) internal view virtual returns (uint256) {
                  this; // Silence state mutability warning without generating any additional byte code
                  return 0;
              }
              /* ========== Public/external getters ========== */
              /**
               * @dev Check if address is a Bonder
               * @param maybeBonder The address being checked
               * @return true if address is a Bonder
               */
              function getIsBonder(address maybeBonder) public view returns (bool) {
                  return _isBonder[maybeBonder];
              }
              /**
               * @dev Get the Bonder's credit balance
               * @param bonder The owner of the credit balance being checked
               * @return The credit balance for the Bonder
               */
              function getCredit(address bonder) public view returns (uint256) {
                  return _credit[bonder];
              }
              /**
               * @dev Gets the debit balance tracked by `_debit` and does not include `_additionalDebit()`
               * @param bonder The owner of the debit balance being checked
               * @return The debit amount for the Bonder
               */
              function getRawDebit(address bonder) external view returns (uint256) {
                  return _debit[bonder];
              }
              /**
               * @dev Get the Bonder's total debit
               * @param bonder The owner of the debit balance being checked
               * @return The Bonder's total debit balance
               */
              function getDebitAndAdditionalDebit(address bonder) public view returns (uint256) {
                  return _debit[bonder].add(_additionalDebit(bonder));
              }
              /* ========== Bonder external functions ========== */
              /** 
               * @dev Allows the Bonder to deposit tokens and increase its credit balance
               * @param bonder The address being staked on
               * @param amount The amount being staked
               */
              function stake(address bonder, uint256 amount) external payable nonReentrant {
                  require(_isBonder[bonder] == true, "ACT: Address is not bonder");
                  _transferToBridge(msg.sender, amount);
                  _addCredit(bonder, amount);
                  emit Stake(bonder, amount);
              }
              /**
               * @dev Allows the caller to withdraw any available balance and add to their debit balance
               * @param amount The amount being unstaked
               */
              function unstake(uint256 amount) external requirePositiveBalance nonReentrant {
                  _addDebit(msg.sender, amount);
                  _transferFromBridge(msg.sender, amount);
                  emit Unstake(msg.sender, amount);
              }
              /**
               * @dev Add Bonder to allowlist
               * @param bonder The address being added as a Bonder
               */
              function addBonder(address bonder) external onlyGovernance {
                  require(_isBonder[bonder] == false, "ACT: Address is already bonder");
                  _isBonder[bonder] = true;
                  emit BonderAdded(bonder);
              }
              /**
               * @dev Remove Bonder from allowlist
               * @param bonder The address being removed as a Bonder
               */
              function removeBonder(address bonder) external onlyGovernance {
                  require(_isBonder[bonder] == true, "ACT: Address is not bonder");
                  _isBonder[bonder] = false;
                  emit BonderRemoved(bonder);
              }
              /* ========== Internal functions ========== */
              function _addCredit(address bonder, uint256 amount) internal {
                  _credit[bonder] = _credit[bonder].add(amount);
              }
              function _addDebit(address bonder, uint256 amount) internal {
                  _debit[bonder] = _debit[bonder].add(amount);
              }
          }
          // SPDX-License-Identifier: MIT
          pragma solidity >0.5.0 <0.8.0;
          /**
           * @title Lib_MerkleTree
           * @author River Keefer
           */
          library Lib_MerkleTree {
              /**********************
               * Internal Functions *
               **********************/
              /**
               * Calculates a merkle root for a list of 32-byte leaf hashes.  WARNING: If the number
               * of leaves passed in is not a power of two, it pads out the tree with zero hashes.
               * If you do not know the original length of elements for the tree you are verifying,
               * then this may allow empty leaves past _elements.length to pass a verification check down the line.
               * Note that the _elements argument is modified, therefore it must not be used again afterwards
               * @param _elements Array of hashes from which to generate a merkle root.
               * @return Merkle root of the leaves, with zero hashes for non-powers-of-two (see above).
               */
              function getMerkleRoot(
                  bytes32[] memory _elements
              )
                  internal
                  pure
                  returns (
                      bytes32
                  )
              {
                  require(
                      _elements.length > 0,
                      "Lib_MerkleTree: Must provide at least one leaf hash."
                  );
                  if (_elements.length == 1) {
                      return _elements[0];
                  }
                  uint256[16] memory defaults = [
                      0x290decd9548b62a8d60345a988386fc84ba6bc95484008f6362f93160ef3e563,
                      0x633dc4d7da7256660a892f8f1604a44b5432649cc8ec5cb3ced4c4e6ac94dd1d,
                      0x890740a8eb06ce9be422cb8da5cdafc2b58c0a5e24036c578de2a433c828ff7d,
                      0x3b8ec09e026fdc305365dfc94e189a81b38c7597b3d941c279f042e8206e0bd8,
                      0xecd50eee38e386bd62be9bedb990706951b65fe053bd9d8a521af753d139e2da,
                      0xdefff6d330bb5403f63b14f33b578274160de3a50df4efecf0e0db73bcdd3da5,
                      0x617bdd11f7c0a11f49db22f629387a12da7596f9d1704d7465177c63d88ec7d7,
                      0x292c23a9aa1d8bea7e2435e555a4a60e379a5a35f3f452bae60121073fb6eead,
                      0xe1cea92ed99acdcb045a6726b2f87107e8a61620a232cf4d7d5b5766b3952e10,
                      0x7ad66c0a68c72cb89e4fb4303841966e4062a76ab97451e3b9fb526a5ceb7f82,
                      0xe026cc5a4aed3c22a58cbd3d2ac754c9352c5436f638042dca99034e83636516,
                      0x3d04cffd8b46a874edf5cfae63077de85f849a660426697b06a829c70dd1409c,
                      0xad676aa337a485e4728a0b240d92b3ef7b3c372d06d189322bfd5f61f1e7203e,
                      0xa2fca4a49658f9fab7aa63289c91b7c7b6c832a6d0e69334ff5b0a3483d09dab,
                      0x4ebfd9cd7bca2505f7bef59cc1c12ecc708fff26ae4af19abe852afe9e20c862,
                      0x2def10d13dd169f550f578bda343d9717a138562e0093b380a1120789d53cf10
                  ];
                  // Reserve memory space for our hashes.
                  bytes memory buf = new bytes(64);
                  // We'll need to keep track of left and right siblings.
                  bytes32 leftSibling;
                  bytes32 rightSibling;
                  // Number of non-empty nodes at the current depth.
                  uint256 rowSize = _elements.length;
                  // Current depth, counting from 0 at the leaves
                  uint256 depth = 0;
                  // Common sub-expressions
                  uint256 halfRowSize;         // rowSize / 2
                  bool rowSizeIsOdd;           // rowSize % 2 == 1
                  while (rowSize > 1) {
                      halfRowSize = rowSize / 2;
                      rowSizeIsOdd = rowSize % 2 == 1;
                      for (uint256 i = 0; i < halfRowSize; i++) {
                          leftSibling  = _elements[(2 * i)    ];
                          rightSibling = _elements[(2 * i) + 1];
                          assembly {
                              mstore(add(buf, 32), leftSibling )
                              mstore(add(buf, 64), rightSibling)
                          }
                          _elements[i] = keccak256(buf);
                      }
                      if (rowSizeIsOdd) {
                          leftSibling  = _elements[rowSize - 1];
                          rightSibling = bytes32(defaults[depth]);
                          assembly {
                              mstore(add(buf, 32), leftSibling)
                              mstore(add(buf, 64), rightSibling)
                          }
                          _elements[halfRowSize] = keccak256(buf);
                      }
                      rowSize = halfRowSize + (rowSizeIsOdd ? 1 : 0);
                      depth++;
                  }
                  return _elements[0];
              }
              /**
               * Verifies a merkle branch for the given leaf hash.  Assumes the original length
               * of leaves generated is a known, correct input, and does not return true for indices
               * extending past that index (even if _siblings would be otherwise valid.)
               * @param _root The Merkle root to verify against.
               * @param _leaf The leaf hash to verify inclusion of.
               * @param _index The index in the tree of this leaf.
               * @param _siblings Array of sibline nodes in the inclusion proof, starting from depth 0 (bottom of the tree).
               * @param _totalLeaves The total number of leaves originally passed into.
               * @return Whether or not the merkle branch and leaf passes verification.
               */
              function verify(
                  bytes32 _root,
                  bytes32 _leaf,
                  uint256 _index,
                  bytes32[] memory _siblings,
                  uint256 _totalLeaves
              )
                  internal
                  pure
                  returns (
                      bool
                  )
              {
                  require(
                      _totalLeaves > 0,
                      "Lib_MerkleTree: Total leaves must be greater than zero."
                  );
                  require(
                      _index < _totalLeaves,
                      "Lib_MerkleTree: Index out of bounds."
                  );
                  require(
                      _siblings.length == _ceilLog2(_totalLeaves),
                      "Lib_MerkleTree: Total siblings does not correctly correspond to total leaves."
                  );
                  bytes32 computedRoot = _leaf;
                  for (uint256 i = 0; i < _siblings.length; i++) {
                      if ((_index & 1) == 1) {
                          computedRoot = keccak256(
                              abi.encodePacked(
                                  _siblings[i],
                                  computedRoot
                              )
                          );
                      } else {
                          computedRoot = keccak256(
                              abi.encodePacked(
                                  computedRoot,
                                  _siblings[i]
                              )
                          );
                      }
                      _index >>= 1;
                  }
                  return _root == computedRoot;
              }
              /*********************
               * Private Functions *
               *********************/
              /**
               * Calculates the integer ceiling of the log base 2 of an input.
               * @param _in Unsigned input to calculate the log.
               * @return ceil(log_base_2(_in))
               */
              function _ceilLog2(
                  uint256 _in
              )
                  private
                  pure
                  returns (
                      uint256
                  )
              {
                  require(
                      _in > 0,
                      "Lib_MerkleTree: Cannot compute ceil(log_2) of 0."
                  );
                  if (_in == 1) {
                      return 0;
                  }
                  // Find the highest set bit (will be floor(log_2)).
                  // Borrowed with <3 from https://github.com/ethereum/solidity-examples
                  uint256 val = _in;
                  uint256 highest = 0;
                  for (uint256 i = 128; i >= 1; i >>= 1) {
                      if (val & (uint(1) << i) - 1 << i != 0) {
                          highest += i;
                          val >>= i;
                      }
                  }
                  // Increment by one if this is not a perfect logarithm.
                  if ((uint(1) << highest) != _in) {
                      highest += 1;
                  }
                  return highest;
              }
          }// SPDX-License-Identifier: MIT
          pragma solidity >=0.6.0 <0.8.0;
          /**
           * @dev Contract module that helps prevent reentrant calls to a function.
           *
           * Inheriting from `ReentrancyGuard` will make the {nonReentrant} modifier
           * available, which can be applied to functions to make sure there are no nested
           * (reentrant) calls to them.
           *
           * Note that because there is a single `nonReentrant` guard, functions marked as
           * `nonReentrant` may not call one another. This can be worked around by making
           * those functions `private`, and then adding `external` `nonReentrant` entry
           * points to them.
           *
           * TIP: If you would like to learn more about reentrancy and alternative ways
           * to protect against it, check out our blog post
           * https://blog.openzeppelin.com/reentrancy-after-istanbul/[Reentrancy After Istanbul].
           */
          abstract contract ReentrancyGuard {
              // Booleans are more expensive than uint256 or any type that takes up a full
              // word because each write operation emits an extra SLOAD to first read the
              // slot's contents, replace the bits taken up by the boolean, and then write
              // back. This is the compiler's defense against contract upgrades and
              // pointer aliasing, and it cannot be disabled.
              // The values being non-zero value makes deployment a bit more expensive,
              // but in exchange the refund on every call to nonReentrant will be lower in
              // amount. Since refunds are capped to a percentage of the total
              // transaction's gas, it is best to keep them low in cases like this one, to
              // increase the likelihood of the full refund coming into effect.
              uint256 private constant _NOT_ENTERED = 1;
              uint256 private constant _ENTERED = 2;
              uint256 private _status;
              constructor () internal {
                  _status = _NOT_ENTERED;
              }
              /**
               * @dev Prevents a contract from calling itself, directly or indirectly.
               * Calling a `nonReentrant` function from another `nonReentrant`
               * function is not supported. It is possible to prevent this from happening
               * by making the `nonReentrant` function external, and make it call a
               * `private` function that does the actual work.
               */
              modifier nonReentrant() {
                  // On the first call to nonReentrant, _notEntered will be true
                  require(_status != _ENTERED, "ReentrancyGuard: reentrant call");
                  // Any calls to nonReentrant after this point will fail
                  _status = _ENTERED;
                  _;
                  // By storing the original value once again, a refund is triggered (see
                  // https://eips.ethereum.org/EIPS/eip-2200)
                  _status = _NOT_ENTERED;
              }
          }
          

          File 2 of 6: FiatTokenProxy
          pragma solidity ^0.4.24;
          
          // File: zos-lib/contracts/upgradeability/Proxy.sol
          
          /**
           * @title Proxy
           * @dev Implements delegation of calls to other contracts, with proper
           * forwarding of return values and bubbling of failures.
           * It defines a fallback function that delegates all calls to the address
           * returned by the abstract _implementation() internal function.
           */
          contract Proxy {
            /**
             * @dev Fallback function.
             * Implemented entirely in `_fallback`.
             */
            function () payable external {
              _fallback();
            }
          
            /**
             * @return The Address of the implementation.
             */
            function _implementation() internal view returns (address);
          
            /**
             * @dev Delegates execution to an implementation contract.
             * This is a low level function that doesn't return to its internal call site.
             * It will return to the external caller whatever the implementation returns.
             * @param implementation Address to delegate.
             */
            function _delegate(address implementation) internal {
              assembly {
                // Copy msg.data. We take full control of memory in this inline assembly
                // block because it will not return to Solidity code. We overwrite the
                // Solidity scratch pad at memory position 0.
                calldatacopy(0, 0, calldatasize)
          
                // Call the implementation.
                // out and outsize are 0 because we don't know the size yet.
                let result := delegatecall(gas, implementation, 0, calldatasize, 0, 0)
          
                // Copy the returned data.
                returndatacopy(0, 0, returndatasize)
          
                switch result
                // delegatecall returns 0 on error.
                case 0 { revert(0, returndatasize) }
                default { return(0, returndatasize) }
              }
            }
          
            /**
             * @dev Function that is run as the first thing in the fallback function.
             * Can be redefined in derived contracts to add functionality.
             * Redefinitions must call super._willFallback().
             */
            function _willFallback() internal {
            }
          
            /**
             * @dev fallback implementation.
             * Extracted to enable manual triggering.
             */
            function _fallback() internal {
              _willFallback();
              _delegate(_implementation());
            }
          }
          
          // File: openzeppelin-solidity/contracts/AddressUtils.sol
          
          /**
           * Utility library of inline functions on addresses
           */
          library AddressUtils {
          
            /**
             * Returns whether the target address is a contract
             * @dev This function will return false if invoked during the constructor of a contract,
             * as the code is not actually created until after the constructor finishes.
             * @param addr address to check
             * @return whether the target address is a contract
             */
            function isContract(address addr) internal view returns (bool) {
              uint256 size;
              // XXX Currently there is no better way to check if there is a contract in an address
              // than to check the size of the code at that address.
              // See https://ethereum.stackexchange.com/a/14016/36603
              // for more details about how this works.
              // TODO Check this again before the Serenity release, because all addresses will be
              // contracts then.
              // solium-disable-next-line security/no-inline-assembly
              assembly { size := extcodesize(addr) }
              return size > 0;
            }
          
          }
          
          // File: zos-lib/contracts/upgradeability/UpgradeabilityProxy.sol
          
          /**
           * @title UpgradeabilityProxy
           * @dev This contract implements a proxy that allows to change the
           * implementation address to which it will delegate.
           * Such a change is called an implementation upgrade.
           */
          contract UpgradeabilityProxy is Proxy {
            /**
             * @dev Emitted when the implementation is upgraded.
             * @param implementation Address of the new implementation.
             */
            event Upgraded(address implementation);
          
            /**
             * @dev Storage slot with the address of the current implementation.
             * This is the keccak-256 hash of "org.zeppelinos.proxy.implementation", and is
             * validated in the constructor.
             */
            bytes32 private constant IMPLEMENTATION_SLOT = 0x7050c9e0f4ca769c69bd3a8ef740bc37934f8e2c036e5a723fd8ee048ed3f8c3;
          
            /**
             * @dev Contract constructor.
             * @param _implementation Address of the initial implementation.
             */
            constructor(address _implementation) public {
              assert(IMPLEMENTATION_SLOT == keccak256("org.zeppelinos.proxy.implementation"));
          
              _setImplementation(_implementation);
            }
          
            /**
             * @dev Returns the current implementation.
             * @return Address of the current implementation
             */
            function _implementation() internal view returns (address impl) {
              bytes32 slot = IMPLEMENTATION_SLOT;
              assembly {
                impl := sload(slot)
              }
            }
          
            /**
             * @dev Upgrades the proxy to a new implementation.
             * @param newImplementation Address of the new implementation.
             */
            function _upgradeTo(address newImplementation) internal {
              _setImplementation(newImplementation);
              emit Upgraded(newImplementation);
            }
          
            /**
             * @dev Sets the implementation address of the proxy.
             * @param newImplementation Address of the new implementation.
             */
            function _setImplementation(address newImplementation) private {
              require(AddressUtils.isContract(newImplementation), "Cannot set a proxy implementation to a non-contract address");
          
              bytes32 slot = IMPLEMENTATION_SLOT;
          
              assembly {
                sstore(slot, newImplementation)
              }
            }
          }
          
          // File: zos-lib/contracts/upgradeability/AdminUpgradeabilityProxy.sol
          
          /**
           * @title AdminUpgradeabilityProxy
           * @dev This contract combines an upgradeability proxy with an authorization
           * mechanism for administrative tasks.
           * All external functions in this contract must be guarded by the
           * `ifAdmin` modifier. See ethereum/solidity#3864 for a Solidity
           * feature proposal that would enable this to be done automatically.
           */
          contract AdminUpgradeabilityProxy is UpgradeabilityProxy {
            /**
             * @dev Emitted when the administration has been transferred.
             * @param previousAdmin Address of the previous admin.
             * @param newAdmin Address of the new admin.
             */
            event AdminChanged(address previousAdmin, address newAdmin);
          
            /**
             * @dev Storage slot with the admin of the contract.
             * This is the keccak-256 hash of "org.zeppelinos.proxy.admin", and is
             * validated in the constructor.
             */
            bytes32 private constant ADMIN_SLOT = 0x10d6a54a4754c8869d6886b5f5d7fbfa5b4522237ea5c60d11bc4e7a1ff9390b;
          
            /**
             * @dev Modifier to check whether the `msg.sender` is the admin.
             * If it is, it will run the function. Otherwise, it will delegate the call
             * to the implementation.
             */
            modifier ifAdmin() {
              if (msg.sender == _admin()) {
                _;
              } else {
                _fallback();
              }
            }
          
            /**
             * Contract constructor.
             * It sets the `msg.sender` as the proxy administrator.
             * @param _implementation address of the initial implementation.
             */
            constructor(address _implementation) UpgradeabilityProxy(_implementation) public {
              assert(ADMIN_SLOT == keccak256("org.zeppelinos.proxy.admin"));
          
              _setAdmin(msg.sender);
            }
          
            /**
             * @return The address of the proxy admin.
             */
            function admin() external view ifAdmin returns (address) {
              return _admin();
            }
          
            /**
             * @return The address of the implementation.
             */
            function implementation() external view ifAdmin returns (address) {
              return _implementation();
            }
          
            /**
             * @dev Changes the admin of the proxy.
             * Only the current admin can call this function.
             * @param newAdmin Address to transfer proxy administration to.
             */
            function changeAdmin(address newAdmin) external ifAdmin {
              require(newAdmin != address(0), "Cannot change the admin of a proxy to the zero address");
              emit AdminChanged(_admin(), newAdmin);
              _setAdmin(newAdmin);
            }
          
            /**
             * @dev Upgrade the backing implementation of the proxy.
             * Only the admin can call this function.
             * @param newImplementation Address of the new implementation.
             */
            function upgradeTo(address newImplementation) external ifAdmin {
              _upgradeTo(newImplementation);
            }
          
            /**
             * @dev Upgrade the backing implementation of the proxy and call a function
             * on the new implementation.
             * This is useful to initialize the proxied contract.
             * @param newImplementation Address of the new implementation.
             * @param data Data to send as msg.data in the low level call.
             * It should include the signature and the parameters of the function to be
             * called, as described in
             * https://solidity.readthedocs.io/en/develop/abi-spec.html#function-selector-and-argument-encoding.
             */
            function upgradeToAndCall(address newImplementation, bytes data) payable external ifAdmin {
              _upgradeTo(newImplementation);
              require(address(this).call.value(msg.value)(data));
            }
          
            /**
             * @return The admin slot.
             */
            function _admin() internal view returns (address adm) {
              bytes32 slot = ADMIN_SLOT;
              assembly {
                adm := sload(slot)
              }
            }
          
            /**
             * @dev Sets the address of the proxy admin.
             * @param newAdmin Address of the new proxy admin.
             */
            function _setAdmin(address newAdmin) internal {
              bytes32 slot = ADMIN_SLOT;
          
              assembly {
                sstore(slot, newAdmin)
              }
            }
          
            /**
             * @dev Only fall back when the sender is not the admin.
             */
            function _willFallback() internal {
              require(msg.sender != _admin(), "Cannot call fallback function from the proxy admin");
              super._willFallback();
            }
          }
          
          // File: contracts/FiatTokenProxy.sol
          
          /**
          * Copyright CENTRE SECZ 2018
          *
          * Permission is hereby granted, free of charge, to any person obtaining a copy 
          * of this software and associated documentation files (the "Software"), to deal 
          * in the Software without restriction, including without limitation the rights 
          * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell 
          * copies of the Software, and to permit persons to whom the Software is furnished to 
          * do so, subject to the following conditions:
          *
          * The above copyright notice and this permission notice shall be included in all 
          * copies or substantial portions of the Software.
          *
          * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR 
          * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 
          * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE 
          * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
          * WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN 
          * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
          */
          
          pragma solidity ^0.4.24;
          
          
          /**
           * @title FiatTokenProxy
           * @dev This contract proxies FiatToken calls and enables FiatToken upgrades
          */ 
          contract FiatTokenProxy is AdminUpgradeabilityProxy {
              constructor(address _implementation) public AdminUpgradeabilityProxy(_implementation) {
              }
          }

          File 3 of 6: StateSender
          /**
          Matic network contracts
          */
          
          pragma solidity ^0.5.2;
          
          
          contract Ownable {
              address private _owner;
          
              event OwnershipTransferred(address indexed previousOwner, address indexed newOwner);
          
              /**
               * @dev The Ownable constructor sets the original `owner` of the contract to the sender
               * account.
               */
              constructor () internal {
                  _owner = msg.sender;
                  emit OwnershipTransferred(address(0), _owner);
              }
          
              /**
               * @return the address of the owner.
               */
              function owner() public view returns (address) {
                  return _owner;
              }
          
              /**
               * @dev Throws if called by any account other than the owner.
               */
              modifier onlyOwner() {
                  require(isOwner());
                  _;
              }
          
              /**
               * @return true if `msg.sender` is the owner of the contract.
               */
              function isOwner() public view returns (bool) {
                  return msg.sender == _owner;
              }
          
              /**
               * @dev Allows the current owner to relinquish control of the contract.
               * It will not be possible to call the functions with the `onlyOwner`
               * modifier anymore.
               * @notice Renouncing ownership will leave the contract without an owner,
               * thereby removing any functionality that is only available to the owner.
               */
              function renounceOwnership() public onlyOwner {
                  emit OwnershipTransferred(_owner, address(0));
                  _owner = address(0);
              }
          
              /**
               * @dev Allows the current owner to transfer control of the contract to a newOwner.
               * @param newOwner The address to transfer ownership to.
               */
              function transferOwnership(address newOwner) public onlyOwner {
                  _transferOwnership(newOwner);
              }
          
              /**
               * @dev Transfers control of the contract to a newOwner.
               * @param newOwner The address to transfer ownership to.
               */
              function _transferOwnership(address newOwner) internal {
                  require(newOwner != address(0));
                  emit OwnershipTransferred(_owner, newOwner);
                  _owner = newOwner;
              }
          }
          
          library SafeMath {
              /**
               * @dev Multiplies two unsigned integers, reverts on overflow.
               */
              function mul(uint256 a, uint256 b) internal pure returns (uint256) {
                  // Gas optimization: this is cheaper than requiring 'a' not being zero, but the
                  // benefit is lost if 'b' is also tested.
                  // See: https://github.com/OpenZeppelin/openzeppelin-solidity/pull/522
                  if (a == 0) {
                      return 0;
                  }
          
                  uint256 c = a * b;
                  require(c / a == b);
          
                  return c;
              }
          
              /**
               * @dev Integer division of two unsigned integers truncating the quotient, reverts on division by zero.
               */
              function div(uint256 a, uint256 b) internal pure returns (uint256) {
                  // Solidity only automatically asserts when dividing by 0
                  require(b > 0);
                  uint256 c = a / b;
                  // assert(a == b * c + a % b); // There is no case in which this doesn't hold
          
                  return c;
              }
          
              /**
               * @dev Subtracts two unsigned integers, reverts on overflow (i.e. if subtrahend is greater than minuend).
               */
              function sub(uint256 a, uint256 b) internal pure returns (uint256) {
                  require(b <= a);
                  uint256 c = a - b;
          
                  return c;
              }
          
              /**
               * @dev Adds two unsigned integers, reverts on overflow.
               */
              function add(uint256 a, uint256 b) internal pure returns (uint256) {
                  uint256 c = a + b;
                  require(c >= a);
          
                  return c;
              }
          
              /**
               * @dev Divides two unsigned integers and returns the remainder (unsigned integer modulo),
               * reverts when dividing by zero.
               */
              function mod(uint256 a, uint256 b) internal pure returns (uint256) {
                  require(b != 0);
                  return a % b;
              }
          }
          
          contract StateSender is Ownable {
              using SafeMath for uint256;
          
              uint256 public counter;
              mapping(address => address) public registrations;
          
              event NewRegistration(
                  address indexed user,
                  address indexed sender,
                  address indexed receiver
              );
              event RegistrationUpdated(
                  address indexed user,
                  address indexed sender,
                  address indexed receiver
              );
              event StateSynced(
                  uint256 indexed id,
                  address indexed contractAddress,
                  bytes data
              );
          
              modifier onlyRegistered(address receiver) {
                  require(registrations[receiver] == msg.sender, "Invalid sender");
                  _;
              }
          
              function syncState(address receiver, bytes calldata data)
                  external
                  onlyRegistered(receiver)
              {
                  counter = counter.add(1);
                  emit StateSynced(counter, receiver, data);
              }
          
              // register new contract for state sync
              function register(address sender, address receiver) public {
                  require(
                      isOwner() || registrations[receiver] == msg.sender,
                      "StateSender.register: Not authorized to register"
                  );
                  registrations[receiver] = sender;
                  if (registrations[receiver] == address(0)) {
                      emit NewRegistration(msg.sender, sender, receiver);
                  } else {
                      emit RegistrationUpdated(msg.sender, sender, receiver);
                  }
              }
          }

          File 4 of 6: FiatTokenV2_1
          // File: @openzeppelin/contracts/math/SafeMath.sol
          
          // SPDX-License-Identifier: MIT
          
          pragma solidity ^0.6.0;
          
          /**
           * @dev Wrappers over Solidity's arithmetic operations with added overflow
           * checks.
           *
           * Arithmetic operations in Solidity wrap on overflow. This can easily result
           * in bugs, because programmers usually assume that an overflow raises an
           * error, which is the standard behavior in high level programming languages.
           * `SafeMath` restores this intuition by reverting the transaction when an
           * operation overflows.
           *
           * Using this library instead of the unchecked operations eliminates an entire
           * class of bugs, so it's recommended to use it always.
           */
          library SafeMath {
              /**
               * @dev Returns the addition of two unsigned integers, reverting on
               * overflow.
               *
               * Counterpart to Solidity's `+` operator.
               *
               * Requirements:
               *
               * - Addition cannot overflow.
               */
              function add(uint256 a, uint256 b) internal pure returns (uint256) {
                  uint256 c = a + b;
                  require(c >= a, "SafeMath: addition overflow");
          
                  return c;
              }
          
              /**
               * @dev Returns the subtraction of two unsigned integers, reverting on
               * overflow (when the result is negative).
               *
               * Counterpart to Solidity's `-` operator.
               *
               * Requirements:
               *
               * - Subtraction cannot overflow.
               */
              function sub(uint256 a, uint256 b) internal pure returns (uint256) {
                  return sub(a, b, "SafeMath: subtraction overflow");
              }
          
              /**
               * @dev Returns the subtraction of two unsigned integers, reverting with custom message on
               * overflow (when the result is negative).
               *
               * Counterpart to Solidity's `-` operator.
               *
               * Requirements:
               *
               * - Subtraction cannot overflow.
               */
              function sub(
                  uint256 a,
                  uint256 b,
                  string memory errorMessage
              ) internal pure returns (uint256) {
                  require(b <= a, errorMessage);
                  uint256 c = a - b;
          
                  return c;
              }
          
              /**
               * @dev Returns the multiplication of two unsigned integers, reverting on
               * overflow.
               *
               * Counterpart to Solidity's `*` operator.
               *
               * Requirements:
               *
               * - Multiplication cannot overflow.
               */
              function mul(uint256 a, uint256 b) internal pure returns (uint256) {
                  // Gas optimization: this is cheaper than requiring 'a' not being zero, but the
                  // benefit is lost if 'b' is also tested.
                  // See: https://github.com/OpenZeppelin/openzeppelin-contracts/pull/522
                  if (a == 0) {
                      return 0;
                  }
          
                  uint256 c = a * b;
                  require(c / a == b, "SafeMath: multiplication overflow");
          
                  return c;
              }
          
              /**
               * @dev Returns the integer division of two unsigned integers. Reverts on
               * division by zero. The result is rounded towards zero.
               *
               * Counterpart to Solidity's `/` operator. Note: this function uses a
               * `revert` opcode (which leaves remaining gas untouched) while Solidity
               * uses an invalid opcode to revert (consuming all remaining gas).
               *
               * Requirements:
               *
               * - The divisor cannot be zero.
               */
              function div(uint256 a, uint256 b) internal pure returns (uint256) {
                  return div(a, b, "SafeMath: division by zero");
              }
          
              /**
               * @dev Returns the integer division of two unsigned integers. Reverts with custom message on
               * division by zero. The result is rounded towards zero.
               *
               * Counterpart to Solidity's `/` operator. Note: this function uses a
               * `revert` opcode (which leaves remaining gas untouched) while Solidity
               * uses an invalid opcode to revert (consuming all remaining gas).
               *
               * Requirements:
               *
               * - The divisor cannot be zero.
               */
              function div(
                  uint256 a,
                  uint256 b,
                  string memory errorMessage
              ) internal pure returns (uint256) {
                  require(b > 0, errorMessage);
                  uint256 c = a / b;
                  // assert(a == b * c + a % b); // There is no case in which this doesn't hold
          
                  return c;
              }
          
              /**
               * @dev Returns the remainder of dividing two unsigned integers. (unsigned integer modulo),
               * Reverts when dividing by zero.
               *
               * Counterpart to Solidity's `%` operator. This function uses a `revert`
               * opcode (which leaves remaining gas untouched) while Solidity uses an
               * invalid opcode to revert (consuming all remaining gas).
               *
               * Requirements:
               *
               * - The divisor cannot be zero.
               */
              function mod(uint256 a, uint256 b) internal pure returns (uint256) {
                  return mod(a, b, "SafeMath: modulo by zero");
              }
          
              /**
               * @dev Returns the remainder of dividing two unsigned integers. (unsigned integer modulo),
               * Reverts with custom message when dividing by zero.
               *
               * Counterpart to Solidity's `%` operator. This function uses a `revert`
               * opcode (which leaves remaining gas untouched) while Solidity uses an
               * invalid opcode to revert (consuming all remaining gas).
               *
               * Requirements:
               *
               * - The divisor cannot be zero.
               */
              function mod(
                  uint256 a,
                  uint256 b,
                  string memory errorMessage
              ) internal pure returns (uint256) {
                  require(b != 0, errorMessage);
                  return a % b;
              }
          }
          
          // File: @openzeppelin/contracts/token/ERC20/IERC20.sol
          
          pragma solidity ^0.6.0;
          
          /**
           * @dev Interface of the ERC20 standard as defined in the EIP.
           */
          interface IERC20 {
              /**
               * @dev Returns the amount of tokens in existence.
               */
              function totalSupply() external view returns (uint256);
          
              /**
               * @dev Returns the amount of tokens owned by `account`.
               */
              function balanceOf(address account) external view returns (uint256);
          
              /**
               * @dev Moves `amount` tokens from the caller's account to `recipient`.
               *
               * Returns a boolean value indicating whether the operation succeeded.
               *
               * Emits a {Transfer} event.
               */
              function transfer(address recipient, uint256 amount)
                  external
                  returns (bool);
          
              /**
               * @dev Returns the remaining number of tokens that `spender` will be
               * allowed to spend on behalf of `owner` through {transferFrom}. This is
               * zero by default.
               *
               * This value changes when {approve} or {transferFrom} are called.
               */
              function allowance(address owner, address spender)
                  external
                  view
                  returns (uint256);
          
              /**
               * @dev Sets `amount` as the allowance of `spender` over the caller's tokens.
               *
               * Returns a boolean value indicating whether the operation succeeded.
               *
               * IMPORTANT: Beware that changing an allowance with this method brings the risk
               * that someone may use both the old and the new allowance by unfortunate
               * transaction ordering. One possible solution to mitigate this race
               * condition is to first reduce the spender's allowance to 0 and set the
               * desired value afterwards:
               * https://github.com/ethereum/EIPs/issues/20#issuecomment-263524729
               *
               * Emits an {Approval} event.
               */
              function approve(address spender, uint256 amount) external returns (bool);
          
              /**
               * @dev Moves `amount` tokens from `sender` to `recipient` using the
               * allowance mechanism. `amount` is then deducted from the caller's
               * allowance.
               *
               * Returns a boolean value indicating whether the operation succeeded.
               *
               * Emits a {Transfer} event.
               */
              function transferFrom(
                  address sender,
                  address recipient,
                  uint256 amount
              ) external returns (bool);
          
              /**
               * @dev Emitted when `value` tokens are moved from one account (`from`) to
               * another (`to`).
               *
               * Note that `value` may be zero.
               */
              event Transfer(address indexed from, address indexed to, uint256 value);
          
              /**
               * @dev Emitted when the allowance of a `spender` for an `owner` is set by
               * a call to {approve}. `value` is the new allowance.
               */
              event Approval(
                  address indexed owner,
                  address indexed spender,
                  uint256 value
              );
          }
          
          // File: contracts/v1/AbstractFiatTokenV1.sol
          
          /**
           * Copyright (c) 2018-2020 CENTRE SECZ
           *
           * Permission is hereby granted, free of charge, to any person obtaining a copy
           * of this software and associated documentation files (the "Software"), to deal
           * in the Software without restriction, including without limitation the rights
           * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
           * copies of the Software, and to permit persons to whom the Software is
           * furnished to do so, subject to the following conditions:
           *
           * The above copyright notice and this permission notice shall be included in
           * copies or substantial portions of the Software.
           *
           * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
           * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
           * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
           * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
           * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
           * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
           * SOFTWARE.
           */
          
          pragma solidity 0.6.12;
          
          abstract contract AbstractFiatTokenV1 is IERC20 {
              function _approve(
                  address owner,
                  address spender,
                  uint256 value
              ) internal virtual;
          
              function _transfer(
                  address from,
                  address to,
                  uint256 value
              ) internal virtual;
          }
          
          // File: contracts/v1/Ownable.sol
          
          /**
           * Copyright (c) 2018 zOS Global Limited.
           * Copyright (c) 2018-2020 CENTRE SECZ
           *
           * Permission is hereby granted, free of charge, to any person obtaining a copy
           * of this software and associated documentation files (the "Software"), to deal
           * in the Software without restriction, including without limitation the rights
           * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
           * copies of the Software, and to permit persons to whom the Software is
           * furnished to do so, subject to the following conditions:
           *
           * The above copyright notice and this permission notice shall be included in
           * copies or substantial portions of the Software.
           *
           * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
           * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
           * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
           * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
           * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
           * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
           * SOFTWARE.
           */
          pragma solidity 0.6.12;
          
          /**
           * @notice The Ownable contract has an owner address, and provides basic
           * authorization control functions
           * @dev Forked from https://github.com/OpenZeppelin/openzeppelin-labs/blob/3887ab77b8adafba4a26ace002f3a684c1a3388b/upgradeability_ownership/contracts/ownership/Ownable.sol
           * Modifications:
           * 1. Consolidate OwnableStorage into this contract (7/13/18)
           * 2. Reformat, conform to Solidity 0.6 syntax, and add error messages (5/13/20)
           * 3. Make public functions external (5/27/20)
           */
          contract Ownable {
              // Owner of the contract
              address private _owner;
          
              /**
               * @dev Event to show ownership has been transferred
               * @param previousOwner representing the address of the previous owner
               * @param newOwner representing the address of the new owner
               */
              event OwnershipTransferred(address previousOwner, address newOwner);
          
              /**
               * @dev The constructor sets the original owner of the contract to the sender account.
               */
              constructor() public {
                  setOwner(msg.sender);
              }
          
              /**
               * @dev Tells the address of the owner
               * @return the address of the owner
               */
              function owner() external view returns (address) {
                  return _owner;
              }
          
              /**
               * @dev Sets a new owner address
               */
              function setOwner(address newOwner) internal {
                  _owner = newOwner;
              }
          
              /**
               * @dev Throws if called by any account other than the owner.
               */
              modifier onlyOwner() {
                  require(msg.sender == _owner, "Ownable: caller is not the owner");
                  _;
              }
          
              /**
               * @dev Allows the current owner to transfer control of the contract to a newOwner.
               * @param newOwner The address to transfer ownership to.
               */
              function transferOwnership(address newOwner) external onlyOwner {
                  require(
                      newOwner != address(0),
                      "Ownable: new owner is the zero address"
                  );
                  emit OwnershipTransferred(_owner, newOwner);
                  setOwner(newOwner);
              }
          }
          
          // File: contracts/v1/Pausable.sol
          
          /**
           * Copyright (c) 2016 Smart Contract Solutions, Inc.
           * Copyright (c) 2018-2020 CENTRE SECZ0
           *
           * Permission is hereby granted, free of charge, to any person obtaining a copy
           * of this software and associated documentation files (the "Software"), to deal
           * in the Software without restriction, including without limitation the rights
           * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
           * copies of the Software, and to permit persons to whom the Software is
           * furnished to do so, subject to the following conditions:
           *
           * The above copyright notice and this permission notice shall be included in
           * copies or substantial portions of the Software.
           *
           * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
           * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
           * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
           * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
           * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
           * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
           * SOFTWARE.
           */
          
          pragma solidity 0.6.12;
          
          /**
           * @notice Base contract which allows children to implement an emergency stop
           * mechanism
           * @dev Forked from https://github.com/OpenZeppelin/openzeppelin-contracts/blob/feb665136c0dae9912e08397c1a21c4af3651ef3/contracts/lifecycle/Pausable.sol
           * Modifications:
           * 1. Added pauser role, switched pause/unpause to be onlyPauser (6/14/2018)
           * 2. Removed whenNotPause/whenPaused from pause/unpause (6/14/2018)
           * 3. Removed whenPaused (6/14/2018)
           * 4. Switches ownable library to use ZeppelinOS (7/12/18)
           * 5. Remove constructor (7/13/18)
           * 6. Reformat, conform to Solidity 0.6 syntax and add error messages (5/13/20)
           * 7. Make public functions external (5/27/20)
           */
          contract Pausable is Ownable {
              event Pause();
              event Unpause();
              event PauserChanged(address indexed newAddress);
          
              address public pauser;
              bool public paused = false;
          
              /**
               * @dev Modifier to make a function callable only when the contract is not paused.
               */
              modifier whenNotPaused() {
                  require(!paused, "Pausable: paused");
                  _;
              }
          
              /**
               * @dev throws if called by any account other than the pauser
               */
              modifier onlyPauser() {
                  require(msg.sender == pauser, "Pausable: caller is not the pauser");
                  _;
              }
          
              /**
               * @dev called by the owner to pause, triggers stopped state
               */
              function pause() external onlyPauser {
                  paused = true;
                  emit Pause();
              }
          
              /**
               * @dev called by the owner to unpause, returns to normal state
               */
              function unpause() external onlyPauser {
                  paused = false;
                  emit Unpause();
              }
          
              /**
               * @dev update the pauser role
               */
              function updatePauser(address _newPauser) external onlyOwner {
                  require(
                      _newPauser != address(0),
                      "Pausable: new pauser is the zero address"
                  );
                  pauser = _newPauser;
                  emit PauserChanged(pauser);
              }
          }
          
          // File: contracts/v1/Blacklistable.sol
          
          /**
           * Copyright (c) 2018-2020 CENTRE SECZ
           *
           * Permission is hereby granted, free of charge, to any person obtaining a copy
           * of this software and associated documentation files (the "Software"), to deal
           * in the Software without restriction, including without limitation the rights
           * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
           * copies of the Software, and to permit persons to whom the Software is
           * furnished to do so, subject to the following conditions:
           *
           * The above copyright notice and this permission notice shall be included in
           * copies or substantial portions of the Software.
           *
           * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
           * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
           * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
           * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
           * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
           * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
           * SOFTWARE.
           */
          
          pragma solidity 0.6.12;
          
          /**
           * @title Blacklistable Token
           * @dev Allows accounts to be blacklisted by a "blacklister" role
           */
          contract Blacklistable is Ownable {
              address public blacklister;
              mapping(address => bool) internal blacklisted;
          
              event Blacklisted(address indexed _account);
              event UnBlacklisted(address indexed _account);
              event BlacklisterChanged(address indexed newBlacklister);
          
              /**
               * @dev Throws if called by any account other than the blacklister
               */
              modifier onlyBlacklister() {
                  require(
                      msg.sender == blacklister,
                      "Blacklistable: caller is not the blacklister"
                  );
                  _;
              }
          
              /**
               * @dev Throws if argument account is blacklisted
               * @param _account The address to check
               */
              modifier notBlacklisted(address _account) {
                  require(
                      !blacklisted[_account],
                      "Blacklistable: account is blacklisted"
                  );
                  _;
              }
          
              /**
               * @dev Checks if account is blacklisted
               * @param _account The address to check
               */
              function isBlacklisted(address _account) external view returns (bool) {
                  return blacklisted[_account];
              }
          
              /**
               * @dev Adds account to blacklist
               * @param _account The address to blacklist
               */
              function blacklist(address _account) external onlyBlacklister {
                  blacklisted[_account] = true;
                  emit Blacklisted(_account);
              }
          
              /**
               * @dev Removes account from blacklist
               * @param _account The address to remove from the blacklist
               */
              function unBlacklist(address _account) external onlyBlacklister {
                  blacklisted[_account] = false;
                  emit UnBlacklisted(_account);
              }
          
              function updateBlacklister(address _newBlacklister) external onlyOwner {
                  require(
                      _newBlacklister != address(0),
                      "Blacklistable: new blacklister is the zero address"
                  );
                  blacklister = _newBlacklister;
                  emit BlacklisterChanged(blacklister);
              }
          }
          
          // File: contracts/v1/FiatTokenV1.sol
          
          /**
           *
           * Copyright (c) 2018-2020 CENTRE SECZ
           *
           * Permission is hereby granted, free of charge, to any person obtaining a copy
           * of this software and associated documentation files (the "Software"), to deal
           * in the Software without restriction, including without limitation the rights
           * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
           * copies of the Software, and to permit persons to whom the Software is
           * furnished to do so, subject to the following conditions:
           *
           * The above copyright notice and this permission notice shall be included in
           * copies or substantial portions of the Software.
           *
           * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
           * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
           * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
           * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
           * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
           * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
           * SOFTWARE.
           */
          
          pragma solidity 0.6.12;
          
          /**
           * @title FiatToken
           * @dev ERC20 Token backed by fiat reserves
           */
          contract FiatTokenV1 is AbstractFiatTokenV1, Ownable, Pausable, Blacklistable {
              using SafeMath for uint256;
          
              string public name;
              string public symbol;
              uint8 public decimals;
              string public currency;
              address public masterMinter;
              bool internal initialized;
          
              mapping(address => uint256) internal balances;
              mapping(address => mapping(address => uint256)) internal allowed;
              uint256 internal totalSupply_ = 0;
              mapping(address => bool) internal minters;
              mapping(address => uint256) internal minterAllowed;
          
              event Mint(address indexed minter, address indexed to, uint256 amount);
              event Burn(address indexed burner, uint256 amount);
              event MinterConfigured(address indexed minter, uint256 minterAllowedAmount);
              event MinterRemoved(address indexed oldMinter);
              event MasterMinterChanged(address indexed newMasterMinter);
          
              function initialize(
                  string memory tokenName,
                  string memory tokenSymbol,
                  string memory tokenCurrency,
                  uint8 tokenDecimals,
                  address newMasterMinter,
                  address newPauser,
                  address newBlacklister,
                  address newOwner
              ) public {
                  require(!initialized, "FiatToken: contract is already initialized");
                  require(
                      newMasterMinter != address(0),
                      "FiatToken: new masterMinter is the zero address"
                  );
                  require(
                      newPauser != address(0),
                      "FiatToken: new pauser is the zero address"
                  );
                  require(
                      newBlacklister != address(0),
                      "FiatToken: new blacklister is the zero address"
                  );
                  require(
                      newOwner != address(0),
                      "FiatToken: new owner is the zero address"
                  );
          
                  name = tokenName;
                  symbol = tokenSymbol;
                  currency = tokenCurrency;
                  decimals = tokenDecimals;
                  masterMinter = newMasterMinter;
                  pauser = newPauser;
                  blacklister = newBlacklister;
                  setOwner(newOwner);
                  initialized = true;
              }
          
              /**
               * @dev Throws if called by any account other than a minter
               */
              modifier onlyMinters() {
                  require(minters[msg.sender], "FiatToken: caller is not a minter");
                  _;
              }
          
              /**
               * @dev Function to mint tokens
               * @param _to The address that will receive the minted tokens.
               * @param _amount The amount of tokens to mint. Must be less than or equal
               * to the minterAllowance of the caller.
               * @return A boolean that indicates if the operation was successful.
               */
              function mint(address _to, uint256 _amount)
                  external
                  whenNotPaused
                  onlyMinters
                  notBlacklisted(msg.sender)
                  notBlacklisted(_to)
                  returns (bool)
              {
                  require(_to != address(0), "FiatToken: mint to the zero address");
                  require(_amount > 0, "FiatToken: mint amount not greater than 0");
          
                  uint256 mintingAllowedAmount = minterAllowed[msg.sender];
                  require(
                      _amount <= mintingAllowedAmount,
                      "FiatToken: mint amount exceeds minterAllowance"
                  );
          
                  totalSupply_ = totalSupply_.add(_amount);
                  balances[_to] = balances[_to].add(_amount);
                  minterAllowed[msg.sender] = mintingAllowedAmount.sub(_amount);
                  emit Mint(msg.sender, _to, _amount);
                  emit Transfer(address(0), _to, _amount);
                  return true;
              }
          
              /**
               * @dev Throws if called by any account other than the masterMinter
               */
              modifier onlyMasterMinter() {
                  require(
                      msg.sender == masterMinter,
                      "FiatToken: caller is not the masterMinter"
                  );
                  _;
              }
          
              /**
               * @dev Get minter allowance for an account
               * @param minter The address of the minter
               */
              function minterAllowance(address minter) external view returns (uint256) {
                  return minterAllowed[minter];
              }
          
              /**
               * @dev Checks if account is a minter
               * @param account The address to check
               */
              function isMinter(address account) external view returns (bool) {
                  return minters[account];
              }
          
              /**
               * @notice Amount of remaining tokens spender is allowed to transfer on
               * behalf of the token owner
               * @param owner     Token owner's address
               * @param spender   Spender's address
               * @return Allowance amount
               */
              function allowance(address owner, address spender)
                  external
                  override
                  view
                  returns (uint256)
              {
                  return allowed[owner][spender];
              }
          
              /**
               * @dev Get totalSupply of token
               */
              function totalSupply() external override view returns (uint256) {
                  return totalSupply_;
              }
          
              /**
               * @dev Get token balance of an account
               * @param account address The account
               */
              function balanceOf(address account)
                  external
                  override
                  view
                  returns (uint256)
              {
                  return balances[account];
              }
          
              /**
               * @notice Set spender's allowance over the caller's tokens to be a given
               * value.
               * @param spender   Spender's address
               * @param value     Allowance amount
               * @return True if successful
               */
              function approve(address spender, uint256 value)
                  external
                  override
                  whenNotPaused
                  notBlacklisted(msg.sender)
                  notBlacklisted(spender)
                  returns (bool)
              {
                  _approve(msg.sender, spender, value);
                  return true;
              }
          
              /**
               * @dev Internal function to set allowance
               * @param owner     Token owner's address
               * @param spender   Spender's address
               * @param value     Allowance amount
               */
              function _approve(
                  address owner,
                  address spender,
                  uint256 value
              ) internal override {
                  require(owner != address(0), "ERC20: approve from the zero address");
                  require(spender != address(0), "ERC20: approve to the zero address");
                  allowed[owner][spender] = value;
                  emit Approval(owner, spender, value);
              }
          
              /**
               * @notice Transfer tokens by spending allowance
               * @param from  Payer's address
               * @param to    Payee's address
               * @param value Transfer amount
               * @return True if successful
               */
              function transferFrom(
                  address from,
                  address to,
                  uint256 value
              )
                  external
                  override
                  whenNotPaused
                  notBlacklisted(msg.sender)
                  notBlacklisted(from)
                  notBlacklisted(to)
                  returns (bool)
              {
                  require(
                      value <= allowed[from][msg.sender],
                      "ERC20: transfer amount exceeds allowance"
                  );
                  _transfer(from, to, value);
                  allowed[from][msg.sender] = allowed[from][msg.sender].sub(value);
                  return true;
              }
          
              /**
               * @notice Transfer tokens from the caller
               * @param to    Payee's address
               * @param value Transfer amount
               * @return True if successful
               */
              function transfer(address to, uint256 value)
                  external
                  override
                  whenNotPaused
                  notBlacklisted(msg.sender)
                  notBlacklisted(to)
                  returns (bool)
              {
                  _transfer(msg.sender, to, value);
                  return true;
              }
          
              /**
               * @notice Internal function to process transfers
               * @param from  Payer's address
               * @param to    Payee's address
               * @param value Transfer amount
               */
              function _transfer(
                  address from,
                  address to,
                  uint256 value
              ) internal override {
                  require(from != address(0), "ERC20: transfer from the zero address");
                  require(to != address(0), "ERC20: transfer to the zero address");
                  require(
                      value <= balances[from],
                      "ERC20: transfer amount exceeds balance"
                  );
          
                  balances[from] = balances[from].sub(value);
                  balances[to] = balances[to].add(value);
                  emit Transfer(from, to, value);
              }
          
              /**
               * @dev Function to add/update a new minter
               * @param minter The address of the minter
               * @param minterAllowedAmount The minting amount allowed for the minter
               * @return True if the operation was successful.
               */
              function configureMinter(address minter, uint256 minterAllowedAmount)
                  external
                  whenNotPaused
                  onlyMasterMinter
                  returns (bool)
              {
                  minters[minter] = true;
                  minterAllowed[minter] = minterAllowedAmount;
                  emit MinterConfigured(minter, minterAllowedAmount);
                  return true;
              }
          
              /**
               * @dev Function to remove a minter
               * @param minter The address of the minter to remove
               * @return True if the operation was successful.
               */
              function removeMinter(address minter)
                  external
                  onlyMasterMinter
                  returns (bool)
              {
                  minters[minter] = false;
                  minterAllowed[minter] = 0;
                  emit MinterRemoved(minter);
                  return true;
              }
          
              /**
               * @dev allows a minter to burn some of its own tokens
               * Validates that caller is a minter and that sender is not blacklisted
               * amount is less than or equal to the minter's account balance
               * @param _amount uint256 the amount of tokens to be burned
               */
              function burn(uint256 _amount)
                  external
                  whenNotPaused
                  onlyMinters
                  notBlacklisted(msg.sender)
              {
                  uint256 balance = balances[msg.sender];
                  require(_amount > 0, "FiatToken: burn amount not greater than 0");
                  require(balance >= _amount, "FiatToken: burn amount exceeds balance");
          
                  totalSupply_ = totalSupply_.sub(_amount);
                  balances[msg.sender] = balance.sub(_amount);
                  emit Burn(msg.sender, _amount);
                  emit Transfer(msg.sender, address(0), _amount);
              }
          
              function updateMasterMinter(address _newMasterMinter) external onlyOwner {
                  require(
                      _newMasterMinter != address(0),
                      "FiatToken: new masterMinter is the zero address"
                  );
                  masterMinter = _newMasterMinter;
                  emit MasterMinterChanged(masterMinter);
              }
          }
          
          // File: @openzeppelin/contracts/utils/Address.sol
          
          pragma solidity ^0.6.2;
          
          /**
           * @dev Collection of functions related to the address type
           */
          library Address {
              /**
               * @dev Returns true if `account` is a contract.
               *
               * [IMPORTANT]
               * ====
               * It is unsafe to assume that an address for which this function returns
               * false is an externally-owned account (EOA) and not a contract.
               *
               * Among others, `isContract` will return false for the following
               * types of addresses:
               *
               *  - an externally-owned account
               *  - a contract in construction
               *  - an address where a contract will be created
               *  - an address where a contract lived, but was destroyed
               * ====
               */
              function isContract(address account) internal view returns (bool) {
                  // According to EIP-1052, 0x0 is the value returned for not-yet created accounts
                  // and 0xc5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a470 is returned
                  // for accounts without code, i.e. `keccak256('')`
                  bytes32 codehash;
          
                      bytes32 accountHash
                   = 0xc5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a470;
                  // solhint-disable-next-line no-inline-assembly
                  assembly {
                      codehash := extcodehash(account)
                  }
                  return (codehash != accountHash && codehash != 0x0);
              }
          
              /**
               * @dev Replacement for Solidity's `transfer`: sends `amount` wei to
               * `recipient`, forwarding all available gas and reverting on errors.
               *
               * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost
               * of certain opcodes, possibly making contracts go over the 2300 gas limit
               * imposed by `transfer`, making them unable to receive funds via
               * `transfer`. {sendValue} removes this limitation.
               *
               * https://diligence.consensys.net/posts/2019/09/stop-using-soliditys-transfer-now/[Learn more].
               *
               * IMPORTANT: because control is transferred to `recipient`, care must be
               * taken to not create reentrancy vulnerabilities. Consider using
               * {ReentrancyGuard} or the
               * https://solidity.readthedocs.io/en/v0.5.11/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].
               */
              function sendValue(address payable recipient, uint256 amount) internal {
                  require(
                      address(this).balance >= amount,
                      "Address: insufficient balance"
                  );
          
                  // solhint-disable-next-line avoid-low-level-calls, avoid-call-value
                  (bool success, ) = recipient.call{ value: amount }("");
                  require(
                      success,
                      "Address: unable to send value, recipient may have reverted"
                  );
              }
          
              /**
               * @dev Performs a Solidity function call using a low level `call`. A
               * plain`call` is an unsafe replacement for a function call: use this
               * function instead.
               *
               * If `target` reverts with a revert reason, it is bubbled up by this
               * function (like regular Solidity function calls).
               *
               * Returns the raw returned data. To convert to the expected return value,
               * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].
               *
               * Requirements:
               *
               * - `target` must be a contract.
               * - calling `target` with `data` must not revert.
               *
               * _Available since v3.1._
               */
              function functionCall(address target, bytes memory data)
                  internal
                  returns (bytes memory)
              {
                  return functionCall(target, data, "Address: low-level call failed");
              }
          
              /**
               * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with
               * `errorMessage` as a fallback revert reason when `target` reverts.
               *
               * _Available since v3.1._
               */
              function functionCall(
                  address target,
                  bytes memory data,
                  string memory errorMessage
              ) internal returns (bytes memory) {
                  return _functionCallWithValue(target, data, 0, errorMessage);
              }
          
              /**
               * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
               * but also transferring `value` wei to `target`.
               *
               * Requirements:
               *
               * - the calling contract must have an ETH balance of at least `value`.
               * - the called Solidity function must be `payable`.
               *
               * _Available since v3.1._
               */
              function functionCallWithValue(
                  address target,
                  bytes memory data,
                  uint256 value
              ) internal returns (bytes memory) {
                  return
                      functionCallWithValue(
                          target,
                          data,
                          value,
                          "Address: low-level call with value failed"
                      );
              }
          
              /**
               * @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but
               * with `errorMessage` as a fallback revert reason when `target` reverts.
               *
               * _Available since v3.1._
               */
              function functionCallWithValue(
                  address target,
                  bytes memory data,
                  uint256 value,
                  string memory errorMessage
              ) internal returns (bytes memory) {
                  require(
                      address(this).balance >= value,
                      "Address: insufficient balance for call"
                  );
                  return _functionCallWithValue(target, data, value, errorMessage);
              }
          
              function _functionCallWithValue(
                  address target,
                  bytes memory data,
                  uint256 weiValue,
                  string memory errorMessage
              ) private returns (bytes memory) {
                  require(isContract(target), "Address: call to non-contract");
          
                  // solhint-disable-next-line avoid-low-level-calls
                  (bool success, bytes memory returndata) = target.call{
                      value: weiValue
                  }(data);
                  if (success) {
                      return returndata;
                  } else {
                      // Look for revert reason and bubble it up if present
                      if (returndata.length > 0) {
                          // The easiest way to bubble the revert reason is using memory via assembly
          
                          // solhint-disable-next-line no-inline-assembly
                          assembly {
                              let returndata_size := mload(returndata)
                              revert(add(32, returndata), returndata_size)
                          }
                      } else {
                          revert(errorMessage);
                      }
                  }
              }
          }
          
          // File: @openzeppelin/contracts/token/ERC20/SafeERC20.sol
          
          pragma solidity ^0.6.0;
          
          /**
           * @title SafeERC20
           * @dev Wrappers around ERC20 operations that throw on failure (when the token
           * contract returns false). Tokens that return no value (and instead revert or
           * throw on failure) are also supported, non-reverting calls are assumed to be
           * successful.
           * To use this library you can add a `using SafeERC20 for IERC20;` statement to your contract,
           * which allows you to call the safe operations as `token.safeTransfer(...)`, etc.
           */
          library SafeERC20 {
              using SafeMath for uint256;
              using Address for address;
          
              function safeTransfer(
                  IERC20 token,
                  address to,
                  uint256 value
              ) internal {
                  _callOptionalReturn(
                      token,
                      abi.encodeWithSelector(token.transfer.selector, to, value)
                  );
              }
          
              function safeTransferFrom(
                  IERC20 token,
                  address from,
                  address to,
                  uint256 value
              ) internal {
                  _callOptionalReturn(
                      token,
                      abi.encodeWithSelector(token.transferFrom.selector, from, to, value)
                  );
              }
          
              /**
               * @dev Deprecated. This function has issues similar to the ones found in
               * {IERC20-approve}, and its usage is discouraged.
               *
               * Whenever possible, use {safeIncreaseAllowance} and
               * {safeDecreaseAllowance} instead.
               */
              function safeApprove(
                  IERC20 token,
                  address spender,
                  uint256 value
              ) internal {
                  // safeApprove should only be called when setting an initial allowance,
                  // or when resetting it to zero. To increase and decrease it, use
                  // 'safeIncreaseAllowance' and 'safeDecreaseAllowance'
                  // solhint-disable-next-line max-line-length
                  require(
                      (value == 0) || (token.allowance(address(this), spender) == 0),
                      "SafeERC20: approve from non-zero to non-zero allowance"
                  );
                  _callOptionalReturn(
                      token,
                      abi.encodeWithSelector(token.approve.selector, spender, value)
                  );
              }
          
              function safeIncreaseAllowance(
                  IERC20 token,
                  address spender,
                  uint256 value
              ) internal {
                  uint256 newAllowance = token.allowance(address(this), spender).add(
                      value
                  );
                  _callOptionalReturn(
                      token,
                      abi.encodeWithSelector(
                          token.approve.selector,
                          spender,
                          newAllowance
                      )
                  );
              }
          
              function safeDecreaseAllowance(
                  IERC20 token,
                  address spender,
                  uint256 value
              ) internal {
                  uint256 newAllowance = token.allowance(address(this), spender).sub(
                      value,
                      "SafeERC20: decreased allowance below zero"
                  );
                  _callOptionalReturn(
                      token,
                      abi.encodeWithSelector(
                          token.approve.selector,
                          spender,
                          newAllowance
                      )
                  );
              }
          
              /**
               * @dev Imitates a Solidity high-level call (i.e. a regular function call to a contract), relaxing the requirement
               * on the return value: the return value is optional (but if data is returned, it must not be false).
               * @param token The token targeted by the call.
               * @param data The call data (encoded using abi.encode or one of its variants).
               */
              function _callOptionalReturn(IERC20 token, bytes memory data) private {
                  // We need to perform a low level call here, to bypass Solidity's return data size checking mechanism, since
                  // we're implementing it ourselves. We use {Address.functionCall} to perform this call, which verifies that
                  // the target address contains contract code and also asserts for success in the low-level call.
          
                  bytes memory returndata = address(token).functionCall(
                      data,
                      "SafeERC20: low-level call failed"
                  );
                  if (returndata.length > 0) {
                      // Return data is optional
                      // solhint-disable-next-line max-line-length
                      require(
                          abi.decode(returndata, (bool)),
                          "SafeERC20: ERC20 operation did not succeed"
                      );
                  }
              }
          }
          
          // File: contracts/v1.1/Rescuable.sol
          
          /**
           * Copyright (c) 2018-2020 CENTRE SECZ
           *
           * Permission is hereby granted, free of charge, to any person obtaining a copy
           * of this software and associated documentation files (the "Software"), to deal
           * in the Software without restriction, including without limitation the rights
           * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
           * copies of the Software, and to permit persons to whom the Software is
           * furnished to do so, subject to the following conditions:
           *
           * The above copyright notice and this permission notice shall be included in
           * copies or substantial portions of the Software.
           *
           * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
           * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
           * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
           * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
           * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
           * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
           * SOFTWARE.
           */
          
          pragma solidity 0.6.12;
          
          contract Rescuable is Ownable {
              using SafeERC20 for IERC20;
          
              address private _rescuer;
          
              event RescuerChanged(address indexed newRescuer);
          
              /**
               * @notice Returns current rescuer
               * @return Rescuer's address
               */
              function rescuer() external view returns (address) {
                  return _rescuer;
              }
          
              /**
               * @notice Revert if called by any account other than the rescuer.
               */
              modifier onlyRescuer() {
                  require(msg.sender == _rescuer, "Rescuable: caller is not the rescuer");
                  _;
              }
          
              /**
               * @notice Rescue ERC20 tokens locked up in this contract.
               * @param tokenContract ERC20 token contract address
               * @param to        Recipient address
               * @param amount    Amount to withdraw
               */
              function rescueERC20(
                  IERC20 tokenContract,
                  address to,
                  uint256 amount
              ) external onlyRescuer {
                  tokenContract.safeTransfer(to, amount);
              }
          
              /**
               * @notice Assign the rescuer role to a given address.
               * @param newRescuer New rescuer's address
               */
              function updateRescuer(address newRescuer) external onlyOwner {
                  require(
                      newRescuer != address(0),
                      "Rescuable: new rescuer is the zero address"
                  );
                  _rescuer = newRescuer;
                  emit RescuerChanged(newRescuer);
              }
          }
          
          // File: contracts/v1.1/FiatTokenV1_1.sol
          
          /**
           * Copyright (c) 2018-2020 CENTRE SECZ
           *
           * Permission is hereby granted, free of charge, to any person obtaining a copy
           * of this software and associated documentation files (the "Software"), to deal
           * in the Software without restriction, including without limitation the rights
           * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
           * copies of the Software, and to permit persons to whom the Software is
           * furnished to do so, subject to the following conditions:
           *
           * The above copyright notice and this permission notice shall be included in
           * copies or substantial portions of the Software.
           *
           * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
           * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
           * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
           * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
           * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
           * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
           * SOFTWARE.
           */
          
          pragma solidity 0.6.12;
          
          /**
           * @title FiatTokenV1_1
           * @dev ERC20 Token backed by fiat reserves
           */
          contract FiatTokenV1_1 is FiatTokenV1, Rescuable {
          
          }
          
          // File: contracts/v2/AbstractFiatTokenV2.sol
          
          /**
           * Copyright (c) 2018-2020 CENTRE SECZ
           *
           * Permission is hereby granted, free of charge, to any person obtaining a copy
           * of this software and associated documentation files (the "Software"), to deal
           * in the Software without restriction, including without limitation the rights
           * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
           * copies of the Software, and to permit persons to whom the Software is
           * furnished to do so, subject to the following conditions:
           *
           * The above copyright notice and this permission notice shall be included in
           * copies or substantial portions of the Software.
           *
           * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
           * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
           * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
           * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
           * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
           * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
           * SOFTWARE.
           */
          
          pragma solidity 0.6.12;
          
          abstract contract AbstractFiatTokenV2 is AbstractFiatTokenV1 {
              function _increaseAllowance(
                  address owner,
                  address spender,
                  uint256 increment
              ) internal virtual;
          
              function _decreaseAllowance(
                  address owner,
                  address spender,
                  uint256 decrement
              ) internal virtual;
          }
          
          // File: contracts/util/ECRecover.sol
          
          /**
           * Copyright (c) 2016-2019 zOS Global Limited
           * Copyright (c) 2018-2020 CENTRE SECZ
           *
           * Permission is hereby granted, free of charge, to any person obtaining a copy
           * of this software and associated documentation files (the "Software"), to deal
           * in the Software without restriction, including without limitation the rights
           * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
           * copies of the Software, and to permit persons to whom the Software is
           * furnished to do so, subject to the following conditions:
           *
           * The above copyright notice and this permission notice shall be included in
           * copies or substantial portions of the Software.
           *
           * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
           * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
           * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
           * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
           * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
           * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
           * SOFTWARE.
           */
          
          pragma solidity 0.6.12;
          
          /**
           * @title ECRecover
           * @notice A library that provides a safe ECDSA recovery function
           */
          library ECRecover {
              /**
               * @notice Recover signer's address from a signed message
               * @dev Adapted from: https://github.com/OpenZeppelin/openzeppelin-contracts/blob/65e4ffde586ec89af3b7e9140bdc9235d1254853/contracts/cryptography/ECDSA.sol
               * Modifications: Accept v, r, and s as separate arguments
               * @param digest    Keccak-256 hash digest of the signed message
               * @param v         v of the signature
               * @param r         r of the signature
               * @param s         s of the signature
               * @return Signer address
               */
              function recover(
                  bytes32 digest,
                  uint8 v,
                  bytes32 r,
                  bytes32 s
              ) internal pure returns (address) {
                  // EIP-2 still allows signature malleability for ecrecover(). Remove this possibility and make the signature
                  // unique. Appendix F in the Ethereum Yellow paper (https://ethereum.github.io/yellowpaper/paper.pdf), defines
                  // the valid range for s in (281): 0 < s < secp256k1n ÷ 2 + 1, and for v in (282): v ∈ {27, 28}. Most
                  // signatures from current libraries generate a unique signature with an s-value in the lower half order.
                  //
                  // If your library generates malleable signatures, such as s-values in the upper range, calculate a new s-value
                  // with 0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFEBAAEDCE6AF48A03BBFD25E8CD0364141 - s1 and flip v from 27 to 28 or
                  // vice versa. If your library also generates signatures with 0/1 for v instead 27/28, add 27 to v to accept
                  // these malleable signatures as well.
                  if (
                      uint256(s) >
                      0x7FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF5D576E7357A4501DDFE92F46681B20A0
                  ) {
                      revert("ECRecover: invalid signature 's' value");
                  }
          
                  if (v != 27 && v != 28) {
                      revert("ECRecover: invalid signature 'v' value");
                  }
          
                  // If the signature is valid (and not malleable), return the signer address
                  address signer = ecrecover(digest, v, r, s);
                  require(signer != address(0), "ECRecover: invalid signature");
          
                  return signer;
              }
          }
          
          // File: contracts/util/EIP712.sol
          
          /**
           * Copyright (c) 2018-2020 CENTRE SECZ
           *
           * Permission is hereby granted, free of charge, to any person obtaining a copy
           * of this software and associated documentation files (the "Software"), to deal
           * in the Software without restriction, including without limitation the rights
           * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
           * copies of the Software, and to permit persons to whom the Software is
           * furnished to do so, subject to the following conditions:
           *
           * The above copyright notice and this permission notice shall be included in
           * copies or substantial portions of the Software.
           *
           * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
           * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
           * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
           * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
           * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
           * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
           * SOFTWARE.
           */
          
          pragma solidity 0.6.12;
          
          /**
           * @title EIP712
           * @notice A library that provides EIP712 helper functions
           */
          library EIP712 {
              /**
               * @notice Make EIP712 domain separator
               * @param name      Contract name
               * @param version   Contract version
               * @return Domain separator
               */
              function makeDomainSeparator(string memory name, string memory version)
                  internal
                  view
                  returns (bytes32)
              {
                  uint256 chainId;
                  assembly {
                      chainId := chainid()
                  }
                  return
                      keccak256(
                          abi.encode(
                              // keccak256("EIP712Domain(string name,string version,uint256 chainId,address verifyingContract)")
                              0x8b73c3c69bb8fe3d512ecc4cf759cc79239f7b179b0ffacaa9a75d522b39400f,
                              keccak256(bytes(name)),
                              keccak256(bytes(version)),
                              chainId,
                              address(this)
                          )
                      );
              }
          
              /**
               * @notice Recover signer's address from a EIP712 signature
               * @param domainSeparator   Domain separator
               * @param v                 v of the signature
               * @param r                 r of the signature
               * @param s                 s of the signature
               * @param typeHashAndData   Type hash concatenated with data
               * @return Signer's address
               */
              function recover(
                  bytes32 domainSeparator,
                  uint8 v,
                  bytes32 r,
                  bytes32 s,
                  bytes memory typeHashAndData
              ) internal pure returns (address) {
                  bytes32 digest = keccak256(
                      abi.encodePacked(
                          "\x19\x01",
                          domainSeparator,
                          keccak256(typeHashAndData)
                      )
                  );
                  return ECRecover.recover(digest, v, r, s);
              }
          }
          
          // File: contracts/v2/EIP712Domain.sol
          
          /**
           * Copyright (c) 2018-2020 CENTRE SECZ
           *
           * Permission is hereby granted, free of charge, to any person obtaining a copy
           * of this software and associated documentation files (the "Software"), to deal
           * in the Software without restriction, including without limitation the rights
           * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
           * copies of the Software, and to permit persons to whom the Software is
           * furnished to do so, subject to the following conditions:
           *
           * The above copyright notice and this permission notice shall be included in
           * copies or substantial portions of the Software.
           *
           * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
           * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
           * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
           * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
           * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
           * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
           * SOFTWARE.
           */
          
          pragma solidity 0.6.12;
          
          /**
           * @title EIP712 Domain
           */
          contract EIP712Domain {
              /**
               * @dev EIP712 Domain Separator
               */
              bytes32 public DOMAIN_SEPARATOR;
          }
          
          // File: contracts/v2/EIP3009.sol
          
          /**
           * Copyright (c) 2018-2020 CENTRE SECZ
           *
           * Permission is hereby granted, free of charge, to any person obtaining a copy
           * of this software and associated documentation files (the "Software"), to deal
           * in the Software without restriction, including without limitation the rights
           * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
           * copies of the Software, and to permit persons to whom the Software is
           * furnished to do so, subject to the following conditions:
           *
           * The above copyright notice and this permission notice shall be included in
           * copies or substantial portions of the Software.
           *
           * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
           * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
           * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
           * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
           * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
           * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
           * SOFTWARE.
           */
          
          pragma solidity 0.6.12;
          
          /**
           * @title EIP-3009
           * @notice Provide internal implementation for gas-abstracted transfers
           * @dev Contracts that inherit from this must wrap these with publicly
           * accessible functions, optionally adding modifiers where necessary
           */
          abstract contract EIP3009 is AbstractFiatTokenV2, EIP712Domain {
              // keccak256("TransferWithAuthorization(address from,address to,uint256 value,uint256 validAfter,uint256 validBefore,bytes32 nonce)")
              bytes32
                  public constant TRANSFER_WITH_AUTHORIZATION_TYPEHASH = 0x7c7c6cdb67a18743f49ec6fa9b35f50d52ed05cbed4cc592e13b44501c1a2267;
          
              // keccak256("ReceiveWithAuthorization(address from,address to,uint256 value,uint256 validAfter,uint256 validBefore,bytes32 nonce)")
              bytes32
                  public constant RECEIVE_WITH_AUTHORIZATION_TYPEHASH = 0xd099cc98ef71107a616c4f0f941f04c322d8e254fe26b3c6668db87aae413de8;
          
              // keccak256("CancelAuthorization(address authorizer,bytes32 nonce)")
              bytes32
                  public constant CANCEL_AUTHORIZATION_TYPEHASH = 0x158b0a9edf7a828aad02f63cd515c68ef2f50ba807396f6d12842833a1597429;
          
              /**
               * @dev authorizer address => nonce => bool (true if nonce is used)
               */
              mapping(address => mapping(bytes32 => bool)) private _authorizationStates;
          
              event AuthorizationUsed(address indexed authorizer, bytes32 indexed nonce);
              event AuthorizationCanceled(
                  address indexed authorizer,
                  bytes32 indexed nonce
              );
          
              /**
               * @notice Returns the state of an authorization
               * @dev Nonces are randomly generated 32-byte data unique to the
               * authorizer's address
               * @param authorizer    Authorizer's address
               * @param nonce         Nonce of the authorization
               * @return True if the nonce is used
               */
              function authorizationState(address authorizer, bytes32 nonce)
                  external
                  view
                  returns (bool)
              {
                  return _authorizationStates[authorizer][nonce];
              }
          
              /**
               * @notice Execute a transfer with a signed authorization
               * @param from          Payer's address (Authorizer)
               * @param to            Payee's address
               * @param value         Amount to be transferred
               * @param validAfter    The time after which this is valid (unix time)
               * @param validBefore   The time before which this is valid (unix time)
               * @param nonce         Unique nonce
               * @param v             v of the signature
               * @param r             r of the signature
               * @param s             s of the signature
               */
              function _transferWithAuthorization(
                  address from,
                  address to,
                  uint256 value,
                  uint256 validAfter,
                  uint256 validBefore,
                  bytes32 nonce,
                  uint8 v,
                  bytes32 r,
                  bytes32 s
              ) internal {
                  _requireValidAuthorization(from, nonce, validAfter, validBefore);
          
                  bytes memory data = abi.encode(
                      TRANSFER_WITH_AUTHORIZATION_TYPEHASH,
                      from,
                      to,
                      value,
                      validAfter,
                      validBefore,
                      nonce
                  );
                  require(
                      EIP712.recover(DOMAIN_SEPARATOR, v, r, s, data) == from,
                      "FiatTokenV2: invalid signature"
                  );
          
                  _markAuthorizationAsUsed(from, nonce);
                  _transfer(from, to, value);
              }
          
              /**
               * @notice Receive a transfer with a signed authorization from the payer
               * @dev This has an additional check to ensure that the payee's address
               * matches the caller of this function to prevent front-running attacks.
               * @param from          Payer's address (Authorizer)
               * @param to            Payee's address
               * @param value         Amount to be transferred
               * @param validAfter    The time after which this is valid (unix time)
               * @param validBefore   The time before which this is valid (unix time)
               * @param nonce         Unique nonce
               * @param v             v of the signature
               * @param r             r of the signature
               * @param s             s of the signature
               */
              function _receiveWithAuthorization(
                  address from,
                  address to,
                  uint256 value,
                  uint256 validAfter,
                  uint256 validBefore,
                  bytes32 nonce,
                  uint8 v,
                  bytes32 r,
                  bytes32 s
              ) internal {
                  require(to == msg.sender, "FiatTokenV2: caller must be the payee");
                  _requireValidAuthorization(from, nonce, validAfter, validBefore);
          
                  bytes memory data = abi.encode(
                      RECEIVE_WITH_AUTHORIZATION_TYPEHASH,
                      from,
                      to,
                      value,
                      validAfter,
                      validBefore,
                      nonce
                  );
                  require(
                      EIP712.recover(DOMAIN_SEPARATOR, v, r, s, data) == from,
                      "FiatTokenV2: invalid signature"
                  );
          
                  _markAuthorizationAsUsed(from, nonce);
                  _transfer(from, to, value);
              }
          
              /**
               * @notice Attempt to cancel an authorization
               * @param authorizer    Authorizer's address
               * @param nonce         Nonce of the authorization
               * @param v             v of the signature
               * @param r             r of the signature
               * @param s             s of the signature
               */
              function _cancelAuthorization(
                  address authorizer,
                  bytes32 nonce,
                  uint8 v,
                  bytes32 r,
                  bytes32 s
              ) internal {
                  _requireUnusedAuthorization(authorizer, nonce);
          
                  bytes memory data = abi.encode(
                      CANCEL_AUTHORIZATION_TYPEHASH,
                      authorizer,
                      nonce
                  );
                  require(
                      EIP712.recover(DOMAIN_SEPARATOR, v, r, s, data) == authorizer,
                      "FiatTokenV2: invalid signature"
                  );
          
                  _authorizationStates[authorizer][nonce] = true;
                  emit AuthorizationCanceled(authorizer, nonce);
              }
          
              /**
               * @notice Check that an authorization is unused
               * @param authorizer    Authorizer's address
               * @param nonce         Nonce of the authorization
               */
              function _requireUnusedAuthorization(address authorizer, bytes32 nonce)
                  private
                  view
              {
                  require(
                      !_authorizationStates[authorizer][nonce],
                      "FiatTokenV2: authorization is used or canceled"
                  );
              }
          
              /**
               * @notice Check that authorization is valid
               * @param authorizer    Authorizer's address
               * @param nonce         Nonce of the authorization
               * @param validAfter    The time after which this is valid (unix time)
               * @param validBefore   The time before which this is valid (unix time)
               */
              function _requireValidAuthorization(
                  address authorizer,
                  bytes32 nonce,
                  uint256 validAfter,
                  uint256 validBefore
              ) private view {
                  require(
                      now > validAfter,
                      "FiatTokenV2: authorization is not yet valid"
                  );
                  require(now < validBefore, "FiatTokenV2: authorization is expired");
                  _requireUnusedAuthorization(authorizer, nonce);
              }
          
              /**
               * @notice Mark an authorization as used
               * @param authorizer    Authorizer's address
               * @param nonce         Nonce of the authorization
               */
              function _markAuthorizationAsUsed(address authorizer, bytes32 nonce)
                  private
              {
                  _authorizationStates[authorizer][nonce] = true;
                  emit AuthorizationUsed(authorizer, nonce);
              }
          }
          
          // File: contracts/v2/EIP2612.sol
          
          /**
           * Copyright (c) 2018-2020 CENTRE SECZ
           *
           * Permission is hereby granted, free of charge, to any person obtaining a copy
           * of this software and associated documentation files (the "Software"), to deal
           * in the Software without restriction, including without limitation the rights
           * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
           * copies of the Software, and to permit persons to whom the Software is
           * furnished to do so, subject to the following conditions:
           *
           * The above copyright notice and this permission notice shall be included in
           * copies or substantial portions of the Software.
           *
           * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
           * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
           * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
           * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
           * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
           * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
           * SOFTWARE.
           */
          
          pragma solidity 0.6.12;
          
          /**
           * @title EIP-2612
           * @notice Provide internal implementation for gas-abstracted approvals
           */
          abstract contract EIP2612 is AbstractFiatTokenV2, EIP712Domain {
              // keccak256("Permit(address owner,address spender,uint256 value,uint256 nonce,uint256 deadline)")
              bytes32
                  public constant PERMIT_TYPEHASH = 0x6e71edae12b1b97f4d1f60370fef10105fa2faae0126114a169c64845d6126c9;
          
              mapping(address => uint256) private _permitNonces;
          
              /**
               * @notice Nonces for permit
               * @param owner Token owner's address (Authorizer)
               * @return Next nonce
               */
              function nonces(address owner) external view returns (uint256) {
                  return _permitNonces[owner];
              }
          
              /**
               * @notice Verify a signed approval permit and execute if valid
               * @param owner     Token owner's address (Authorizer)
               * @param spender   Spender's address
               * @param value     Amount of allowance
               * @param deadline  The time at which this expires (unix time)
               * @param v         v of the signature
               * @param r         r of the signature
               * @param s         s of the signature
               */
              function _permit(
                  address owner,
                  address spender,
                  uint256 value,
                  uint256 deadline,
                  uint8 v,
                  bytes32 r,
                  bytes32 s
              ) internal {
                  require(deadline >= now, "FiatTokenV2: permit is expired");
          
                  bytes memory data = abi.encode(
                      PERMIT_TYPEHASH,
                      owner,
                      spender,
                      value,
                      _permitNonces[owner]++,
                      deadline
                  );
                  require(
                      EIP712.recover(DOMAIN_SEPARATOR, v, r, s, data) == owner,
                      "EIP2612: invalid signature"
                  );
          
                  _approve(owner, spender, value);
              }
          }
          
          // File: contracts/v2/FiatTokenV2.sol
          
          /**
           * Copyright (c) 2018-2020 CENTRE SECZ
           *
           * Permission is hereby granted, free of charge, to any person obtaining a copy
           * of this software and associated documentation files (the "Software"), to deal
           * in the Software without restriction, including without limitation the rights
           * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
           * copies of the Software, and to permit persons to whom the Software is
           * furnished to do so, subject to the following conditions:
           *
           * The above copyright notice and this permission notice shall be included in
           * copies or substantial portions of the Software.
           *
           * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
           * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
           * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
           * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
           * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
           * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
           * SOFTWARE.
           */
          
          pragma solidity 0.6.12;
          
          /**
           * @title FiatToken V2
           * @notice ERC20 Token backed by fiat reserves, version 2
           */
          contract FiatTokenV2 is FiatTokenV1_1, EIP3009, EIP2612 {
              uint8 internal _initializedVersion;
          
              /**
               * @notice Initialize v2
               * @param newName   New token name
               */
              function initializeV2(string calldata newName) external {
                  // solhint-disable-next-line reason-string
                  require(initialized && _initializedVersion == 0);
                  name = newName;
                  DOMAIN_SEPARATOR = EIP712.makeDomainSeparator(newName, "2");
                  _initializedVersion = 1;
              }
          
              /**
               * @notice Increase the allowance by a given increment
               * @param spender   Spender's address
               * @param increment Amount of increase in allowance
               * @return True if successful
               */
              function increaseAllowance(address spender, uint256 increment)
                  external
                  whenNotPaused
                  notBlacklisted(msg.sender)
                  notBlacklisted(spender)
                  returns (bool)
              {
                  _increaseAllowance(msg.sender, spender, increment);
                  return true;
              }
          
              /**
               * @notice Decrease the allowance by a given decrement
               * @param spender   Spender's address
               * @param decrement Amount of decrease in allowance
               * @return True if successful
               */
              function decreaseAllowance(address spender, uint256 decrement)
                  external
                  whenNotPaused
                  notBlacklisted(msg.sender)
                  notBlacklisted(spender)
                  returns (bool)
              {
                  _decreaseAllowance(msg.sender, spender, decrement);
                  return true;
              }
          
              /**
               * @notice Execute a transfer with a signed authorization
               * @param from          Payer's address (Authorizer)
               * @param to            Payee's address
               * @param value         Amount to be transferred
               * @param validAfter    The time after which this is valid (unix time)
               * @param validBefore   The time before which this is valid (unix time)
               * @param nonce         Unique nonce
               * @param v             v of the signature
               * @param r             r of the signature
               * @param s             s of the signature
               */
              function transferWithAuthorization(
                  address from,
                  address to,
                  uint256 value,
                  uint256 validAfter,
                  uint256 validBefore,
                  bytes32 nonce,
                  uint8 v,
                  bytes32 r,
                  bytes32 s
              ) external whenNotPaused notBlacklisted(from) notBlacklisted(to) {
                  _transferWithAuthorization(
                      from,
                      to,
                      value,
                      validAfter,
                      validBefore,
                      nonce,
                      v,
                      r,
                      s
                  );
              }
          
              /**
               * @notice Receive a transfer with a signed authorization from the payer
               * @dev This has an additional check to ensure that the payee's address
               * matches the caller of this function to prevent front-running attacks.
               * @param from          Payer's address (Authorizer)
               * @param to            Payee's address
               * @param value         Amount to be transferred
               * @param validAfter    The time after which this is valid (unix time)
               * @param validBefore   The time before which this is valid (unix time)
               * @param nonce         Unique nonce
               * @param v             v of the signature
               * @param r             r of the signature
               * @param s             s of the signature
               */
              function receiveWithAuthorization(
                  address from,
                  address to,
                  uint256 value,
                  uint256 validAfter,
                  uint256 validBefore,
                  bytes32 nonce,
                  uint8 v,
                  bytes32 r,
                  bytes32 s
              ) external whenNotPaused notBlacklisted(from) notBlacklisted(to) {
                  _receiveWithAuthorization(
                      from,
                      to,
                      value,
                      validAfter,
                      validBefore,
                      nonce,
                      v,
                      r,
                      s
                  );
              }
          
              /**
               * @notice Attempt to cancel an authorization
               * @dev Works only if the authorization is not yet used.
               * @param authorizer    Authorizer's address
               * @param nonce         Nonce of the authorization
               * @param v             v of the signature
               * @param r             r of the signature
               * @param s             s of the signature
               */
              function cancelAuthorization(
                  address authorizer,
                  bytes32 nonce,
                  uint8 v,
                  bytes32 r,
                  bytes32 s
              ) external whenNotPaused {
                  _cancelAuthorization(authorizer, nonce, v, r, s);
              }
          
              /**
               * @notice Update allowance with a signed permit
               * @param owner       Token owner's address (Authorizer)
               * @param spender     Spender's address
               * @param value       Amount of allowance
               * @param deadline    Expiration time, seconds since the epoch
               * @param v           v of the signature
               * @param r           r of the signature
               * @param s           s of the signature
               */
              function permit(
                  address owner,
                  address spender,
                  uint256 value,
                  uint256 deadline,
                  uint8 v,
                  bytes32 r,
                  bytes32 s
              ) external whenNotPaused notBlacklisted(owner) notBlacklisted(spender) {
                  _permit(owner, spender, value, deadline, v, r, s);
              }
          
              /**
               * @notice Internal function to increase the allowance by a given increment
               * @param owner     Token owner's address
               * @param spender   Spender's address
               * @param increment Amount of increase
               */
              function _increaseAllowance(
                  address owner,
                  address spender,
                  uint256 increment
              ) internal override {
                  _approve(owner, spender, allowed[owner][spender].add(increment));
              }
          
              /**
               * @notice Internal function to decrease the allowance by a given decrement
               * @param owner     Token owner's address
               * @param spender   Spender's address
               * @param decrement Amount of decrease
               */
              function _decreaseAllowance(
                  address owner,
                  address spender,
                  uint256 decrement
              ) internal override {
                  _approve(
                      owner,
                      spender,
                      allowed[owner][spender].sub(
                          decrement,
                          "ERC20: decreased allowance below zero"
                      )
                  );
              }
          }
          
          // File: contracts/v2/FiatTokenV2_1.sol
          
          /**
           * Copyright (c) 2018-2020 CENTRE SECZ
           *
           * Permission is hereby granted, free of charge, to any person obtaining a copy
           * of this software and associated documentation files (the "Software"), to deal
           * in the Software without restriction, including without limitation the rights
           * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
           * copies of the Software, and to permit persons to whom the Software is
           * furnished to do so, subject to the following conditions:
           *
           * The above copyright notice and this permission notice shall be included in
           * copies or substantial portions of the Software.
           *
           * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
           * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
           * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
           * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
           * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
           * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
           * SOFTWARE.
           */
          
          pragma solidity 0.6.12;
          
          // solhint-disable func-name-mixedcase
          
          /**
           * @title FiatToken V2.1
           * @notice ERC20 Token backed by fiat reserves, version 2.1
           */
          contract FiatTokenV2_1 is FiatTokenV2 {
              /**
               * @notice Initialize v2.1
               * @param lostAndFound  The address to which the locked funds are sent
               */
              function initializeV2_1(address lostAndFound) external {
                  // solhint-disable-next-line reason-string
                  require(_initializedVersion == 1);
          
                  uint256 lockedAmount = balances[address(this)];
                  if (lockedAmount > 0) {
                      _transfer(address(this), lostAndFound, lockedAmount);
                  }
                  blacklisted[address(this)] = true;
          
                  _initializedVersion = 2;
              }
          
              /**
               * @notice Version string for the EIP712 domain separator
               * @return Version string
               */
              function version() external view returns (string memory) {
                  return "2";
              }
          }

          File 5 of 6: PolygonMessengerWrapper
          // SPDX-License-Identifier: MIT
          // @unsupported: ovm
          pragma solidity 0.8.9;
          pragma experimental ABIEncoderV2;
          import "../polygon/tunnel/FxBaseRootTunnel.sol";
          import "./MessengerWrapper.sol";
          /**
           * @dev A MessengerWrapper for Polygon - https://docs.matic.network/docs
           * @notice Deployed on layer-1
           */
          contract PolygonMessengerWrapper is FxBaseRootTunnel, MessengerWrapper {
              constructor(
                  address _l1BridgeAddress,
                  address _checkpointManager,
                  address _fxRoot,
                  address _fxChildTunnel
              )
                  public
                  MessengerWrapper(_l1BridgeAddress)
                  FxBaseRootTunnel(_checkpointManager, _fxRoot)
              {
                  setFxChildTunnel(_fxChildTunnel);
              }
              /** 
               * @dev Sends a message to the l2MessengerProxy from layer-1
               * @param _calldata The data that l2MessengerProxy will be called with
               * @notice The msg.sender is sent to the L2_PolygonMessengerProxy and checked there.
               */
              function sendCrossDomainMessage(bytes memory _calldata) public override {
                  _sendMessageToChild(
                      abi.encode(msg.sender, _calldata)
                  );
              }
              function verifySender(address l1BridgeCaller, bytes memory /*_data*/) public view override {
                  require(l1BridgeCaller == address(this), "L1_PLGN_WPR: Caller must be this contract");
              }
              function _processMessageFromChild(bytes memory message) internal override {
                  (bool success,) = l1BridgeAddress.call(message);
                  require(success, "L1_PLGN_WPR: Call to L1 Bridge failed");
              }
          }
          // SPDX-License-Identifier: MIT
          pragma solidity ^0.8.0;
          import {RLPReader} from "../lib/RLPReader.sol";
          import {MerklePatriciaProof} from "../lib/MerklePatriciaProof.sol";
          import {Merkle} from "../lib/Merkle.sol";
          import "../lib/ExitPayloadReader.sol";
          interface IFxStateSender {
              function sendMessageToChild(address _receiver, bytes calldata _data) external;
          }
          contract ICheckpointManager {
              struct HeaderBlock {
                  bytes32 root;
                  uint256 start;
                  uint256 end;
                  uint256 createdAt;
                  address proposer;
              }
              /**
               * @notice mapping of checkpoint header numbers to block details
               * @dev These checkpoints are submited by plasma contracts
               */
              mapping(uint256 => HeaderBlock) public headerBlocks;
          }
          abstract contract FxBaseRootTunnel {
              using RLPReader for RLPReader.RLPItem;
              using Merkle for bytes32;
              using ExitPayloadReader for bytes;
              using ExitPayloadReader for ExitPayloadReader.ExitPayload;
              using ExitPayloadReader for ExitPayloadReader.Log;
              using ExitPayloadReader for ExitPayloadReader.LogTopics;
              using ExitPayloadReader for ExitPayloadReader.Receipt;
              // keccak256(MessageSent(bytes))
              bytes32 public constant SEND_MESSAGE_EVENT_SIG = 0x8c5261668696ce22758910d05bab8f186d6eb247ceac2af2e82c7dc17669b036;
              // state sender contract
              IFxStateSender public fxRoot;
              // root chain manager
              ICheckpointManager public checkpointManager;
              // child tunnel contract which receives and sends messages
              address public fxChildTunnel;
              // storage to avoid duplicate exits
              mapping(bytes32 => bool) public processedExits;
              constructor(address _checkpointManager, address _fxRoot) {
                  checkpointManager = ICheckpointManager(_checkpointManager);
                  fxRoot = IFxStateSender(_fxRoot);
              }
              // set fxChildTunnel if not set already
              function setFxChildTunnel(address _fxChildTunnel) public {
                  require(fxChildTunnel == address(0x0), "FxBaseRootTunnel: CHILD_TUNNEL_ALREADY_SET");
                  fxChildTunnel = _fxChildTunnel;
              }
              /**
               * @notice Send bytes message to Child Tunnel
               * @param message bytes message that will be sent to Child Tunnel
               * some message examples -
               *   abi.encode(tokenId);
               *   abi.encode(tokenId, tokenMetadata);
               *   abi.encode(messageType, messageData);
               */
              function _sendMessageToChild(bytes memory message) internal {
                  fxRoot.sendMessageToChild(fxChildTunnel, message);
              }
              function _validateAndExtractMessage(bytes memory inputData) internal returns (bytes memory) {
                  ExitPayloadReader.ExitPayload memory payload = inputData.toExitPayload();
                  bytes memory branchMaskBytes = payload.getBranchMaskAsBytes();
                  uint256 blockNumber = payload.getBlockNumber();
                  // checking if exit has already been processed
                  // unique exit is identified using hash of (blockNumber, branchMask, receiptLogIndex)
                  bytes32 exitHash = keccak256(
                      abi.encodePacked(
                          blockNumber,
                          // first 2 nibbles are dropped while generating nibble array
                          // this allows branch masks that are valid but bypass exitHash check (changing first 2 nibbles only)
                          // so converting to nibble array and then hashing it
                          MerklePatriciaProof._getNibbleArray(branchMaskBytes),
                          payload.getReceiptLogIndex()
                      )
                  );
                  require(processedExits[exitHash] == false, "FxRootTunnel: EXIT_ALREADY_PROCESSED");
                  processedExits[exitHash] = true;
                  ExitPayloadReader.Receipt memory receipt = payload.getReceipt();
                  ExitPayloadReader.Log memory log = receipt.getLog();
                  // check child tunnel
                  require(fxChildTunnel == log.getEmitter(), "FxRootTunnel: INVALID_FX_CHILD_TUNNEL");
                  bytes32 receiptRoot = payload.getReceiptRoot();
                  // verify receipt inclusion
                  require(
                      MerklePatriciaProof.verify(receipt.toBytes(), branchMaskBytes, payload.getReceiptProof(), receiptRoot),
                      "FxRootTunnel: INVALID_RECEIPT_PROOF"
                  );
                  // verify checkpoint inclusion
                  _checkBlockMembershipInCheckpoint(
                      blockNumber,
                      payload.getBlockTime(),
                      payload.getTxRoot(),
                      receiptRoot,
                      payload.getHeaderNumber(),
                      payload.getBlockProof()
                  );
                  ExitPayloadReader.LogTopics memory topics = log.getTopics();
                  require(
                      bytes32(topics.getField(0).toUint()) == SEND_MESSAGE_EVENT_SIG, // topic0 is event sig
                      "FxRootTunnel: INVALID_SIGNATURE"
                  );
                  // received message data
                  bytes memory message = abi.decode(log.getData(), (bytes)); // event decodes params again, so decoding bytes to get message
                  return message;
              }
              function _checkBlockMembershipInCheckpoint(
                  uint256 blockNumber,
                  uint256 blockTime,
                  bytes32 txRoot,
                  bytes32 receiptRoot,
                  uint256 headerNumber,
                  bytes memory blockProof
              ) private view returns (uint256) {
                  (bytes32 headerRoot, uint256 startBlock, , uint256 createdAt, ) = checkpointManager.headerBlocks(headerNumber);
                  require(
                      keccak256(abi.encodePacked(blockNumber, blockTime, txRoot, receiptRoot)).checkMembership(
                          blockNumber - startBlock,
                          headerRoot,
                          blockProof
                      ),
                      "FxRootTunnel: INVALID_HEADER"
                  );
                  return createdAt;
              }
              /**
               * @notice receive message from  L2 to L1, validated by proof
               * @dev This function verifies if the transaction actually happened on child chain
               *
               * @param inputData RLP encoded data of the reference tx containing following list of fields
               *  0 - headerNumber - Checkpoint header block number containing the reference tx
               *  1 - blockProof - Proof that the block header (in the child chain) is a leaf in the submitted merkle root
               *  2 - blockNumber - Block number containing the reference tx on child chain
               *  3 - blockTime - Reference tx block time
               *  4 - txRoot - Transactions root of block
               *  5 - receiptRoot - Receipts root of block
               *  6 - receipt - Receipt of the reference transaction
               *  7 - receiptProof - Merkle proof of the reference receipt
               *  8 - branchMask - 32 bits denoting the path of receipt in merkle tree
               *  9 - receiptLogIndex - Log Index to read from the receipt
               */
              function receiveMessage(bytes memory inputData) public virtual {
                  bytes memory message = _validateAndExtractMessage(inputData);
                  _processMessageFromChild(message);
              }
              /**
               * @notice Process message received from Child Tunnel
               * @dev function needs to be implemented to handle message as per requirement
               * This is called by onStateReceive function.
               * Since it is called via a system call, any event will not be emitted during its execution.
               * @param message bytes message that was sent from Child Tunnel
               */
              function _processMessageFromChild(bytes memory message) internal virtual;
          }// SPDX-License-Identifier: MIT
          pragma solidity >=0.6.12 <=0.8.9;
          pragma experimental ABIEncoderV2;
          import "../interfaces/IMessengerWrapper.sol";
          abstract contract MessengerWrapper is IMessengerWrapper {
              address public immutable l1BridgeAddress;
              constructor(address _l1BridgeAddress) internal {
                  l1BridgeAddress = _l1BridgeAddress;
              }
              modifier onlyL1Bridge {
                  require(msg.sender == l1BridgeAddress, "MW: Sender must be the L1 Bridge");
                  _;
              }
          }
          /*
           * @author Hamdi Allam hamdi.allam97@gmail.com
           * Please reach out with any questions or concerns
           */
          pragma solidity ^0.8.0;
          library RLPReader {
              uint8 constant STRING_SHORT_START = 0x80;
              uint8 constant STRING_LONG_START = 0xb8;
              uint8 constant LIST_SHORT_START = 0xc0;
              uint8 constant LIST_LONG_START = 0xf8;
              uint8 constant WORD_SIZE = 32;
              struct RLPItem {
                  uint256 len;
                  uint256 memPtr;
              }
              struct Iterator {
                  RLPItem item; // Item that's being iterated over.
                  uint256 nextPtr; // Position of the next item in the list.
              }
              /*
               * @dev Returns the next element in the iteration. Reverts if it has not next element.
               * @param self The iterator.
               * @return The next element in the iteration.
               */
              function next(Iterator memory self) internal pure returns (RLPItem memory) {
                  require(hasNext(self));
                  uint256 ptr = self.nextPtr;
                  uint256 itemLength = _itemLength(ptr);
                  self.nextPtr = ptr + itemLength;
                  return RLPItem(itemLength, ptr);
              }
              /*
               * @dev Returns true if the iteration has more elements.
               * @param self The iterator.
               * @return true if the iteration has more elements.
               */
              function hasNext(Iterator memory self) internal pure returns (bool) {
                  RLPItem memory item = self.item;
                  return self.nextPtr < item.memPtr + item.len;
              }
              /*
               * @param item RLP encoded bytes
               */
              function toRlpItem(bytes memory item) internal pure returns (RLPItem memory) {
                  uint256 memPtr;
                  assembly {
                      memPtr := add(item, 0x20)
                  }
                  return RLPItem(item.length, memPtr);
              }
              /*
               * @dev Create an iterator. Reverts if item is not a list.
               * @param self The RLP item.
               * @return An 'Iterator' over the item.
               */
              function iterator(RLPItem memory self) internal pure returns (Iterator memory) {
                  require(isList(self));
                  uint256 ptr = self.memPtr + _payloadOffset(self.memPtr);
                  return Iterator(self, ptr);
              }
              /*
               * @param item RLP encoded bytes
               */
              function rlpLen(RLPItem memory item) internal pure returns (uint256) {
                  return item.len;
              }
              /*
               * @param item RLP encoded bytes
               */
              function payloadLen(RLPItem memory item) internal pure returns (uint256) {
                  return item.len - _payloadOffset(item.memPtr);
              }
              /*
               * @param item RLP encoded list in bytes
               */
              function toList(RLPItem memory item) internal pure returns (RLPItem[] memory) {
                  require(isList(item));
                  uint256 items = numItems(item);
                  RLPItem[] memory result = new RLPItem[](items);
                  uint256 memPtr = item.memPtr + _payloadOffset(item.memPtr);
                  uint256 dataLen;
                  for (uint256 i = 0; i < items; i++) {
                      dataLen = _itemLength(memPtr);
                      result[i] = RLPItem(dataLen, memPtr);
                      memPtr = memPtr + dataLen;
                  }
                  return result;
              }
              // @return indicator whether encoded payload is a list. negate this function call for isData.
              function isList(RLPItem memory item) internal pure returns (bool) {
                  if (item.len == 0) return false;
                  uint8 byte0;
                  uint256 memPtr = item.memPtr;
                  assembly {
                      byte0 := byte(0, mload(memPtr))
                  }
                  if (byte0 < LIST_SHORT_START) return false;
                  return true;
              }
              /*
               * @dev A cheaper version of keccak256(toRlpBytes(item)) that avoids copying memory.
               * @return keccak256 hash of RLP encoded bytes.
               */
              function rlpBytesKeccak256(RLPItem memory item) internal pure returns (bytes32) {
                  uint256 ptr = item.memPtr;
                  uint256 len = item.len;
                  bytes32 result;
                  assembly {
                      result := keccak256(ptr, len)
                  }
                  return result;
              }
              function payloadLocation(RLPItem memory item) internal pure returns (uint256, uint256) {
                  uint256 offset = _payloadOffset(item.memPtr);
                  uint256 memPtr = item.memPtr + offset;
                  uint256 len = item.len - offset; // data length
                  return (memPtr, len);
              }
              /*
               * @dev A cheaper version of keccak256(toBytes(item)) that avoids copying memory.
               * @return keccak256 hash of the item payload.
               */
              function payloadKeccak256(RLPItem memory item) internal pure returns (bytes32) {
                  (uint256 memPtr, uint256 len) = payloadLocation(item);
                  bytes32 result;
                  assembly {
                      result := keccak256(memPtr, len)
                  }
                  return result;
              }
              /** RLPItem conversions into data types **/
              // @returns raw rlp encoding in bytes
              function toRlpBytes(RLPItem memory item) internal pure returns (bytes memory) {
                  bytes memory result = new bytes(item.len);
                  if (result.length == 0) return result;
                  uint256 ptr;
                  assembly {
                      ptr := add(0x20, result)
                  }
                  copy(item.memPtr, ptr, item.len);
                  return result;
              }
              // any non-zero byte is considered true
              function toBoolean(RLPItem memory item) internal pure returns (bool) {
                  require(item.len == 1);
                  uint256 result;
                  uint256 memPtr = item.memPtr;
                  assembly {
                      result := byte(0, mload(memPtr))
                  }
                  return result == 0 ? false : true;
              }
              function toAddress(RLPItem memory item) internal pure returns (address) {
                  // 1 byte for the length prefix
                  require(item.len == 21);
                  return address(uint160(toUint(item)));
              }
              function toUint(RLPItem memory item) internal pure returns (uint256) {
                  require(item.len > 0 && item.len <= 33);
                  uint256 offset = _payloadOffset(item.memPtr);
                  uint256 len = item.len - offset;
                  uint256 result;
                  uint256 memPtr = item.memPtr + offset;
                  assembly {
                      result := mload(memPtr)
                      // shfit to the correct location if neccesary
                      if lt(len, 32) {
                          result := div(result, exp(256, sub(32, len)))
                      }
                  }
                  return result;
              }
              // enforces 32 byte length
              function toUintStrict(RLPItem memory item) internal pure returns (uint256) {
                  // one byte prefix
                  require(item.len == 33);
                  uint256 result;
                  uint256 memPtr = item.memPtr + 1;
                  assembly {
                      result := mload(memPtr)
                  }
                  return result;
              }
              function toBytes(RLPItem memory item) internal pure returns (bytes memory) {
                  require(item.len > 0);
                  uint256 offset = _payloadOffset(item.memPtr);
                  uint256 len = item.len - offset; // data length
                  bytes memory result = new bytes(len);
                  uint256 destPtr;
                  assembly {
                      destPtr := add(0x20, result)
                  }
                  copy(item.memPtr + offset, destPtr, len);
                  return result;
              }
              /*
               * Private Helpers
               */
              // @return number of payload items inside an encoded list.
              function numItems(RLPItem memory item) private pure returns (uint256) {
                  if (item.len == 0) return 0;
                  uint256 count = 0;
                  uint256 currPtr = item.memPtr + _payloadOffset(item.memPtr);
                  uint256 endPtr = item.memPtr + item.len;
                  while (currPtr < endPtr) {
                      currPtr = currPtr + _itemLength(currPtr); // skip over an item
                      count++;
                  }
                  return count;
              }
              // @return entire rlp item byte length
              function _itemLength(uint256 memPtr) private pure returns (uint256) {
                  uint256 itemLen;
                  uint256 byte0;
                  assembly {
                      byte0 := byte(0, mload(memPtr))
                  }
                  if (byte0 < STRING_SHORT_START) itemLen = 1;
                  else if (byte0 < STRING_LONG_START) itemLen = byte0 - STRING_SHORT_START + 1;
                  else if (byte0 < LIST_SHORT_START) {
                      assembly {
                          let byteLen := sub(byte0, 0xb7) // # of bytes the actual length is
                          memPtr := add(memPtr, 1) // skip over the first byte
                          /* 32 byte word size */
                          let dataLen := div(mload(memPtr), exp(256, sub(32, byteLen))) // right shifting to get the len
                          itemLen := add(dataLen, add(byteLen, 1))
                      }
                  } else if (byte0 < LIST_LONG_START) {
                      itemLen = byte0 - LIST_SHORT_START + 1;
                  } else {
                      assembly {
                          let byteLen := sub(byte0, 0xf7)
                          memPtr := add(memPtr, 1)
                          let dataLen := div(mload(memPtr), exp(256, sub(32, byteLen))) // right shifting to the correct length
                          itemLen := add(dataLen, add(byteLen, 1))
                      }
                  }
                  return itemLen;
              }
              // @return number of bytes until the data
              function _payloadOffset(uint256 memPtr) private pure returns (uint256) {
                  uint256 byte0;
                  assembly {
                      byte0 := byte(0, mload(memPtr))
                  }
                  if (byte0 < STRING_SHORT_START) return 0;
                  else if (byte0 < STRING_LONG_START || (byte0 >= LIST_SHORT_START && byte0 < LIST_LONG_START)) return 1;
                  else if (byte0 < LIST_SHORT_START)
                      // being explicit
                      return byte0 - (STRING_LONG_START - 1) + 1;
                  else return byte0 - (LIST_LONG_START - 1) + 1;
              }
              /*
               * @param src Pointer to source
               * @param dest Pointer to destination
               * @param len Amount of memory to copy from the source
               */
              function copy(
                  uint256 src,
                  uint256 dest,
                  uint256 len
              ) private pure {
                  if (len == 0) return;
                  // copy as many word sizes as possible
                  for (; len >= WORD_SIZE; len -= WORD_SIZE) {
                      assembly {
                          mstore(dest, mload(src))
                      }
                      src += WORD_SIZE;
                      dest += WORD_SIZE;
                  }
                  if (len == 0) return;
                  // left over bytes. Mask is used to remove unwanted bytes from the word
                  uint256 mask = 256**(WORD_SIZE - len) - 1;
                  assembly {
                      let srcpart := and(mload(src), not(mask)) // zero out src
                      let destpart := and(mload(dest), mask) // retrieve the bytes
                      mstore(dest, or(destpart, srcpart))
                  }
              }
          }// SPDX-License-Identifier: MIT
          pragma solidity ^0.8.0;
          import {RLPReader} from "./RLPReader.sol";
          library MerklePatriciaProof {
              /*
               * @dev Verifies a merkle patricia proof.
               * @param value The terminating value in the trie.
               * @param encodedPath The path in the trie leading to value.
               * @param rlpParentNodes The rlp encoded stack of nodes.
               * @param root The root hash of the trie.
               * @return The boolean validity of the proof.
               */
              function verify(
                  bytes memory value,
                  bytes memory encodedPath,
                  bytes memory rlpParentNodes,
                  bytes32 root
              ) internal pure returns (bool) {
                  RLPReader.RLPItem memory item = RLPReader.toRlpItem(rlpParentNodes);
                  RLPReader.RLPItem[] memory parentNodes = RLPReader.toList(item);
                  bytes memory currentNode;
                  RLPReader.RLPItem[] memory currentNodeList;
                  bytes32 nodeKey = root;
                  uint256 pathPtr = 0;
                  bytes memory path = _getNibbleArray(encodedPath);
                  if (path.length == 0) {
                      return false;
                  }
                  for (uint256 i = 0; i < parentNodes.length; i++) {
                      if (pathPtr > path.length) {
                          return false;
                      }
                      currentNode = RLPReader.toRlpBytes(parentNodes[i]);
                      if (nodeKey != keccak256(currentNode)) {
                          return false;
                      }
                      currentNodeList = RLPReader.toList(parentNodes[i]);
                      if (currentNodeList.length == 17) {
                          if (pathPtr == path.length) {
                              if (keccak256(RLPReader.toBytes(currentNodeList[16])) == keccak256(value)) {
                                  return true;
                              } else {
                                  return false;
                              }
                          }
                          uint8 nextPathNibble = uint8(path[pathPtr]);
                          if (nextPathNibble > 16) {
                              return false;
                          }
                          nodeKey = bytes32(RLPReader.toUintStrict(currentNodeList[nextPathNibble]));
                          pathPtr += 1;
                      } else if (currentNodeList.length == 2) {
                          uint256 traversed = _nibblesToTraverse(RLPReader.toBytes(currentNodeList[0]), path, pathPtr);
                          if (pathPtr + traversed == path.length) {
                              //leaf node
                              if (keccak256(RLPReader.toBytes(currentNodeList[1])) == keccak256(value)) {
                                  return true;
                              } else {
                                  return false;
                              }
                          }
                          //extension node
                          if (traversed == 0) {
                              return false;
                          }
                          pathPtr += traversed;
                          nodeKey = bytes32(RLPReader.toUintStrict(currentNodeList[1]));
                      } else {
                          return false;
                      }
                  }
              }
              function _nibblesToTraverse(
                  bytes memory encodedPartialPath,
                  bytes memory path,
                  uint256 pathPtr
              ) private pure returns (uint256) {
                  uint256 len = 0;
                  // encodedPartialPath has elements that are each two hex characters (1 byte), but partialPath
                  // and slicedPath have elements that are each one hex character (1 nibble)
                  bytes memory partialPath = _getNibbleArray(encodedPartialPath);
                  bytes memory slicedPath = new bytes(partialPath.length);
                  // pathPtr counts nibbles in path
                  // partialPath.length is a number of nibbles
                  for (uint256 i = pathPtr; i < pathPtr + partialPath.length; i++) {
                      bytes1 pathNibble = path[i];
                      slicedPath[i - pathPtr] = pathNibble;
                  }
                  if (keccak256(partialPath) == keccak256(slicedPath)) {
                      len = partialPath.length;
                  } else {
                      len = 0;
                  }
                  return len;
              }
              // bytes b must be hp encoded
              function _getNibbleArray(bytes memory b) internal pure returns (bytes memory) {
                  bytes memory nibbles = "";
                  if (b.length > 0) {
                      uint8 offset;
                      uint8 hpNibble = uint8(_getNthNibbleOfBytes(0, b));
                      if (hpNibble == 1 || hpNibble == 3) {
                          nibbles = new bytes(b.length * 2 - 1);
                          bytes1 oddNibble = _getNthNibbleOfBytes(1, b);
                          nibbles[0] = oddNibble;
                          offset = 1;
                      } else {
                          nibbles = new bytes(b.length * 2 - 2);
                          offset = 0;
                      }
                      for (uint256 i = offset; i < nibbles.length; i++) {
                          nibbles[i] = _getNthNibbleOfBytes(i - offset + 2, b);
                      }
                  }
                  return nibbles;
              }
              function _getNthNibbleOfBytes(uint256 n, bytes memory str) private pure returns (bytes1) {
                  return bytes1(n % 2 == 0 ? uint8(str[n / 2]) / 0x10 : uint8(str[n / 2]) % 0x10);
              }
          }// SPDX-License-Identifier: MIT
          pragma solidity ^0.8.0;
          library Merkle {
              function checkMembership(
                  bytes32 leaf,
                  uint256 index,
                  bytes32 rootHash,
                  bytes memory proof
              ) internal pure returns (bool) {
                  require(proof.length % 32 == 0, "Invalid proof length");
                  uint256 proofHeight = proof.length / 32;
                  // Proof of size n means, height of the tree is n+1.
                  // In a tree of height n+1, max #leafs possible is 2 ^ n
                  require(index < 2**proofHeight, "Leaf index is too big");
                  bytes32 proofElement;
                  bytes32 computedHash = leaf;
                  for (uint256 i = 32; i <= proof.length; i += 32) {
                      assembly {
                          proofElement := mload(add(proof, i))
                      }
                      if (index % 2 == 0) {
                          computedHash = keccak256(abi.encodePacked(computedHash, proofElement));
                      } else {
                          computedHash = keccak256(abi.encodePacked(proofElement, computedHash));
                      }
                      index = index / 2;
                  }
                  return computedHash == rootHash;
              }
          }pragma solidity ^0.8.0;
          import {RLPReader} from "./RLPReader.sol";
          library ExitPayloadReader {
              using RLPReader for bytes;
              using RLPReader for RLPReader.RLPItem;
              uint8 constant WORD_SIZE = 32;
              struct ExitPayload {
                  RLPReader.RLPItem[] data;
              }
              struct Receipt {
                  RLPReader.RLPItem[] data;
                  bytes raw;
                  uint256 logIndex;
              }
              struct Log {
                  RLPReader.RLPItem data;
                  RLPReader.RLPItem[] list;
              }
              struct LogTopics {
                  RLPReader.RLPItem[] data;
              }
              // copy paste of private copy() from RLPReader to avoid changing of existing contracts
              function copy(
                  uint256 src,
                  uint256 dest,
                  uint256 len
              ) private pure {
                  if (len == 0) return;
                  // copy as many word sizes as possible
                  for (; len >= WORD_SIZE; len -= WORD_SIZE) {
                      assembly {
                          mstore(dest, mload(src))
                      }
                      src += WORD_SIZE;
                      dest += WORD_SIZE;
                  }
                  // left over bytes. Mask is used to remove unwanted bytes from the word
                  uint256 mask = 256**(WORD_SIZE - len) - 1;
                  assembly {
                      let srcpart := and(mload(src), not(mask)) // zero out src
                      let destpart := and(mload(dest), mask) // retrieve the bytes
                      mstore(dest, or(destpart, srcpart))
                  }
              }
              function toExitPayload(bytes memory data) internal pure returns (ExitPayload memory) {
                  RLPReader.RLPItem[] memory payloadData = data.toRlpItem().toList();
                  return ExitPayload(payloadData);
              }
              function getHeaderNumber(ExitPayload memory payload) internal pure returns (uint256) {
                  return payload.data[0].toUint();
              }
              function getBlockProof(ExitPayload memory payload) internal pure returns (bytes memory) {
                  return payload.data[1].toBytes();
              }
              function getBlockNumber(ExitPayload memory payload) internal pure returns (uint256) {
                  return payload.data[2].toUint();
              }
              function getBlockTime(ExitPayload memory payload) internal pure returns (uint256) {
                  return payload.data[3].toUint();
              }
              function getTxRoot(ExitPayload memory payload) internal pure returns (bytes32) {
                  return bytes32(payload.data[4].toUint());
              }
              function getReceiptRoot(ExitPayload memory payload) internal pure returns (bytes32) {
                  return bytes32(payload.data[5].toUint());
              }
              function getReceipt(ExitPayload memory payload) internal pure returns (Receipt memory receipt) {
                  receipt.raw = payload.data[6].toBytes();
                  RLPReader.RLPItem memory receiptItem = receipt.raw.toRlpItem();
                  if (receiptItem.isList()) {
                      // legacy tx
                      receipt.data = receiptItem.toList();
                  } else {
                      // pop first byte before parsting receipt
                      bytes memory typedBytes = receipt.raw;
                      bytes memory result = new bytes(typedBytes.length - 1);
                      uint256 srcPtr;
                      uint256 destPtr;
                      assembly {
                          srcPtr := add(33, typedBytes)
                          destPtr := add(0x20, result)
                      }
                      copy(srcPtr, destPtr, result.length);
                      receipt.data = result.toRlpItem().toList();
                  }
                  receipt.logIndex = getReceiptLogIndex(payload);
                  return receipt;
              }
              function getReceiptProof(ExitPayload memory payload) internal pure returns (bytes memory) {
                  return payload.data[7].toBytes();
              }
              function getBranchMaskAsBytes(ExitPayload memory payload) internal pure returns (bytes memory) {
                  return payload.data[8].toBytes();
              }
              function getBranchMaskAsUint(ExitPayload memory payload) internal pure returns (uint256) {
                  return payload.data[8].toUint();
              }
              function getReceiptLogIndex(ExitPayload memory payload) internal pure returns (uint256) {
                  return payload.data[9].toUint();
              }
              // Receipt methods
              function toBytes(Receipt memory receipt) internal pure returns (bytes memory) {
                  return receipt.raw;
              }
              function getLog(Receipt memory receipt) internal pure returns (Log memory) {
                  RLPReader.RLPItem memory logData = receipt.data[3].toList()[receipt.logIndex];
                  return Log(logData, logData.toList());
              }
              // Log methods
              function getEmitter(Log memory log) internal pure returns (address) {
                  return RLPReader.toAddress(log.list[0]);
              }
              function getTopics(Log memory log) internal pure returns (LogTopics memory) {
                  return LogTopics(log.list[1].toList());
              }
              function getData(Log memory log) internal pure returns (bytes memory) {
                  return log.list[2].toBytes();
              }
              function toRlpBytes(Log memory log) internal pure returns (bytes memory) {
                  return log.data.toRlpBytes();
              }
              // LogTopics methods
              function getField(LogTopics memory topics, uint256 index) internal pure returns (RLPReader.RLPItem memory) {
                  return topics.data[index];
              }
          }
          // SPDX-License-Identifier: MIT
          pragma solidity >=0.6.12 <=0.8.9;
          pragma experimental ABIEncoderV2;
          interface IMessengerWrapper {
              function sendCrossDomainMessage(bytes memory _calldata) external;
              function verifySender(address l1BridgeCaller, bytes memory _data) external;
          }
          

          File 6 of 6: FxRoot
          // SPDX-License-Identifier: MIT
          pragma solidity 0.7.3;
          
          
          interface IStateSender {
              function syncState(address receiver, bytes calldata data) external;
          }
          
          interface IFxStateSender {
              function sendMessageToChild(address _receiver, bytes calldata _data) external;
          }
          
          /** 
           * @title FxRoot root contract for fx-portal
           */
          contract FxRoot is IFxStateSender {
              IStateSender public stateSender;
              address public fxChild;
          
              constructor(address _stateSender) {
                  stateSender = IStateSender(_stateSender);
              }
          
              function setFxChild(address _fxChild) public {
                  require(fxChild == address(0x0));
                  fxChild = _fxChild;
              }
          
              function sendMessageToChild(address _receiver, bytes calldata _data) public override {
                  bytes memory data = abi.encode(msg.sender, _receiver, _data);
                  stateSender.syncState(fxChild, data);
              }
          }