Настройка приема ставок в 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) достаточна для депозитов — риск реорга практически нулевой, but 7-day challenge window для bridged funds.

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 activity
  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. Это не проблема для казино (platform платит газ), но нужен мониторинг баланса 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;

Никакой арифметики с float — все суммы в integer (BIGINT), единица = наименьшая единица токена.

Что входит в интеграцию

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