@keep-network/tbtc-v2 1.6.0-dev.15 → 1.6.0-dev.16

package/artifacts/solcInputs/{1788e81ec23cfa014c2c13441f296723.json → 8bdb4098420884547fe701093440e1b8.json}

@@ -313,6 +313,15 @@
     "contracts/hardhat-dependency-compiler/@openzeppelin/contracts/proxy/transparent/TransparentUpgradeableProxy.sol": {
       "content": "// SPDX-License-Identifier: UNLICENSED\npragma solidity >0.0.0;\nimport '@openzeppelin/contracts/proxy/transparent/TransparentUpgradeableProxy.sol';\n"
     },
+    "contracts/integrator/AbstractTBTCDepositor.sol": {
+      "content": "// SPDX-License-Identifier: GPL-3.0-only\n\n// ██████████████     ▐████▌     ██████████████\n// ██████████████     ▐████▌     ██████████████\n//               ▐████▌    ▐████▌\n//               ▐████▌    ▐████▌\n// ██████████████     ▐████▌     ██████████████\n// ██████████████     ▐████▌     ██████████████\n//               ▐████▌    ▐████▌\n//               ▐████▌    ▐████▌\n//               ▐████▌    ▐████▌\n//               ▐████▌    ▐████▌\n//               ▐████▌    ▐████▌\n//               ▐████▌    ▐████▌\n\npragma solidity ^0.8.0;\n\nimport {BTCUtils} from \"@keep-network/bitcoin-spv-sol/contracts/BTCUtils.sol\";\n\nimport \"./IBridge.sol\";\nimport \"./ITBTCVault.sol\";\n\n/// @title Abstract AbstractTBTCDepositor contract.\n/// @notice This abstract contract is meant to facilitate integration of protocols\n///         aiming to use tBTC as an underlying Bitcoin bridge.\n///\n///         Such an integrator is supposed to:\n///         - Create a child contract inheriting from this abstract contract\n///         - Call the `__AbstractTBTCDepositor_initialize` initializer function\n///         - Use the `_initializeDeposit` and `_finalizeDeposit` as part of their\n///           business logic in order to initialize and finalize deposits.\n///\n/// @dev Example usage:\n///      ```\n///      // Example upgradeable integrator contract.\n///      contract ExampleTBTCIntegrator is AbstractTBTCDepositor, Initializable {\n///          /// @custom:oz-upgrades-unsafe-allow constructor\n///          constructor() {\n///              // Prevents the contract from being initialized again.\n///              _disableInitializers();\n///          }\n///\n///          function initialize(\n///              address _bridge,\n///              address _tbtcVault\n///          ) external initializer {\n///              __AbstractTBTCDepositor_initialize(_bridge, _tbtcVault);\n///          }\n///\n///          function startProcess(\n///              IBridgeTypes.BitcoinTxInfo calldata fundingTx,\n///              IBridgeTypes.DepositRevealInfo calldata reveal\n///          ) external {\n///              // Embed necessary context as extra data.\n///              bytes32 extraData = ...;\n///\n///              uint256 depositKey = _initializeDeposit(\n///                  fundingTx,\n///                  reveal,\n///                  extraData\n///              );\n///\n///              // Use the depositKey to track the process.\n///          }\n///\n///          function finalizeProcess(uint256 depositKey) external {\n///              (uint256 tbtcAmount, bytes32 extraData) = _finalizeDeposit(depositKey);\n///\n///              // Do something with the minted TBTC using context\n///              // embedded in the extraData.\n///          }\n///      }\nabstract contract AbstractTBTCDepositor {\n    using BTCUtils for bytes;\n\n    /// @notice Multiplier to convert satoshi to TBTC token units.\n    uint256 public constant SATOSHI_MULTIPLIER = 10**10;\n\n    /// @notice Bridge contract address.\n    IBridge public bridge;\n    /// @notice TBTCVault contract address.\n    ITBTCVault public tbtcVault;\n    /// @notice Mapping holding information about pending deposits that have\n    ///         been initialized but not finalized yet. If the deposit is not\n    ///         in this mapping it means it has already been finalized or it\n    ///         has not been initialized yet.\n    mapping(uint256 => bool) public pendingDeposits;\n\n    // Reserved storage space that allows adding more variables without affecting\n    // the storage layout of the child contracts. The convention from OpenZeppelin\n    // suggests the storage space should add up to 50 slots. If more variables are\n    // added in the upcoming versions one need to reduce the array size accordingly.\n    // See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps\n    // slither-disable-next-line unused-state\n    uint256[47] private __gap;\n\n    event DepositInitialized(uint256 indexed depositKey, uint32 initializedAt);\n\n    event DepositFinalized(\n        uint256 indexed depositKey,\n        uint256 tbtcAmount,\n        uint32 finalizedAt\n    );\n\n    /// @notice Initializes the contract. MUST BE CALLED from the child\n    ///         contract initializer.\n    // slither-disable-next-line dead-code\n    function __AbstractTBTCDepositor_initialize(\n        address _bridge,\n        address _tbtcVault\n    ) internal {\n        require(\n            address(bridge) == address(0) && address(tbtcVault) == address(0),\n            \"AbstractTBTCDepositor already initialized\"\n        );\n\n        require(_bridge != address(0), \"Bridge address cannot be zero\");\n        require(_tbtcVault != address(0), \"TBTCVault address cannot be zero\");\n\n        bridge = IBridge(_bridge);\n        tbtcVault = ITBTCVault(_tbtcVault);\n    }\n\n    /// @notice Initializes a deposit by revealing it to the Bridge.\n    /// @param fundingTx Bitcoin funding transaction data, see `IBridgeTypes.BitcoinTxInfo`.\n    /// @param reveal Deposit reveal data, see `IBridgeTypes.DepositRevealInfo` struct.\n    /// @param extraData 32-byte deposit extra data.\n    /// @return depositKey Deposit key computed as\n    ///         `keccak256(fundingTxHash | reveal.fundingOutputIndex)`. This\n    ///         key can be used to refer to the deposit in the Bridge and\n    ///         TBTCVault contracts.\n    /// @dev Requirements:\n    ///      - The revealed vault address must match the TBTCVault address,\n    ///      - All requirements from {Bridge#revealDepositWithExtraData}\n    ///        function must be met.\n    // slither-disable-next-line dead-code\n    function _initializeDeposit(\n        IBridgeTypes.BitcoinTxInfo calldata fundingTx,\n        IBridgeTypes.DepositRevealInfo calldata reveal,\n        bytes32 extraData\n    ) internal returns (uint256) {\n        require(reveal.vault == address(tbtcVault), \"Vault address mismatch\");\n\n        uint256 depositKey = _calculateDepositKey(\n            _calculateBitcoinTxHash(fundingTx),\n            reveal.fundingOutputIndex\n        );\n\n        pendingDeposits[depositKey] = true;\n\n        emit DepositInitialized(\n            depositKey,\n            /* solhint-disable-next-line not-rely-on-time */\n            uint32(block.timestamp)\n        );\n\n        // The Bridge does not allow to reveal the same deposit twice and\n        // revealed deposits stay there forever. The transaction will revert\n        // if the deposit has already been revealed so, there is no need to do\n        // an explicit check here.\n        bridge.revealDepositWithExtraData(fundingTx, reveal, extraData);\n\n        return depositKey;\n    }\n\n    /// @notice Finalizes a deposit by calculating the amount of TBTC minted\n    ///         for the deposit\n    /// @param depositKey Deposit key identifying the deposit.\n    /// @return tbtcAmount Approximate amount of TBTC minted for the deposit.\n    /// @return extraData 32-byte deposit extra data.\n    /// @dev Requirements:\n    ///      - The deposit must be initialized but not finalized\n    ///        (in the context of this contract) yet.\n    ///      - The deposit must be finalized on the Bridge side. That means the\n    ///        deposit must be either swept or optimistically minted.\n    /// @dev IMPORTANT NOTE: The tbtcAmount returned by this function is an\n    ///      approximation. See documentation of the `calculateTbtcAmount`\n    ///      responsible for calculating this value for more details.\n    // slither-disable-next-line dead-code\n    function _finalizeDeposit(uint256 depositKey)\n        internal\n        returns (uint256 tbtcAmount, bytes32 extraData)\n    {\n        require(pendingDeposits[depositKey], \"Deposit not initialized\");\n\n        IBridgeTypes.DepositRequest memory deposit = bridge.deposits(\n            depositKey\n        );\n        (, uint64 finalizedAt) = tbtcVault.optimisticMintingRequests(\n            depositKey\n        );\n\n        require(\n            deposit.sweptAt != 0 || finalizedAt != 0,\n            \"Deposit not finalized by the bridge\"\n        );\n\n        // We can safely delete the deposit from the pending deposits mapping.\n        // This deposit cannot be initialized again because the bridge does not\n        // allow to reveal the same deposit twice. Deleting the deposit from\n        // the mapping will also prevent the finalizeDeposit function from\n        // being called again for the same deposit.\n        // slither-disable-next-line reentrancy-no-eth\n        delete pendingDeposits[depositKey];\n\n        tbtcAmount = _calculateTbtcAmount(deposit.amount, deposit.treasuryFee);\n\n        // slither-disable-next-line reentrancy-events\n        emit DepositFinalized(\n            depositKey,\n            tbtcAmount,\n            /* solhint-disable-next-line not-rely-on-time */\n            uint32(block.timestamp)\n        );\n\n        extraData = deposit.extraData;\n    }\n\n    /// @notice Calculates the amount of TBTC minted for the deposit.\n    /// @param depositAmountSat Deposit amount in satoshi (1e8 precision).\n    ///        This is the actual amount deposited by the deposit creator, i.e.\n    ///        the gross amount the Bridge's fees are cut from.\n    /// @param depositTreasuryFeeSat Deposit treasury fee in satoshi (1e8 precision).\n    ///        This is an accurate value of the treasury fee that was actually\n    ///        cut upon minting.\n    /// @return tbtcAmount Approximate amount of TBTC minted for the deposit.\n    /// @dev IMPORTANT NOTE: The tbtcAmount returned by this function may\n    ///      not correspond to the actual amount of TBTC minted for the deposit.\n    ///      Although the treasury fee cut upon minting is known precisely,\n    ///      this is not the case for the optimistic minting fee and the Bitcoin\n    ///      transaction fee. To overcome that problem, this function just takes\n    ///      the current maximum allowed values of both fees, at the moment of deposit\n    ///      finalization. For the great majority of the deposits, such an\n    ///      algorithm will return a tbtcAmount slightly lesser than the\n    ///      actual amount of TBTC minted for the deposit. This will cause\n    ///      some TBTC to be left in the contract and ensure there is enough\n    ///      liquidity to finalize the deposit. However, in some rare cases,\n    ///      where the actual values of those fees change between the deposit\n    ///      minting and finalization, the tbtcAmount returned by this function\n    ///      may be greater than the actual amount of TBTC minted for the deposit.\n    ///      If this happens and the reserve coming from previous deposits\n    ///      leftovers does not provide enough liquidity, the deposit will have\n    ///      to wait for finalization until the reserve is refilled by subsequent\n    ///      deposits or a manual top-up. The integrator is responsible for\n    ///      handling such cases.\n    // slither-disable-next-line dead-code\n    function _calculateTbtcAmount(\n        uint64 depositAmountSat,\n        uint64 depositTreasuryFeeSat\n    ) internal view virtual returns (uint256) {\n        // Both deposit amount and treasury fee are in the 1e8 satoshi precision.\n        // We need to convert them to the 1e18 TBTC precision.\n        uint256 amountSubTreasury = (depositAmountSat - depositTreasuryFeeSat) *\n            SATOSHI_MULTIPLIER;\n\n        uint256 omFeeDivisor = tbtcVault.optimisticMintingFeeDivisor();\n        uint256 omFee = omFeeDivisor > 0\n            ? (amountSubTreasury / omFeeDivisor)\n            : 0;\n\n        // The deposit transaction max fee is in the 1e8 satoshi precision.\n        // We need to convert them to the 1e18 TBTC precision.\n        (, , uint64 depositTxMaxFee, ) = bridge.depositParameters();\n        uint256 txMaxFee = depositTxMaxFee * SATOSHI_MULTIPLIER;\n\n        return amountSubTreasury - omFee - txMaxFee;\n    }\n\n    /// @notice Calculates the deposit key for the given funding transaction\n    ///         hash and funding output index.\n    /// @param fundingTxHash Funding transaction hash.\n    /// @param fundingOutputIndex Funding output index.\n    /// @return depositKey Deposit key computed as\n    ///         `keccak256(fundingTxHash | reveal.fundingOutputIndex)`. This\n    ///         key can be used to refer to the deposit in the Bridge and\n    ///         TBTCVault contracts.\n    // slither-disable-next-line dead-code\n    function _calculateDepositKey(\n        bytes32 fundingTxHash,\n        uint32 fundingOutputIndex\n    ) internal pure returns (uint256) {\n        return\n            uint256(\n                keccak256(abi.encodePacked(fundingTxHash, fundingOutputIndex))\n            );\n    }\n\n    /// @notice Calculates the Bitcoin transaction hash for the given Bitcoin\n    ///         transaction data.\n    /// @param txInfo Bitcoin transaction data, see `IBridgeTypes.BitcoinTxInfo` struct.\n    /// @return txHash Bitcoin transaction hash.\n    // slither-disable-next-line dead-code\n    function _calculateBitcoinTxHash(IBridgeTypes.BitcoinTxInfo calldata txInfo)\n        internal\n        view\n        returns (bytes32)\n    {\n        return\n            abi\n                .encodePacked(\n                    txInfo.version,\n                    txInfo.inputVector,\n                    txInfo.outputVector,\n                    txInfo.locktime\n                )\n                .hash256View();\n    }\n}\n"
+    },
+    "contracts/integrator/IBridge.sol": {
+      "content": "// SPDX-License-Identifier: GPL-3.0-only\n\n// ██████████████     ▐████▌     ██████████████\n// ██████████████     ▐████▌     ██████████████\n//               ▐████▌    ▐████▌\n//               ▐████▌    ▐████▌\n// ██████████████     ▐████▌     ██████████████\n// ██████████████     ▐████▌     ██████████████\n//               ▐████▌    ▐████▌\n//               ▐████▌    ▐████▌\n//               ▐████▌    ▐████▌\n//               ▐████▌    ▐████▌\n//               ▐████▌    ▐████▌\n//               ▐████▌    ▐████▌\n\npragma solidity ^0.8.0;\n\n/// @notice Namespace which groups all types relevant to the IBridge interface.\n/// @dev This is a mirror of the real types used in the Bridge contract.\n///      This way, the `integrator` subpackage does not need to import\n///      anything from the `bridge` subpackage and explicitly depend on it.\n///      This simplifies the dependency graph for integrators.\nlibrary IBridgeTypes {\n    /// @dev See bridge/BitcoinTx.sol#Info\n    struct BitcoinTxInfo {\n        bytes4 version;\n        bytes inputVector;\n        bytes outputVector;\n        bytes4 locktime;\n    }\n\n    /// @dev See bridge/Deposit.sol#DepositRevealInfo\n    struct DepositRevealInfo {\n        uint32 fundingOutputIndex;\n        bytes8 blindingFactor;\n        bytes20 walletPubKeyHash;\n        bytes20 refundPubKeyHash;\n        bytes4 refundLocktime;\n        address vault;\n    }\n\n    /// @dev See bridge/Deposit.sol#DepositRequest\n    struct DepositRequest {\n        address depositor;\n        uint64 amount;\n        uint32 revealedAt;\n        address vault;\n        uint64 treasuryFee;\n        uint32 sweptAt;\n        bytes32 extraData;\n    }\n}\n\n/// @notice Interface of the Bridge contract.\n/// @dev See bridge/Bridge.sol\ninterface IBridge {\n    /// @dev See {Bridge#revealDepositWithExtraData}\n    function revealDepositWithExtraData(\n        IBridgeTypes.BitcoinTxInfo calldata fundingTx,\n        IBridgeTypes.DepositRevealInfo calldata reveal,\n        bytes32 extraData\n    ) external;\n\n    /// @dev See {Bridge#deposits}\n    function deposits(uint256 depositKey)\n        external\n        view\n        returns (IBridgeTypes.DepositRequest memory);\n\n    /// @dev See {Bridge#depositParameters}\n    function depositParameters()\n        external\n        view\n        returns (\n            uint64 depositDustThreshold,\n            uint64 depositTreasuryFeeDivisor,\n            uint64 depositTxMaxFee,\n            uint32 depositRevealAheadPeriod\n        );\n}\n"
+    },
+    "contracts/integrator/ITBTCVault.sol": {
+      "content": "// SPDX-License-Identifier: GPL-3.0-only\n\n// ██████████████     ▐████▌     ██████████████\n// ██████████████     ▐████▌     ██████████████\n//               ▐████▌    ▐████▌\n//               ▐████▌    ▐████▌\n// ██████████████     ▐████▌     ██████████████\n// ██████████████     ▐████▌     ██████████████\n//               ▐████▌    ▐████▌\n//               ▐████▌    ▐████▌\n//               ▐████▌    ▐████▌\n//               ▐████▌    ▐████▌\n//               ▐████▌    ▐████▌\n//               ▐████▌    ▐████▌\n\npragma solidity ^0.8.0;\n\n/// @notice Interface of the TBTCVault contract.\n/// @dev See vault/TBTCVault.sol\ninterface ITBTCVault {\n    /// @dev See {TBTCVault#optimisticMintingRequests}\n    function optimisticMintingRequests(uint256 depositKey)\n        external\n        returns (uint64 requestedAt, uint64 finalizedAt);\n\n    /// @dev See {TBTCVault#optimisticMintingFeeDivisor}\n    function optimisticMintingFeeDivisor() external view returns (uint32);\n}\n"
+    },
     "contracts/l2/L2TBTC.sol": {
       "content": "// SPDX-License-Identifier: GPL-3.0-only\n\n// ██████████████     ▐████▌     ██████████████\n// ██████████████     ▐████▌     ██████████████\n//               ▐████▌    ▐████▌\n//               ▐████▌    ▐████▌\n// ██████████████     ▐████▌     ██████████████\n// ██████████████     ▐████▌     ██████████████\n//               ▐████▌    ▐████▌\n//               ▐████▌    ▐████▌\n//               ▐████▌    ▐████▌\n//               ▐████▌    ▐████▌\n//               ▐████▌    ▐████▌\n//               ▐████▌    ▐████▌\n\npragma solidity ^0.8.17;\n\nimport \"@openzeppelin/contracts-upgradeable/token/ERC20/extensions/draft-ERC20PermitUpgradeable.sol\";\nimport \"@openzeppelin/contracts-upgradeable/token/ERC20/extensions/ERC20BurnableUpgradeable.sol\";\nimport \"@openzeppelin/contracts-upgradeable/token/ERC20/IERC20Upgradeable.sol\";\nimport \"@openzeppelin/contracts-upgradeable/token/ERC20/utils/SafeERC20Upgradeable.sol\";\nimport \"@openzeppelin/contracts-upgradeable/token/ERC721/IERC721Upgradeable.sol\";\nimport \"@openzeppelin/contracts-upgradeable/access/OwnableUpgradeable.sol\";\nimport \"@openzeppelin/contracts-upgradeable/security/PausableUpgradeable.sol\";\n\n/// @title L2TBTC\n/// @notice Canonical L2/sidechain token implementation. tBTC token is minted on\n///         L1 and locked there to be moved to L2/sidechain. By deploying\n///         a canonical token on each L2/sidechain, we can ensure the supply of\n///         tBTC remains sacrosanct, while enabling quick, interoperable\n///         cross-chain bridges and localizing ecosystem risk.\n///\n///         This contract is flexible enough to:\n///         - Delegate minting authority to a native bridge on the chain, if\n///           present.\n///         - Delegate minting authority to a short list of ecosystem bridges.\n///         - Have mints and burns paused by any one of n guardians, allowing\n///           avoidance of contagion in case of a chain- or bridge-specific\n///           incident.\n///         - Be governed and upgradeable.\n///\n///         The token is burnable by the token holder and supports EIP2612\n///         permits. Token holder can authorize a transfer of their token with\n///         a signature conforming EIP712 standard instead of an on-chain\n///         transaction from their address. Anyone can submit this signature on\n///         the user's behalf by calling the permit function, paying gas fees,\n///         and possibly performing other actions in the same transaction.\n///         The governance can recover ERC20 and ERC721 tokens sent mistakenly\n///         to L2TBTC token contract.\ncontract L2TBTC is\n    ERC20Upgradeable,\n    ERC20BurnableUpgradeable,\n    ERC20PermitUpgradeable,\n    OwnableUpgradeable,\n    PausableUpgradeable\n{\n    using SafeERC20Upgradeable for IERC20Upgradeable;\n\n    /// @notice Indicates if the given address is a minter. Only minters can\n    ///         mint the token.\n    mapping(address => bool) public isMinter;\n\n    /// @notice List of all minters.\n    address[] public minters;\n\n    /// @notice Indicates if the given address is a guardian. Only guardians can\n    ///         pause token mints and burns.\n    mapping(address => bool) public isGuardian;\n\n    /// @notice List of all guardians.\n    address[] public guardians;\n\n    event MinterAdded(address indexed minter);\n    event MinterRemoved(address indexed minter);\n\n    event GuardianAdded(address indexed guardian);\n    event GuardianRemoved(address indexed guardian);\n\n    modifier onlyMinter() {\n        require(isMinter[msg.sender], \"Caller is not a minter\");\n        _;\n    }\n\n    modifier onlyGuardian() {\n        require(isGuardian[msg.sender], \"Caller is not a guardian\");\n        _;\n    }\n\n    /// @notice Initializes the token contract.\n    /// @param _name The name of the token.\n    /// @param _symbol The symbol of the token, usually a shorter version of the\n    ///        name.\n    function initialize(string memory _name, string memory _symbol)\n        external\n        initializer\n    {\n        // OpenZeppelin upgradeable contracts documentation says:\n        //\n        // \"Use with multiple inheritance requires special care. Initializer\n        // functions are not linearized by the compiler like constructors.\n        // Because of this, each __{ContractName}_init function embeds the\n        // linearized calls to all parent initializers. As a consequence,\n        // calling two of these init functions can potentially initialize the\n        // same contract twice.\"\n        //\n        // Note that ERC20 extensions do not linearize calls to ERC20Upgradeable\n        // initializer so we call all extension initializers individually. At\n        // the same time, ERC20PermitUpgradeable does linearize the call to\n        // EIP712Upgradeable so we are not using the unchained initializer\n        // versions.\n        __ERC20_init(_name, _symbol);\n        __ERC20Burnable_init();\n        __ERC20Permit_init(_name);\n        __Ownable_init();\n        __Pausable_init();\n    }\n\n    /// @notice Adds the address to the minters list.\n    /// @dev Requirements:\n    ///      - The caller must be the contract owner.\n    ///      - `minter` must not be a minter address already.\n    /// @param minter The address to be added as a minter.\n    function addMinter(address minter) external onlyOwner {\n        require(!isMinter[minter], \"This address is already a minter\");\n        isMinter[minter] = true;\n        minters.push(minter);\n        emit MinterAdded(minter);\n    }\n\n    /// @notice Removes the address from the minters list.\n    /// @dev Requirements:\n    ///      - The caller must be the contract owner.\n    ///      - `minter` must be a minter address.\n    /// @param minter The address to be removed from the minters list.\n    function removeMinter(address minter) external onlyOwner {\n        require(isMinter[minter], \"This address is not a minter\");\n        delete isMinter[minter];\n\n        // We do not expect too many minters so a simple loop is safe.\n        for (uint256 i = 0; i < minters.length; i++) {\n            if (minters[i] == minter) {\n                minters[i] = minters[minters.length - 1];\n                // slither-disable-next-line costly-loop\n                minters.pop();\n                break;\n            }\n        }\n\n        emit MinterRemoved(minter);\n    }\n\n    /// @notice Adds the address to the guardians list.\n    /// @dev Requirements:\n    ///      - The caller must be the contract owner.\n    ///      - `guardian` must not be a guardian address already.\n    /// @param guardian The address to be added as a guardian.\n    function addGuardian(address guardian) external onlyOwner {\n        require(!isGuardian[guardian], \"This address is already a guardian\");\n        isGuardian[guardian] = true;\n        guardians.push(guardian);\n        emit GuardianAdded(guardian);\n    }\n\n    /// @notice Removes the address from the guardians list.\n    /// @dev Requirements:\n    ///      - The caller must be the contract owner.\n    ///      - `guardian` must be a guardian address.\n    /// @param guardian The address to be removed from the guardians list.\n    function removeGuardian(address guardian) external onlyOwner {\n        require(isGuardian[guardian], \"This address is not a guardian\");\n        delete isGuardian[guardian];\n\n        // We do not expect too many guardians so a simple loop is safe.\n        for (uint256 i = 0; i < guardians.length; i++) {\n            if (guardians[i] == guardian) {\n                guardians[i] = guardians[guardians.length - 1];\n                // slither-disable-next-line costly-loop\n                guardians.pop();\n                break;\n            }\n        }\n\n        emit GuardianRemoved(guardian);\n    }\n\n    /// @notice Allows the governance of the token contract to recover any ERC20\n    ///         sent mistakenly to the token contract address.\n    /// @param token The address of the token to be recovered.\n    /// @param recipient The token recipient address that will receive recovered\n    ///        tokens.\n    /// @param amount The amount to be recovered.\n    function recoverERC20(\n        IERC20Upgradeable token,\n        address recipient,\n        uint256 amount\n    ) external onlyOwner {\n        token.safeTransfer(recipient, amount);\n    }\n\n    /// @notice Allows the governance of the token contract to recover any\n    ///         ERC721 sent mistakenly to the token contract address.\n    /// @param token The address of the token to be recovered.\n    /// @param recipient The token recipient address that will receive the\n    ///        recovered token.\n    /// @param tokenId The ID of the ERC721 token to be recovered.\n    function recoverERC721(\n        IERC721Upgradeable token,\n        address recipient,\n        uint256 tokenId,\n        bytes calldata data\n    ) external onlyOwner {\n        token.safeTransferFrom(address(this), recipient, tokenId, data);\n    }\n\n    /// @notice Allows one of the guardians to pause mints and burns allowing\n    ///         avoidance of contagion in case of a chain- or bridge-specific\n    ///         incident.\n    /// @dev Requirements:\n    ///      - The caller must be a guardian.\n    ///      - The contract must not be already paused.\n    function pause() external onlyGuardian {\n        _pause();\n    }\n\n    /// @notice Allows the governance to unpause mints and burns previously\n    ///         paused by one of the guardians.\n    /// @dev Requirements:\n    ///      - The caller must be the contract owner.\n    ///      - The contract must be paused.\n    function unpause() external onlyOwner {\n        _unpause();\n    }\n\n    /// @notice Allows one of the minters to mint `amount` tokens and assign\n    ///         them to `account`, increasing the total supply. Emits\n    ///         a `Transfer` event with `from` set to the zero address.\n    /// @dev Requirements:\n    ///      - The caller must be a minter.\n    ///      - `account` must not be the zero address.\n    /// @param account The address to receive tokens.\n    /// @param amount The amount of token to be minted.\n    function mint(address account, uint256 amount)\n        external\n        whenNotPaused\n        onlyMinter\n    {\n        _mint(account, amount);\n    }\n\n    /// @notice Destroys `amount` tokens from the caller. Emits a `Transfer`\n    ///         event with `to` set to the zero address.\n    /// @dev Requirements:\n    ///      - The caller must have at least `amount` tokens.\n    /// @param amount The amount of token to be burned.\n    function burn(uint256 amount) public override whenNotPaused {\n        super.burn(amount);\n    }\n\n    /// @notice Destroys `amount` tokens from `account`, deducting from the\n    ///         caller's allowance. Emits a `Transfer` event with `to` set to\n    ///         the zero address.\n    /// @dev Requirements:\n    ///      - The che caller must have allowance for `accounts`'s tokens of at\n    ///        least `amount`.\n    ///      - `account` must not be the zero address.\n    ///      - `account` must have at least `amount` tokens.\n    /// @param account The address owning tokens to be burned.\n    /// @param amount The amount of token to be burned.\n    function burnFrom(address account, uint256 amount)\n        public\n        override\n        whenNotPaused\n    {\n        super.burnFrom(account, amount);\n    }\n\n    /// @notice Allows to fetch a list of all minters.\n    function getMinters() external view returns (address[] memory) {\n        return minters;\n    }\n\n    /// @notice Allows to fetch a list of all guardians.\n    function getGuardians() external view returns (address[] memory) {\n        return guardians;\n    }\n}\n"
     },
