shufflecom-calculations 1.3.2 → 1.3.4

package/src/games/wheel.spec.ts

@@ -0,0 +1,148 @@
+import { createHmac } from 'crypto';
+import BigNumber from 'bignumber.js';
+import { WHEEL_MULTIPLIERS, Wheel, WheelRiskLevel, WheelSegments } from './wheel';
+
+interface ProvablyFair {
+  serverSeed: string;
+  clientSeed: string;
+  nonce: string;
+  segments: WheelSegments;
+  risk: WheelRiskLevel;
+  resultSegment: number;
+  multiplier: number;
+}
+
+describe('Wheel', () => {
+  it('edge for all segments and risk levels should be constant at 1%', () => {
+    Object.values(WheelSegments).forEach((segment: WheelSegments) => {
+      Object.values(WheelRiskLevel).forEach((risk: WheelRiskLevel) => {
+        const multiplierArr = WHEEL_MULTIPLIERS[segment][risk];
+        const returnToPlayer = multiplierArr.reduce((acc, curr) => acc.plus(curr), BigNumber(0)).dividedBy(multiplierArr.length);
+
+        expect(returnToPlayer.toString()).toEqual('0.99');
+      });
+    });
+  });
+
+  it('be able generate provably fair results', () => {
+    const gameSeeds: Array<ProvablyFair> = [
+      {
+        serverSeed: '9b0499f7abbebf3ea889e3f958d1bc2d77c514792143d07dc66378711f7eb313',
+        clientSeed: 'pf4jl5q97q',
+        nonce: '2',
+        segments: WheelSegments.TEN,
+        risk: WheelRiskLevel.LOW,
+        resultSegment: 5,
+        multiplier: 1.2,
+      },
+      {
+        serverSeed: '9b0499f7abbebf3ea889e3f958d1bc2d77c514792143d07dc66378711f7eb313',
+        clientSeed: 'pf4jl5q97q',
+        nonce: '3',
+        segments: WheelSegments.TEN,
+        risk: WheelRiskLevel.LOW,
+        resultSegment: 7,
+        multiplier: 1.2,
+      },
+      {
+        serverSeed: '9b0499f7abbebf3ea889e3f958d1bc2d77c514792143d07dc66378711f7eb313',
+        clientSeed: 'fasd',
+        nonce: '3',
+        segments: WheelSegments.TEN,
+        risk: WheelRiskLevel.LOW,
+        resultSegment: 2,
+        multiplier: 1.2,
+      },
+      {
+        serverSeed: 'FDL:SJ#33f9asdfasd',
+        clientSeed: 'pf4jl5q97q',
+        nonce: '2',
+        segments: WheelSegments.TEN,
+        risk: WheelRiskLevel.LOW,
+        resultSegment: 2,
+        multiplier: 1.2,
+      },
+
+      {
+        serverSeed: '9b0499f7abbebf3ea889e3f958d1bc2d77c514792143d07dc66378711f7eb313',
+        clientSeed: 'fasd',
+        nonce: '3',
+        segments: WheelSegments.TWENTY,
+        risk: WheelRiskLevel.HIGH,
+        resultSegment: 4,
+        multiplier: 0,
+      },
+      {
+        serverSeed: '9b0499f7abbebf3ea889e3f958d1bc2d77c514792143d07dc66378711f7eb313',
+        clientSeed: 'fasd',
+        nonce: '4',
+        segments: WheelSegments.THIRTY,
+        risk: WheelRiskLevel.LOW,
+        resultSegment: 21,
+        multiplier: 1.2,
+      },
+      {
+        serverSeed: '9b0499f7abbebf3ea889e3f958d1bc2d77c514792143d07dc66378711f7eb313',
+        clientSeed: 'fasd',
+        nonce: '5',
+        segments: WheelSegments.FORTY,
+        risk: WheelRiskLevel.MEDIUM,
+        resultSegment: 4,
+        multiplier: 3,
+      },
+      {
+        serverSeed: '9b0499f7abbebf3ea889e3f958d1bc2d77c514792143d07dc66378711f7eb313',
+        clientSeed: 'fasd',
+        nonce: '3',
+        segments: WheelSegments.FIFTY,
+        risk: WheelRiskLevel.HIGH,
+        resultSegment: 10,
+        multiplier: 0,
+      },
+      {
+        serverSeed: '9b0499f7abbebf3ea889e3f958d1bc2d77c514792143d07dc66378711f7eb313',
+        clientSeed: 'fasd',
+        nonce: '3',
+        segments: WheelSegments.THIRTY,
+        risk: WheelRiskLevel.MEDIUM,
+        resultSegment: 6,
+        multiplier: 2,
+      },
+      {
+        serverSeed: '9b0499f7abbebf3ea889e3f958d1bc2d77c514792143d07dc66378711f7eb313',
+        clientSeed: 'fasd',
+        nonce: '43',
+        segments: WheelSegments.FORTY,
+        risk: WheelRiskLevel.HIGH,
+        resultSegment: 39,
+        multiplier: 39.6,
+      },
+    ];
+    gameSeeds.forEach((e) => {
+      const resultHex = generateDigestHex(e);
+      const { multiplier, resultSegment } = Wheel.getResult(resultHex[0], e.segments, e.risk);
+      expect(multiplier.toNumber()).toEqual(e.multiplier);
+      expect(resultSegment).toEqual(e.resultSegment);
+    });
+  });
+});
+
+function generateDigestHex({
+  serverSeed,
+  clientSeed,
+  nonce,
+  rounds = 2,
+}: {
+  serverSeed: string;
+  clientSeed: string;
+  nonce: string;
+  rounds?: number;
+}): string[] {
+  const results = Array.from(Array(rounds).keys()).map((round) => {
+    const hmac = createHmac('sha256', serverSeed);
+    hmac.update(`${clientSeed}:${nonce}:${round}`);
+    return hmac.digest('hex');
+  });
+
+  return results;
+}

