starknet 11.1.0 → 11.2.0

package/CHANGELOG.md

@@ -1,3 +1,9 @@
+# [11.2.0](https://github.com/starknet-io/starknet.js/compare/v11.1.0...v11.2.0) (2026-10-12)
+
+### Features
+
+- **cairoDataTypes:** add CairoStorageAddress ([96ad4c6](https://github.com/starknet-io/starknet.js/commit/96ad4c6390c47dd8753f4d1ffdad63469007ab28)), closes [#1116](https://github.com/starknet-io/starknet.js/issues/1116)
+
 # [11.1.0](https://github.com/starknet-io/starknet.js/compare/v11.0.3...v11.1.0) (2026-10-06)
 
 ### Features

package/dist/index.d.ts

@@ -1712,6 +1712,9 @@ type _Transport = any;
  * Signer for accounts using a Ledger Nano S+/X signature (Starknet Ledger APP version 1.1.1)
  *
  * The Ledger has to be connected, unlocked and the Starknet APP has to be selected prior of use of this class.
+ * @deprecated Import it from `starknet/ledger` instead: it is the same class, with the transport typed as a
+ * Ledger `Transport`. Importing it from `starknet` is kept only for backward compatibility, and will be
+ * removed in v12.
  */
 declare class LedgerSigner111<Transport extends Record<any, any> = any> implements SignerInterface {
     readonly transporter: Transport;
@@ -1859,6 +1862,8 @@ declare class LedgerSigner111<Transport extends Record<any, any> = any> implemen
  * for a Ledger Starknet DAPP v1.1.1.
  *
  * EIP2645 path = 2645'/starknet/application/0/accountId/0
+ * @deprecated Import it from `starknet/ledger` instead: it is the same function. Importing it from
+ * `starknet` is kept only for backward compatibility, and will be removed in v12.
  * @param {number} accountId Id of account. < 2**31.
  * @param {string} [applicationName='LedgerW'] utf8 string of application name.
  * @returns an Uint8array of 24 bytes.
@@ -1878,6 +1883,9 @@ declare function getLedgerPathBuffer111(accountId: number, applicationName?: str
  * Signer for accounts using a Ledger Nano S+/X signature (Starknet Ledger APP version 2.2.1).
  *
  * The Ledger has to be connected, unlocked and the Starknet APP has to be selected prior of use of this class.
+ * @deprecated Import it from `starknet/ledger` instead: it is the same class, with the transport typed as a
+ * Ledger `Transport`. Importing it from `starknet` is kept only for backward compatibility, and will be
+ * removed in v12.
  */
 declare class LedgerSigner221<Transport extends Record<any, any> = any> extends LedgerSigner111 implements SignerInterface {
     /**
@@ -1893,13 +1901,13 @@ declare class LedgerSigner221<Transport extends Record<any, any> = any> extends
      *
      * If you are using APP v2.2.1 with an account created with the v1.1.1, you need to use :
      * ```typescript
-     * const myLedgerSigner = new LedgerSigner211(myNodeTransport, 0, undefined, getLedgerPathBuffer111);
+     * const myLedgerSigner = new LedgerSigner221(myNodeTransport, 0, undefined, getLedgerPathBuffer111);
      * ```
      * @example
      * ```typescript
      * import TransportNodeHid from "@ledgerhq/hw-transport-node-hid";
      * const myNodeTransport = await TransportNodeHid.create();
-     * const myLedgerSigner = new LedgerSigner211(myNodeTransport, 0);
+     * const myLedgerSigner = new LedgerSigner221(myNodeTransport, 0);
      * ```
      */
     constructor(transport: Transport, accountID: number, eip2645application?: string, pathFunction?: LedgerPathCalculation);
@@ -2042,12 +2050,14 @@ declare class LedgerSigner221<Transport extends Record<any, any> = any> extends
  * Format the Ledger wallet path to an Uint8Array.
  * for a Ledger Starknet DAPP v2.2.0
  * EIP2645 path = 2645'/starknet'/application'/0'/accountId'/0
+ * @deprecated Import it from `starknet/ledger` instead: it is the same function. Importing it from
+ * `starknet` is kept only for backward compatibility, and will be removed in v12.
  * @param {number} accountId Id of account. < 2**31.
  * @param {string} [applicationName='LedgerW'] utf8 string of application name.
  * @returns an Uint8array of 24 bytes.
  * @example
  * ```typescript
- * const result = getLedgerPathBuffer211(0);
+ * const result = getLedgerPathBuffer221(0);
  * // result = Uint8Array(24) [
  *   128,   0,  10,  85, 199, 65, 233, 201,
  *   171, 206, 231, 219, 128,  0,   0,   0,
@@ -2058,9 +2068,13 @@ declare class LedgerSigner221<Transport extends Record<any, any> = any> extends
 declare function getLedgerPathBuffer221(accountId: number, applicationName?: string): Uint8Array;
 
 /**
- * Signer for accounts using a Ledger Nano S+/X signature (Starknet Ledger APP version 2.3.1).
+ * Signer for accounts using a Ledger Nano S+/X signature (Starknet Ledger APP from version 2.3.1
+ * to 2.4.3).
  *
  * The Ledger has to be connected, unlocked and the Starknet APP has to be selected prior of use of this class.
+ * @deprecated Import it from `starknet/ledger` instead: it is the same class, with the transport typed as a
+ * Ledger `Transport`. Importing it from `starknet` is kept only for backward compatibility, and will be
+ * removed in v12.
  */
 declare class LedgerSigner231<Transport extends Record<any, any> = any> extends LedgerSigner221 implements SignerInterface {
     /**
@@ -3962,6 +3976,7 @@ declare const Literal: {
     readonly ClassHash: "core::starknet::class_hash::ClassHash";
     readonly ContractAddress: "core::starknet::contract_address::ContractAddress";
     readonly Secp256k1Point: "core::starknet::secp256k1::Secp256k1Point";
+    readonly StorageAddress: "core::starknet::storage_access::StorageAddress";
     readonly U96: "core::internal::bounded_int::BoundedInt::<0, 79228162514264337593543950335>";
 };
 type Literal = ValuesType<typeof Literal>;
@@ -8081,6 +8096,10 @@ declare const RANGE_CLASS_HASH: {
     readonly min: bigint;
     readonly max: bigint;
 };
+declare const RANGE_STORAGE_ADDRESS: {
+    readonly min: bigint;
+    readonly max: bigint;
+};
 declare const LegacyUDC: {
     readonly ADDRESS: "0x041a78e741e5af2fec34b695679bc6891742439f7afb8484ecd7766661ad02bf";
     readonly ENTRYPOINT: "deployContract";
@@ -8230,6 +8249,7 @@ declare const constants_RANGE_I16: typeof RANGE_I16;
 declare const constants_RANGE_I32: typeof RANGE_I32;
 declare const constants_RANGE_I64: typeof RANGE_I64;
 declare const constants_RANGE_I8: typeof RANGE_I8;
+declare const constants_RANGE_STORAGE_ADDRESS: typeof RANGE_STORAGE_ADDRESS;
 declare const constants_RANGE_U128: typeof RANGE_U128;
 declare const constants_RANGE_U16: typeof RANGE_U16;
 declare const constants_RANGE_U32: typeof RANGE_U32;
@@ -8248,7 +8268,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, 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_CLASS_HASH as RANGE_CLASS_HASH, constants_RANGE_CONTRACT_ADDRESS as RANGE_CONTRACT_ADDRESS, 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 };
+  export { constants_ADDR_BOUND as ADDR_BOUND, constants_API_VERSION as API_VERSION, 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_CLASS_HASH as RANGE_CLASS_HASH, constants_RANGE_CONTRACT_ADDRESS as RANGE_CONTRACT_ADDRESS, 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_STORAGE_ADDRESS as RANGE_STORAGE_ADDRESS, 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. */
@@ -9512,6 +9532,19 @@ declare function verifyMessageInStarknet(provider: ProviderInterface, message: B
 
 declare function getGasPrices(channel: RpcChannel$3 | RpcChannel$2, blockIdentifier?: BlockIdentifier): Promise<GasPrices>;
 
+/**
+ * @deprecated Use {@link RpcProvider} instead. `Provider` is an alias of it, kept only for
+ * backward compatibility, and will be removed in a future major version. The two are the same
+ * class, so the migration is a rename: no behavior changes.
+ */
+declare const Provider: typeof RpcProvider;
+/**
+ * @deprecated Use {@link RpcProvider} instead. `Provider` is an alias of it, kept only for
+ * backward compatibility, and will be removed in a future major version. The two are the same
+ * class, so the migration is a rename: no behavior changes.
+ */
+type Provider = RpcProvider;
+
 interface Account extends StarknetIdAccountMethods, BrotherIdProviderMethods, FastExecuteAccountMethods {
 }
 declare class Account implements AccountInterface {
@@ -16026,6 +16059,155 @@ declare class CairoContractAddress {
     static factoryFromApiResponse(responseIterator: Iterator<string>): CairoContractAddress;
 }
 
+/**
+ * A Cairo `core::starknet::storage_access::StorageAddress` : the address of a value in the storage
+ * of a contract.
+ *
+ * On the wire it is a field element like any other, so what this class adds over
+ * {@link CairoFelt252} is the bound of the Cairo `StorageAddress` type : [0, 2^251), the same range
+ * as the Cairo type of a class hash, and narrower than the field.
+ *
+ * A number, a bigint, a decimal string and a hexadecimal string are all read as the same number.
+ * Text is **not** an accepted input : a storage address spelled as words is a mistake, not a value.
+ * @example
+ * ```typescript
+ * // the same address, reached three ways
+ * new CairoStorageAddress('0x1234').toBigInt(); // 4660n
+ * new CairoStorageAddress(4660).toBigInt(); //    4660n
+ * new CairoStorageAddress('4660').toBigInt(); //  4660n
+ * ```
+ */
+declare class CairoStorageAddress {
+    /**
+     * The address, always as a bigint.
+     * @example
+     * ```typescript
+     * const result = new CairoStorageAddress('0x1234').data;
+     * // result = 4660n
+     * ```
+     */
+    data: bigint;
+    /**
+     * The abi type this class serializes.
+     * @example
+     * ```typescript
+     * const result = CairoStorageAddress.abiSelector;
+     * // result = "core::starknet::storage_access::StorageAddress"
+     * ```
+     */
+    static abiSelector: "core::starknet::storage_access::StorageAddress";
+    /**
+     * Build from a number or a numeric string, refusing text and anything outside the
+     * StorageAddress range.
+     * @param {BigNumberish | boolean} data the address to carry, within [0, 2^251 - 1]
+     * @throws {Error} when the value is text, a decimal number, not a felt252 input, or out of the StorageAddress range
+     * @example
+     * ```typescript
+     * const result = new CairoStorageAddress('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 CairoStorageAddress('0x1234').toApiRequest();
+     * // result = ["4660"]
+     * ```
+     */
+    toApiRequest(): string[];
+    /**
+     * The address as a number.
+     * @returns {bigint} the number this address holds
+     * @example
+     * ```typescript
+     * const result = new CairoStorageAddress('0x1234').toBigInt();
+     * // result = 4660n
+     * ```
+     */
+    toBigInt(): bigint;
+    /**
+     * The address in hexadecimal, without padding.
+     *
+     * 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 CairoStorageAddress(4660).toHexString();
+     * // result = "0x1234"
+     * const result2 = new CairoStorageAddress('0x0034').toHexString();
+     * // result2 = "0x34"     (four digits in, two out)
+     * ```
+     */
+    toHexString(): string;
+    /**
+     * Throw unless the value can be carried by a StorageAddress.
+     *
+     * Text is refused first, then a number with a decimal part. A number or a bigint is read as it
+     * is, so that a negative one reaches the range check. Anything else is read as a felt252 — which
+     * is what refuses a null, an object or an unsupported type. The value is finally checked against
+     * the range of the Cairo `StorageAddress` type, [0, 2^251), which is narrower than the field.
+     * @param {BigNumberish | boolean} data the value to check
+     * @throws {Error} when the value is text, a decimal number, not a felt252 input, or out of the StorageAddress range
+     * @example
+     * ```typescript
+     * CairoStorageAddress.validate('0x1234'); // passes
+     * CairoStorageAddress.validate('abc');
+     * // throws Error("Invalid input: a StorageAddress cannot be built from text")
+     * CairoStorageAddress.validate(2n ** 251n);
+     * // throws Error("Value is out of StorageAddress range [0, 3618502788666131106986593281521497120414687020801267626233049500247285301247]")
+     * CairoStorageAddress.validate(-1);
+     * // throws Error("Value is out of StorageAddress range [0, 3618502788666131106986593281521497120414687020801267626233049500247285301247]")
+     * ```
+     */
+    static validate(data: BigNumberish | boolean | unknown): void;
+    /**
+     * Can this value be carried by a StorageAddress?
+     *
+     * The non-throwing form of {@link CairoStorageAddress.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 a StorageAddress
+     * @example
+     * ```typescript
+     * const result = CairoStorageAddress.is('0x1234');
+     * // result = true
+     * const result2 = CairoStorageAddress.is('abc');
+     * // result2 = false     (text, not a number)
+     * ```
+     */
+    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::storage_access::StorageAddress`
+     * @example
+     * ```typescript
+     * const result = CairoStorageAddress.isAbiType(
+     *   'core::starknet::storage_access::StorageAddress'
+     * );
+     * // result = true
+     * const result2 = CairoStorageAddress.isAbiType('core::felt252');
+     * // result2 = false
+     * ```
+     */
+    static isAbiType(abiType: string): boolean;
+    /**
+     * Read one StorageAddress off a contract response, advancing the iterator past it.
+     * @param {Iterator<string>} responseIterator the response felts, positioned on this address
+     * @returns {CairoStorageAddress} the address that was read
+     * @example
+     * ```typescript
+     * const response = ['0x1234'];
+     * const result = CairoStorageAddress.factoryFromApiResponse(response.values()).toBigInt();
+     * // result = 4660n
+     * ```
+     */
+    static factoryFromApiResponse(responseIterator: Iterator<string>): CairoStorageAddress;
+}
+
 /**
  * A Cairo dynamic array : any number of values, all of the same type.
  *
@@ -18155,4 +18337,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, AbiParser0, 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, CairoArray, type CairoAssembly, CairoBool, CairoByteArray, CairoBytes31, CairoClassHash, type CairoContract, CairoContractAddress, CairoCustomEnum, type CairoEnum, type CairoEnumRaw, CairoEthAddress, type CairoEvent, type CairoEventDefinition, type CairoEventVariant, CairoFelt252, CairoFixedArray, CairoInt128, CairoInt16, CairoInt32, CairoInt64, CairoInt8, CairoNonZero, CairoOption, CairoOptionVariant, CairoResult, CairoResultVariant, CairoSecp256k1Point, CairoStruct, CairoTuple, type CairoType, CairoTypeCustomEnum, CairoTypeOption, CairoTypeResult, type CairoTypeStrategy, 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$8 as RPC, index$6 as RPC0102, index$5 as RPC0103, index$4 as RPC0104, index$7 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, type VariantType, 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, cairoTypeStrategy, compareVersions, config, constants, contractClassResponseToLegacyCompiledContract, contractLoader, createAbiParser, createTransactionReceipt, defaultDeployer, defaultPlugins, ec, encode, enumStrategy, eth, index as events, extractContractHashes, fastCairoTypeStrategy, 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, isCairoType, 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, structStrategy, toAnyPatchVersion, toApiVersion, toReleaseVersion, index$2 as transaction, typedData, 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, AbiParser0, 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, CairoArray, type CairoAssembly, CairoBool, CairoByteArray, CairoBytes31, CairoClassHash, type CairoContract, CairoContractAddress, CairoCustomEnum, type CairoEnum, type CairoEnumRaw, CairoEthAddress, type CairoEvent, type CairoEventDefinition, type CairoEventVariant, CairoFelt252, CairoFixedArray, CairoInt128, CairoInt16, CairoInt32, CairoInt64, CairoInt8, CairoNonZero, CairoOption, CairoOptionVariant, CairoResult, CairoResultVariant, CairoSecp256k1Point, CairoStorageAddress, CairoStruct, CairoTuple, type CairoType, CairoTypeCustomEnum, CairoTypeOption, CairoTypeResult, type CairoTypeStrategy, 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, Provider, type ProviderHooks, ProviderInterface, type ProviderOptions, type ProviderOrAccount, type PythonicHints, type RESOURCE_PRICE, index$8 as RPC, index$6 as RPC0102, index$5 as RPC0103, index$4 as RPC0104, index$7 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, type VariantType, 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, cairoTypeStrategy, compareVersions, config, constants, contractClassResponseToLegacyCompiledContract, contractLoader, createAbiParser, createTransactionReceipt, defaultDeployer, defaultPlugins, ec, encode, enumStrategy, eth, index as events, extractContractHashes, fastCairoTypeStrategy, 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, isCairoType, 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, structStrategy, toAnyPatchVersion, toApiVersion, toReleaseVersion, index$2 as transaction, typedData, uint256, units, v3 as v3hash, validateAndParseAddress, validateChecksumAddress, verifyMessageInStarknet, type waitForTransactionOptions, connect as wallet, connectV5 as walletV5, connectV6 as walletV6 };

package/dist/index.global.js

@@ -77,6 +77,7 @@ var starknet = (() => {
     CairoResult: () => CairoResult,
     CairoResultVariant: () => CairoResultVariant,
     CairoSecp256k1Point: () => CairoSecp256k1Point,
+    CairoStorageAddress: () => CairoStorageAddress,
     CairoStruct: () => CairoStruct,
     CairoTuple: () => CairoTuple,
     CairoTypeCustomEnum: () => CairoTypeCustomEnum,
@@ -123,7 +124,7 @@ var starknet = (() => {
     PaymasterInterface: () => PaymasterInterface,
     PaymasterRpc: () => PaymasterRpc,
     PluginManager: () => PluginManager,
-    Provider: () => RpcProvider,
+    Provider: () => Provider,
     ProviderInterface: () => ProviderInterface,
     RPC: () => api_exports3,
     RPC0102: () => v0_10_2_exports,
@@ -269,6 +270,7 @@ var starknet = (() => {
     RANGE_I32: () => RANGE_I32,
     RANGE_I64: () => RANGE_I64,
     RANGE_I8: () => RANGE_I8,
+    RANGE_STORAGE_ADDRESS: () => RANGE_STORAGE_ADDRESS,
     RANGE_U128: () => RANGE_U128,
     RANGE_U16: () => RANGE_U16,
     RANGE_U32: () => RANGE_U32,
@@ -1236,6 +1238,7 @@ var starknet = (() => {
   var RANGE_ETH_ADDRESS = range(ZERO, 2n ** 160n - 1n);
   var RANGE_CONTRACT_ADDRESS = range(ZERO, ADDR_BOUND - 1n);
   var RANGE_CLASS_HASH = range(ZERO, 2n ** 251n - 1n);
+  var RANGE_STORAGE_ADDRESS = range(ZERO, 2n ** 251n - 1n);
   var LegacyUDC = {
     ADDRESS: "0x041a78e741e5af2fec34b695679bc6891742439f7afb8484ecd7766661ad02bf",
     ENTRYPOINT: "deployContract"
@@ -3203,6 +3206,7 @@ ${indent}}` : "}";
     ClassHash: "core::starknet::class_hash::ClassHash",
     ContractAddress: "core::starknet::contract_address::ContractAddress",
     Secp256k1Point: "core::starknet::secp256k1::Secp256k1Point",
+    StorageAddress: "core::starknet::storage_access::StorageAddress",
     U96: "core::internal::bounded_int::BoundedInt::<0, 79228162514264337593543950335>"
   };
   var ETH_ADDRESS = "core::starknet::eth_address::EthAddress";
@@ -13705,6 +13709,169 @@ ${indent}}` : "}";
     }
   };
 
+  // src/utils/cairoDataTypes/storageAddress.ts
+  var CairoStorageAddress = class _CairoStorageAddress {
+    /**
+     * The address, always as a bigint.
+     * @example
+     * ```typescript
+     * const result = new CairoStorageAddress('0x1234').data;
+     * // result = 4660n
+     * ```
+     */
+    data;
+    /**
+     * The abi type this class serializes.
+     * @example
+     * ```typescript
+     * const result = CairoStorageAddress.abiSelector;
+     * // result = "core::starknet::storage_access::StorageAddress"
+     * ```
+     */
+    static abiSelector = Literal.StorageAddress;
+    /**
+     * Build from a number or a numeric string, refusing text and anything outside the
+     * StorageAddress range.
+     * @param {BigNumberish | boolean} data the address to carry, within [0, 2^251 - 1]
+     * @throws {Error} when the value is text, a decimal number, not a felt252 input, or out of the StorageAddress range
+     * @example
+     * ```typescript
+     * const result = new CairoStorageAddress('0x1234').toApiRequest();
+     * // result = ["4660"]
+     * ```
+     */
+    constructor(data) {
+      _CairoStorageAddress.validate(data);
+      this.data = new CairoFelt252(data).toBigInt();
+    }
+    /**
+     * Serialize to the single felt a contract call carries.
+     * @returns {string[]} one decimal-string felt, flagged as compiled
+     * @example
+     * ```typescript
+     * const result = new CairoStorageAddress('0x1234').toApiRequest();
+     * // result = ["4660"]
+     * ```
+     */
+    toApiRequest() {
+      return addCompiledFlag([this.toBigInt().toString()]);
+    }
+    /**
+     * The address as a number.
+     * @returns {bigint} the number this address holds
+     * @example
+     * ```typescript
+     * const result = new CairoStorageAddress('0x1234').toBigInt();
+     * // result = 4660n
+     * ```
+     */
+    toBigInt() {
+      return this.data;
+    }
+    /**
+     * The address in hexadecimal, without padding.
+     *
+     * 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 CairoStorageAddress(4660).toHexString();
+     * // result = "0x1234"
+     * const result2 = new CairoStorageAddress('0x0034').toHexString();
+     * // result2 = "0x34"     (four digits in, two out)
+     * ```
+     */
+    toHexString() {
+      return addHexPrefix(this.toBigInt().toString(16));
+    }
+    /**
+     * Throw unless the value can be carried by a StorageAddress.
+     *
+     * Text is refused first, then a number with a decimal part. A number or a bigint is read as it
+     * is, so that a negative one reaches the range check. Anything else is read as a felt252 — which
+     * is what refuses a null, an object or an unsupported type. The value is finally checked against
+     * the range of the Cairo `StorageAddress` type, [0, 2^251), which is narrower than the field.
+     * @param {BigNumberish | boolean} data the value to check
+     * @throws {Error} when the value is text, a decimal number, not a felt252 input, or out of the StorageAddress range
+     * @example
+     * ```typescript
+     * CairoStorageAddress.validate('0x1234'); // passes
+     * CairoStorageAddress.validate('abc');
+     * // throws Error("Invalid input: a StorageAddress cannot be built from text")
+     * CairoStorageAddress.validate(2n ** 251n);
+     * // throws Error("Value is out of StorageAddress range [0, 3618502788666131106986593281521497120414687020801267626233049500247285301247]")
+     * CairoStorageAddress.validate(-1);
+     * // throws Error("Value is out of StorageAddress range [0, 3618502788666131106986593281521497120414687020801267626233049500247285301247]")
+     * ```
+     */
+    static validate(data) {
+      assert(!isText(data), "Invalid input: a StorageAddress cannot be built from text");
+      assert(
+        !isNumber2(data) || Number.isInteger(data),
+        "Invalid input: decimal numbers are not supported, only integers"
+      );
+      const value = isNumber2(data) || isBigInt(data) ? BigInt(data) : new CairoFelt252(data).toBigInt();
+      assert(
+        value >= RANGE_STORAGE_ADDRESS.min && value <= RANGE_STORAGE_ADDRESS.max,
+        `Value is out of StorageAddress range [${RANGE_STORAGE_ADDRESS.min}, ${RANGE_STORAGE_ADDRESS.max}]`
+      );
+    }
+    /**
+     * Can this value be carried by a StorageAddress?
+     *
+     * The non-throwing form of {@link CairoStorageAddress.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 a StorageAddress
+     * @example
+     * ```typescript
+     * const result = CairoStorageAddress.is('0x1234');
+     * // result = true
+     * const result2 = CairoStorageAddress.is('abc');
+     * // result2 = false     (text, not a number)
+     * ```
+     */
+    static is(data) {
+      try {
+        _CairoStorageAddress.validate(data);
+        return true;
+      } catch {
+        return false;
+      }
+    }
+    /**
+     * Is this abi type the one this class serializes?
+     * @param {string} abiType the abi type to test
+     * @returns {boolean} true for `core::starknet::storage_access::StorageAddress`
+     * @example
+     * ```typescript
+     * const result = CairoStorageAddress.isAbiType(
+     *   'core::starknet::storage_access::StorageAddress'
+     * );
+     * // result = true
+     * const result2 = CairoStorageAddress.isAbiType('core::felt252');
+     * // result2 = false
+     * ```
+     */
+    static isAbiType(abiType) {
+      return abiType === _CairoStorageAddress.abiSelector;
+    }
+    /**
+     * Read one StorageAddress off a contract response, advancing the iterator past it.
+     * @param {Iterator<string>} responseIterator the response felts, positioned on this address
+     * @returns {CairoStorageAddress} the address that was read
+     * @example
+     * ```typescript
+     * const response = ['0x1234'];
+     * const result = CairoStorageAddress.factoryFromApiResponse(response.values()).toBigInt();
+     * // result = 4660n
+     * ```
+     */
+    static factoryFromApiResponse(responseIterator) {
+      return new _CairoStorageAddress(getNext(responseIterator));
+    }
+  };
+
   // src/utils/cairoDataTypes/ethAddress.ts
   var CairoEthAddress = class _CairoEthAddress {
     /**
@@ -16111,6 +16278,7 @@ ${indent}}` : "}";
     CairoEthAddress,
     CairoClassHash,
     CairoContractAddress,
+    CairoStorageAddress,
     CairoBytes31,
     CairoByteArray,
     CairoSecp256k1Point,
@@ -16184,6 +16352,7 @@ ${indent}}` : "}";
       [CairoEthAddress.abiSelector]: (instance) => instance.toBigInt(),
       [CairoClassHash.abiSelector]: (instance) => instance.toBigInt(),
       [CairoContractAddress.abiSelector]: (instance) => instance.toBigInt(),
+      [CairoStorageAddress.abiSelector]: (instance) => instance.toBigInt(),
       [CairoBytes31.abiSelector]: (instance) => instance.decodeUtf8(),
       [CairoByteArray.abiSelector]: (instance) => instance.decodeUtf8(),
       [CairoSecp256k1Point.abiSelector]: (instance) => instance.toBigInt(),
@@ -23091,6 +23260,9 @@ ${indent}}` : "}";
     WebSocketProvider.prototype[Symbol.dispose] = WebSocketProvider.prototype.dispose;
   }
 
+  // src/provider/index.ts
+  var Provider = RpcProvider;
+
   // src/signer/interface.ts
   var SignerInterface = class {
   };
@@ -23554,13 +23726,13 @@ ${indent}}` : "}";
      *
      * If you are using APP v2.2.1 with an account created with the v1.1.1, you need to use :
      * ```typescript
-     * const myLedgerSigner = new LedgerSigner211(myNodeTransport, 0, undefined, getLedgerPathBuffer111);
+     * const myLedgerSigner = new LedgerSigner221(myNodeTransport, 0, undefined, getLedgerPathBuffer111);
      * ```
      * @example
      * ```typescript
      * import TransportNodeHid from "@ledgerhq/hw-transport-node-hid";
      * const myNodeTransport = await TransportNodeHid.create();
-     * const myLedgerSigner = new LedgerSigner211(myNodeTransport, 0);
+     * const myLedgerSigner = new LedgerSigner221(myNodeTransport, 0);
      * ```
      */
     constructor(transport, accountID, eip2645application = "LedgerW", pathFunction = getLedgerPathBuffer221) {