Upfront Payment Contracts

1. MersoUP Contract (Per Game)

Purpose: Core Upfront Payment logic and payment management for each game

Key State Variables:

contract MersoUP is ReentrancyGuard {
    MersoTokenPool public immutable MERSO_TOKEN_POOL;
    
    address[] public allowedCollections;
    mapping(address => address) public wrappedCollection;
    mapping(address => mapping(address => bool)) public originalCollectionToken;
    mapping(address => mapping(uint256 => uint256)) public tokenLastPayment;
    mapping(address => mapping(uint256 => address)) public tokenUser;
    mapping(address => mapping(uint256 => uint256)) public tokenPaymentNumber;
    mapping(address => mapping(uint256 => uint256)) public tokenSplitPayment;
}

Key Functions:

// Add new NFT collection to the protocol
function addNewAllowedCollection(
    address originalCollection,
    string memory wCollectionName,
    string memory wCollectionSymbol,
    address gameToken
) external onlyOwner;

// Purchase NFT
function buyTokenFrom(
    address originalCollection,
    uint256 tokenId,
    uint256 tokenPrice,
    address tokenAddress
) external onlyAllowedCollection(originalCollection) nonReentrant;

// Process weekly payment (called by owner)
function payUserNFTPortion(
    address collection,
    uint256 tokenId
) external onlyOwner onlyRegisteredToken(collection, tokenId) nonReentrant;

Payment Flow Logic:

function buyTokenFrom(address originalCollection, uint256 tokenId, uint256 tokenPrice) external {
    _transferTokensToPool(msg.sender, gameTokenAddress, tokenPrice);
    
    // 2. Protocol pays 97.5% to game company
    uint256 amountToGame = (tokenPrice * 25) / 1000;
    _buyTokenFromOriginalCollection(originalCollection, tokenId, tokenPrice);
    
    // 3. Track loan details
    tokenLastPayment[originalCollection][tokenId] = block.timestamp;
    tokenUser[originalCollection][tokenId] = msg.sender;
    tokenPaymentNumber[originalCollection][tokenId] = 0;
    tokenSplitPayment[originalCollection][tokenId] = amountToTransfer / 4;
    
    // 4. Mint NFT to user
    originalCollection.mint(msg.sender, tokenId);
}

2. MersoTokenPool Contract (Per Game)

Purpose: Manages liquidity and payment tokens for each blockchain

Key State Variables:

contract MersoTokenPool is Ownable {
    mapping(address => bool) public allowedTokens;
    mapping(address => uint256) public tokenLiquidity;
}

Key Functions:

// Token management
function addAllowedToken(address token) external onlyOwner;
function removeAllowedToken(address token) external onlyOwner;

// Liquidity management
function transferTokensToPool(address token, uint256 amount) external onlyAllowedToken(token);
function withdrawToken(address token, uint256 amount) external onlyOwner;

// Token validation
function isAllowedToken(address token) external view returns (bool);
function getTokenLiquidity(address token) external view returns (uint256);

Liquidity Management:

function transferTokensToPool(address token, uint256 amount) external onlyAllowedToken(token) {
    tokenLiquidity[token] += amount;
    bool success = IERC20(token).transferFrom(msg.sender, address(this), amount);
    if (!success) {
        revert TokenPool__TransferFromFailed();
    }
}