@@ -361,6 +370,9 @@
     "contracts/test/TestERC721.sol": {
       "content": "// SPDX-License-Identifier: GPL-3.0-only\n\npragma solidity 0.8.17;\n\nimport \"@openzeppelin/contracts/token/ERC721/ERC721.sol\";\n\ncontract TestERC721 is ERC721 {\n    string public constant NAME = \"Test ERC721 Token\";\n    string public constant SYMBOL = \"TT\";\n\n    constructor() ERC721(NAME, SYMBOL) {}\n\n    function mint(address to, uint256 tokenId) public {\n        _mint(to, tokenId);\n    }\n}\n"
     },
+    "contracts/test/TestTBTCDepositor.sol": {
+      "content": "// SPDX-License-Identifier: GPL-3.0-only\n\npragma solidity ^0.8.0;\n\nimport {BTCUtils} from \"@keep-network/bitcoin-spv-sol/contracts/BTCUtils.sol\";\n\nimport \"../integrator/AbstractTBTCDepositor.sol\";\nimport \"../integrator/IBridge.sol\";\nimport \"../integrator/ITBTCVault.sol\";\n\ncontract TestTBTCDepositor is AbstractTBTCDepositor {\n    event InitializeDepositReturned(uint256 depositKey);\n\n    event FinalizeDepositReturned(uint256 tbtcAmount, bytes32 extraData);\n\n    function initialize(address _bridge, address _tbtcVault) external {\n        __AbstractTBTCDepositor_initialize(_bridge, _tbtcVault);\n    }\n\n    function initializeDepositPublic(\n        IBridgeTypes.BitcoinTxInfo calldata fundingTx,\n        IBridgeTypes.DepositRevealInfo calldata reveal,\n        bytes32 extraData\n    ) external {\n        uint256 depositKey = _initializeDeposit(fundingTx, reveal, extraData);\n        emit InitializeDepositReturned(depositKey);\n    }\n\n    function finalizeDepositPublic(uint256 depositKey) external {\n        (uint256 tbtcAmount, bytes32 extraData) = _finalizeDeposit(depositKey);\n        emit FinalizeDepositReturned(tbtcAmount, extraData);\n    }\n\n    function calculateTbtcAmountPublic(\n        uint64 depositAmountSat,\n        uint64 depositTreasuryFeeSat\n    ) external view returns (uint256) {\n        return _calculateTbtcAmount(depositAmountSat, depositTreasuryFeeSat);\n    }\n}\n\ncontract MockBridge is IBridge {\n    using BTCUtils for bytes;\n\n    mapping(uint256 => IBridgeTypes.DepositRequest) internal _deposits;\n\n    uint64 internal _depositTxMaxFee = 1 * 1e7; // 0.1 BTC\n\n    event DepositRevealed(uint256 depositKey);\n\n    function revealDepositWithExtraData(\n        IBridgeTypes.BitcoinTxInfo calldata fundingTx,\n        IBridgeTypes.DepositRevealInfo calldata reveal,\n        bytes32 extraData\n    ) external {\n        bytes32 fundingTxHash = abi\n            .encodePacked(\n                fundingTx.version,\n                fundingTx.inputVector,\n                fundingTx.outputVector,\n                fundingTx.locktime\n            )\n            .hash256View();\n\n        uint256 depositKey = uint256(\n            keccak256(\n                abi.encodePacked(fundingTxHash, reveal.fundingOutputIndex)\n            )\n        );\n\n        require(\n            _deposits[depositKey].revealedAt == 0,\n            \"Deposit already revealed\"\n        );\n\n        IBridgeTypes.DepositRequest memory request;\n\n        request.depositor = msg.sender;\n        request.amount = uint64(10 * 1e8); // 10 BTC\n        /* solhint-disable-next-line not-rely-on-time */\n        request.revealedAt = uint32(block.timestamp);\n        request.vault = reveal.vault;\n        request.treasuryFee = uint64(1 * 1e8); // 1 BTC\n        request.sweptAt = 0;\n        request.extraData = extraData;\n\n        _deposits[depositKey] = request;\n\n        emit DepositRevealed(depositKey);\n    }\n\n    function sweepDeposit(uint256 depositKey) external {\n        require(_deposits[depositKey].revealedAt != 0, \"Deposit not revealed\");\n        require(_deposits[depositKey].sweptAt == 0, \"Deposit already swept\");\n        /* solhint-disable-next-line not-rely-on-time */\n        _deposits[depositKey].sweptAt = uint32(block.timestamp);\n    }\n\n    function deposits(uint256 depositKey)\n        external\n        view\n        returns (IBridgeTypes.DepositRequest memory)\n    {\n        return _deposits[depositKey];\n    }\n\n    function depositParameters()\n        external\n        view\n        returns (\n            uint64 depositDustThreshold,\n            uint64 depositTreasuryFeeDivisor,\n            uint64 depositTxMaxFee,\n            uint32 depositRevealAheadPeriod\n        )\n    {\n        depositDustThreshold = 0;\n        depositTreasuryFeeDivisor = 0;\n        depositTxMaxFee = _depositTxMaxFee;\n        depositRevealAheadPeriod = 0;\n    }\n\n    function setDepositTxMaxFee(uint64 value) external {\n        _depositTxMaxFee = value;\n    }\n}\n\ncontract MockTBTCVault is ITBTCVault {\n    struct Request {\n        uint64 requestedAt;\n        uint64 finalizedAt;\n    }\n\n    mapping(uint256 => Request) internal _requests;\n\n    uint32 public optimisticMintingFeeDivisor = 100; // 1%\n\n    function optimisticMintingRequests(uint256 depositKey)\n        external\n        returns (uint64 requestedAt, uint64 finalizedAt)\n    {\n        Request memory request = _requests[depositKey];\n        return (request.requestedAt, request.finalizedAt);\n    }\n\n    function createOptimisticMintingRequest(uint256 depositKey) external {\n        require(\n            _requests[depositKey].requestedAt == 0,\n            \"Request already exists\"\n        );\n        /* solhint-disable-next-line not-rely-on-time */\n        _requests[depositKey].requestedAt = uint64(block.timestamp);\n    }\n\n    function finalizeOptimisticMintingRequest(uint256 depositKey) external {\n        require(\n            _requests[depositKey].requestedAt != 0,\n            \"Request does not exist\"\n        );\n        require(\n            _requests[depositKey].finalizedAt == 0,\n            \"Request already finalized\"\n        );\n        /* solhint-disable-next-line not-rely-on-time */\n        _requests[depositKey].finalizedAt = uint64(block.timestamp);\n    }\n\n    function setOptimisticMintingFeeDivisor(uint32 value) external {\n        optimisticMintingFeeDivisor = value;\n    }\n}\n"
+    },
     "contracts/test/WormholeBridgeStub.sol": {
       "content": "// SPDX-License-Identifier: GPL-3.0-only\n\npragma solidity 0.8.17;\n\nimport \"./TestERC20.sol\";\nimport \"../l2/L2WormholeGateway.sol\";\n\n/// @dev Stub contract used in L2WormholeGateway unit tests.\n///      Stub contract is used instead of a smock because of the token transfer\n///      that needs to happen in completeTransferWithPayload function.\ncontract WormholeBridgeStub is IWormholeTokenBridge {\n    TestERC20 public wormholeToken;\n\n    uint256 public transferAmount;\n    bytes32 public receiverAddress;\n\n    // Two simple events allowing to assert Wormhole bridge functions are\n    // called.\n    event WormholeBridgeStub_completeTransferWithPayload(bytes encodedVm);\n    event WormholeBridgeStub_transferTokens(\n        address token,\n        uint256 amount,\n        uint16 recipientChain,\n        bytes32 recipient,\n        uint256 arbiterFee,\n        uint32 nonce\n    );\n    event WormholeBridgeStub_transferTokensWithPayload(\n        address token,\n        uint256 amount,\n        uint16 recipientChain,\n        bytes32 recipient,\n        uint32 nonce,\n        bytes payload\n    );\n\n    constructor(TestERC20 _wormholeToken) {\n        wormholeToken = _wormholeToken;\n    }\n\n    function completeTransferWithPayload(bytes memory encodedVm)\n        external\n        returns (bytes memory)\n    {\n        emit WormholeBridgeStub_completeTransferWithPayload(encodedVm);\n        wormholeToken.mint(msg.sender, transferAmount);\n\n        // In a real implementation, encodedVm is parsed. To avoid copy-pasting\n        // Wormhole code to this contract and then encoding parmaters in unit\n        // tests, we allow to set the receiver address on the stub contract and\n        // we return it here. The rest of the parameters does not matter.\n        IWormholeTokenBridge.TransferWithPayload memory transfer = IWormholeTokenBridge\n            .TransferWithPayload(\n                1, // payloadID\n                2, // amount\n                0x3000000000000000000000000000000000000000000000000000000000000000, // tokenAddress\n                4, // tokenChain\n                0x5000000000000000000000000000000000000000000000000000000000000000, // to\n                6, // toChain\n                0x7000000000000000000000000000000000000000000000000000000000000000, // fromAddress\n                abi.encode(receiverAddress) // payload\n            );\n\n        return abi.encode(transfer);\n    }\n\n    function transferTokens(\n        address token,\n        uint256 amount,\n        uint16 recipientChain,\n        bytes32 recipient,\n        uint256 arbiterFee,\n        uint32 nonce\n    ) external payable returns (uint64 sequence) {\n        emit WormholeBridgeStub_transferTokens(\n            token,\n            amount,\n            recipientChain,\n            recipient,\n            arbiterFee,\n            nonce\n        );\n        return 777;\n    }\n\n    function transferTokensWithPayload(\n        address token,\n        uint256 amount,\n        uint16 recipientChain,\n        bytes32 recipient,\n        uint32 nonce,\n        bytes memory payload\n    ) external payable returns (uint64 sequence) {\n        emit WormholeBridgeStub_transferTokensWithPayload(\n            token,\n            amount,\n            recipientChain,\n            recipient,\n            nonce,\n            payload\n        );\n        return 888;\n    }\n\n    function parseTransferWithPayload(bytes memory encoded)\n        external\n        pure\n        returns (IWormholeTokenBridge.TransferWithPayload memory transfer)\n    {\n        return abi.decode(encoded, (IWormholeTokenBridge.TransferWithPayload));\n    }\n\n    function setTransferAmount(uint256 _transferAmount) external {\n        transferAmount = _transferAmount;\n    }\n\n    function setReceiverAddress(bytes32 _receiverAddress) external {\n        receiverAddress = _receiverAddress;\n    }\n\n    // Allows to mint Wormhole tBTC for depositWormholeTbtc unit tests.\n    function mintWormholeToken(address to, uint256 amount) external {\n        wormholeToken.mint(to, amount);\n    }\n}\n"
     },

