TrustDice 老虎机源码深度解析
Slots游戏开发完全指南

// TrustDice Slots 核心架构示意
interface SlotGameEngine {
  /** 表现层 — 卷轴动画 & 用户交互 */
  renderer:    WebGLReelRenderer;
  soundEngine: AudioContext;
  ui:          SlotUIController;

  /** 业务逻辑层 — 游戏规则 & 赔率 */
  gameLogic:   SlotGameLogic;
  paytable:    PaytableConfig;
  lineEngine:  WinLineCalculator;

  /** 随机数层 — 可验证公平 */
  rng:         ProvablyFairRNG;

  /** 区块链结算层 */
  contract:    SlotSmartContract;
  wallet:      Web3WalletAdapter;
}

// 单次旋转完整生命周期
async function spinLifecycle(
  engine: SlotGameEngine,
  betAmount: number
): Promise<SpinResult> {
  const seed   = await engine.rng.generateSeed();
  const reels  = engine.gameLogic.computeReels(seed);
  const wins   = engine.lineEngine.evaluate(reels);
  const txHash = await engine.contract.settle(wins, betAmount);
  engine.renderer.playAnimation(reels, wins);
  return { reels, wins, txHash, seed };
}

class ReelStrip {
  constructor(symbols, visibleRows = 3) {
    this.strip  = symbols;    // 符号条带（通常 30-50个）
    this.rows   = visibleRows;
    this.offset = 0;           // 当前停止位置
  }

  spin(targetIndex, duration) {
    // 计算停止位 + 旋转圈数（保证足够动画帧）
    const fullRotations = 3;
    const totalDistance =
      fullRotations * this.strip.length + targetIndex;

    return gsap.to(this, {
      offset: totalDistance,
      duration,
      ease: 'power2.inOut',
      onUpdate: () => this.render()
    });
  }

  getVisibleSymbols() {
    return Array.from({ length: this.rows }, (_, i) =>
      this.strip[(this.offset + i) % this.strip.length]
    );
  }
}

const crypto = require('crypto');

/**
 * TrustDice Slots — Provably Fair RNG
 * 生成 0~1 之间的可验证随机浮点数序列
 */
function generateProvablyFairResult({
  serverSeed,
  clientSeed,
  nonce,
  numReels = 5
}) {
  const message = `${clientSeed}:${nonce}`;
  const hmac = crypto
    .createHmac('sha256', serverSeed)
    .update(message)
    .digest('hex');

  // 每 8 个十六进制字符 → 一个卷轴随机值
  const results = [];
  for (let i = 0; i < numReels; i++) {
    const chunk = hmac.slice(i * 8, (i + 1) * 8);
    const val   = parseInt(chunk, 16) / 0xFFFFFFFF;
    results.push(val);   // 0 ≤ val < 1
  }
  return results;
}

// 将随机值映射到卷轴停止位置
function mapToReelStop(randomVal, stripLength) {
  return Math.floor(randomVal * stripLength);
}

// TrustDice Slots — EOS 合约核心逻辑
class [[eosio::contract("trustdice.sl")]]
slots : public eosio::contract {
public:
  [[eosio::action]]
  void spin(
    eosio::name     player,
    eosio::asset    bet,
    std::string     clientSeed
  ) {
    require_auth(player);
    check(bet.amount >= MIN_BET, "投注额过小");

    // 生成链上随机数种子（tapos + 区块哈希）
    auto seed = computeSeed(clientSeed,
      eosio::tapos_block_num(),
      eosio::tapos_block_prefix());

    auto reels  = mapToReels(seed);
    auto payout = calcPayout(reels, bet);

    if (payout.amount > 0) {
      // 自动转账赔付，无需人工干预
      eosio::action(
        eosio::permission_level{get_self(), "active"_n},
        "eosio.token"_n, "transfer"_n,
        std::make_tuple(get_self(), player,
                          payout, "恭喜获奖!")
      ).send();
    }

    // 发送链上事件供前端监听
    emit_spin_result(player, reels, payout, seed);
  }
};