starknet 10.3.1 → 10.3.3

package/CHANGELOG.md

@@ -1,3 +1,15 @@
+## [10.3.3](https://github.com/starknet-io/starknet.js/compare/v10.3.2...v10.3.3) (2026-06-30)
+
+### Bug Fixes
+
+- restore consistency of .toApiRequest() output type ([71c5d90](https://github.com/starknet-io/starknet.js/commit/71c5d90b740648bfa57b388938414dc1f50a9a08))
+
+## [10.3.2](https://github.com/starknet-io/starknet.js/compare/v10.3.1...v10.3.2) (2026-06-16)
+
+### Bug Fixes
+
+- surface clear error instead of crashing on empty node reply ([678ca1d](https://github.com/starknet-io/starknet.js/commit/678ca1db2b0f055708b03363688bddf75858a5e4))
+
 ## [10.3.1](https://github.com/starknet-io/starknet.js/compare/v10.3.0...v10.3.1) (2026-06-15)
 
 ### Bug Fixes

package/dist/index.d.ts

@@ -1150,7 +1150,7 @@ declare abstract class ProviderInterface {
      * // Equivalent to:
      * const [feeEstimate] = await provider.getEstimateFeeBulk([{ type: ETransactionType.INVOKE, ...invocation, ...details }], options);
      * ```
-     * @alias getEstimateFeeBulk - This method is an alias that calls getEstimateFeeBulk with a single transaction
+     * @remarks This method is an alias that calls getEstimateFeeBulk with a single transaction
      */
     abstract getInvokeEstimateFee(invocation: Invocation, details: InvocationsDetailsWithNonce, blockIdentifier?: BlockIdentifier, skipValidate?: boolean): Promise<EstimateFeeResponseOverhead>;
     /**
@@ -1174,7 +1174,7 @@ declare abstract class ProviderInterface {
      * // Equivalent to:
      * const [feeEstimate] = await provider.getEstimateFeeBulk([{ type: ETransactionType.DECLARE, ...transaction, ...details }], options);
      * ```
-     * @alias getEstimateFeeBulk - This method is an alias that calls getEstimateFeeBulk with a single transaction
+     * @remarks This method is an alias that calls getEstimateFeeBulk with a single transaction
      */
     abstract getDeclareEstimateFee(transaction: DeclareContractTransaction, details: InvocationsDetailsWithNonce, blockIdentifier?: BlockIdentifier, skipValidate?: boolean): Promise<EstimateFeeResponseOverhead>;
     /**
@@ -1199,7 +1199,7 @@ declare abstract class ProviderInterface {
      * // Equivalent to:
      * const [feeEstimate] = await provider.getEstimateFeeBulk([{ type: ETransactionType.DEPLOY_ACCOUNT, ...transaction, ...details }], options);
      * ```
-     * @alias getEstimateFeeBulk - This method is an alias that calls getEstimateFeeBulk with a single transaction
+     * @remarks This method is an alias that calls getEstimateFeeBulk with a single transaction
      */
     abstract getDeployAccountEstimateFee(transaction: DeployAccountContractTransaction, details: InvocationsDetailsWithNonce, blockIdentifier?: BlockIdentifier, skipValidate?: boolean): Promise<EstimateFeeResponseOverhead>;
     /**
@@ -1420,7 +1420,7 @@ declare abstract class ProviderInterface {
      * @param {Signature} signature signature of the message.
      * @param {BigNumberish} accountAddress address of the account that has signed the message.
      * @param {string} [signatureVerificationFunctionName] if account contract with non standard account verification function name.
-     * @param { okResponse: string[]; nokResponse: string[]; error: string[] } [signatureVerificationResponse] if account contract with non standard response of verification function.
+     * @param [signatureVerificationResponse] if account contract with non standard response of verification function.
      * @returns
      * ```typescript
      * const myTypedMessage: TypedMessage = .... ;
@@ -3612,7 +3612,7 @@ type ParsedEvents = Array<ParsedEvent> & {
 };
 /**
  * Advance formatting used to get js types data as result
- * @description https://starknet-io.github.io/starknet.js/docs/guides/define_call_message/#formatresponse
+ * @see https://starknet-io.github.io/starknet.js/docs/guides/define_call_message/#formatresponse
  * @example
  * ```typescript
  * // assign custom or existing method to resulting data
@@ -9850,10 +9850,6 @@ declare namespace byteArray {
 /**
  * Parse one field of the calldata by using input field from the abi for that method
  *
- * @param argsIterator - Iterator for value of the field
- * @param input  - input(field) information from the abi that will be used to parse the data
- * @param structs - structs from abi
- * @param enums - enums from abi
  * @return {string | string[]} - parsed arguments in format that contract is expecting
  *
  * @example
@@ -9899,10 +9895,15 @@ declare namespace byteArray {
  * // parsedField === ['1952805748']
  */
 declare function parseCalldataField({ argsIterator, input, structs, enums, parser, }: {
+    /** Iterator for value of the field */
     argsIterator: Iterator<any>;
+    /** input(field) information from the abi that will be used to parse the data */
     input: AbiEntry;
+    /** structs from abi */
     structs: AbiStructs;
+    /** enums from abi */
     enums: AbiEnums;
+    /** parser used to serialize the value */
     parser: AbiParserInterface;
 }): string | string[];
 
@@ -10025,7 +10026,7 @@ declare function isFileSystemAvailable(): boolean;
  * - Can accept a single .sierra.json or .casm file, or multiple files
  * - If compiledClassHash is provided: .casm file is optional
  *
- * @param {string | File | File[]} input - Path (Node.js) or File/File[] (browser)
+ * @param {string | File | File[]} contractPath - Path (Node.js) or File/File[] (browser)
  * @param {string} [compiledClassHash] - Optional compiled class hash. If provided, .casm file becomes optional
  * @return {LoadedContract | Promise<LoadedContract>} - Contract data (sync in Node.js, async in browser)
  * @throws {Error} - If no .sierra.json file is found, or if .casm is missing when compiledClassHash is not provided

package/dist/index.global.js

@@ -5591,7 +5591,7 @@ ${indent}}` : "}";
       return addHexPrefix(this.toBigInt().toString(16));
     }
     toApiRequest() {
-      return addCompiledFlag([this.toHexString()]);
+      return addCompiledFlag([BigInt(this.toHexString()).toString()]);
     }
     static assertRange(val) {
       assert(val >= 0n && val < PRIME, `Value ${val} is out of felt252 range [0, ${PRIME})`);
@@ -6221,7 +6221,7 @@ ${indent}}` : "}";
       throw new Error("Invalid input type for CairoBytes31. Expected string, Buffer, or Uint8Array");
     }
     toApiRequest() {
-      return addCompiledFlag([this.toHexString()]);
+      return addCompiledFlag([BigInt(this.toHexString()).toString()]);
     }
     toBigInt() {
       return uint8ArrayToBigInt(this.data);
@@ -6424,7 +6424,7 @@ ${indent}}` : "}";
       return BigInt(data);
     }
     toApiRequest() {
-      return addCompiledFlag([this.toHexString()]);
+      return addCompiledFlag([BigInt(this.toHexString()).toString()]);
     }
     toBigInt() {
       return this.data;
@@ -6544,7 +6544,7 @@ ${indent}}` : "}";
     toApiRequest() {
       this.assertInitialized();
       return addCompiledFlag([
-        addHexPrefix(this.data.length.toString(16)),
+        this.data.length.toString(),
         ...this.data.flatMap((bytes31) => bytes31.toApiRequest()),
         ...this.pending_word.toApiRequest(),
         ...this.pending_word_len.toApiRequest()
@@ -6697,7 +6697,7 @@ ${indent}}` : "}";
       return BigInt(data);
     }
     toApiRequest() {
-      return addCompiledFlag([this.toHexString()]);
+      return addCompiledFlag([BigInt(this.toHexString()).toString()]);
     }
     toBigInt() {
       return this.data;
@@ -6755,7 +6755,7 @@ ${indent}}` : "}";
       return BigInt(data);
     }
     toApiRequest() {
-      return addCompiledFlag([this.toHexString()]);
+      return addCompiledFlag([BigInt(this.toHexString()).toString()]);
     }
     toBigInt() {
       return this.data;
@@ -6813,7 +6813,7 @@ ${indent}}` : "}";
       return BigInt(data);
     }
     toApiRequest() {
-      return addCompiledFlag([this.toHexString()]);
+      return addCompiledFlag([BigInt(this.toHexString()).toString()]);
     }
     toBigInt() {
       return this.data;
@@ -6871,7 +6871,7 @@ ${indent}}` : "}";
       return BigInt(data);
     }
     toApiRequest() {
-      return addCompiledFlag([this.toHexString()]);
+      return addCompiledFlag([BigInt(this.toHexString()).toString()]);
     }
     toBigInt() {
       return this.data;
@@ -6929,7 +6929,7 @@ ${indent}}` : "}";
       return BigInt(data);
     }
     toApiRequest() {
-      return addCompiledFlag([this.toHexString()]);
+      return addCompiledFlag([BigInt(this.toHexString()).toString()]);
     }
     toBigInt() {
       return this.data;
@@ -6987,7 +6987,7 @@ ${indent}}` : "}";
       return BigInt(data);
     }
     toApiRequest() {
-      return addCompiledFlag([this.toHexString()]);
+      return addCompiledFlag([BigInt(this.toHexString()).toString()]);
     }
     toBigInt() {
       return this.data;
@@ -7059,7 +7059,7 @@ ${indent}}` : "}";
       return BigInt(data);
     }
     toApiRequest() {
-      return addCompiledFlag([this.toHexString()]);
+      return addCompiledFlag([BigInt(this.toHexString()).toString()]);
     }
     toBigInt() {
       return this.data;
@@ -7131,7 +7131,7 @@ ${indent}}` : "}";
       return BigInt(data);
     }
     toApiRequest() {
-      return addCompiledFlag([this.toHexString()]);
+      return addCompiledFlag([BigInt(this.toHexString()).toString()]);
     }
     toBigInt() {
       return this.data;
@@ -7203,7 +7203,7 @@ ${indent}}` : "}";
       return BigInt(data);
     }
     toApiRequest() {
-      return addCompiledFlag([this.toHexString()]);
+      return addCompiledFlag([BigInt(this.toHexString()).toString()]);
     }
     toBigInt() {
       return this.data;
@@ -7275,7 +7275,7 @@ ${indent}}` : "}";
       return BigInt(data);
     }
     toApiRequest() {
-      return addCompiledFlag([this.toHexString()]);
+      return addCompiledFlag([BigInt(this.toHexString()).toString()]);
     }
     toBigInt() {
       return this.data;
@@ -7439,7 +7439,7 @@ ${indent}}` : "}";
         return new CairoByteArray(val).toApiRequest();
       },
       [CairoFelt252.abiSelector]: (val) => {
-        return felt(val);
+        return new CairoFelt252(val).toApiRequest();
       },
       [CairoUint256.abiSelector]: (val) => {
         return new CairoUint256(val).toApiRequest();
@@ -11277,18 +11277,20 @@ ${indent}}` : "}";
     }
     async fetchEndpoint(method, params) {
       try {
+        let error;
+        let result;
         if (this.batchClient) {
-          const { error: error2, result: result2 } = await this.batchClient.fetch(
-            method,
-            params,
-            this.requestId += 1
-          );
-          this.errorHandler(method, params, error2);
-          return result2;
+          ({ error, result } = await this.batchClient.fetch(method, params, this.requestId += 1));
+        } else {
+          const rawResult = await this.fetch(method, params, this.requestId += 1);
+          ({ error, result } = await rawResult.json());
         }
-        const rawResult = await this.fetch(method, params, this.requestId += 1);
-        const { error, result } = await rawResult.json();
         this.errorHandler(method, params, error);
+        if (result === void 0) {
+          throw new LibraryError(
+            `RPC: '${method}' returned an empty response (no result and no error). The node reply is malformed or not a valid JSON-RPC response.`
+          );
+        }
         return result;
       } catch (error) {
         this.errorHandler(method, params, error?.response?.data, error);
@@ -11916,18 +11918,20 @@ ${indent}}` : "}";
     }
     async fetchEndpoint(method, params) {
       try {
+        let error;
+        let result;
         if (this.batchClient) {
-          const { error: error2, result: result2 } = await this.batchClient.fetch(
-            method,
-            params,
-            this.requestId += 1
-          );
-          this.errorHandler(method, params, error2);
-          return result2;
+          ({ error, result } = await this.batchClient.fetch(method, params, this.requestId += 1));
+        } else {
+          const rawResult = await this.fetch(method, params, this.requestId += 1);
+          ({ error, result } = await rawResult.json());
         }
-        const rawResult = await this.fetch(method, params, this.requestId += 1);
-        const { error, result } = await rawResult.json();
         this.errorHandler(method, params, error);
+        if (result === void 0) {
+          throw new LibraryError(
+            `RPC: '${method}' returned an empty response (no result and no error). The node reply is malformed or not a valid JSON-RPC response.`
+          );
+        }
         return result;
       } catch (error) {
         this.errorHandler(method, params, error?.response?.data, error);