Skip to content
CARDZDocumentation
How it worksFairnessSearch documentation…
CARDZ documentation cover

About Cardz.game

RNG 與可驗證公平性

Copy page

本頁先說明開包的 RNG 計算方式,下方提供升級與合成的逐步驗證教學。

要核對升級結果? 請直接查看升級與合成:逐步驗證教學。在 JACKZ.AI 選擇 Success / fail: Card Upgrade, Enhancement。

開包:RNG 計算方式

1. 介紹

Cardz.game 的結算引擎使用基於 SHA-256 密碼雜湊函式的決定性隨機數生成 (RNG) 演算法。這可確保任何機率事件(開包)的結果僅由事先提交的輸入導出,使結果不可更改且可驗證。

本文件定義將原始熵轉換為資產選取所使用的數學運算。

2. 輸入參數

生成器需要三個不同的輸入(種子)以最大化熵並確保使用者參與。

參數 類型 位元長度 說明
伺服器種子 (Ss) 字串(16 進位) 256 位元 由平台產生的密碼學安全隨機位元組。
用戶種子 (Sc) 字串 可變 使用者提供的熵。預設為瀏覽器產生的 32 字元字串,但可由使用者自訂。
計數器 (N) 整數(u64) 64 位元 與該種子對關聯的單調遞增計數器。每次執行遞增 (N+1)。

3. 雜湊程序

原始熵透過串接與雜湊產生。

3.1. 串接

輸入以嚴格的 UTF-8 字串方式串接:

明文

Raw = ServerSeed + ClientSeed + Nonce

3.2. 摘要產生

串接後的字串經由 SHA-256 演算法處理以產生十六進位摘要 (H):

明文

H = SHA256(Raw)

結果是一個 64 個字元的十六進位字串,代表 256 位元的熵。

範例 H: b56a4208e9104033...

4. 結果決定(正規化)

為將十六進位雜湊 (H) 轉為可用的遊戲結果,我們採用均勻浮點轉換方法。此方法將雜湊映射到介於 0 與 1 之間的浮點數。

4.1. 切片與整數轉換

我們取生成雜湊 (H) 的前 8 個字元(32 位元)。該子字串從 16 進位(hex)轉換為 10 進位(十進制)。

明文

I = HexToDecimal(H.substring(0, 8))
  • I 的理論範圍: 0 到 4,294,967,295 (16^8 - 1)

4.2. 浮點正規化

整數 I 被除以最大可能的 32 位元值以產生正規化的浮點數 (U)。

明文

U = I / 4,294,967,296

這會產生一個均勻分佈的浮點數,其 0 <= U < 1.

5. 資產選取(累積分佈函數映射)

浮點數 U 會與該包的掉落表的累積分佈函數(CDF)比較。

範例掉落表:

  • 資產 A(普通):50%(0.50)
  • 資產 B(稀有):30%(0.30)
  • 資產 C(超稀有 SSR):20%(0.20)

映射邏輯:

系統會遍歷累積權重。若 U 小於累積閾值,該資產即被選取。

  1. 閾值 1: 0.50 (資產 A) -> 是否 U < 0.50?
  2. 閾值 2: 0.80 (0.50 + 0.30) -> 是否 U < 0.80?
  3. 閾值 3: 1.00 (0.80 + 0.20) -> 是否 U < 1.00?

注意:對於 5 張卡包,該過程會重複 5 次。通常會遞增 Nonce 以從單一種子產生 5 個不同的數值。

6. 參考實作(TypeScript)

下列程式片段複製生產邏輯以供驗證之用。

TypeScript

import { createHash } from 'crypto';

/**
 * Generates a normalized float from seeds.
 * @param serverSeed - The unhashed server seed.
 * @param clientSeed - The user's client seed.
 * @param nonce - The current transaction count.
 * @returns A float between 0 and 1.
 */
function generateResult(serverSeed: string, clientSeed: string, nonce: number): number {
  // 1. Construct the Raw String
  const rawString = `${serverSeed}${clientSeed}${nonce}`;

  // 2. Generate SHA-256 Hash (Hex Output)
  const hash = createHash('sha256').update(rawString).digest('hex');

  // 3. Slice first 8 characters (32 bits)
  const hexSlice = hash.substring(0, 8);

  // 4. Convert to Decimal Integer
  const decimalValue = parseInt(hexSlice, 16);

  // 5. Normalize to Float [0, 1)
  // Divisor is 16^8 (4,294,967,296)
  const result = decimalValue / 4294967296;

  return result;
}

// Example Usage
const outcome = generateResult("a1b2c3d4...", "user-seed-123", 1);
console.log(`RNG Result: ${outcome}`); // e.g., 0.4812...

7. 邊界情況處理

7.1. 精度限制

系統使用標準 IEEE 754 雙精度浮點運算。除數 2^32 確保結果解析度足以支援低至 0.000000023%.

7.2. 避免模數偏差

我們嚴格避免對原始雜湊使用模(%)運算來決定結果,因為當鍵空間無法被結果數量整除時,模運算可能會引入些微的統計偏差。浮點正規化方法(I / 2^32)在統計上是中性且無偏的。

