ITIP20Factory.sol

// SPDX-License-Identifier: MIT OR Apache-2.0
pragma solidity >=0.8.13 <0.9.0;

import {ITIP20} from "./ITIP20.sol";

/// @title The interface for TIP-20 token factory
/// @notice Factory contract for creating and deploying TIP-20 compliant tokens
interface ITIP20Factory {
    error AddressReserved();
    error InvalidQuoteToken();
    error TokenAlreadyExists(address tokenAddress);

    /// @notice Emitted when a new TIP-20 token is created
    /// @param token The address of the newly created token contract
    /// @param name The name of the created token
    /// @param symbol The symbol of the created token
    /// @param currency The currency identifier of the created token
    /// @param quoteToken The address of the quote token for the created token
    /// @param admin The address assigned as the admin of the new token
    /// @param salt The salt used for deterministic deployment
    event TokenCreated(
        address indexed token,
        string name,
        string symbol,
        string currency,
        ITIP20 quoteToken,
        address admin,
        bytes32 salt
    );

    /// @notice Creates a new TIP-20 compliant token
    /// @param name The name for the new token
    /// @param symbol The symbol for the new token
    /// @param currency The currency identifier for the new token
    /// @param admin The address to be assigned as the admin of the new token
    /// @return The address of the newly created token contract
    function createToken(
        string memory name,
        string memory symbol,
        string memory currency,
        ITIP20 quoteToken,
        address admin,
        bytes32 salt
    ) external returns (address);

    /// @notice Checks if a given address is a TIP-20 compliant token
    /// @param token The address of the token to check
    /// @return True if the address is a TIP-20 token, false otherwise
    function isTIP20(address token) external view returns (bool);

    /// @notice Predicts the address of a token deployment given sender and salt
    /// @dev Reverts with AddressReserved if the computed address would be in the reserved range
    /// @param sender The address that will call createToken
    /// @param salt The salt to use for deterministic deployment
    /// @return The predicted token address
    function getTokenAddress(address sender, bytes32 salt) external pure returns (address);
}