Contract Source Code (Solidity Standard Json-Input format)

IDE

• Blockscan IDE
• 🤖 Code ReaderBeta
• Remix IDE

More Options

• Similar
• Sol2Uml
• Submit Audit
• Compare

// SPDX-License-Identifier: Unlicensed

pragma solidity 0.8.25;

import {MerkleProof} from "@openzeppelin/contracts/utils/cryptography/MerkleProof.sol";
import {IERC165} from "@openzeppelin/contracts/interfaces/IERC165.sol";
import {IBurnRedeemable} from "./interfaces/IBurnRedeemable.sol";
import {ICore} from "./interfaces/ICore.sol";
import {IALX} from "./interfaces/IALX.sol";
import {Bridge} from "./base/Bridge.sol";

/// ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| \\\

/**
 * @title Interface for the ALX airdrop stake functionality.
 * @dev Defines functions for staking airdropped ALX tokens.
 */
interface IALXStake {

    /**
     * @notice Stakes ALX tokens received via airdrop.
     * @dev This function allows users to stake their airdropped ALX tokens.
     * @param _user The address of the user staking the tokens.
     * @param _amount The amount of ALX tokens to stake.
     * @param _duration The duration for staking the tokens.
     */
    function stakeWithAirdroppedALX(
        address _user,
        uint256 _amount,
        uint256 _duration
    ) external;

    /// --------------------------------------------------------------------------------------------------------------------------------- \\\
}

/// ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| \\\

/*
 * @title ALX Contract
 *
 * @notice Implements a token with airdrop and burnable functionalities.
 *
 * Co-Founders:
 * - Simran Dhillon: [email protected]
 * - Hardev Dhillon: [email protected]
 * - Dayana Plaz: [email protected]
 *
 * Official Links:
 * - Twitter: https://twitter.com/alixa_io
 * - Telegram: https://t.me/alixa_io
 * - Website: https://alixa.io
 *
 * Disclaimer:
 * This contract aligns with the principles of the Fair Crypto Foundation, promoting self-custody, transparency, consensus-based
 * trust, and permissionless value exchange. There are no administrative access keys, underscoring our commitment to decentralisation.
 * Engaging with this contract involves technical and legal risks. Users must conduct their own due diligence and ensure compliance
 * with local laws and regulations. The software is provided "AS-IS," without warranties, and the co-founders and developers disclaim
 * all liability for any vulnerabilities, exploits, errors, or breaches that may occur. By using this contract, users accept all associated
 * risks and this disclaimer. The co-founders, developers, or related parties will not bear liability for any consequences of non-compliance.
 *
 * Redistribution and Use:
 * Redistribution, modification, or repurposing of this contract, in whole or in part, is strictly prohibited without express written
 * approval from all co-founders. Approval requests must be sent to the official email addresses of the co-founders, ensuring responses
 * are received directly from these addresses. Proposals for redistribution, modification, or repurposing must include a detailed explanation
 * of the intended changes or uses and the reasons behind them. The co-founders reserve the right to request additional information or
 * clarification as necessary. Approval is at the sole discretion of the co-founders and may be subject to conditions to uphold the
 * project’s integrity and the values of the Fair Crypto Foundation. Failure to obtain express written approval prior to any redistribution,
 * modification, or repurposing will result in a breach of these terms and immediate legal action.
 *
 * Copyright and License:
 * Copyright © 2024 Alixa (Simran Dhillon, Hardev Dhillon, Dayana Plaz). All rights reserved.
 * This software is provided 'as is' and may be used by the recipient. No permission is granted for redistribution,
 * modification, or repurposing of this contract. Any use beyond the scope defined herein may be subject to legal action.
 */
contract ALX is Bridge, IALX {

    /// --------------------------------------------------------------------------------------------------------------------------------- \\\
    /// ---------------------------------------------------------- VARIABLES ------------------------------------------------------------ \\\
    /// --------------------------------------------------------------------------------------------------------------------------------- \\\

    /**
     * @notice Protocol owned pool address.
     * @dev This variable holds the protocol-owned pool address.
     */
    address public pool;

    /**
     * @notice Address of the core contract.
     * @dev This variable holds the address of the core contract.
     */
    address public immutable core;

    /**
     * @notice Root of the Merkle tree for airdrop claims.
     * @dev This variable holds the Merkle root for verifying airdrop claims.
     */
    bytes32 public immutable merkleRoot;

    /**
     * @notice Total supply of airdropped tokens.
     * @dev This variable holds the total supply of airdropped tokens.
     */
    uint256 public totalAirdroppedSupply;

    /**
     * @notice Marks the time when airdrop claiming begins.
     * @dev This variable holds the timestamp when the contract is deployed.
     */
    uint256 public immutable initialTimestamp;

    /// --------------------------------------------------------------------------------------------------------------------------------- \\\
    /// ---------------------------------------------------------- MAPPINGS ------------------------------------------------------------- \\\
    /// --------------------------------------------------------------------------------------------------------------------------------- \\\

    /**
     * @notice Records the total number of tokens burned by each user.
     * @dev This mapping tracks the number of tokens burned by each user.
     */
    mapping (address user => uint256 amountBurnt) public userBurns;

    /**
     * @notice Tracks the amount that was claimed.
     * @dev This mapping tracks the amount of tokens claimed from the airdrop.
     */
    mapping (bytes32 leaf => uint256 amountClaimed) public airdropClaimed;

    /// --------------------------------------------------------------------------------------------------------------------------------- \\\
    /// ------------------------------------------------------------ ERRORS ------------------------------------------------------------- \\\
    /// --------------------------------------------------------------------------------------------------------------------------------- \\\

    /**
     * @notice Error when the core address is set more than once.
     * @dev Triggered when attempting to set the core address more than once.
     */
    error ContractAlreadySet();

    /**
     * @notice Error when claiming more than airdropped.
     * @dev Triggered when a claim exceeds the airdropped amount.
     */
    error InsufficientAirdroppedAmount();

    /// --------------------------------------------------------------------------------------------------------------------------------- \\\
    /// ---------------------------------------------------------- CONSTRUCTOR ---------------------------------------------------------- \\\
    /// --------------------------------------------------------------------------------------------------------------------------------- \\\

    /**
     * @notice Initialises the ALX token with given parameters.
     * @dev Sets up the token with bridge functionality and airdrop parameters.
     * @param _merkleRoot Merkle root for airdrop claim verification.
     * @param _core Core contract address.
     * @param _gateway Gateway address for the bridge token.
     * @param _gasService Gas service address for the bridge token.
     * @param _endpoint Endpoint address for the bridge token.
     * @param _wormholeRelayer Wormhole relayer address for the bridge token.
     */
    constructor(
        bytes32 _merkleRoot,
        address _core,
        address _gateway,
        address _gasService,
        address _endpoint,
        address _wormholeRelayer
    ) payable
        Bridge(
            "ALX",
            "ALX",
            _gateway,
            _gasService,
            _endpoint,
            _wormholeRelayer
        )
    {
        initialTimestamp = block.timestamp;
        merkleRoot = _merkleRoot;
        core = _core;
    }

    /// --------------------------------------------------------------------------------------------------------------------------------- \\\
    /// ----------------------------------------------------- EXTERNAL FUNCTIONS -------------------------------------------------------- \\\
    /// --------------------------------------------------------------------------------------------------------------------------------- \\\

    /**
     * @notice Sets the ALX-vXNF POL address.
     * @dev Can only be set once by the core contract.
     * @param _ALXPOL The address of the ALX-vXNF POL contract.
     */
    function setPool(address _ALXPOL) external {
        if (pool != address(0))
            revert ContractAlreadySet();
        if (_ALXPOL == address(0))
            revert ZeroAddress();
        if (msg.sender == core)
            pool = _ALXPOL;
    }

    /// --------------------------------------------------------------------------------------------------------------------------------- \\\

    /**
     * @notice Claims airdropped tokens using a Merkle proof.
     * @dev Verifies the claim against the Merkle root and mints the tokens.
     * @param _proof Array of bytes32 values representing the Merkle proof.
     * @param _airdroppedAmount Total airdropped amount for the user.
     * @param _amountToClaim Amount of tokens being claimed.
     */
    function claim(
        bytes32[] calldata _proof,
        uint256 _airdroppedAmount,
        uint256 _amountToClaim
    ) external {
        if (pool == address(0) || block.timestamp > initialTimestamp + 90 days)
            revert AirdropPeriodNotActive();
        bytes32 leaf = keccak256(bytes.concat(keccak256(abi.encode(msg.sender, _airdroppedAmount))));
        if (!MerkleProof.verify(_proof, merkleRoot, leaf)) {
            revert InvalidClaimProof();
        }
        uint256 airdropClaimedAmount = airdropClaimed[leaf];
        if (_amountToClaim > _airdroppedAmount - airdropClaimedAmount) {
            revert InsufficientAirdroppedAmount();
        }
        unchecked {
            airdropClaimed[leaf] = airdropClaimedAmount + _amountToClaim;
            totalAirdroppedSupply = totalAirdroppedSupply + _amountToClaim;
        }
        _mint(msg.sender, _amountToClaim);
        emit Airdropped(msg.sender, _amountToClaim);
    }

    /// --------------------------------------------------------------------------------------------------------------------------------- \\\

    /**
     * @notice Purchases bonds using airdropped ALX tokens.
     * @dev Verifies the user's airdropped tokens and initiates bond purchase.
     * @param _proof Merkle proof for verification.
     * @param _user Address of the user purchasing bonds.
     * @param _bondPower The power of the bond being purchased.
     * @param _bondCount The number of bonds to purchase.
     * @param _daysCount The duration of the bond in days.
     * @param _airdroppedAmount The total amount of airdropped tokens available.
     */
    function purchaseBondWithAirdroppedALX(
        bytes32[] calldata _proof,
        address _user,
        uint256 _bondPower,
        uint256 _bondCount,
        uint256 _daysCount,
        uint256 _airdroppedAmount
    ) external {
        if (block.timestamp > initialTimestamp + 90 days) {
            revert AirdropPeriodNotActive();
        }
        uint256 ALXRequired = ICore(core).getTokenAmounts(_bondPower, _bondCount, false);
        bytes32 leaf = keccak256(bytes.concat(keccak256(abi.encode(msg.sender, _airdroppedAmount))));
        if (!MerkleProof.verify(_proof, merkleRoot, leaf)) {
            revert InvalidClaimProof();
        }
        uint256 airdropClaimedAmount = airdropClaimed[leaf];
        if (ALXRequired > _airdroppedAmount - airdropClaimedAmount) {
            revert InsufficientAirdroppedAmount();
        }
        unchecked {
            airdropClaimed[leaf] = airdropClaimedAmount + ALXRequired;
            totalAirdroppedSupply = totalAirdroppedSupply + ALXRequired;
        }
        emit Airdropped(msg.sender, ALXRequired);
        ICore(core).purchaseBondWithAirdroppedALX(
            _user,
            _bondCount,
            _daysCount,
            _bondPower,
            ALXRequired
        );
    }

    /// --------------------------------------------------------------------------------------------------------------------------------- \\\

    /**
     * @notice Stakes airdropped ALX tokens.
     * @dev Verifies the user's airdropped tokens and initiates staking.
     * @param _proof Merkle proof for verification.
     * @param _user Address of the user staking tokens.
     * @param _duration Duration of the stake.
     * @param _amountToStake Amount of tokens being staked.
     * @param _airdroppedAmount The total amount of airdropped tokens available.
     */
    function stakeWithAirdroppedALX(
        bytes32[] calldata _proof,
        address _user,
        uint256 _duration,
        uint256 _amountToStake,
        uint256 _airdroppedAmount
    ) external {
        if (block.timestamp > initialTimestamp + 90 days) {
            revert AirdropPeriodNotActive();
        }
        bytes32 leaf = keccak256(bytes.concat(keccak256(abi.encode(msg.sender, _airdroppedAmount))));
        if (!MerkleProof.verify(_proof, merkleRoot, leaf)) {
            revert InvalidClaimProof();
        }
        uint256 airdropClaimedAmount = airdropClaimed[leaf];
        if (_amountToStake > _airdroppedAmount - airdropClaimedAmount) {
            revert InsufficientAirdroppedAmount();
        }
        unchecked {
            airdropClaimed[leaf] = airdropClaimedAmount + _amountToStake;
            totalAirdroppedSupply = totalAirdroppedSupply + _amountToStake;
        }
        _mint(core, _amountToStake);
        emit Airdropped(msg.sender, _amountToStake);
        IALXStake(core).stakeWithAirdroppedALX(
            _user,
            _amountToStake,
            _duration
        );
    }

    /// --------------------------------------------------------------------------------------------------------------------------------- \\\

    /**
     * @notice Mints ALX tokens to an account.
     * @dev Can only be called by the core contract.
     * @param _account The account to which the tokens will be minted.
     * @param _amount The amount of ALX tokens to mint.
     */
    function mint(address _account, uint256 _amount) external {
        if (msg.sender != core)
            revert InvalidCaller();
        if (totalSupply() + _amount + totalBridgedAmount > 50_000_000 ether)
            revert MaxSupplyExceeded();
        _mint(_account, _amount);
    }

    /// --------------------------------------------------------------------------------------------------------------------------------- \\\

    /**
     * @notice Burns ALX tokens from a user's account.
     * @dev Can only be called by a contract implementing IBurnRedeemable.
     * @param _user The user from whom tokens will be burned.
     * @param _amount The amount of ALX tokens to burn.
     */
    function burn(address _user, uint256 _amount) external {
        if (!IERC165(msg.sender).supportsInterface(type(IBurnRedeemable).interfaceId)) {
            revert UnsupportedInterface();
        }
        if (msg.sender != _user) {
            _spendAllowance(
                _user,
                msg.sender,
                _amount
            );
        }
        _burn(_user, _amount);
        unchecked {
            userBurns[_user] += _amount;
        }
        IBurnRedeemable(msg.sender).onTokenBurned(_user, _amount);
    }

    /// --------------------------------------------------------------------------------------------------------------------------------- \\\
}

// SPDX-License-Identifier: MIT

pragma solidity ^0.8.0;

import { IAxelarGateway } from '../interfaces/IAxelarGateway.sol';
import { IAxelarExecutable } from '../interfaces/IAxelarExecutable.sol';

contract AxelarExecutable is IAxelarExecutable {
    IAxelarGateway public immutable gateway;

    constructor(address gateway_) {
        if (gateway_ == address(0)) revert InvalidAddress();

        gateway = IAxelarGateway(gateway_);
    }

    function execute(
        bytes32 commandId,
        string calldata sourceChain,
        string calldata sourceAddress,
        bytes calldata payload
    ) external {
        bytes32 payloadHash = keccak256(payload);

        if (!gateway.validateContractCall(commandId, sourceChain, sourceAddress, payloadHash))
            revert NotApprovedByGateway();

        _execute(sourceChain, sourceAddress, payload);
    }

    function executeWithToken(
        bytes32 commandId,
        string calldata sourceChain,
        string calldata sourceAddress,
        bytes calldata payload,
        string calldata tokenSymbol,
        uint256 amount
    ) external {
        bytes32 payloadHash = keccak256(payload);

        if (
            !gateway.validateContractCallAndMint(
                commandId,
                sourceChain,
                sourceAddress,
                payloadHash,
                tokenSymbol,
                amount
            )
        ) revert NotApprovedByGateway();

        _executeWithToken(sourceChain, sourceAddress, payload, tokenSymbol, amount);
    }

    function _execute(
        string calldata sourceChain,
        string calldata sourceAddress,
        bytes calldata payload
    ) internal virtual {}

    function _executeWithToken(
        string calldata sourceChain,
        string calldata sourceAddress,
        bytes calldata payload,
        string calldata tokenSymbol,
        uint256 amount
    ) internal virtual {}
}

// SPDX-License-Identifier: MIT

pragma solidity ^0.8.0;

import { IAxelarGateway } from './IAxelarGateway.sol';

interface IAxelarExecutable {
    error InvalidAddress();
    error NotApprovedByGateway();

    function gateway() external view returns (IAxelarGateway);

    function execute(
        bytes32 commandId,
        string calldata sourceChain,
        string calldata sourceAddress,
        bytes calldata payload
    ) external;

    function executeWithToken(
        bytes32 commandId,
        string calldata sourceChain,
        string calldata sourceAddress,
        bytes calldata payload,
        string calldata tokenSymbol,
        uint256 amount
    ) external;
}

// SPDX-License-Identifier: MIT

pragma solidity ^0.8.0;

// This should be owned by the microservice that is paying for gas.
interface IAxelarGasService {
    error NothingReceived();
    error InvalidAddress();
    error NotCollector();
    error InvalidAmounts();

    event GasPaidForContractCall(
        address indexed sourceAddress,
        string destinationChain,
        string destinationAddress,
        bytes32 indexed payloadHash,
        address gasToken,
        uint256 gasFeeAmount,
        address refundAddress
    );

    event GasPaidForContractCallWithToken(
        address indexed sourceAddress,
        string destinationChain,
        string destinationAddress,
        bytes32 indexed payloadHash,
        string symbol,
        uint256 amount,
        address gasToken,
        uint256 gasFeeAmount,
        address refundAddress
    );

    event NativeGasPaidForContractCall(
        address indexed sourceAddress,
        string destinationChain,
        string destinationAddress,
        bytes32 indexed payloadHash,
        uint256 gasFeeAmount,
        address refundAddress
    );

    event NativeGasPaidForContractCallWithToken(
        address indexed sourceAddress,
        string destinationChain,
        string destinationAddress,
        bytes32 indexed payloadHash,
        string symbol,
        uint256 amount,
        uint256 gasFeeAmount,
        address refundAddress
    );

    event GasPaidForExpressCallWithToken(
        address indexed sourceAddress,
        string destinationChain,
        string destinationAddress,
        bytes32 indexed payloadHash,
        string symbol,
        uint256 amount,
        address gasToken,
        uint256 gasFeeAmount,
        address refundAddress
    );

    event NativeGasPaidForExpressCallWithToken(
        address indexed sourceAddress,
        string destinationChain,
        string destinationAddress,
        bytes32 indexed payloadHash,
        string symbol,
        uint256 amount,
        uint256 gasFeeAmount,
        address refundAddress
    );

    event GasAdded(
        bytes32 indexed txHash,
        uint256 indexed logIndex,
        address gasToken,
        uint256 gasFeeAmount,
        address refundAddress
    );

    event NativeGasAdded(bytes32 indexed txHash, uint256 indexed logIndex, uint256 gasFeeAmount, address refundAddress);

    event ExpressGasAdded(
        bytes32 indexed txHash,
        uint256 indexed logIndex,
        address gasToken,
        uint256 gasFeeAmount,
        address refundAddress
    );

    event NativeExpressGasAdded(
        bytes32 indexed txHash,
        uint256 indexed logIndex,
        uint256 gasFeeAmount,
        address refundAddress
    );

    // This is called on the source chain before calling the gateway to execute a remote contract.
    function payGasForContractCall(
        address sender,
        string calldata destinationChain,
        string calldata destinationAddress,
        bytes calldata payload,
        address gasToken,
        uint256 gasFeeAmount,
        address refundAddress
    ) external;

    // This is called on the source chain before calling the gateway to execute a remote contract.
    function payGasForContractCallWithToken(
        address sender,
        string calldata destinationChain,
        string calldata destinationAddress,
        bytes calldata payload,
        string calldata symbol,
        uint256 amount,
        address gasToken,
        uint256 gasFeeAmount,
        address refundAddress
    ) external;

    // This is called on the source chain before calling the gateway to execute a remote contract.
    function payNativeGasForContractCall(
        address sender,
        string calldata destinationChain,
        string calldata destinationAddress,
        bytes calldata payload,
        address refundAddress
    ) external payable;

    // This is called on the source chain before calling the gateway to execute a remote contract.
    function payNativeGasForContractCallWithToken(
        address sender,
        string calldata destinationChain,
        string calldata destinationAddress,
        bytes calldata payload,
        string calldata symbol,
        uint256 amount,
        address refundAddress
    ) external payable;

    // This is called on the source chain before calling the gateway to execute a remote contract.
    function payGasForExpressCallWithToken(
        address sender,
        string calldata destinationChain,
        string calldata destinationAddress,
        bytes calldata payload,
        string calldata symbol,
        uint256 amount,
        address gasToken,
        uint256 gasFeeAmount,
        address refundAddress
    ) external;

    // This is called on the source chain before calling the gateway to execute a remote contract.
    function payNativeGasForExpressCallWithToken(
        address sender,
        string calldata destinationChain,
        string calldata destinationAddress,
        bytes calldata payload,
        string calldata symbol,
        uint256 amount,
        address refundAddress
    ) external payable;

    function addGas(
        bytes32 txHash,
        uint256 txIndex,
        address gasToken,
        uint256 gasFeeAmount,
        address refundAddress
    ) external;

    function addNativeGas(
        bytes32 txHash,
        uint256 logIndex,
        address refundAddress
    ) external payable;

    function addExpressGas(
        bytes32 txHash,
        uint256 txIndex,
        address gasToken,
        uint256 gasFeeAmount,
        address refundAddress
    ) external;

    function addNativeExpressGas(
        bytes32 txHash,
        uint256 logIndex,
        address refundAddress
    ) external payable;

    function collectFees(
        address payable receiver,
        address[] calldata tokens,
        uint256[] calldata amounts
    ) external;

    function refund(
        address payable receiver,
        address token,
        uint256 amount
    ) external;

    function gasCollector() external returns (address);
}

// SPDX-License-Identifier: MIT

pragma solidity ^0.8.0;

interface IAxelarGateway {
    /**********\
    |* Errors *|
    \**********/

    error NotSelf();
    error NotProxy();
    error InvalidCodeHash();
    error SetupFailed();
    error InvalidAuthModule();
    error InvalidTokenDeployer();
    error InvalidAmount();
    error InvalidChainId();
    error InvalidCommands();
    error TokenDoesNotExist(string symbol);
    error TokenAlreadyExists(string symbol);
    error TokenDeployFailed(string symbol);
    error TokenContractDoesNotExist(address token);
    error BurnFailed(string symbol);
    error MintFailed(string symbol);
    error InvalidSetMintLimitsParams();
    error ExceedMintLimit(string symbol);

    /**********\
    |* Events *|
    \**********/

    event TokenSent(
        address indexed sender,
        string destinationChain,
        string destinationAddress,
        string symbol,
        uint256 amount
    );

    event ContractCall(
        address indexed sender,
        string destinationChain,
        string destinationContractAddress,
        bytes32 indexed payloadHash,
        bytes payload
    );

    event ContractCallWithToken(
        address indexed sender,
        string destinationChain,
        string destinationContractAddress,
        bytes32 indexed payloadHash,
        bytes payload,
        string symbol,
        uint256 amount
    );

    event Executed(bytes32 indexed commandId);

    event TokenDeployed(string symbol, address tokenAddresses);

    event ContractCallApproved(
        bytes32 indexed commandId,
        string sourceChain,
        string sourceAddress,
        address indexed contractAddress,
        bytes32 indexed payloadHash,
        bytes32 sourceTxHash,
        uint256 sourceEventIndex
    );

    event ContractCallApprovedWithMint(
        bytes32 indexed commandId,
        string sourceChain,
        string sourceAddress,
        address indexed contractAddress,
        bytes32 indexed payloadHash,
        string symbol,
        uint256 amount,
        bytes32 sourceTxHash,
        uint256 sourceEventIndex
    );

    event TokenMintLimitUpdated(string symbol, uint256 limit);

    event OperatorshipTransferred(bytes newOperatorsData);

    event Upgraded(address indexed implementation);

    /********************\
    |* Public Functions *|
    \********************/

    function sendToken(
        string calldata destinationChain,
        string calldata destinationAddress,
        string calldata symbol,
        uint256 amount
    ) external;

    function callContract(
        string calldata destinationChain,
        string calldata contractAddress,
        bytes calldata payload
    ) external;

    function callContractWithToken(
        string calldata destinationChain,
        string calldata contractAddress,
        bytes calldata payload,
        string calldata symbol,
        uint256 amount
    ) external;

    function isContractCallApproved(
        bytes32 commandId,
        string calldata sourceChain,
        string calldata sourceAddress,
        address contractAddress,
        bytes32 payloadHash
    ) external view returns (bool);

    function isContractCallAndMintApproved(
        bytes32 commandId,
        string calldata sourceChain,
        string calldata sourceAddress,
        address contractAddress,
        bytes32 payloadHash,
        string calldata symbol,
        uint256 amount
    ) external view returns (bool);

    function validateContractCall(
        bytes32 commandId,
        string calldata sourceChain,
        string calldata sourceAddress,
        bytes32 payloadHash
    ) external returns (bool);

    function validateContractCallAndMint(
        bytes32 commandId,
        string calldata sourceChain,
        string calldata sourceAddress,
        bytes32 payloadHash,
        string calldata symbol,
        uint256 amount
    ) external returns (bool);

    /***********\
    |* Getters *|
    \***********/

    function authModule() external view returns (address);

    function tokenDeployer() external view returns (address);

    function tokenMintLimit(string memory symbol) external view returns (uint256);

    function tokenMintAmount(string memory symbol) external view returns (uint256);

    function allTokensFrozen() external view returns (bool);

    function implementation() external view returns (address);

    function tokenAddresses(string memory symbol) external view returns (address);

    function tokenFrozen(string memory symbol) external view returns (bool);

    function isCommandExecuted(bytes32 commandId) external view returns (bool);

    function adminEpoch() external view returns (uint256);

    function adminThreshold(uint256 epoch) external view returns (uint256);

    function admins(uint256 epoch) external view returns (address[] memory);

    /*******************\
    |* Admin Functions *|
    \*******************/

    function setTokenMintLimits(string[] calldata symbols, uint256[] calldata limits) external;

    function upgrade(
        address newImplementation,
        bytes32 newImplementationCodeHash,
        bytes calldata setupParams
    ) external;

    /**********************\
    |* External Functions *|
    \**********************/

    function setup(bytes calldata params) external;

    function execute(bytes calldata input) external;
}

// SPDX-License-Identifier: MIT

pragma solidity ^0.8.0;

library StringToAddress {
    error InvalidAddressString();

    function toAddress(string memory addressString) internal pure returns (address) {
        bytes memory stringBytes = bytes(addressString);
        uint160 addressNumber = 0;
        uint8 stringByte;

        if (stringBytes.length != 42 || stringBytes[0] != '0' || stringBytes[1] != 'x') revert InvalidAddressString();

        for (uint256 i = 2; i < 42; ++i) {
            stringByte = uint8(stringBytes[i]);

            if ((stringByte >= 97) && (stringByte <= 102)) stringByte -= 87;
            else if ((stringByte >= 65) && (stringByte <= 70)) stringByte -= 55;
            else if ((stringByte >= 48) && (stringByte <= 57)) stringByte -= 48;
            else revert InvalidAddressString();

            addressNumber |= uint160(uint256(stringByte) << ((41 - i) << 2));
        }
        return address(addressNumber);
    }
}

library AddressToString {
    function toString(address addr) internal pure returns (string memory) {
        bytes memory addressBytes = abi.encodePacked(addr);
        uint256 length = addressBytes.length;
        bytes memory characters = '0123456789abcdef';
        bytes memory stringBytes = new bytes(2 + addressBytes.length * 2);

        stringBytes[0] = '0';
        stringBytes[1] = 'x';

        for (uint256 i; i < length; ++i) {
            stringBytes[2 + i * 2] = characters[uint8(addressBytes[i] >> 4)];
            stringBytes[3 + i * 2] = characters[uint8(addressBytes[i] & 0x0f)];
        }
        return string(stringBytes);
    }
}