package/build/contracts/GovernanceUtils.sol/GovernanceUtils.dbg.json

@@ -1,4 +1,4 @@
 {
   "_format": "hh-sol-dbg-1",
-  "buildInfo": "../../build-info/b5f1e8cf3b3e0a9bb2a81d4dff3fdda7.json"
+  "buildInfo": "../../build-info/d51cc3cb76791b35eb7e8d6276e01849.json"
 }

package/build/contracts/bank/Bank.sol/Bank.dbg.json

@@ -1,4 +1,4 @@
 {
   "_format": "hh-sol-dbg-1",
-  "buildInfo": "../../../build-info/b5f1e8cf3b3e0a9bb2a81d4dff3fdda7.json"
+  "buildInfo": "../../../build-info/d51cc3cb76791b35eb7e8d6276e01849.json"
 }

package/build/contracts/bank/IReceiveBalanceApproval.sol/IReceiveBalanceApproval.dbg.json

@@ -1,4 +1,4 @@
 {
   "_format": "hh-sol-dbg-1",
-  "buildInfo": "../../../build-info/b5f1e8cf3b3e0a9bb2a81d4dff3fdda7.json"
+  "buildInfo": "../../../build-info/d51cc3cb76791b35eb7e8d6276e01849.json"
 }

package/build/contracts/bridge/BitcoinTx.sol/BitcoinTx.dbg.json

