shufflecom-calculations 2.2.32 → 2.3.1

package/lib/games/chicken.d.ts

@@ -0,0 +1,18 @@
+import BigNumber from 'bignumber.js';
+import { GameCalculation } from './gameCalculation';
+export declare enum ChickenDifficulty {
+    EASY = "EASY",
+    MEDIUM = "MEDIUM",
+    HARD = "HARD",
+    EXPERT = "EXPERT"
+}
+export declare class Chicken extends GameCalculation {
+    static readonly TOTAL_LANES = 20;
+    static readonly DIFFICULTY_TO_VALID_LANE_COUNT: Record<ChickenDifficulty, number>;
+    static readonly DIFFICULTY_TO_HEX_ROUNDS: Record<ChickenDifficulty, number>;
+    static getResults(hexStr: string[], difficulty: ChickenDifficulty): number[];
+    static calculateWinChanceBN(difficulty: ChickenDifficulty, selectedLane: number): BigNumber;
+    static calculateMultiplierBN(difficulty: ChickenDifficulty, selectedLane: number, edgeBps: number): BigNumber;
+    static firstDeathLane(results: number[]): number;
+    static isLoss(results: number[], selected: number): boolean;
+}

package/lib/games/chicken.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Chicken = exports.ChickenDifficulty = void 0;
+const edge_1 = require("../utils/edge");
+const ncr_1 = require("../utils/ncr");
+const gameCalculation_1 = require("./gameCalculation");
+var ChickenDifficulty;
+(function (ChickenDifficulty) {
+    ChickenDifficulty["EASY"] = "EASY";
+    ChickenDifficulty["MEDIUM"] = "MEDIUM";
+    ChickenDifficulty["HARD"] = "HARD";
+    ChickenDifficulty["EXPERT"] = "EXPERT";
+})(ChickenDifficulty || (exports.ChickenDifficulty = ChickenDifficulty = {}));
+class Chicken extends gameCalculation_1.GameCalculation {
+    static getResults(hexStr, difficulty) {
+        const losingLaneCount = this.TOTAL_LANES - this.DIFFICULTY_TO_VALID_LANE_COUNT[difficulty];
+        return this.pickUniqueNumbers(hexStr, losingLaneCount, this.TOTAL_LANES);
+    }
+    static calculateWinChanceBN(difficulty, selectedLane) {
+        const validLanes = this.DIFFICULTY_TO_VALID_LANE_COUNT[difficulty];
+        const selectedLaneCount = selectedLane + 1;
+        return (0, ncr_1.nCr)(validLanes, selectedLaneCount).dividedBy((0, ncr_1.nCr)(this.TOTAL_LANES, selectedLaneCount));
+    }
+    static calculateMultiplierBN(difficulty, selectedLane, edgeBps) {
+        const winChance = this.calculateWinChanceBN(difficulty, selectedLane);
+        return (0, edge_1.calculateEdgeMultiplier)(edgeBps).div(winChance);
+    }
+    static firstDeathLane(results) {
+        if (results.length === 0) {
+            throw new Error('Results array is empty, cannot determine first death lane.');
+        }
+        return Math.min(...results);
+    }
+    static isLoss(results, selected) {
+        return selected >= this.firstDeathLane(results);
+    }
+}
+exports.Chicken = Chicken;
+Chicken.TOTAL_LANES = 20;
+Chicken.DIFFICULTY_TO_VALID_LANE_COUNT = {
+    [ChickenDifficulty.EASY]: 19,
+    [ChickenDifficulty.MEDIUM]: 17,
+    [ChickenDifficulty.HARD]: 15,
+    [ChickenDifficulty.EXPERT]: 10,
+};
+Chicken.DIFFICULTY_TO_HEX_ROUNDS = {
+    [ChickenDifficulty.EASY]: 1,
+    [ChickenDifficulty.MEDIUM]: 1,
+    [ChickenDifficulty.HARD]: 1,
+    [ChickenDifficulty.EXPERT]: 2,
+};
+//# sourceMappingURL=chicken.js.map

