deterministic-dice 1.0.0 → 3.0.0

package/README.md

@@ -1,4 +1,4 @@
-# deterministic-dice
+# 🎲 deterministic-dice
 
 Deterministic random number generator seeded by a bytes32 hash.
 
@@ -17,15 +17,15 @@ const dice = new DeterministicDice(
   "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef"
 );
 
-dice.roll(15); // 0-15
-dice.roll(6); // 0-6
-dice.roll(100); // 0-100
+dice.roll(16); // 0-15
+dice.roll(6); // 0-5
+dice.roll(100); // 0-99
 ```
 
 ## How It Works
 
 1. Initialize with a bytes32 hash (with or without `0x` prefix)
-2. Call `roll(max)` to get a random number from 0 to max (inclusive)
+2. Call `roll(n)` to get a random number from 0 to n-1 (n possible values)
 3. Entropy is automatically rehashed with SHA256 when exhausted
 4. Same hash always produces the same sequence of rolls
 

package/dist/index.d.ts

@@ -6,9 +6,9 @@ export declare class DeterministicDice {
     private position;
     constructor(randomHash: string);
     /**
-     * Roll a random number from 0 to max (inclusive).
+     * Roll a random number from 0 to n-1 (n possible values).
      */
-    roll(max: number): number;
+    roll(n: number): number;
     private consumeHex;
 }
 export default DeterministicDice;

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAS;gBAEb,UAAU,EAAE,MAAM;IAO9B;;OAEG;IACH,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAezB,OAAO,CAAC,UAAU;CAYnB;AAED,eAAe,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAS;gBAEb,UAAU,EAAE,MAAM;IAO9B;;OAEG;IACH,IAAI,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM;IAevB,OAAO,CAAC,UAAU;CAcnB;AAED,eAAe,iBAAiB,CAAC"}

package/dist/index.js

@@ -1,5 +1,5 @@
-import { sha256 } from "@noble/hashes/sha256";
-import { bytesToHex } from "@noble/hashes/utils";
+import { keccak_256 } from "@noble/hashes/sha3";
+import { bytesToHex, hexToBytes } from "@noble/hashes/utils";
 /**
  * Deterministic random number generator seeded by a bytes32 hash.
  */
@@ -11,10 +11,10 @@ export class DeterministicDice {
         this.position = 0;
     }
     /**
-     * Roll a random number from 0 to max (inclusive).
+     * Roll a random number from 0 to n-1 (n possible values).
      */
-    roll(max) {
-        const range = max + 1;
+    roll(n) {
+        const range = n;
         const bitsNeeded = Math.ceil(Math.log2(range));
         const hexCharsNeeded = Math.max(1, Math.ceil(bitsNeeded / 4));
         const maxValue = Math.pow(16, hexCharsNeeded);
@@ -29,7 +29,9 @@ export class DeterministicDice {
         let result = 0;
         for (let i = 0; i < count; i++) {
             if (this.position >= this.entropy.length) {
-                this.entropy = bytesToHex(sha256(this.entropy));
+                // Convert hex string to bytes, hash the raw bytes (for Solidity parity)
+                const bytes = hexToBytes(this.entropy);
+                this.entropy = bytesToHex(keccak_256(bytes));
                 this.position = 0;
             }
             result = (result << 4) + parseInt(this.entropy[this.position], 16);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "deterministic-dice",
-  "version": "1.0.0",
+  "version": "3.0.0",
   "description": "Deterministic random number generator seeded by a bytes32 hash",
   "type": "module",
   "main": "./dist/index.js",
@@ -37,4 +37,3 @@
     "typescript": "^5.3.3"
   }
 }
-