升級與合成:逐步驗證教學

升級使用 HMAC-SHA256。核對升級或合成時,請依照以下步驟;上方開包使用的串接公式屬於不同流程。

從 CARDZ.GAME 的升級紀錄複製資料,到 JACKZ.AI 自行重算及核對結果。本教學逐欄說明,無須懂程式。

本篇只教升級/合成。 JACKZ.AI 的 Draw type 必須選擇 Success / fail: Card Upgrade, Enhancement。以下使用英文介面截圖,方便逐項對照。

為甚麼可以驗證

RNG 是隨機數產生器。每次升級會產生一個 Roll 數字;數字落在該局的 Winning range 成功範圍內,升級便成功。

完整驗證連接三個步驟:

  1. 開始前保存指紋。 Server seed hash 是隱藏 Server seed 的數位指紋。先保存完整 hash,留下該局開始前的紀錄。
  2. 公開 seed 後核對指紋。 驗證器重新計算 Server seed 的 hash,必須與事前保存的值相同。更換 seed 幾乎必然產生不同指紋。
  3. 重新計算及對照結果。 相同 Server seed、Client seed 和 Nonce,經相同公式會產生相同 Roll。再核對紀錄中的 Roll 及成功範圍。

這些核對讓你發現 seed 被更換,或結果不符合提供的輸入與規則。開始前保存 hash,才可把事後計算連接到當時的承諾。

為甚麼要事前保存 hash?沒有保存怎麼辦?

Hash 是 Server seed 的數位指紋。保存 hash,讓你在 seed 公開後,親自確認它符合升級前的承諾。你保留的是一份可自行比對的原始憑據。

升級前保存 hash H;升級後取得公開的 Server seed S;驗證時計算 SHA-256(S),再與 H 比較。兩者一致,就能核對公開的 seed 符合該份事前承諾。

Hash 本身沒有時間證明。事後取得的 seed 和 hash 相符,只能確認這兩項數值一致;要確認 hash 在升級前已公開,仍需事前紀錄。

沒有自行保存,仍可使用公開的 Server seed 及該局資料重算 Roll,並按該局成功範圍核對成敗。

如另有可核實來源及時間的事前 hash 紀錄,也可用來核對種子承諾。截圖只是保存方式之一,關鍵是紀錄在升級前已經存在,並對應該局使用的 seed。

若沒有任何可核實的事前紀錄,仍可確認結果計算是否一致,但無法補做事前承諾的時間核對。沒有保存紀錄,本身並不代表平台曾更換種子。

已有完成的升級? 可直接從第 3 步開始。事後才複製的 hash,可以核對數值是否一致,但單憑它無法證明公開時間。

同時開啟兩個分頁:CARDZ.GAME Upgrade 及 JACKZ.AI 英文驗證器。

第 1 步 找到升級頁面的入口

開啟 app.cardz.game/asia/upgrade,登入帳戶。查看 Upgrader 標題旁的小圖示。

Upgrade 頁面及右上方操作圖示

時鐘圖示是 Upgrade history;盾牌圖示是 Fairness。 電腦版把游標移到圖示上即可查看名稱。喇叭用來控制聲音,問號用來查看玩法。

歷史紀錄與公平性圖示特寫

第 2 步 在下一局開始前保存 hash

按 盾牌/Fairness。在 Server seed hash 旁按 Copy,貼到記事本,並保存畫面截圖。同時記下 Client seed。

Fairness 視窗中的 Server seed hash 和 Client seed

Hash 與 Server seed 是不同資料:先公開的是 hash,之後才公開 seed。如果更換或輪換 seed,下一局前要重新保存當時的 hash。驗證既有紀錄無須再進行一次升級。

第 3 步 開啟一筆已完成的升級紀錄

關閉 Fairness,按 時鐘/Upgrade history。找到要驗證的一局,按該列開啟 Upgrade details。失敗的升級也可以驗證。

向下找到 Provable Fairness。小螢幕如有收合,先展開。所有數值必須來自同一局。

升級詳情中的成功範圍及驗證資料

用 Copy 複製 Server seed (hash)、Server seed、Client seed 及 Nonce。若 Winning range 和 Result roll 沒有 Copy 按鈕,就選取文字複製。同時記下結果是 Success 還是 Failed。

Server seed 尚未公開時: 先完成仍使用該組 seed 的待結算回合。詳情如提供 Rotate to verify,可由此操作;也可到 Fairness → Rotate。閱讀確認內容後,再返回舊紀錄。輪換會更改之後回合使用的 seed,舊回合不會重抽。若仍有回合使用舊 seed,公開時間可能延後。

按 Verify results ↗,或自行開啟 jackz.ai/en/。如顯示其他語言,選 EN。保留 CARDZ.GAME 紀錄分頁。

第 4 步 填寫升級資料

在 JACKZ.AI 按 Start Verifying 或 Self Verify。如 Enter Seeds 已收合,先展開。若已有資料,先逐項對照原紀錄。

  1. Server Seed: 貼入已公開的 Server seed,不要貼 Server seed (hash)。
  2. Client Seed: 貼入同一局的 Client seed,大小寫、空格和符號都要一致。
  3. Nonce: 貼入紀錄中的 Nonce,不要自行估計回合次數。
  4. Draw type: 選 Success / fail: Card Upgrade, Enhancement。
  5. Winning range or Threshold: 貼入完整成功範圍,包括兩端數字。例如 0 – 2,611,340,114。