// SPDX-License-Identifier: BUSL-1.1

pragma solidity >=0.5.0;

import "./ILayerZeroUserApplicationConfig.sol";

interface ILayerZeroEndpoint is ILayerZeroUserApplicationConfig {
    // @notice send a LayerZero message to the specified address at a LayerZero endpoint.
    // @param _dstChainId - the destination chain identifier
    // @param _destination - the address on destination chain (in bytes). address length/format may vary by chains
    // @param _payload - a custom bytes payload to send to the destination contract
    // @param _refundAddress - if the source transaction is cheaper than the amount of value passed, refund the additional amount to this address
    // @param _zroPaymentAddress - the address of the ZRO token holder who would pay for the transaction
    // @param _adapterParams - parameters for custom functionality. e.g. receive airdropped native gas from the relayer on destination
    function send(
        uint16 _dstChainId,
        bytes calldata _destination,
        bytes calldata _payload,
        address payable _refundAddress,
        address _zroPaymentAddress,
        bytes calldata _adapterParams
    ) external payable;

    // @notice used by the messaging library to publish verified payload
    // @param _srcChainId - the source chain identifier
    // @param _srcAddress - the source contract (as bytes) at the source chain
    // @param _dstAddress - the address on destination chain
    // @param _nonce - the unbound message ordering nonce
    // @param _gasLimit - the gas limit for external contract execution
    // @param _payload - verified payload to send to the destination contract
    function receivePayload(
        uint16 _srcChainId,
        bytes calldata _srcAddress,
        address _dstAddress,
        uint64 _nonce,
        uint _gasLimit,
        bytes calldata _payload
    ) external;

    // @notice get the inboundNonce of a receiver from a source chain which could be EVM or non-EVM chain
    // @param _srcChainId - the source chain identifier
    // @param _srcAddress - the source chain contract address
    function getInboundNonce(uint16 _srcChainId, bytes calldata _srcAddress) external view returns (uint64);

    // @notice get the outboundNonce from this source chain which, consequently, is always an EVM
    // @param _srcAddress - the source chain contract address
    function getOutboundNonce(uint16 _dstChainId, address _srcAddress) external view returns (uint64);

    // @notice gets a quote in source native gas, for the amount that send() requires to pay for message delivery
    // @param _dstChainId - the destination chain identifier
    // @param _userApplication - the user app address on this EVM chain
    // @param _payload - the custom message to send over LayerZero
    // @param _payInZRO - if false, user app pays the protocol fee in native token
    // @param _adapterParam - parameters for the adapter service, e.g. send some dust native token to dstChain
    function estimateFees(
        uint16 _dstChainId,
        address _userApplication,
        bytes calldata _payload,
        bool _payInZRO,
        bytes calldata _adapterParam
    ) external view returns (uint nativeFee, uint zroFee);

    // @notice get this Endpoint's immutable source identifier
    function getChainId() external view returns (uint16);

    // @notice the interface to retry failed message on this Endpoint destination
    // @param _srcChainId - the source chain identifier
    // @param _srcAddress - the source chain contract address
    // @param _payload - the payload to be retried
    function retryPayload(uint16 _srcChainId, bytes calldata _srcAddress, bytes calldata _payload) external;

    // @notice query if any STORED payload (message blocking) at the endpoint.
    // @param _srcChainId - the source chain identifier
    // @param _srcAddress - the source chain contract address
    function hasStoredPayload(uint16 _srcChainId, bytes calldata _srcAddress) external view returns (bool);

    // @notice query if the _libraryAddress is valid for sending msgs.
    // @param _userApplication - the user app address on this EVM chain
    function getSendLibraryAddress(address _userApplication) external view returns (address);

    // @notice query if the _libraryAddress is valid for receiving msgs.
    // @param _userApplication - the user app address on this EVM chain
    function getReceiveLibraryAddress(address _userApplication) external view returns (address);

    // @notice query if the non-reentrancy guard for send() is on
    // @return true if the guard is on. false otherwise
    function isSendingPayload() external view returns (bool);

    // @notice query if the non-reentrancy guard for receive() is on
    // @return true if the guard is on. false otherwise
    function isReceivingPayload() external view returns (bool);

    // @notice get the configuration of the LayerZero messaging library of the specified version
    // @param _version - messaging library version
    // @param _chainId - the chainId for the pending config change
    // @param _userApplication - the contract address of the user application
    // @param _configType - type of configuration. every messaging library has its own convention.
    function getConfig(
        uint16 _version,
        uint16 _chainId,
        address _userApplication,
        uint _configType
    ) external view returns (bytes memory);

    // @notice get the send() LayerZero messaging library version
    // @param _userApplication - the contract address of the user application
    function getSendVersion(address _userApplication) external view returns (uint16);

    // @notice get the lzReceive() LayerZero messaging library version
    // @param _userApplication - the contract address of the user application
    function getReceiveVersion(address _userApplication) external view returns (uint16);
}

// SPDX-License-Identifier: BUSL-1.1

pragma solidity >=0.5.0;

interface ILayerZeroUserApplicationConfig {
    // @notice set the configuration of the LayerZero messaging library of the specified version
    // @param _version - messaging library version
    // @param _chainId - the chainId for the pending config change
    // @param _configType - type of configuration. every messaging library has its own convention.
    // @param _config - configuration in the bytes. can encode arbitrary content.
    function setConfig(uint16 _version, uint16 _chainId, uint _configType, bytes calldata _config) external;

    // @notice set the send() LayerZero messaging library version to _version
    // @param _version - new messaging library version
    function setSendVersion(uint16 _version) external;

    // @notice set the lzReceive() LayerZero messaging library version to _version
    // @param _version - new messaging library version
    function setReceiveVersion(uint16 _version) external;

    // @notice Only when the UA needs to resume the message flow in blocking mode and clear the stored payload
    // @param _srcChainId - the chainId of the source chain
    // @param _srcAddress - the contract address of the source contract at the source chain
    function forceResumeReceive(uint16 _srcChainId, bytes calldata _srcAddress) external;
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts v4.4.1 (interfaces/IERC165.sol)

pragma solidity ^0.8.0;

import "../utils/introspection/IERC165.sol";

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.0) (token/ERC20/ERC20.sol)

pragma solidity ^0.8.0;

import "./IERC20.sol";
import "./extensions/IERC20Metadata.sol";
import "../../utils/Context.sol";

/**
 * @dev Implementation of the {IERC20} interface.
 *
 * This implementation is agnostic to the way tokens are created. This means
 * that a supply mechanism has to be added in a derived contract using {_mint}.
 * For a generic mechanism see {ERC20PresetMinterPauser}.
 *
 * TIP: For a detailed writeup see our guide
 * https://forum.openzeppelin.com/t/how-to-implement-erc20-supply-mechanisms/226[How
 * to implement supply mechanisms].
 *
 * The default value of {decimals} is 18. To change this, you should override
 * this function so it returns a different value.
 *
 * We have followed general OpenZeppelin Contracts guidelines: functions revert
 * instead returning `false` on failure. This behavior is nonetheless
 * conventional and does not conflict with the expectations of ERC20
 * applications.
 *
 * Additionally, an {Approval} event is emitted on calls to {transferFrom}.
 * This allows applications to reconstruct the allowance for all accounts just
 * by listening to said events. Other implementations of the EIP may not emit
 * these events, as it isn't required by the specification.
 *
 * Finally, the non-standard {decreaseAllowance} and {increaseAllowance}
 * functions have been added to mitigate the well-known issues around setting
 * allowances. See {IERC20-approve}.
 */