@@ -1,4 +1,4 @@
 {
   "_format": "hh-sol-dbg-1",
-  "buildInfo": "../../../build-info/b5f1e8cf3b3e0a9bb2a81d4dff3fdda7.json"
+  "buildInfo": "../../../build-info/d51cc3cb76791b35eb7e8d6276e01849.json"
 }

package/build/contracts/bridge/Bridge.sol/Bridge.dbg.json

@@ -1,4 +1,4 @@
 {
   "_format": "hh-sol-dbg-1",
-  "buildInfo": "../../../build-info/b5f1e8cf3b3e0a9bb2a81d4dff3fdda7.json"
+  "buildInfo": "../../../build-info/d51cc3cb76791b35eb7e8d6276e01849.json"
 }

package/build/contracts/bridge/BridgeGovernanceParameters.sol/BridgeGovernanceParameters.dbg.json

@@ -1,4 +1,4 @@
 {
   "_format": "hh-sol-dbg-1",
-  "buildInfo": "../../../build-info/b5f1e8cf3b3e0a9bb2a81d4dff3fdda7.json"
+  "buildInfo": "../../../build-info/d51cc3cb76791b35eb7e8d6276e01849.json"
 }

package/build/contracts/bridge/BridgeState.sol/BridgeState.dbg.json

