@actuallyfair/verifier 0.0.5 → 0.0.7

package/dist/cli/context-codec.js

@@ -4,10 +4,18 @@ const context_1 = require("../generated/context");
 function isMode(value) {
     return value === "decode" || value === "encode";
 }
-function normalizeBase64(input) {
-    const cleaned = input.replace(/\s+/g, "").replace(/-/g, "+").replace(/_/g, "/");
-    const padding = cleaned.length % 4;
-    return padding === 0 ? cleaned : `${cleaned}${"=".repeat(4 - padding)}`;
+function normalizeHex(input) {
+    const cleaned = input.replace(/\s+/g, "").replace(/^0x/i, "");
+    if (!cleaned) {
+        return cleaned;
+    }
+    if (cleaned.length % 2 !== 0) {
+        throw new Error("Hex input must have an even length.");
+    }
+    if (!/^[0-9a-fA-F]+$/.test(cleaned)) {
+        throw new Error("Hex input contains non-hex characters.");
+    }
+    return cleaned;
 }
 function readStdin() {
     return new Promise((resolve, reject) => {
@@ -32,15 +40,15 @@ async function readInput(args) {
 }
 function usage(mode) {
     if (mode === "decode") {
-        return ["Usage: npm run decode -- <base64>", "       cat context.b64 | npm run decode"];
+        return ["Usage: npm run decode -- <hex>", "       cat context.hex | npm run decode"];
     }
     if (mode === "encode") {
         return ["Usage: npm run encode -- '<json>'", "       cat context.json | npm run encode"];
     }
     return [
-        "Usage: npm run decode -- <base64>",
+        "Usage: npm run decode -- <hex>",
         "       npm run encode -- '<json>'",
-        "       cat context.b64 | npm run decode",
+        "       cat context.hex | npm run decode",
         "       cat context.json | npm run encode",
     ];
 }
@@ -70,8 +78,8 @@ async function main() {
     }
     try {
         if (modeRaw === "decode") {
-            const base64 = normalizeBase64(input);
-            const bytes = Buffer.from(base64, "base64");
+            const hex = normalizeHex(input);
+            const bytes = Buffer.from(hex, "hex");
             const message = context_1.Context.decode(bytes);
             const json = context_1.Context.toJSON(message);
             process.stdout.write(`${JSON.stringify(json, null, 2)}\n`);
@@ -80,7 +88,7 @@ async function main() {
         const parsed = JSON.parse(input);
         const message = context_1.Context.fromJSON(parsed);
         const encoded = context_1.Context.encode(message).finish();
-        process.stdout.write(`${Buffer.from(encoded).toString("base64")}\n`);
+        process.stdout.write(`${Buffer.from(encoded).toString("hex")}\n`);
     }
     catch (error) {
         console.error(`Failed to ${modeRaw} context: ${errorMessage(error)}`);

package/dist/compute-wager.d.ts

@@ -2,26 +2,37 @@ import { Currency } from "./generated/currency";
 import { FairCoinToss, FairCoinToss_Choice } from "./generated/context/fair-coin-toss";
 import { CrashDice } from "./generated/context/crash-dice";
 import { MultiRoulette } from "./generated/context/multi-roulette";
-import { Plinko } from "./generated/context/plinko";
-export declare function computeFairCoinTossResult(sig: Uint8Array): FairCoinToss_Choice.HEADS | FairCoinToss_Choice.TAILS;
-export declare function computeFairCoinTossOutcome(sig: Uint8Array, w: FairCoinToss): {
+export type CompressedSeed = number;
+export type RandomSource = Uint8Array;
+export declare function splitHelixHash(hash: Uint8Array): {
+    lhs: Uint8Array;
+    rhs: Uint8Array;
+};
+export declare function computeCompressedSeed(clientSeed: string, lhsHash: Uint8Array): CompressedSeed;
+export declare function computeCompressedSeedFromGameHash(clientSeed: string, gameHash: Uint8Array): CompressedSeed;
+export declare function computeRandomSourceFromCompressedSeed(compressedSeed: CompressedSeed, rhsHash: Uint8Array): RandomSource;
+export declare function computeRandomSource(clientSeed: string, gameHash: Uint8Array): RandomSource;
+export declare function computeFairCoinTossResult(randomSource: RandomSource): FairCoinToss_Choice.HEADS | FairCoinToss_Choice.TAILS;
+export declare function computeFairCoinTossOutcome(randomSource: RandomSource, w: FairCoinToss): {
     result: FairCoinToss_Choice;
     playerProfit: {
         currency: Currency;
         amount: number;
     };
 };
-export declare function computeCrashResult(vxSignature: Uint8Array, gameHash: Uint8Array, // This is the hash of the next from the hash chain
+export declare function computeCrashResult(hash: Uint8Array, gameHash: Uint8Array, // This is the hash of the next from the hash chain
 houseEdge?: number): number;
 export type CrashDiceOutcome = {
     multiplier: number;
     target: number;
     win: boolean;
 };
+export declare function computeCrashDiceResultFromRandomSource(randomSource: RandomSource): number;
 export declare function computeCrashDiceResult(hash: Uint8Array, clientSeed: string): number;
+export declare function computeCrashDiceOutcomeFromRandomSource(randomSource: RandomSource, bet: CrashDice): CrashDiceOutcome;
 export declare function computeCrashDiceOutcome(hash: Uint8Array, clientSeed: string, bet: CrashDice): CrashDiceOutcome;
-export declare function computeMultiRouletteResult(vxSignature: Uint8Array, bet: MultiRoulette): number | undefined;
-export declare function computeMineLocations(vxSignature: Uint8Array, revealedCells: Set<number>, // tiles we know are safe
+export declare function computeMultiRouletteResult(randomSource: RandomSource, bet: MultiRoulette): number | undefined;
+export declare function computeMineLocations(randomSource: RandomSource, revealedCells: Set<number>, // tiles we know are safe
 cells: number, // how many cells in total
 mines: number): Set<number>;
 export declare function computeMinesMultiplier(mines: number, // how many mines in the game
@@ -30,13 +41,13 @@ turn: number, // which turn they have finished
 houseEdge?: number): number;
 type PlinkoPath = ("L" | "R")[];
 export declare function computePinkoPossibilityIndexFromPath(path: PlinkoPath): number;
-export declare function computePlinkoPath(vxSignature: Uint8Array, possibilities: number): PlinkoPath;
+export declare function computePlinkoPath(randomSource: RandomSource, possibilities: number): PlinkoPath;
 export declare function computePlinkoPascalsProbabilities(rowNumber: number): number[];
-export declare function computePlinkoHouseEdge(possibilities: number[]): number;
+export declare function computePlinkoHouseEdge(payouts: number[]): number;
 export type PlinkoResult = {
     slot: number;
     multiplier: number;
-    win: boolean;
 };
-export declare function computePlinkoResult(hash: Uint8Array, clientSeed: string, bet: Plinko): PlinkoResult;
+export declare function computePlinkoResultFromRandomSource(randomSource: RandomSource, payouts: number[]): PlinkoResult;
+export declare function computePlinkoResult(hash: Uint8Array, clientSeed: string, payouts: number[]): PlinkoResult;
 export {};

package/dist/compute-wager.js

@@ -1,16 +1,47 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.computePlinkoResult = exports.computePlinkoHouseEdge = exports.computePlinkoPascalsProbabilities = exports.computePlinkoPath = exports.computePinkoPossibilityIndexFromPath = exports.computeMinesMultiplier = exports.computeMineLocations = exports.computeMultiRouletteResult = exports.computeCrashDiceOutcome = exports.computeCrashDiceResult = exports.computeCrashResult = exports.computeFairCoinTossOutcome = exports.computeFairCoinTossResult = void 0;
+exports.computePlinkoResult = exports.computePlinkoResultFromRandomSource = exports.computePlinkoHouseEdge = exports.computePlinkoPascalsProbabilities = exports.computePlinkoPath = exports.computePinkoPossibilityIndexFromPath = exports.computeMinesMultiplier = exports.computeMineLocations = exports.computeMultiRouletteResult = exports.computeCrashDiceOutcome = exports.computeCrashDiceOutcomeFromRandomSource = exports.computeCrashDiceResult = exports.computeCrashDiceResultFromRandomSource = exports.computeCrashResult = exports.computeFairCoinTossOutcome = exports.computeFairCoinTossResult = exports.computeRandomSource = exports.computeRandomSourceFromCompressedSeed = exports.computeCompressedSeedFromGameHash = exports.computeCompressedSeed = exports.splitHelixHash = void 0;
 const sha256_1 = require("@noble/hashes/sha256");
 const hmac_1 = require("@noble/hashes/hmac");
 const utils_1 = require("@noble/curves/abstract/utils");
 const currency_1 = require("./generated/currency");
 const fair_coin_toss_1 = require("./generated/context/fair-coin-toss");
 const utils_2 = require("@noble/hashes/utils");
-const duel_plinko_payouts_1 = require("./duel-plinko-payouts");
-function computeFairCoinTossResult(sig) {
-    // We're going to hash the signature just to really be sure its fairly distributed
-    const hash = (0, sha256_1.sha256)(sig);
+function splitHelixHash(hash) {
+    if (hash.length % 2 !== 0) {
+        throw new Error("Helix hash input must have an even number of bytes.");
+    }
+    const mid = hash.length >>> 1;
+    return {
+        lhs: hash.subarray(0, mid),
+        rhs: hash.subarray(mid),
+    };
+}
+exports.splitHelixHash = splitHelixHash;
+function computeCompressedSeed(clientSeed, lhsHash) {
+    const seedHash = hmacSha256(lhsHash, clientSeed);
+    return u32FromHash(seedHash);
+}
+exports.computeCompressedSeed = computeCompressedSeed;
+function computeCompressedSeedFromGameHash(clientSeed, gameHash) {
+    const { lhs } = splitHelixHash(gameHash);
+    return computeCompressedSeed(clientSeed, lhs);
+}
+exports.computeCompressedSeedFromGameHash = computeCompressedSeedFromGameHash;
+function computeRandomSourceFromCompressedSeed(compressedSeed, rhsHash) {
+    const seedBytes = u32ToBytes(compressedSeed);
+    return hmacSha256Bytes(rhsHash, seedBytes);
+}
+exports.computeRandomSourceFromCompressedSeed = computeRandomSourceFromCompressedSeed;
+function computeRandomSource(clientSeed, gameHash) {
+    const { lhs, rhs } = splitHelixHash(gameHash);
+    const compressedSeed = computeCompressedSeed(clientSeed, lhs);
+    return computeRandomSourceFromCompressedSeed(compressedSeed, rhs);
+}
+exports.computeRandomSource = computeRandomSource;
+function computeFairCoinTossResult(randomSource) {
+    // We're going to hash the random source just to really be sure its fairly distributed
+    const hash = (0, sha256_1.sha256)(randomSource);
     const result = hash[0] % 2;
     if (result == 0) {
         return fair_coin_toss_1.FairCoinToss_Choice.HEADS;
@@ -20,8 +51,8 @@ function computeFairCoinTossResult(sig) {
     }
 }
 exports.computeFairCoinTossResult = computeFairCoinTossResult;
-function computeFairCoinTossOutcome(sig, w) {
-    const result = computeFairCoinTossResult(sig);
+function computeFairCoinTossOutcome(randomSource, w) {
+    const result = computeFairCoinTossResult(randomSource);
     const win = w.playerChoice === result;
     const profit = win ? 1 : -1;
     return {
@@ -30,10 +61,10 @@ function computeFairCoinTossOutcome(sig, w) {
     };
 }
 exports.computeFairCoinTossOutcome = computeFairCoinTossOutcome;
-function doComputeCrashResult(hash, houseEdge) {
+function doComputeCrashResult(randomSource, houseEdge) {
     const nBits = 52;
-    const hashHex = (0, utils_2.bytesToHex)(hash);
-    const seed = hashHex.slice(0, nBits / 4);
+    const randomSourceHex = (0, utils_2.bytesToHex)(randomSource);
+    const seed = randomSourceHex.slice(0, nBits / 4);
     const r = Number.parseInt(seed, 16);
     let X = r / 2 ** nBits; // uniformly distributed in [0; 1)
     let Y = 1 - X; // Now it's uniformly distributed in (0; 1], so it's safe to divide by it
@@ -42,18 +73,25 @@ function doComputeCrashResult(hash, houseEdge) {
     result = Math.max(1, result);
     return result;
 }
-function computeCrashResult(vxSignature, gameHash, // This is the hash of the next from the hash chain
+function computeCrashResult(hash, gameHash, // This is the hash of the next from the hash chain
 houseEdge = 0) {
-    return doComputeCrashResult((0, hmac_1.hmac)(sha256_1.sha256, vxSignature, gameHash), houseEdge);
+    return doComputeCrashResult((0, hmac_1.hmac)(sha256_1.sha256, hash, gameHash), houseEdge);
 }
 exports.computeCrashResult = computeCrashResult;
+function computeCrashDiceResultFromRandomSource(randomSource) {
+    const normalized = u32FromHash(randomSource);
+    const max = 2 ** 32;
+    const multiplierTimes100 = Math.floor((100 * max) / (max - normalized));
+    return multiplierTimes100 / 100;
+}
+exports.computeCrashDiceResultFromRandomSource = computeCrashDiceResultFromRandomSource;
 function computeCrashDiceResult(hash, clientSeed) {
-    const rollHash = hmacSha256(hash, clientSeed);
-    return multiplierFromHash(rollHash);
+    const randomSource = computeRandomSource(clientSeed, hash);
+    return computeCrashDiceResultFromRandomSource(randomSource);
 }
 exports.computeCrashDiceResult = computeCrashDiceResult;
-function computeCrashDiceOutcome(hash, clientSeed, bet) {
-    const multiplier = computeCrashDiceResult(hash, clientSeed);
+function computeCrashDiceOutcomeFromRandomSource(randomSource, bet) {
+    const multiplier = computeCrashDiceResultFromRandomSource(randomSource);
     const target = bet.target;
     return {
         multiplier,
@@ -61,12 +99,17 @@ function computeCrashDiceOutcome(hash, clientSeed, bet) {
         win: multiplier >= target,
     };
 }
+exports.computeCrashDiceOutcomeFromRandomSource = computeCrashDiceOutcomeFromRandomSource;
+function computeCrashDiceOutcome(hash, clientSeed, bet) {
+    const randomSource = computeRandomSource(clientSeed, hash);
+    return computeCrashDiceOutcomeFromRandomSource(randomSource, bet);
+}
 exports.computeCrashDiceOutcome = computeCrashDiceOutcome;
 // returns the index of which roulette outcome was picked
-function computeMultiRouletteResult(vxSignature, bet) {
-    const hash = (0, sha256_1.sha256)(vxSignature);
+function computeMultiRouletteResult(randomSource, bet) {
+    const seedHash = (0, sha256_1.sha256)(randomSource);
     const nBits = 52;
-    const hashHex = (0, utils_2.bytesToHex)(hash);
+    const hashHex = (0, utils_2.bytesToHex)(seedHash);
     const seed = hashHex.slice(0, nBits / 4);
     const n = Number.parseInt(seed, 16);
     const v = n / 2 ** nBits; // uniform in [0; 1)
@@ -79,7 +122,7 @@ function computeMultiRouletteResult(vxSignature, bet) {
     }
 }
 exports.computeMultiRouletteResult = computeMultiRouletteResult;
-function computeMineLocations(vxSignature, revealedCells, // tiles we know are safe
+function computeMineLocations(randomSource, revealedCells, // tiles we know are safe
 cells, // how many cells in total
 mines // how many mines there are going to be in total
 ) {
@@ -90,7 +133,7 @@ mines // how many mines there are going to be in total
             console.warn("Trying to place more mines than there are available locations.");
             break;
         }
-        let mineIndex = Number((0, utils_1.bytesToNumberBE)(vxSignature) % BigInt(cellsLeft));
+        let mineIndex = Number((0, utils_1.bytesToNumberBE)(randomSource) % BigInt(cellsLeft));
         let adjustedIndex = 0;
         for (let i = 0; i < cells; i++) {
             if (revealedCells.has(i) || mineLocations.has(i))
@@ -152,14 +195,14 @@ function computePinkoPossibilityIndexFromPath(path) {
 exports.computePinkoPossibilityIndexFromPath = computePinkoPossibilityIndexFromPath;
 // return a path (saying 'L' or 'R', where 'L' means go left, and 'R' means going right)
 //  of possibilities-1 length
-function computePlinkoPath(vxSignature, possibilities) {
+function computePlinkoPath(randomSource, possibilities) {
     if (!Number.isSafeInteger(possibilities) ||
         possibilities < 2 ||
         possibilities > 256) {
         throw new Error("invalid possibilities ");
     }
-    const hash = (0, sha256_1.sha256)(vxSignature);
-    let n = (0, utils_1.bytesToNumberBE)(hash);
+    const pathHash = (0, sha256_1.sha256)(randomSource);
+    let n = (0, utils_1.bytesToNumberBE)(pathHash);
     let ret = [];
     for (let i = 0; i < possibilities - 1; i++) {
         ret.push(n % 2n == 0n ? "R" : "L");
@@ -193,65 +236,64 @@ function computePlinkoPascalsProbabilities(rowNumber) {
     return lastRow.map((v) => v / sum);
 }
 exports.computePlinkoPascalsProbabilities = computePlinkoPascalsProbabilities;
-function computePlinkoHouseEdge(possibilities) {
-    const odds = computePlinkoPascalsProbabilities(possibilities.length);
+function computePlinkoHouseEdge(payouts) {
+    const odds = computePlinkoPascalsProbabilities(payouts.length);
     let ev = 1; // you start off by betting everything
-    for (let i = 0; i < possibilities.length; i++) {
-        ev -= possibilities[i] * odds[i];
+    for (let i = 0; i < payouts.length; i++) {
+        ev -= payouts[i] * odds[i];
     }
     return ev;
 }
 exports.computePlinkoHouseEdge = computePlinkoHouseEdge;
-function computePlinkoResult(hash, clientSeed, bet) {
-    const possibilities = resolvePlinkoPayouts(bet);
-    if (possibilities.length < 2) {
+function computePlinkoResultFromRandomSource(randomSource, payouts) {
+    if (payouts.length < 2) {
         throw new Error("invalid possibilities ");
     }
-    const probabilities = computePlinkoPascalsProbabilities(possibilities.length);
-    const rollHash = hmacSha256(hash, clientSeed);
-    const roll = uniformFromHash(rollHash);
+    const probabilities = computePlinkoPascalsProbabilities(payouts.length);
+    const roll = uniformFromHash(randomSource);
     const slot = pickSlot(probabilities, roll);
-    const multiplier = possibilities[slot] ?? 0;
+    const multiplier = payouts[slot] ?? 0;
     return {
         slot,
         multiplier,
-        win: multiplier >= 1,
     };
 }
-exports.computePlinkoResult = computePlinkoResult;
-function resolvePlinkoPayouts(bet) {
-    const payouts = bet.payouts;
-    if (!payouts) {
-        return [];
-    }
-    if (payouts.duel) {
-        return (0, duel_plinko_payouts_1.getDuelPlinkoPayoutsFromEnum)(payouts.duel.rows, payouts.duel.risk);
-    }
-    if (payouts.custom) {
-        return payouts.custom.possibilities;
-    }
-    return [];
+exports.computePlinkoResultFromRandomSource = computePlinkoResultFromRandomSource;
+function computePlinkoResult(hash, clientSeed, payouts) {
+    const randomSource = computeRandomSource(clientSeed, hash);
+    return computePlinkoResultFromRandomSource(randomSource, payouts);
 }
+exports.computePlinkoResult = computePlinkoResult;
 function hmacSha256(key, message) {
     const data = new TextEncoder().encode(message);
     return (0, hmac_1.hmac)(sha256_1.sha256, key, data);
 }
-function multiplierFromHash(hash) {
-    if (hash.length < 4) {
-        throw new Error("Hash must be at least 4 bytes.");
+function hmacSha256Bytes(key, message) {
+    return (0, hmac_1.hmac)(sha256_1.sha256, key, message);
+}
+function u32FromHash(randomSource) {
+    if (randomSource.length < 4) {
+        throw new Error("Random source must be at least 4 bytes.");
     }
-    const value = (hash[0] << 24) | (hash[1] << 16) | (hash[2] << 8) | hash[3];
-    const normalized = value >>> 0;
-    const max = 2 ** 32;
-    const multiplierTimes100 = Math.floor((100 * max) / (max - normalized));
-    return multiplierTimes100 / 100;
+    return (((randomSource[0] << 24) |
+        (randomSource[1] << 16) |
+        (randomSource[2] << 8) |
+        randomSource[3]) >>>
+        0);
 }
-function uniformFromHash(hash) {
-    if (hash.length < 4) {
-        throw new Error("Hash must be at least 4 bytes.");
+function u32ToBytes(value) {
+    if (!Number.isInteger(value) || value < 0 || value > 0xffffffff) {
+        throw new Error("Value must be a 32-bit unsigned integer.");
     }
-    const value = (hash[0] << 24) | (hash[1] << 16) | (hash[2] << 8) | hash[3];
-    const normalized = value >>> 0;
+    const buffer = new Uint8Array(4);
+    buffer[0] = (value >>> 24) & 0xff;
+    buffer[1] = (value >>> 16) & 0xff;
+    buffer[2] = (value >>> 8) & 0xff;
+    buffer[3] = value & 0xff;
+    return buffer;
+}
+function uniformFromHash(randomSource) {
+    const normalized = u32FromHash(randomSource);
     return normalized / 2 ** 32;
 }
 function pickSlot(probabilities, roll) {

package/dist/duel-plinko-payouts.d.ts

@@ -1,14 +1,18 @@
-import { DuelPlinkoRisk } from "./generated/context/plinko";
-export declare const DUEL_PLINKO_RISK_KEYS: readonly ["low", "medium", "high"];
-export type DuelPlinkoRiskKey = (typeof DUEL_PLINKO_RISK_KEYS)[number];
-export declare const DUEL_PLINKO_PAYOUTS: Record<number, Record<DuelPlinkoRiskKey, number[]>>;
-export declare const DUEL_PLINKO_ROWS: {
+import { PlinkoPayoutTable } from "./generated/context/plinko";
+export declare const PLINKO_RISK_KEYS: readonly ["low", "medium", "high"];
+export type PlinkoRiskKey = (typeof PLINKO_RISK_KEYS)[number];
+export declare const PLINKO_PAYOUT_TABLE_KEYS: readonly ["duel_8_low", "duel_8_medium", "duel_8_high", "duel_9_low", "duel_9_medium", "duel_9_high", "duel_10_low", "duel_10_medium", "duel_10_high", "duel_11_low", "duel_11_medium", "duel_11_high", "duel_12_low", "duel_12_medium", "duel_12_high", "duel_13_low", "duel_13_medium", "duel_13_high", "duel_14_low", "duel_14_medium", "duel_14_high", "duel_15_low", "duel_15_medium", "duel_15_high", "duel_16_low", "duel_16_medium", "duel_16_high"];
+export type PlinkoPayoutTableKey = (typeof PLINKO_PAYOUT_TABLE_KEYS)[number];
+export declare const PLINKO_PAYOUT_TABLES: Record<PlinkoPayoutTableKey, number[]>;
+export declare const PLINKO_ROWS: {
     readonly min: number;
     readonly max: number;
 };
-export declare function getDuelPlinkoPayouts(rows: number, risk: DuelPlinkoRiskKey): number[];
-export declare function isDuelPlinkoRiskKey(value: string): value is DuelPlinkoRiskKey;
-export declare function isDuelPlinkoRows(rows: number): boolean;
-export declare function duelPlinkoRiskToEnum(value: DuelPlinkoRiskKey): DuelPlinkoRisk;
-export declare function duelPlinkoRiskFromEnum(value: DuelPlinkoRisk): DuelPlinkoRiskKey | null;
-export declare function getDuelPlinkoPayoutsFromEnum(rows: number, risk: DuelPlinkoRisk): number[];
+export declare function isPlinkoRiskKey(value: string): value is PlinkoRiskKey;
+export declare function isPlinkoRows(rows: number): boolean;
+export declare function getPlinkoPayoutTableKey(rows: number, risk: PlinkoRiskKey): PlinkoPayoutTableKey | null;
+export declare function getPlinkoPayouts(key: PlinkoPayoutTableKey): number[];
+export declare function isPlinkoPayoutTableKey(value: string): value is PlinkoPayoutTableKey;
+export declare function plinkoPayoutTableToEnum(value: PlinkoPayoutTableKey): PlinkoPayoutTable;
+export declare function plinkoPayoutTableFromEnum(value: PlinkoPayoutTable): PlinkoPayoutTableKey | null;
+export declare function getPlinkoPayoutsFromEnum(value: PlinkoPayoutTable): number[];