
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:
0.50(資產 A) -> 是否U < 0.50? - 閾值 2:
0.80(0.50 + 0.30) -> 是否U < 0.80? - 閾值 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 成功範圍內,升級便成功。
完整驗證連接三個步驟:
- 開始前保存指紋。 Server seed hash 是隱藏 Server seed 的數位指紋。先保存完整 hash,留下該局開始前的紀錄。
- 公開 seed 後核對指紋。 驗證器重新計算 Server seed 的 hash,必須與事前保存的值相同。更換 seed 幾乎必然產生不同指紋。
- 重新計算及對照結果。 相同 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 history;盾牌圖示是 Fairness。 電腦版把游標移到圖示上即可查看名稱。喇叭用來控制聲音,問號用來查看玩法。

第 2 步 在下一局開始前保存 hash
按 盾牌/Fairness。在 Server seed hash 旁按 Copy,貼到記事本,並保存畫面截圖。同時記下 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 已收合,先展開。若已有資料,先逐項對照原紀錄。
- Server Seed: 貼入已公開的 Server seed,不要貼 Server seed (hash)。
- Client Seed: 貼入同一局的 Client seed,大小寫、空格和符號都要一致。
- Nonce: 貼入紀錄中的 Nonce,不要自行估計回合次數。
- Draw type: 選 Success / fail: Card Upgrade, Enhancement。
- Winning range or Threshold: 貼入完整成功範圍,包括兩端數字。例如 0 – 2,611,340,114。

Winning range 與 Result roll 是兩個不同欄位。 前者是成功範圍,後者是實際產生的數字。這一步填範圍,下一步才填 Roll。
第 5 步 加入原紀錄作比較
展開 Optional: compare with the platform’s record。完成以下欄位,才可核對事前 hash 和原紀錄結果。

- 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。

查看結果下方的三項核對:
- 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 從 18,489,831 改成 18,489,832。CARDZ.GAME 原紀錄沒有改動,驗證器成功指出差異。
連結
畫面及按鈕名稱核對日期:2026 年 10 月 29 日。範例展示一筆已完成升級;實際驗證時請使用自己該局的數值。
