fix(utils): reject whitespace in decodeTokenIds with helpful error (#1865)

Add explicit check for whitespace that throws a clear error message
showing the expected format: '1,2,3' or '1:5' or '1,3:5,8' (no spaces).

Co-authored-by: Claude Opus 4.5 <[email protected]>

Author: ryanio

src/utils/protocol.ts

@@ -140,6 +140,13 @@ export const decodeTokenIds = (encodedTokenIds: string): string[] => {
     return [];
   }
 
+  // Check for whitespace and provide helpful error message
+  if (/\s/.test(encodedTokenIds)) {
+    throw new Error(
+      "Invalid input format: whitespace is not allowed. Expected format: '1,2,3' or '1:5' or '1,3:5,8' (no spaces).",
+    );
+  }
+
   const validFormatRegex = /^(\d+(:\d+)?)(,\d+(:\d+)?)*$/;
 
   if (!validFormatRegex.test(encodedTokenIds)) {

test/utils/protocol.spec.ts

@@ -211,6 +211,18 @@ suite("Utils: protocol", () => {
     test("correctly decodes range where start = end", () => {
       expect(decodeTokenIds("5:5")).to.deep.equal(["5"]);
     });
+
+    test("throws error for input with whitespace", () => {
+      expect(() => decodeTokenIds(" 1,2,3")).to.throw(
+        "whitespace is not allowed",
+      );
+      expect(() => decodeTokenIds("1 : 3")).to.throw(
+        "whitespace is not allowed",
+      );
+      expect(() => decodeTokenIds("1, 2")).to.throw(
+        "whitespace is not allowed",
+      );
+    });
   });
 
   suite("getSeaportInstance", () => {