@@ -1,4 +1,4 @@
 {
   "_format": "hh-sol-dbg-1",
-  "buildInfo": "../../../build-info/b5f1e8cf3b3e0a9bb2a81d4dff3fdda7.json"
+  "buildInfo": "../../../build-info/d51cc3cb76791b35eb7e8d6276e01849.json"
 }

package/build/contracts/bridge/Deposit.sol/Deposit.dbg.json

@@ -1,4 +1,4 @@
 {
   "_format": "hh-sol-dbg-1",
-  "buildInfo": "../../../build-info/b5f1e8cf3b3e0a9bb2a81d4dff3fdda7.json"
+  "buildInfo": "../../../build-info/d51cc3cb76791b35eb7e8d6276e01849.json"
 }

package/build/contracts/bridge/DepositSweep.sol/DepositSweep.dbg.json

@@ -1,4 +1,4 @@
 {
   "_format": "hh-sol-dbg-1",
-  "buildInfo": "../../../build-info/b5f1e8cf3b3e0a9bb2a81d4dff3fdda7.json"
+  "buildInfo": "../../../build-info/d51cc3cb76791b35eb7e8d6276e01849.json"
 }

package/build/contracts/bridge/EcdsaLib.sol/EcdsaLib.dbg.json

@@ -1,4 +1,4 @@
 {
   "_format": "hh-sol-dbg-1",
-  "buildInfo": "../../../build-info/b5f1e8cf3b3e0a9bb2a81d4dff3fdda7.json"
+  "buildInfo": "../../../build-info/d51cc3cb76791b35eb7e8d6276e01849.json"
 }