選擇 Card Upgrade 與 Enhancement 並填寫資料

Winning range 與 Result roll 是兩個不同欄位。 前者是成功範圍,後者是實際產生的數字。這一步填範圍,下一步才填 Roll。

第 5 步 加入原紀錄作比較

展開 Optional: compare with the platform’s record。完成以下欄位,才可核對事前 hash 和原紀錄結果。

比較欄位及 Verify 按鈕

  • Server Seed Hash: 貼入該局開始前保存的完整 hash,並確認與詳情中的 Server seed (hash) 相同。
  • Draw: 這個升級流程填 0。Draw 與 Nonce 是不同欄位。
  • Roll: 貼入 Result roll。範例填 18489831。
  • Result: 原紀錄是 Success 就填 1;是 Failed 就填 0。不要填百分比。
  • Input card names 和 Target card name: 這兩欄是選填名稱,驗證 RNG 時可留白。

按 Verify 前再確認一次:所有值來自同一筆完成的紀錄,Draw type 已選 Card Upgrade, Enhancement。

第 6 步 按 Verify 並查看結果

按 Verify,瀏覽器便會重新計算。本文完整範例會顯示 Verified。

Verified 及三項核對結果

查看結果下方的三項核對:

  • Server Seed Hash: Hash matches: 公開的 seed 能產生你輸入的 hash。
  • Roll: Recalculated: 驗證器已按 seed 和 Nonce 重新計算 Roll。
  • Record: Matches the record: 輸入作比較的紀錄與計算一致。

Verified 是驗證通過;Success 是升級成功。 兩者意思不同。升級失敗的一局,也可以通過驗證。

按 View Proof 可查看計算細節。保存結果截圖,並與原紀錄放在一起。

讀懂範例數字

成功範圍為 0 至 2,611,340,114,包括兩端。計算得到的 18,489,831 在範圍內,所以結果是 Success。對應 Threshold 是上限加一,即 2,611,340,115。JACKZ.AI 可直接接受完整範圍,無須自行換算。

驗證能確認甚麼

使用正確的事前 hash 及完整紀錄,可確認公開 seed 符合該承諾,以及記錄的 Roll、成功或失敗,符合提供的輸入和公開公式。

JACKZ.AI 是可自行開啟的外部驗證工具,讓你在 CARDZ.GAME 介面以外重算結果。畫面的 Verified 是對輸入資料的核對,不是整個平台的認證。

Winning range 決定成功機率。這個手動流程會以你輸入的範圍核對結果。它不會評估平台如何設定機率、卡牌價值或價格,也不會核對配送、帳戶餘額及其他所有回合。

因此,除了 hash,也應保存當時顯示的機率及回合紀錄。隨機結果可以連續失敗;某個成功率不會保證少量回合中必定成功多少次。

公式的簡單說明

升級驗證器使用 HMAC-SHA256。Server seed 文字是密鑰,ClientSeed:Nonce:0 是訊息。取計算結果的前四個位元組,讀成 0 至 4,294,967,295 的無符號整數,就是 Roll。

Roll < Threshold 時升級成功。畫面顯示 0 – U,表示零至 U 均在成功範圍內。Roll 等於 Threshold 時失敗。

Seed 承諾另外使用 SHA-256:對 Server seed 文字計算 hash,結果必須等於事前保存的 Server seed hash。以上公式都由驗證器處理。

PTS 與 USDC: 直接複製證明欄位,不要換算卡值、餘額或幣別來填表。本篇使用指定的 Asia Upgrade 頁面;其他版本的畫面及幣別規則可有所不同。

沒有顯示 Verified 時

Draw calculated: 已計算結果,但比較尚未完成。到 Optional 補上原紀錄的 Roll、Result,以及保存的 hash。

Result matches the record: 結果一致,但未提供事前 Server Seed Hash。加入事前保存的 hash,才可核對 seed 承諾。

This draw can’t be verified yet: 缺少公開的 Server seed。返回第 3 步,在輪換後取得舊 seed。

Incomplete data 或 Can’t verify: 重新複製缺少的值。確認已選 Card Upgrade, Enhancement,並把 Winning range 及 Result roll 填到各自欄位。

Verification failed: 先檢查是否複製錯誤、混入另一局資料,或改動了字元。正確資料仍失敗時,保存兩邊截圖並聯絡 CARDZ.GAME 客服。

故意輸入錯誤 Roll 後顯示 Verification failed

錯誤示範: 這張圖只把驗證器內的 Roll 從 18,489,831 改成 18,489,832。CARDZ.GAME 原紀錄沒有改動,驗證器成功指出差異。

連結

畫面及按鈕名稱核對日期:2026 年 10 月 29 日。範例展示一筆已完成升級;實際驗證時請使用自己該局的數值。

© CARDZ
Thank you! Your submission has been received!
Oops! Something went wrong while submitting the form.