starknet 9.3.0 → 9.4.0

package/CHANGELOG.md

@@ -1,3 +1,18 @@
+# [9.4.0](https://github.com/starknet-io/starknet.js/compare/v9.3.0...v9.4.0) (2026-02-06)
+
+### Bug Fixes
+
+- add ci release permissions to the top calling workflow not just \_release ([1e9376c](https://github.com/starknet-io/starknet.js/commit/1e9376cff1c79b8403b2b37f7205635689928a8c))
+- audit package fix ([e34813e](https://github.com/starknet-io/starknet.js/commit/e34813ea466ac0efd08fff8810af2cdab75c89c5))
+- fix to trigger release ([87dc498](https://github.com/starknet-io/starknet.js/commit/87dc498e846ce4a3711d152501f68fb3a3d8beb6))
+- iffe shim plugin skip packing fs and path ([8dcb136](https://github.com/starknet-io/starknet.js/commit/8dcb136fcb2c1216ed4cb643a388812d6b2bdf22))
+- is file system available log ([23524ec](https://github.com/starknet-io/starknet.js/commit/23524ec7a9717be69bacd021ff60e26c8bf0d1a4))
+- resolve relative and absolute path ([9b69257](https://github.com/starknet-io/starknet.js/commit/9b69257c96e166726e5e4243690262fe7d5ceec7))
+
+### Features
+
+- contractLoader ([e4e837e](https://github.com/starknet-io/starknet.js/commit/e4e837e3393d6fb5db1eb20e699bde80efee57c4))
+
 # [9.3.0](https://github.com/starknet-io/starknet.js/compare/v9.2.2...v9.3.0) (2025-12-19)
 
 ### Features

package/dist/index.d.ts

@@ -9395,6 +9395,67 @@ declare class CallData {
     decodeParameters(typeCairo: AllowArray<string>, response: string[]): AllowArray<CallResult>;
 }
 
+type LoadedContract = {
+    sierra: CompiledSierra;
+    casm: CairoAssembly;
+    compiler?: string;
+    compiledClassHash?: never;
+} | {
+    sierra: CompiledSierra;
+    casm?: never;
+    compiler?: string;
+    compiledClassHash: string;
+};
+/**
+ * Helper function to check if filesystem access is available (Node.js environment)
+ * @return {boolean} - Returns true if running in Node.js with fs module available
+ */
+declare function isFileSystemAvailable(): boolean;
+/**
+ * Loads a Cairo contract from filesystem (Node.js) or File object (browser).
+ *
+ * **Node.js usage:**
+ * Accepts a directory path or a direct path to a .sierra.json or .casm file.
+ * - If a directory is provided: searches for .sierra.json and .casm files
+ * - If a file path is provided: loads that file and attempts to find the complementary file
+ * - If compiledClassHash is provided: .casm file is optional
+ * - If compiledClassHash is NOT provided: .casm file is required
+ *
+ * **Browser usage:**
+ * Accepts a File object (from file input or drag-and-drop).
+ * - Returns a Promise that resolves to LoadedContract
+ * - Automatically detects .sierra.json and .casm files
+ * - Can accept a single .sierra.json or .casm file, or multiple files
+ * - If compiledClassHash is provided: .casm file is optional
+ *
+ * @param {string | File | File[]} input - Path (Node.js) or File/File[] (browser)
+ * @param {string} [compiledClassHash] - Optional compiled class hash. If provided, .casm file becomes optional
+ * @return {LoadedContract | Promise<LoadedContract>} - Contract data (sync in Node.js, async in browser)
+ * @throws {Error} - If no .sierra.json file is found, or if .casm is missing when compiledClassHash is not provided
+ *
+ * @example
+ * ```typescript
+ * // Node.js: Load from directory (requires .casm)
+ * const contract = contractLoader('./contracts/my_contract');
+ *
+ * // Node.js: Load with compiledClassHash (no .casm needed)
+ * const contract = contractLoader('./contracts/my_contract', '0x1234...');
+ *
+ * // Node.js: Load from .sierra.json file
+ * const contract = contractLoader('./contracts/my_contract.sierra.json');
+ *
+ * // Browser: Load from file input
+ * const fileInput = document.querySelector('input[type="file"]');
+ * const contract = await contractLoader(fileInput.files[0]);
+ *
+ * // Browser: Load with compiledClassHash (no .casm needed)
+ * const contract = await contractLoader(sierraFile, '0x1234...');
+ * ```
+ */
+declare function contractLoader(contractPath: string, compiledClassHash?: string): LoadedContract;
+declare function contractLoader(file: File, compiledClassHash?: string): Promise<LoadedContract>;
+declare function contractLoader(files: File[], compiledClassHash?: string): Promise<LoadedContract>;
+
 /**
  * Checks if a given contract is in Sierra (Safe Intermediate Representation) format.
  *
@@ -9770,4 +9831,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, 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 BlockWithTxHashes, type Builtins, type ByteArray, type ByteCode, type CairoAssembly, CairoByteArray, CairoBytes31, type CairoContract, CairoCustomEnum, type CairoEnum, type CairoEnumRaw, type CairoEvent, type CairoEventDefinition, type CairoEventVariant, CairoFelt, 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, type Details, EDAMode, EDataAvailabilityMode, ETH_ADDRESS, ETransactionExecutionStatus, ETransactionStatus, ETransactionVersion, ETransactionVersion2, ETransactionVersion3, 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 FeeEstimate, type FeeMode, type FormatResponse, type FunctionAbi, type GasPrices, type GetBlockResponse, type GetTransactionReceiptResponse, type GetTransactionResponse, type GetTxReceiptResponseWithoutHelper, type HexCalldata, type Hint, 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 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 PreConfirmedBlock, type PreConfirmedStateUpdate, type PreparedDeployAndInvokeTransaction, type PreparedDeployTransaction, type PreparedInvokeTransaction, type PreparedTransaction, type Program, RpcProvider as Provider, ProviderInterface, type ProviderOptions, type ProviderOrAccount, type PythonicHints, type RESOURCE_PRICE, index$4 as RPC, rpc_0_10_0 as RPC010, rpc_0_9_0 as RPC09, RPCResponseParser, type RPC_ERROR, type RPC_ERROR_SET, type RawArgs, type RawArgsArray, type RawArgsObject, type RawCalldata, type Receipt, ReceiptTx, type ReconnectOptions, type RequiredKeysOf, type ResourceBounds, type ResourceBoundsBN, type ResourceBoundsOverhead, ResponseParser, type RevertedTransactionReceiptResponse, type RevertedTransactionReceiptResponseHelper, RpcChannel, RpcError, RpcProvider, type RpcProviderOptions, type SIMULATION_FLAG, type STATE_UPDATE, 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 StateUpdate, type StateUpdateResponse, type Storage, type SubscribeEventsParams, type SubscribeNewHeadsParams, type SubscribeNewTransactionReceiptsParams, type SubscribeNewTransactionsParams, type SubscribeTransactionStatusParams, Subscription, type SubscriptionBlockIdentifier, type SubscriptionNewHeadsEvent, type SubscriptionNewTransactionEvent, type SubscriptionNewTransactionReceiptsEvent, type SubscriptionOptions, 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, WebSocketChannel, type WebSocketModule, WebSocketNotConnectedError, type WebSocketOptions, type WeierstrassSignatureType, type WithOptions, addAddressPadding, byteArray, cairo, compareVersions, config, constants, contractClassResponseToLegacyCompiledContract, createAbiParser, createTransactionReceipt, defaultDeployer, defaultPaymaster, defaultProvider, ec, encode, eth, index as events, extractContractHashes, type fastExecuteResponse, fastParsingStrategy, type fastWaitForTransactionOptions, getAbiVersion, getChecksumAddress, type getContractVersionOptions, type getEstimateFeeBulkOptions, getGasPrices, getLedgerPathBuffer111 as getLedgerPathBuffer, getLedgerPathBuffer111, getLedgerPathBuffer221, type getSimulateTransactionOptions, getTipStatsFromBlocks, index$3 as hash, hdParsingStrategy, isAccount, 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, toAnyPatchVersion, toApiVersion, index$2 as transaction, typedData, uint256$1 as uint256, units, v2 as v2hash, v3 as v3hash, validateAndParseAddress, validateChecksumAddress, verifyMessageInStarknet, type waitForTransactionOptions, connect as wallet, connectV5 as walletV5 };
+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, 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 BlockWithTxHashes, type Builtins, type ByteArray, type ByteCode, type CairoAssembly, CairoByteArray, CairoBytes31, type CairoContract, CairoCustomEnum, type CairoEnum, type CairoEnumRaw, type CairoEvent, type CairoEventDefinition, type CairoEventVariant, CairoFelt, 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, type Details, EDAMode, EDataAvailabilityMode, ETH_ADDRESS, ETransactionExecutionStatus, ETransactionStatus, ETransactionVersion, ETransactionVersion2, ETransactionVersion3, 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 FeeEstimate, type FeeMode, type FormatResponse, type FunctionAbi, type GasPrices, type GetBlockResponse, type GetTransactionReceiptResponse, type GetTransactionResponse, type GetTxReceiptResponseWithoutHelper, type HexCalldata, type Hint, 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 PreConfirmedBlock, type PreConfirmedStateUpdate, type PreparedDeployAndInvokeTransaction, type PreparedDeployTransaction, type PreparedInvokeTransaction, type PreparedTransaction, type Program, RpcProvider as Provider, ProviderInterface, type ProviderOptions, type ProviderOrAccount, type PythonicHints, type RESOURCE_PRICE, index$4 as RPC, rpc_0_10_0 as RPC010, rpc_0_9_0 as RPC09, RPCResponseParser, type RPC_ERROR, type RPC_ERROR_SET, type RawArgs, type RawArgsArray, type RawArgsObject, type RawCalldata, type Receipt, ReceiptTx, type ReconnectOptions, type RequiredKeysOf, type ResourceBounds, type ResourceBoundsBN, type ResourceBoundsOverhead, ResponseParser, type RevertedTransactionReceiptResponse, type RevertedTransactionReceiptResponseHelper, RpcChannel, RpcError, RpcProvider, type RpcProviderOptions, type SIMULATION_FLAG, type STATE_UPDATE, 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 StateUpdate, type StateUpdateResponse, type Storage, type SubscribeEventsParams, type SubscribeNewHeadsParams, type SubscribeNewTransactionReceiptsParams, type SubscribeNewTransactionsParams, type SubscribeTransactionStatusParams, Subscription, type SubscriptionBlockIdentifier, type SubscriptionNewHeadsEvent, type SubscriptionNewTransactionEvent, type SubscriptionNewTransactionReceiptsEvent, type SubscriptionOptions, 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, WebSocketChannel, type WebSocketModule, WebSocketNotConnectedError, type WebSocketOptions, type WeierstrassSignatureType, type WithOptions, addAddressPadding, byteArray, cairo, compareVersions, config, constants, contractClassResponseToLegacyCompiledContract, contractLoader, createAbiParser, createTransactionReceipt, defaultDeployer, defaultPaymaster, defaultProvider, ec, encode, eth, index as events, extractContractHashes, type fastExecuteResponse, fastParsingStrategy, type fastWaitForTransactionOptions, getAbiVersion, 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, toAnyPatchVersion, toApiVersion, index$2 as transaction, typedData, uint256$1 as uint256, units, v2 as v2hash, v3 as v3hash, validateAndParseAddress, validateChecksumAddress, verifyMessageInStarknet, type waitForTransactionOptions, connect as wallet, connectV5 as walletV5 };

package/dist/index.global.js

@@ -4,6 +4,15 @@ var starknet = (() => {
   var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
   var __getOwnPropNames = Object.getOwnPropertyNames;
   var __hasOwnProp = Object.prototype.hasOwnProperty;
+  var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+    get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+  }) : x)(function(x) {
+    if (typeof require !== "undefined") return require.apply(this, arguments);
+    throw Error('Dynamic require of "' + x + '" is not supported');
+  });
+  var __commonJS = (cb, mod2) => function __require2() {
+    return mod2 || (0, cb[__getOwnPropNames(cb)[0]])((mod2 = { exports: {} }).exports, mod2), mod2.exports;
+  };
   var __export = (target, all) => {
     for (var name in all)
       __defProp(target, name, { get: all[name], enumerable: true });
@@ -18,6 +27,22 @@ var starknet = (() => {
   };
   var __toCommonJS = (mod2) => __copyProps(__defProp({}, "__esModule", { value: true }), mod2);
 
+  // browser-node-shim:fs
+  var require_fs = __commonJS({
+    "browser-node-shim:fs"(exports, module) {
+      "use strict";
+      module.exports = void 0;
+    }
+  });
+
+  // browser-node-shim:path
+  var require_path = __commonJS({
+    "browser-node-shim:path"(exports, module) {
+      "use strict";
+      module.exports = void 0;
+    }
+  });
+
   // src/index.ts
   var index_exports = {};
   __export(index_exports, {
@@ -123,6 +148,7 @@ var starknet = (() => {
     config: () => config,
     constants: () => constants_exports,
     contractClassResponseToLegacyCompiledContract: () => contractClassResponseToLegacyCompiledContract,
+    contractLoader: () => contractLoader,
     createAbiParser: () => createAbiParser,
     createTransactionReceipt: () => createTransactionReceipt,
     defaultDeployer: () => defaultDeployer,
@@ -144,6 +170,7 @@ var starknet = (() => {
     hash: () => hash_exports,
     hdParsingStrategy: () => hdParsingStrategy,
     isAccount: () => isAccount,
+    isFileSystemAvailable: () => isFileSystemAvailable,
     isNoConstructorValid: () => isNoConstructorValid,
     isPreConfirmedBlock: () => isPreConfirmedBlock,
     isPreConfirmedStateUpdate: () => isPreConfirmedStateUpdate,
@@ -14402,6 +14429,170 @@ ${indent}}` : "}";
     return convertStringToBigInt(resourceBounds);
   }
 
+  // src/utils/contractLoader.ts
+  function isFileSystemAvailable() {
+    try {
+      return typeof __require !== "undefined" && typeof __require.resolve === "function";
+    } catch {
+      logger.info("isFileSystemAvailable: false");
+      return false;
+    }
+  }
+  function contractLoader(input, compiledClassHash) {
+    if (typeof File !== "undefined" && (input instanceof File || Array.isArray(input))) {
+      return loadFromFileAPI(input, compiledClassHash);
+    }
+    if (typeof input === "string") {
+      if (!isFileSystemAvailable()) {
+        throw new Error(
+          'contractLoader with string paths is only available in Node.js environments. In browsers, please use File objects from <input type="file"> or drag-and-drop. Example: await contractLoader(fileInput.files[0])'
+        );
+      }
+      return loadFromFileSystem(input, compiledClassHash);
+    }
+    throw new Error(
+      "Invalid input type. Expected string (Node.js path) or File/File[] (browser File API)"
+    );
+  }
+  function loadFromFileSystem(contractPath, compiledClassHash) {
+    const fs = require_fs();
+    const path = require_path();
+    const resolvedPath = path.resolve(contractPath);
+    let dirPath;
+    let specifiedSierraFile;
+    let specifiedCasmFile;
+    const stats = fs.statSync(resolvedPath);
+    if (stats.isFile()) {
+      dirPath = path.dirname(resolvedPath);
+      const fileName = path.basename(resolvedPath);
+      if (fileName.endsWith(".sierra.json") || fileName.endsWith(".json") && !fileName.endsWith(".casm")) {
+        specifiedSierraFile = fileName;
+      } else if (fileName.endsWith(".casm")) {
+        specifiedCasmFile = fileName;
+      } else {
+        throw new Error(
+          `Invalid file type. Expected .json, .sierra.json, or .casm file, got: ${fileName}`
+        );
+      }
+    } else if (stats.isDirectory()) {
+      dirPath = resolvedPath;
+    } else {
+      throw new Error(`Path is neither a file nor a directory: ${contractPath}`);
+    }
+    const files = fs.readdirSync(dirPath);
+    let sierraFile;
+    let casmFile;
+    if (specifiedSierraFile) {
+      sierraFile = specifiedSierraFile;
+      const baseName = sierraFile.replace(/\.sierra\.json$/, "").replace(/\.json$/, "");
+      casmFile = files.find((f) => f === `${baseName}.casm`);
+    } else if (specifiedCasmFile) {
+      casmFile = specifiedCasmFile;
+      const baseName = casmFile.replace(/\.casm$/, "");
+      sierraFile = files.find((f) => f === `${baseName}.sierra.json`) || files.find((f) => f === `${baseName}.json`);
+    } else {
+      const sierraFiles = files.filter(
+        (f) => f.endsWith(".sierra.json") || f.endsWith(".json") && !f.endsWith(".casm")
+      );
+      if (sierraFiles.length === 0) {
+        throw new Error(`No .sierra.json file found in ${dirPath}. Sierra file is required.`);
+      }
+      if (sierraFiles.length > 1) {
+        throw new Error(
+          `Multiple .sierra.json files found in ${dirPath}: ${sierraFiles.join(", ")}. Please specify which file to use.`
+        );
+      }
+      [sierraFile] = sierraFiles;
+      const baseName = sierraFile.replace(/\.sierra\.json$/, "").replace(/\.json$/, "");
+      casmFile = files.find((f) => f === `${baseName}.casm`);
+    }
+    if (!sierraFile) {
+      throw new Error(`No .sierra.json file found in ${dirPath}. Sierra file is required.`);
+    }
+    const sierraPath = path.join(dirPath, sierraFile);
+    const sierraContent = parse2(fs.readFileSync(sierraPath, "utf8"));
+    if (casmFile) {
+      const casmPath = path.join(dirPath, casmFile);
+      const casmContent = parse2(fs.readFileSync(casmPath, "utf8"));
+      return {
+        sierra: sierraContent,
+        casm: casmContent,
+        compiler: casmContent.compiler_version
+      };
+    }
+    if (!compiledClassHash) {
+      throw new Error(
+        `No .casm file found for ${sierraFile} and no compiledClassHash provided. Either provide a .casm file or pass compiledClassHash as second parameter.`
+      );
+    }
+    return {
+      sierra: sierraContent,
+      compiledClassHash
+    };
+  }
+  async function loadFromFileAPI(input, compiledClassHash) {
+    const files = Array.isArray(input) ? input : [input];
+    if (files.length === 0) {
+      throw new Error("No files provided");
+    }
+    const sierraFiles = files.filter(
+      (file) => file.name.endsWith(".sierra.json") || file.name.endsWith(".json") && !file.name.endsWith(".casm")
+    );
+    const casmFiles = files.filter((file) => file.name.endsWith(".casm"));
+    if (sierraFiles.length > 1) {
+      throw new Error(
+        `Multiple .sierra.json files provided: ${sierraFiles.map((f) => f.name).join(", ")}. Please provide only one sierra file.`
+      );
+    }
+    if (casmFiles.length > 1) {
+      throw new Error(
+        `Multiple .casm files provided: ${casmFiles.map((f) => f.name).join(", ")}. Please provide only one casm file.`
+      );
+    }
+    const sierraFile = sierraFiles[0];
+    const casmFile = casmFiles[0];
+    if (!sierraFile) {
+      throw new Error(
+        `No .sierra.json file found in provided files. Sierra file is required. Provided files: ${files.map((f) => f.name).join(", ")}`
+      );
+    }
+    const sierraContent = parse2(await readFileAsText(sierraFile));
+    if (casmFile) {
+      const casmContent = parse2(await readFileAsText(casmFile));
+      return {
+        sierra: sierraContent,
+        casm: casmContent,
+        compiler: casmContent.compiler_version
+      };
+    }
+    if (!compiledClassHash) {
+      throw new Error(
+        "No .casm file found in provided files and no compiledClassHash provided. Either provide a .casm file or pass compiledClassHash as second parameter."
+      );
+    }
+    return {
+      sierra: sierraContent,
+      compiledClassHash
+    };
+  }
+  function readFileAsText(file) {
+    return new Promise((resolve, reject) => {
+      const reader = new FileReader();
+      reader.onload = (event) => {
+        const content = event.target?.result;
+        if (typeof content === "string") {
+          resolve(content);
+        } else {
+          reject(new Error(`Failed to read file ${file.name} as text`));
+        }
+      };
+      reader.onerror = () => {
+        reject(new Error(`Failed to read file ${file.name}: ${reader.error?.message}`));
+      };
+      reader.readAsText(file);
+    });
+  }
+
   // src/utils/contract.ts
   function isSierra(contract) {
     const compiledContract = isString(contract) ? parse2(contract) : contract;