package/build/contracts/bridge/Fraud.sol/Fraud.dbg.json

@@ -1,4 +1,4 @@
 {
   "_format": "hh-sol-dbg-1",
-  "buildInfo": "../../../build-info/b5f1e8cf3b3e0a9bb2a81d4dff3fdda7.json"
+  "buildInfo": "../../../build-info/d51cc3cb76791b35eb7e8d6276e01849.json"
 }

package/build/contracts/bridge/Heartbeat.sol/Heartbeat.dbg.json

@@ -1,4 +1,4 @@
 {
   "_format": "hh-sol-dbg-1",
-  "buildInfo": "../../../build-info/b5f1e8cf3b3e0a9bb2a81d4dff3fdda7.json"
+  "buildInfo": "../../../build-info/d51cc3cb76791b35eb7e8d6276e01849.json"
 }

package/build/contracts/bridge/IRelay.sol/IRelay.dbg.json

@@ -1,4 +1,4 @@
 {
   "_format": "hh-sol-dbg-1",
-  "buildInfo": "../../../build-info/b5f1e8cf3b3e0a9bb2a81d4dff3fdda7.json"
+  "buildInfo": "../../../build-info/d51cc3cb76791b35eb7e8d6276e01849.json"
 }

package/build/contracts/bridge/MovingFunds.sol/MovingFunds.dbg.json

