starknet 11.0.0-beta.7 → 11.0.0-beta.8

package/CHANGELOG.md

@@ -1,3 +1,17 @@
+# [11.0.0-beta.8](https://github.com/starknet-io/starknet.js/compare/v11.0.0-beta.7...v11.0.0-beta.8) (2026-08-27)
+
+### Bug Fixes
+
+- **starknetId:** accept bigAlphabet characters in isStarkDomain ([f508984](https://github.com/starknet-io/starknet.js/commit/f5089848f4b4bf526cc814f20fef1918bc67879f)), closes [#1668](https://github.com/starknet-io/starknet.js/issues/1668)
+- **starknetId:** reject names the encoder cannot represent ([76fe9b1](https://github.com/starknet-io/starknet.js/commit/76fe9b1df174d295374417a018e425ee652258c8)), closes [#1668](https://github.com/starknet-io/starknet.js/issues/1668)
+
+### BREAKING CHANGES
+
+- **starknetId:** `useEncoded` throws on any character outside the Starknet.id alphabets
+  instead of silently ignoring it, and `encodeBrotherDomain`, which calls it with no guard,
+  throws on the same input. `isStarkDomain` also rejects labels whose encoding overflows the
+  field, including every 48-character label it used to accept.
+
 # [11.0.0-beta.7](https://github.com/starknet-io/starknet.js/compare/v11.0.0-beta.6...v11.0.0-beta.7) (2026-08-26)
 
 ### Bug Fixes

package/dist/index.d.ts

@@ -9401,14 +9401,22 @@ declare namespace typedData {
  */
 declare function useDecoded(encoded: bigint[]): string;
 /**
- * Encodes a string into a bigint value.
+ * Encodes a single Starknet.id label into a bigint value.
  *
- * @param {string} decoded The string to be encoded.
+ * Only the characters of the Starknet.id alphabets are accepted: `a-z`, `0-9`, `-` and the two
+ * `bigAlphabet` characters. Any other character throws, so a mistyped name can never be silently
+ * encoded as a different, existing one.
+ *
+ * @param {string} decoded The label to be encoded, without any `.` separator nor `.stark` suffix.
  * @returns {bigint} The encoded bigint value.
+ * @throws {Error} If the label holds a character outside the Starknet.id alphabets.
  * @example
  * ```typescript
- * const result = starknetId.useEncoded("starknet.js");
+ * const result = starknetId.useEncoded("starknetjs");
  * // result = 3015206943634620n
+ *
+ * starknetId.useEncoded("Starknetjs");
+ * // throws an Error: the uppercase "S" is not a Starknet.id character
  * ```
  */
 declare function useEncoded(decoded: string): bigint;

package/dist/index.global.js

@@ -15800,6 +15800,10 @@ ${indent}}` : "}";
         const newid = (i === decoded.length - 1 ? 1 : 0) + bigAlphabet.indexOf(char);
         encoded += multiplier * BigInt(newid);
         multiplier *= bigAlphabetSize;
+      } else {
+        throw new Error(
+          `Invalid character "${char}" in a Starknet.id name: allowed characters are "${basicAlphabet}" and "${bigAlphabet}"`
+        );
       }
     }
     return encoded;
@@ -15919,9 +15923,14 @@ ${indent}}` : "}";
       return false;
     }
     return name.split(".").every((label) => {
-      return label.length > 0 && label.length <= 48 && [...label].every((char) => {
-        return char >= "a" && char <= "z" || char >= "0" && char <= "9" || char === "-";
-      });
+      if (label.length === 0 || label.length > 48) {
+        return false;
+      }
+      try {
+        return useEncoded(label) < PRIME;
+      } catch {
+        return false;
+      }
     });
   }