Архітектура блокчейн-рулетки
Забезпечити непередбачуваність результату в on-chain рулетці — нетривіально. Наївні реалізації використовують block.prevrandao або хеші блоків, але це відкриває шлях для MEV-атак: валідатор може переупорядкувати транзакції, щоб вплинути на результат. Ми розробляємо смарт-контракти з перевіреною випадковістю — або через Chainlink VRF, або за commit-reveal схемою. Перший дорожчий, але повністю децентралізований; другий швидший, але вимагає довіри до сервера. Нижче — повна архітектура з кодом, вибором мережі та анімацією.
За 5+ років розробки рулеток на блокчейні ми запустили понад 20 проектів: від казуальних ігор до великих DeFi gaming платформ. Досвід з різними L1/L2 дозволяє обрати оптимальний стек під бюджет та аудиторію.
Як забезпечити чесну випадковість?
Не можна використовувати block.timestamp, block.prevrandao, або хеші блоків як джерело випадковості. Miner/validator може впливати на ці значення — це називається miner extractable value (MEV) атака на randomness. Для рулетки це означає, що нода може вибирати, включати чи ні транзакцію залежно від того, виграшний чи блок.
Chainlink VRF v2.5
Cryptographically secure, verifiable random numbers від децентралізованого оракула. Chainlink VRF гарантує, що ні казино, ні гравець не можуть вплинути на результат, а доказ верифікується в контракті.
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;
import { VRFConsumerBaseV2Plus } from "@chainlink/contracts/src/v0.8/vrf/dev/VRFConsumerBaseV2Plus.sol";
import { VRFV2PlusClient } from "@chainlink/contracts/src/v0.8/vrf/dev/libraries/VRFV2PlusClient.sol";
contract RouletteGame is VRFConsumerBaseV2Plus {
uint256 public subscriptionId;
bytes32 public keyHash; // залежить від мережі
enum BetType { Number, Red, Black, Even, Odd, Low, High }
struct Bet {
address player;
BetType betType;
uint8 number; // для Number ставки (0-36)
uint256 amount;
bool settled;
}
struct Round {
uint256 requestId;
uint8 result; // 0-36
bool fulfilled;
mapping(uint256 => Bet) bets;
uint256 betCount;
}
mapping(uint256 => Round) public rounds; // requestId → Round
mapping(uint256 => uint256) public requestToRound;
uint256 public currentRoundId;
uint256 public constant MAX_BET = 1 ether;
uint256 public constant HOUSE_EDGE = 270; // 2.7% (європейська рулетка)
event BetPlaced(uint256 roundId, address player, BetType betType, uint8 number, uint256 amount);
event RoundStarted(uint256 roundId, uint256 requestId);
event RoundSettled(uint256 roundId, uint8 result);
event WinningPaid(address player, uint256 amount);
constructor(
address vrfCoordinator,
uint256 _subscriptionId,
bytes32 _keyHash
) VRFConsumerBaseV2Plus(vrfCoordinator) {
subscriptionId = _subscriptionId;
keyHash = _keyHash;
currentRoundId = 1;
}
function placeBet(
BetType betType,
uint8 number
) external payable {
require(msg.value > 0 && msg.value <= MAX_BET, "Invalid bet amount");
if (betType == BetType.Number) {
require(number <= 36, "Invalid number");
}
Round storage round = rounds[currentRoundId];
uint256 betId = round.betCount++;
round.bets[betId] = Bet({
player: msg.sender,
betType: betType,
number: number,
amount: msg.value,
settled: false
});
emit BetPlaced(currentRoundId, msg.sender, betType, number, msg.value);
}
// Закрити раунд і запросити випадковість
function spinWheel() external returns (uint256 requestId) {
requestId = s_vrfCoordinator.requestRandomWords(
VRFV2PlusClient.RandomWordsRequest({
keyHash: keyHash,
subId: subscriptionId,
requestConfirmations: 3,
callbackGasLimit: 300_000,
numWords: 1,
extraArgs: VRFV2PlusClient._argsToBytes(
VRFV2PlusClient.ExtraArgsV1({ nativePayment: false })
)
})
);
requestToRound[requestId] = currentRoundId;
rounds[currentRoundId].requestId = requestId;
currentRoundId++;
emit RoundStarted(currentRoundId - 1, requestId);
}
// Callback від Chainlink VRF
function fulfillRandomWords(
uint256 requestId,
uint256[] calldata randomWords
) internal override {
uint256 roundId = requestToRound[requestId];
Round storage round = rounds[roundId];
// 0-36 включно = 37 значень
uint8 result = uint8(randomWords[0] % 37);
round.result = result;
round.fulfilled = true;
emit RoundSettled(roundId, result);
_settleAllBets(roundId);
}
function _settleAllBets(uint256 roundId) internal {
Round storage round = rounds[roundId];
uint8 result = round.result;
for (uint256 i = 0; i < round.betCount; i++) {
Bet storage bet = round.bets[i];
if (bet.settled) continue;
bet.settled = true;
uint256 payout = _calculatePayout(bet, result);
if (payout > 0) {
payable(bet.player).transfer(payout);
emit WinningPaid(bet.player, payout);
}
}
}
function _calculatePayout(
Bet memory bet,
uint8 result
) internal pure returns (uint256) {
bool win = false;
uint256 multiplier = 0;
if (bet.betType == BetType.Number) {
win = (bet.number == result);
multiplier = 35; // 35:1
} else if (bet.betType == BetType.Red) {
win = _isRed(result);
multiplier = 1; // 1:1
} else if (bet.betType == BetType.Black) {
win = (!_isRed(result) && result != 0);
multiplier = 1;
} else if (bet.betType == BetType.Even) {
win = (result != 0 && result % 2 == 0);
multiplier = 1;
} else if (bet.betType == BetType.Odd) {
win = (result % 2 == 1);
multiplier = 1;
} else if (bet.betType == BetType.Low) {
win = (result >= 1 && result <= 18);
multiplier = 1;
} else if (bet.betType == BetType.High) {
win = (result >= 19 && result <= 36);
multiplier = 1;
}
if (!win) return 0;
return bet.amount + (bet.amount * multiplier); // stake + profit
}
// Червоні числа європейської рулетки
function _isRed(uint8 n) internal pure returns (bool) {
uint256 redNumbers = 0x3A4A5251412C2B1A191009080706;
return (redNumbers >> n) & 1 == 1;
}
// Поповнення пулу призів
receive() external payable {}
// Emergency: виведення призового пулу (timelock + multisig в production)
function withdrawHouseBalance(uint256 amount) external onlyOwner {
payable(owner()).transfer(amount);
}
}
Чому варто обрати Chainlink VRF?
Chainlink VRF надає доказ випадковості, який можна перевірити в контракті. Це означає, що гравець може самостійно переконатися в чесності раунду. Альтернативні рішення, такі як commit-reveal з серверним seed, не надають ончейн-верифікації, але значно дешевші. Для low-stake ігор або тестнетів їх можна розглядати.
Комісія та ліквідність
Казино повинно мати достатній резерв для виплати великих виграшів. Поширені підходи:
Fixed house reserve — контракт тримає фіксований резерв, максимальна ставка обмежена відсотком від резерву.
Liquidity pool модель — LP провайдери депонують ETH, отримують частку house edge як дохідність. Гравці грають проти пулу. Смарт-контракт на зразок Liquidity.lp token. Ця модель популярна у великих блокчейн-гемблінг проектах.
Фронтенд та анімація
Сама рулетка — DOM canvas (React + Pixi.js або Three.js). Ключові моменти:
- Анімація колеса запускається при виклику spinWheel(), ще до отримання результату від VRF
- Реальний результат приходить через ~30–60 секунд (час VRF callback)
- Колесо "випадково обертається" кілька повних обертів, потім плавно гальмує на потрібному секторі
- Event RoundSettled від контракту — тригер для фінальної позиції колеса
// Підписка на подію результату
const unwatch = publicClient.watchContractEvent({
address: ROULETTE_ADDRESS,
abi: rouletteAbi,
eventName: "RoundSettled",
args: { roundId: currentRoundId },
onLogs: (logs) => {
const result = logs[0].args.result;
rouletteWheel.stopAt(result); // анімація фінального положення
showResult(result);
checkWinnings(result);
},
});
Мережі та вартість
Основний параметр вибору мережі — вартість VRF callback. На Ethereum mainnet це дорого. Використання L2 мереж знижує витрати на VRF у 10-20 разів. Рекомендовані мережі:
| Мережа | VRF вартість | Час відповіді | Рекомендація |
|---|---|---|---|
| Arbitrum | ~$0.30–0.80 | ~30–60 сек | Оптимально |
| Polygon | ~$0.01–0.05 | ~30–60 сек | Бюджетний варіант |
| Avalanche | ~$0.10–0.30 | ~30–60 сек | Добре |
| Base | ~$0.05–0.20 | ~30–60 сек | Зростаюча аудиторія |
Для high-frequency обертань (кілька за хвилину) — розглядаємо alternative VRF: Pyth Entropy (значно дешевше Chainlink), або commit-reveal з server seed (менш decentralized, але миттєво).
Процес розробки під ключ
Ми працюємо за чітким планом:
- Аналітика та проектування — фіксуємо правила гри, види ставок, house edge, механіку виплат.
- Розробка смарт-контракту — пишемо контракт на Solidity 0.8.x з підтримкою VRF, multiple bet types, payout math.
- Тестування та аудит — unit тести (Foundry), fuzzing (Echidna), статичний аналіз (Slither, Mythril). Сертифіковані Solidity-розробники проводять рев'ю коду.
- Фронтенд інтеграція — React + wagmi + RainbowKit, анімація колеса на Pixi.js/Three.js, підписка на події контракту.
- Деплой та запуск — розгортання в обраній мережі, налаштування Chainlink VRF subscription, фінальний smoke test.
Що входить в роботу
| Компонент | Опис |
|---|---|
| Смарт-контракт | Solidity, ERC-20/ETH, VRF, всі ставки |
| Анімація колеса | React + Pixi.js, синхронізація з подією контракту |
| Бекенд (опціонально) | Event sourcing, лідерборд, адмінка |
| Документація | API контракту, інструкція по запуску |
| Підтримка | 2 тижні після запуску, навчання команди |
Строки та вартість
Строки розробки — від 4 до 8 тижнів залежно від складності. Точна вартість розраховується індивідуально після аналізу ваших вимог. Готові обговорити проект? Зв'яжіться з нами для попередньої оцінки. Замовте розробку рулетки під ключ — отримайте готовий продукт з гарантією якості.