contract ERC20 is Context, IERC20, IERC20Metadata {
    mapping(address => uint256) private _balances;

    mapping(address => mapping(address => uint256)) private _allowances;

    uint256 private _totalSupply;

    string private _name;
    string private _symbol;

    /**
     * @dev Sets the values for {name} and {symbol}.
     *
     * All two of these values are immutable: they can only be set once during
     * construction.
     */
    constructor(string memory name_, string memory symbol_) {
        _name = name_;
        _symbol = symbol_;
    }

    /**
     * @dev Returns the name of the token.
     */
    function name() public view virtual override returns (string memory) {
        return _name;
    }

    /**
     * @dev Returns the symbol of the token, usually a shorter version of the
     * name.
     */
    function symbol() public view virtual override returns (string memory) {
        return _symbol;
    }

    /**
     * @dev Returns the number of decimals used to get its user representation.
     * For example, if `decimals` equals `2`, a balance of `505` tokens should
     * be displayed to a user as `5.05` (`505 / 10 ** 2`).
     *
     * Tokens usually opt for a value of 18, imitating the relationship between
     * Ether and Wei. This is the default value returned by this function, unless
     * it's overridden.
     *
     * NOTE: This information is only used for _display_ purposes: it in
     * no way affects any of the arithmetic of the contract, including
     * {IERC20-balanceOf} and {IERC20-transfer}.
     */
    function decimals() public view virtual override returns (uint8) {
        return 18;
    }

    /**
     * @dev See {IERC20-totalSupply}.
     */
    function totalSupply() public view virtual override returns (uint256) {
        return _totalSupply;
    }

    /**
     * @dev See {IERC20-balanceOf}.
     */
    function balanceOf(address account) public view virtual override returns (uint256) {
        return _balances[account];
    }

    /**
     * @dev See {IERC20-transfer}.
     *
     * Requirements:
     *
     * - `to` cannot be the zero address.
     * - the caller must have a balance of at least `amount`.
     */
    function transfer(address to, uint256 amount) public virtual override returns (bool) {
        address owner = _msgSender();
        _transfer(owner, to, amount);
        return true;
    }

    /**
     * @dev See {IERC20-allowance}.
     */
    function allowance(address owner, address spender) public view virtual override returns (uint256) {
        return _allowances[owner][spender];
    }

    /**
     * @dev See {IERC20-approve}.
     *
     * NOTE: If `amount` is the maximum `uint256`, the allowance is not updated on
     * `transferFrom`. This is semantically equivalent to an infinite approval.
     *
     * Requirements:
     *
     * - `spender` cannot be the zero address.
     */
    function approve(address spender, uint256 amount) public virtual override returns (bool) {
        address owner = _msgSender();
        _approve(owner, spender, amount);
        return true;
    }

    /**
     * @dev See {IERC20-transferFrom}.
     *
     * Emits an {Approval} event indicating the updated allowance. This is not
     * required by the EIP. See the note at the beginning of {ERC20}.
     *
     * NOTE: Does not update the allowance if the current allowance
     * is the maximum `uint256`.
     *
     * Requirements:
     *
     * - `from` and `to` cannot be the zero address.
     * - `from` must have a balance of at least `amount`.
     * - the caller must have allowance for ``from``'s tokens of at least
     * `amount`.
     */
    function transferFrom(address from, address to, uint256 amount) public virtual override returns (bool) {
        address spender = _msgSender();
        _spendAllowance(from, spender, amount);
        _transfer(from, to, amount);
        return true;
    }

    /**
     * @dev Atomically increases the allowance granted to `spender` by the caller.
     *
     * This is an alternative to {approve} that can be used as a mitigation for
     * problems described in {IERC20-approve}.
     *
     * Emits an {Approval} event indicating the updated allowance.
     *
     * Requirements:
     *
     * - `spender` cannot be the zero address.
     */
    function increaseAllowance(address spender, uint256 addedValue) public virtual returns (bool) {
        address owner = _msgSender();
        _approve(owner, spender, allowance(owner, spender) + addedValue);
        return true;
    }

    /**
     * @dev Atomically decreases the allowance granted to `spender` by the caller.
     *
     * This is an alternative to {approve} that can be used as a mitigation for
     * problems described in {IERC20-approve}.
     *
     * Emits an {Approval} event indicating the updated allowance.
     *
     * Requirements:
     *
     * - `spender` cannot be the zero address.
     * - `spender` must have allowance for the caller of at least
     * `subtractedValue`.
     */
    function decreaseAllowance(address spender, uint256 subtractedValue) public virtual returns (bool) {
        address owner = _msgSender();
        uint256 currentAllowance = allowance(owner, spender);
        require(currentAllowance >= subtractedValue, "ERC20: decreased allowance below zero");
        unchecked {
            _approve(owner, spender, currentAllowance - subtractedValue);
        }

        return true;
    }

    /**
     * @dev Moves `amount` of tokens from `from` to `to`.
     *
     * This internal function is equivalent to {transfer}, and can be used to
     * e.g. implement automatic token fees, slashing mechanisms, etc.
     *
     * Emits a {Transfer} event.
     *
     * Requirements:
     *
     * - `from` cannot be the zero address.
     * - `to` cannot be the zero address.
     * - `from` must have a balance of at least `amount`.
     */
    function _transfer(address from, address to, uint256 amount) internal virtual {
        require(from != address(0), "ERC20: transfer from the zero address");
        require(to != address(0), "ERC20: transfer to the zero address");

        _beforeTokenTransfer(from, to, amount);

        uint256 fromBalance = _balances[from];
        require(fromBalance >= amount, "ERC20: transfer amount exceeds balance");
        unchecked {
            _balances[from] = fromBalance - amount;
            // Overflow not possible: the sum of all balances is capped by totalSupply, and the sum is preserved by
            // decrementing then incrementing.
            _balances[to] += amount;
        }

        emit Transfer(from, to, amount);

        _afterTokenTransfer(from, to, amount);
    }

    /** @dev Creates `amount` tokens and assigns them to `account`, increasing
     * the total supply.
     *
     * Emits a {Transfer} event with `from` set to the zero address.
     *
     * Requirements:
     *
     * - `account` cannot be the zero address.
     */
    function _mint(address account, uint256 amount) internal virtual {
        require(account != address(0), "ERC20: mint to the zero address");

        _beforeTokenTransfer(address(0), account, amount);

        _totalSupply += amount;
        unchecked {
            // Overflow not possible: balance + amount is at most totalSupply + amount, which is checked above.
            _balances[account] += amount;
        }
        emit Transfer(address(0), account, amount);

        _afterTokenTransfer(address(0), account, amount);
    }

    /**
     * @dev Destroys `amount` tokens from `account`, reducing the
     * total supply.
     *
     * Emits a {Transfer} event with `to` set to the zero address.
     *
     * Requirements:
     *
     * - `account` cannot be the zero address.
     * - `account` must have at least `amount` tokens.
     */
    function _burn(address account, uint256 amount) internal virtual {
        require(account != address(0), "ERC20: burn from the zero address");

        _beforeTokenTransfer(account, address(0), amount);

        uint256 accountBalance = _balances[account];
        require(accountBalance >= amount, "ERC20: burn amount exceeds balance");
        unchecked {
            _balances[account] = accountBalance - amount;
            // Overflow not possible: amount <= accountBalance <= totalSupply.
            _totalSupply -= amount;
        }

        emit Transfer(account, address(0), amount);

        _afterTokenTransfer(account, address(0), amount);
    }

    /**
     * @dev Sets `amount` as the allowance of `spender` over the `owner` s tokens.
     *
     * This internal function is equivalent to `approve`, and can be used to
     * e.g. set automatic allowances for certain subsystems, etc.
     *
     * Emits an {Approval} event.
     *
     * Requirements:
     *
     * - `owner` cannot be the zero address.
     * - `spender` cannot be the zero address.
     */
    function _approve(address owner, address spender, uint256 amount) internal virtual {
        require(owner != address(0), "ERC20: approve from the zero address");
        require(spender != address(0), "ERC20: approve to the zero address");

        _allowances[owner][spender] = amount;
        emit Approval(owner, spender, amount);
    }

    /**
     * @dev Updates `owner` s allowance for `spender` based on spent `amount`.
     *
     * Does not update the allowance amount in case of infinite allowance.
     * Revert if not enough allowance is available.
     *
     * Might emit an {Approval} event.
     */
    function _spendAllowance(address owner, address spender, uint256 amount) internal virtual {
        uint256 currentAllowance = allowance(owner, spender);
        if (currentAllowance != type(uint256).max) {
            require(currentAllowance >= amount, "ERC20: insufficient allowance");
            unchecked {
                _approve(owner, spender, currentAllowance - amount);
            }
        }
    }

    /**
     * @dev Hook that is called before any transfer of tokens. This includes
     * minting and burning.
     *
     * Calling conditions:
     *
     * - when `from` and `to` are both non-zero, `amount` of ``from``'s tokens
     * will be transferred to `to`.
     * - when `from` is zero, `amount` tokens will be minted for `to`.
     * - when `to` is zero, `amount` of ``from``'s tokens will be burned.
     * - `from` and `to` are never both zero.
     *
     * To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks].
     */
    function _beforeTokenTransfer(address from, address to, uint256 amount) internal virtual {}

    /**
     * @dev Hook that is called after any transfer of tokens. This includes
     * minting and burning.
     *
     * Calling conditions:
     *
     * - when `from` and `to` are both non-zero, `amount` of ``from``'s tokens
     * has been transferred to `to`.
     * - when `from` is zero, `amount` tokens have been minted for `to`.
     * - when `to` is zero, `amount` of ``from``'s tokens have been burned.
     * - `from` and `to` are never both zero.
     *
     * To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks].
     */
    function _afterTokenTransfer(address from, address to, uint256 amount) internal virtual {}
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts v4.4.1 (token/ERC20/extensions/IERC20Metadata.sol)

pragma solidity ^0.8.0;

import "../IERC20.sol";

/**
 * @dev Interface for the optional metadata functions from the ERC20 standard.
 *
 * _Available since v4.1._
 */
interface IERC20Metadata is IERC20 {
    /**
     * @dev Returns the name of the token.
     */
    function name() external view returns (string memory);

    /**
     * @dev Returns the symbol of the token.
     */
    function symbol() external view returns (string memory);

    /**
     * @dev Returns the decimals places of the token.
     */
    function decimals() external view returns (uint8);
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.0) (token/ERC20/IERC20.sol)

pragma solidity ^0.8.0;

/**
 * @dev Interface of the ERC20 standard as defined in the EIP.
 */
interface IERC20 {
    /**
     * @dev Emitted when `value` tokens are moved from one account (`from`) to
     * another (`to`).
     *
     * Note that `value` may be zero.
     */
    event Transfer(address indexed from, address indexed to, uint256 value);

    /**
     * @dev Emitted when the allowance of a `spender` for an `owner` is set by
     * a call to {approve}. `value` is the new allowance.
     */
    event Approval(address indexed owner, address indexed spender, uint256 value);

    /**
     * @dev Returns the amount of tokens in existence.
     */
    function totalSupply() external view returns (uint256);

    /**
     * @dev Returns the amount of tokens owned by `account`.
     */
    function balanceOf(address account) external view returns (uint256);

    /**
     * @dev Moves `amount` tokens from the caller's account to `to`.
     *
     * Returns a boolean value indicating whether the operation succeeded.
     *
     * Emits a {Transfer} event.
     */
    function transfer(address to, uint256 amount) external returns (bool);

    /**
     * @dev Returns the remaining number of tokens that `spender` will be
     * allowed to spend on behalf of `owner` through {transferFrom}. This is
     * zero by default.
     *
     * This value changes when {approve} or {transferFrom} are called.
     */
    function allowance(address owner, address spender) external view returns (uint256);

    /**
     * @dev Sets `amount` as the allowance of `spender` over the caller's tokens.
     *
     * Returns a boolean value indicating whether the operation succeeded.
     *
     * IMPORTANT: Beware that changing an allowance with this method brings the risk
     * that someone may use both the old and the new allowance by unfortunate
     * transaction ordering. One possible solution to mitigate this race
     * condition is to first reduce the spender's allowance to 0 and set the
     * desired value afterwards:
     * https://github.com/ethereum/EIPs/issues/20#issuecomment-263524729
     *
     * Emits an {Approval} event.
     */
    function approve(address spender, uint256 amount) external returns (bool);

    /**
     * @dev Moves `amount` tokens from `from` to `to` using the
     * allowance mechanism. `amount` is then deducted from the caller's
     * allowance.
     *
     * Returns a boolean value indicating whether the operation succeeded.
     *
     * Emits a {Transfer} event.
     */
    function transferFrom(address from, address to, uint256 amount) external returns (bool);
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.4) (utils/Context.sol)

pragma solidity ^0.8.0;

/**
 * @dev Provides information about the current execution context, including the
 * sender of the transaction and its data. While these are generally available
 * via msg.sender and msg.data, they should not be accessed in such a direct
 * manner, since when dealing with meta-transactions the account sending and
 * paying for execution may not be the actual sender (as far as an application
 * is concerned).
 *
 * This contract is only required for intermediate, library-like contracts.
 */
abstract contract Context {
    function _msgSender() internal view virtual returns (address) {
        return msg.sender;
    }

    function _msgData() internal view virtual returns (bytes calldata) {
        return msg.data;
    }

    function _contextSuffixLength() internal view virtual returns (uint256) {
        return 0;
    }
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.2) (utils/cryptography/MerkleProof.sol)

pragma solidity ^0.8.0;

/**
 * @dev These functions deal with verification of Merkle Tree proofs.
 *
 * The tree and the proofs can be generated using our
 * https://github.com/OpenZeppelin/merkle-tree[JavaScript library].
 * You will find a quickstart guide in the readme.
 *
 * WARNING: You should avoid using leaf values that are 64 bytes long prior to
 * hashing, or use a hash function other than keccak256 for hashing leaves.
 * This is because the concatenation of a sorted pair of internal nodes in
 * the merkle tree could be reinterpreted as a leaf value.
 * OpenZeppelin's JavaScript library generates merkle trees that are safe
 * against this attack out of the box.
 */
library MerkleProof {
    /**
     * @dev Returns true if a `leaf` can be proved to be a part of a Merkle tree
     * defined by `root`. For this, a `proof` must be provided, containing
     * sibling hashes on the branch from the leaf to the root of the tree. Each
     * pair of leaves and each pair of pre-images are assumed to be sorted.
     */
    function verify(bytes32[] memory proof, bytes32 root, bytes32 leaf) internal pure returns (bool) {
        return processProof(proof, leaf) == root;
    }

    /**
     * @dev Calldata version of {verify}
     *
     * _Available since v4.7._
     */
    function verifyCalldata(bytes32[] calldata proof, bytes32 root, bytes32 leaf) internal pure returns (bool) {
        return processProofCalldata(proof, leaf) == root;
    }

    /**
     * @dev Returns the rebuilt hash obtained by traversing a Merkle tree up
     * from `leaf` using `proof`. A `proof` is valid if and only if the rebuilt
     * hash matches the root of the tree. When processing the proof, the pairs
     * of leafs & pre-images are assumed to be sorted.
     *
     * _Available since v4.4._
     */
    function processProof(bytes32[] memory proof, bytes32 leaf) internal pure returns (bytes32) {
        bytes32 computedHash = leaf;
        for (uint256 i = 0; i < proof.length; i++) {
            computedHash = _hashPair(computedHash, proof[i]);
        }
        return computedHash;
    }

    /**
     * @dev Calldata version of {processProof}
     *
     * _Available since v4.7._
     */
    function processProofCalldata(bytes32[] calldata proof, bytes32 leaf) internal pure returns (bytes32) {
        bytes32 computedHash = leaf;
        for (uint256 i = 0; i < proof.length; i++) {
            computedHash = _hashPair(computedHash, proof[i]);
        }
        return computedHash;
    }

    /**
     * @dev Returns true if the `leaves` can be simultaneously proven to be a part of a merkle tree defined by
     * `root`, according to `proof` and `proofFlags` as described in {processMultiProof}.
     *
     * CAUTION: Not all merkle trees admit multiproofs. See {processMultiProof} for details.
     *
     * _Available since v4.7._
     */
    function multiProofVerify(
        bytes32[] memory proof,
        bool[] memory proofFlags,
        bytes32 root,
        bytes32[] memory leaves
    ) internal pure returns (bool) {
        return processMultiProof(proof, proofFlags, leaves) == root;
    }

    /**
     * @dev Calldata version of {multiProofVerify}
     *
     * CAUTION: Not all merkle trees admit multiproofs. See {processMultiProof} for details.
     *
     * _Available since v4.7._
     */
    function multiProofVerifyCalldata(
        bytes32[] calldata proof,
        bool[] calldata proofFlags,
        bytes32 root,
        bytes32[] memory leaves
    ) internal pure returns (bool) {
        return processMultiProofCalldata(proof, proofFlags, leaves) == root;
    }

    /**
     * @dev Returns the root of a tree reconstructed from `leaves` and sibling nodes in `proof`. The reconstruction
     * proceeds by incrementally reconstructing all inner nodes by combining a leaf/inner node with either another
     * leaf/inner node or a proof sibling node, depending on whether each `proofFlags` item is true or false
     * respectively.
     *
     * CAUTION: Not all merkle trees admit multiproofs. To use multiproofs, it is sufficient to ensure that: 1) the tree
     * is complete (but not necessarily perfect), 2) the leaves to be proven are in the opposite order they are in the
     * tree (i.e., as seen from right to left starting at the deepest layer and continuing at the next layer).
     *
     * _Available since v4.7._
     */
    function processMultiProof(
        bytes32[] memory proof,
        bool[] memory proofFlags,
        bytes32[] memory leaves
    ) internal pure returns (bytes32 merkleRoot) {
        // This function rebuilds the root hash by traversing the tree up from the leaves. The root is rebuilt by
        // consuming and producing values on a queue. The queue starts with the `leaves` array, then goes onto the
        // `hashes` array. At the end of the process, the last hash in the `hashes` array should contain the root of
        // the merkle tree.
        uint256 leavesLen = leaves.length;
        uint256 proofLen = proof.length;
        uint256 totalHashes = proofFlags.length;

        // Check proof validity.
        require(leavesLen + proofLen - 1 == totalHashes, "MerkleProof: invalid multiproof");

        // The xxxPos values are "pointers" to the next value to consume in each array. All accesses are done using
        // `xxx[xxxPos++]`, which return the current value and increment the pointer, thus mimicking a queue's "pop".
        bytes32[] memory hashes = new bytes32[](totalHashes);
        uint256 leafPos = 0;
        uint256 hashPos = 0;
        uint256 proofPos = 0;
        // At each step, we compute the next hash using two values:
        // - a value from the "main queue". If not all leaves have been consumed, we get the next leaf, otherwise we
        //   get the next hash.
        // - depending on the flag, either another value from the "main queue" (merging branches) or an element from the
        //   `proof` array.
        for (uint256 i = 0; i < totalHashes; i++) {
            bytes32 a = leafPos < leavesLen ? leaves[leafPos++] : hashes[hashPos++];
            bytes32 b = proofFlags[i]
                ? (leafPos < leavesLen ? leaves[leafPos++] : hashes[hashPos++])
                : proof[proofPos++];
            hashes[i] = _hashPair(a, b);
        }

        if (totalHashes > 0) {
            require(proofPos == proofLen, "MerkleProof: invalid multiproof");
            unchecked {
                return hashes[totalHashes - 1];
            }
        } else if (leavesLen > 0) {
            return leaves[0];
        } else {
            return proof[0];
        }
    }

    /**
     * @dev Calldata version of {processMultiProof}.
     *
     * CAUTION: Not all merkle trees admit multiproofs. See {processMultiProof} for details.
     *
     * _Available since v4.7._
     */
    function processMultiProofCalldata(
        bytes32[] calldata proof,
        bool[] calldata proofFlags,
        bytes32[] memory leaves
    ) internal pure returns (bytes32 merkleRoot) {
        // This function rebuilds the root hash by traversing the tree up from the leaves. The root is rebuilt by
        // consuming and producing values on a queue. The queue starts with the `leaves` array, then goes onto the
        // `hashes` array. At the end of the process, the last hash in the `hashes` array should contain the root of
        // the merkle tree.
        uint256 leavesLen = leaves.length;
        uint256 proofLen = proof.length;
        uint256 totalHashes = proofFlags.length;

        // Check proof validity.
        require(leavesLen + proofLen - 1 == totalHashes, "MerkleProof: invalid multiproof");

        // The xxxPos values are "pointers" to the next value to consume in each array. All accesses are done using
        // `xxx[xxxPos++]`, which return the current value and increment the pointer, thus mimicking a queue's "pop".
        bytes32[] memory hashes = new bytes32[](totalHashes);
        uint256 leafPos = 0;
        uint256 hashPos = 0;
        uint256 proofPos = 0;
        // At each step, we compute the next hash using two values:
        // - a value from the "main queue". If not all leaves have been consumed, we get the next leaf, otherwise we
        //   get the next hash.
        // - depending on the flag, either another value from the "main queue" (merging branches) or an element from the
        //   `proof` array.
        for (uint256 i = 0; i < totalHashes; i++) {
            bytes32 a = leafPos < leavesLen ? leaves[leafPos++] : hashes[hashPos++];
            bytes32 b = proofFlags[i]
                ? (leafPos < leavesLen ? leaves[leafPos++] : hashes[hashPos++])
                : proof[proofPos++];
            hashes[i] = _hashPair(a, b);
        }

        if (totalHashes > 0) {
            require(proofPos == proofLen, "MerkleProof: invalid multiproof");
            unchecked {
                return hashes[totalHashes - 1];
            }
        } else if (leavesLen > 0) {
            return leaves[0];
        } else {
            return proof[0];
        }
    }

    function _hashPair(bytes32 a, bytes32 b) private pure returns (bytes32) {
        return a < b ? _efficientHash(a, b) : _efficientHash(b, a);
    }

    function _efficientHash(bytes32 a, bytes32 b) private pure returns (bytes32 value) {
        /// @solidity memory-safe-assembly
        assembly {
            mstore(0x00, a)
            mstore(0x20, b)
            value := keccak256(0x00, 0x40)
        }
    }
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts v4.4.1 (utils/introspection/IERC165.sol)

pragma solidity ^0.8.0;

/**
 * @dev Interface of the ERC165 standard, as defined in the
 * https://eips.ethereum.org/EIPS/eip-165[EIP].
 *
 * Implementers can declare support of contract interfaces, which can then be
 * queried by others ({ERC165Checker}).
 *
 * For an implementation, see {ERC165}.
 */
interface IERC165 {
    /**
     * @dev Returns true if this contract implements the interface defined by
     * `interfaceId`. See the corresponding
     * https://eips.ethereum.org/EIPS/eip-165#how-interfaces-are-identified[EIP section]
     * to learn more about how these ids are created.
     *
     * This function call must use less than 30 000 gas.
     */
    function supportsInterface(bytes4 interfaceId) external view returns (bool);
}

// SPDX-License-Identifier: Unlicensed

pragma solidity 0.8.25;

import {StringToAddress, AddressToString} from "@axelar-network/axelar-gmp-sdk-solidity/contracts/utils/AddressString.sol";
import {IAxelarGasService} from "@axelar-network/axelar-gmp-sdk-solidity/contracts/interfaces/IAxelarGasService.sol";
import {AxelarExecutable} from "@axelar-network/axelar-gmp-sdk-solidity/contracts/executable/AxelarExecutable.sol";
import {ILayerZeroEndpoint} from "@layerzerolabs/lz-evm-sdk-v1-0.7/contracts/interfaces/ILayerZeroEndpoint.sol";
import {IWormholeRelayer} from "../interfaces/IWormholeRelayer.sol";
import {ERC20} from "@openzeppelin/contracts/token/ERC20/ERC20.sol";
import {IBridgeToken} from "../interfaces/IBridgeToken.sol";

/// ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| \\\

/*
 * @title Bridge Contract
 *
 * @notice This contract facilitates cross-chain token bridging, utilising LayerZero, Axelar, and Wormhole protocols for interoperable token transfers.
 *
 * Co-Founders:
 * - Simran Dhillon: [email protected]
 * - Hardev Dhillon: [email protected]
 * - Dayana Plaz: [email protected]
 *
 * Official Links:
 * - Twitter: https://twitter.com/alixa_io
 * - Telegram: https://t.me/alixa_io
 * - Website: https://alixa.io
 *
 * Disclaimer:
 * This contract aligns with the principles of the Fair Crypto Foundation, promoting self-custody, transparency, consensus-based
 * trust, and permissionless value exchange. There are no administrative access keys, underscoring our commitment to decentralisation.
 * Engaging with this contract involves technical and legal risks. Users must conduct their own due diligence and ensure compliance
 * with local laws and regulations. The software is provided "AS-IS," without warranties, and the co-founders and developers disclaim
 * all liability for any vulnerabilities, exploits, errors, or breaches that may occur. By using this contract, users accept all associated
 * risks and this disclaimer. The co-founders, developers, or related parties will not bear liability for any consequences of non-compliance.
 *
 * Redistribution and Use:
 * Redistribution, modification, or repurposing of this contract, in whole or in part, is strictly prohibited without express written
 * approval from all co-founders. Approval requests must be sent to the official email addresses of the co-founders, ensuring responses
 * are received directly from these addresses. Proposals for redistribution, modification, or repurposing must include a detailed explanation
 * of the intended changes or uses and the reasons behind them. The co-founders reserve the right to request additional information or
 * clarification as necessary. Approval is at the sole discretion of the co-founders and may be subject to conditions to uphold the
 * project’s integrity and the values of the Fair Crypto Foundation. Failure to obtain express written approval prior to any redistribution,
 * modification, or repurposing will result in a breach of these terms and immediate legal action.
 *
 * Copyright and License:
 * Copyright © 2024 Alixa (Simran Dhillon, Hardev Dhillon, Dayana Plaz). All rights reserved.
 * This software is provided 'as is' and may be used by the recipient. No permission is granted for redistribution,
 * modification, or repurposing of this contract. Any use beyond the scope defined herein may be subject to legal action.
 */
abstract contract Bridge is
    AxelarExecutable,
    IBridgeToken,
    ERC20
{

    /// -------------------------------------------------------------------------------------------------------------------------------- \\\
    /// ----------------------------------------------------------- LIBRARIES ---------------------------------------------------------- \\\
    /// -------------------------------------------------------------------------------------------------------------------------------- \\\

    /**
     * @notice Converts string to address format.
     * @dev Attaches StringToAddress library functions to string type for address conversions.
     */
    using StringToAddress for string;

    /**
     * @notice Converts address to string format.
     * @dev Attaches AddressToString library functions to address type for string conversions.
     */
    using AddressToString for address;

    /// --------------------------------------------------------------------------------------------------------------------------------- \\\
    /// ---------------------------------------------------------- VARIABLES ------------------------------------------------------------ \\\
    /// --------------------------------------------------------------------------------------------------------------------------------- \\\

    /**
     * @notice Address of this token in string format.
     * @dev Used for identifying this contract's address across various bridging protocols.
     */
    string public addressThis;

    /**
     * @notice Total amount of tokens bridged across all chains.
     * @dev Tracks the cumulative number of tokens bridged across all supported chains.
     */
    uint256 totalBridgedAmount;

    /**
     * @notice Interface for LayerZero endpoint.
     * @dev Used for interacting with LayerZero for cross-chain token transfers.
     */
    ILayerZeroEndpoint public immutable ENDPOINT;

    /**
     * @notice Interface for Axelar gas service.
     * @dev Used for estimating and paying gas fees for Axelar's cross-chain operations.
     */
    IAxelarGasService public immutable GAS_SERVICE;

    /**
     * @notice Interface for Wormhole relayer.
     * @dev Facilitates cross-chain transfers using the Wormhole protocol.
     */
    IWormholeRelayer public immutable WORMHOLE_RELAYER;

    /// --------------------------------------------------------------------------------------------------------------------------------- \\\
    /// ----------------------------------------------------------- MAPPING ------------------------------------------------------------- \\\
    /// --------------------------------------------------------------------------------------------------------------------------------- \\\

    /**
     * @notice Mapping to prevent replay attacks.
     * @dev Stores processed delivery hashes to prevent duplicate processing of messages.
     */
    mapping (bytes32 => bool) public seenDeliveryVaaHashes;

    /// --------------------------------------------------------------------------------------------------------------------------------- \\\
    /// ----------------------------------------------------------- MODIFIER ------------------------------------------------------------ \\\
    /// --------------------------------------------------------------------------------------------------------------------------------- \\\

    /**
     * @notice Ensures that a Wormhole message is processed only once.
     * @dev Checks if the provided _deliveryHash has been seen before to prevent replay attacks.
     * @param _deliveryHash Unique hash representing the delivery message from the Wormhole relayer.
     */
    modifier replayProtect(bytes32 _deliveryHash) {
        if (seenDeliveryVaaHashes[_deliveryHash]) {
            revert WormholeMessageAlreadyProcessed();
        }
        seenDeliveryVaaHashes[_deliveryHash] = true;
        _;
    }

    /// --------------------------------------------------------------------------------------------------------------------------------- \\\
    /// ---------------------------------------------------------- CONSTRUCTOR ---------------------------------------------------------- \\\
    /// --------------------------------------------------------------------------------------------------------------------------------- \\\

    /**
     * @notice Initialises a new Bridge contract instance.
     * @dev Sets up essential external contracts and services for bridge operations.
     * @param _name The name of the bridge token.
     * @param _symbol The symbol of the bridge token.
     * @param _gateway The address of the Axelar gateway contract.
     * @param _gasService The address of the Axelar gas service contract.
     * @param _endpoint The address of the LayerZero endpoint contract.
     * @param _wormholeRelayer The address of the Wormhole relayer contract.
     */
    constructor(
        string memory _name,
        string memory _symbol,
        address _gateway,
        address _gasService,
        address _endpoint,
        address _wormholeRelayer
    ) ERC20(_name, _symbol) AxelarExecutable(_gateway) {
        GAS_SERVICE = IAxelarGasService(_gasService);
        ENDPOINT = ILayerZeroEndpoint(_endpoint);
        WORMHOLE_RELAYER = IWormholeRelayer(_wormholeRelayer);
        addressThis = address(this).toString();
    }

    /// --------------------------------------------------------------------------------------------------------------------------------- \\\
    /// ----------------------------------------------------- EXTERNAL FUNCTIONS -------------------------------------------------------- \\\
    /// --------------------------------------------------------------------------------------------------------------------------------- \\\

    /**
     * @notice Handles the receipt of ALX tokens sent via the LayerZero bridge.
     * @dev Mints ALX tokens for the recipient after a successful cross-chain transfer.
     * @param _srcChainId The source chain's identifier in the LayerZero network.
     * @param _srcAddress Encoded source address from which the tokens were sent.
     * @param _payload Encoded data comprising sender's and recipient's addresses and token amount.
     */
    function lzReceive(
        uint16 _srcChainId,
        bytes memory _srcAddress,
        uint64,
        bytes memory _payload
    ) external override {
        if (address(ENDPOINT) != msg.sender) {
            revert NotVerifiedCaller();
        }
        if (address(this) != address(uint160(bytes20(_srcAddress)))) {
            revert InvalidLayerZeroSourceAddress();
        }
        (address _from, address _to, uint256 _amount) = abi.decode(
            _payload,
            (address, address, uint256)
        );
        _mint(_to, _amount);
        emit BridgeReceive(
            _to,
            _amount,
            BridgeId.LayerZero,
            abi.encode(_srcChainId),
            _from
        );
        if (block.chainid == 1) {
            totalBridgedAmount -= _amount;
        }
    }

    /// --------------------------------------------------------------------------------------------------------------------------------- \\\

    /**
     * @notice Handles incoming token transfers via the Wormhole bridge.
     * @dev Extracts transfer details from payload, mints tokens to the recipient, and updates state.
     * @param _payload Encoded information including recipient's address and token amount.
     * @param _sourceAddress The originating address from the source chain.
     * @param _srcChainId Identifier of the source chain.
     * @param _deliveryHash Unique hash for replay protection and verification.
     */
    function receiveWormholeMessages(
        bytes memory _payload,
        bytes[] memory,
        bytes32 _sourceAddress,
        uint16 _srcChainId,
        bytes32 _deliveryHash
    )
        external
        payable
        override
        replayProtect(_deliveryHash)
    {
        if (msg.sender != address(WORMHOLE_RELAYER)) {
            revert OnlyRelayerAllowed();
        }
        if (address(this) != address(uint160(uint256(_sourceAddress)))) {
            revert InvalidWormholeSourceAddress();
        }
        (address _from, address _to, uint256 _amount) = abi.decode(
            _payload,
            (address, address, uint256)
        );
        _mint(_to, _amount);
        emit BridgeReceive(
            _to,
            _amount,
            BridgeId.Wormhole,
            abi.encode(_srcChainId),
            _from
        );
        if (block.chainid == 1) {
            totalBridgedAmount -= _amount;
        }
    }

    /// --------------------------------------------------------------------------------------------------------------------------------- \\\
    /// ------------------------------------------------------ PUBLIC FUNCTIONS --------------------------------------------------------- \\\
    /// --------------------------------------------------------------------------------------------------------------------------------- \\\

    /**
     * @notice Bridges tokens to a specified chain using the LayerZero protocol.
     * @dev Burns tokens from sender, constructs payload, and initiates bridge operation.
     * @param _dstChainId The ID of the destination chain within the LayerZero network.
     * @param _from The address initiating the token bridge on the source chain.
     * @param _to The address on the destination chain to receive the tokens.
     * @param _amount The number of tokens to bridge.
     * @param _feeRefundAddress The address to receive refunds for any excess fee paid.
     * @param _zroPaymentAddress Address holding ZRO tokens to cover fees, if applicable.
     * @param _adapterParams Parameters for the LayerZero adapter.
     */
    function bridgeViaLayerZero(
        uint16 _dstChainId,
        address _from,
        address _to,
        uint256 _amount,
        address payable _feeRefundAddress,
        address _zroPaymentAddress,
        bytes calldata _adapterParams
    )
        public
        payable
        override
    {
        if (_zroPaymentAddress == address(0)) {
            if (msg.value < estimateGasForLayerZero(
                    _dstChainId,
                    _from,
                    _to,
                    _amount,
                    false,
                    _adapterParams
                    )
                )
            {
                revert InsufficientFee();
            }
        }
        else {
            if (msg.value < estimateGasForLayerZero(
                    _dstChainId,
                    _from,
                    _to,
                    _amount,
                    true,
                    _adapterParams
                    )
                )
            {
                revert InsufficientFee();
            }
        }
        if (msg.sender != _from)
            _spendAllowance(
                _from,
                msg.sender,
                _amount
            );
        _burn(_from, _amount);
        if (_to == address(0)) {
            revert InvalidToAddress();
        }
        ENDPOINT.send{value: msg.value} (
            _dstChainId,
            abi.encodePacked(address(this),address(this)),
            abi.encode(
                _from,
                _to,
                _amount
            ),
            _feeRefundAddress,
            _zroPaymentAddress,
            _adapterParams
        );
        emit BridgeTransfer(
            _from,
            _amount,
            BridgeId.LayerZero,
            abi.encode(_dstChainId),
            _to
        );
        if (block.chainid == 1) {
            totalBridgedAmount += _amount;
        }
    }

    /// --------------------------------------------------------------------------------------------------------------------------------- \\\

    /**
     * @notice Bridges tokens to a specified chain using the Axelar network.
     * @dev Encodes transaction details, invokes Axelar gateway, and burns bridged tokens.
     * @param _destinationChain The identifier of the destination chain within the Axelar network.
     * @param _from The address sending the tokens on the source chain.
     * @param _to The intended recipient address on the destination chain.
     * @param _amount The number of tokens to be bridged.
     * @param _feeRefundAddress The address to which any excess ETH should be refunded.
     */
    function bridgeViaAxelar(
        string calldata _destinationChain,
        address _from,
        address _to,
        uint256 _amount,
        address payable _feeRefundAddress
    )
        public
        payable
        override
    {
        bytes memory payload = abi.encode(_from, _to, _amount);
        string memory _ALXAddress = addressThis;
        if (msg.value != 0) {
            GAS_SERVICE.payNativeGasForContractCall{value: msg.value} (
                address(this),
                _destinationChain,
                _ALXAddress,
                payload,
                _feeRefundAddress
            );
        }
        if (_from != msg.sender)
            _spendAllowance(
                _from,
                msg.sender,
                _amount
            );
        _burn(_from, _amount);
        if (_to == address(0)) {
            revert InvalidToAddress();
        }
        gateway.callContract(
            _destinationChain,
            _ALXAddress,
            payload
        );
        emit BridgeTransfer(
            _from,
            _amount,
            BridgeId.Axelar,
            abi.encode(_destinationChain),
            _to
        );
        if (block.chainid == 1) {
            totalBridgedAmount += _amount;
        }
    }

    /// --------------------------------------------------------------------------------------------------------------------------------- \\\

    /**
     * @notice Bridges tokens to a specified chain using the Wormhole network.
     * @dev Estimates gas fee, burns tokens from sender, and initiates bridge process via Wormhole relayer.
     * @param _targetChain The identifier of the destination chain within the Wormhole network.
     * @param _from The address initiating the token bridge on the source chain.
     * @param _to The intended recipient address on the target chain.
     * @param _amount The quantity of tokens to be bridged.
     * @param _feeRefundAddress The address to which any excess fees should be refunded.
     * @param _gasLimit The gas limit for processing the transaction on the destination chain.
     */
    function bridgeViaWormhole(
        uint16 _targetChain,
        address _from,
        address _to,
        uint256 _amount,
        address payable _feeRefundAddress,
        uint256 _gasLimit
    )
        public
        payable
        override
    {
        uint256 cost = estimateGasForWormhole(_targetChain, _gasLimit);
        if (msg.value < cost) {
            revert InsufficientFeeForWormhole();
        }
        if (msg.sender != _from)
            _spendAllowance(
                _from,
                msg.sender,
                _amount
            );
        _burn(_from, _amount);
        if (_to == address(0)) {
            revert InvalidToAddress();
        }
        WORMHOLE_RELAYER.sendPayloadToEvm{value: msg.value} (
            _targetChain,
            address(this),
            abi.encode(_from, _to, _amount),
            0,
            _gasLimit,
            _targetChain,
            _feeRefundAddress
        );
        emit BridgeTransfer(
            _from,
            _amount,
            BridgeId.Wormhole,
            abi.encode(_targetChain),
            _to
        );
        if (block.chainid == 1) {
            totalBridgedAmount += _amount;
        }
    }

    /// --------------------------------------------------------------------------------------------------------------------------------- \\\

    /**
     * @notice Estimates the bridging fee on LayerZero for token transfer.
     * @dev Invokes the `estimateFees` function from LayerZero's endpoint contract.
     * @param _dstChainId The destination chain ID on LayerZero.
     * @param _from The address sending tokens on the source chain.
     * @param _to The address receiving tokens on the destination chain.
     * @param _amount The amount of tokens being bridged.
     * @param _payInZRO Indicates if the fee will be paid in ZRO token.
     * @param _adapterParam Adapter-specific parameters that may affect fee calculation.
     * @return nativeFee_ The estimated fee for the bridging operation in the native chain token.
     */
    function estimateGasForLayerZero(
        uint16 _dstChainId,
        address _from,
        address _to,
        uint256 _amount,
        bool _payInZRO,
        bytes calldata _adapterParam
    )
        public
        override
        view
        returns (uint256 nativeFee_)
    {
        (nativeFee_, ) = ENDPOINT.estimateFees(
            _dstChainId,
            address(this),
            abi.encode(_from, _to, _amount),
            _payInZRO,
            _adapterParam
        );
    }

    /// --------------------------------------------------------------------------------------------------------------------------------- \\\

    /**
     * @notice Estimates the bridging fee using the Wormhole network for a specific transaction.
     * @dev Calls the `quoteEVMDeliveryPrice` function on the Wormhole relayer contract.
     * @param _targetChain The ID of the target chain within the Wormhole network.
     * @param _gasLimit The gas limit specified for the transaction on the destination chain.
     * @return cost_ The estimated cost for using Wormhole to bridge the transaction.
     */
    function estimateGasForWormhole(uint16 _targetChain, uint256 _gasLimit)
        public
        override
        view
        returns (uint256 cost_)
    {
        (cost_, ) = WORMHOLE_RELAYER.quoteEVMDeliveryPrice(
            _targetChain,
            0,
            _gasLimit
        );
    }

    /// --------------------------------------------------------------------------------------------------------------------------------- \\\
    /// ------------------------------------------------------ INTERNAL FUNCTION -------------------------------------------------------- \\\
    /// --------------------------------------------------------------------------------------------------------------------------------- \\\

    /**
     * @notice Processes the minting of tokens based on a cross-chain transaction.
     * @dev Decodes the payload, validates the source address, and mints tokens to the recipient.
     * @param _sourceChain Identifies the blockchain from which the cross-chain request originated.
     * @param _sourceAddress The address on the source chain that initiated the mint request.
     * @param _payload Encoded data containing the details of the mint operation.
     */
    function _execute(
        string calldata _sourceChain,
        string calldata _sourceAddress,
        bytes calldata _payload
    ) internal override {
        if (_sourceAddress.toAddress() != address(this)) {
            revert InvalidSourceAddress();
        }
        (address _from, address _to, uint256 _amount) = abi.decode(
            _payload,
            (address, address, uint256)
        );
        _mint(_to, _amount);
        emit BridgeReceive(
            _to,
            _amount,
            BridgeId.Axelar,
            abi.encode(_sourceChain),
            _from
        );
        if (block.chainid == 1) {
            totalBridgedAmount -= _amount;
        }
    }

    /// --------------------------------------------------------------------------------------------------------------------------------- \\\
}

// SPDX-License-Identifier: Unlicensed

pragma solidity 0.8.25;

import {IERC20} from "@openzeppelin/contracts/token/ERC20/IERC20.sol";
import {IBurnableToken} from "./IBurnableToken.sol";
import {IBridgeToken} from "./IBridgeToken.sol";

/// ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| \\\

/*
 * @title IALX Interface
 *
 * @notice Interface for the ALX token, incorporating ERC20, burnable, and bridgeable functionalities.
 *
 * Co-Founders:
 * - Simran Dhillon: [email protected]
 * - Hardev Dhillon: [email protected]
 * - Dayana Plaz: [email protected]
 *
 * Official Links:
 * - Twitter: https://twitter.com/alixa_io
 * - Telegram: https://t.me/alixa_io
 * - Website: https://alixa.io
 *
 * Disclaimer:
 * This interface aligns with the principles of the Fair Crypto Foundation, promoting self-custody, transparency, consensus-based
 * trust, and permissionless value exchange. There are no administrative access keys, underscoring our commitment to decentralisation.
 * Engaging with this interface involves technical and legal risks. Users must conduct their own due diligence and ensure compliance
 * with local laws and regulations. The software is provided "AS-IS," without warranties, and the co-founders and developers disclaim
 * all liability for any vulnerabilities, exploits, errors, or breaches that may occur. By using this interface, users accept all associated
 * risks and this disclaimer. The co-founders, developers, or related parties will not bear liability for any consequences of non-compliance.
 *
 * Redistribution and Use:
 * Redistribution, modification, or repurposing of this interface, in whole or in part, is strictly prohibited without express written
 * approval from all co-founders. Approval requests must be sent to the official email addresses of the co-founders, ensuring responses
 * are received directly from these addresses. Proposals for redistribution, modification, or repurposing must include a detailed explanation
 * of the intended changes or uses and the reasons behind them. The co-founders reserve the right to request additional information or
 * clarification as necessary. Approval is at the sole discretion of the co-founders and may be subject to conditions to uphold the
 * project’s integrity and the values of the Fair Crypto Foundation. Failure to obtain express written approval prior to any redistribution,
 * modification, or repurposing will result in a breach of these terms and immediate legal action.
 *
 * Copyright and License:
 * Copyright © 2024 Alixa (Simran Dhillon, Hardev Dhillon, Dayana Plaz). All rights reserved.
 * This software is provided 'as is' and may be used by the recipient. No permission is granted for redistribution,
 * modification, or repurposing of this interface. Any use beyond the scope defined herein may be subject to legal action.
 */
interface IALX is
    IBurnableToken,
    IBridgeToken,
    IERC20
{

    /// --------------------------------------------------------------------------------------------------------------------------------- \\\
    /// ------------------------------------------------------------ ERRORS ------------------------------------------------------------- \\\
    /// --------------------------------------------------------------------------------------------------------------------------------- \\\

    /**
     * @notice Thrown when attempting to mint tokens to the zero address.
     * @dev Prevents minting to invalid addresses, maintaining token integrity.
     */
    error ZeroAddress();

    /**
     * @notice Thrown when an unauthorised caller attempts a restricted function.
     * @dev Ensures only approved entities can perform sensitive operations.
     */
    error InvalidCaller();

    /**
     * @notice Thrown when attempting to set the Core address more than once.
     * @dev Maintains protocol integrity by allowing Core address to be set only once.
     */
    error CoreAlreadySet();

    /**
     * @notice Thrown when a minting operation would exceed the maximum supply.
     * @dev Enforces the predefined maximum supply limit for ALX tokens.
     */
    error ExceedsMaxSupply();

    /**
     * @notice Thrown when the maximum supply cap has been reached.
     * @dev Prevents further minting once the maximum token supply is achieved.
     */
    error MaxSupplyExceeded();

    /**
     * @notice Thrown when an invalid claim proof is provided for an airdrop.
     * @dev Ensures the validity of Merkle proofs in airdrop claims.
     */
    error InvalidClaimProof();

    /**
     * @notice Thrown when an unsupported interface is accessed.
     * @dev Restricts interactions to only supported interfaces.
     */
    error UnsupportedInterface();

    /**
     * @notice Thrown when a user attempts to claim an airdrop more than once.
     * @dev Prevents multiple airdrop claims by the same user.
     */
    error AirdropAlreadyClaimed();

    /**
     * @notice Thrown when attempting to claim an airdrop outside the active period.
     * @dev Enforces the time constraints for airdrop claims.
     */
    error AirdropPeriodNotActive();

    /// --------------------------------------------------------------------------------------------------------------------------------- \\\
    /// ------------------------------------------------------------ EVENT -------------------------------------------------------------- \\\
    /// --------------------------------------------------------------------------------------------------------------------------------- \\\

    /**
     * @notice Emitted when a user successfully claims their airdrop.
     * @param _user Address of the user claiming the airdrop.
     * @param _amount Amount of tokens claimed in the airdrop.
     */
    event Airdropped(address indexed _user, uint256 _amount);

    /// --------------------------------------------------------------------------------------------------------------------------------- \\\
    /// ----------------------------------------------------- EXTERNAL FUNCTIONS -------------------------------------------------------- \\\
    /// --------------------------------------------------------------------------------------------------------------------------------- \\\

    /**
     * @notice Sets the ALX-vXNF POL address.
     * @dev Can only be set once for protocol security.
     * @param _ALXPOL The address of the ALX-vXNF POL contract.
     */
    function setPool(address _ALXPOL) external;

    /// --------------------------------------------------------------------------------------------------------------------------------- \\\

    /**
     * @notice Burns ALX tokens from a specified user's account.
     * @dev Reduces total supply by destroying tokens from the user's balance.
     * @param _user The address from which tokens will be burned.
     * @param _amount The amount of tokens to burn.
     */
    function burn(address _user, uint256 _amount) external;

    /// --------------------------------------------------------------------------------------------------------------------------------- \\\

    /**
     * @notice Mints ALX tokens to a specified account.
     * @dev Allows authorised entities to create new ALX tokens.
     * @param _account The address to which new tokens will be minted.
     * @param _amount The amount of tokens to mint.
     */
    function mint(address _account, uint256 _amount) external;

    /// --------------------------------------------------------------------------------------------------------------------------------- \\\

    /**
     * @notice Claims airdropped tokens using a Merkle proof.
     * @dev Verifies claim eligibility and mints tokens to the claimant.
     * @param _proof Array of bytes32 values representing the Merkle proof.
     * @param _airdroppedAmount Total amount of tokens airdropped to the user.
     * @param _amountToClaim Amount of tokens being claimed in this transaction.
     */
    function claim(
        bytes32[] calldata _proof,
        uint256 _airdroppedAmount,
        uint256 _amountToClaim
    ) external;

    /// --------------------------------------------------------------------------------------------------------------------------------- \\\

    /**
     * @notice Purchases bonds using airdropped ALX tokens.
     * @dev Verifies airdrop eligibility before processing bond purchase.
     * @param _proof Merkle proof for airdrop verification.
     * @param _user Address of the bond purchaser.
     * @param _bondPower Power (tier) of the bond being purchased.
     * @param _bondCount Number of bonds to purchase.
     * @param _daysCount Duration of the bond in days.
     * @param _airdroppedAmount Total airdropped tokens available to the user.
     */
    function purchaseBondWithAirdroppedALX(
        bytes32[] calldata _proof,
        address _user,
        uint256 _bondPower,
        uint256 _bondCount,
        uint256 _daysCount,
        uint256 _airdroppedAmount
    ) external;

    /// --------------------------------------------------------------------------------------------------------------------------------- \\\

    /**
     * @notice Stakes airdropped ALX tokens.
     * @dev Verifies airdrop eligibility before processing the stake.
     * @param _proof Merkle proof for airdrop verification.
     * @param _user Address of the user staking tokens.
     * @param _duration Staking duration.
     * @param _amountToStake Amount of tokens to stake.
     * @param _airdroppedAmount Total airdropped tokens available to the user.
     */
    function stakeWithAirdroppedALX(
        bytes32[] calldata _proof,
        address _user,
        uint256 _duration,
        uint256 _amountToStake,
        uint256 _airdroppedAmount
    ) external;

    /// --------------------------------------------------------------------------------------------------------------------------------- \\\
}

// SPDX-License-Identifier: Unlicensed

pragma solidity 0.8.25;

/*
 * @title IBridge Interface
 *
 * @notice Interface defining the functions and events for token bridging operations.
 *
 * Co-Founders:
 * - Simran Dhillon: [email protected]
 * - Hardev Dhillon: [email protected]
 * - Dayana Plaz: [email protected]
 *
 * Official Links:
 * - Twitter: https://twitter.com/alixa_io
 * - Telegram: https://t.me/alixa_io
 * - Website: https://alixa.io
 *
 * Disclaimer:
 * This interface aligns with the principles of the Fair Crypto Foundation, promoting self-custody, transparency, consensus-based
 * trust, and permissionless value exchange. There are no administrative access keys, underscoring our commitment to decentralisation.
 * Engaging with this interface involves technical and legal risks. Users must conduct their own due diligence and ensure compliance
 * with local laws and regulations. The software is provided "AS-IS," without warranties, and the co-founders and developers disclaim
 * all liability for any vulnerabilities, exploits, errors, or breaches that may occur. By using this interface, users accept all associated
 * risks and this disclaimer. The co-founders, developers, or related parties will not bear liability for any consequences of non-compliance.
 *
 * Redistribution and Use:
 * Redistribution, modification, or repurposing of this interface, in whole or in part, is strictly prohibited without express written
 * approval from all co-founders. Approval requests must be sent to the official email addresses of the co-founders, ensuring responses
 * are received directly from these addresses. Proposals for redistribution, modification, or repurposing must include a detailed explanation
 * of the intended changes or uses and the reasons behind them. The co-founders reserve the right to request additional information or
 * clarification as necessary. Approval is at the sole discretion of the co-founders and may be subject to conditions to uphold the
 * project’s integrity and the values of the Fair Crypto Foundation. Failure to obtain express written approval prior to any redistribution,
 * modification, or repurposing will result in a breach of these terms and immediate legal action.
 *
 * Copyright and License:
 * Copyright © 2024 Alixa (Simran Dhillon, Hardev Dhillon, Dayana Plaz). All rights reserved.
 * This software is provided 'as is' and may be used by the recipient. No permission is granted for redistribution,
 * modification, or repurposing of this interface. Any use beyond the scope defined herein may be subject to legal action.
 */
interface IBridgeToken {

    /// --------------------------------------------------------------------------------------------------------------------------------- \\\
    /// ------------------------------------------------------------- ENUM -------------------------------------------------------------- \\\
    /// --------------------------------------------------------------------------------------------------------------------------------- \\\

    /**
     * @notice Enumerates the types of bridges supported.
     * @dev Defines different bridge protocols for cross-chain operations.
     */
    enum BridgeId {
        LayerZero,
        Wormhole,
        Axelar
    }

    /// --------------------------------------------------------------------------------------------------------------------------------- \\\
    /// ------------------------------------------------------------ EVENTS ------------------------------------------------------------- \\\
    /// --------------------------------------------------------------------------------------------------------------------------------- \\\

    /**
     * @notice Emitted when tokens are received through a bridge.
     * @param to Recipient address on the destination chain.
     * @param amount Amount of tokens received.
     * @param bridgeId Identifier of the bridge protocol used.
     * @param fromChainId Identifier of the source chain.
     * @param from Sender address on the source chain.
     */
    event BridgeReceive(
        address indexed to,
        uint256 amount,
        BridgeId bridgeId,
        bytes fromChainId,
        address indexed from
    );

   /// --------------------------------------------------------------------------------------------------------------------------------- \\\

    /**
     * @notice Emitted when tokens are sent to another chain via a bridge.
     * @param from Sender address on the source chain.
     * @param amount Amount of tokens transferred.
     * @param bridgeId Bridge protocol used for the transfer.
     * @param toChainId Destination chain identifier.
     * @param to Recipient address on the destination chain.
     */
    event BridgeTransfer(
        address indexed from,
        uint256 amount,
        BridgeId bridgeId,
        bytes toChainId,
        address indexed to
    );

    /// --------------------------------------------------------------------------------------------------------------------------------- \\\
    /// ------------------------------------------------------------ ERRORS ------------------------------------------------------------- \\\
    /// --------------------------------------------------------------------------------------------------------------------------------- \\\

    /**
     * @notice Error for when the provided fee is insufficient.
     * @dev Ensures adequate fees for bridging to prevent transaction failures.
     */
    error InsufficientFee();

    /**
     * @notice Error for when the recipient address is invalid.
     * @dev Validates recipient address to prevent sending to invalid addresses.
     */
    error InvalidToAddress();

    /**
     * @notice Error for when a non-verified caller attempts an operation.
     * @dev Prevents unauthorised access to bridge functions.
     */
    error NotVerifiedCaller();

    /**
     * @notice Error indicating that the operation is restricted to the relayer.
     * @dev Ensures only the designated relayer can perform certain operations.
     */
    error OnlyRelayerAllowed();

    /**
     * @notice Error for when the source address is invalid.
     * @dev Validates source address to prevent security risks or incorrect attributions.
     */
    error InvalidSourceAddress();

    /**
     * @notice Error for when the fee for Wormhole bridging is insufficient.
     * @dev Ensures adequate fees specifically for Wormhole bridging.
     */
    error InsufficientFeeForWormhole();

    /**
     * @notice Error for when the Wormhole source address is invalid.
     * @dev Validates source address in Wormhole bridging for transfer integrity.
     */
    error InvalidWormholeSourceAddress();

    /**
     * @notice Error for when the LayerZero source address is invalid.
     * @dev Validates source address in LayerZero bridging for secure transfers.
     */
    error InvalidLayerZeroSourceAddress();

    /**
     * @notice Error for when a Wormhole message is replayed.
     * @dev Prevents replay attacks in Wormhole bridging operations.
     */
    error WormholeMessageAlreadyProcessed();

    /// --------------------------------------------------------------------------------------------------------------------------------- \\\
    /// ----------------------------------------------------- EXTERNAL FUNCTIONS -------------------------------------------------------- \\\
    /// --------------------------------------------------------------------------------------------------------------------------------- \\\

    /**
     * @notice Receives tokens via LayerZero.
     * @dev Handles incoming LayerZero bridging operations.
     * @param _srcChainId Source chain ID on LayerZero network.
     * @param _srcAddress Source address of the ALX token sender.
     * @param _payload Encoded data with recipient address and amount.
     */
    function lzReceive(
        uint16 _srcChainId,
        bytes memory _srcAddress,
        uint64,
        bytes memory _payload
    ) external;

    /// --------------------------------------------------------------------------------------------------------------------------------- \\\

    /**
     * @notice Receives tokens via Wormhole.
     * @dev Handles incoming Wormhole bridging operations.
     * @param _payload Encoded data with user address and amount.
     * @param _sourceAddress Caller's address on source chain in bytes32.
     * @param _srcChainId Source chain ID.
     * @param _deliveryHash Hash for verifying relay calls.
     */
    function receiveWormholeMessages(
        bytes memory _payload,
        bytes[] memory,
        bytes32 _sourceAddress,
        uint16 _srcChainId,
        bytes32 _deliveryHash
    ) external payable;

    /// --------------------------------------------------------------------------------------------------------------------------------- \\\

    /**
     * @notice Bridges tokens to another chain via LayerZero.
     * @dev Facilitates LayerZero token transfer, handling locking and messaging.
     * @param _dstChainId Target chain ID on LayerZero.
     * @param _from Sender's address on source chain.
     * @param _to Recipient's address on destination chain.
     * @param _amount Amount of tokens to bridge.
     * @param _feeRefundAddress Address for excess fee refunds.
     * @param _zroPaymentAddress ZRO token holder address for fees.
     * @param _adapterParams Additional parameters for custom functionalities.
     */
    function bridgeViaLayerZero(
        uint16 _dstChainId,
        address _from,
        address _to,
        uint256 _amount,
        address payable _feeRefundAddress,
        address _zroPaymentAddress,
        bytes calldata _adapterParams
    ) external payable;

    /// --------------------------------------------------------------------------------------------------------------------------------- \\\

    /**
     * @notice Bridges tokens to another chain via Axelar.
     * @dev Facilitates Axelar token transfer, handling locking and messaging.
     * @param _destinationChain Target chain ID on Axelar.
     * @param _from Sender's address on source chain.
     * @param _to Recipient's address on destination chain.
     * @param _amount Amount of tokens to bridge.
     * @param _feeRefundAddress Address for excess fee refunds.
     */
    function bridgeViaAxelar(
        string calldata _destinationChain,
        address _from,
        address _to,
        uint256 _amount,
        address payable _feeRefundAddress
    ) external payable;

    /// --------------------------------------------------------------------------------------------------------------------------------- \\\

    /**
     * @notice Bridges tokens to another chain via Wormhole.
     * @dev Facilitates Wormhole token transfer, handling locking and messaging.
     * @param _targetChain Target chain ID on Wormhole.
     * @param _from Sender's address on source chain.
     * @param _to Recipient's address on destination chain.
     * @param _amount Amount of tokens to bridge.
     * @param _feeRefundAddress Address for excess fee refunds.
     * @param _gasLimit Gas limit for the transaction on destination chain.
     */
    function bridgeViaWormhole(
        uint16 _targetChain,
        address _from,
        address _to,
        uint256 _amount,
        address payable _feeRefundAddress,
        uint256 _gasLimit
    ) external payable;

    /// --------------------------------------------------------------------------------------------------------------------------------- \\\

    /**
     * @notice Estimates the gas required for LayerZero bridging.
     * @dev Provides gas fee estimate for LayerZero bridging.
     * @param _dstChainId Destination chain ID on LayerZero.
     * @param _from Sender's address on source chain.
     * @param _to Recipient's address on destination chain.
     * @param _amount Amount of tokens to bridge.
     * @param _payInZRO True if fee is paid in ZRO tokens, false for native tokens.
     * @param _adapterParam Parameters for adapter services.
     * @return nativeFee_ Estimated fee in native tokens of destination chain.
     */
    function estimateGasForLayerZero(
        uint16 _dstChainId,
        address _from,
        address _to,
        uint256 _amount,
        bool _payInZRO,
        bytes calldata _adapterParam
    )
        external
        view
        returns (uint256 nativeFee_);

    /// --------------------------------------------------------------------------------------------------------------------------------- \\\

    /**
     * @notice Estimates the gas required for Wormhole bridging.
     * @dev Provides gas fee estimate for Wormhole bridging.
     * @param _targetChain Destination chain ID on Wormhole.
     * @param _gasLimit Gas limit for the transaction on destination chain.
     * @return cost_ Estimated fee in native tokens of source chain.
     */
    function estimateGasForWormhole(uint16 _targetChain, uint256 _gasLimit)
        external
        view
        returns (uint256 cost_);

    /// --------------------------------------------------------------------------------------------------------------------------------- \\\
}

// SPDX-License-Identifier: Unlicensed

pragma solidity 0.8.25;

/*
 * @title IBurnableToken Interface
 *
 * @notice Defines the functionality for tokens that can be burned, reducing the total supply irreversibly.
 *
 * Co-Founders:
 * - Simran Dhillon: [email protected]
 * - Hardev Dhillon: [email protected]
 * - Dayana Plaz: [email protected]
 *
 * Official Links:
 * - Twitter: https://twitter.com/alixa_io
 * - Telegram: https://t.me/alixa_io
 * - Website: https://alixa.io
 *
 * Disclaimer:
 * This interface aligns with the principles of the Fair Crypto Foundation, promoting self-custody, transparency, consensus-based
 * trust, and permissionless value exchange. There are no administrative access keys, underscoring our commitment to decentralisation.
 * Engaging with this interface involves technical and legal risks. Users must conduct their own due diligence and ensure compliance
 * with local laws and regulations. The software is provided "AS-IS," without warranties, and the co-founders and developers disclaim
 * all liability for any vulnerabilities, exploits, errors, or breaches that may occur. By using this interface, users accept all associated
 * risks and this disclaimer. The co-founders, developers, or related parties will not bear liability for any consequences of non-compliance.
 *
 * Redistribution and Use:
 * Redistribution, modification, or repurposing of this interface, in whole or in part, is strictly prohibited without express written
 * approval from all co-founders. Approval requests must be sent to the official email addresses of the co-founders, ensuring responses
 * are received directly from these addresses. Proposals for redistribution, modification, or repurposing must include a detailed explanation
 * of the intended changes or uses and the reasons behind them. The co-founders reserve the right to request additional information or
 * clarification as necessary. Approval is at the sole discretion of the co-founders and may be subject to conditions to uphold the
 * project’s integrity and the values of the Fair Crypto Foundation. Failure to obtain express written approval prior to any redistribution,
 * modification, or repurposing will result in a breach of these terms and immediate legal action.
 *
 * Copyright and License:
 * Copyright © 2024 Alixa (Simran Dhillon, Hardev Dhillon, Dayana Plaz). All rights reserved.
 * This software is provided 'as is' and may be used by the recipient. No permission is granted for redistribution,
 * modification, or repurposing of this interface. Any use beyond the scope defined herein may be subject to legal action.
 */
interface IBurnableToken {

    /// --------------------------------------------------------------------------------------------------------------------------------- \\\
    /// ------------------------------------------------------ EXTERNAL FUNCTION -------------------------------------------------------- \\\
    /// --------------------------------------------------------------------------------------------------------------------------------- \\\

    /**
     * @notice Burns a specific amount of tokens from a user's account.
     * @dev Reduces total supply by destroying specified amount of tokens.
     * @param _user Address from which tokens will be burned.
     * @param _amount Number of tokens to be burned.
     */
    function burn(address _user, uint256 _amount) external;

    /// --------------------------------------------------------------------------------------------------------------------------------- \\\
}

// SPDX-License-Identifier: Unlicensed

pragma solidity 0.8.25;

/*
 * @title IBurnRedeemable Interface
 *
 * @notice Interface for tokens with redeemable features upon burning.
 *
 * Co-Founders:
 * - Simran Dhillon: [email protected]
 * - Hardev Dhillon: [email protected]
 * - Dayana Plaz: [email protected]
 *
 * Official Links:
 * - Twitter: https://twitter.com/alixa_io
 * - Telegram: https://t.me/alixa_io
 * - Website: https://alixa.io
 *
 * Disclaimer:
 * This interface aligns with the principles of the Fair Crypto Foundation, promoting self-custody, transparency, consensus-based
 * trust, and permissionless value exchange. There are no administrative access keys, underscoring our commitment to decentralisation.
 * Engaging with this interface involves technical and legal risks. Users must conduct their own due diligence and ensure compliance
 * with local laws and regulations. The software is provided "AS-IS," without warranties, and the co-founders and developers disclaim
 * all liability for any vulnerabilities, exploits, errors, or breaches that may occur. By using this interface, users accept all associated
 * risks and this disclaimer. The co-founders, developers, or related parties will not bear liability for any consequences of non-compliance.
 *
 * Redistribution and Use:
 * Redistribution, modification, or repurposing of this interface, in whole or in part, is strictly prohibited without express written
 * approval from all co-founders. Approval requests must be sent to the official email addresses of the co-founders, ensuring responses
 * are received directly from these addresses. Proposals for redistribution, modification, or repurposing must include a detailed explanation
 * of the intended changes or uses and the reasons behind them. The co-founders reserve the right to request additional information or
 * clarification as necessary. Approval is at the sole discretion of the co-founders and may be subject to conditions to uphold the
 * project’s integrity and the values of the Fair Crypto Foundation. Failure to obtain express written approval prior to any redistribution,
 * modification, or repurposing will result in a breach of these terms and immediate legal action.
 *
 * Copyright and License:
 * Copyright © 2024 Alixa (Simran Dhillon, Hardev Dhillon, Dayana Plaz). All rights reserved.
 * This software is provided 'as is' and may be used by the recipient. No permission is granted for redistribution,
 * modification, or repurposing of this interface. Any use beyond the scope defined herein may be subject to legal action.
 */
interface IBurnRedeemable {

    /// --------------------------------------------------------------------------------------------------------------------------------- \\\
    /// ------------------------------------------------------ EXTERNAL FUNCTION -------------------------------------------------------- \\\
    /// --------------------------------------------------------------------------------------------------------------------------------- \\\

    /**
     * @notice Callback triggered when a user burns tokens.
     * @dev Executes post-burn logic. Implement with reentrancy protection.
     * @param _user Address of the user burning tokens.
     * @param _amount Amount of tokens being burned.
     */
    function onTokenBurned(address _user, uint256 _amount) external;

    /// --------------------------------------------------------------------------------------------------------------------------------- \\\
}

// SPDX-License-Identifier: Unlicensed

pragma solidity 0.8.25;

/*
 * @title ICore Interface
 *
 * @notice Defines the core functionalities of the Alixa protocol, allowing interaction with bond and staking mechanisms.
 *
 * Co-Founders:
 * - Simran Dhillon: [email protected]
 * - Hardev Dhillon: [email protected]
 * - Dayana Plaz: [email protected]
 *
 * Official Links:
 * - Twitter: https://twitter.com/alixa_io
 * - Telegram: https://t.me/alixa_io
 * - Website: https://alixa.io
 *
 * Disclaimer:
 * This interface aligns with the principles of the Fair Crypto Foundation, promoting self-custody, transparency, consensus-based
 * trust, and permissionless value exchange. There are no administrative access keys, underscoring our commitment to decentralisation.
 * Engaging with this interface involves technical and legal risks. Users must conduct their own due diligence and ensure compliance
 * with local laws and regulations. The software is provided "AS-IS," without warranties, and the co-founders and developers disclaim
 * all liability for any vulnerabilities, exploits, errors, or breaches that may occur. By using this interface, users accept all associated
 * risks and this disclaimer. The co-founders, developers, or related parties will not bear liability for any consequences of non-compliance.
 *
 * Redistribution and Use:
 * Redistribution, modification, or repurposing of this interface, in whole or in part, is strictly prohibited without express written
 * approval from all co-founders. Approval requests must be sent to the official email addresses of the co-founders, ensuring responses
 * are received directly from these addresses. Proposals for redistribution, modification, or repurposing must include a detailed explanation
 * of the intended changes or uses and the reasons behind them. The co-founders reserve the right to request additional information or
 * clarification as necessary. Approval is at the sole discretion of the co-founders and may be subject to conditions to uphold the
 * project’s integrity and the values of the Fair Crypto Foundation. Failure to obtain express written approval prior to any redistribution,
 * modification, or repurposing will result in a breach of these terms and immediate legal action.
 *
 * Copyright and License:
 * Copyright © 2024 Alixa (Simran Dhillon, Hardev Dhillon, Dayana Plaz). All rights reserved.
 * This software is provided 'as is' and may be used by the recipient. No permission is granted for redistribution,
 * modification, or repurposing of this interface. Any use beyond the scope defined herein may be subject to legal action.
 */
interface ICore {

    /// --------------------------------------------------------------------------------------------------------------------------------- \\\
    /// ------------------------------------------------------------- ENUM -------------------------------------------------------------- \\\
    /// --------------------------------------------------------------------------------------------------------------------------------- \\\

    /**
     * @notice Supported token types in the Alixa ecosystem.
     * @dev Defines eETH, ETHx, and ETH as valid token types.
     */
    enum Token {
        eeth,
        ethx,
        eth
    }

    /// --------------------------------------------------------------------------------------------------------------------------------- \\\
    /// ----------------------------------------------------- EXTERNAL FUNCTIONS -------------------------------------------------------- \\\
    /// --------------------------------------------------------------------------------------------------------------------------------- \\\

    /**
     * @notice Updates the current cycle.
     * @dev Calculates and updates the cycle based on protocol parameters.
     * @return Current cycle number.
     */
    function calculateCycle() external returns (uint256);

    /// --------------------------------------------------------------------------------------------------------------------------------- \\\

    /**
     * @notice Initiates ALX token unbonding process.
     * @dev Starts unbonding for specified bond ID.
     * @param _bondID Bond identifier.
     * @param _restake If true, restakes rewards.
     */
    function unbondingALX(uint256 _bondID, bool _restake) external;

    /// --------------------------------------------------------------------------------------------------------------------------------- \\\

    /**
     * @notice Provides ALX tokens for liquidity.
     * @dev Adds specified ALX amount to liquidity pool.
     * @param ALXAmount Amount of ALX tokens to provide.
     */
    function provideAssetsForLiquidity(uint256 ALXAmount) external;

    /// --------------------------------------------------------------------------------------------------------------------------------- \\\

    /**
     * @notice Reactivates an existing bond.
     * @dev Reactivates bond using specified ETHx amount.
     * @param _bondID Bond identifier.
     * @param _ETHxAmount Amount of ETHx for reactivation.
     */
    function reactivate(uint256 _bondID, uint256 _ETHxAmount) external;

    /// --------------------------------------------------------------------------------------------------------------------------------- \\\

    /**
     * @notice Claims ETHx rewards for a bond.
     * @dev Processes ETHx reward claims for specified bond.
     * @param _bondID Bond identifier.
     * @param _restake If true, restakes rewards.
     */
    function claimETHxRewards(uint256 _bondID, bool _restake) external;

    /// --------------------------------------------------------------------------------------------------------------------------------- \\\

    /**
     * @notice Checks liquidity provision trigger status.
     * @dev Returns current status of liquidity provision trigger.
     * @return True if triggered, false otherwise.
     */
    function isTriggered()
        external
        view
        returns (bool);

    /// --------------------------------------------------------------------------------------------------------------------------------- \\\

    /**
     * @notice Retrieves base cost for transactions.
     * @dev Returns fixed base cost value.
     * @return Base cost value.
     */
    function BASE_COST()
        external
        pure
        returns (uint256);

    /// --------------------------------------------------------------------------------------------------------------------------------- \\\

    /**
     * @notice Gets current cycle number.
     * @dev Returns cycle number without state modification.
     * @return Current cycle number.
     */
    function getCurrentCycle()
        external
        view
        returns (uint256);

    /// --------------------------------------------------------------------------------------------------------------------------------- \\\

    /**
     * @notice Calculates required token amounts for bonds.
     * @dev Determines token amount based on bond parameters.
     * @param _bondPower Bond power level.
     * @param _bondCount Number of bonds.
     * @param _isETHBond True if ETH bond, false otherwise.
     * @return tokenRequired_ Required token amount.
     */
     function getTokenAmounts(
        uint256 _bondPower,
        uint256 _bondCount,
        bool _isETHBond
    )
        external
        view
        returns (uint256 tokenRequired_);

    /// --------------------------------------------------------------------------------------------------------------------------------- \\\

    /**
     * @notice Retrieves pending ALX rewards for a bond.
     * @dev Calculates pending ALX rewards for specified bond.
     * @param _bondID Bond identifier.
     * @return reward_ Pending ALX reward amount.
     */
    function pendingALX(uint256 _bondID)
        external
        view
        returns (uint256 reward_);

    /// --------------------------------------------------------------------------------------------------------------------------------- \\\

    /**
     * @notice Checks bond existence for a user.
     * @dev Verifies if specified bond exists for given user.
     * @param _user User address.
     * @param _bondID Bond identifier.
     * @return exists_ True if bond exists, false otherwise.
     */
    function isExist(address _user, uint256 _bondID)
        external
        view
        returns (bool exists_);

    /// --------------------------------------------------------------------------------------------------------------------------------- \\\

    /**
     * @notice Transfers bond ownership.
     * @dev Processes bond transfer to new owner.
     * @param _bondIDs Array of bond IDs to transfer.
     * @param _recipient New owner's address.
     * @param _restake If true, restakes rewards.
     */
    function transferBond(
        uint256[] calldata _bondIDs,
        address _recipient,
        bool _restake
    ) external;

    /// --------------------------------------------------------------------------------------------------------------------------------- \\\

    /**
     * @notice Allows bond sniping.
     * @dev Processes bond sniping between users.
     * @param _user Bond owner's address.
     * @param _bondIDUser ID of bond to snipe.
     * @param _bondIDSniper Sniper's bond ID.
     * @param _restake If true, restakes rewards.
     */
    function snipe(
        address _user,
        uint256 _bondIDUser,
        uint256 _bondIDSniper,
        bool _restake
    ) external;

    /// --------------------------------------------------------------------------------------------------------------------------------- \\\

    /**
     * @notice Calculates pending ETHx rewards for a bond.
     * @dev Computes various components of ETHx rewards.
     * @param _user User address.
     * @param _bondID Bond identifier.
     * @return pendingAmount_ Base pending ETHx amount.
     * @return pendingBonus_ Pending bonus amount.
     * @return totalPending_ Total pending rewards.
     */
    function pendingETHx(address _user, uint256 _bondID)
        external
        view
        returns (
            uint256 pendingAmount_,
            uint256 pendingBonus_,
            uint256 totalPending_
        );

    /// --------------------------------------------------------------------------------------------------------------------------------- \\\

    /**
     * @notice Purchases bond with ALX tokens.
     * @dev Processes ALX bond purchase.
     * @param _user Purchaser's address.
     * @param _bondCount Number of bonds to purchase.
     * @param _daysCount Bond duration in days.
     * @param _bondPower Bond power level.
     */
    function purchaseALXBond(
        address _user,
        uint256 _bondCount,
        uint256 _daysCount,
        uint256 _bondPower
    ) external;

    /// --------------------------------------------------------------------------------------------------------------------------------- \\\

    /**
     * @notice Purchases bond with airdropped ALX tokens.
     * @dev Processes bond purchase using airdropped ALX.
     * @param _user Purchaser's address.
     * @param _bondCount Number of bonds to purchase.
     * @param _daysCount Bond duration in days.
     * @param _bondPower Bond power level.
     * @param _requiredALXAmount Required ALX amount for purchase.
     */
    function purchaseBondWithAirdroppedALX(
        address _user,
        uint256 _bondCount,
        uint256 _daysCount,
        uint256 _bondPower,
        uint256 _requiredALXAmount
    ) external payable;

    /// --------------------------------------------------------------------------------------------------------------------------------- \\\

    /**
     * @notice Purchases ETH bond.
     * @dev Processes ETH or ETH-based token bond purchase.
     * @param _user Purchaser's address.
     * @param _bondCount Number of bonds to purchase.
     * @param _token Token type used for purchase.
     * @param _daysCount Bond duration in days.
     * @param _bondPower Bond power level.
     */
    function purchaseETHBond(
        address _user,
        uint256 _bondCount,
        Token _token,
        uint256 _daysCount,
        uint256 _bondPower
    ) external payable;

    /// --------------------------------------------------------------------------------------------------------------------------------- \\\
}

// SPDX-License-Identifier: Unlicensed

pragma solidity 0.8.25;

/*
 * @title IWormholeRelayerBase Interface
 *
 * @notice Defines the base interface for the Wormhole Relayer, facilitating cross-chain communication and message relaying.
 *
 * Co-Founders:
 * - Simran Dhillon: [email protected]
 * - Hardev Dhillon: [email protected]
 * - Dayana Plaz: [email protected]
 *
 * Official Links:
 * - Twitter: https://twitter.com/alixa_io
 * - Telegram: https://t.me/alixa_io
 * - Website: https://alixa.io
 *
 * Disclaimer:
 * This interface aligns with the principles of the Fair Crypto Foundation, promoting self-custody, transparency, consensus-based
 * trust, and permissionless value exchange. There are no administrative access keys, underscoring our commitment to decentralisation.
 * Engaging with this interface involves technical and legal risks. Users must conduct their own due diligence and ensure compliance
 * with local laws and regulations. The software is provided "AS-IS," without warranties, and the co-founders and developers disclaim
 * all liability for any vulnerabilities, exploits, errors, or breaches that may occur. By using this interface, users accept all associated
 * risks and this disclaimer. The co-founders, developers, or related parties will not bear liability for any consequences of non-compliance.
 *
 * Redistribution and Use:
 * Redistribution, modification, or repurposing of this interface, in whole or in part, is strictly prohibited without express written
 * approval from all co-founders. Approval requests must be sent to the official email addresses of the co-founders, ensuring responses
 * are received directly from these addresses. Proposals for redistribution, modification, or repurposing must include a detailed explanation
 * of the intended changes or uses and the reasons behind them. The co-founders reserve the right to request additional information or
 * clarification as necessary. Approval is at the sole discretion of the co-founders and may be subject to conditions to uphold the
 * project’s integrity and the values of the Fair Crypto Foundation. Failure to obtain express written approval prior to any redistribution,
 * modification, or repurposing will result in a breach of these terms and immediate legal action.
 *
 * Copyright and License:
 * Copyright © 2024 Alixa (Simran Dhillon, Hardev Dhillon, Dayana Plaz). All rights reserved.
 * This software is provided 'as is' and may be used by the recipient. No permission is granted for redistribution,
 * modification, or repurposing of this interface. Any use beyond the scope defined herein may be subject to legal action.
 */

/// --------------------------------------------------------------------------------------------------------------------------------- \\\
/// ---------------------------------------------------------- STRUCTURE ------------------------------------------------------------ \\\
/// --------------------------------------------------------------------------------------------------------------------------------- \\\

/**
 * @notice VaaKey identifies a wormhole message.
 * @custom:member chainId Wormhole chain ID of the chain where this VAA was emitted from.
 * @custom:member emitterAddress Address of the emitter of the VAA, in Wormhole bytes32 format.
 * @custom:member sequence Sequence number of the VAA.
 */
struct VaaKey {
    uint16 chainId;
    bytes32 emitterAddress;
    uint64 sequence;
}

/// ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| \\\

/**
 * @title IWormholeRelayerBase
 * @notice Interface for basic Wormhole Relayer operations.
 */
interface IWormholeRelayerBase {

    /// --------------------------------------------------------------------------------------------------------------------------------- \\\
    /// ------------------------------------------------------------ EVENT -------------------------------------------------------------- \\\
    /// --------------------------------------------------------------------------------------------------------------------------------- \\\

    /**
     * @notice Emitted when a Send operation is executed.
     * @param sequence The sequence of the send event.
     * @param deliveryQuote The delivery quote for the send operation.
     * @param paymentForExtraReceiverValue The payment value for the additional receiver.
     */
    event SendEvent(
        uint64 indexed sequence,
        uint256 deliveryQuote,
        uint256 paymentForExtraReceiverValue
    );

    /// --------------------------------------------------------------------------------------------------------------------------------- \\\
    /// ------------------------------------------------------ EXTERNAL FUNCTION -------------------------------------------------------- \\\
    /// --------------------------------------------------------------------------------------------------------------------------------- \\\

    /**
     * @notice Fetches the registered Wormhole Relayer contract for a given chain ID.
     * @param chainId The chain ID to fetch the relayer contract for.
     * @return The address of the registered Wormhole Relayer contract for the given chain ID.
     */
    function getRegisteredWormholeRelayerContract(uint16 chainId)
        external
        view
        returns (bytes32);

    /// --------------------------------------------------------------------------------------------------------------------------------- \\\
}

/// ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| \\\

/**
 * @title IWormholeRelayerSend
 * @notice The interface to request deliveries.
 */
interface IWormholeRelayerSend is IWormholeRelayerBase {

    /// --------------------------------------------------------------------------------------------------------------------------------- \\\
    /// ----------------------------------------------------- EXTERNAL FUNCTIONS -------------------------------------------------------- \\\
    /// --------------------------------------------------------------------------------------------------------------------------------- \\\

    /**
     * @notice Publishes an instruction for the default delivery provider
     * to relay a payload to the address `targetAddress` on chain `targetChain`
     * with gas limit `gasLimit` and `msg.value` equal to `receiverValue`
     *
     * `targetAddress` must implement the IWormholeReceiver interface.
     *
     * This function must be called with `msg.value` equal to `quoteEVMDeliveryPrice(targetChain, receiverValue, gasLimit)`.
     *
     * Any refunds (from leftover gas) will be paid to the delivery provider. In order to receive the refunds, use the `sendPayloadToEvm` function
     * with `refundChain` and `refundAddress` as parameters.
     *
     * @param targetChain in Wormhole Chain ID format.
     * @param targetAddress address to call on targetChain (that implements IWormholeReceiver).
     * @param payload arbitrary bytes to pass in as parameter in call to `targetAddress`.
     * @param receiverValue msg.value that delivery provider should pass in for call to `targetAddress` (in targetChain currency units).
     * @param gasLimit gas limit with which to call `targetAddress`.
     * @return sequence sequence number of published VAA containing delivery instructions.
     */
    function sendPayloadToEvm(
        uint16 targetChain,
        address targetAddress,
        bytes memory payload,
        uint256 receiverValue,
        uint256 gasLimit
    )
        external
        payable
        returns (uint64 sequence);

    /// --------------------------------------------------------------------------------------------------------------------------------- \\\

    /**
     * @notice Publishes an instruction for the default delivery provider.
     * to relay a payload to the address `targetAddress` on chain `targetChain`
     * with gas limit `gasLimit` and `msg.value` equal to `receiverValue`.
     *
     * Any refunds (from leftover gas) will be sent to `refundAddress` on chain `refundChain`
     * `targetAddress` must implement the IWormholeReceiver interface.
     *
     * This function must be called with `msg.value` equal to `quoteEVMDeliveryPrice(targetChain, receiverValue, gasLimit)`.
     *
     * @param targetChain in Wormhole Chain ID format.
     * @param targetAddress address to call on targetChain (that implements IWormholeReceiver).
     * @param payload arbitrary bytes to pass in as parameter in call to `targetAddress`.
     * @param receiverValue msg.value that delivery provider should pass in for call to `targetAddress` (in targetChain currency units).
     * @param gasLimit gas limit with which to call `targetAddress`. Any units of gas unused will be refunded according to the
     *        `targetChainRefundPerGasUnused` rate quoted by the delivery provider.
     * @param refundChain The chain to deliver any refund to, in Wormhole Chain ID format.
     * @param refundAddress The address on `refundChain` to deliver any refund to.
     * @return sequence sequence number of published VAA containing delivery instructions.
     */
    function sendPayloadToEvm(
        uint16 targetChain,
        address targetAddress,
        bytes memory payload,
        uint256 receiverValue,
        uint256 gasLimit,
        uint16 refundChain,
        address refundAddress
    )
        external
        payable
        returns (uint64 sequence);

    /// --------------------------------------------------------------------------------------------------------------------------------- \\\

    /**
     * @notice Publishes an instruction for the default delivery provider
     * to relay a payload and VAAs specified by `vaaKeys` to the address `targetAddress` on chain `targetChain`
     * with gas limit `gasLimit` and `msg.value` equal to `receiverValue`
     *
     * `targetAddress` must implement the IWormholeReceiver interface
     *
     * This function must be called with `msg.value` equal to `quoteEVMDeliveryPrice(targetChain, receiverValue, gasLimit)`
     *
     * Any refunds (from leftover gas) will be paid to the delivery provider. In order to receive the refunds, use the `sendVaasToEvm` function
     * with `refundChain` and `refundAddress` as parameters
     *
     * @param targetChain in Wormhole Chain ID format
     * @param targetAddress address to call on targetChain (that implements IWormholeReceiver)
     * @param payload arbitrary bytes to pass in as parameter in call to `targetAddress`
     * @param receiverValue msg.value that delivery provider should pass in for call to `targetAddress` (in targetChain currency units)
     * @param gasLimit gas limit with which to call `targetAddress`.
     * @param vaaKeys Additional VAAs to pass in as parameter in call to `targetAddress`
     * @return sequence sequence number of published VAA containing delivery instructions
     */
    function sendVaasToEvm(
        uint16 targetChain,
        address targetAddress,
        bytes memory payload,
        uint256 receiverValue,
        uint256 gasLimit,
        VaaKey[] memory vaaKeys
    )
        external
        payable
        returns (uint64 sequence);

    /// --------------------------------------------------------------------------------------------------------------------------------- \\\

    /**
     * @notice Publishes an instruction for the default delivery provider
     * to relay a payload and VAAs specified by `vaaKeys` to the address `targetAddress` on chain `targetChain`
     * with gas limit `gasLimit` and `msg.value` equal to `receiverValue`
     *
     * Any refunds (from leftover gas) will be sent to `refundAddress` on chain `refundChain`
     * `targetAddress` must implement the IWormholeReceiver interface
     *
     * This function must be called with `msg.value` equal to `quoteEVMDeliveryPrice(targetChain, receiverValue, gasLimit)`
     *
     * @param targetChain in Wormhole Chain ID format
     * @param targetAddress address to call on targetChain (that implements IWormholeReceiver)
     * @param payload arbitrary bytes to pass in as parameter in call to `targetAddress`
     * @param receiverValue msg.value that delivery provider should pass in for call to `targetAddress` (in targetChain currency units)
     * @param gasLimit gas limit with which to call `targetAddress`. Any units of gas unused will be refunded according to the
     *        `targetChainRefundPerGasUnused` rate quoted by the delivery provider
     * @param vaaKeys Additional VAAs to pass in as parameter in call to `targetAddress`
     * @param refundChain The chain to deliver any refund to, in Wormhole Chain ID format
     * @param refundAddress The address on `refundChain` to deliver any refund to
     * @return sequence sequence number of published VAA containing delivery instructions
     */
    function sendVaasToEvm(
        uint16 targetChain,
        address targetAddress,
        bytes memory payload,
        uint256 receiverValue,
        uint256 gasLimit,
        VaaKey[] memory vaaKeys,
        uint16 refundChain,
        address refundAddress
    )
        external
        payable
        returns (uint64 sequence);

    /// --------------------------------------------------------------------------------------------------------------------------------- \\\

    /**
     * @notice Publishes an instruction for the delivery provider at `deliveryProviderAddress`
     * to relay a payload and VAAs specified by `vaaKeys` to the address `targetAddress` on chain `targetChain`
     * with gas limit `gasLimit` and `msg.value` equal to
     * receiverValue + (arbitrary amount that is paid for by paymentForExtraReceiverValue of this chain's wei) in targetChain wei.
     *
     * Any refunds (from leftover gas) will be sent to `refundAddress` on chain `refundChain`
     * `targetAddress` must implement the IWormholeReceiver interface
     *
     * This function must be called with `msg.value` equal to
     * quoteEVMDeliveryPrice(targetChain, receiverValue, gasLimit, deliveryProviderAddress) + paymentForExtraReceiverValue
     *
     * @param targetChain in Wormhole Chain ID format
     * @param targetAddress address to call on targetChain (that implements IWormholeReceiver)
     * @param payload arbitrary bytes to pass in as parameter in call to `targetAddress`
     * @param receiverValue msg.value that delivery provider should pass in for call to `targetAddress` (in targetChain currency units)
     * @param paymentForExtraReceiverValue amount (in current chain currency units) to spend on extra receiverValue
     *        (in addition to the `receiverValue` specified)
     * @param gasLimit gas limit with which to call `targetAddress`. Any units of gas unused will be refunded according to the
     *        `targetChainRefundPerGasUnused` rate quoted by the delivery provider
     * @param refundChain The chain to deliver any refund to, in Wormhole Chain ID format
     * @param refundAddress The address on `refundChain` to deliver any refund to
     * @param deliveryProviderAddress The address of the desired delivery provider's implementation of IDeliveryProvider
     * @param vaaKeys Additional VAAs to pass in as parameter in call to `targetAddress`
     * @param consistencyLevel Consistency level with which to publish the delivery instructions - see
     *        https://book.wormhole.com/wormhole/3_coreLayerContracts.html?highlight=consistency#consistency-levels
     * @return sequence sequence number of published VAA containing delivery instructions
     */
    function sendToEvm(
        uint16 targetChain,
        address targetAddress,
        bytes memory payload,
        uint256 receiverValue,
        uint256 paymentForExtraReceiverValue,
        uint256 gasLimit,
        uint16 refundChain,
        address refundAddress,
        address deliveryProviderAddress,
        VaaKey[] memory vaaKeys,
        uint8 consistencyLevel
    )
        external
        payable
        returns (uint64 sequence);

    /// --------------------------------------------------------------------------------------------------------------------------------- \\\

    /**
     * @notice Publishes an instruction for the delivery provider at `deliveryProviderAddress`
     * to relay a payload and VAAs specified by `vaaKeys` to the address `targetAddress` on chain `targetChain`
     * with `msg.value` equal to
     * receiverValue + (arbitrary amount that is paid for by paymentForExtraReceiverValue of this chain's wei) in targetChain wei.
     *
     * Any refunds (from leftover gas) will be sent to `refundAddress` on chain `refundChain`
     * `targetAddress` must implement the IWormholeReceiver interface
     *
     * This function must be called with `msg.value` equal to
     * quoteDeliveryPrice(targetChain, receiverValue, encodedExecutionParameters, deliveryProviderAddress) + paymentForExtraReceiverValue
     *
     * @param targetChain in Wormhole Chain ID format
     * @param targetAddress address to call on targetChain (that implements IWormholeReceiver), in Wormhole bytes32 format
     * @param payload arbitrary bytes to pass in as parameter in call to `targetAddress`
     * @param receiverValue msg.value that delivery provider should pass in for call to `targetAddress` (in targetChain currency units)
     * @param paymentForExtraReceiverValue amount (in current chain currency units) to spend on extra receiverValue
     *        (in addition to the `receiverValue` specified)
     * @param encodedExecutionParameters encoded information on how to execute delivery that may impact pricing
     *        e.g. for version EVM_V1, this is a struct that encodes the `gasLimit` with which to call `targetAddress`
     * @param refundChain The chain to deliver any refund to, in Wormhole Chain ID format
     * @param refundAddress The address on `refundChain` to deliver any refund to, in Wormhole bytes32 format
     * @param deliveryProviderAddress The address of the desired delivery provider's implementation of IDeliveryProvider
     * @param vaaKeys Additional VAAs to pass in as parameter in call to `targetAddress`
     * @param consistencyLevel Consistency level with which to publish the delivery instructions - see
     *        https://book.wormhole.com/wormhole/3_coreLayerContracts.html?highlight=consistency#consistency-levels
     * @return sequence sequence number of published VAA containing delivery instructions
     */
    function send(
        uint16 targetChain,
        bytes32 targetAddress,
        bytes memory payload,
        uint256 receiverValue,
        uint256 paymentForExtraReceiverValue,
        bytes memory encodedExecutionParameters,
        uint16 refundChain,
        bytes32 refundAddress,
        address deliveryProviderAddress,
        VaaKey[] memory vaaKeys,
        uint8 consistencyLevel
    )
        external
        payable
        returns (uint64 sequence);

    /// --------------------------------------------------------------------------------------------------------------------------------- \\\

    /**
     * @notice Performs the same function as a `send`, except:
     * 1)  Can only be used during a delivery (i.e. in execution of `receiveWormholeMessages`)
     * 2)  Is paid for (along with any other calls to forward) by (any msg.value passed in) + (refund leftover from current delivery)
     * 3)  Only executes after `receiveWormholeMessages` is completed (and thus does not return a sequence number)
     *
     * The refund from the delivery currently in progress will not be sent to the user; it will instead
     * be paid to the delivery provider to perform the instruction specified here
     *
     * Publishes an instruction for the same delivery provider (or default, if the same one doesn't support the new target chain)
     * to relay a payload to the address `targetAddress` on chain `targetChain`
     * with gas limit `gasLimit` and with `msg.value` equal to `receiverValue`
     *
     * The following equation must be satisfied (sum_f indicates summing over all forwards requested in `receiveWormholeMessages`):
     * (refund amount from current execution of receiveWormholeMessages) + sum_f [msg.value_f]
     * >= sum_f [quoteEVMDeliveryPrice(targetChain_f, receiverValue_f, gasLimit_f)]
     *
     * The difference between the two sides of the above inequality will be added to `paymentForExtraReceiverValue` of the first forward requested
     *
     * Any refunds (from leftover gas) from this forward will be paid to the same refundChain and refundAddress specified for the current delivery.
     *
     * @param targetChain in Wormhole Chain ID format
     * @param targetAddress address to call on targetChain (that implements IWormholeReceiver), in Wormhole bytes32 format
     * @param payload arbitrary bytes to pass in as parameter in call to `targetAddress`
     * @param receiverValue msg.value that delivery provider should pass in for call to `targetAddress` (in targetChain currency units)
     * @param gasLimit gas limit with which to call `targetAddress`.
     */
    function forwardPayloadToEvm(
        uint16 targetChain,
        address targetAddress,
        bytes memory payload,
        uint256 receiverValue,
        uint256 gasLimit
    ) external payable;

    /// --------------------------------------------------------------------------------------------------------------------------------- \\\

    /**
     * @notice Performs the same function as a `send`, except:
     * 1)  Can only be used during a delivery (i.e. in execution of `receiveWormholeMessages`)
     * 2)  Is paid for (along with any other calls to forward) by (any msg.value passed in) + (refund leftover from current delivery)
     * 3)  Only executes after `receiveWormholeMessages` is completed (and thus does not return a sequence number)
     *
     * The refund from the delivery currently in progress will not be sent to the user; it will instead
     * be paid to the delivery provider to perform the instruction specified here
     *
     * Publishes an instruction for the same delivery provider (or default, if the same one doesn't support the new target chain)
     * to relay a payload and VAAs specified by `vaaKeys` to the address `targetAddress` on chain `targetChain`
     * with gas limit `gasLimit` and with `msg.value` equal to `receiverValue`
     *
     * The following equation must be satisfied (sum_f indicates summing over all forwards requested in `receiveWormholeMessages`):
     * (refund amount from current execution of receiveWormholeMessages) + sum_f [msg.value_f]
     * >= sum_f [quoteEVMDeliveryPrice(targetChain_f, receiverValue_f, gasLimit_f)]
     *
     * The difference between the two sides of the above inequality will be added to `paymentForExtraReceiverValue` of the first forward requested
     *
     * Any refunds (from leftover gas) from this forward will be paid to the same refundChain and refundAddress specified for the current delivery.
     *
     * @param targetChain in Wormhole Chain ID format
     * @param targetAddress address to call on targetChain (that implements IWormholeReceiver), in Wormhole bytes32 format
     * @param payload arbitrary bytes to pass in as parameter in call to `targetAddress`
     * @param receiverValue msg.value that delivery provider should pass in for call to `targetAddress` (in targetChain currency units)
     * @param gasLimit gas limit with which to call `targetAddress`.
     * @param vaaKeys Additional VAAs to pass in as parameter in call to `targetAddress`
     */
    function forwardVaasToEvm(
        uint16 targetChain,
        address targetAddress,
        bytes memory payload,
        uint256 receiverValue,
        uint256 gasLimit,
        VaaKey[] memory vaaKeys
    ) external payable;

    /// --------------------------------------------------------------------------------------------------------------------------------- \\\

    /**
     * @notice Performs the same function as a `send`, except:
     * 1)  Can only be used during a delivery (i.e. in execution of `receiveWormholeMessages`)
     * 2)  Is paid for (along with any other calls to forward) by (any msg.value passed in) + (refund leftover from current delivery)
     * 3)  Only executes after `receiveWormholeMessages` is completed (and thus does not return a sequence number)
     *
     * The refund from the delivery currently in progress will not be sent to the user; it will instead
     * be paid to the delivery provider to perform the instruction specified here
     *
     * Publishes an instruction for the delivery provider at `deliveryProviderAddress`
     * to relay a payload and VAAs specified by `vaaKeys` to the address `targetAddress` on chain `targetChain`
     * with gas limit `gasLimit` and with `msg.value` equal to
     * receiverValue + (arbitrary amount that is paid for by paymentForExtraReceiverValue of this chain's wei) in targetChain wei.
     *
     * Any refunds (from leftover gas) will be sent to `refundAddress` on chain `refundChain`
     * `targetAddress` must implement the IWormholeReceiver interface
     *
     * The following equation must be satisfied (sum_f indicates summing over all forwards requested in `receiveWormholeMessages`):
     * (refund amount from current execution of receiveWormholeMessages) + sum_f [msg.value_f]
     * >= sum_f [quoteEVMDeliveryPrice(targetChain_f, receiverValue_f, gasLimit_f, deliveryProviderAddress_f) + paymentForExtraReceiverValue_f]
     *
     * The difference between the two sides of the above inequality will be added to `paymentForExtraReceiverValue` of the first forward requested
     *
     * @param targetChain in Wormhole Chain ID format
     * @param targetAddress address to call on targetChain (that implements IWormholeReceiver), in Wormhole bytes32 format
     * @param payload arbitrary bytes to pass in as parameter in call to `targetAddress`
     * @param receiverValue msg.value that delivery provider should pass in for call to `targetAddress` (in targetChain currency units)
     * @param paymentForExtraReceiverValue amount (in current chain currency units) to spend on extra receiverValue
     *        (in addition to the `receiverValue` specified)
     * @param gasLimit gas limit with which to call `targetAddress`. Any units of gas unused will be refunded according to the
     *        `targetChainRefundPerGasUnused` rate quoted by the delivery provider
     * @param refundChain The chain to deliver any refund to, in Wormhole Chain ID format
     * @param refundAddress The address on `refundChain` to deliver any refund to, in Wormhole bytes32 format
     * @param deliveryProviderAddress The address of the desired delivery provider's implementation of IDeliveryProvider
     * @param vaaKeys Additional VAAs to pass in as parameter in call to `targetAddress`
     * @param consistencyLevel Consistency level with which to publish the delivery instructions - see
     *        https://book.wormhole.com/wormhole/3_coreLayerContracts.html?highlight=consistency#consistency-levels
     */
    function forwardToEvm(
        uint16 targetChain,
        address targetAddress,
        bytes memory payload,
        uint256 receiverValue,
        uint256 paymentForExtraReceiverValue,
        uint256 gasLimit,
        uint16 refundChain,
        address refundAddress,
        address deliveryProviderAddress,
        VaaKey[] memory vaaKeys,
        uint8 consistencyLevel
    ) external payable;

    /// --------------------------------------------------------------------------------------------------------------------------------- \\\

    /**
     * @notice Performs the same function as a `send`, except:
     * 1)  Can only be used during a delivery (i.e. in execution of `receiveWormholeMessages`)
     * 2)  Is paid for (along with any other calls to forward) by (any msg.value passed in) + (refund leftover from current delivery)
     * 3)  Only executes after `receiveWormholeMessages` is completed (and thus does not return a sequence number)
     *
     * The refund from the delivery currently in progress will not be sent to the user; it will instead
     * be paid to the delivery provider to perform the instruction specified here
     *
     * Publishes an instruction for the delivery provider at `deliveryProviderAddress`
     * to relay a payload and VAAs specified by `vaaKeys` to the address `targetAddress` on chain `targetChain`
     * with `msg.value` equal to
     * receiverValue + (arbitrary amount that is paid for by paymentForExtraReceiverValue of this chain's wei) in targetChain wei.
     *
     * Any refunds (from leftover gas) will be sent to `refundAddress` on chain `refundChain`
     * `targetAddress` must implement the IWormholeReceiver interface
     *
     * The following equation must be satisfied (sum_f indicates summing over all forwards requested in `receiveWormholeMessages`):
     * (refund amount from current execution of receiveWormholeMessages) + sum_f [msg.value_f]
     * >= sum_f [quoteDeliveryPrice(targetChain_f, receiverValue_f, encodedExecutionParameters_f, deliveryProviderAddress_f) + paymentForExtraReceiverValue_f]
     *
     * The difference between the two sides of the above inequality will be added to `paymentForExtraReceiverValue` of the first forward requested
     *
     * @param targetChain in Wormhole Chain ID format
     * @param targetAddress address to call on targetChain (that implements IWormholeReceiver), in Wormhole bytes32 format
     * @param payload arbitrary bytes to pass in as parameter in call to `targetAddress`
     * @param receiverValue msg.value that delivery provider should pass in for call to `targetAddress` (in targetChain currency units)
     * @param paymentForExtraReceiverValue amount (in current chain currency units) to spend on extra receiverValue
     *        (in addition to the `receiverValue` specified)
     * @param encodedExecutionParameters encoded information on how to execute delivery that may impact pricing
     *        e.g. for version EVM_V1, this is a struct that encodes the `gasLimit` with which to call `targetAddress`
     * @param refundChain The chain to deliver any refund to, in Wormhole Chain ID format
     * @param refundAddress The address on `refundChain` to deliver any refund to, in Wormhole bytes32 format
     * @param deliveryProviderAddress The address of the desired delivery provider's implementation of IDeliveryProvider
     * @param vaaKeys Additional VAAs to pass in as parameter in call to `targetAddress`
     * @param consistencyLevel Consistency level with which to publish the delivery instructions - see
     *        https://book.wormhole.com/wormhole/3_coreLayerContracts.html?highlight=consistency#consistency-levels
     */
    function forward(
        uint16 targetChain,
        bytes32 targetAddress,
        bytes memory payload,
        uint256 receiverValue,
        uint256 paymentForExtraReceiverValue,
        bytes memory encodedExecutionParameters,
        uint16 refundChain,
        bytes32 refundAddress,
        address deliveryProviderAddress,
        VaaKey[] memory vaaKeys,
        uint8 consistencyLevel
    ) external payable;

    /// --------------------------------------------------------------------------------------------------------------------------------- \\\

    /**
     * @notice Requests a previously published delivery instruction to be redelivered
     * (e.g. with a different delivery provider)
     *
     * This function must be called with `msg.value` equal to
     * quoteEVMDeliveryPrice(targetChain, newReceiverValue, newGasLimit, newDeliveryProviderAddress)
     *
     *  @notice *** This will only be able to succeed if the following is true **
     *         - newGasLimit >= gas limit of the old instruction
     *         - newReceiverValue >= receiver value of the old instruction
     *         - newDeliveryProvider's `targetChainRefundPerGasUnused` >= old relay provider's `targetChainRefundPerGasUnused`
     *
     * @param deliveryVaaKey VaaKey identifying the wormhole message containing the
     *        previously published delivery instructions
     * @param targetChain The target chain that the original delivery targeted. Must match targetChain from original delivery instructions
     * @param newReceiverValue new msg.value that delivery provider should pass in for call to `targetAddress` (in targetChain currency units)
     * @param newGasLimit gas limit with which to call `targetAddress`. Any units of gas unused will be refunded according to the
     *        `targetChainRefundPerGasUnused` rate quoted by the delivery provider, to the refund chain and address specified in the original request
     * @param newDeliveryProviderAddress The address of the desired delivery provider's implementation of IDeliveryProvider
     * @return sequence sequence number of published VAA containing redelivery instructions
     *
     * @notice *** This will only be able to succeed if the following is true **
     *         - newGasLimit >= gas limit of the old instruction
     *         - newReceiverValue >= receiver value of the old instruction
     *         - newDeliveryProvider's `targetChainRefundPerGasUnused` >= old relay provider's `targetChainRefundPerGasUnused`
     */
    function resendToEvm(
        VaaKey memory deliveryVaaKey,
        uint16 targetChain,
        uint256 newReceiverValue,
        uint256 newGasLimit,
        address newDeliveryProviderAddress
    )
        external
        payable
        returns (uint64 sequence);

    /// --------------------------------------------------------------------------------------------------------------------------------- \\\

    /**
     * @notice Requests a previously published delivery instruction to be redelivered
     *
     *
     * This function must be called with `msg.value` equal to
     * quoteDeliveryPrice(targetChain, newReceiverValue, newEncodedExecutionParameters, newDeliveryProviderAddress)
     *
     * @param deliveryVaaKey VaaKey identifying the wormhole message containing the
     *        previously published delivery instructions
     * @param targetChain The target chain that the original delivery targeted. Must match targetChain from original delivery instructions
     * @param newReceiverValue new msg.value that delivery provider should pass in for call to `targetAddress` (in targetChain currency units)
     * @param newEncodedExecutionParameters new encoded information on how to execute delivery that may impact pricing
     *        e.g. for version EVM_V1, this is a struct that encodes the `gasLimit` with which to call `targetAddress`
     * @param newDeliveryProviderAddress The address of the desired delivery provider's implementation of IDeliveryProvider
     * @return sequence sequence number of published VAA containing redelivery instructions
     *
     *  @notice *** This will only be able to succeed if the following is true **
     *         - (For EVM_V1) newGasLimit >= gas limit of the old instruction
     *         - newReceiverValue >= receiver value of the old instruction
     *         - (For EVM_V1) newDeliveryProvider's `targetChainRefundPerGasUnused` >= old relay provider's `targetChainRefundPerGasUnused`
     */
    function resend(
        VaaKey memory deliveryVaaKey,
        uint16 targetChain,
        uint256 newReceiverValue,
        bytes memory newEncodedExecutionParameters,
        address newDeliveryProviderAddress
    )
        external
        payable
        returns (uint64 sequence);

    /// --------------------------------------------------------------------------------------------------------------------------------- \\\

    /**
     * @notice Returns the price to request a relay to chain `targetChain`, using the default delivery provider
     *
     * @param targetChain in Wormhole Chain ID format
     * @param receiverValue msg.value that delivery provider should pass in for call to `targetAddress` (in targetChain currency units)
     * @param gasLimit gas limit with which to call `targetAddress`.
     * @return nativePriceQuote Price, in units of current chain currency, that the delivery provider charges to perform the relay
     * @return targetChainRefundPerGasUnused amount of target chain currency that will be refunded per unit of gas unused,
     *         if a refundAddress is specified
     */
    function quoteEVMDeliveryPrice(
        uint16 targetChain,
        uint256 receiverValue,
        uint256 gasLimit
    )
        external
        view
        returns (uint256 nativePriceQuote, uint256 targetChainRefundPerGasUnused);

    /// --------------------------------------------------------------------------------------------------------------------------------- \\\

    /**
     * @notice Returns the price to request a relay to chain `targetChain`, using delivery provider `deliveryProviderAddress`
     *
     * @param targetChain in Wormhole Chain ID format
     * @param receiverValue msg.value that delivery provider should pass in for call to `targetAddress` (in targetChain currency units)
     * @param gasLimit gas limit with which to call `targetAddress`.
     * @param deliveryProviderAddress The address of the desired delivery provider's implementation of IDeliveryProvider
     * @return nativePriceQuote Price, in units of current chain currency, that the delivery provider charges to perform the relay
     * @return targetChainRefundPerGasUnused amount of target chain currency that will be refunded per unit of gas unused,
     *         if a refundAddress is specified
     */
    function quoteEVMDeliveryPrice(
        uint16 targetChain,
        uint256 receiverValue,
        uint256 gasLimit,
        address deliveryProviderAddress
    )
        external
        view
        returns (uint256 nativePriceQuote, uint256 targetChainRefundPerGasUnused);

    /// --------------------------------------------------------------------------------------------------------------------------------- \\\

    /**
     * @notice Returns the price to request a relay to chain `targetChain`, using delivery provider `deliveryProviderAddress`
     *
     * @param targetChain in Wormhole Chain ID format
     * @param receiverValue msg.value that delivery provider should pass in for call to `targetAddress` (in targetChain currency units)
     * @param encodedExecutionParameters encoded information on how to execute delivery that may impact pricing
     *        e.g. for version EVM_V1, this is a struct that encodes the `gasLimit` with which to call `targetAddress`
     * @param deliveryProviderAddress The address of the desired delivery provider's implementation of IDeliveryProvider
     * @return nativePriceQuote Price, in units of current chain currency, that the delivery provider charges to perform the relay
     * @return encodedExecutionInfo encoded information on how the delivery will be executed
     *        e.g. for version EVM_V1, this is a struct that encodes the `gasLimit` and `targetChainRefundPerGasUnused`
     *             (which is the amount of target chain currency that will be refunded per unit of gas unused,
     *              if a refundAddress is specified)
     */
    function quoteDeliveryPrice(
        uint16 targetChain,
        uint256 receiverValue,
        bytes memory encodedExecutionParameters,
        address deliveryProviderAddress
    )
        external
        view
        returns (uint256 nativePriceQuote, bytes memory encodedExecutionInfo);

    /// --------------------------------------------------------------------------------------------------------------------------------- \\\

    /**
     * @notice Returns the (extra) amount of target chain currency that `targetAddress`
     * will be called with, if the `paymentForExtraReceiverValue` field is set to `currentChainAmount`
     *
     * @param targetChain in Wormhole Chain ID format
     * @param currentChainAmount The value that `paymentForExtraReceiverValue` will be set to
     * @param deliveryProviderAddress The address of the desired delivery provider's implementation of IDeliveryProvider
     * @return targetChainAmount The amount such that if `targetAddress` will be called with `msg.value` equal to
     *         receiverValue + targetChainAmount
     */
    function quoteNativeForChain(
        uint16 targetChain,
        uint256 currentChainAmount,
        address deliveryProviderAddress
    )
        external
        view
        returns (uint256 targetChainAmount);

    /// --------------------------------------------------------------------------------------------------------------------------------- \\\

    /**
     * @notice Returns the address of the current default delivery provider
     * @return deliveryProvider The address of (the default delivery provider)'s contract on this source
     *   chain. This must be a contract that implements IDeliveryProvider.
     */
    function getDefaultDeliveryProvider()
        external
        view
        returns (address deliveryProvider);
}

/// ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| \\\

/**
 * @title IWormholeRelayerDelivery
 * @notice The interface to execute deliveries. Only relevant for Delivery Providers
 */
interface IWormholeRelayerDelivery is IWormholeRelayerBase {

    /// --------------------------------------------------------------------------------------------------------------------------------- \\\
    /// ------------------------------------------------------------- ENUM -------------------------------------------------------------- \\\
    /// --------------------------------------------------------------------------------------------------------------------------------- \\\

    /**
     * @notice Represents the possible statuses of a delivery.
     */
    enum DeliveryStatus {
        SUCCESS,
        RECEIVER_FAILURE,
        FORWARD_REQUEST_FAILURE,
        FORWARD_REQUEST_SUCCESS
    }

    /// --------------------------------------------------------------------------------------------------------------------------------- \\\

    /**
     * @notice Represents the possible statuses of a refund after a delivery attempt.
     */
    enum RefundStatus {
        REFUND_SENT,
        REFUND_FAIL,
        CROSS_CHAIN_REFUND_SENT,
        CROSS_CHAIN_REFUND_FAIL_PROVIDER_NOT_SUPPORTED,
        CROSS_CHAIN_REFUND_FAIL_NOT_ENOUGH
    }

    /// --------------------------------------------------------------------------------------------------------------------------------- \\\
    /// ------------------------------------------------------------- EVENT ------------------------------------------------------------- \\\
    /// --------------------------------------------------------------------------------------------------------------------------------- \\\

    /**
     * @custom:member recipientContract - The target contract address
     * @custom:member sourceChain - The chain which this delivery was requested from (in wormhole
     *     ChainID format)
     * @custom:member sequence - The wormhole sequence number of the delivery VAA on the source chain
     *     corresponding to this delivery request
     * @custom:member deliveryVaaHash - The hash of the delivery VAA corresponding to this delivery
     *     request
     * @custom:member gasUsed - The amount of gas that was used to call your target contract
     * @custom:member status:
     *   - RECEIVER_FAILURE, if the target contract reverts
     *   - SUCCESS, if the target contract doesn't revert and no forwards were requested
     *   - FORWARD_REQUEST_FAILURE, if the target contract doesn't revert, forwards were requested,
     *       but provided/leftover funds were not sufficient to cover them all
     *   - FORWARD_REQUEST_SUCCESS, if the target contract doesn't revert and all forwards are covered
     * @custom:member additionalStatusInfo:
     *   - If status is SUCCESS or FORWARD_REQUEST_SUCCESS, then this is empty.
     *   - If status is RECEIVER_FAILURE, this is `RETURNDATA_TRUNCATION_THRESHOLD` bytes of the
     *       return data (i.e. potentially truncated revert reason information).
     *   - If status is FORWARD_REQUEST_FAILURE, this is also the revert data - the reason the forward failed.
     *     This will be either an encoded Cancelled, DeliveryProviderReverted, or DeliveryProviderPaymentFailed error
     * @custom:member refundStatus - Result of the refund. REFUND_SUCCESS or REFUND_FAIL are for
     *     refunds where targetChain=refundChain; the others are for targetChain!=refundChain,
     *     where a cross chain refund is necessary
     * @custom:member overridesInfo:
     *   - If not an override: empty bytes array
     *   - Otherwise: An encoded `DeliveryOverride`
     */
    event Delivery(
        address indexed recipientContract,
        uint16 indexed sourceChain,
        uint64 indexed sequence,
        bytes32 deliveryVaaHash,
        DeliveryStatus status,
        uint256 gasUsed,
        RefundStatus refundStatus,
        bytes additionalStatusInfo,
        bytes overridesInfo
    );

    /// --------------------------------------------------------------------------------------------------------------------------------- \\\
    /// ------------------------------------------------------ EXTERNAL FUNCTION -------------------------------------------------------- \\\
    /// --------------------------------------------------------------------------------------------------------------------------------- \\\

    /**
     * @notice The delivery provider calls `deliver` to relay messages as described by one delivery instruction
     *
     * The delivery provider must pass in the specified (by VaaKeys[]) signed wormhole messages (VAAs) from the source chain
     * as well as the signed wormhole message with the delivery instructions (the delivery VAA)
     *
     * The messages will be relayed to the target address (with the specified gas limit and receiver value) iff the following checks are met:
     * - the delivery VAA has a valid signature
     * - the delivery VAA's emitter is one of these WormholeRelayer contracts
     * - the delivery provider passed in at least enough of this chain's currency as msg.value (enough meaning the maximum possible refund)
     * - the instruction's target chain is this chain
     * - the relayed signed VAAs match the descriptions in container.messages (the VAA hashes match, or the emitter address, sequence number pair matches, depending on the description given)
     *
     * @param encodedVMs - An array of signed wormhole messages (all from the same source chain
     *     transaction)
     * @param encodedDeliveryVAA - Signed wormhole message from the source chain's WormholeRelayer
     *     contract with payload being the encoded delivery instruction container
     * @param relayerRefundAddress - The address to which any refunds to the delivery provider
     *     should be sent
     * @param deliveryOverrides - Optional overrides field which must be either an empty bytes array or
     *     an encoded DeliveryOverride struct
     */
    function deliver(
        bytes[] memory encodedVMs,
        bytes memory encodedDeliveryVAA,
        address payable relayerRefundAddress,
        bytes memory deliveryOverrides
    ) external payable;
}

/// ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| \\\

/**
 * @title IWormholeRelayer
 * @notice Interface for the primary Wormhole Relayer which aggregates the functionalities of the Delivery and Send interfaces.
 */
interface IWormholeRelayer is
    IWormholeRelayerDelivery,
    IWormholeRelayerSend {}

    uint256 constant RETURNDATA_TRUNCATION_THRESHOLD = 132;

    /// --------------------------------------------------------------------------------------------------------------------------------- \\\

    /**
     * Errors related to conversion and validation of EVM addresses.
     */
    error NotAnEvmAddress(bytes32);

    /// --------------------------------------------------------------------------------------------------------------------------------- \\\

    /**
     * Errors related to unauthorised access or usage.
     */
    error RequesterNotWormholeRelayer();

    /// --------------------------------------------------------------------------------------------------------------------------------- \\\

    /**
     * Errors for when there are issues with the overrides provided.
     */
    error InvalidOverrideGasLimit();
    error InvalidOverrideReceiverValue();
    error InvalidOverrideRefundPerGasUnused();

    /// --------------------------------------------------------------------------------------------------------------------------------- \\\

    /**
     * Errors related to the state and progress of the WormholeRelayer's operations.
     */
    error NoDeliveryInProgress();
    error ReentrantDelivery(address msgSender, address lockedBy);

    /// --------------------------------------------------------------------------------------------------------------------------------- \\\

    /**
     * Errors related to funding and refunds.
     */
    error InsufficientRelayerFunds(uint256 msgValue, uint256 minimum);

    /// --------------------------------------------------------------------------------------------------------------------------------- \\\

    /**
     * Errors related to the VAA (signed wormhole message) validation.
     */
    error VaaKeysDoNotMatchVaas(uint8 index);
    error VaaKeysLengthDoesNotMatchVaasLength(uint256 keys, uint256 vaas);
    error InvalidEmitter(bytes32 emitter, bytes32 registered, uint16 chainId);

    /// --------------------------------------------------------------------------------------------------------------------------------- \\\

    /**
     * Errors related to payment values and delivery prices.
     */
    error RequestedGasLimitTooLow();
    error DeliveryProviderCannotReceivePayment();
    error InvalidMsgValue(uint256 msgValue, uint256 totalFee);
    error DeliveryProviderDoesNotSupportTargetChain(address relayer, uint16 chainId);

    /// --------------------------------------------------------------------------------------------------------------------------------- \\\

    /**
     * Errors for when there are issues with forwarding or delivery.
     */
    error InvalidVaaKeyType(uint8 parsed);
    error InvalidDeliveryVaa(string reason);
    error InvalidPayloadId(uint8 parsed, uint8 expected);
    error InvalidPayloadLength(uint256 received, uint256 expected);
    error ForwardRequestFromWrongAddress(address msgSender, address deliveryTarget);

    /// --------------------------------------------------------------------------------------------------------------------------------- \\\

    /**
     * Errors related to relaying instructions and target chains.
     */
    error TargetChainIsNotThisChain(uint16 targetChain);
    error ForwardNotSufficientlyFunded(uint256 amountOfFunds, uint256 amountOfFundsNeeded);

    /// --------------------------------------------------------------------------------------------------------------------------------- \\\

{
  "viaIR": true,
  "optimizer": {
    "enabled": true,
    "runs": 1
  },
  "evmVersion": "paris",
  "outputSelection": {
    "*": {
      "*": [
        "evm.bytecode",
        "evm.deployedBytecode",
        "devdoc",
        "userdoc",
        "metadata",
        "abi"
      ]
    }
  },
  "metadata": {
    "useLiteralContent": true
  },
  "libraries": {}
}

• No Contract Security Audit Submitted- Submit Audit Here

[{"inputs":[{"internalType":"bytes32","name":"_merkleRoot","type":"bytes32"},{"internalType":"address","name":"_core","type":"address"},{"internalType":"address","name":"_gateway","type":"address"},{"internalType":"address","name":"_gasService","type":"address"},{"internalType":"address","name":"_endpoint","type":"address"},{"internalType":"address","name":"_wormholeRelayer","type":"address"}],"stateMutability":"payable","type":"constructor"},{"inputs":[],"name":"AirdropAlreadyClaimed","type":"error"},{"inputs":[],"name":"AirdropPeriodNotActive","type":"error"},{"inputs":[],"name":"ContractAlreadySet","type":"error"},{"inputs":[],"name":"CoreAlreadySet","type":"error"},{"inputs":[],"name":"ExceedsMaxSupply","type":"error"},{"inputs":[],"name":"InsufficientAirdroppedAmount","type":"error"},{"inputs":[],"name":"InsufficientFee","type":"error"},{"inputs":[],"name":"InsufficientFeeForWormhole","type":"error"},{"inputs":[],"name":"InvalidAddress","type":"error"},{"inputs":[],"name":"InvalidAddressString","type":"error"},{"inputs":[],"name":"InvalidCaller","type":"error"},{"inputs":[],"name":"InvalidClaimProof","type":"error"},{"inputs":[],"name":"InvalidLayerZeroSourceAddress","type":"error"},{"inputs":[],"name":"InvalidSourceAddress","type":"error"},{"inputs":[],"name":"InvalidToAddress","type":"error"},{"inputs":[],"name":"InvalidWormholeSourceAddress","type":"error"},{"inputs":[],"name":"MaxSupplyExceeded","type":"error"},{"inputs":[],"name":"NotApprovedByGateway","type":"error"},{"inputs":[],"name":"NotVerifiedCaller","type":"error"},{"inputs":[],"name":"OnlyRelayerAllowed","type":"error"},{"inputs":[],"name":"UnsupportedInterface","type":"error"},{"inputs":[],"name":"WormholeMessageAlreadyProcessed","type":"error"},{"inputs":[],"name":"ZeroAddress","type":"error"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"_user","type":"address"},{"indexed":false,"internalType":"uint256","name":"_amount","type":"uint256"}],"name":"Airdropped","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"owner","type":"address"},{"indexed":true,"internalType":"address","name":"spender","type":"address"},{"indexed":false,"internalType":"uint256","name":"value","type":"uint256"}],"name":"Approval","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"to","type":"address"},{"indexed":false,"internalType":"uint256","name":"amount","type":"uint256"},{"indexed":false,"internalType":"enum IBridgeToken.BridgeId","name":"bridgeId","type":"uint8"},{"indexed":false,"internalType":"bytes","name":"fromChainId","type":"bytes"},{"indexed":true,"internalType":"address","name":"from","type":"address"}],"name":"BridgeReceive","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"from","type":"address"},{"indexed":false,"internalType":"uint256","name":"amount","type":"uint256"},{"indexed":false,"internalType":"enum IBridgeToken.BridgeId","name":"bridgeId","type":"uint8"},{"indexed":false,"internalType":"bytes","name":"toChainId","type":"bytes"},{"indexed":true,"internalType":"address","name":"to","type":"address"}],"name":"BridgeTransfer","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"from","type":"address"},{"indexed":true,"internalType":"address","name":"to","type":"address"},{"indexed":false,"internalType":"uint256","name":"value","type":"uint256"}],"name":"Transfer","type":"event"},{"inputs":[],"name":"ENDPOINT","outputs":[{"internalType":"contract ILayerZeroEndpoint","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"GAS_SERVICE","outputs":[{"internalType":"contract IAxelarGasService","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"WORMHOLE_RELAYER","outputs":[{"internalType":"contract IWormholeRelayer","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"addressThis","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bytes32","name":"leaf","type":"bytes32"}],"name":"airdropClaimed","outputs":[{"internalType":"uint256","name":"amountClaimed","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"owner","type":"address"},{"internalType":"address","name":"spender","type":"address"}],"name":"allowance","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"spender","type":"address"},{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"approve","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"account","type":"address"}],"name":"balanceOf","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"string","name":"_destinationChain","type":"string"},{"internalType":"address","name":"_from","type":"address"},{"internalType":"address","name":"_to","type":"address"},{"internalType":"uint256","name":"_amount","type":"uint256"},{"internalType":"address payable","name":"_feeRefundAddress","type":"address"}],"name":"bridgeViaAxelar","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[{"internalType":"uint16","name":"_dstChainId","type":"uint16"},{"internalType":"address","name":"_from","type":"address"},{"internalType":"address","name":"_to","type":"address"},{"internalType":"uint256","name":"_amount","type":"uint256"},{"internalType":"address payable","name":"_feeRefundAddress","type":"address"},{"internalType":"address","name":"_zroPaymentAddress","type":"address"},{"internalType":"bytes","name":"_adapterParams","type":"bytes"}],"name":"bridgeViaLayerZero","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[{"internalType":"uint16","name":"_targetChain","type":"uint16"},{"internalType":"address","name":"_from","type":"address"},{"internalType":"address","name":"_to","type":"address"},{"internalType":"uint256","name":"_amount","type":"uint256"},{"internalType":"address payable","name":"_feeRefundAddress","type":"address"},{"internalType":"uint256","name":"_gasLimit","type":"uint256"}],"name":"bridgeViaWormhole","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[{"internalType":"address","name":"_user","type":"address"},{"internalType":"uint256","name":"_amount","type":"uint256"}],"name":"burn","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes32[]","name":"_proof","type":"bytes32[]"},{"internalType":"uint256","name":"_airdroppedAmount","type":"uint256"},{"internalType":"uint256","name":"_amountToClaim","type":"uint256"}],"name":"claim","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"core","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"decimals","outputs":[{"internalType":"uint8","name":"","type":"uint8"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"spender","type":"address"},{"internalType":"uint256","name":"subtractedValue","type":"uint256"}],"name":"decreaseAllowance","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint16","name":"_dstChainId","type":"uint16"},{"internalType":"address","name":"_from","type":"address"},{"internalType":"address","name":"_to","type":"address"},{"internalType":"uint256","name":"_amount","type":"uint256"},{"internalType":"bool","name":"_payInZRO","type":"bool"},{"internalType":"bytes","name":"_adapterParam","type":"bytes"}],"name":"estimateGasForLayerZero","outputs":[{"internalType":"uint256","name":"nativeFee_","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint16","name":"_targetChain","type":"uint16"},{"internalType":"uint256","name":"_gasLimit","type":"uint256"}],"name":"estimateGasForWormhole","outputs":[{"internalType":"uint256","name":"cost_","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bytes32","name":"commandId","type":"bytes32"},{"internalType":"string","name":"sourceChain","type":"string"},{"internalType":"string","name":"sourceAddress","type":"string"},{"internalType":"bytes","name":"payload","type":"bytes"}],"name":"execute","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes32","name":"commandId","type":"bytes32"},{"internalType":"string","name":"sourceChain","type":"string"},{"internalType":"string","name":"sourceAddress","type":"string"},{"internalType":"bytes","name":"payload","type":"bytes"},{"internalType":"string","name":"tokenSymbol","type":"string"},{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"executeWithToken","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"gateway","outputs":[{"internalType":"contract IAxelarGateway","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"spender","type":"address"},{"internalType":"uint256","name":"addedValue","type":"uint256"}],"name":"increaseAllowance","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"initialTimestamp","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint16","name":"_srcChainId","type":"uint16"},{"internalType":"bytes","name":"_srcAddress","type":"bytes"},{"internalType":"uint64","name":"","type":"uint64"},{"internalType":"bytes","name":"_payload","type":"bytes"}],"name":"lzReceive","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"merkleRoot","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"_account","type":"address"},{"internalType":"uint256","name":"_amount","type":"uint256"}],"name":"mint","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"name","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"pool","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bytes32[]","name":"_proof","type":"bytes32[]"},{"internalType":"address","name":"_user","type":"address"},{"internalType":"uint256","name":"_bondPower","type":"uint256"},{"internalType":"uint256","name":"_bondCount","type":"uint256"},{"internalType":"uint256","name":"_daysCount","type":"uint256"},{"internalType":"uint256","name":"_airdroppedAmount","type":"uint256"}],"name":"purchaseBondWithAirdroppedALX","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes","name":"_payload","type":"bytes"},{"internalType":"bytes[]","name":"","type":"bytes[]"},{"internalType":"bytes32","name":"_sourceAddress","type":"bytes32"},{"internalType":"uint16","name":"_srcChainId","type":"uint16"},{"internalType":"bytes32","name":"_deliveryHash","type":"bytes32"}],"name":"receiveWormholeMessages","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"name":"seenDeliveryVaaHashes","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"_ALXPOL","type":"address"}],"name":"setPool","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes32[]","name":"_proof","type":"bytes32[]"},{"internalType":"address","name":"_user","type":"address"},{"internalType":"uint256","name":"_duration","type":"uint256"},{"internalType":"uint256","name":"_amountToStake","type":"uint256"},{"internalType":"uint256","name":"_airdroppedAmount","type":"uint256"}],"name":"stakeWithAirdroppedALX","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"symbol","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"totalAirdroppedSupply","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"totalSupply","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"transfer","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"from","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"transferFrom","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"user","type":"address"}],"name":"userBurns","outputs":[{"internalType":"uint256","name":"amountBurnt","type":"uint256"}],"stateMutability":"view","type":"function"}]

