starknet 11.0.0-beta.10 → 11.0.0-beta.11

package/CHANGELOG.md

@@ -1,3 +1,17 @@
+# [11.0.0-beta.11](https://github.com/starknet-io/starknet.js/compare/v11.0.0-beta.10...v11.0.0-beta.11) (2026-09-01)
+
+### Features
+
+- **cairoDataTypes:** add CairoBool, CairoEthAddress and CairoSecp256k1Point ([332dd1e](https://github.com/starknet-io/starknet.js/commit/332dd1e2fbf9db756343768327788f9114a897b1))
+
+### BREAKING CHANGES
+
+- **cairoDataTypes:** three inputs that used to reach the calldata are now refused.
+  A core::bool argument that is neither a boolean nor 0/1 throws instead of being
+  serialized as a felt. An EthAddress built from text throws instead of being
+  encoded as its UTF-8 bytes. A Secp256k1Point wider than 512 bits throws instead
+  of emitting four corrupted felts.
+
 # [11.0.0-beta.10](https://github.com/starknet-io/starknet.js/compare/v11.0.0-beta.9...v11.0.0-beta.10) (2026-09-01)
 
 ### Bug Fixes

package/dist/index.d.ts

@@ -3992,6 +3992,165 @@ declare abstract class AbiParserInterface {
     abstract getResponseParser(abiType: AbiEntryType): (responseIterator: Iterator<string>) => any;
 }
 
+/**
+ * A Cairo `core::bool` : true or false, carried in one felt252 as 1 or 0.
+ *
+ * A boolean is the natural input, but the two numbers a bool occupies on the wire are accepted
+ * too — `1`, `0n`, `'1'`, `'0x0'` — because that is how a bool comes back from a node, as a felt
+ * rather than as a JS value. Any other number is refused : a bool is not a felt narrowed to a
+ * range, it is exactly two values.
+ *
+ * On the request side the library is stricter still : `CallData.compile` runs `validateFields`
+ * first, which requires a real boolean. So a `1` reaching a `core::bool` argument is refused there
+ * before this class ever sees it.
+ * @example
+ * ```typescript
+ * // the same value, reached three ways
+ * new CairoBool(true).toBoolean(); //   true
+ * new CairoBool(1).toBoolean(); //      true
+ * new CairoBool('0x1').toBoolean(); //  true
+ * ```
+ */
+declare class CairoBool {
+    /**
+     * The value, always as a boolean.
+     * @example
+     * ```typescript
+     * const result = new CairoBool('0x1').data;
+     * // result = true
+     * ```
+     */
+    data: boolean;
+    /**
+     * The abi type this class serializes.
+     * @example
+     * ```typescript
+     * const result = CairoBool.abiSelector;
+     * // result = "core::bool"
+     * ```
+     */
+    static abiSelector: string;
+    /**
+     * Build from a boolean, or from the numbers 0 and 1.
+     * @param {BigNumberish | boolean} data the value to carry : a boolean, 0 or 1
+     * @throws {Error} when the value is text, is not a felt252 input, or is a number other than 0 or 1
+     * @example
+     * ```typescript
+     * const result = new CairoBool(false).toApiRequest();
+     * // result = ["0"]
+     * ```
+     */
+    constructor(data: BigNumberish | boolean | unknown);
+    /**
+     * Turn an accepted input into its boolean.
+     *
+     * Nothing here refuses a value : `validate` is what decides, and only a boolean, a 0 or a 1
+     * reaches this point.
+     * @param {BigNumberish | boolean} data the value to convert
+     * @returns {boolean} the boolean the input spells
+     * @example
+     * ```typescript
+     * const result = CairoBool.__processData('0x1');
+     * // result = true
+     * ```
+     */
+    static __processData(data: BigNumberish | boolean | unknown): boolean;
+    /**
+     * Serialize to the single felt a contract call carries.
+     * @returns {string[]} one decimal-string felt, `"1"` or `"0"`, flagged as compiled
+     * @example
+     * ```typescript
+     * const result = new CairoBool(true).toApiRequest();
+     * // result = ["1"]
+     * const result2 = new CairoBool(false).toApiRequest();
+     * // result2 = ["0"]
+     * ```
+     */
+    toApiRequest(): string[];
+    /**
+     * The value as a boolean.
+     * @returns {boolean} the boolean this bool holds
+     * @example
+     * ```typescript
+     * const result = new CairoBool(1).toBoolean();
+     * // result = true
+     * ```
+     */
+    toBoolean(): boolean;
+    /**
+     * The value in hexadecimal, as the felt a bool occupies.
+     * @returns {string} `"0x1"` for true, `"0x0"` for false
+     * @example
+     * ```typescript
+     * const result = new CairoBool(true).toHexString();
+     * // result = "0x1"
+     * const result2 = new CairoBool(false).toHexString();
+     * // result2 = "0x0"
+     * ```
+     */
+    toHexString(): string;
+    /**
+     * Throw unless the value can be carried by a bool.
+     *
+     * Text is refused first, then the value is read as a felt252 — which is what refuses a null, an
+     * object or an unsupported type — and finally checked to be one of the only two numbers a bool
+     * can hold.
+     * @param {BigNumberish | boolean} data the value to check
+     * @throws {Error} when the value is text, is not a felt252 input, or is a number other than 0 or 1
+     * @example
+     * ```typescript
+     * CairoBool.validate(true); // passes
+     * CairoBool.validate(2);
+     * // throws Error("Only values 0 or 1 are possible in a core::bool, received 2")
+     * ```
+     */
+    static validate(data: BigNumberish | boolean | unknown): void;
+    /**
+     * Can this value be carried by a bool?
+     *
+     * The non-throwing form of {@link CairoBool.validate}, so it answers false for every input that
+     * one refuses, whatever the reason.
+     * @param {BigNumberish | boolean} data the value to test
+     * @returns {boolean} true when the value is a boolean, a 0 or a 1
+     * @example
+     * ```typescript
+     * const result = CairoBool.is(1);
+     * // result = true
+     * const result2 = CairoBool.is(2);
+     * // result2 = false     (a bool is exactly two values)
+     * ```
+     */
+    static is(data: BigNumberish | boolean | unknown): boolean;
+    /**
+     * Is this abi type the one this class serializes?
+     * @param {string} abiType the abi type to test
+     * @returns {boolean} true for `core::bool`
+     * @example
+     * ```typescript
+     * const result = CairoBool.isAbiType('core::bool');
+     * // result = true
+     * const result2 = CairoBool.isAbiType('core::felt252');
+     * // result2 = false
+     * ```
+     */
+    static isAbiType(abiType: string): boolean;
+    /**
+     * Read one bool off a contract response, advancing the iterator past it.
+     *
+     * The felts a node returns are hex strings, and one is consumed per call, so successive calls
+     * read successive return values.
+     * @param {Iterator<string>} responseIterator the response felts, positioned on this bool
+     * @returns {CairoBool} the bool that was read
+     * @example
+     * ```typescript
+     * const response = ['0x1'];
+     * const result = CairoBool.factoryFromApiResponse(response.values()).toBoolean();
+     * // result = true
+     * ```
+     */
+    static factoryFromApiResponse(responseIterator: Iterator<string>): CairoBool;
+}
+
 /**
  * The largest u512, 2^512 - 1.
  * @example
@@ -6260,6 +6419,7 @@ type ParsingStrategy = {
  */
 declare const hdParsingStrategy: {
     readonly request: {
+        readonly [CairoBool.abiSelector]: (val: unknown) => string[];
         readonly [CairoUint512.abiSelector]: (val: unknown) => string[];
         readonly [CairoUint8.abiSelector]: (val: unknown) => string[];
         readonly [CairoUint16.abiSelector]: (val: unknown) => string[];
@@ -6276,9 +6436,11 @@ declare const hdParsingStrategy: {
         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::starknet::secp256k1::Secp256k1Point": (val: unknown) => string[];
         readonly "core::integer::u256": (val: unknown) => string[];
     };
     readonly response: {
+        readonly [CairoBool.abiSelector]: (responseIterator: Iterator<string>) => boolean;
         readonly [CairoUint512.abiSelector]: (responseIterator: Iterator<string>) => bigint;
         readonly [CairoUint8.abiSelector]: (responseIterator: Iterator<string>) => bigint;
         readonly [CairoUint16.abiSelector]: (responseIterator: Iterator<string>) => bigint;
@@ -6294,6 +6456,7 @@ declare const hdParsingStrategy: {
         readonly "core::bytes_31::bytes31": (responseIterator: Iterator<string>) => string;
         readonly "core::byte_array::ByteArray": (responseIterator: Iterator<string>) => string;
         readonly "core::felt252": (responseIterator: Iterator<string>) => bigint;
+        readonly "core::starknet::secp256k1::Secp256k1Point": (responseIterator: Iterator<string>) => bigint;
         readonly "core::integer::u256": (responseIterator: Iterator<string>) => bigint;
     };
 };
@@ -13302,6 +13465,402 @@ declare class CairoByteArray {
     static factoryFromApiResponse(responseIterator: Iterator<string>): CairoByteArray;
 }
 
+/**
+ * A Cairo `core::starknet::eth_address::EthAddress` : an Ethereum address, carried in one felt252
+ * but only 160 bits wide.
+ *
+ * On the wire it is a field element like any other, so what this class adds over
+ * {@link CairoFelt252} is the narrower bound : an address must fit in 160 bits, and a value past
+ * that is refused before any calldata leaves.
+ *
+ * A number, a bigint, a decimal string and a hexadecimal string are all read as the same number,
+ * so the shape of the input does not survive. Text is **not** an accepted input : unlike the other
+ * Cairo classes, which take a string that spells no number for its UTF-8 bytes, an address has no
+ * meaning as text and refuses it rather than encoding it into a number nobody meant.
+ * @example
+ * ```typescript
+ * // the same address, reached three ways
+ * new CairoEthAddress('0x1234').toBigInt(); // 4660n
+ * new CairoEthAddress(4660).toBigInt(); //    4660n
+ * new CairoEthAddress('4660').toBigInt(); //  4660n
+ * ```
+ */
+declare class CairoEthAddress {
+    /**
+     * The address, always as a bigint.
+     * @example
+     * ```typescript
+     * const result = new CairoEthAddress('0x1234').data;
+     * // result = 4660n
+     * ```
+     */
+    data: bigint;
+    /**
+     * The abi type this class serializes.
+     * @example
+     * ```typescript
+     * const result = CairoEthAddress.abiSelector;
+     * // result = "core::starknet::eth_address::EthAddress"
+     * ```
+     */
+    static abiSelector: string;
+    /**
+     * Build from a number or a numeric string, refusing text and anything wider than 160 bits.
+     * @param {BigNumberish | boolean} data the address to carry, within [0, 2^160 - 1]
+     * @throws {Error} when the value is text, is not a felt252 input, or is out of the EthAddress range
+     * @example
+     * ```typescript
+     * const result = new CairoEthAddress('0x1234').toApiRequest();
+     * // result = ["4660"]
+     * ```
+     */
+    constructor(data: BigNumberish | boolean | unknown);
+    /**
+     * Serialize to the single felt a contract call carries.
+     * @returns {string[]} one decimal-string felt, flagged as compiled
+     * @example
+     * ```typescript
+     * const result = new CairoEthAddress('0x1234').toApiRequest();
+     * // result = ["4660"]
+     * ```
+     */
+    toApiRequest(): string[];
+    /**
+     * The address as a number.
+     * @returns {bigint} the number this address holds
+     * @example
+     * ```typescript
+     * const result = new CairoEthAddress('0x1234').toBigInt();
+     * // result = 4660n
+     * ```
+     */
+    toBigInt(): bigint;
+    /**
+     * The address in hexadecimal, without padding.
+     *
+     * The 40 hex digits an Ethereum address is usually written with are not restored here : leading
+     * zeros are dropped, as they are everywhere else in the library.
+     * @returns {string} the address as a 0x-prefixed hex string
+     * @example
+     * ```typescript
+     * const result = new CairoEthAddress(4660).toHexString();
+     * // result = "0x1234"
+     * const result2 = new CairoEthAddress('0x0034').toHexString();
+     * // result2 = "0x34"     (four digits in, two out)
+     * ```
+     */
+    toHexString(): string;
+    /**
+     * Throw unless the value can be carried by an EthAddress.
+     *
+     * Text is refused first, since an address spelled as words is a mistake rather than a value to
+     * encode. What remains is read as a felt252 — which is what refuses a null, an object or an
+     * unsupported type — then checked against the 160 bits an Ethereum address occupies.
+     * @param {BigNumberish | boolean} data the value to check
+     * @throws {Error} when the value is text, is not a felt252 input, or is out of the EthAddress range
+     * @example
+     * ```typescript
+     * CairoEthAddress.validate('0x1234'); // passes
+     * CairoEthAddress.validate('abc');
+     * // throws Error("Invalid input: an EthAddress cannot be built from text")
+     * CairoEthAddress.validate(2n ** 160n);
+     * // throws Error("Value is out of EthAddress range [0, 1461501637330902918203684832716283019655932542975]")
+     * ```
+     */
+    static validate(data: BigNumberish | boolean | unknown): void;
+    /**
+     * Can this value be carried by an EthAddress?
+     *
+     * The non-throwing form of {@link CairoEthAddress.validate}, so it answers false for every input
+     * that one refuses, whatever the reason.
+     * @param {BigNumberish | boolean} data the value to test
+     * @returns {boolean} true when the value fits in an EthAddress
+     * @example
+     * ```typescript
+     * const result = CairoEthAddress.is('0x1234');
+     * // result = true
+     * const result2 = CairoEthAddress.is('abc');
+     * // result2 = false     (text, not a number)
+     * const result3 = CairoEthAddress.is(2n ** 160n);
+     * // result3 = false     (one bit too wide)
+     * ```
+     */
+    static is(data: BigNumberish | boolean | unknown): boolean;
+    /**
+     * Is this abi type the one this class serializes?
+     * @param {string} abiType the abi type to test
+     * @returns {boolean} true for `core::starknet::eth_address::EthAddress`
+     * @example
+     * ```typescript
+     * const result = CairoEthAddress.isAbiType('core::starknet::eth_address::EthAddress');
+     * // result = true
+     * const result2 = CairoEthAddress.isAbiType('core::felt252');
+     * // result2 = false
+     * ```
+     */
+    static isAbiType(abiType: string): boolean;
+    /**
+     * Read one EthAddress off a contract response, advancing the iterator past it.
+     *
+     * The felts a node returns are hex strings, and one is consumed per call, so successive calls
+     * read successive return values.
+     * @param {Iterator<string>} responseIterator the response felts, positioned on this address
+     * @returns {CairoEthAddress} the address that was read
+     * @example
+     * ```typescript
+     * const response = ['0x1234'];
+     * const result = CairoEthAddress.factoryFromApiResponse(response.values()).toBigInt();
+     * // result = 4660n
+     * ```
+     */
+    static factoryFromApiResponse(responseIterator: Iterator<string>): CairoEthAddress;
+}
+
+/**
+ * The largest value a Secp256k1Point can carry : both coordinates at their maximum, 512 bits.
+ * @example
+ * ```typescript
+ * const result = SECP256K1_POINT_MAX === (1n << 512n) - 1n;
+ * // result = true
+ * ```
+ */
+declare const SECP256K1_POINT_MAX: bigint;
+/**
+ * The smallest value a Secp256k1Point can carry.
+ * @example
+ * ```typescript
+ * const result = SECP256K1_POINT_MIN;
+ * // result = 0n
+ * ```
+ */
+declare const SECP256K1_POINT_MIN = 0n;
+/**
+ * The four 128-bit limbs a Secp256k1Point occupies on the wire, in the order a call carries them.
+ */
+interface Secp256k1PointStruct {
+    xLow: BigNumberish;
+    xHigh: BigNumberish;
+    yLow: BigNumberish;
+    yHigh: BigNumberish;
+}
+/**
+ * A Cairo `core::starknet::secp256k1::Secp256k1Point` : a point on the secp256k1 curve, the one
+ * Ethereum signs with.
+ *
+ * A point is two 256-bit coordinates, x and y, and Cairo carries each of them as two 128-bit
+ * limbs — so four felts in all, in the order `xLow, xHigh, yLow, yHigh`. The single number this
+ * class accepts is the 512-bit concatenation `x || y`, x in the upper half : that is the shape an
+ * uncompressed public key already has once its `04` prefix is dropped.
+ *
+ * Both ways in are supported : one number, or the four limbs directly, which is how a response is
+ * read back.
+ * @example
+ * ```typescript
+ * // one number, x in the upper 256 bits
+ * const point = new CairoSecp256k1Point(1n);
+ * point.toApiRequest(); // ["0", "0", "1", "0"]     x = 0, y = 1
+ *
+ * // the four limbs, as a call carries them
+ * const same = new CairoSecp256k1Point(0, 0, 1, 0);
+ * same.toBigInt(); // 1n
+ * ```
+ */
+declare class CairoSecp256k1Point {
+    /**
+     * The low 128 bits of the x coordinate.
+     * @example
+     * ```typescript
+     * const result = new CairoSecp256k1Point({ xLow: 1, xHigh: 2, yLow: 3, yHigh: 4 }).xLow;
+     * // result = 1n
+     * ```
+     */
+    xLow: bigint;
+    /**
+     * The high 128 bits of the x coordinate.
+     * @example
+     * ```typescript
+     * const result = new CairoSecp256k1Point({ xLow: 1, xHigh: 2, yLow: 3, yHigh: 4 }).xHigh;
+     * // result = 2n
+     * ```
+     */
+    xHigh: bigint;
+    /**
+     * The low 128 bits of the y coordinate.
+     * @example
+     * ```typescript
+     * const result = new CairoSecp256k1Point({ xLow: 1, xHigh: 2, yLow: 3, yHigh: 4 }).yLow;
+     * // result = 3n
+     * ```
+     */
+    yLow: bigint;
+    /**
+     * The high 128 bits of the y coordinate.
+     * @example
+     * ```typescript
+     * const result = new CairoSecp256k1Point({ xLow: 1, xHigh: 2, yLow: 3, yHigh: 4 }).yHigh;
+     * // result = 4n
+     * ```
+     */
+    yHigh: bigint;
+    /**
+     * The abi type this class serializes.
+     * @example
+     * ```typescript
+     * const result = CairoSecp256k1Point.abiSelector;
+     * // result = "core::starknet::secp256k1::Secp256k1Point"
+     * ```
+     */
+    static abiSelector: "core::starknet::secp256k1::Secp256k1Point";
+    /**
+     * Build from the 512-bit number `x || y`, or from an object carrying the four limbs.
+     */
+    constructor(input: BigNumberish | Secp256k1PointStruct | unknown);
+    /**
+     * Build from the four limbs, in the order a contract response returns them.
+     */
+    constructor(xLow: BigNumberish, xHigh: BigNumberish, yLow: BigNumberish, yHigh: BigNumberish);
+    /**
+     * Throw unless the value can be carried by a Secp256k1Point, and return it as a number.
+     *
+     * Unlike the other classes here this one gives the number back rather than returning nothing :
+     * the constructor needs it, and computing it twice would mean splitting a 512-bit value twice.
+     * @param {BigNumberish} input the 512-bit value to check
+     * @returns {bigint} the value, once checked
+     * @throws {Error} when the value is null, undefined, of an unread type, or outside [0, 2^512 - 1]
+     * @example
+     * ```typescript
+     * const result = CairoSecp256k1Point.validate('0x1234');
+     * // result = 4660n
+     * CairoSecp256k1Point.validate(SECP256K1_POINT_MAX + 1n);
+     * // throws Error("input is bigger than SECP256K1_POINT_MAX")
+     * ```
+     */
+    static validate(input: BigNumberish | unknown): bigint;
+    /**
+     * Throw unless the four limbs can each be carried by 128 bits, and return them as numbers.
+     * @param {BigNumberish} xLow the low 128 bits of x
+     * @param {BigNumberish} xHigh the high 128 bits of x
+     * @param {BigNumberish} yLow the low 128 bits of y
+     * @param {BigNumberish} yHigh the high 128 bits of y
+     * @returns {{xLow: bigint, xHigh: bigint, yLow: bigint, yHigh: bigint}} the four limbs, checked
+     * @throws {Error} when a limb is null, undefined, not a number, negative, or wider than 128 bits
+     * @example
+     * ```typescript
+     * const result = CairoSecp256k1Point.validateProps(1, 2, 3, 4);
+     * // result = { xLow: 1n, xHigh: 2n, yLow: 3n, yHigh: 4n }
+     * CairoSecp256k1Point.validateProps(1, 2, 3, 2n ** 128n);
+     * // throws Error("yHigh must fit in 128 bits")
+     * ```
+     */
+    static validateProps(xLow: BigNumberish, xHigh: BigNumberish, yLow: BigNumberish, yHigh: BigNumberish): {
+        xLow: bigint;
+        xHigh: bigint;
+        yLow: bigint;
+        yHigh: bigint;
+    };
+    /**
+     * Can this value be carried by a Secp256k1Point?
+     *
+     * The non-throwing form of {@link CairoSecp256k1Point.validate}, so it answers false for every
+     * input that one refuses, whatever the reason.
+     * @param {any} data the value to test
+     * @returns {boolean} true when the value fits in 512 bits
+     * @example
+     * ```typescript
+     * const result = CairoSecp256k1Point.is(SECP256K1_POINT_MAX);
+     * // result = true
+     * const result2 = CairoSecp256k1Point.is(SECP256K1_POINT_MAX + 1n);
+     * // result2 = false
+     * ```
+     */
+    static is(data: any): boolean;
+    /**
+     * Is this abi type the one this class serializes?
+     * @param {string} abiType the abi type to test
+     * @returns {boolean} true for `core::starknet::secp256k1::Secp256k1Point`
+     * @example
+     * ```typescript
+     * const result = CairoSecp256k1Point.isAbiType('core::starknet::secp256k1::Secp256k1Point');
+     * // result = true
+     * const result2 = CairoSecp256k1Point.isAbiType('core::felt252');
+     * // result2 = false
+     * ```
+     */
+    static isAbiType(abiType: string): boolean;
+    /**
+     * Read one point off a contract response, advancing the iterator past its four felts.
+     * @param {Iterator<string>} responseIterator the response felts, positioned on this point
+     * @returns {CairoSecp256k1Point} the point that was read
+     * @example
+     * ```typescript
+     * const response = ['0x0', '0x0', '0x1', '0x0'];
+     * const result = CairoSecp256k1Point.factoryFromApiResponse(response.values()).toBigInt();
+     * // result = 1n
+     * ```
+     */
+    static factoryFromApiResponse(responseIterator: Iterator<string>): CairoSecp256k1Point;
+    /**
+     * The point as the single 512-bit number `x || y`.
+     *
+     * The inverse of what the constructor does with one number, so a point built that way comes back
+     * unchanged.
+     * @returns {bigint} the two coordinates concatenated, x in the upper 256 bits
+     * @example
+     * ```typescript
+     * const result = new CairoSecp256k1Point(1n).toBigInt();
+     * // result = 1n
+     * const result2 = new CairoSecp256k1Point(0, 0, 3, 0).toBigInt();
+     * // result2 = 3n
+     * ```
+     */
+    toBigInt(): bigint;
+    /**
+     * The four limbs as hexadecimal strings.
+     * @returns {Secp256k1PointStruct} the limbs, each 0x-prefixed and unpadded
+     * @example
+     * ```typescript
+     * const result = new CairoSecp256k1Point({ xLow: 1, xHigh: 2, yLow: 3, yHigh: 4 }).toStruct();
+     * // result = { xLow: "0x1", xHigh: "0x2", yLow: "0x3", yHigh: "0x4" }
+     * ```
+     */
+    toStruct(): Secp256k1PointStruct;
+    /**
+     * The point in hexadecimal, without padding.
+     * @returns {string} the 512-bit value as a 0x-prefixed hex string
+     * @example
+     * ```typescript
+     * const result = new CairoSecp256k1Point(4660n).toHexString();
+     * // result = "0x1234"
+     * ```
+     */
+    toHexString(): string;
+    /**
+     * Serialize to the four felts a contract call carries.
+     * @returns {string[]} the limbs as decimal strings, `[xLow, xHigh, yLow, yHigh]`, flagged as compiled
+     * @example
+     * ```typescript
+     * const result = new CairoSecp256k1Point({ xLow: 1, xHigh: 2, yLow: 3, yHigh: 4 }).toApiRequest();
+     * // result = ["1", "2", "3", "4"]
+     * ```
+     */
+    toApiRequest(): string[];
+    /**
+     * Build from a hexadecimal string spelling the 512-bit value.
+     *
+     * A shorter string is left-padded to the 128 hex digits a point occupies, so a small value is
+     * read as a point whose upper limbs are zero. A longer one is refused rather than truncated.
+     * @param {string} hexString the value, 0x-prefixed or not, at most 128 hex digits
+     * @returns {CairoSecp256k1Point} the point the string spells
+     * @throws {Error} when the string holds more than 128 hex digits
+     * @example
+     * ```typescript
+     * const result = CairoSecp256k1Point.fromHex('0x1').toApiRequest();
+     * // result = ["0", "0", "1", "0"]
+     * ```
+     */
+    static fromHex(hexString: string): CairoSecp256k1Point;
+}
+
 /**
  * Format a hex number to '0x' and 64 characters, adding leading zeros if necessary.
  *
@@ -14294,4 +14853,4 @@ declare class Logger {
  */
 declare const logger: Logger;
 
-export { type Abi, type AbiEntry, type AbiEntryType, type AbiEnum, type AbiEnums, type AbiEvent, type AbiEvents, type AbiInterfaces, AbiParser1, AbiParser2, AbiParserInterface, type AbiStruct, type AbiStructs, Account, type AccountHooks, AccountInterface, type AccountInvocationItem, type AccountInvocations, type AccountInvocationsFactoryDetails, type AccountOptions, type AllowArray, type ApiEstimateFeeResponse, type Args, type ArgsOrCalldata, type ArgsOrCalldataWithOptions, type ArraySignatureType, type AsyncContractFunction, type BLOCK_HASH, type BLOCK_NUMBER, BatchClient, type BatchClientOptions, type BigNumberish, type Block$1 as Block, type BlockIdentifier, type BlockNumber, BlockStatus, BlockTag, type BlockTransactionTrace, type BlockTransactionsTracesWithInitialReads, type BlockWithTxHashes, BrotherIdImpl, type BrotherIdProviderMethods, type BrotherProfile, type Builtins, type ByteArray, type ByteCode, type CairoAssembly, CairoByteArray, CairoBytes31, type CairoContract, CairoCustomEnum, type CairoEnum, type CairoEnumRaw, type CairoEvent, type CairoEventDefinition, type CairoEventVariant, CairoFelt252, CairoFixedArray, CairoInt128, CairoInt16, CairoInt32, CairoInt64, CairoInt8, CairoOption, CairoOptionVariant, CairoResult, CairoResultVariant, CairoUint128, CairoUint16, CairoUint256, CairoUint32, CairoUint512, CairoUint64, CairoUint8, CairoUint96, type CairoVersion, type Call, type CallContractResponse, CallData, type CallDetails, type CallOptions, type CallResult, type Calldata, type CommonContractOptions, type CompiledContract, type CompiledSierra, type CompiledSierraCasm, type CompilerVersion, type CompleteDeclareContractPayload, type CompressedProgram, Contract, type ContractClass, type ContractClassIdentifier, type ContractClassPayload, type ContractClassResponse, type ContractEntryPointFields, type ContractFunction, ContractInterface, type ContractOptions, type ContractVersion, type DeclareAndDeployContractPayload, type DeclareContractPayload, type DeclareContractResponse, type DeclareContractTransaction, type DeclareDeployUDCResponse, type DeclareSignerDetails, type DeclareTransactionReceiptResponse, type DeclaredTransaction, type DeployAccountContractPayload, type DeployAccountContractTransaction, type DeployAccountSignerDetails, type DeployAccountTransactionReceiptResponse, type DeployAndInvokeTransaction, type DeployContractResponse, type DeployContractUDCResponse, type DeployTransaction, type DeployTransactionReceiptResponse, type DeployedAccountTransaction, Deployer, type DeployerCall, DeployerInterface, EDAMode, EDataAvailabilityMode, ESubscriptionTag, ETH_ADDRESS, ETraceFlag, ETransactionExecutionStatus, ETransactionStatus, ETransactionVersion, ETransactionVersion3, ETxnResponseFlag, type EVENTS_CHUNK, type EmittedEvent, EntryPointType, type EntryPointsByType, type ErrorReceiptResponseHelper, type EstimateFeeBulk, type EstimateFeeResponseBulkOverhead, type EstimateFeeResponseOverhead, EthSigner, type Event$1 as Event, type EventEntry, type EventFilter, type ExecutableDeployAndInvokeTransaction, type ExecutableDeployTransaction, type ExecutableInvokeTransaction, type ExecutableUserInvoke, type ExecutableUserTransaction, type ExecuteOptions, type ExecutionParameters, type FEE_ESTIMATE, type FELT, type FactoryParams, type FastExecuteAccountMethods, type FastExecuteProviderMethods, type FastExecuteResponse, type FastWaitForTransactionOptions, type FeeEstimate, type FeeMode, type FormatResponse, type FunctionAbi, type GasPrices, type GetBlockResponse, type GetTransactionReceiptResponse, type GetTransactionResponse, type GetTxReceiptResponseWithoutHelper, type HexCalldata, type Hint, HttpTransport, type HttpTransportOptions, type INITIAL_READS, Int, type InterfaceAbi, type Invocation, type Invocations, type InvocationsDetails, type InvocationsDetailsWithNonce, type InvocationsSignerDetails, type InvokeFunctionResponse, type InvokeTransaction, type InvokeTransactionReceiptResponse, type InvokedTransaction, type L1HandlerTransactionReceiptResponse, type L1_HANDLER_TXN, type LedgerPathCalculation, LedgerSigner111 as LedgerSigner, LedgerSigner111, LedgerSigner221, LedgerSigner231, type LegacyCompiledContract, type LegacyContractClass, type LegacyEvent, LibraryError, Literal, type LoadedContract, type LogLevel, LogLevelIndex, type Methods, type MultiDeployContractResponse, type MultiType, NON_ZERO_PREFIX, type Nonce, type OptionalPayload, type OutsideCall, type OutsideExecution, type OutsideExecutionOptions, OutsideExecutionTypesV1, OutsideExecutionTypesV2, OutsideExecutionVersion, type OutsideTransaction, type PRE_CONFIRMED_STATE_UPDATE, type PRICE_UNIT, type ParsedEvent, type ParsedEvents, type ParsedStruct, type ParsingStrategy, type PaymasterDetails, type PaymasterFeeEstimate, PaymasterInterface, type PaymasterOptions, PaymasterRpc, type PaymasterRpcOptions, type PaymasterTimeBounds, type PluginConfig, PluginManager, type PreConfirmedBlock, type PreConfirmedStateUpdate, type PreparedDeployAndInvokeTransaction, type PreparedDeployTransaction, type PreparedInvokeTransaction, type PreparedTransaction, type Program, RpcProvider as Provider, type ProviderHooks, ProviderInterface, type ProviderOptions, type ProviderOrAccount, type PythonicHints, type RESOURCE_PRICE, index$7 as RPC, index$5 as RPC0102, index$4 as RPC0103, index$6 as RPC09, RPCResponseParser, type RPC_ERROR, type RPC_ERROR_SET, type RawArgs, type RawArgsArray, type RawArgsObject, type RawCalldata, type Receipt, type ReconnectOptions, ReconnectingWsTransport, type ReconnectingWsTransportOptions, type RequiredKeysOf, type ResourceBounds, type ResourceBoundsBN, type ResourceBoundsOverhead, ResponseParser, type RevertedTransactionReceiptResponse, type RevertedTransactionReceiptResponseHelper, RpcChannel, RpcError, type RpcNotification, RpcProvider, type RpcProviderOptions, type RpcTransport, type SIMULATION_FLAG, type STATE_UPDATE, type STRK20_ACTION, type STRK20_CALL_AND_PROOF, type STRK20_SHADOW_ACCOUNT_INVOKE_ACTION, type SierraContractClass, type SierraContractEntryPointFields, type SierraEntryPointsByType, type SierraProgramDebugInfo, type Signature, Signer, SignerInterface, type Simplify, type SimulateTransaction, type SimulateTransactionDetails, type SimulateTransactionOverhead, type SimulateTransactionOverheadResponse, type SimulateTransactionResponse, type SimulationFlags, type StarkProfile, type StarknetIdAccountMethods, StarknetIdImpl, type StarknetIdProviderMethods, type StarknetPlugin, type StateUpdate, type StateUpdateResponse, type StorageResponse, type SubscribeEventsParams, type SubscribeNewHeadsParams, type SubscribeNewTransactionReceiptsParams, type SubscribeNewTransactionsParams, type SubscribeTransactionStatusParams, Subscription, type SubscriptionBlockIdentifier, type SubscriptionNewHeadsEvent, type SubscriptionNewTransactionEvent, type SubscriptionNewTransactionReceiptsEvent, type SubscriptionOptions, type SubscriptionOwner, type SubscriptionStarknetEventsEvent, type SubscriptionTransactionStatusEvent, type SuccessfulTransactionReceiptResponse, type SuccessfulTransactionReceiptResponseHelper, type TXN_EXECUTION_STATUS, type TXN_HASH, type TXN_STATUS, TimeoutError, type TipAnalysisOptions, type TipEstimate, type TipType, type TokenData, TransactionExecutionStatus, TransactionFinalityStatus, type TransactionReceipt, type TransactionReceiptCallbacks, type TransactionReceiptCallbacksDefault, type TransactionReceiptCallbacksDefined, type TransactionReceiptStatus, type TransactionReceiptValue, type TransactionStatus, type TransactionStatusReceiptSets, type TransactionTrace, TransactionType, type TransactionWithHash, type Tupled, type TypedContractV2, UINT_128_MAX, UINT_128_MIN, UINT_256_HIGH_MAX, UINT_256_HIGH_MIN, UINT_256_LOW_MAX, UINT_256_LOW_MIN, UINT_256_MAX, UINT_256_MIN, UINT_512_MAX, UINT_512_MIN, Uint, type Uint256, type Uint512, type UniversalDeployerContractPayload, type UniversalDetails, type UserInvoke, type UserTransaction, type V3DeclareSignerDetails, type V3DeployAccountSignerDetails, type V3InvocationsSignerDetails, type V3TransactionDetails, ValidateType, WalletAccount, WalletAccountV5, WalletAccountV6, WebSocketChannel, type WebSocketModule, WebSocketNotConnectedError, type WebSocketOptions, WebSocketProvider, type WebSocketProviderOptions, type WeierstrassSignatureType, type WithOptions, WsTransport, type WsTransportOptions, type WsTransportState, addAddressPadding, brotherId, byteArray, cairo, compareVersions, config, constants, contractClassResponseToLegacyCompiledContract, contractLoader, createAbiParser, createTransactionReceipt, defaultDeployer, defaultPlugins, ec, encode, eth, index as events, extractContractHashes, fastExecute, fastParsingStrategy, getAbiVersion, type getBlockTransactionsTracesOptions, getChecksumAddress, type getContractVersionOptions, type getEstimateFeeBulkOptions, getGasPrices, getLedgerPathBuffer111 as getLedgerPathBuffer, getLedgerPathBuffer111, getLedgerPathBuffer221, type getSimulateTransactionOptions, getTipStatsFromBlocks, index$3 as hash, hdParsingStrategy, isAccount, isFileSystemAvailable, isNoConstructorValid, isPreConfirmedBlock, isPreConfirmedStateUpdate, isPreConfirmedTransaction, isRPC08Plus_ResourceBounds, isRPC08Plus_ResourceBoundsBN, isSierra, isSupportedSpecVersion, isV3Tx, isVersion, json, legacyDeployer, logger, merkle, num, outsideExecution, parseCalldataField, paymaster, provider, selector, shortString, src5, index$1 as stark, starknetId, starknetId$1 as starknetIdPlugin, toAnyPatchVersion, toApiVersion, index$2 as transaction, typedData, uint256$1 as uint256, units, v3 as v3hash, validateAndParseAddress, validateChecksumAddress, verifyMessageInStarknet, type waitForTransactionOptions, connect as wallet, connectV5 as walletV5, connectV6 as walletV6 };
+export { type Abi, type AbiEntry, type AbiEntryType, type AbiEnum, type AbiEnums, type AbiEvent, type AbiEvents, type AbiInterfaces, AbiParser1, AbiParser2, AbiParserInterface, type AbiStruct, type AbiStructs, Account, type AccountHooks, AccountInterface, type AccountInvocationItem, type AccountInvocations, type AccountInvocationsFactoryDetails, type AccountOptions, type AllowArray, type ApiEstimateFeeResponse, type Args, type ArgsOrCalldata, type ArgsOrCalldataWithOptions, type ArraySignatureType, type AsyncContractFunction, type BLOCK_HASH, type BLOCK_NUMBER, BatchClient, type BatchClientOptions, type BigNumberish, type Block$1 as Block, type BlockIdentifier, type BlockNumber, BlockStatus, BlockTag, type BlockTransactionTrace, type BlockTransactionsTracesWithInitialReads, type BlockWithTxHashes, BrotherIdImpl, type BrotherIdProviderMethods, type BrotherProfile, type Builtins, type ByteArray, type ByteCode, type CairoAssembly, CairoBool, CairoByteArray, CairoBytes31, type CairoContract, CairoCustomEnum, type CairoEnum, type CairoEnumRaw, CairoEthAddress, type CairoEvent, type CairoEventDefinition, type CairoEventVariant, CairoFelt252, CairoFixedArray, CairoInt128, CairoInt16, CairoInt32, CairoInt64, CairoInt8, CairoOption, CairoOptionVariant, CairoResult, CairoResultVariant, CairoSecp256k1Point, CairoUint128, CairoUint16, CairoUint256, CairoUint32, CairoUint512, CairoUint64, CairoUint8, CairoUint96, type CairoVersion, type Call, type CallContractResponse, CallData, type CallDetails, type CallOptions, type CallResult, type Calldata, type CommonContractOptions, type CompiledContract, type CompiledSierra, type CompiledSierraCasm, type CompilerVersion, type CompleteDeclareContractPayload, type CompressedProgram, Contract, type ContractClass, type ContractClassIdentifier, type ContractClassPayload, type ContractClassResponse, type ContractEntryPointFields, type ContractFunction, ContractInterface, type ContractOptions, type ContractVersion, type DeclareAndDeployContractPayload, type DeclareContractPayload, type DeclareContractResponse, type DeclareContractTransaction, type DeclareDeployUDCResponse, type DeclareSignerDetails, type DeclareTransactionReceiptResponse, type DeclaredTransaction, type DeployAccountContractPayload, type DeployAccountContractTransaction, type DeployAccountSignerDetails, type DeployAccountTransactionReceiptResponse, type DeployAndInvokeTransaction, type DeployContractResponse, type DeployContractUDCResponse, type DeployTransaction, type DeployTransactionReceiptResponse, type DeployedAccountTransaction, Deployer, type DeployerCall, DeployerInterface, EDAMode, EDataAvailabilityMode, ESubscriptionTag, ETH_ADDRESS, ETraceFlag, ETransactionExecutionStatus, ETransactionStatus, ETransactionVersion, ETransactionVersion3, ETxnResponseFlag, type EVENTS_CHUNK, type EmittedEvent, EntryPointType, type EntryPointsByType, type ErrorReceiptResponseHelper, type EstimateFeeBulk, type EstimateFeeResponseBulkOverhead, type EstimateFeeResponseOverhead, EthSigner, type Event$1 as Event, type EventEntry, type EventFilter, type ExecutableDeployAndInvokeTransaction, type ExecutableDeployTransaction, type ExecutableInvokeTransaction, type ExecutableUserInvoke, type ExecutableUserTransaction, type ExecuteOptions, type ExecutionParameters, type FEE_ESTIMATE, type FELT, type FactoryParams, type FastExecuteAccountMethods, type FastExecuteProviderMethods, type FastExecuteResponse, type FastWaitForTransactionOptions, type FeeEstimate, type FeeMode, type FormatResponse, type FunctionAbi, type GasPrices, type GetBlockResponse, type GetTransactionReceiptResponse, type GetTransactionResponse, type GetTxReceiptResponseWithoutHelper, type HexCalldata, type Hint, HttpTransport, type HttpTransportOptions, type INITIAL_READS, Int, type InterfaceAbi, type Invocation, type Invocations, type InvocationsDetails, type InvocationsDetailsWithNonce, type InvocationsSignerDetails, type InvokeFunctionResponse, type InvokeTransaction, type InvokeTransactionReceiptResponse, type InvokedTransaction, type L1HandlerTransactionReceiptResponse, type L1_HANDLER_TXN, type LedgerPathCalculation, LedgerSigner111 as LedgerSigner, LedgerSigner111, LedgerSigner221, LedgerSigner231, type LegacyCompiledContract, type LegacyContractClass, type LegacyEvent, LibraryError, Literal, type LoadedContract, type LogLevel, LogLevelIndex, type Methods, type MultiDeployContractResponse, type MultiType, NON_ZERO_PREFIX, type Nonce, type OptionalPayload, type OutsideCall, type OutsideExecution, type OutsideExecutionOptions, OutsideExecutionTypesV1, OutsideExecutionTypesV2, OutsideExecutionVersion, type OutsideTransaction, type PRE_CONFIRMED_STATE_UPDATE, type PRICE_UNIT, type ParsedEvent, type ParsedEvents, type ParsedStruct, type ParsingStrategy, type PaymasterDetails, type PaymasterFeeEstimate, PaymasterInterface, type PaymasterOptions, PaymasterRpc, type PaymasterRpcOptions, type PaymasterTimeBounds, type PluginConfig, PluginManager, type PreConfirmedBlock, type PreConfirmedStateUpdate, type PreparedDeployAndInvokeTransaction, type PreparedDeployTransaction, type PreparedInvokeTransaction, type PreparedTransaction, type Program, RpcProvider as Provider, type ProviderHooks, ProviderInterface, type ProviderOptions, type ProviderOrAccount, type PythonicHints, type RESOURCE_PRICE, index$7 as RPC, index$5 as RPC0102, index$4 as RPC0103, index$6 as RPC09, RPCResponseParser, type RPC_ERROR, type RPC_ERROR_SET, type RawArgs, type RawArgsArray, type RawArgsObject, type RawCalldata, type Receipt, type ReconnectOptions, ReconnectingWsTransport, type ReconnectingWsTransportOptions, type RequiredKeysOf, type ResourceBounds, type ResourceBoundsBN, type ResourceBoundsOverhead, ResponseParser, type RevertedTransactionReceiptResponse, type RevertedTransactionReceiptResponseHelper, RpcChannel, RpcError, type RpcNotification, RpcProvider, type RpcProviderOptions, type RpcTransport, SECP256K1_POINT_MAX, SECP256K1_POINT_MIN, type SIMULATION_FLAG, type STATE_UPDATE, type STRK20_ACTION, type STRK20_CALL_AND_PROOF, type STRK20_SHADOW_ACCOUNT_INVOKE_ACTION, type Secp256k1PointStruct, type SierraContractClass, type SierraContractEntryPointFields, type SierraEntryPointsByType, type SierraProgramDebugInfo, type Signature, Signer, SignerInterface, type Simplify, type SimulateTransaction, type SimulateTransactionDetails, type SimulateTransactionOverhead, type SimulateTransactionOverheadResponse, type SimulateTransactionResponse, type SimulationFlags, type StarkProfile, type StarknetIdAccountMethods, StarknetIdImpl, type StarknetIdProviderMethods, type StarknetPlugin, type StateUpdate, type StateUpdateResponse, type StorageResponse, type SubscribeEventsParams, type SubscribeNewHeadsParams, type SubscribeNewTransactionReceiptsParams, type SubscribeNewTransactionsParams, type SubscribeTransactionStatusParams, Subscription, type SubscriptionBlockIdentifier, type SubscriptionNewHeadsEvent, type SubscriptionNewTransactionEvent, type SubscriptionNewTransactionReceiptsEvent, type SubscriptionOptions, type SubscriptionOwner, type SubscriptionStarknetEventsEvent, type SubscriptionTransactionStatusEvent, type SuccessfulTransactionReceiptResponse, type SuccessfulTransactionReceiptResponseHelper, type TXN_EXECUTION_STATUS, type TXN_HASH, type TXN_STATUS, TimeoutError, type TipAnalysisOptions, type TipEstimate, type TipType, type TokenData, TransactionExecutionStatus, TransactionFinalityStatus, type TransactionReceipt, type TransactionReceiptCallbacks, type TransactionReceiptCallbacksDefault, type TransactionReceiptCallbacksDefined, type TransactionReceiptStatus, type TransactionReceiptValue, type TransactionStatus, type TransactionStatusReceiptSets, type TransactionTrace, TransactionType, type TransactionWithHash, type Tupled, type TypedContractV2, UINT_128_MAX, UINT_128_MIN, UINT_256_HIGH_MAX, UINT_256_HIGH_MIN, UINT_256_LOW_MAX, UINT_256_LOW_MIN, UINT_256_MAX, UINT_256_MIN, UINT_512_MAX, UINT_512_MIN, Uint, type Uint256, type Uint512, type UniversalDeployerContractPayload, type UniversalDetails, type UserInvoke, type UserTransaction, type V3DeclareSignerDetails, type V3DeployAccountSignerDetails, type V3InvocationsSignerDetails, type V3TransactionDetails, ValidateType, WalletAccount, WalletAccountV5, WalletAccountV6, WebSocketChannel, type WebSocketModule, WebSocketNotConnectedError, type WebSocketOptions, WebSocketProvider, type WebSocketProviderOptions, type WeierstrassSignatureType, type WithOptions, WsTransport, type WsTransportOptions, type WsTransportState, addAddressPadding, brotherId, byteArray, cairo, compareVersions, config, constants, contractClassResponseToLegacyCompiledContract, contractLoader, createAbiParser, createTransactionReceipt, defaultDeployer, defaultPlugins, ec, encode, eth, index as events, extractContractHashes, fastExecute, fastParsingStrategy, getAbiVersion, type getBlockTransactionsTracesOptions, getChecksumAddress, type getContractVersionOptions, type getEstimateFeeBulkOptions, getGasPrices, getLedgerPathBuffer111 as getLedgerPathBuffer, getLedgerPathBuffer111, getLedgerPathBuffer221, type getSimulateTransactionOptions, getTipStatsFromBlocks, index$3 as hash, hdParsingStrategy, isAccount, isFileSystemAvailable, isNoConstructorValid, isPreConfirmedBlock, isPreConfirmedStateUpdate, isPreConfirmedTransaction, isRPC08Plus_ResourceBounds, isRPC08Plus_ResourceBoundsBN, isSierra, isSupportedSpecVersion, isV3Tx, isVersion, json, legacyDeployer, logger, merkle, num, outsideExecution, parseCalldataField, paymaster, provider, selector, shortString, src5, index$1 as stark, starknetId, starknetId$1 as starknetIdPlugin, toAnyPatchVersion, toApiVersion, index$2 as transaction, typedData, uint256$1 as uint256, units, v3 as v3hash, validateAndParseAddress, validateChecksumAddress, verifyMessageInStarknet, type waitForTransactionOptions, connect as wallet, connectV5 as walletV5, connectV6 as walletV6 };