package/lib/games/chicken.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chicken.js","sourceRoot":"","sources":["../../src/games/chicken.ts"],"names":[],"mappings":";;;AACA,wCAAwD;AACxD,sCAAmC;AACnC,uDAAoD;AAEpD,IAAY,iBAKX;AALD,WAAY,iBAAiB;IAC3B,kCAAa,CAAA;IACb,sCAAiB,CAAA;IACjB,kCAAa,CAAA;IACb,sCAAiB,CAAA;AACnB,CAAC,EALW,iBAAiB,iCAAjB,iBAAiB,QAK5B;AAED,MAAa,OAAQ,SAAQ,iCAAe;IAiB1C,MAAM,CAAC,UAAU,CAAC,MAAgB,EAAE,UAA6B;QAC/D,MAAM,eAAe,GAAG,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,8BAA8B,CAAC,UAAU,CAAC,CAAC;QAE3F,OAAO,IAAI,CAAC,iBAAiB,CAAC,MAAM,EAAE,eAAe,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IAC3E,CAAC;IAED,MAAM,CAAC,oBAAoB,CAAC,UAA6B,EAAE,YAAoB;QAC7E,MAAM,UAAU,GAAG,IAAI,CAAC,8BAA8B,CAAC,UAAU,CAAC,CAAC;QACnE,MAAM,iBAAiB,GAAG,YAAY,GAAG,CAAC,CAAC;QAE3C,OAAO,IAAA,SAAG,EAAC,UAAU,EAAE,iBAAiB,CAAC,CAAC,SAAS,CAAC,IAAA,SAAG,EAAC,IAAI,CAAC,WAAW,EAAE,iBAAiB,CAAC,CAAC,CAAC;IAChG,CAAC;IAED,MAAM,CAAC,qBAAqB,CAAC,UAA6B,EAAE,YAAoB,EAAE,OAAe;QAC/F,MAAM,SAAS,GAAG,IAAI,CAAC,oBAAoB,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;QAEtE,OAAO,IAAA,8BAAuB,EAAC,OAAO,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACzD,CAAC;IAED,MAAM,CAAC,cAAc,CAAC,OAAiB;QACrC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC;QAChF,CAAC;QACD,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC;IAC9B,CAAC;IAED,MAAM,CAAC,MAAM,CAAC,OAAiB,EAAE,QAAgB;QAC/C,OAAO,QAAQ,IAAI,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;IAClD,CAAC;;AA7CH,0BA8CC;AA7CiB,mBAAW,GAAG,EAAE,CAAC;AAEjB,sCAA8B,GAAsC;IAClF,CAAC,iBAAiB,CAAC,IAAI,CAAC,EAAE,EAAE;IAC5B,CAAC,iBAAiB,CAAC,MAAM,CAAC,EAAE,EAAE;IAC9B,CAAC,iBAAiB,CAAC,IAAI,CAAC,EAAE,EAAE;IAC5B,CAAC,iBAAiB,CAAC,MAAM,CAAC,EAAE,EAAE;CAC/B,CAAC;AAEc,gCAAwB,GAAsC;IAC5E,CAAC,iBAAiB,CAAC,IAAI,CAAC,EAAE,CAAC;IAC3B,CAAC,iBAAiB,CAAC,MAAM,CAAC,EAAE,CAAC;IAC7B,CAAC,iBAAiB,CAAC,IAAI,CAAC,EAAE,CAAC;IAC3B,CAAC,iBAAiB,CAAC,MAAM,CAAC,EAAE,CAAC;CAC9B,CAAC"}

package/lib/games/gameCalculation.d.ts

@@ -0,0 +1,16 @@
+export declare abstract class GameCalculation {
+    private static readonly BYTE_TOTAL;
+    private static readonly BYTES_PER_HEX_STRING;
+    private static readonly BYTES_PER_RANDOM_NUMBER;
+    private static readonly NUMBERS_PER_HEX_STRING;
+    private static bytesToProbability;
+    private static getRandomInt;
+    static pickUniqueNumbers(hexStrings: string[], count: number, poolSize: number): number[];
+    static generateIndependentNumbers(hexStrings: string[], count: number, maxValue: number): number[];
+    static generateDigestHex({ serverSeed, clientSeed, nonce, rounds, }: {
+        serverSeed: string;
+        clientSeed: string;
+        nonce: string;
+        rounds: number;
+    }): string[];
+}

package/lib/games/gameCalculation.js