610160604081815260c08261356f803803809161001c828561079f565b83398101031261077f578151906020926100378482016107c2565b936100438383016107c2565b91610050606082016107c2565b61006860a0610061608085016107c2565b93016107c2565b6100706107f1565b906100796107f1565b956001600160a01b03908116801561076e5760805282516001600160401b0395909290868411610677576003958654946001968787811c97168015610764575b8b88101461074e5781908b601f988981116106fa575b50508b908883116001146106985760009261068d575b5050600019828a1b1c191690871b1787555b89518881116106775760049a8b548881811c9116801561066d575b8c82101461065857908b82898997969594116105fe575b50508b90888311600114610582578593929160009183610577575b5050600019828c1b1c191690891b178c555b1660c0521660a0521660e0528651943060601b818701526014865261017a86610784565b855188519661018888610784565b601088526f181899199a1a9b1b9c1cb0b131b232b360811b8389015280519081861b60029280820484149015171561056257820180831161056257906101e9826101e16101d88f989796956107d6565b9751978861079f565b8087526107d6565b99848601601f19809c0136823786511561054d57603090538551881015610538576078602187015360005b848110610450575050505050815195861161043b576005978854908582811c92168015610431575b8383101461041c57508381116103d8575b5080928611600114610371575084955090849291600095610366575b50501b92600019911b1c19161790555b610140904282526101209283526101009384525191612d3793846108388539608051848181610279015281816114a101528181611eff0152611fef015260a051848181610c0d015281816111bb01528181611a3501528181611b0401528181611bab01528181611d4101526121d2015260c0518481816103c6015261104f015260e051848181610a64015281816112bc0152818161203401526126c001525183818161049f0152818161055601528181610d88015281816117a401526118250152518281816105fd0152611931015251818181610519015281816107c8015281816108be0152610cfa0152f35b015193503880610269565b939295859081168860005285600020956000905b898383106103be57505050106103a4575b50505050811b019055610279565b01519060f884600019921b161c1916905538808080610396565b858701518955909701969485019488935090810190610385565b8860005281600020848089018b1c820192848a10610413575b018a1c019085905b82811061040757505061024d565b600081550185906103f9565b925081926103f1565b602290634e487b7160e01b6000525260246000fd5b91607f169161023c565b604188634e487b7160e01b6000525260246000fd5b7fff000000000000000000000000000000000000000000000000000000000000008061048961047f8487610810565b5160fc1c85610810565b511690828b1b91838304871484151715610522578287019081881161050b576104b69060001a918b610810565b536104d1600f6104c68588610810565b5160f81c1685610810565b5116908b0190818c116104f657906104ef8b939260001a918a610810565b5301610214565b60118f634e487b7160e01b6000525260246000fd5b505060118f634e487b7160e01b6000525260246000fd5b5060118f634e487b7160e01b6000525260246000fd5b60328c634e487b7160e01b6000525260246000fd5b60328d634e487b7160e01b6000525260246000fd5b60118b634e487b7160e01b6000525260246000fd5b015190503880610144565b918c8a928f97969594601f1984169860005282600020926000905b8a82106105d7575050838899989798106105bf575b505050811b018c55610156565b0151600019838e1b60f8161c191690553880806105b2565b9296985094819497999387849301518155019501930192899694919795928f948d9561059d565b909192939495508d60005288826000209181860160051c830193861061064f575b918b918a9897969594930160051c01915b82811061064057508d9150610129565b600081558997508b9101610630565b9250819261061f565b60228d634e487b7160e01b6000525260246000fd5b90607f1690610112565b634e487b7160e01b600052604160045260246000fd5b0151905038806100e5565b60008b81528d81208b9550929190601f198516908f5b8282106106e357505084116106cb575b505050811b0187556100f7565b0151600019838c1b60f8161c191690553880806106be565b8385015186558d979095019493840193018f6106ae565b909192508a60005288826000209181860160051c8301938610610745575b918b91869594930160051c01915b82811061073657508d91506100cf565b600081558594508b9101610726565b92508192610718565b634e487b7160e01b600052602260045260246000fd5b96607f16966100b9565b885163e6c4247b60e01b8152600490fd5b600080fd5b604081019081106001600160401b0382111761067757604052565b601f909101601f19168101906001600160401b0382119082101761067757604052565b51906001600160a01b038216820361077f57565b6001600160401b03811161067757601f01601f191660200190565b604051906107fe82610784565b600382526208298b60eb1b6020830152565b908151811015610821570160200190565b634e487b7160e01b600052603260045260246000fdfe6080604052600436101561001257600080fd5b6000803560e01c80621d35671461216757806306fdde031461208a578063095ea7b3146120635780630f1f9cfc1461201e578063116191b614611fd957806316f0115b14611fb0578063180f6cc214611f8157806318160ddd14611f635780631a98b2e014611e1b57806322282f0314611deb57806323b872dd14611db257806325c7e35b146119545780632eb4a7ab14611919578063313ce567146118fd57806339509351146118ac57806340c10f19146118065780634437152a1461176c57806349160658146113c2578063529dca32146111ea5780636fad06f5146111a557806370a082311461116d57806395d89b411461107e578063997f35eb146110395780639dc29fac14610f20578063a457c2d714610e7b578063a9059cbb14610e49578063af4ba6cf14610e2b578063b024c11c14610cb7578063b3e4376814610c8d578063b7edaaf614610b31578063b963111414610972578063c8e769821461093e578063ce653d5f14610905578063d4a6da09146107eb578063d6d14171146107b0578063dd62ed3e14610761578063eaa24a21146104d1578063f2f4eb26146104895763facea41e146101c957600080fd5b60031960a036820112610485576004356001600160401b038111610481576101f590369060040161241a565b91906101ff6123ee565b90610208612404565b9260643594610215612447565b94604051958661022a89848960208501612719565b039361023e601f19958681018a5289612311565b896102476124b8565b92346103bc575b505060018060a01b03809361026d8b838b169a338c036103ac57612b38565b1697881561039a578a937f000000000000000000000000000000000000000000000000000000000000000016803b15610396578785876102f382966102d4966102e46040519a8b998a988997631c92115f60e01b8952606060048a0152606489019161265a565b9084878303016024880152612398565b91848303016044850152612398565b03925af1801561038b5761036f575b50509161034161034e92600080516020612ca283398151915294610335604051948592602080850152604084019161265a565b03908101835282612311565b60405191829187836125e3565b0390a36001461461035d575080f35b6103699060065461273b565b60065580f35b61037b909492946122cd565b61038757918638610302565b8680fd5b6040513d84823e3d90fd5b8480fd5b604051638aa3a72f60e01b8152600490fd5b6103b7823383612944565b612b38565b6001600160a01b037f000000000000000000000000000000000000000000000000000000000000000081169190823b1561047d5785928a8986948f9461044d61042e9661043d8c6040519b8c9a8b998a99630c93e3bb60e01b8b523060048c015260a060248c015260a48b019161265a565b91888303016044890152612398565b908c868303016064870152612398565b91166084830152039134905af1801561038b571561024e5761046e906122cd565b61047957893861024e565b8980fd5b8380fd5b8280fd5b5080fd5b50346104ce57806003193601126104ce576040517f00000000000000000000000000000000000000000000000000000000000000006001600160a01b03168152602090f35b80fd5b50346104ce5760c03660031901126104ce576004356001600160401b03811161048557610502903690600401612488565b9061050b6123ee565b916044356064359260a435947f00000000000000000000000000000000000000000000000000000000000000006276a700810180911161074d57421161073b5760018060a01b0392837f0000000000000000000000000000000000000000000000000000000000000000169460405193639b21756560e01b855282600486015287602486015289604486015260209182866064818b5afa958615610730578b966106fb575b5061062491610629918b6040516105dd816105cf898201943386612748565b03601f198101835282612311565b5190206040518681019182528681526105f5816122f6565b5190209384927f0000000000000000000000000000000000000000000000000000000000000000923691612763565b612c2d565b156106e957808a52600b825261064460408b2054809a61261f565b85116106d757899885918a52600b83520160408920558360095401600955600080516020612ce2833981519152604051918583523392a2843b1561038757869460a49386926040519889978896630ea562d160e21b885216600487015260248601526084356044860152606485015260848401525af1801561038b576106c75750f35b6106d0906122cd565b6104ce5780f35b60405163111c38fd60e31b8152600490fd5b6040516369ca16c960e01b8152600490fd5b9095508281813d8311610729575b6107138183612311565b810103126107255751946106246105b0565b8a80fd5b503d610709565b6040513d8d823e3d90fd5b60405163c1293bcd60e01b8152600490fd5b634e487b7160e01b88526011600452602488fd5b50346104ce5760403660031901126104ce5761077b6123d8565b60406107856123ee565b9260018060a01b03809316815260016020522091166000526020526020604060002054604051908152f35b50346104ce57806003193601126104ce5760206040517f00000000000000000000000000000000000000000000000000000000000000008152f35b50346104ce5760603660031901126104ce576004356001600160401b0381116104855761081c903690600401612488565b6008546044359260243592916001600160a01b03161580156108bb575b61073b5761085e6106249160405193602094858101906105dd816105cf8a3386612748565b156106e957808552600b82526108796040862054809461261f565b84116106d757600080516020612ce28339815191529284918652600b835201604085205582600954016009556108af83336127b1565b6040519283523392a280f35b507f00000000000000000000000000000000000000000000000000000000000000006276a70081018091116108f1574211610839565b634e487b7160e01b86526011600452602486fd5b50346104ce5760203660031901126104ce576020906040906001600160a01b0361092d6123d8565b168152600a83522054604051908152f35b50346104ce57806003193601126104ce5761096e61095a6124b8565b604051918291602083526020830190612398565b0390f35b5060c03660031901126104ce576109876122bc565b61098f6123ee565b610997612404565b91606435926109a4612447565b9060a4356109b28185612691565b3410610b1f576001600160a01b03948086169433869003610b0f575b6109d88883612b38565b86841696871561039a5761ffff610a47928b83610a0699610a148e6040519c8d9160209d8e9c8d8501612719565b03601f1981018d528c612311565b604051988997889687966312d729bd60e21b8852169c8d600488015230602488015260e0604488015260e4870190612398565b93606486015260848501528a60a48501521660c4830152039134907f0000000000000000000000000000000000000000000000000000000000000000165af18015610b0457610ac6575b50600080516020612ca28339815191529161034e9160405191818301528152610ab9816122f6565b6040519182918783612601565b8181813d8311610afd575b610adb8183612311565b8101031261038757516001600160401b03811603610af95738610a91565b8580fd5b503d610ad1565b6040513d89823e3d90fd5b610b1a883384612944565b6109ce565b6040516306807deb60e41b8152600490fd5b50346104ce576003199060c0368301126104ce57610b4d6122bc565b90610b566123ee565b92610b5f612404565b90608435928315158094036104ce5760a435906001600160401b0382116104ce575092610bc460409593610c0993610b9e61ffff97369060040161241a565b939092610bb68a519b8c926064359160208501612719565b03601f1981018b528a612311565b610bf58851998a98899863040a7bb160e41b8a5216600489015230602489015260a0604489015260a4880190612398565b93606487015285840301608486015261265a565b03817f00000000000000000000000000000000000000000000000000000000000000006001600160a01b03165afa8015610c8157602091600091610c51575b50604051908152f35b610c73915060403d604011610c7a575b610c6b8183612311565b81019061267b565b5038610c48565b503d610c61565b6040513d6000823e3d90fd5b50346104ce5760203660031901126104ce5760406020916004358152600b83522054604051908152f35b50346104ce5760a03660031901126104ce576004356001600160401b03811161048557610ce8903690600401612488565b610cf06123ee565b60643591608435937f00000000000000000000000000000000000000000000000000000000000000006276a7008101809111610e1757421161073b57610d4d6106249160405193602094858101906105dd816105cf8c3386612748565b156106e957808652600b8252610d686040872054809661261f565b84116106d757859484918652600b835201604085205582600954016009557f000000000000000000000000000000000000000000000000000000000000000090610db284836127b1565b600080516020612ce2833981519152604051918583523392a26001600160a01b03908116803b1561039657849283606492604051968795869463df428d0160e01b8652166004850152602484015260443560448401525af1801561038b576106c75750f35b634e487b7160e01b87526011600452602487fd5b50346104ce57806003193601126104ce576020600954604051908152f35b50346104ce5760403660031901126104ce57610e70610e666123d8565b60243590336129dc565b602060405160018152f35b50346104ce5760403660031901126104ce57610e956123d8565b60406024359233815260016020522060018060a01b03821660005260205260406000205491808310610ecd57610e7092039033612842565b60405162461bcd60e51b815260206004820152602560248201527f45524332303a2064656372656173656420616c6c6f77616e63652062656c6f77604482015264207a65726f60d81b6064820152608490fd5b50346104ce5760403660031901126104ce57610f3a6123d8565b6024356040516301ffc9a760e01b815263543746b160e01b90816004820152602081602481335afa90811561102e578591610fff575b5015610fed5783926001600160a01b03811633819003610fdd575b610f958483612b38565b8452600a60205260408420838154019055333b15610fd8578391610fc56040519485938493845260048401612748565b038183335af1801561038b576106c75750f35b505050fd5b610fe8843384612944565b610f8b565b6040516331d5783360e11b8152600490fd5b611021915060203d602011611027575b6110198183612311565b810190612642565b38610f70565b503d61100f565b6040513d87823e3d90fd5b50346104ce57806003193601126104ce576040517f00000000000000000000000000000000000000000000000000000000000000006001600160a01b03168152602090f35b50346104ce57806003193601126104ce5760405160045460018082169180821c916000918415611163575b602094858510811461114f57848752869392918690821561112f5750506001146110ef575b506110db92500383612311565b61096e604051928284938452830190612398565b849150600460005281600020906000915b8583106111175750506110db9350820101856110ce565b80548389018501528794508693909201918101611100565b60ff1916858201526110db95151560051b85010192508791506110ce9050565b634e487b7160e01b84526022600452602484fd5b92607f16926110a9565b50346104ce5760203660031901126104ce576020906040906001600160a01b036111956123d8565b1681528083522054604051908152f35b50346104ce57806003193601126104ce576040517f00000000000000000000000000000000000000000000000000000000000000006001600160a01b03168152602090f35b5060a03660031901126104ce576001600160401b036004358181116104815761121790369060040161237a565b9060249060243581811161039657366023820112156103965780600401359061123f82612471565b9361124d6040519586612311565b828552602460208096019360051b830101933685116113be5760248301935b858510611398578888886064359061ffff8216809203611393576084358085526007825260ff6040862054166113815784526007815260408420805460ff191660011790556001600160a01b03927f00000000000000000000000000000000000000000000000000000000000000008416330361136f578360443516300361135d5783611310828480600080516020612c828339815191529551830101910161259c565b96169361131d87866127b1565b60405195818701528552611330856122f6565b61134260405192839216958783612601565b0390a360014614611351575080f35b6103699060065461261f565b6040516309aa97f760e31b8152600490fd5b6040516381316de160e01b8152600490fd5b60405163bed444bb60e01b8152600490fd5b600080fd5b84358281116104795787916113b3839286369189010161237a565b81520194019361126c565b8780fd5b50346104ce57600319608036820112610485576024906001600160401b03908235828111610396576113f890369060040161241a565b9290916044358281116103875761141390369060040161241a565b9590926064359081116113be5761142e90369060040161241a565b91909661143c36848a612334565b9486865196898c60808760209b8c8096012061149660018060a01b039c611485604051998a9889978897635f6970c360e01b895260043560048a0152880152608487019161265a565b908482030160448501528a8a61265a565b90606483015203918a7f0000000000000000000000000000000000000000000000000000000000000000165af1908115610730578b9161174f575b501561173d576114e2913691612334565b8051899291602a918281148015919061171b575b5080156116e2575b61169a579190600280935b8285106115ae575050505050823091160361159c578560609181010312610af957600080516020612c828339815191529161158a6115468761245d565b9161157c846040611558848c0161245d565b9a01359916966115688a896127b1565b60405198838a94850152604084019161265a565b03601f198101875286612311565b611342604051928392169587836125e3565b60405163063ce8cd60e31b8152600490fd5b909192939481518610156116cd5788868301015160f81c6061811015806116c2575b156116325760ff9081166056190190811161161d575b60299087820391821161160a5760ff1690841b1b8816179460010193929190611509565b634e487b7160e01b8f526011600452868ffd5b85634e487b7160e01b60005260116004526000fd5b6041811015806116b7575b156116685760ff90811660361901908111156115e65785634e487b7160e01b60005260116004526000fd5b6030811015806116ac575b1561169a57602f190160ff8111156115e65785634e487b7160e01b60005260116004526000fd5b604051636fa478cf60e11b8152600490fd5b506039811115611673565b50604681111561163d565b5060668111156115d0565b84634e487b7160e01b60005260326004526000fd5b508051600110156117085760218101516001600160f81b031916600f60fb1b14156114fe565b634e487b7160e01b8b526032600452828bfd5b90501561170857808701516001600160f81b031916600360fc1b1415386114f6565b604051631403112d60e21b8152600490fd5b6117669150873d8911611027576110198183612311565b386114d1565b50346104ce5760203660031901126104ce576117866123d8565b6008546001600160a01b03918282166117f45782169182156117e2577f00000000000000000000000000000000000000000000000000000000000000001633146117ce578280f35b6001600160a01b0319161760085538808280f35b60405163d92e233d60e01b8152600490fd5b604051636532af8360e11b8152600490fd5b50346104ce5760403660031901126104ce576118206123d8565b6024357f00000000000000000000000000000000000000000000000000000000000000006001600160a01b0316330361189a576a295be96e6406697200000061187761186e8360025461273b565b6006549061273b565b1161188857611885916127b1565b80f35b604051638a164f6360e01b8152600490fd5b6040516348f5c3ed60e01b8152600490fd5b50346104ce5760403660031901126104ce57610e709060406118cc6123d8565b9133815260016020522060018060a01b0382166000526020526118f660243560406000205461273b565b9033612842565b50346104ce57806003193601126104ce57602060405160128152f35b50346104ce57806003193601126104ce5760206040517f00000000000000000000000000000000000000000000000000000000000000008152f35b5060e03660031901126104ce576119696122bc565b6119716123ee565b9061197a612404565b611982612447565b60a435906001600160a01b0382168203610af9576001600160401b0360c4358181116113be576119b690369060040161241a565b926001600160a01b038516611cd1576040516119dd816105cf6064358a8d60208501612719565b604061ffff89611a318d611a188551968795869563040a7bb160e41b875216600486015230602486015260a0604486015260a4850190612398565b906064840152600319838203016084840152898861265a565b03817f00000000000000000000000000000000000000000000000000000000000000006001600160a01b03165afa908115611cc6578a91611ca6575b503410611c95575b6001600160a01b0388163303611c83575b611a9260643589612b38565b6001600160a01b0386161561039a57604051923060601b80602086015260348501526028845283606081011090606085011117611c6f5790829160608a959401604052611b0283611aea6064358a8d60808501612719565b03607f1981016060860152605f190160608501612311565b7f00000000000000000000000000000000000000000000000000000000000000006001600160a01b03163b1561039657611b7e93611ba692604051978896879662c5803160e81b885261ffff8d16600489015260c060248901526060611b6b60c48a0183612398565b8981036003190160448b01529101612398565b6001600160a01b039485166064880152931660848601528483036003190160a486015261265a565b0381347f00000000000000000000000000000000000000000000000000000000000000006001600160a01b03165af1801561102e57611c4a575b50611c2e600080516020612ca28339815191529161ffff6040519416602085015260208452611c0e846122f6565b6040516001600160a01b03918216959091169390918291606435836125c5565b0390a360014614611c3c5780f35b61036960643560065461273b565b600080516020612ca28339815191529194611c67611c2e926122cd565b949150611be0565b634e487b7160e01b89526041600452602489fd5b611c90606435338a612944565b611a86565b60405162976f7560e21b8152600490fd5b611cbf915060403d604011610c7a57610c6b8183612311565b5038611a6d565b6040513d8c823e3d90fd5b604051611ce9816105cf6064358a8d60208501612719565b604061ffff89611d3d611d238451958694859463040a7bb160e41b865216600485015230602485015260a0604485015260a4840190612398565b60016064840152828103600319016084840152898861265a565b03817f00000000000000000000000000000000000000000000000000000000000000006001600160a01b03165afa908115611cc6578a91611d92575b50341015611a755760405162976f7560e21b8152600490fd5b611dab915060403d604011610c7a57610c6b8183612311565b5038611d79565b50346104ce5760603660031901126104ce57610e70611dcf6123d8565b611dd76123ee565b60443591611de6833383612944565b6129dc565b50346104ce5760403660031901126104ce576020611e13611e0a6122bc565b60243590612691565b604051908152f35b50346104ce5760031960c036820112610485576001600160401b0360243581811161047d57611e4e90369060040161241a565b604435838111610af957611e6690369060040161241a565b6064358581116113be57611e7e90369060040161241a565b608435968711611f5f57611ee297610bf5611ef295611eb0611ea660209b369060040161241a565b9690953691612334565b8a8151910120956040519b8c9a8b9a631876eed960e01b8c5260043560048d015260c060248d015260c48c019161265a565b91848a84030160448b015261265a565b60a48035908301520381857f00000000000000000000000000000000000000000000000000000000000000006001600160a01b03165af190811561038b578291611f40575b501561173d5780f35b611f59915060203d602011611027576110198183612311565b38611f37565b8880fd5b50346104ce57806003193601126104ce576020600254604051908152f35b50346104ce5760203660031901126104ce5760ff60406020926004358152600784522054166040519015158152f35b50346104ce57806003193601126104ce576008546040516001600160a01b039091168152602090f35b50346104ce57806003193601126104ce576040517f00000000000000000000000000000000000000000000000000000000000000006001600160a01b03168152602090f35b50346104ce57806003193601126104ce576040517f00000000000000000000000000000000000000000000000000000000000000006001600160a01b03168152602090f35b50346104ce5760403660031901126104ce57610e706120806123d8565b6024359033612842565b50346104ce57806003193601126104ce5760405190806003549160018360011c926001851694851561215d575b6020958686108114612149578588528794939291879082156121275750506001146120eb575b50506110db92500383612311565b90859250600382528282205b85831061210f5750506110db935082010138806120dd565b805483890185015287945086939092019181016120f7565b92509350506110db94915060ff191682840152151560051b82010138806120dd565b634e487b7160e01b83526022600452602483fd5b93607f16936120b7565b50346104ce5760803660031901126104ce576121816122bc565b6001600160401b039060243582811161047d576121a290369060040161237a565b916044358181160361047d5760643590811161047d576121c690369060040161237a565b6001600160a01b0392337f00000000000000000000000000000000000000000000000000000000000000008516036122aa5780516020909101516001600160601b031991828216919060148110612295575b5050905060601c300361228357600080516020612c8283398151915261224882602080879551830101910161259c565b959193169261225786856127b1565b61ffff6040519516602086015260208552612271856122f6565b611342604051928392169587836125c5565b6040516347cec4bb60e11b8152600490fd5b8391925060140360031b1b1616803880612218565b60405163a667bffb60e01b8152600490fd5b6004359061ffff8216820361139357565b6001600160401b0381116122e057604052565b634e487b7160e01b600052604160045260246000fd5b604081019081106001600160401b038211176122e057604052565b601f909101601f19168101906001600160401b038211908210176122e057604052565b9192916001600160401b0382116122e0576040519161235d601f8201601f191660200184612311565b829481845281830111611393578281602093846000960137010152565b9080601f830112156113935781602061239593359101612334565b90565b919082519283825260005b8481106123c4575050826000602080949584010152601f8019910116010190565b6020818301810151848301820152016123a3565b600435906001600160a01b038216820361139357565b602435906001600160a01b038216820361139357565b604435906001600160a01b038216820361139357565b9181601f84011215611393578235916001600160401b038311611393576020838186019501011161139357565b608435906001600160a01b038216820361139357565b35906001600160a01b038216820361139357565b6001600160401b0381116122e05760051b60200190565b9181601f84011215611393578235916001600160401b038311611393576020808501948460051b01011161139357565b6040519060006005549060018260011c906001841693841561257e575b602094858410811461256a578388528794939291811561254a5750600114612508575b505061250692500383612311565b565b90939150600560005281600020936000915b818310612532575050612506935082010138806124f8565b8554888401850152948501948794509183019161251a565b91505061250694925060ff191682840152151560051b82010138806124f8565b634e487b7160e01b85526022600452602485fd5b91607f16916124d5565b51906001600160a01b038216820361139357565b90816060910312611393576125b081612588565b9160406125bf60208401612588565b92015190565b60609061239593928152600060208201528160408201520190612398565b60609061239593928152600260208201528160408201520190612398565b60609061239593928152600160208201528160408201520190612398565b9190820391821161262c57565b634e487b7160e01b600052601160045260246000fd5b90816020910312611393575180151581036113935790565b908060209392818452848401376000828201840152601f01601f1916010190565b9190826040910312611393576020825192015190565b6040805163c23ee3c360e01b815261ffff909216600483015260006024830152604482019290925290816064817f00000000000000000000000000000000000000000000000000000000000000006001600160a01b03165afa908115610c81576000916126fc575090565b612715915060403d604011610c7a57610c6b8183612311565b5090565b6001600160a01b03918216815291166020820152604081019190915260600190565b9190820180921161262c57565b6001600160a01b039091168152602081019190915260400190565b929161276e82612471565b9161277c6040519384612311565b829481845260208094019160051b810192831161139357905b8282106127a25750505050565b81358152908301908301612795565b6001600160a01b03169081156127fd57600080516020612cc28339815191526020826127e160009460025461273b565b60025584845283825260408420818154019055604051908152a3565b60405162461bcd60e51b815260206004820152601f60248201527f45524332303a206d696e7420746f20746865207a65726f2061646472657373006044820152606490fd5b6001600160a01b039081169182156128f357169182156128a35760207f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925918360005260018252604060002085600052825280604060002055604051908152a3565b60405162461bcd60e51b815260206004820152602260248201527f45524332303a20617070726f766520746f20746865207a65726f206164647265604482015261737360f01b6064820152608490fd5b60405162461bcd60e51b8152602060048201526024808201527f45524332303a20617070726f76652066726f6d20746865207a65726f206164646044820152637265737360e01b6064820152608490fd5b9060018060a01b038083166000526001602052604060002090821660005260205260406000205492600019840361297c575b50505050565b8084106129975761298e930391612842565b38808080612976565b60405162461bcd60e51b815260206004820152601d60248201527f45524332303a20696e73756666696369656e7420616c6c6f77616e63650000006044820152606490fd5b6001600160a01b03908116918215612ae55716918215612a9457600082815280602052604081205491808310612a405760408282600080516020612cc2833981519152958760209652828652038282205586815220818154019055604051908152a3565b60405162461bcd60e51b815260206004820152602660248201527f45524332303a207472616e7366657220616d6f756e7420657863656564732062604482015265616c616e636560d01b6064820152608490fd5b60405162461bcd60e51b815260206004820152602360248201527f45524332303a207472616e7366657220746f20746865207a65726f206164647260448201526265737360e81b6064820152608490fd5b60405162461bcd60e51b815260206004820152602560248201527f45524332303a207472616e736665722066726f6d20746865207a65726f206164604482015264647265737360d81b6064820152608490fd5b6001600160a01b03168015612bde57600091818352826020526040832054818110612b8e5781600080516020612cc2833981519152926020928587528684520360408620558060025403600255604051908152a3565b60405162461bcd60e51b815260206004820152602260248201527f45524332303a206275726e20616d6f756e7420657863656564732062616c616e604482015261636560f01b6064820152608490fd5b60405162461bcd60e51b815260206004820152602160248201527f45524332303a206275726e2066726f6d20746865207a65726f206164647265736044820152607360f81b6064820152608490fd5b9091906000915b8151831015612c7a576020808460051b84010151916000838210600014612c6a575060005252600160406000205b920191612c34565b9060409260019483525220612c62565b915050149056fe51fa6b13f6daaeb242e226abef2a9ff882bc8f2559829aa56db5baddc7a494b4910681e1ddfdfd81641e12c78e640eb5928c78b55a791eeec551d2c3bd1581e2ddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef7bd6d4be1decdc27a9ed9c7ccdf5bb7cc38e31b3647b958c6b37162a2296c0faa2646970667358221220a658a3ab8749752191f725609be2a218b5d73c5e76f03f2cbb8d992b0fac0aa264736f6c63430008190033d4bcbe05fe31207aef0c337f192001cecf2cacc2c113932601576e0a321e5c720000000000000000000000007a7e4ef924803b956ca97a415c86cd9f905510980000000000000000000000004f4495243837681061c4743b74b3eedf548d56a50000000000000000000000002d5d7d31f671f86c782533cc367f14109a08271200000000000000000000000066a71dcef29a0ffbdbe3c6a460a3b5bc225cd67500000000000000000000000027428dd2d3dd32a4d7f7c497eaaa23130d894911

