shufflecom-calculations 3.0.4 → 3.1.0

package/src/games/baccarat.spec.ts

@@ -0,0 +1,805 @@
+import { createHmac } from 'crypto';
+import BigNumber from 'bignumber.js';
+import { CardGames, CardValue, Suits } from './cardGames';
+import { Baccarat, BaccaratBet, BaccaratBetType, BaccaratGameResult, BaccaratOutcome } from './baccarat';
+
+const ci = (value: CardValue, suit: Suits): number => CardGames.getCardIndexFromDetails({ value, suit });
+
+const hexString = (serverSeed: string, clientSeed: string, nonce: string): string => {
+  const hmac = createHmac('sha256', serverSeed);
+  hmac.update(`${clientSeed}:${nonce}:0`);
+  return hmac.digest('hex');
+};
+
+const mockResult = (
+  playerCards: number[],
+  bankerCards: number[],
+  playerHandValue: number,
+  bankerHandValue: number,
+  outcome: BaccaratOutcome,
+): BaccaratGameResult => ({ playerCards, bankerCards, playerHandValue, bankerHandValue, outcome });
+
+const bet = (type: BaccaratBetType, amount: number): BaccaratBet => ({ type, amount: new BigNumber(amount) });
+
+const SEED1 = {
+  serverSeed: 'ebd3ff712ee7ed3cabe3753146f95847b017f847758ed254c531ff0d45686cea',
+  clientSeed: 'pf4jl5q97q',
+};
+
+const SEED2 = {
+  serverSeed: '652fb02cbce322c4232a9032d905ca580c77ed9cf4850ba6ce9990527d37949f',
+  clientSeed: 'l5sgv5cutr',
+};
+
+describe('Baccarat', () => {
+  describe('getBaccaratCardValue', () => {
+    it('returns face value for 2–9', () => {
+      expect(Baccarat.getBaccaratCardValue(0)).toBe(2);
+      expect(Baccarat.getBaccaratCardValue(28)).toBe(9);
+      expect(Baccarat.getBaccaratCardValue(20)).toBe(7);
+    });
+
+    it('returns 0 for 10, J, Q, K', () => {
+      expect(Baccarat.getBaccaratCardValue(32)).toBe(0);
+      expect(Baccarat.getBaccaratCardValue(37)).toBe(0);
+      expect(Baccarat.getBaccaratCardValue(42)).toBe(0);
+      expect(Baccarat.getBaccaratCardValue(47)).toBe(0);
+    });
+
+    it('returns 1 for Ace', () => {
+      expect(Baccarat.getBaccaratCardValue(48)).toBe(1);
+      expect(Baccarat.getBaccaratCardValue(51)).toBe(1);
+    });
+  });
+
+  describe('calcHandValue', () => {
+    it('returns sum of card values mod 10', () => {
+      expect(Baccarat.calcHandValue([0, 28])).toBe(1);
+      expect(Baccarat.calcHandValue([25, 49])).toBe(9);
+      expect(Baccarat.calcHandValue([20, 35])).toBe(7);
+      expect(Baccarat.calcHandValue([36, 44])).toBe(0);
+    });
+
+    it('handles three-card hands correctly', () => {
+      expect(Baccarat.calcHandValue([0, 28, 45])).toBe(1);
+      expect(Baccarat.calcHandValue([14, 39, 3])).toBe(7);
+    });
+  });
+
+  describe('isNatural', () => {
+    it('returns true only for 8 and 9', () => {
+      expect(Baccarat.isNatural(8, [ci('8', Suits.CLUBS), ci('K', Suits.HEARTS)])).toBe(true);
+      expect(Baccarat.isNatural(9, [ci('9', Suits.CLUBS), ci('K', Suits.HEARTS)])).toBe(true);
+      expect(Baccarat.isNatural(7, [ci('7', Suits.CLUBS), ci('K', Suits.HEARTS)])).toBe(false);
+      expect(Baccarat.isNatural(0, [ci('2', Suits.CLUBS), ci('K', Suits.HEARTS)])).toBe(false);
+      expect(Baccarat.isNatural(8, [ci('2', Suits.CLUBS), ci('10', Suits.HEARTS), ci('6', Suits.DIAMONDS)])).toBe(false);
+      expect(Baccarat.isNatural(9, [ci('3', Suits.CLUBS), ci('5', Suits.HEARTS), ci('A', Suits.DIAMONDS)])).toBe(false);
+    });
+  });
+
+  describe('hasPair', () => {
+    it('returns true when first two cards share the same rank', () => {
+      expect(Baccarat.hasPair([ci('7', Suits.CLUBS), ci('7', Suits.HEARTS)])).toBe(true);
+    });
+
+    it('returns true for a perfect pair (identical cards)', () => {
+      expect(Baccarat.hasPair([ci('7', Suits.CLUBS), ci('7', Suits.CLUBS)])).toBe(true);
+    });
+
+    it('returns false when ranks differ', () => {
+      expect(Baccarat.hasPair([ci('7', Suits.CLUBS), ci('8', Suits.CLUBS)])).toBe(false);
+    });
+  });
+
+  describe('hasPerfectPair', () => {
+    it('returns true only when both cards are the exact same index', () => {
+      const card = ci('7', Suits.CLUBS);
+      expect(Baccarat.hasPerfectPair([card, card])).toBe(true);
+    });
+
+    it('returns false when ranks match but suits differ', () => {
+      expect(Baccarat.hasPerfectPair([ci('7', Suits.CLUBS), ci('7', Suits.HEARTS)])).toBe(false);
+    });
+  });
+
+  describe('getGameResult', () => {
+    it('banker wins — player draws third, banker does not (nonce 2, SEED1)', () => {
+      const result = Baccarat.getGameResult(hexString(SEED1.serverSeed, SEED1.clientSeed, '2'));
+      expect(result.playerHandValue).toBe(2);
+      expect(result.playerCards).toHaveLength(3);
+      expect(result.bankerHandValue).toBe(6);
+      expect(result.bankerCards).toHaveLength(2);
+      expect(result.outcome).toBe(BaccaratOutcome.BANKER_WIN);
+    });
+
+    it('player wins — both hands draw third card (nonce 3, SEED1)', () => {
+      const result = Baccarat.getGameResult(hexString(SEED1.serverSeed, SEED1.clientSeed, '3'));
+      expect(result.playerHandValue).toBe(4);
+      expect(result.playerCards).toHaveLength(3);
+      expect(result.bankerHandValue).toBe(1);
+      expect(result.bankerCards).toHaveLength(3);
+      expect(result.outcome).toBe(BaccaratOutcome.PLAYER_WIN);
+    });
+
+    it('player wins — both hands draw third card (nonce 4, SEED1)', () => {
+      const result = Baccarat.getGameResult(hexString(SEED1.serverSeed, SEED1.clientSeed, '4'));
+      expect(result.playerHandValue).toBe(5);
+      expect(result.playerCards).toHaveLength(3);
+      expect(result.bankerHandValue).toBe(4);
+      expect(result.bankerCards).toHaveLength(3);
+      expect(result.outcome).toBe(BaccaratOutcome.PLAYER_WIN);
+    });
+
+    it('player wins — player stands, banker draws third (nonce 2476, SEED2)', () => {
+      const result = Baccarat.getGameResult(hexString(SEED2.serverSeed, SEED2.clientSeed, '2476'));
+      expect(result.playerHandValue).toBe(7);
+      expect(result.playerCards).toHaveLength(2);
+      expect(result.bankerHandValue).toBe(4);
+      expect(result.bankerCards).toHaveLength(3);
+      expect(result.outcome).toBe(BaccaratOutcome.PLAYER_WIN);
+    });
+  });
+
+  describe('calcBetPayouts', () => {
+    describe('main bets', () => {
+      it('player wins 1:1', () => {
+        const result = mockResult(
+          [ci('6', Suits.CLUBS), ci('3', Suits.CLUBS)],
+          [ci('2', Suits.CLUBS), ci('3', Suits.DIAMONDS)],
+          9,
+          5,
+          BaccaratOutcome.PLAYER_WIN,
+        );
+        const { payout, multiplier } = Baccarat.calcBetPayouts([bet(BaccaratBetType.PLAYER, 100)], result);
+        expect(payout.toNumber()).toBe(200);
+        expect(multiplier.toNumber()).toBe(2);
+      });
+
+      it('banker wins with 0.95:1 commission', () => {
+        const result = mockResult(
+          [ci('3', Suits.CLUBS), ci('A', Suits.DIAMONDS)],
+          [ci('8', Suits.CLUBS), ci('Q', Suits.DIAMONDS)],
+          4,
+          8,
+          BaccaratOutcome.BANKER_WIN,
+        );
+        const { payout, multiplier } = Baccarat.calcBetPayouts([bet(BaccaratBetType.BANKER, 100)], result);
+        expect(payout.toNumber()).toBe(195);
+        expect(multiplier.toNumber()).toBe(1.95);
+      });
+
+      it('player bet pushes on tie', () => {
+        const result = mockResult(
+          [ci('3', Suits.CLUBS), ci('3', Suits.DIAMONDS)],
+          [ci('2', Suits.CLUBS), ci('4', Suits.DIAMONDS)],
+          6,
+          6,
+          BaccaratOutcome.TIE,
+        );
+        const { payout, multiplier } = Baccarat.calcBetPayouts([bet(BaccaratBetType.PLAYER, 100)], result);
+        expect(payout.toNumber()).toBe(100);
+        expect(multiplier.toNumber()).toBe(1);
+      });
+
+      it('banker bet pushes on tie', () => {
+        const result = mockResult(
+          [ci('3', Suits.CLUBS), ci('3', Suits.DIAMONDS)],
+          [ci('4', Suits.CLUBS), ci('2', Suits.DIAMONDS)],
+          6,
+          6,
+          BaccaratOutcome.TIE,
+        );
+        const { payout, multiplier } = Baccarat.calcBetPayouts([bet(BaccaratBetType.BANKER, 100)], result);
+        expect(payout.toNumber()).toBe(100);
+        expect(multiplier.toNumber()).toBe(1);
+      });
+
+      it('losing bet returns 0', () => {
+        const result = mockResult(
+          [ci('3', Suits.CLUBS), ci('A', Suits.DIAMONDS)],
+          [ci('8', Suits.CLUBS), ci('Q', Suits.DIAMONDS)],
+          4,
+          8,
+          BaccaratOutcome.BANKER_WIN,
+        );
+        const { payout, multiplier } = Baccarat.calcBetPayouts([bet(BaccaratBetType.PLAYER, 100)], result);
+        expect(payout.toNumber()).toBe(0);
+        expect(multiplier.toNumber()).toBe(0);
+      });
+    });
+
+    describe('tie bet', () => {
+      it('tie pays 8:1', () => {
+        const result = mockResult(
+          [ci('3', Suits.CLUBS), ci('3', Suits.DIAMONDS)],
+          [ci('2', Suits.CLUBS), ci('4', Suits.DIAMONDS)],
+          6,
+          6,
+          BaccaratOutcome.TIE,
+        );
+        const { payout, multiplier } = Baccarat.calcBetPayouts([bet(BaccaratBetType.TIE, 50)], result);
+        expect(payout.toNumber()).toBe(450);
+        expect(multiplier.toNumber()).toBe(9);
+      });
+
+      it('tie bet loses when player wins', () => {
+        const result = mockResult(
+          [ci('6', Suits.CLUBS), ci('3', Suits.CLUBS)],
+          [ci('2', Suits.CLUBS), ci('3', Suits.DIAMONDS)],
+          9,
+          5,
+          BaccaratOutcome.PLAYER_WIN,
+        );
+        const { payout } = Baccarat.calcBetPayouts([bet(BaccaratBetType.TIE, 50)], result);
+        expect(payout.toNumber()).toBe(0);
+      });
+
+      it('tie bet loses when banker wins', () => {
+        const result = mockResult(
+          [ci('3', Suits.CLUBS), ci('A', Suits.DIAMONDS)],
+          [ci('8', Suits.CLUBS), ci('Q', Suits.DIAMONDS)],
+          4,
+          8,
+          BaccaratOutcome.BANKER_WIN,
+        );
+        const { payout } = Baccarat.calcBetPayouts([bet(BaccaratBetType.TIE, 50)], result);
+        expect(payout.toNumber()).toBe(0);
+      });
+    });
+
+    describe('pair side bets', () => {
+      it('P Pair pays 11:1 when player has a pair', () => {
+        const result = mockResult(
+          [ci('4', Suits.CLUBS), ci('4', Suits.HEARTS)],
+          [ci('3', Suits.CLUBS), ci('2', Suits.DIAMONDS)],
+          8,
+          5,
+          BaccaratOutcome.PLAYER_WIN,
+        );
+        const { payout, multiplier } = Baccarat.calcBetPayouts([bet(BaccaratBetType.PLAYER_PAIR, 10)], result);
+        expect(payout.toNumber()).toBe(120);
+        expect(multiplier.toNumber()).toBe(12);
+      });
+
+      it('P Pair pays 11:1 when player has a pair but banker wins', () => {
+        const result = mockResult(
+          [ci('7', Suits.CLUBS), ci('7', Suits.HEARTS), ci('2', Suits.DIAMONDS)],
+          [ci('3', Suits.DIAMONDS), ci('4', Suits.CLUBS)],
+          6,
+          7,
+          BaccaratOutcome.BANKER_WIN,
+        );
+        const { payout, multiplier } = Baccarat.calcBetPayouts([bet(BaccaratBetType.PLAYER_PAIR, 10)], result);
+        expect(payout.toNumber()).toBe(120);
+        expect(multiplier.toNumber()).toBe(12);
+      });
+
+      it('P Pair loses when player has no pair', () => {
+        const result = mockResult(
+          [ci('4', Suits.CLUBS), ci('3', Suits.DIAMONDS)],
+          [ci('A', Suits.CLUBS), ci('2', Suits.DIAMONDS), ci('3', Suits.HEARTS)],
+          7,
+          6,
+          BaccaratOutcome.PLAYER_WIN,
+        );
+        const { payout } = Baccarat.calcBetPayouts([bet(BaccaratBetType.PLAYER_PAIR, 10)], result);
+        expect(payout.toNumber()).toBe(0);
+      });
+
+      it('P Pair loses when banker has a pair but player does not', () => {
+        const result = mockResult(
+          [ci('7', Suits.CLUBS), ci('9', Suits.CLUBS)],
+          [ci('3', Suits.CLUBS), ci('3', Suits.HEARTS)],
+          6,
+          6,
+          BaccaratOutcome.TIE,
+        );
+        const { payout } = Baccarat.calcBetPayouts([bet(BaccaratBetType.PLAYER_PAIR, 10)], result);
+        expect(payout.toNumber()).toBe(0);
+      });
+
+      it('P Pair pays 11:1 when it is a tie', () => {
+        const result = mockResult(
+          [ci('7', Suits.CLUBS), ci('7', Suits.HEARTS), ci('2', Suits.DIAMONDS)],
+          [ci('3', Suits.CLUBS), ci('3', Suits.HEARTS)],
+          6,
+          6,
+          BaccaratOutcome.TIE,
+        );
+        const { payout, multiplier } = Baccarat.calcBetPayouts([bet(BaccaratBetType.PLAYER_PAIR, 10)], result);
+        expect(payout.toNumber()).toBe(120);
+        expect(multiplier.toNumber()).toBe(12);
+      });
+
+      it('B Pair pays 11:1 when banker has a pair', () => {
+        const result = mockResult(
+          [ci('3', Suits.CLUBS), ci('2', Suits.DIAMONDS)],
+          [ci('9', Suits.DIAMONDS), ci('9', Suits.HEARTS)],
+          5,
+          8,
+          BaccaratOutcome.BANKER_WIN,
+        );
+        const { payout, multiplier } = Baccarat.calcBetPayouts([bet(BaccaratBetType.BANKER_PAIR, 10)], result);
+        expect(payout.toNumber()).toBe(120);
+        expect(multiplier.toNumber()).toBe(12);
+      });
+
+      it('B Pair pays 11:1 when banker has a pair but loses', () => {
+        const result = mockResult(
+          [ci('3', Suits.CLUBS), ci('4', Suits.DIAMONDS)],
+          [ci('6', Suits.DIAMONDS), ci('6', Suits.HEARTS), ci('10', Suits.CLUBS)],
+          7,
+          2,
+          BaccaratOutcome.PLAYER_WIN,
+        );
+        const { payout, multiplier } = Baccarat.calcBetPayouts([bet(BaccaratBetType.BANKER_PAIR, 10)], result);
+        expect(payout.toNumber()).toBe(120);
+        expect(multiplier.toNumber()).toBe(12);
+      });
+
+      it('B Pair pays 11:1 when both banker and player have a pair', () => {
+        const result = mockResult(
+          [ci('3', Suits.CLUBS), ci('3', Suits.HEARTS)],
+          [ci('6', Suits.DIAMONDS), ci('6', Suits.HEARTS), ci('10', Suits.CLUBS)],
+          6,
+          2,
+          BaccaratOutcome.PLAYER_WIN,
+        );
+        const { payout, multiplier } = Baccarat.calcBetPayouts([bet(BaccaratBetType.BANKER_PAIR, 10)], result);
+        expect(payout.toNumber()).toBe(120);
+        expect(multiplier.toNumber()).toBe(12);
+      });
+
+      it('B Pair loses when player has a pair but banker does not', () => {
+        const result = mockResult(
+          [ci('3', Suits.CLUBS), ci('3', Suits.HEARTS)],
+          [ci('10', Suits.DIAMONDS), ci('7', Suits.HEARTS)],
+          6,
+          7,
+          BaccaratOutcome.BANKER_WIN,
+        );
+        const { payout } = Baccarat.calcBetPayouts([bet(BaccaratBetType.BANKER_PAIR, 10)], result);
+        expect(payout.toNumber()).toBe(0);
+      });
+
+      it('Either Pair pays 5:1 when player has a pair', () => {
+        const result = mockResult(
+          [ci('4', Suits.CLUBS), ci('4', Suits.HEARTS)],
+          [ci('3', Suits.CLUBS), ci('2', Suits.DIAMONDS)],
+          8,
+          5,
+          BaccaratOutcome.PLAYER_WIN,
+        );
+        const { payout, multiplier } = Baccarat.calcBetPayouts([bet(BaccaratBetType.EITHER_PAIR, 10)], result);
+        expect(payout.toNumber()).toBe(60);
+        expect(multiplier.toNumber()).toBe(6);
+      });
+
+      it('Either Pair pays 5:1 when banker has a pair', () => {
+        const result = mockResult(
+          [ci('3', Suits.CLUBS), ci('2', Suits.DIAMONDS)],
+          [ci('9', Suits.DIAMONDS), ci('9', Suits.HEARTS)],
+          5,
+          8,
+          BaccaratOutcome.BANKER_WIN,
+        );
+        const { payout, multiplier } = Baccarat.calcBetPayouts([bet(BaccaratBetType.EITHER_PAIR, 10)], result);
+        expect(payout.toNumber()).toBe(60);
+        expect(multiplier.toNumber()).toBe(6);
+      });
+
+      it('Either Pair pays 5:1 when both hands have a pair', () => {
+        const result = mockResult(
+          [ci('4', Suits.CLUBS), ci('4', Suits.HEARTS)],
+          [ci('9', Suits.DIAMONDS), ci('9', Suits.HEARTS)],
+          8,
+          8,
+          BaccaratOutcome.TIE,
+        );
+        const { payout, multiplier } = Baccarat.calcBetPayouts([bet(BaccaratBetType.EITHER_PAIR, 10)], result);
+        expect(payout.toNumber()).toBe(60);
+        expect(multiplier.toNumber()).toBe(6);
+      });
+
+      it('Either Pair loses when neither hand has a pair', () => {
+        const result = mockResult(
+          [ci('4', Suits.CLUBS), ci('3', Suits.DIAMONDS)],
+          [ci('A', Suits.CLUBS), ci('2', Suits.DIAMONDS), ci('3', Suits.HEARTS)],
+          7,
+          6,
+          BaccaratOutcome.PLAYER_WIN,
+        );
+        const { payout } = Baccarat.calcBetPayouts([bet(BaccaratBetType.EITHER_PAIR, 10)], result);
+        expect(payout.toNumber()).toBe(0);
+      });
+    });
+
+    describe('perfect pair side bet', () => {
+      it('pays 25:1 when exactly one hand has a perfect pair', () => {
+        const card = ci('4', Suits.CLUBS);
+        const result = mockResult([card, card], [ci('3', Suits.CLUBS), ci('2', Suits.DIAMONDS)], 8, 5, BaccaratOutcome.PLAYER_WIN);
+        const { payout, multiplier } = Baccarat.calcBetPayouts([bet(BaccaratBetType.PERFECT_PAIR, 10)], result);
+        expect(payout.toNumber()).toBe(260);
+        expect(multiplier.toNumber()).toBe(26);
+      });
+
+      it('pays 25:1 when player has a non-perfect pair but banker has a non-perfect pair', () => {
+        const bankerCard = ci('4', Suits.CLUBS);
+        const result = mockResult([ci('K', Suits.HEARTS), ci('K', Suits.DIAMONDS)], [bankerCard, bankerCard], 0, 8, BaccaratOutcome.BANKER_WIN);
+        const { payout, multiplier } = Baccarat.calcBetPayouts([bet(BaccaratBetType.PERFECT_PAIR, 10)], result);
+        expect(payout.toNumber()).toBe(260);
+        expect(multiplier.toNumber()).toBe(26);
+      });
+
+      it('pays 200:1 when both hands have a perfect pair', () => {
+        const playerCard = ci('4', Suits.CLUBS);
+        const bankerCard = ci('K', Suits.DIAMONDS);
+        const result = mockResult([playerCard, playerCard], [bankerCard, bankerCard], 8, 0, BaccaratOutcome.PLAYER_WIN);
+        const { payout, multiplier } = Baccarat.calcBetPayouts([bet(BaccaratBetType.PERFECT_PAIR, 10)], result);
+        expect(payout.toNumber()).toBe(2010);
+        expect(multiplier.toNumber()).toBe(201);
+      });
+
+      it('loses when player has a non-perfect pair and banker does not have a pair', () => {
+        const result = mockResult(
+          [ci('4', Suits.CLUBS), ci('4', Suits.HEARTS)],
+          [ci('3', Suits.CLUBS), ci('2', Suits.DIAMONDS)],
+          8,
+          5,
+          BaccaratOutcome.PLAYER_WIN,
+        );
+        const { payout } = Baccarat.calcBetPayouts([bet(BaccaratBetType.PERFECT_PAIR, 10)], result);
+        expect(payout.toNumber()).toBe(0);
+      });
+    });
+
+    describe('bonus side bets', () => {
+      it('P Bonus pays 1:1 on a natural player win', () => {
+        const result = mockResult(
+          [ci('8', Suits.CLUBS), ci('A', Suits.DIAMONDS)],
+          [ci('3', Suits.CLUBS), ci('2', Suits.DIAMONDS)],
+          9,
+          5,
+          BaccaratOutcome.PLAYER_WIN,
+        );
+        const { payout, multiplier } = Baccarat.calcBetPayouts([bet(BaccaratBetType.PLAYER_BONUS, 10)], result);
+        expect(payout.toNumber()).toBe(20);
+        expect(multiplier.toNumber()).toBe(2);
+      });
+
+      it('B Bonus pays 1:1 on a natural banker win', () => {
+        const result = mockResult(
+          [ci('3', Suits.CLUBS), ci('A', Suits.DIAMONDS)],
+          [ci('8', Suits.CLUBS), ci('A', Suits.CLUBS)],
+          4,
+          9,
+          BaccaratOutcome.BANKER_WIN,
+        );
+        const { payout, multiplier } = Baccarat.calcBetPayouts([bet(BaccaratBetType.BANKER_BONUS, 10)], result);
+        expect(payout.toNumber()).toBe(20);
+        expect(multiplier.toNumber()).toBe(2);
+      });
+
+      it('P Bonus loses when player loses', () => {
+        const result = mockResult(
+          [ci('3', Suits.CLUBS), ci('10', Suits.DIAMONDS), ci('Q', Suits.HEARTS)],
+          [ci('3', Suits.CLUBS), ci('4', Suits.DIAMONDS)],
+          3,
+          7,
+          BaccaratOutcome.BANKER_WIN,
+        );
+        const { payout } = Baccarat.calcBetPayouts([bet(BaccaratBetType.PLAYER_BONUS, 10)], result);
+        expect(payout.toNumber()).toBe(0);
+      });
+
+      it('P Bonus loses on a non-natural win by fewer than 4 points', () => {
+        const result = mockResult(
+          [ci('4', Suits.CLUBS), ci('3', Suits.DIAMONDS)],
+          [ci('A', Suits.CLUBS), ci('2', Suits.DIAMONDS), ci('3', Suits.HEARTS)],
+          7,
+          6,
+          BaccaratOutcome.PLAYER_WIN,
+        );
+        const { payout } = Baccarat.calcBetPayouts([bet(BaccaratBetType.PLAYER_BONUS, 10)], result);
+        expect(payout.toNumber()).toBe(0);
+      });
+
+      it('P Bonus pays 1:1 on a non-natural banker win by 4', () => {
+        const result = mockResult(
+          [ci('4', Suits.CLUBS), ci('10', Suits.DIAMONDS), ci('Q', Suits.HEARTS)],
+          [ci('A', Suits.CLUBS), ci('2', Suits.DIAMONDS), ci('7', Suits.HEARTS)],
+          4,
+          0,
+          BaccaratOutcome.PLAYER_WIN,
+        );
+        const { payout, multiplier } = Baccarat.calcBetPayouts([bet(BaccaratBetType.PLAYER_BONUS, 10)], result);
+        expect(payout.toNumber()).toBe(20);
+        expect(multiplier.toNumber()).toBe(2);
+      });
+
+      it('B Bonus pays 2:1 on a non-natural banker win by 5', () => {
+        const result = mockResult(
+          [ci('A', Suits.CLUBS), ci('2', Suits.DIAMONDS), ci('8', Suits.HEARTS)],
+          [ci('3', Suits.DIAMONDS), ci('3', Suits.HEARTS)],
+          1,
+          6,
+          BaccaratOutcome.BANKER_WIN,
+        );
+        const { payout, multiplier } = Baccarat.calcBetPayouts([bet(BaccaratBetType.BANKER_BONUS, 10)], result);
+        expect(payout.toNumber()).toBe(30);
+        expect(multiplier.toNumber()).toBe(3);
+      });
+
+      it('P Bonus pays 4:1 on non-natural win by 6', () => {
+        const result = mockResult(
+          [ci('4', Suits.CLUBS), ci('3', Suits.DIAMONDS)],
+          [ci('A', Suits.CLUBS), ci('10', Suits.DIAMONDS), ci('Q', Suits.HEARTS)],
+          7,
+          1,
+          BaccaratOutcome.PLAYER_WIN,
+        );
+        const { payout, multiplier } = Baccarat.calcBetPayouts([bet(BaccaratBetType.PLAYER_BONUS, 10)], result);
+        expect(payout.toNumber()).toBe(50);
+        expect(multiplier.toNumber()).toBe(5);
+      });
+
+      it('B Bonus pays 6:1 on a non-natural banker win by 7', () => {
+        const result = mockResult(
+          [ci('A', Suits.CLUBS), ci('2', Suits.DIAMONDS), ci('8', Suits.HEARTS)],
+          [ci('2', Suits.DIAMONDS), ci('A', Suits.HEARTS), ci('5', Suits.CLUBS)],
+          1,
+          8,
+          BaccaratOutcome.BANKER_WIN,
+        );
+        const { payout, multiplier } = Baccarat.calcBetPayouts([bet(BaccaratBetType.BANKER_BONUS, 10)], result);
+        expect(payout.toNumber()).toBe(70);
+        expect(multiplier.toNumber()).toBe(7);
+      });
+
+      it('P Bonus pays 10:1 on non-natural win by 8', () => {
+        const result = mockResult(
+          [ci('3', Suits.CLUBS), ci('A', Suits.DIAMONDS), ci('5', Suits.HEARTS)],
+          [ci('A', Suits.CLUBS), ci('A', Suits.DIAMONDS), ci('9', Suits.HEARTS)],
+          9,
+          1,
+          BaccaratOutcome.PLAYER_WIN,
+        );
+        const { payout, multiplier } = Baccarat.calcBetPayouts([bet(BaccaratBetType.PLAYER_BONUS, 10)], result);
+        expect(payout.toNumber()).toBe(110);
+        expect(multiplier.toNumber()).toBe(11);
+      });
+
+      it('B Bonus pays 30:1 on a non-natural banker win by 9', () => {
+        const result = mockResult(
+          [ci('A', Suits.CLUBS), ci('4', Suits.DIAMONDS), ci('5', Suits.HEARTS)],
+          [ci('3', Suits.DIAMONDS), ci('3', Suits.HEARTS), ci('3', Suits.CLUBS)],
+          0,
+          9,
+          BaccaratOutcome.BANKER_WIN,
+        );
+        const { payout, multiplier } = Baccarat.calcBetPayouts([bet(BaccaratBetType.BANKER_BONUS, 10)], result);
+        expect(payout.toNumber()).toBe(310);
+        expect(multiplier.toNumber()).toBe(31);
+      });
+
+      it('B Bonus loses when player wins', () => {
+        const result = mockResult(
+          [ci('4', Suits.CLUBS), ci('3', Suits.DIAMONDS)],
+          [ci('A', Suits.CLUBS), ci('A', Suits.DIAMONDS), ci('10', Suits.HEARTS)],
+          7,
+          2,
+          BaccaratOutcome.PLAYER_WIN,
+        );
+        const { payout } = Baccarat.calcBetPayouts([bet(BaccaratBetType.BANKER_BONUS, 10)], result);
+        expect(payout.toNumber()).toBe(0);
+      });
+
+      it('P Bonus and B Bonus both lose on a non-natural tie', () => {
+        const result = mockResult(
+          [ci('3', Suits.CLUBS), ci('3', Suits.DIAMONDS)],
+          [ci('2', Suits.CLUBS), ci('4', Suits.DIAMONDS)],
+          6,
+          6,
+          BaccaratOutcome.TIE,
+        );
+        const { payout, multiplier } = Baccarat.calcBetPayouts(
+          [bet(BaccaratBetType.PLAYER_BONUS, 10), bet(BaccaratBetType.BANKER_BONUS, 10)],
+          result,
+        );
+        expect(payout.toNumber()).toBe(0);
+        expect(multiplier.toNumber()).toBe(0);
+      });
+
+      it('both P Bonus and B Bonus push on natural tie', () => {
+        const result = mockResult(
+          [ci('8', Suits.CLUBS), ci('Q', Suits.DIAMONDS)],
+          [ci('8', Suits.DIAMONDS), ci('Q', Suits.HEARTS)],
+          8,
+          8,
+          BaccaratOutcome.TIE,
+        );
+        const { payout, multiplier } = Baccarat.calcBetPayouts(
+          [bet(BaccaratBetType.PLAYER_BONUS, 10), bet(BaccaratBetType.BANKER_BONUS, 10)],
+          result,
+        );
+        expect(payout.toNumber()).toBe(20);
+        expect(multiplier.toNumber()).toBe(1);
+      });
+    });
+
+    describe('multiple simultaneous bets', () => {
+      it('player win + player pair + losing banker and tie bets: only winning bets contribute', () => {
+        const result = mockResult(
+          [ci('4', Suits.CLUBS), ci('4', Suits.HEARTS)],
+          [ci('3', Suits.CLUBS), ci('2', Suits.DIAMONDS)],
+          8,
+          5,
+          BaccaratOutcome.PLAYER_WIN,
+        );
+        const { payout, multiplier } = Baccarat.calcBetPayouts(
+          [bet(BaccaratBetType.PLAYER, 10), bet(BaccaratBetType.PLAYER_PAIR, 10), bet(BaccaratBetType.BANKER, 10), bet(BaccaratBetType.TIE, 10)],
+          result,
+        );
+        expect(payout.toNumber()).toBe(140);
+        expect(multiplier.toNumber()).toBe(3.5);
+      });
+
+      it('player pair + either pair + losing banker pair: only player-side pair bets pay', () => {
+        const result = mockResult(
+          [ci('4', Suits.CLUBS), ci('4', Suits.HEARTS)],
+          [ci('3', Suits.CLUBS), ci('2', Suits.DIAMONDS)],
+          8,
+          5,
+          BaccaratOutcome.PLAYER_WIN,
+        );
+        const { payout, multiplier } = Baccarat.calcBetPayouts(
+          [bet(BaccaratBetType.PLAYER_PAIR, 10), bet(BaccaratBetType.EITHER_PAIR, 10), bet(BaccaratBetType.BANKER_PAIR, 10)],
+          result,
+        );
+        expect(payout.toNumber()).toBe(180);
+        expect(multiplier.toNumber()).toBe(6);
+      });
+
+      it('player pair + perfect pair + either pair + losing banker bet: all pair bets pay, main banker bet does not', () => {
+        const card = ci('4', Suits.CLUBS);
+        const result = mockResult([card, card], [ci('3', Suits.CLUBS), ci('2', Suits.DIAMONDS)], 8, 5, BaccaratOutcome.PLAYER_WIN);
+        const { payout, multiplier } = Baccarat.calcBetPayouts(
+          [
+            bet(BaccaratBetType.PLAYER_PAIR, 10),
+            bet(BaccaratBetType.PERFECT_PAIR, 10),
+            bet(BaccaratBetType.EITHER_PAIR, 10),
+            bet(BaccaratBetType.BANKER, 10),
+          ],
+          result,
+        );
+        expect(payout.toNumber()).toBe(440);
+        expect(multiplier.toNumber()).toBe(11);
+      });
+
+      it('player pair + banker pair + perfect pair: all three pay when both hands have perfect pairs', () => {
+        const playerCard = ci('4', Suits.CLUBS);
+        const bankerCard = ci('K', Suits.DIAMONDS);
+        const result = mockResult([playerCard, playerCard], [bankerCard, bankerCard], 8, 0, BaccaratOutcome.PLAYER_WIN);
+        const { payout, multiplier } = Baccarat.calcBetPayouts(
+          [bet(BaccaratBetType.PLAYER_PAIR, 10), bet(BaccaratBetType.BANKER_PAIR, 10), bet(BaccaratBetType.PERFECT_PAIR, 10)],
+          result,
+        );
+        expect(payout.toNumber()).toBe(2250);
+        expect(multiplier.toNumber()).toBe(75);
+      });
+
+      it('player pair + banker pair + either pair + tie bet + player push on natural tie: pair and tie win, player pushes', () => {
+        const result = mockResult(
+          [ci('4', Suits.CLUBS), ci('4', Suits.HEARTS)],
+          [ci('9', Suits.DIAMONDS), ci('9', Suits.HEARTS)],
+          8,
+          8,
+          BaccaratOutcome.TIE,
+        );
+        const { payout, multiplier } = Baccarat.calcBetPayouts(
+          [
+            bet(BaccaratBetType.PLAYER_PAIR, 10),
+            bet(BaccaratBetType.BANKER_PAIR, 10),
+            bet(BaccaratBetType.EITHER_PAIR, 10),
+            bet(BaccaratBetType.TIE, 10),
+            bet(BaccaratBetType.PLAYER, 10),
+          ],
+          result,
+        );
+        expect(payout.toNumber()).toBe(400);
+        expect(multiplier.toNumber()).toBe(8);
+      });
+
+      it('player bonus + player pair + losing banker-side bets: only player-side bets pay', () => {
+        const result = mockResult(
+          [ci('4', Suits.CLUBS), ci('4', Suits.HEARTS)],
+          [ci('3', Suits.CLUBS), ci('2', Suits.DIAMONDS)],
+          8,
+          5,
+          BaccaratOutcome.PLAYER_WIN,
+        );
+        const { payout, multiplier } = Baccarat.calcBetPayouts(
+          [
+            bet(BaccaratBetType.PLAYER_BONUS, 10),
+            bet(BaccaratBetType.PLAYER_PAIR, 10),
+            bet(BaccaratBetType.BANKER_BONUS, 10),
+            bet(BaccaratBetType.BANKER_PAIR, 10),
+          ],
+          result,
+        );
+        expect(payout.toNumber()).toBe(140);
+        expect(multiplier.toNumber()).toBe(3.5);
+      });
+
+      it('player pair + player bonus + losing banker and banker bonus: opposite-side bets contribute zero', () => {
+        const result = mockResult(
+          [ci('7', Suits.CLUBS), ci('7', Suits.HEARTS), ci('2', Suits.DIAMONDS)],
+          [ci('10', Suits.CLUBS), ci('Q', Suits.DIAMONDS), ci('10', Suits.HEARTS)],
+          6,
+          0,
+          BaccaratOutcome.PLAYER_WIN,
+        );
+        const { payout, multiplier } = Baccarat.calcBetPayouts(
+          [
+            bet(BaccaratBetType.PLAYER_PAIR, 10),
+            bet(BaccaratBetType.PLAYER_BONUS, 10),
+            bet(BaccaratBetType.BANKER, 10),
+            bet(BaccaratBetType.BANKER_BONUS, 10),
+          ],
+          result,
+        );
+        expect(payout.toNumber()).toBe(170);
+        expect(multiplier.toNumber()).toBe(4.25);
+      });
+
+      it('banker pair + banker bonus + all losing player-side bets: only banker bets pay', () => {
+        const result = mockResult(
+          [ci('A', Suits.CLUBS), ci('2', Suits.DIAMONDS), ci('8', Suits.HEARTS)],
+          [ci('3', Suits.DIAMONDS), ci('3', Suits.HEARTS)],
+          1,
+          6,
+          BaccaratOutcome.BANKER_WIN,
+        );
+        const { payout, multiplier } = Baccarat.calcBetPayouts(
+          [
+            bet(BaccaratBetType.BANKER_PAIR, 10),
+            bet(BaccaratBetType.BANKER_BONUS, 10),
+            bet(BaccaratBetType.PLAYER, 10),
+            bet(BaccaratBetType.TIE, 10),
+            bet(BaccaratBetType.PLAYER_PAIR, 10),
+            bet(BaccaratBetType.PLAYER_BONUS, 10),
+          ],
+          result,
+        );
+        expect(payout.toNumber()).toBe(150);
+        expect(multiplier.toNumber()).toBe(2.5);
+      });
+
+      it('losing main banker bet + winning banker pair + other losing bets: only banker pair pays', () => {
+        const result = mockResult(
+          [ci('4', Suits.CLUBS), ci('3', Suits.DIAMONDS)],
+          [ci('6', Suits.DIAMONDS), ci('6', Suits.HEARTS), ci('10', Suits.CLUBS)],
+          7,
+          2,
+          BaccaratOutcome.PLAYER_WIN,
+        );
+        const { payout, multiplier } = Baccarat.calcBetPayouts(
+          [bet(BaccaratBetType.BANKER, 10), bet(BaccaratBetType.BANKER_PAIR, 10), bet(BaccaratBetType.TIE, 10), bet(BaccaratBetType.PLAYER_PAIR, 10)],
+          result,
+        );
+        expect(payout.toNumber()).toBe(120);
+        expect(multiplier.toNumber()).toBe(3);
+      });
+    });
+  });
+
+  describe('getGameOutcome', () => {
+    it('returns result, payout, and multiplier for a valid game', () => {
+      const hex = hexString(SEED1.serverSeed, SEED1.clientSeed, '2');
+      const { result, payout, multiplier } = Baccarat.getGameOutcome([bet(BaccaratBetType.BANKER, 100)], hex);
+      expect(result.outcome).toBe(BaccaratOutcome.BANKER_WIN);
+      expect(payout.toNumber()).toBe(195);
+      expect(multiplier.toNumber()).toBe(1.95);
+    });
+  });
+});