package/src/games/wheel.ts

@@ -0,0 +1,94 @@
+import BigNumber from 'bignumber.js';
+import { hexToBytes } from '../utils/hex-to-bytes';
+
+const BYTE_TOTAL = new BigNumber(256);
+
+export enum WheelRiskLevel {
+  LOW = 'LOW',
+  MEDIUM = 'MEDIUM',
+  HIGH = 'HIGH',
+}
+
+// can't map to number because using numbers in the enum doesn't work well with graphql enums
+export enum WheelSegments {
+  TEN = 'TEN',
+  TWENTY = 'TWENTY',
+  THIRTY = 'THIRTY',
+  FORTY = 'FORTY',
+  FIFTY = 'FIFTY',
+}
+
+export const WHEEL_MULTIPLIERS: Record<WheelSegments, Record<WheelRiskLevel, number[]>> = {
+  [WheelSegments.TEN]: {
+    [WheelRiskLevel.LOW]: [1.5, 1.2, 1.2, 1.2, 0, 1.2, 1.2, 1.2, 1.2, 0],
+    [WheelRiskLevel.MEDIUM]: [0, 1.9, 0, 1.5, 0, 2, 0, 1.5, 0, 3],
+    [WheelRiskLevel.HIGH]: [0, 0, 0, 0, 0, 0, 0, 0, 0, 9.9],
+  },
+  [WheelSegments.TWENTY]: {
+    [WheelRiskLevel.LOW]: [1.5, 1.2, 1.2, 1.2, 0, 1.2, 1.2, 1.2, 1.2, 0, 1.5, 1.2, 1.2, 1.2, 0, 1.2, 1.2, 1.2, 1.2, 0],
+    [WheelRiskLevel.MEDIUM]: [1.5, 0, 2, 0, 1.8, 0, 2, 0, 2, 0, 1.5, 0, 2, 0, 2, 0, 3, 0, 2, 0],
+    [WheelRiskLevel.HIGH]: [0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 19.8],
+  },
+  [WheelSegments.THIRTY]: {
+    [WheelRiskLevel.LOW]: [
+      1.5, 1.2, 1.2, 1.2, 0, 1.2, 1.2, 1.2, 1.2, 0, 1.5, 1.2, 1.2, 1.2, 0, 1.2, 1.2, 1.2, 1.2, 0, 1.5, 1.2, 1.2, 1.2, 0, 1.2, 1.2, 1.2, 1.2, 0,
+    ],
+    [WheelRiskLevel.MEDIUM]: [1.5, 0, 2, 0, 1.5, 0, 2, 0, 3, 0, 1.7, 0, 1.5, 0, 2, 0, 1.5, 0, 2, 0, 1.5, 0, 2, 0, 4, 0, 1.5, 0, 2, 0],
+    [WheelRiskLevel.HIGH]: [0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 29.7],
+  },
+  [WheelSegments.FORTY]: {
+    [WheelRiskLevel.LOW]: [
+      1.5, 1.2, 1.2, 1.2, 0, 1.2, 1.2, 1.2, 1.2, 0, 1.5, 1.2, 1.2, 1.2, 0, 1.2, 1.2, 1.2, 1.2, 0, 1.5, 1.2, 1.2, 1.2, 0, 1.2, 1.2, 1.2, 1.2, 0, 1.5, 1.2, 1.2,
+      1.2, 0, 1.2, 1.2, 1.2, 1.2, 0,
+    ],
+    [WheelRiskLevel.MEDIUM]: [
+      2, 0, 1.5, 0, 3, 0, 2, 0, 1.5, 0, 2, 0, 1.5, 0, 3, 0, 2, 0, 1.5, 0, 1.6, 0, 1.5, 0, 3, 0, 2, 0, 1.5, 0, 2, 0, 1.5, 0, 3, 0, 2, 0, 1.5, 0,
+    ],
+    [WheelRiskLevel.HIGH]: [0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 39.6],
+  },
+  [WheelSegments.FIFTY]: {
+    [WheelRiskLevel.LOW]: [
+      1.5, 1.2, 1.2, 1.2, 0, 1.2, 1.2, 1.2, 1.2, 0, 1.5, 1.2, 1.2, 1.2, 0, 1.2, 1.2, 1.2, 1.2, 0, 1.5, 1.2, 1.2, 1.2, 0, 1.2, 1.2, 1.2, 1.2, 0, 1.5, 1.2, 1.2,
+      1.2, 0, 1.2, 1.2, 1.2, 1.2, 0, 1.5, 1.2, 1.2, 1.2, 0, 1.2, 1.2, 1.2, 1.2, 0,
+    ],
+    [WheelRiskLevel.MEDIUM]: [
+      1.5, 0, 2, 0, 1.5, 0, 3, 0, 1.5, 0, 2, 0, 1.5, 0, 2, 0, 1.5, 0, 3, 0, 1.5, 0, 2, 0, 1.5, 0, 2, 0, 1.5, 0, 3, 0, 1.5, 0, 2, 0, 1.5, 0, 2, 0, 1.5, 0, 5, 0,
+      1.5, 0, 2, 0, 1.5, 0,
+    ],
+    [WheelRiskLevel.HIGH]: [
+      0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 49.5,
+    ],
+  },
+};
+
+export const WHEEL_SEGMENTS_TO_NUMBER: Record<WheelSegments, number> = {
+  [WheelSegments.TEN]: 10,
+  [WheelSegments.TWENTY]: 20,
+  [WheelSegments.THIRTY]: 30,
+  [WheelSegments.FORTY]: 40,
+  [WheelSegments.FIFTY]: 50,
+};
+
+export class Wheel {
+  static getResult(hexStr: string, segments: WheelSegments, risk: WheelRiskLevel): { resultSegment: number; multiplier: BigNumber } {
+    const resultSegment = this.getRandomNumberFromHexStr(hexStr).multipliedBy(WHEEL_SEGMENTS_TO_NUMBER[segments]).integerValue(BigNumber.ROUND_DOWN).toNumber();
+    const multiplier = BigNumber(WHEEL_MULTIPLIERS[segments][risk][resultSegment]);
+    return { resultSegment, multiplier };
+  }
+
+  // move to a separate file
+  private static getRandomNumberFromHexStr(hexStr: string): BigNumber {
+    const gameResultBytes = hexToBytes(hexStr);
+
+    let result = new BigNumber(0);
+
+    // Only use the first 4 bytes to get the random number
+    for (let i = 0; i < 4; i++) {
+      const value = gameResultBytes[i];
+
+      result = result.plus(new BigNumber(value).dividedBy(BYTE_TOTAL.pow(i + 1)));
+    }
+
+    return result;
+  }
+}