0x6080604052600436101561001257600080fd5b6000803560e01c80621d35671461216757806306fdde031461208a578063095ea7b3146120635780630f1f9cfc1461201e578063116191b614611fd957806316f0115b14611fb0578063180f6cc214611f8157806318160ddd14611f635780631a98b2e014611e1b57806322282f0314611deb57806323b872dd14611db257806325c7e35b146119545780632eb4a7ab14611919578063313ce567146118fd57806339509351146118ac57806340c10f19146118065780634437152a1461176c57806349160658146113c2578063529dca32146111ea5780636fad06f5146111a557806370a082311461116d57806395d89b411461107e578063997f35eb146110395780639dc29fac14610f20578063a457c2d714610e7b578063a9059cbb14610e49578063af4ba6cf14610e2b578063b024c11c14610cb7578063b3e4376814610c8d578063b7edaaf614610b31578063b963111414610972578063c8e769821461093e578063ce653d5f14610905578063d4a6da09146107eb578063d6d14171146107b0578063dd62ed3e14610761578063eaa24a21146104d1578063f2f4eb26146104895763facea41e146101c957600080fd5b60031960a036820112610485576004356001600160401b038111610481576101f590369060040161241a565b91906101ff6123ee565b90610208612404565b9260643594610215612447565b94604051958661022a89848960208501612719565b039361023e601f19958681018a5289612311565b896102476124b8565b92346103bc575b505060018060a01b03809361026d8b838b169a338c036103ac57612b38565b1697881561039a578a937f0000000000000000000000004f4495243837681061c4743b74b3eedf548d56a516803b15610396578785876102f382966102d4966102e46040519a8b998a988997631c92115f60e01b8952606060048a0152606489019161265a565b9084878303016024880152612398565b91848303016044850152612398565b03925af1801561038b5761036f575b50509161034161034e92600080516020612ca283398151915294610335604051948592602080850152604084019161265a565b03908101835282612311565b60405191829187836125e3565b0390a36001461461035d575080f35b6103699060065461273b565b60065580f35b61037b909492946122cd565b61038757918638610302565b8680fd5b6040513d84823e3d90fd5b8480fd5b604051638aa3a72f60e01b8152600490fd5b6103b7823383612944565b612b38565b6001600160a01b037f0000000000000000000000002d5d7d31f671f86c782533cc367f14109a08271281169190823b1561047d5785928a8986948f9461044d61042e9661043d8c6040519b8c9a8b998a99630c93e3bb60e01b8b523060048c015260a060248c015260a48b019161265a565b91888303016044890152612398565b908c868303016064870152612398565b91166084830152039134905af1801561038b571561024e5761046e906122cd565b61047957893861024e565b8980fd5b8380fd5b8280fd5b5080fd5b50346104ce57806003193601126104ce576040517f0000000000000000000000007a7e4ef924803b956ca97a415c86cd9f905510986001600160a01b03168152602090f35b80fd5b50346104ce5760c03660031901126104ce576004356001600160401b03811161048557610502903690600401612488565b9061050b6123ee565b916044356064359260a435947f0000000000000000000000000000000000000000000000000000000066af8a076276a700810180911161074d57421161073b5760018060a01b0392837f0000000000000000000000007a7e4ef924803b956ca97a415c86cd9f90551098169460405193639b21756560e01b855282600486015287602486015289604486015260209182866064818b5afa958615610730578b966106fb575b5061062491610629918b6040516105dd816105cf898201943386612748565b03601f198101835282612311565b5190206040518681019182528681526105f5816122f6565b5190209384927fd4bcbe05fe31207aef0c337f192001cecf2cacc2c113932601576e0a321e5c72923691612763565b612c2d565b156106e957808a52600b825261064460408b2054809a61261f565b85116106d757899885918a52600b83520160408920558360095401600955600080516020612ce2833981519152604051918583523392a2843b1561038757869460a49386926040519889978896630ea562d160e21b885216600487015260248601526084356044860152606485015260848401525af1801561038b576106c75750f35b6106d0906122cd565b6104ce5780f35b60405163111c38fd60e31b8152600490fd5b6040516369ca16c960e01b8152600490fd5b9095508281813d8311610729575b6107138183612311565b810103126107255751946106246105b0565b8a80fd5b503d610709565b6040513d8d823e3d90fd5b60405163c1293bcd60e01b8152600490fd5b634e487b7160e01b88526011600452602488fd5b50346104ce5760403660031901126104ce5761077b6123d8565b60406107856123ee565b9260018060a01b03809316815260016020522091166000526020526020604060002054604051908152f35b50346104ce57806003193601126104ce5760206040517f0000000000000000000000000000000000000000000000000000000066af8a078152f35b50346104ce5760603660031901126104ce576004356001600160401b0381116104855761081c903690600401612488565b6008546044359260243592916001600160a01b03161580156108bb575b61073b5761085e6106249160405193602094858101906105dd816105cf8a3386612748565b156106e957808552600b82526108796040862054809461261f565b84116106d757600080516020612ce28339815191529284918652600b835201604085205582600954016009556108af83336127b1565b6040519283523392a280f35b507f0000000000000000000000000000000000000000000000000000000066af8a076276a70081018091116108f1574211610839565b634e487b7160e01b86526011600452602486fd5b50346104ce5760203660031901126104ce576020906040906001600160a01b0361092d6123d8565b168152600a83522054604051908152f35b50346104ce57806003193601126104ce5761096e61095a6124b8565b604051918291602083526020830190612398565b0390f35b5060c03660031901126104ce576109876122bc565b61098f6123ee565b610997612404565b91606435926109a4612447565b9060a4356109b28185612691565b3410610b1f576001600160a01b03948086169433869003610b0f575b6109d88883612b38565b86841696871561039a5761ffff610a47928b83610a0699610a148e6040519c8d9160209d8e9c8d8501612719565b03601f1981018d528c612311565b604051988997889687966312d729bd60e21b8852169c8d600488015230602488015260e0604488015260e4870190612398565b93606486015260848501528a60a48501521660c4830152039134907f00000000000000000000000027428dd2d3dd32a4d7f7c497eaaa23130d894911165af18015610b0457610ac6575b50600080516020612ca28339815191529161034e9160405191818301528152610ab9816122f6565b6040519182918783612601565b8181813d8311610afd575b610adb8183612311565b8101031261038757516001600160401b03811603610af95738610a91565b8580fd5b503d610ad1565b6040513d89823e3d90fd5b610b1a883384612944565b6109ce565b6040516306807deb60e41b8152600490fd5b50346104ce576003199060c0368301126104ce57610b4d6122bc565b90610b566123ee565b92610b5f612404565b90608435928315158094036104ce5760a435906001600160401b0382116104ce575092610bc460409593610c0993610b9e61ffff97369060040161241a565b939092610bb68a519b8c926064359160208501612719565b03601f1981018b528a612311565b610bf58851998a98899863040a7bb160e41b8a5216600489015230602489015260a0604489015260a4880190612398565b93606487015285840301608486015261265a565b03817f00000000000000000000000066a71dcef29a0ffbdbe3c6a460a3b5bc225cd6756001600160a01b03165afa8015610c8157602091600091610c51575b50604051908152f35b610c73915060403d604011610c7a575b610c6b8183612311565b81019061267b565b5038610c48565b503d610c61565b6040513d6000823e3d90fd5b50346104ce5760203660031901126104ce5760406020916004358152600b83522054604051908152f35b50346104ce5760a03660031901126104ce576004356001600160401b03811161048557610ce8903690600401612488565b610cf06123ee565b60643591608435937f0000000000000000000000000000000000000000000000000000000066af8a076276a7008101809111610e1757421161073b57610d4d6106249160405193602094858101906105dd816105cf8c3386612748565b156106e957808652600b8252610d686040872054809661261f565b84116106d757859484918652600b835201604085205582600954016009557f0000000000000000000000007a7e4ef924803b956ca97a415c86cd9f9055109890610db284836127b1565b600080516020612ce2833981519152604051918583523392a26001600160a01b03908116803b1561039657849283606492604051968795869463df428d0160e01b8652166004850152602484015260443560448401525af1801561038b576106c75750f35b634e487b7160e01b87526011600452602487fd5b50346104ce57806003193601126104ce576020600954604051908152f35b50346104ce5760403660031901126104ce57610e70610e666123d8565b60243590336129dc565b602060405160018152f35b50346104ce5760403660031901126104ce57610e956123d8565b60406024359233815260016020522060018060a01b03821660005260205260406000205491808310610ecd57610e7092039033612842565b60405162461bcd60e51b815260206004820152602560248201527f45524332303a2064656372656173656420616c6c6f77616e63652062656c6f77604482015264207a65726f60d81b6064820152608490fd5b50346104ce5760403660031901126104ce57610f3a6123d8565b6024356040516301ffc9a760e01b815263543746b160e01b90816004820152602081602481335afa90811561102e578591610fff575b5015610fed5783926001600160a01b03811633819003610fdd575b610f958483612b38565b8452600a60205260408420838154019055333b15610fd8578391610fc56040519485938493845260048401612748565b038183335af1801561038b576106c75750f35b505050fd5b610fe8843384612944565b610f8b565b6040516331d5783360e11b8152600490fd5b611021915060203d602011611027575b6110198183612311565b810190612642565b38610f70565b503d61100f565b6040513d87823e3d90fd5b50346104ce57806003193601126104ce576040517f0000000000000000000000002d5d7d31f671f86c782533cc367f14109a0827126001600160a01b03168152602090f35b50346104ce57806003193601126104ce5760405160045460018082169180821c916000918415611163575b602094858510811461114f57848752869392918690821561112f5750506001146110ef575b506110db92500383612311565b61096e604051928284938452830190612398565b849150600460005281600020906000915b8583106111175750506110db9350820101856110ce565b80548389018501528794508693909201918101611100565b60ff1916858201526110db95151560051b85010192508791506110ce9050565b634e487b7160e01b84526022600452602484fd5b92607f16926110a9565b50346104ce5760203660031901126104ce576020906040906001600160a01b036111956123d8565b1681528083522054604051908152f35b50346104ce57806003193601126104ce576040517f00000000000000000000000066a71dcef29a0ffbdbe3c6a460a3b5bc225cd6756001600160a01b03168152602090f35b5060a03660031901126104ce576001600160401b036004358181116104815761121790369060040161237a565b9060249060243581811161039657366023820112156103965780600401359061123f82612471565b9361124d6040519586612311565b828552602460208096019360051b830101933685116113be5760248301935b858510611398578888886064359061ffff8216809203611393576084358085526007825260ff6040862054166113815784526007815260408420805460ff191660011790556001600160a01b03927f00000000000000000000000027428dd2d3dd32a4d7f7c497eaaa23130d8949118416330361136f578360443516300361135d5783611310828480600080516020612c828339815191529551830101910161259c565b96169361131d87866127b1565b60405195818701528552611330856122f6565b61134260405192839216958783612601565b0390a360014614611351575080f35b6103699060065461261f565b6040516309aa97f760e31b8152600490fd5b6040516381316de160e01b8152600490fd5b60405163bed444bb60e01b8152600490fd5b600080fd5b84358281116104795787916113b3839286369189010161237a565b81520194019361126c565b8780fd5b50346104ce57600319608036820112610485576024906001600160401b03908235828111610396576113f890369060040161241a565b9290916044358281116103875761141390369060040161241a565b9590926064359081116113be5761142e90369060040161241a565b91909661143c36848a612334565b9486865196898c60808760209b8c8096012061149660018060a01b039c611485604051998a9889978897635f6970c360e01b895260043560048a0152880152608487019161265a565b908482030160448501528a8a61265a565b90606483015203918a7f0000000000000000000000004f4495243837681061c4743b74b3eedf548d56a5165af1908115610730578b9161174f575b501561173d576114e2913691612334565b8051899291602a918281148015919061171b575b5080156116e2575b61169a579190600280935b8285106115ae575050505050823091160361159c578560609181010312610af957600080516020612c828339815191529161158a6115468761245d565b9161157c846040611558848c0161245d565b9a01359916966115688a896127b1565b60405198838a94850152604084019161265a565b03601f198101875286612311565b611342604051928392169587836125e3565b60405163063ce8cd60e31b8152600490fd5b909192939481518610156116cd5788868301015160f81c6061811015806116c2575b156116325760ff9081166056190190811161161d575b60299087820391821161160a5760ff1690841b1b8816179460010193929190611509565b634e487b7160e01b8f526011600452868ffd5b85634e487b7160e01b60005260116004526000fd5b6041811015806116b7575b156116685760ff90811660361901908111156115e65785634e487b7160e01b60005260116004526000fd5b6030811015806116ac575b1561169a57602f190160ff8111156115e65785634e487b7160e01b60005260116004526000fd5b604051636fa478cf60e11b8152600490fd5b506039811115611673565b50604681111561163d565b5060668111156115d0565b84634e487b7160e01b60005260326004526000fd5b508051600110156117085760218101516001600160f81b031916600f60fb1b14156114fe565b634e487b7160e01b8b526032600452828bfd5b90501561170857808701516001600160f81b031916600360fc1b1415386114f6565b604051631403112d60e21b8152600490fd5b6117669150873d8911611027576110198183612311565b386114d1565b50346104ce5760203660031901126104ce576117866123d8565b6008546001600160a01b03918282166117f45782169182156117e2577f0000000000000000000000007a7e4ef924803b956ca97a415c86cd9f905510981633146117ce578280f35b6001600160a01b0319161760085538808280f35b60405163d92e233d60e01b8152600490fd5b604051636532af8360e11b8152600490fd5b50346104ce5760403660031901126104ce576118206123d8565b6024357f0000000000000000000000007a7e4ef924803b956ca97a415c86cd9f905510986001600160a01b0316330361189a576a295be96e6406697200000061187761186e8360025461273b565b6006549061273b565b1161188857611885916127b1565b80f35b604051638a164f6360e01b8152600490fd5b6040516348f5c3ed60e01b8152600490fd5b50346104ce5760403660031901126104ce57610e709060406118cc6123d8565b9133815260016020522060018060a01b0382166000526020526118f660243560406000205461273b565b9033612842565b50346104ce57806003193601126104ce57602060405160128152f35b50346104ce57806003193601126104ce5760206040517fd4bcbe05fe31207aef0c337f192001cecf2cacc2c113932601576e0a321e5c728152f35b5060e03660031901126104ce576119696122bc565b6119716123ee565b9061197a612404565b611982612447565b60a435906001600160a01b0382168203610af9576001600160401b0360c4358181116113be576119b690369060040161241a565b926001600160a01b038516611cd1576040516119dd816105cf6064358a8d60208501612719565b604061ffff89611a318d611a188551968795869563040a7bb160e41b875216600486015230602486015260a0604486015260a4850190612398565b906064840152600319838203016084840152898861265a565b03817f00000000000000000000000066a71dcef29a0ffbdbe3c6a460a3b5bc225cd6756001600160a01b03165afa908115611cc6578a91611ca6575b503410611c95575b6001600160a01b0388163303611c83575b611a9260643589612b38565b6001600160a01b0386161561039a57604051923060601b80602086015260348501526028845283606081011090606085011117611c6f5790829160608a959401604052611b0283611aea6064358a8d60808501612719565b03607f1981016060860152605f190160608501612311565b7f00000000000000000000000066a71dcef29a0ffbdbe3c6a460a3b5bc225cd6756001600160a01b03163b1561039657611b7e93611ba692604051978896879662c5803160e81b885261ffff8d16600489015260c060248901526060611b6b60c48a0183612398565b8981036003190160448b01529101612398565b6001600160a01b039485166064880152931660848601528483036003190160a486015261265a565b0381347f00000000000000000000000066a71dcef29a0ffbdbe3c6a460a3b5bc225cd6756001600160a01b03165af1801561102e57611c4a575b50611c2e600080516020612ca28339815191529161ffff6040519416602085015260208452611c0e846122f6565b6040516001600160a01b03918216959091169390918291606435836125c5565b0390a360014614611c3c5780f35b61036960643560065461273b565b600080516020612ca28339815191529194611c67611c2e926122cd565b949150611be0565b634e487b7160e01b89526041600452602489fd5b611c90606435338a612944565b611a86565b60405162976f7560e21b8152600490fd5b611cbf915060403d604011610c7a57610c6b8183612311565b5038611a6d565b6040513d8c823e3d90fd5b604051611ce9816105cf6064358a8d60208501612719565b604061ffff89611d3d611d238451958694859463040a7bb160e41b865216600485015230602485015260a0604485015260a4840190612398565b60016064840152828103600319016084840152898861265a565b03817f00000000000000000000000066a71dcef29a0ffbdbe3c6a460a3b5bc225cd6756001600160a01b03165afa908115611cc6578a91611d92575b50341015611a755760405162976f7560e21b8152600490fd5b611dab915060403d604011610c7a57610c6b8183612311565b5038611d79565b50346104ce5760603660031901126104ce57610e70611dcf6123d8565b611dd76123ee565b60443591611de6833383612944565b6129dc565b50346104ce5760403660031901126104ce576020611e13611e0a6122bc565b60243590612691565b604051908152f35b50346104ce5760031960c036820112610485576001600160401b0360243581811161047d57611e4e90369060040161241a565b604435838111610af957611e6690369060040161241a565b6064358581116113be57611e7e90369060040161241a565b608435968711611f5f57611ee297610bf5611ef295611eb0611ea660209b369060040161241a565b9690953691612334565b8a8151910120956040519b8c9a8b9a631876eed960e01b8c5260043560048d015260c060248d015260c48c019161265a565b91848a84030160448b015261265a565b60a48035908301520381857f0000000000000000000000004f4495243837681061c4743b74b3eedf548d56a56001600160a01b03165af190811561038b578291611f40575b501561173d5780f35b611f59915060203d602011611027576110198183612311565b38611f37565b8880fd5b50346104ce57806003193601126104ce576020600254604051908152f35b50346104ce5760203660031901126104ce5760ff60406020926004358152600784522054166040519015158152f35b50346104ce57806003193601126104ce576008546040516001600160a01b039091168152602090f35b50346104ce57806003193601126104ce576040517f0000000000000000000000004f4495243837681061c4743b74b3eedf548d56a56001600160a01b03168152602090f35b50346104ce57806003193601126104ce576040517f00000000000000000000000027428dd2d3dd32a4d7f7c497eaaa23130d8949116001600160a01b03168152602090f35b50346104ce5760403660031901126104ce57610e706120806123d8565b6024359033612842565b50346104ce57806003193601126104ce5760405190806003549160018360011c926001851694851561215d575b6020958686108114612149578588528794939291879082156121275750506001146120eb575b50506110db92500383612311565b90859250600382528282205b85831061210f5750506110db935082010138806120dd565b805483890185015287945086939092019181016120f7565b92509350506110db94915060ff191682840152151560051b82010138806120dd565b634e487b7160e01b83526022600452602483fd5b93607f16936120b7565b50346104ce5760803660031901126104ce576121816122bc565b6001600160401b039060243582811161047d576121a290369060040161237a565b916044358181160361047d5760643590811161047d576121c690369060040161237a565b6001600160a01b0392337f00000000000000000000000066a71dcef29a0ffbdbe3c6a460a3b5bc225cd6758516036122aa5780516020909101516001600160601b031991828216919060148110612295575b5050905060601c300361228357600080516020612c8283398151915261224882602080879551830101910161259c565b959193169261225786856127b1565b61ffff6040519516602086015260208552612271856122f6565b611342604051928392169587836125c5565b6040516347cec4bb60e11b8152600490fd5b8391925060140360031b1b1616803880612218565b60405163a667bffb60e01b8152600490fd5b6004359061ffff8216820361139357565b6001600160401b0381116122e057604052565b634e487b7160e01b600052604160045260246000fd5b604081019081106001600160401b038211176122e057604052565b601f909101601f19168101906001600160401b038211908210176122e057604052565b9192916001600160401b0382116122e0576040519161235d601f8201601f191660200184612311565b829481845281830111611393578281602093846000960137010152565b9080601f830112156113935781602061239593359101612334565b90565b919082519283825260005b8481106123c4575050826000602080949584010152601f8019910116010190565b6020818301810151848301820152016123a3565b600435906001600160a01b038216820361139357565b602435906001600160a01b038216820361139357565b604435906001600160a01b038216820361139357565b9181601f84011215611393578235916001600160401b038311611393576020838186019501011161139357565b608435906001600160a01b038216820361139357565b35906001600160a01b038216820361139357565b6001600160401b0381116122e05760051b60200190565b9181601f84011215611393578235916001600160401b038311611393576020808501948460051b01011161139357565b6040519060006005549060018260011c906001841693841561257e575b602094858410811461256a578388528794939291811561254a5750600114612508575b505061250692500383612311565b565b90939150600560005281600020936000915b818310612532575050612506935082010138806124f8565b8554888401850152948501948794509183019161251a565b91505061250694925060ff191682840152151560051b82010138806124f8565b634e487b7160e01b85526022600452602485fd5b91607f16916124d5565b51906001600160a01b038216820361139357565b90816060910312611393576125b081612588565b9160406125bf60208401612588565b92015190565b60609061239593928152600060208201528160408201520190612398565b60609061239593928152600260208201528160408201520190612398565b60609061239593928152600160208201528160408201520190612398565b9190820391821161262c57565b634e487b7160e01b600052601160045260246000fd5b90816020910312611393575180151581036113935790565b908060209392818452848401376000828201840152601f01601f1916010190565b9190826040910312611393576020825192015190565b6040805163c23ee3c360e01b815261ffff909216600483015260006024830152604482019290925290816064817f00000000000000000000000027428dd2d3dd32a4d7f7c497eaaa23130d8949116001600160a01b03165afa908115610c81576000916126fc575090565b612715915060403d604011610c7a57610c6b8183612311565b5090565b6001600160a01b03918216815291166020820152604081019190915260600190565b9190820180921161262c57565b6001600160a01b039091168152602081019190915260400190565b929161276e82612471565b9161277c6040519384612311565b829481845260208094019160051b810192831161139357905b8282106127a25750505050565b81358152908301908301612795565b6001600160a01b03169081156127fd57600080516020612cc28339815191526020826127e160009460025461273b565b60025584845283825260408420818154019055604051908152a3565b60405162461bcd60e51b815260206004820152601f60248201527f45524332303a206d696e7420746f20746865207a65726f2061646472657373006044820152606490fd5b6001600160a01b039081169182156128f357169182156128a35760207f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925918360005260018252604060002085600052825280604060002055604051908152a3565b60405162461bcd60e51b815260206004820152602260248201527f45524332303a20617070726f766520746f20746865207a65726f206164647265604482015261737360f01b6064820152608490fd5b60405162461bcd60e51b8152602060048201526024808201527f45524332303a20617070726f76652066726f6d20746865207a65726f206164646044820152637265737360e01b6064820152608490fd5b9060018060a01b038083166000526001602052604060002090821660005260205260406000205492600019840361297c575b50505050565b8084106129975761298e930391612842565b38808080612976565b60405162461bcd60e51b815260206004820152601d60248201527f45524332303a20696e73756666696369656e7420616c6c6f77616e63650000006044820152606490fd5b6001600160a01b03908116918215612ae55716918215612a9457600082815280602052604081205491808310612a405760408282600080516020612cc2833981519152958760209652828652038282205586815220818154019055604051908152a3565b60405162461bcd60e51b815260206004820152602660248201527f45524332303a207472616e7366657220616d6f756e7420657863656564732062604482015265616c616e636560d01b6064820152608490fd5b60405162461bcd60e51b815260206004820152602360248201527f45524332303a207472616e7366657220746f20746865207a65726f206164647260448201526265737360e81b6064820152608490fd5b60405162461bcd60e51b815260206004820152602560248201527f45524332303a207472616e736665722066726f6d20746865207a65726f206164604482015264647265737360d81b6064820152608490fd5b6001600160a01b03168015612bde57600091818352826020526040832054818110612b8e5781600080516020612cc2833981519152926020928587528684520360408620558060025403600255604051908152a3565b60405162461bcd60e51b815260206004820152602260248201527f45524332303a206275726e20616d6f756e7420657863656564732062616c616e604482015261636560f01b6064820152608490fd5b60405162461bcd60e51b815260206004820152602160248201527f45524332303a206275726e2066726f6d20746865207a65726f206164647265736044820152607360f81b6064820152608490fd5b9091906000915b8151831015612c7a576020808460051b84010151916000838210600014612c6a575060005252600160406000205b920191612c34565b9060409260019483525220612c62565b915050149056fe51fa6b13f6daaeb242e226abef2a9ff882bc8f2559829aa56db5baddc7a494b4910681e1ddfdfd81641e12c78e640eb5928c78b55a791eeec551d2c3bd1581e2ddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef7bd6d4be1decdc27a9ed9c7ccdf5bb7cc38e31b3647b958c6b37162a2296c0faa2646970667358221220a658a3ab8749752191f725609be2a218b5d73c5e76f03f2cbb8d992b0fac0aa264736f6c63430008190033

