Налаштування прийому ставок у Bitcoin для казино

Настройка приєму ставок у Bitcoin для казино

Bitcoin в iGaming — це не просто ще один спосіб оплати. Тут специфіка: висока частота транзакцій малого номіналу, вимога до миттєвого зачислення для ставок, волатильність BTC проти фіатного балансу казино, та жорсткі вимоги до provably fair. Стандартні on-chain транзакції з 10-хвилинним очікуванням підтвердження для ставок не працюють — потрібна Lightning Network або кастодіальна модель з внутрішніми балансами.

Архітектурні підходи: три моделі

Модель 1: Кастодіальний гаманець з внутрішніми балансами

Найпоширеніша в індустрії. Bitcoin приймається on-chain, конвертується у внутрішні кредити, ставки проходять через внутрішню систему:

BTC on-chain депозит → Внутрішній кредитний баланс → Ставки (без блокчейну) → Вивід у BTC

Плюси: миттєві ставки, немає комісій per-bet, простий rollback при помилці. Мінуси: казино зберігає ключі користувачів, custody risk, потребує довіри.

Модель 2: Lightning Network для ставок

Ставки через LN-канали — миттєво та без кастодії крупних сум. Архітектура описана нижче.

Модель 3: Гібридна (рекомендована)

Депозит/вивід — on-chain BTC (для крупних сум) + Lightning (для мілких). Ігровий баланс — кастодіальний. Баланс між UX, безпекою та операційною складністю.

On-chain інтеграція: BTCPay Server

Для production — не винаходьте велосипед з Bitcoin-нодою напряму. BTCPay Server — open-source, self-hosted, перевірене рішення:

# Docker деплой BTCPay Server
git clone https://github.com/btcpayserver/btcpayserver-docker
cd btcpayserver-docker
export BTCPAY_HOST="pay.yourcasino.com"
export NBITCOIN_NETWORK="mainnet"
export BTCPAYGEN_CRYPTO1="btc"
export BTCPAYGEN_LIGHTNING="lnd"  # Lightning вбудований
. btcpay-setup.sh -i

API для створення depozit інвойсу:

import httpx

BTCPAY_URL = "https://pay.yourcasino.com"
BTCPAY_API_KEY = "your_api_key"
STORE_ID = "your_store_id"

async def create_deposit_invoice(user_id: str, amount_usd: float) -> dict:
    async with httpx.AsyncClient() as client:
        response = await client.post(
            f"{BTCPAY_URL}/api/v1/stores/{STORE_ID}/invoices",
            headers={"Authorization": f"token {BTCPAY_API_KEY}"},
            json={
                "amount": amount_usd,
                "currency": "USD",
                "metadata": {"userId": user_id},
                "checkout": {
                    "expirationMinutes": 60,
                    "redirectURL": f"https://casino.com/deposit/success?user={user_id}"
                }
            }
        )
        invoice = response.json()
        return {
            "invoice_id": invoice["id"],
            "payment_url": invoice["checkoutLink"],
            "btc_address": invoice["addresses"]["BTC"],
            "btc_amount": invoice["cryptoInfo"][0]["due"]
        }

Webhook від BTCPay

@app.post("/btcpay/webhook")
async def btcpay_webhook(request: Request):
    body = await request.body()
    signature = request.headers.get("BTCPay-Sig")

    # Верифікація HMAC-SHA256
    expected = "sha256=" + hmac.new(
        WEBHOOK_SECRET.encode(), body, hashlib.sha256
    ).hexdigest()

    if not hmac.compare_digest(expected, signature):
        raise HTTPException(status_code=401)

    event = json.loads(body)

    if event["type"] == "InvoiceSettled":
        invoice_id = event["invoiceId"]
        invoice = await get_invoice_details(invoice_id)
        user_id = invoice["metadata"]["userId"]
        usd_amount = float(invoice["amount"])

        await credit_user_balance(user_id, usd_amount)
        await notify_user_deposit_confirmed(user_id, usd_amount)

Робота з волатильністю

BTC/USD може рухнутися на 5–10% за кілька годин. Для казино з фіатною бухгалтерією потрібна стратегія:

Опція 1: Негайна конвертація — отриманий BTC конвертується у USDT/USDC через біржевий API (Binance, Kraken) у момент підтвердження. Баланс гравця у USD, курсовий ризик мінімальний.

async def convert_btc_to_usd(btc_amount: float) -> float:
    binance = ccxt.binance({'apiKey': KEY, 'secret': SECRET})
    order = await binance.create_order(
        symbol='BTC/USDT',
        type='market',
        side='sell',
        amount=btc_amount
    )
    return float(order['cost'])  # USD отримано

Опція 2: Утримання BTC — казино приймає ризик волатильності. Виправдано лише якщо власник цілеспрямовано накопичує BTC.

Опція 3: BTC-номіналований баланс — ставки у сатоші, виплати у сатоші. Гравець несе курсовий ризик. Популярно у Bitcoin-орієнтованих казино.

Lightning Network для миттєвих платежів

Для ставок з малим номіналом (0.0001–0.01 BTC) — Lightning дозволяє миттєві ставки без on-chain комісії:

# LND gRPC клієнт для створення invoice
import grpc, codecs
from lnd_grpc_pb2 import Invoice

stub = create_lnd_stub(LND_HOST, MACAROON, TLS_CERT)

def create_lightning_invoice(amount_sats: int, memo: str) -> dict:
    invoice = Invoice(
        value=amount_sats,
        memo=memo,
        expiry=3600  # 1 година
    )
    response = stub.AddInvoice(invoice)
    return {
        "payment_hash": codecs.encode(response.r_hash, 'hex').decode(),
        "payment_request": response.payment_request  # BOLT11 invoice
    }

def check_invoice_paid(payment_hash: str) -> bool:
    lookup = stub.LookupInvoice(PaymentHash(r_hash=codecs.decode(payment_hash, 'hex')))
    return lookup.state == Invoice.SETTLED

Управління ліквідністю Lightning-каналів — окрема операційна задача: канали потрібно тримати відкритими, inbound ліквідність забезпечувати через loop-out або LSP.

Provably Fair

Чесні казино публікують алгоритм верифікації результату ставки. Стандартна схема:

import hashlib, hmac

def generate_game_result(server_seed: str, client_seed: str, nonce: int) -> float:
    """Повертає число [0, 1) для визначення результату"""
    message = f"{client_seed}-{nonce}"
    h = hmac.new(server_seed.encode(), message.encode(), hashlib.sha256).hexdigest()
    # Перші 8 символів hex → float
    return int(h[:8], 16) / 0xFFFFFFFF

# Гравець може верифікувати: сервер публікує server_seed_hash до гри,
# після гри розкриває server_seed — гравець перевіряє совпадение hash

Ліміти та AML

Основні нормативні вимоги для крипто-казино:

• Поріг ідентифікації: зазвичай 2000 EUR/сутки вимагає KYC
• Зберігати історію транзакцій мінімум 5 років
• Скринінг адрес на санкції (OFAC список) перед зачисленням
• Підозріла активність (структурування, швидкі депозит/вивід) — SAR звіт

Настройка повної BTC-інтеграції з BTCPay Server, webhook обробником, конвертацією у USD та Lightning підтримкою: 2–4 тижні включаючи тестування на testnet.