IEspressoApplicationFactory.sol

// (c) Cartesi and individual authors (see AUTHORS)
// SPDX-License-Identifier: Apache-2.0 (see LICENSE)

pragma solidity ^0.8.8;

import {IApplication} from "./IApplication.sol";
import {IOutputsMerkleRootValidator} from "../consensus/IOutputsMerkleRootValidator.sol";

/// @title Application Factory interface
interface IEspressoApplicationFactory {
    /// @notice Deploy a new application deterministically.
    /// @param outputsMerkleRootValidator The initial outputs Merkle root validator contract
    /// @param appOwner The initial application owner
    /// @param templateHash The initial machine state hash
    /// @param fromBlock Height of first Espresso block to consider
    /// @param namespaceId The Espresso namespace ID
    /// @param salt The salt used to deterministically generate the application contract address
    /// @return The application
    /// @dev On success, MUST emit an `ApplicationCreated` event.
    /// @dev Reverts if the application owner address is zero.
    function newApplication(
        IOutputsMerkleRootValidator outputsMerkleRootValidator,
        address appOwner,
        bytes32 templateHash,
        uint256 fromBlock,
        uint32 namespaceId,
        bytes32 salt
    ) external returns (IApplication);

    /// @notice Calculate the address of an application contract to be deployed deterministically.
    /// @param outputsMerkleRootValidator The initial outputs Merkle root validator contract
    /// @param appOwner The initial application owner
    /// @param templateHash The initial machine state hash
    /// @param fromBlock Height of first Espresso block to consider
    /// @param namespaceId The Espresso namespace ID
    /// @param salt The salt used to deterministically generate the application contract address
    /// @return The deterministic application contract address
    /// @dev Beware that only the `newApplication` function with the `salt` parameter
    ///      is able to deterministically deploy an application.
    function calculateApplicationAddress(
        IOutputsMerkleRootValidator outputsMerkleRootValidator,
        address appOwner,
        bytes32 templateHash,
        uint256 fromBlock,
        uint32 namespaceId,
        bytes32 salt
    ) external view returns (address);
}