starknet 11.0.0-beta.6 → 11.0.0-beta.8

package/CHANGELOG.md

@@ -1,3 +1,25 @@
+# [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
+
+- **calldata:** a Cairo type serializes itself, abi or not ([c0943fb](https://github.com/starknet-io/starknet.js/commit/c0943fb173ab7e914ae213865c8cf7cf78898746))
+- **calldata:** an abi slot accepts the Cairo type it declares ([b9fa576](https://github.com/starknet-io/starknet.js/commit/b9fa5769aba339a27a989d249d4adef1b04f79a8))
+- **calldata:** out-of-range arguments refused, negative results come back negative ([41bf052](https://github.com/starknet-io/starknet.js/commit/41bf052f11a66d9b72e8db2a964b86c8161546b1))
+
 # [11.0.0-beta.6](https://github.com/starknet-io/starknet.js/compare/v11.0.0-beta.5...v11.0.0-beta.6) (2026-08-25)
 
 ### Bug Fixes

package/dist/index.d.ts

@@ -4101,6 +4101,24 @@ declare class CairoUint16 {
     static factoryFromApiResponse(responseIterator: Iterator<string>): CairoUint16;
 }
 
+declare class CairoUint32 {
+    data: bigint;
+    static abiSelector: string;
+    constructor(data: BigNumberish | boolean | unknown);
+    static __processData(data: BigNumberish | boolean | unknown): bigint;
+    toApiRequest(): string[];
+    toBigInt(): bigint;
+    decodeUtf8(): string;
+    toHexString(): string;
+    static validate(data: BigNumberish | boolean | unknown): void;
+    static is(data: BigNumberish | boolean | unknown): boolean;
+    /**
+     * Check if provided abi type is this data type
+     */
+    static isAbiType(abiType: string): boolean;
+    static factoryFromApiResponse(responseIterator: Iterator<string>): CairoUint32;
+}
+
 declare class CairoUint64 {
     data: bigint;
     static abiSelector: string;
@@ -4274,7 +4292,15 @@ type ParsingStrategy = {
     response: Record<AbiEntryType, (responseIterator: Iterator<string>) => any>;
 };
 /**
- * More robust parsing strategy
+ * The default parsing strategy.
+ *
+ * A request is validated, a response is only decoded. What the caller passes in is the caller's
+ * mistake to catch, so an argument goes through the class of its declared type and is refused
+ * when it does not fit. What a node answers is not, so a response is read as it comes — the
+ * declared type is used there only where reading needs it: a negative i8..i128, which is a field
+ * element on the wire and only its own class turns back into a negative number, a u256 or u512
+ * spread over several felts, a bytes31 or a ByteArray carrying bytes.
+ *
  * Configuration mapping - data-driven approach
  * Configure parsing strategy for each abi type
  */
@@ -4283,6 +4309,7 @@ declare const hdParsingStrategy: {
         readonly [CairoUint512.abiSelector]: (val: unknown) => string[];
         readonly [CairoUint8.abiSelector]: (val: unknown) => string[];
         readonly [CairoUint16.abiSelector]: (val: unknown) => string[];
+        readonly [CairoUint32.abiSelector]: (val: unknown) => string[];
         readonly [CairoUint64.abiSelector]: (val: unknown) => string[];
         readonly [CairoUint96.abiSelector]: (val: unknown) => string[];
         readonly [CairoUint128.abiSelector]: (val: unknown) => string[];
@@ -4294,12 +4321,14 @@ declare const hdParsingStrategy: {
         readonly "core::bytes_31::bytes31": (val: unknown) => string[];
         readonly "core::byte_array::ByteArray": (val: unknown) => string[];
         readonly "core::felt252": (val: unknown) => string[];
+        readonly "core::starknet::eth_address::EthAddress": (val: unknown) => string[];
         readonly "core::integer::u256": (val: unknown) => string[];
     };
     readonly response: {
         readonly [CairoUint512.abiSelector]: (responseIterator: Iterator<string>) => bigint;
         readonly [CairoUint8.abiSelector]: (responseIterator: Iterator<string>) => bigint;
         readonly [CairoUint16.abiSelector]: (responseIterator: Iterator<string>) => bigint;
+        readonly [CairoUint32.abiSelector]: (responseIterator: Iterator<string>) => bigint;
         readonly [CairoUint64.abiSelector]: (responseIterator: Iterator<string>) => bigint;
         readonly [CairoUint96.abiSelector]: (responseIterator: Iterator<string>) => bigint;
         readonly [CairoUint128.abiSelector]: (responseIterator: Iterator<string>) => bigint;
@@ -4315,7 +4344,13 @@ declare const hdParsingStrategy: {
     };
 };
 /**
- * Faster parsing strategy
+ * A faster strategy, opt-in through the second argument of `new CallData(abi, strategy)`.
+ *
+ * It buys that speed by not going through the class of the declared type, which costs two things
+ * the caller should weigh: an out-of-range u8/u16/u64/u96/u128 is serialized rather than refused,
+ * and a negative i8..i128 comes back from a call as its raw field element rather than as a
+ * negative number.
+ *
  * Configuration mapping - data-driven approach
  * Configure parsing strategy for each abi type
  */
@@ -5171,6 +5206,10 @@ declare const RANGE_I128: {
     readonly min: bigint;
     readonly max: bigint;
 };
+declare const RANGE_ETH_ADDRESS: {
+    readonly min: bigint;
+    readonly max: bigint;
+};
 declare const LegacyUDC: {
     readonly ADDRESS: "0x041a78e741e5af2fec34b695679bc6891742439f7afb8484ecd7766661ad02bf";
     readonly ENTRYPOINT: "deployContract";
@@ -5315,6 +5354,7 @@ declare const constants_MAX_STORAGE_ITEM_SIZE: typeof MAX_STORAGE_ITEM_SIZE;
 declare const constants_OutsideExecutionCallerAny: typeof OutsideExecutionCallerAny;
 declare const constants_PAYMASTER_RPC_NODES: typeof PAYMASTER_RPC_NODES;
 declare const constants_PRIME: typeof PRIME;
+declare const constants_RANGE_ETH_ADDRESS: typeof RANGE_ETH_ADDRESS;
 declare const constants_RANGE_FELT: typeof RANGE_FELT;
 declare const constants_RANGE_I128: typeof RANGE_I128;
 declare const constants_RANGE_I16: typeof RANGE_I16;
@@ -5339,7 +5379,7 @@ declare const constants_TEXT_TO_FELT_MAX_LEN: typeof TEXT_TO_FELT_MAX_LEN;
 declare const constants_UDC: typeof UDC;
 declare const constants_ZERO: typeof ZERO;
 declare namespace constants {
-  export { constants_ADDR_BOUND as ADDR_BOUND, constants_API_VERSION as API_VERSION, _BaseUrl as BaseUrl, type constants_ChannelDefaultOptions as ChannelDefaultOptions, type constants_ChannelDefaults as ChannelDefaults, type constants_ChannelMethodOptions as ChannelMethodOptions, constants_DEFAULT_GLOBAL_CONFIG as DEFAULT_GLOBAL_CONFIG, constants_HARDENING_4BYTES as HARDENING_4BYTES, constants_HARDENING_BYTE as HARDENING_BYTE, constants_IS_BROWSER as IS_BROWSER, constants_LegacyUDC as LegacyUDC, constants_MASK_250 as MASK_250, constants_MASK_31 as MASK_31, constants_MAX_STORAGE_ITEM_SIZE as MAX_STORAGE_ITEM_SIZE, _NetworkName as NetworkName, constants_OutsideExecutionCallerAny as OutsideExecutionCallerAny, constants_PAYMASTER_RPC_NODES as PAYMASTER_RPC_NODES, constants_PRIME as PRIME, constants_RANGE_FELT as RANGE_FELT, constants_RANGE_I128 as RANGE_I128, constants_RANGE_I16 as RANGE_I16, constants_RANGE_I32 as RANGE_I32, constants_RANGE_I64 as RANGE_I64, constants_RANGE_I8 as RANGE_I8, constants_RANGE_U128 as RANGE_U128, constants_RANGE_U16 as RANGE_U16, constants_RANGE_U32 as RANGE_U32, constants_RANGE_U64 as RANGE_U64, constants_RANGE_U8 as RANGE_U8, constants_RANGE_U96 as RANGE_U96, constants_RPC_DEFAULT_NODES as RPC_DEFAULT_NODES, constants_SNIP9_V1_INTERFACE_ID as SNIP9_V1_INTERFACE_ID, constants_SNIP9_V2_INTERFACE_ID as SNIP9_V2_INTERFACE_ID, constants_SN_VERSION_IMPLEMENTING_BLAKE_FOR_COMPILED_CLASS as SN_VERSION_IMPLEMENTING_BLAKE_FOR_COMPILED_CLASS, constants_SYSTEM_MESSAGES as SYSTEM_MESSAGES, _StarknetChainId as StarknetChainId, type constants_SupportedCairoVersion as SupportedCairoVersion, _SupportedRpcVersion as SupportedRpcVersion, type constants_SupportedRpcVersion0_10 as SupportedRpcVersion0_10, type constants_SupportedTransactionVersion as SupportedTransactionVersion, constants_TEXT_TO_FELT_MAX_LEN as TEXT_TO_FELT_MAX_LEN, _TransactionHashPrefix as TransactionHashPrefix, constants_UDC as UDC, constants_ZERO as ZERO };
+  export { constants_ADDR_BOUND as ADDR_BOUND, constants_API_VERSION as API_VERSION, _BaseUrl as BaseUrl, type constants_ChannelDefaultOptions as ChannelDefaultOptions, type constants_ChannelDefaults as ChannelDefaults, type constants_ChannelMethodOptions as ChannelMethodOptions, constants_DEFAULT_GLOBAL_CONFIG as DEFAULT_GLOBAL_CONFIG, constants_HARDENING_4BYTES as HARDENING_4BYTES, constants_HARDENING_BYTE as HARDENING_BYTE, constants_IS_BROWSER as IS_BROWSER, constants_LegacyUDC as LegacyUDC, constants_MASK_250 as MASK_250, constants_MASK_31 as MASK_31, constants_MAX_STORAGE_ITEM_SIZE as MAX_STORAGE_ITEM_SIZE, _NetworkName as NetworkName, constants_OutsideExecutionCallerAny as OutsideExecutionCallerAny, constants_PAYMASTER_RPC_NODES as PAYMASTER_RPC_NODES, constants_PRIME as PRIME, constants_RANGE_ETH_ADDRESS as RANGE_ETH_ADDRESS, constants_RANGE_FELT as RANGE_FELT, constants_RANGE_I128 as RANGE_I128, constants_RANGE_I16 as RANGE_I16, constants_RANGE_I32 as RANGE_I32, constants_RANGE_I64 as RANGE_I64, constants_RANGE_I8 as RANGE_I8, constants_RANGE_U128 as RANGE_U128, constants_RANGE_U16 as RANGE_U16, constants_RANGE_U32 as RANGE_U32, constants_RANGE_U64 as RANGE_U64, constants_RANGE_U8 as RANGE_U8, constants_RANGE_U96 as RANGE_U96, constants_RPC_DEFAULT_NODES as RPC_DEFAULT_NODES, constants_SNIP9_V1_INTERFACE_ID as SNIP9_V1_INTERFACE_ID, constants_SNIP9_V2_INTERFACE_ID as SNIP9_V2_INTERFACE_ID, constants_SN_VERSION_IMPLEMENTING_BLAKE_FOR_COMPILED_CLASS as SN_VERSION_IMPLEMENTING_BLAKE_FOR_COMPILED_CLASS, constants_SYSTEM_MESSAGES as SYSTEM_MESSAGES, _StarknetChainId as StarknetChainId, type constants_SupportedCairoVersion as SupportedCairoVersion, _SupportedRpcVersion as SupportedRpcVersion, type constants_SupportedRpcVersion0_10 as SupportedRpcVersion0_10, type constants_SupportedTransactionVersion as SupportedTransactionVersion, constants_TEXT_TO_FELT_MAX_LEN as TEXT_TO_FELT_MAX_LEN, _TransactionHashPrefix as TransactionHashPrefix, constants_UDC as UDC, constants_ZERO as ZERO };
 }
 
 /** What a {@link SubscriptionChannel} needs: a socket to borrow, and how much to buffer. */
@@ -9361,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.
+ *
+ * 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 string to be encoded.
+ * @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;
@@ -10581,24 +10629,6 @@ declare class CairoFelt252 {
     static factoryFromApiResponse(responseIterator: Iterator<string>): CairoFelt252;
 }
 
-declare class CairoUint32 {
-    data: bigint;
-    static abiSelector: string;
-    constructor(data: BigNumberish);
-    static __processData(data: BigNumberish): bigint;
-    toApiRequest(): string[];
-    toBigInt(): bigint;
-    decodeUtf8(): string;
-    toHexString(): string;
-    static validate(data: BigNumberish): void;
-    static is(data: BigNumberish): boolean;
-    /**
-     * Check if provided abi type is this data type
-     */
-    static isAbiType(abiType: string): boolean;
-    static factoryFromApiResponse(responseIterator: Iterator<string>): CairoUint32;
-}
-
 /**
  * A Cairo `core::byte_array::ByteArray` : an arbitrary sequence of bytes, cut into words of 31.
  *
@@ -11340,8 +11370,23 @@ declare class CallData {
     compile(method: string, argsCalldata: RawArgs): Calldata;
     /**
      * Compile contract callData without abi
+     *
+     * An instance of a Cairo type class — `CairoByteArray`, `CairoBytes31`, `CairoUint256`, … — is
+     * serialized by that class, so it yields the same felts here as it would through an abi. Any
+     * other object is walked field by field, which is what makes a plain `{ low, high }` and the
+     * object of `byteArrayFromString` work just as well.
+     *
+     * A `string[]` value is always read as a Cairo array and gains a length in front of it, an
+     * already compiled one included : pass the instance itself rather than its `toApiRequest()`.
      * @param rawArgs RawArgs representing cairo method arguments or string array of compiled data
      * @returns Calldata
+     * @example
+     * ```typescript
+     * const result = CallData.compile({ text: CairoByteArray.fromText('12345') });
+     * // result = ["0", "211295614005", "5"]
+     * const result2 = CallData.compile({ text: CairoByteArray.fromText('12345').toApiRequest() });
+     * // result2 = ["3", "0", "211295614005", "5"]   the three felts, behind an array length
+     * ```
      */
     static compile(rawArgs: RawArgs): Calldata;
     /**