/** * 鬼影服務:上傳形態驗證 + 以 battle-core 重播反作弊驗證(04 §5、synthesis B-4/B-5)。 */ import { replay, RULE_VERSION, CARDS_HASH, type GhostRecord } from "@wcg/battle-core"; /** 有界整數檢查(擋 NaN/Infinity/非整數/超界)。 */ export function intInRange(v: unknown, lo: number, hi: number): boolean { return typeof v === "number" && Number.isInteger(v) && v >= lo && v <= hi; } /** 驗證動作序列(鬼影上傳與統計回報共用);回錯誤訊息或 null。逐型驗欄位,擋 NaN/物件混入引擎。 */ export function validateActions(value: unknown): string | null { if (!Array.isArray(value)) return "actions 必須是陣列"; if (value.length > 1500) return "actions 過長"; // 防重播 DoS(真實 11 關約數百個動作;1500 仍給長場充足餘裕,又砍掉惡意上傳最壞放大) let lastElapsedSec = 0; const validTypes = new Set(["PLAY_CARD", "END_TURN", "PICK_REWARD", "CHOOSE_CARDS", "REWARD_HEAL", "REWARD_DRAFT", "SKIP_REWARD", "SURRENDER"]); for (const a of value) { if (typeof a !== "object" || a === null) return "actions 元素必須是物件"; const aa = a as Record; if (typeof aa.type !== "string") return "actions 元素缺 type"; if (!validTypes.has(aa.type)) return "actions type 非法"; if (aa.type === "PLAY_CARD" && !intInRange(aa.handIndex, 0, 63)) return "PLAY_CARD handIndex 非法"; if ((aa.type === "PLAY_CARD" || aa.type === "END_TURN") && aa.elapsedSec !== undefined) { if (!intInRange(aa.elapsedSec, 0, 24 * 60 * 60)) return `${aa.type} elapsedSec 非法`; if ((aa.elapsedSec as number) < lastElapsedSec) return "elapsedSec 不可倒退"; lastElapsedSec = aa.elapsedSec as number; } if (aa.type === "PICK_REWARD" && !intInRange(aa.choiceIndex, 0, 9)) return "PICK_REWARD choiceIndex 非法"; if (aa.type === "CHOOSE_CARDS") { if (!Array.isArray(aa.indices) || aa.indices.length > 16 || !aa.indices.every((x) => intInRange(x, 0, 63))) return "CHOOSE_CARDS indices 非法"; } } return null; } /** 檢查上傳 body 的形態;回傳錯誤訊息或 null(通過)。全面用 Number.isInteger 擋 NaN/Infinity,並逐一驗證 actions 元素。 */ export function validateGhostShape(body: unknown): string | null { if (typeof body !== "object" || body === null) return "body 必須是物件"; const r = body as Record; if (!intInRange(r.playerMaxHp, 1, 100000)) return "playerMaxHp 超出範圍"; if (!Array.isArray(r.turns)) return "turns 必須是陣列"; if (r.turns.length > 2000) return "turns 過長"; // 防 DoS(11 關正常數十回合) for (const t of r.turns) { if (typeof t !== "object" || t === null) return "turns 元素必須是物件"; const tt = t as Record; if (!intInRange(tt.atk, -100000, 100000) || !intInRange(tt.def, -100000, 100000)) return "turns 元素需含整數 atk/def"; } if (!intInRange(r.seed, -0x80000000, 0xffffffff)) return "seed 必須是整數"; if (typeof r.ruleVersion !== "string" || r.ruleVersion.length > 32) return "缺/非法 ruleVersion"; if (typeof r.cardsHash !== "string" || r.cardsHash.length > 64) return "缺/非法 cardsHash"; if (r.meta !== undefined) { if (typeof r.meta !== "object" || r.meta === null) return "meta 必須是物件"; const hn = (r.meta as Record).heroName; // heroName 若有則必為字串、長度有界(防 DoS;實際內容由 cleanHeroName 截長/過濾)。 if (hn !== undefined && (typeof hn !== "string" || hn.length > 1000)) return "meta.heroName 非法"; } if (r.actions !== undefined) { const e = validateActions(r.actions); if (e) return e; } return null; } export interface VerifyResult { ok: boolean; reason: string; } /** * 以 seed + actions 重播,驗證 turns / playerMaxHp / 確實破關。 * 版本或卡表指紋不符 → 降級為「不校驗」(B-4,避免舊紀錄被誤判作弊)。 */ export function verifyGhost(record: GhostRecord): VerifyResult { if (record.ruleVersion !== RULE_VERSION || record.cardsHash !== CARDS_HASH) { return { ok: false, reason: "version-mismatch(降級不校驗)" }; } if (!record.actions || record.actions.length === 0) { return { ok: false, reason: "no-actions(無法重播)" }; } let final; try { // 帶職業/路線/困難模式才能忠實重播魔法師/野蠻人/Sanctus(maxLevel 省略→createGame 依 campaign 取正式關數)。 final = replay(record.seed, record.actions, { classType: record.meta?.classType ?? "WARRIOR", campaign: record.campaign ?? "slime", hardMode: record.hardMode, }); } catch (e) { return { ok: false, reason: `replay-error: ${(e as Error).message}` }; } if (final.phase !== "VICTORY") return { ok: false, reason: "未達破關(phase 非 VICTORY)" }; if (final.player.maxHp !== record.playerMaxHp) return { ok: false, reason: "playerMaxHp 不符" }; if (final.turnLog.length !== record.turns.length) return { ok: false, reason: "turns 長度不符" }; for (let i = 0; i < final.turnLog.length; i++) { const a = final.turnLog[i]!; const b = record.turns[i]!; if (a.atk !== b.atk || a.def !== b.def) return { ok: false, reason: `第 ${i + 1} 回合 atk/def 不符` }; } return { ok: true, reason: "verified" }; }