starknet 10.4.0 → 10.5.0

package/CHANGELOG.md

@@ -1,3 +1,9 @@
+# [10.5.0](https://github.com/starknet-io/starknet.js/compare/v10.4.0...v10.5.0) (2026-07-06)
+
+### Features
+
+- add Contract.compile() to build calldata from the abi ([0cdcaf9](https://github.com/starknet-io/starknet.js/commit/0cdcaf927a75b4537ccc071794ae354f058c320c))
+
 # [10.4.0](https://github.com/starknet-io/starknet.js/compare/v10.3.3...v10.4.0) (2026-07-01)
 
 ### Features

package/dist/index.d.ts

@@ -6278,6 +6278,27 @@ declare abstract class ContractInterface {
      * ```
      */
     abstract populate(method: string, args?: ArgsOrCalldata): Invocation;
+    /**
+     * Compile the calldata for a contract method, using the contract abi.
+     *
+     * Unlike {@link populate}, this returns only the compiled `Calldata` array, without wrapping it
+     * in an `Invocation` object (no `contractAddress` nor `entrypoint`). It is the contract-bound
+     * equivalent of `myCallData.compile(method, args)`.
+     *
+     * If `args` is already a compiled `Calldata`, it is returned as-is without recompilation.
+     *
+     * @param method - Name of the contract method, as defined in the abi
+     * @param args - Method arguments as array (in abi order) or object (free order), or an already
+     * compiled calldata
+     * @returns The compiled calldata
+     * @example
+     * ```typescript
+     * // 'amount' is a u256: the abi splits it into 2 felts automatically
+     * const calldata = contract.compile('transfer', { recipient: '0x123', amount: 100n });
+     * // calldata = ['0x123', '100', '0']
+     * ```
+     */
+    abstract compile(method: string, args?: ArgsOrCalldata): Calldata;
     /**
      * Parse events from a transaction receipt using the contract's ABI
      *
@@ -6404,6 +6425,7 @@ declare class Contract implements ContractInterface {
     }): Promise<InvokeFunctionResponse>;
     invoke(method: string, args?: ArgsOrCalldata, options?: ExecuteOptions): Promise<InvokeFunctionResponse>;
     estimate(method: string, args?: ArgsOrCalldata, estimateDetails?: ExecuteOptions): Promise<EstimateFeeResponseOverhead | PaymasterFeeEstimate>;
+    compile(method: string, args?: RawArgs): Calldata;
     populate(method: string, args?: RawArgs): Call;
     parseEvents(receipt: GetTransactionReceiptResponse): ParsedEvents;
     isCairo1(): boolean;

package/dist/index.global.js

@@ -18548,12 +18548,14 @@ ${indent}}` : "}";
       }
       throw Error("Contract must be connected to the account contract to estimate");
     }
+    compile(method, args = []) {
+      return getCompiledCalldata(args, () => this.callData.compile(method, args));
+    }
     populate(method, args = []) {
-      const calldata = getCompiledCalldata(args, () => this.callData.compile(method, args));
       return {
         contractAddress: this.address,
         entrypoint: method,
-        calldata
+        calldata: this.compile(method, args)
       };
     }
     parseEvents(receipt) {