d4bcbe05fe31207aef0c337f192001cecf2cacc2c113932601576e0a321e5c720000000000000000000000007a7e4ef924803b956ca97a415c86cd9f905510980000000000000000000000004f4495243837681061c4743b74b3eedf548d56a50000000000000000000000002d5d7d31f671f86c782533cc367f14109a08271200000000000000000000000066a71dcef29a0ffbdbe3c6a460a3b5bc225cd67500000000000000000000000027428dd2d3dd32a4d7f7c497eaaa23130d894911

-----Decoded View---------------
Arg [0] : _merkleRoot (bytes32): 0xd4bcbe05fe31207aef0c337f192001cecf2cacc2c113932601576e0a321e5c72
Arg [1] : _core (address): 0x7a7E4eF924803b956Ca97A415c86Cd9f90551098
Arg [2] : _gateway (address): 0x4F4495243837681061C4743b74B3eEdf548D56A5
Arg [3] : _gasService (address): 0x2d5d7d31F671F86C782533cc367F14109a082712
Arg [4] : _endpoint (address): 0x66A71Dcef29A0fFBDBE3c6a460a3B5BC225Cd675
Arg [5] : _wormholeRelayer (address): 0x27428DD2d3DD32A4D7f7C497eAaa23130d894911

-----Encoded View---------------
6 Constructor Arguments found :
Arg [0] : d4bcbe05fe31207aef0c337f192001cecf2cacc2c113932601576e0a321e5c72
Arg [1] : 0000000000000000000000007a7e4ef924803b956ca97a415c86cd9f90551098
Arg [2] : 0000000000000000000000004f4495243837681061c4743b74b3eedf548d56a5
Arg [3] : 0000000000000000000000002d5d7d31f671f86c782533cc367f14109a082712
Arg [4] : 00000000000000000000000066a71dcef29a0ffbdbe3c6a460a3b5bc225cd675
Arg [5] : 00000000000000000000000027428dd2d3dd32a4d7f7c497eaaa23130d894911