starknet 10.0.3 → 10.0.4

package/CHANGELOG.md

@@ -1,3 +1,9 @@
+## [10.0.4](https://github.com/starknet-io/starknet.js/compare/v10.0.3...v10.0.4) (2026-06-04)
+
+### Bug Fixes
+
+- add validation to cairofelt to ensure numbers are valid felt252 numbers ([f056836](https://github.com/starknet-io/starknet.js/commit/f0568369781e602a8a47dee76bb7ac13d152faaf))
+
 ## [10.0.3](https://github.com/starknet-io/starknet.js/compare/v10.0.2...v10.0.3) (2026-05-29)
 
 ### Bug Fixes

package/dist/index.d.ts

@@ -9325,12 +9325,6 @@ declare class CairoBytes31 {
     static factoryFromApiResponse(responseIterator: Iterator<string>): CairoBytes31;
 }
 
-/**
- * @deprecated use the CairoFelt252 class instead, this one is limited to ASCII strings
- * Create felt Cairo type (cairo type helper)
- * @returns format: felt-string
- */
-declare function CairoFelt(it: BigNumberish): string;
 /**
  * felt252 is the basic field element used in Cairo.
  * It corresponds to an integer in the range 0 ≤ x < P where P is a very large prime number currently equal to 2^251 + 17⋅2^192 + 1.
@@ -9349,11 +9343,18 @@ declare class CairoFelt252 {
     decodeUtf8(): string;
     toHexString(): string;
     toApiRequest(): string[];
+    static assertRange(val: bigint): void;
     static validate(data: BigNumberish | boolean | unknown): void;
     static is(data: BigNumberish | boolean | unknown): boolean;
     static isAbiType(abiType: string): boolean;
     static factoryFromApiResponse(responseIterator: Iterator<string>): CairoFelt252;
 }
+/**
+ * @deprecated use the CairoFelt252 class instead, this one is limited to ASCII strings
+ * Create felt Cairo type (cairo type helper)
+ * @returns format: felt-string
+ */
+declare function CairoFelt(it: BigNumberish): string;
 
 declare class CairoUint32 {
     data: bigint;

package/dist/index.global.js

@@ -5547,31 +5547,6 @@ ${indent}}` : "}";
   }
 
   // src/utils/cairoDataTypes/felt.ts
-  function CairoFelt(it) {
-    if (isBigInt(it) || Number.isInteger(it)) {
-      return it.toString();
-    }
-    if (isString(it)) {
-      if (isHex2(it)) {
-        return BigInt(it).toString();
-      }
-      if (isText(it)) {
-        if (!isShortString(it)) {
-          throw new Error(
-            `${it} is a long string > 31 chars. Please split it into an array of short strings.`
-          );
-        }
-        return BigInt(encodeShortString(it)).toString();
-      }
-      if (isStringWholeNumber(it)) {
-        return it;
-      }
-    }
-    if (isBoolean(it)) {
-      return `${+it}`;
-    }
-    throw new Error(`${it} can't be computed by felt()`);
-  }
   var CairoFelt252 = class _CairoFelt252 {
     /**
      * byte representation of the felt252
@@ -5610,6 +5585,9 @@ ${indent}}` : "}";
     toApiRequest() {
       return addCompiledFlag([this.toHexString()]);
     }
+    static assertRange(val) {
+      assert(val >= 0n && val < PRIME, `Value ${val} is out of felt252 range [0, ${PRIME})`);
+    }
     static validate(data) {
       assert(data !== null, "null value is not allowed for felt252");
       assert(data !== void 0, "undefined value is not allowed for felt252");
@@ -5619,7 +5597,7 @@ ${indent}}` : "}";
       );
       const value = _CairoFelt252.__processData(data);
       const bn = uint8ArrayToBigInt(value);
-      assert(bn >= 0n && bn < PRIME, `Value ${value} is out of felt252 range [0, ${PRIME})`);
+      _CairoFelt252.assertRange(bn);
     }
     static is(data) {
       try {
@@ -5636,6 +5614,37 @@ ${indent}}` : "}";
       return new _CairoFelt252(getNext(responseIterator));
     }
   };
+  function CairoFelt(it) {
+    if (isBigInt(it) || Number.isInteger(it)) {
+      const val = BigInt(it);
+      CairoFelt252.assertRange(val);
+      return val.toString();
+    }
+    if (isString(it)) {
+      if (isHex2(it)) {
+        const val = BigInt(it);
+        CairoFelt252.assertRange(val);
+        return val.toString();
+      }
+      if (isText(it)) {
+        if (!isShortString(it)) {
+          throw new Error(
+            `${it} is a long string > 31 chars. Please split it into an array of short strings.`
+          );
+        }
+        return BigInt(encodeShortString(it)).toString();
+      }
+      if (isStringWholeNumber(it)) {
+        const val = BigInt(it);
+        CairoFelt252.assertRange(val);
+        return val.toString();
+      }
+    }
+    if (isBoolean(it)) {
+      return `${+it}`;
+    }
+    throw new Error(`${it} can't be computed by felt()`);
+  }
 
   // src/utils/cairoDataTypes/uint256.ts
   var UINT_128_MAX = (1n << 128n) - 1n;