@@ -0,0 +1,82 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GameCalculation = void 0;
+const bignumber_js_1 = __importDefault(require("bignumber.js"));
+const hex_to_bytes_1 = require("../utils/hex-to-bytes");
+const crypto_1 = require("crypto");
+class GameCalculation {
+    static bytesToProbability(byteArray, startIndex) {
+        let probability = new bignumber_js_1.default(0);
+        for (let i = 0; i < this.BYTES_PER_RANDOM_NUMBER; i++) {
+            const byteValue = byteArray[startIndex + i];
+            probability = probability.plus(new bignumber_js_1.default(byteValue).dividedBy(this.BYTE_TOTAL.pow(i + 1)));
+        }
+        return probability;
+    }
+    static getRandomInt(byteArray, startIndex, maxValue) {
+        const probability = this.bytesToProbability(byteArray, startIndex);
+        return probability.multipliedBy(maxValue).integerValue(bignumber_js_1.default.ROUND_DOWN).toNumber();
+    }
+    static pickUniqueNumbers(hexStrings, count, poolSize) {
+        const bytesAvailable = hexStrings.length * this.BYTES_PER_HEX_STRING;
+        const bytesNeeded = count * this.BYTES_PER_RANDOM_NUMBER;
+        if (bytesAvailable < bytesNeeded) {
+            throw new Error(`Not enough randomness: need ${bytesNeeded} bytes for ${count} numbers, only have ${bytesAvailable} bytes`);
+        }
+        const results = [];
+        const pool = Array.from({ length: poolSize }, (_, i) => i);
+        const byteArrays = hexStrings.map(hex_to_bytes_1.hexToBytes);
+        for (let hexIndex = 0; hexIndex < byteArrays.length; hexIndex++) {
+            const byteArray = byteArrays[hexIndex];
+            for (let numberIndex = 0; numberIndex < this.NUMBERS_PER_HEX_STRING; numberIndex++) {
+                if (results.length >= count) {
+                    return results;
+                }
+                const byteOffset = numberIndex * this.BYTES_PER_RANDOM_NUMBER;
+                const remainingPoolSize = pool.length;
+                const randomPosition = this.getRandomInt(byteArray, byteOffset, remainingPoolSize);
+                const pickedNumber = pool.splice(randomPosition, 1)[0];
+                results.push(pickedNumber);
+            }
+        }
+        return results;
+    }
+    static generateIndependentNumbers(hexStrings, count, maxValue) {
+        const bytesAvailable = hexStrings.length * this.BYTES_PER_HEX_STRING;
+        const bytesNeeded = count * this.BYTES_PER_RANDOM_NUMBER;
+        if (bytesAvailable < bytesNeeded) {
+            throw new Error(`Not enough randomness: need ${bytesNeeded} bytes for ${count} numbers, only have ${bytesAvailable} bytes`);
+        }
+        const results = [];
+        const byteArrays = hexStrings.map(hex_to_bytes_1.hexToBytes);
+        for (let hexIndex = 0; hexIndex < byteArrays.length; hexIndex++) {
+            const byteArray = byteArrays[hexIndex];
+            for (let numberIndex = 0; numberIndex < this.NUMBERS_PER_HEX_STRING; numberIndex++) {
+                if (results.length >= count) {
+                    return results;
+                }
+                const byteOffset = numberIndex * this.BYTES_PER_RANDOM_NUMBER;
+                const randomNumber = this.getRandomInt(byteArray, byteOffset, maxValue);
+                results.push(randomNumber);
+            }
+        }
+        return results;
+    }
+    static generateDigestHex({ serverSeed, clientSeed, nonce, rounds, }) {
+        const results = Array.from(Array(rounds).keys()).map(round => {
+            const hmac = (0, crypto_1.createHmac)('sha256', serverSeed);
+            hmac.update(`${clientSeed}:${nonce}:${round}`);
+            return hmac.digest('hex');
+        });
+        return results;
+    }
+}
+exports.GameCalculation = GameCalculation;
+GameCalculation.BYTE_TOTAL = new bignumber_js_1.default(256);
+GameCalculation.BYTES_PER_HEX_STRING = 32;
+GameCalculation.BYTES_PER_RANDOM_NUMBER = 4;
+GameCalculation.NUMBERS_PER_HEX_STRING = 8;
+//# sourceMappingURL=gameCalculation.js.map

package/lib/games/gameCalculation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gameCalculation.js","sourceRoot":"","sources":["../../src/games/gameCalculation.ts"],"names":[],"mappings":"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"}