@@ -1,4 +1,4 @@
 {
   "_format": "hh-sol-dbg-1",
-  "buildInfo": "../../../build-info/b5f1e8cf3b3e0a9bb2a81d4dff3fdda7.json"
+  "buildInfo": "../../../build-info/d51cc3cb76791b35eb7e8d6276e01849.json"
 }

package/build/contracts/bridge/Redemption.sol/OutboundTx.dbg.json

@@ -1,4 +1,4 @@
 {
   "_format": "hh-sol-dbg-1",
-  "buildInfo": "../../../build-info/b5f1e8cf3b3e0a9bb2a81d4dff3fdda7.json"
+  "buildInfo": "../../../build-info/d51cc3cb76791b35eb7e8d6276e01849.json"
 }

package/build/contracts/bridge/Redemption.sol/Redemption.dbg.json

@@ -1,4 +1,4 @@
 {
   "_format": "hh-sol-dbg-1",
-  "buildInfo": "../../../build-info/b5f1e8cf3b3e0a9bb2a81d4dff3fdda7.json"
+  "buildInfo": "../../../build-info/d51cc3cb76791b35eb7e8d6276e01849.json"
 }

package/build/contracts/bridge/VendingMachine.sol/VendingMachine.dbg.json

@@ -1,4 +1,4 @@
 {
   "_format": "hh-sol-dbg-1",
-  "buildInfo": "../../../build-info/b5f1e8cf3b3e0a9bb2a81d4dff3fdda7.json"
+  "buildInfo": "../../../build-info/d51cc3cb76791b35eb7e8d6276e01849.json"
 }

package/build/contracts/bridge/VendingMachineV2.sol/VendingMachineV2.dbg.json

@@ -1,4 +1,4 @@
 {
   "_format": "hh-sol-dbg-1",
-  "buildInfo": "../../../build-info/b5f1e8cf3b3e0a9bb2a81d4dff3fdda7.json"
+  "buildInfo": "../../../build-info/d51cc3cb76791b35eb7e8d6276e01849.json"
 }

package/build/contracts/bridge/VendingMachineV3.sol/VendingMachineV3.dbg.json

@@ -1,4 +1,4 @@
 {
   "_format": "hh-sol-dbg-1",
-  "buildInfo": "../../../build-info/b5f1e8cf3b3e0a9bb2a81d4dff3fdda7.json"
+  "buildInfo": "../../../build-info/d51cc3cb76791b35eb7e8d6276e01849.json"
 }

package/build/contracts/bridge/WalletProposalValidator.sol/WalletProposalValidator.dbg.json

@@ -1,4 +1,4 @@
 {
   "_format": "hh-sol-dbg-1",
-  "buildInfo": "../../../build-info/b5f1e8cf3b3e0a9bb2a81d4dff3fdda7.json"
+  "buildInfo": "../../../build-info/d51cc3cb76791b35eb7e8d6276e01849.json"
 }

package/build/contracts/bridge/Wallets.sol/Wallets.dbg.json

@@ -1,4 +1,4 @@
 {
   "_format": "hh-sol-dbg-1",
-  "buildInfo": "../../../build-info/b5f1e8cf3b3e0a9bb2a81d4dff3fdda7.json"
+  "buildInfo": "../../../build-info/d51cc3cb76791b35eb7e8d6276e01849.json"
 }

package/build/contracts/integrator/AbstractTBTCDepositor.sol/AbstractTBTCDepositor.dbg.json

@@ -0,0 +1,4 @@
+{
+  "_format": "hh-sol-dbg-1",
+  "buildInfo": "../../../build-info/d51cc3cb76791b35eb7e8d6276e01849.json"
+}

package/build/contracts/integrator/AbstractTBTCDepositor.sol/AbstractTBTCDepositor.json

@@ -0,0 +1,113 @@
+{
+  "_format": "hh-sol-artifact-1",
+  "contractName": "AbstractTBTCDepositor",
+  "sourceName": "contracts/integrator/AbstractTBTCDepositor.sol",
+  "abi": [
+    {
+      "anonymous": false,
+      "inputs": [
+        {
+          "indexed": true,
+          "internalType": "uint256",
+          "name": "depositKey",
+          "type": "uint256"
+        },
+        {
+          "indexed": false,
+          "internalType": "uint256",
+          "name": "tbtcAmount",
+          "type": "uint256"
+        },
+        {
+          "indexed": false,
+          "internalType": "uint32",
+          "name": "finalizedAt",
+          "type": "uint32"
+        }
+      ],
+      "name": "DepositFinalized",
+      "type": "event"
+    },
+    {
+      "anonymous": false,
+      "inputs": [
+        {
+          "indexed": true,
+          "internalType": "uint256",
+          "name": "depositKey",
+          "type": "uint256"
+        },
+        {
+          "indexed": false,
+          "internalType": "uint32",
+          "name": "initializedAt",
+          "type": "uint32"
+        }
+      ],
+      "name": "DepositInitialized",
+      "type": "event"
+    },
+    {
+      "inputs": [],
+      "name": "SATOSHI_MULTIPLIER",
+      "outputs": [
+        {
+          "internalType": "uint256",
+          "name": "",
+          "type": "uint256"
+        }
+      ],
+      "stateMutability": "view",
+      "type": "function"
+    },
+    {
+      "inputs": [],
+      "name": "bridge",
+      "outputs": [
+        {
+          "internalType": "contract IBridge",
+          "name": "",
+          "type": "address"
+        }
+      ],
+      "stateMutability": "view",
+      "type": "function"
+    },
+    {
+      "inputs": [
+        {
+          "internalType": "uint256",
+          "name": "",
+          "type": "uint256"
+        }
+      ],
+      "name": "pendingDeposits",
+      "outputs": [
+        {
+          "internalType": "bool",
+          "name": "",
+          "type": "bool"
+        }
+      ],
+      "stateMutability": "view",
+      "type": "function"
+    },
+    {
+      "inputs": [],
+      "name": "tbtcVault",
+      "outputs": [
+        {
+          "internalType": "contract ITBTCVault",
+          "name": "",
+          "type": "address"
+        }
+      ],
+      "stateMutability": "view",
+      "type": "function"
+    }
+  ],
+  "bytecode": "0x",
+  "deployedBytecode": "0x",
+  "linkReferences": {},
+  "deployedLinkReferences": {}
+}

