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

Настройка прийому ставок в USDT/USDC для казино

Інтеграція стейблкоїнів в гемблінг-платформу технічно відрізняється від звичайного крипто-процесінгу: потрібна швидкість підтвердження транзакції сопоставима з temporality гри, точний облік балансів без похибок floating point, обробка великого числа мікро-транзакцій, та — критично — верифікація того що прийнятий USDT/USDC є саме тим контрактом який ви очікуєте, а не фейковим токеном з тим самим ім'ям.

Вибір мережі

USDT та USDC існують на десятках мереж. Для казино важливі: швидкість фіналізації, вартість транзакції, ліквідність для конвертації.

Практична рекомендація для казино: Tron (USDT TRC-20) + BNB Chain (USDT BEP-20) покривають більшість аудиторії. Додання Ethereum для крупних гравців. USDC — Arbitrum або Base (Circle активно підтримує).

Важливо верифікувати адресу контракту при депозиті — приймати тільки з офіційних адрес:

const VERIFIED_CONTRACTS = {
  USDT_ERC20: '0xdAC17F958D2ee523a2206206994597C13D831ec7',
  USDT_TRC20: 'TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t',
  USDT_BEP20: '0x55d398326f99059fF775485246999027B3197955',
  USDC_ERC20: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48',
  USDC_ARB:   '0xaf88d065e77c8cC2239327C5EDb3A432268e5831',
};

function verifyToken(contractAddress: string, network: string): boolean {
  const key = `${tokenSymbol}_${network}`;
  return VERIFIED_CONTRACTS[key]?.toLowerCase() === contractAddress.toLowerCase();
}

Архітектура депозитів

Генерація адрес

Два підходи:

Один адрес на користувача — HD-гаманець з BIP-32 деривацією. Кожен користувач отримує унікальний deposit address,權власник платформи. Будь-який депозит на цей адрес — кредитується на рахунок. Просто в реалізації, але потребує моніторингу тисяч адрес.

import { HDNodeWallet } from 'ethers';

const masterWallet = HDNodeWallet.fromMnemonic(mnemonic);

function getDepositAddress(userId: number): string {
  // Шлях деривації: m/44'/60'/0'/0/{userId}
  const child = masterWallet.deriveChild(userId);
  return child.address;
}

Спільний адрес + memo — один гаманець для всіх, ідентифікатор у memo/tag транзакції. Простіше для EVM (просто мониторити один адрес), стандарт для Tron, XRP, Stellar. Ризик: користувач може не вказати memo.

Моніторинг вхідних переводів

Для EVM-ланцюгів — підписка на Transfer события потрібних контрактів:

const usdtContract = getContract({
  address: USDT_ERC20,
  abi: erc20Abi,
  client: publicClient,
});

// Підписка на Transfer события на наші адреси
publicClient.watchContractEvent({
  address: USDT_ERC20,
  abi: erc20Abi,
  eventName: 'Transfer',
  args: { to: ourDepositAddresses },  // фільтр по отримувачу
  onLogs: async (logs) => {
    for (const log of logs) {
      const { from, to, value } = log.args;
      const amountUSDT = Number(value) / 1e6; // USDT 6 decimals
      await creditUserBalance(getUserByAddress(to), amountUSDT);
    }
  },
});

Важливо про decimals. USDT та USDC використовують 6 decimals (не 18 як ETH). 1 USDT = 1_000_000 у raw units. Вся арифметика балансів — у integer units (уникайте float).

Підтвердження та finality

Ставку не можна прийняти поки депозит не фіналізований. Рекомендовані пороги:

Для Arbitrum: soft finality (1 підтвердження на L2) достатня для депозитів — ризик реорга практично нульовий, але 7-день challenge window для bridged коштів.

Withdrawals (виплати)

Безпека

Виплата USDT/USDC — реальне рух коштів. Критичні правила:

Розділення hot/cold wallet. На гарячому гаманці — тільки суточний обсяг виплат. Решта — в cold storage (hardware wallet або MPC custody).

Двоетапне підтвердження. Заявка на вивіз → backend validation → queue → виплата. Ніколи не відправляйте транзакцію синхронно в рамках HTTP запиту.

Rate limiting виводів. Максимум X USDT на вивід, Y USDT в суціль на користувача, Z USDT в годину для всієї платформи.

Anti-money laundering checks. Перевірка адреси через Chainalysis або TRM Labs API перед виплатою — стандарт для ліцензованих операторів.

async function processWithdrawal(
  userId: string,
  toAddress: string,
  amount: bigint,  // в smallest units
): Promise<string> {
  // Перевірка адреси на санкції/mixer активність
  const riskScore = await checkAddressRisk(toAddress);
  if (riskScore > RISK_THRESHOLD) {
    await flagForManualReview(userId, toAddress, amount);
    throw new Error('Withdrawal flagged for review');
  }
  
  // Підготовка транзакції
  const tx = await walletClient.writeContract({
    address: USDT_CONTRACT,
    abi: erc20Abi,
    functionName: 'transfer',
    args: [toAddress, amount],
  });
  
  await recordWithdrawal(userId, tx, amount);
  return tx;
}

Gas management

Для виплат USDT/USDC потрібен нативний токен мережі для газу (ETH, BNB, MATIC). Якщо користувацькі адреси не мають ETH — не можна передати USDT. Це не проблема для казино (платформа платить газ), але потребує моніторингу балансу hot wallet у нативному токені.

Облік балансів

Баланс користувача зберігається в базі даних, а не on-chain. On-chain транзакції — тільки для депозитів та виводів.

-- Таблиця транзакцій (ledger)
CREATE TABLE balance_transactions (
  id BIGSERIAL PRIMARY KEY,
  user_id BIGINT NOT NULL,
  type VARCHAR(20) NOT NULL,  -- 'deposit', 'bet', 'win', 'withdrawal'
  amount BIGINT NOT NULL,     -- у smallest units (6 decimals для USDT)
  currency VARCHAR(10) NOT NULL,
  token_network VARCHAR(20),
  tx_hash VARCHAR(66),        -- on-chain hash для deposit/withdrawal
  created_at TIMESTAMPTZ DEFAULT NOW()
);

-- Поточний баланс = сума всіх транзакцій
CREATE VIEW user_balances AS
SELECT user_id, currency,
  SUM(CASE WHEN type IN ('deposit','win') THEN amount 
           WHEN type IN ('bet','withdrawal') THEN -amount END) AS balance
FROM balance_transactions
GROUP BY user_id, currency;

Всі суми у integer (BIGINT), одиниця = найменша одиниця токена. Жодної арифметики з float.

Що входить в інтеграцію

Настройка займає 2-4 тижні: вибір та конфігурація мереж, генерація та безпечне зберігання депозитних гаманців, моніторинг вхідних Transfer подій, логіка підтверджень, кредитування балансів, черга виводів з перевірками, gas management, базовий моніторинг. Окремо — підключення до AML-провайдера та настройка лімітів.