Kiến trúc hợp đồng
Công bằng có thể kiểm chứng

createSession(SessionConfig)

Đối tác tạo một trò chơi mua chung. Khóa toàn bộ khoản ký quỹ (giá vé × số lượng) và đồng thời gửi một cam kết băm — cả hai được ràng buộc nguyên tử và không thể tách rời.

function createSession(SessionConfig memory partialConfig) returns (address)  {
    if (partialConfig.sessionCommitment == bytes32(0)) revert MissingCommitment();
    uint16 totalFee = partialConfig.partnerShareBps + platformFeeBps;
    if (totalFee > BPS_DENOMINATOR) revert FeeTooHigh(totalFee);

    uint256 requiredDeposit = partialConfig.ticketPrice * partialConfig.totalTickets;
    uint256 currentBalance = treasury.balances(msg.sender);
    if (currentBalance < requiredDeposit) {
        revert InsufficientDeposit(currentBalance, requiredDeposit);
    }

    partialConfig.admin = admin;
    partialConfig.creator = msg.sender;
    partialConfig.treasury = payable(address(treasury));
    partialConfig.platformFeeBps = platformFeeBps;
    partialConfig.creatorAbsentPartnerDepositSlashBps = creatorAbsentPartnerDepositSlashBps;

    CommitRevealSession session = new CommitRevealSession(partialConfig);

    treasury.registerSession(address(session), msg.sender);
    treasury.lockPartnerDeposit(address(session), msg.sender, requiredDeposit);

    emit SessionCreated(msg.sender, address(session), partialConfig);

    return address(session);
}

playerBuyAndCommitTicket()

Người chơi tham gia trò chơi. Một hành động nguyên tử duy nhất sẽ đồng thời gửi tiền vé và số ngẫu nhiên cá nhân. Không cần bước Reveal thứ hai, loại bỏ hoàn toàn cửa sổ tấn công hậu thủ.

function playerBuyAndCommitTicket(uint256 quantity, bytes32 secret, bool useBalance) external payable {
    uint256 endTimestamp = unlockTimestamp + commitDurationSeconds;
    if (block.timestamp < unlockTimestamp) {
        revert TimeConstraintError(block.timestamp, unlockTimestamp);
    }
    if (block.timestamp > endTimestamp) {
        revert TimeConstraintError(block.timestamp, endTimestamp);
    }
    if (quantity == 0) revert InvalidZeroInput();
    if (nextTicketIndex + quantity > totalTickets) revert SoldOut(nextTicketIndex, quantity);

    uint256 cost = ticketPrice * quantity;
    
    if (useBalance) {
        uint256 treasuryBalance = treasury.balances(msg.sender);
        if (treasuryBalance < cost) revert IncorrectETHAmount(cost, treasuryBalance);
        treasury.playerPayTicketUseBalance(msg.sender, cost);
    } else {
        if (msg.value != cost) revert IncorrectETHAmount(cost, msg.value);
        treasury.playerPayTicket{value: msg.value}(msg.sender);
    }

    for (uint256 i = 0; i < quantity; i++) {
        ticketToPlayer[nextTicketIndex + i] = msg.sender;
    }
    nextTicketIndex += quantity;
    ticketCounts[msg.sender] += quantity;

    playerCommitment ^= secret ^ blockhash(block.number - 1);

    emit TicketsPurchased(msg.sender, quantity, nextTicketIndex);
}

reveal()

Đối tác reveal seed gốc, kích hoạt việc trộn số ngẫu nhiên và quyết toán cuối cùng. Nếu không reveal trong thời hạn, bất kỳ ai cũng có thể gọi hàm phạt để cắt khoản ký quỹ.

function reveal(bytes calldata revealData, bytes32 salt) external onlyCreator {
    bytes32 calculatedResult = keccak256(abi.encodePacked(revealData, salt));
    if (calculatedResult != sessionCommitment) revert InvalidReveal(sessionCommitment, calculatedResult);

    _settle(SettlementType.Normal);

    bytes32 combinedResult = keccak256(abi.encodePacked(revealData, playerCommitment));
    uint256 winnerIndex = uint256(combinedResult) % totalTickets;

    uint256 totalAmount = ticketPrice * totalTickets;
    uint256 partnerShare = (totalAmount * partnerShareBps) / BPS_DENOMINATOR;
    uint256 platformFee = (totalAmount * platformFeeBps) / BPS_DENOMINATOR;
    uint256 rewardAmount = totalAmount - partnerShare - platformFee;

    address[] memory users = new address[](3);
    users[0] = creator;
    users[1] = admin;
    users[2] = ticketToPlayer[winnerIndex];
    uint256[] memory amounts = new uint256[](3);
    amounts[0] = partnerShare;
    amounts[1] = platformFee;
    amounts[2] = rewardAmount;

    treasury.distributeFundsBatch(users, amounts);

    treasury.unlockPartnerDeposit(ticketPrice * totalTickets);

    emit WinnerSelected(ticketToPlayer[winnerIndex], winnerIndex);
    emit SessionSettled(SettlementType.Normal);
}