package/build/contracts/integrator/IBridge.sol/IBridge.dbg.json

@@ -0,0 +1,4 @@
+{
+  "_format": "hh-sol-dbg-1",
+  "buildInfo": "../../../build-info/d51cc3cb76791b35eb7e8d6276e01849.json"
+}

package/build/contracts/integrator/IBridge.sol/IBridge.json

@@ -0,0 +1,172 @@
+{
+  "_format": "hh-sol-artifact-1",
+  "contractName": "IBridge",
+  "sourceName": "contracts/integrator/IBridge.sol",
+  "abi": [
+    {
+      "inputs": [],
+      "name": "depositParameters",
+      "outputs": [
+        {
+          "internalType": "uint64",
+          "name": "depositDustThreshold",
+          "type": "uint64"
+        },
+        {
+          "internalType": "uint64",
+          "name": "depositTreasuryFeeDivisor",
+          "type": "uint64"
+        },
+        {
+          "internalType": "uint64",
+          "name": "depositTxMaxFee",
+          "type": "uint64"
+        },
+        {
+          "internalType": "uint32",
+          "name": "depositRevealAheadPeriod",
+          "type": "uint32"
+        }
+      ],
+      "stateMutability": "view",
+      "type": "function"
+    },
+    {
+      "inputs": [
+        {
+          "internalType": "uint256",
+          "name": "depositKey",
+          "type": "uint256"
+        }
+      ],
+      "name": "deposits",
+      "outputs": [
+        {
+          "components": [
+            {
+              "internalType": "address",
+              "name": "depositor",
+              "type": "address"
+            },
+            {
+              "internalType": "uint64",
+              "name": "amount",
+              "type": "uint64"
+            },
+            {
+              "internalType": "uint32",
+              "name": "revealedAt",
+              "type": "uint32"
+            },
+            {
+              "internalType": "address",
+              "name": "vault",
+              "type": "address"
+            },
+            {
+              "internalType": "uint64",
+              "name": "treasuryFee",
+              "type": "uint64"
+            },
+            {
+              "internalType": "uint32",
+              "name": "sweptAt",
+              "type": "uint32"
+            },
+            {
+              "internalType": "bytes32",
+              "name": "extraData",
+              "type": "bytes32"
+            }
+          ],
+          "internalType": "struct IBridgeTypes.DepositRequest",
+          "name": "",
+          "type": "tuple"
+        }
+      ],
+      "stateMutability": "view",
+      "type": "function"
+    },
+    {
+      "inputs": [
+        {
+          "components": [
+            {
+              "internalType": "bytes4",
+              "name": "version",
+              "type": "bytes4"
+            },
+            {
+              "internalType": "bytes",
+              "name": "inputVector",
+              "type": "bytes"
+            },
+            {
+              "internalType": "bytes",
+              "name": "outputVector",
+              "type": "bytes"
+            },
+            {
+              "internalType": "bytes4",
+              "name": "locktime",
+              "type": "bytes4"
+            }
+          ],
+          "internalType": "struct IBridgeTypes.BitcoinTxInfo",
+          "name": "fundingTx",
+          "type": "tuple"
+        },
+        {
+          "components": [
+            {
+              "internalType": "uint32",
+              "name": "fundingOutputIndex",
+              "type": "uint32"
+            },
+            {
+              "internalType": "bytes8",
+              "name": "blindingFactor",
+              "type": "bytes8"
+            },
+            {
+              "internalType": "bytes20",
+              "name": "walletPubKeyHash",
+              "type": "bytes20"
+            },
+            {
+              "internalType": "bytes20",
+              "name": "refundPubKeyHash",
+              "type": "bytes20"
+            },
+            {
+              "internalType": "bytes4",
+              "name": "refundLocktime",
+              "type": "bytes4"
+            },
+            {
+              "internalType": "address",
+              "name": "vault",
+              "type": "address"
+            }
+          ],
+          "internalType": "struct IBridgeTypes.DepositRevealInfo",
+          "name": "reveal",
+          "type": "tuple"
+        },
+        {
+          "internalType": "bytes32",
+          "name": "extraData",
+          "type": "bytes32"
+        }
+      ],
+      "name": "revealDepositWithExtraData",
+      "outputs": [],
+      "stateMutability": "nonpayable",
+      "type": "function"
+    }
+  ],
+  "bytecode": "0x",
+  "deployedBytecode": "0x",
+  "linkReferences": {},
+  "deployedLinkReferences": {}
+}

package/build/contracts/integrator/IBridge.sol/IBridgeTypes.dbg.json

@@ -0,0 +1,4 @@
+{
+  "_format": "hh-sol-dbg-1",
+  "buildInfo": "../../../build-info/d51cc3cb76791b35eb7e8d6276e01849.json"
+}

package/build/contracts/integrator/IBridge.sol/IBridgeTypes.json

@@ -0,0 +1,10 @@
+{
+  "_format": "hh-sol-artifact-1",
+  "contractName": "IBridgeTypes",
+  "sourceName": "contracts/integrator/IBridge.sol",
+  "abi": [],
+  "bytecode": "0x60566037600b82828239805160001a607314602a57634e487b7160e01b600052600060045260246000fd5b30600052607381538281f3fe73000000000000000000000000000000000000000030146080604052600080fdfea26469706673582212200450dfe4da4d6283feff622803b649709e272778add3b40416c8c18864e15bf464736f6c63430008110033",
+  "deployedBytecode": "0x73000000000000000000000000000000000000000030146080604052600080fdfea26469706673582212200450dfe4da4d6283feff622803b649709e272778add3b40416c8c18864e15bf464736f6c63430008110033",
+  "linkReferences": {},
+  "deployedLinkReferences": {}
+}

package/build/contracts/integrator/ITBTCVault.sol/ITBTCVault.dbg.json

@@ -0,0 +1,4 @@
+{
+  "_format": "hh-sol-dbg-1",
+  "buildInfo": "../../../build-info/d51cc3cb76791b35eb7e8d6276e01849.json"
+}