starknet 10.0.0-beta.1 → 10.0.0-beta.2

package/CHANGELOG.md

@@ -1,3 +1,9 @@
+# [10.0.0-beta.2](https://github.com/starknet-io/starknet.js/compare/v10.0.0-beta.1...v10.0.0-beta.2) (2026-02-27)
+
+### Features
+
+- remove default providers - resolve unintended side effect initializations ([ea581a8](https://github.com/starknet-io/starknet.js/commit/ea581a821a517362886e16075068b8ce4104e7a7))
+
 # [10.0.0-beta.1](https://github.com/starknet-io/starknet.js/compare/v9.5.0-beta.2...v10.0.0-beta.1) (2026-02-24)
 
 - feat!: refactor Account to use composition pattern, plugin system, docs\ \ BREAKING CHANGE: Account no longer extends Provider. Provider methods must now be accessed via account.provider property. \ Changes: - Account uses composition instead of inheritance - Add plugin system to replace ts-mixer - Update all tests to use account.provider.xyz() - Create migration guide and plugin documentation ([31d9458](https://github.com/starknet-io/starknet.js/commit/31d94587676a543c71dbd64b92d0e65d0ee3aa38))

package/dist/index.d.ts

@@ -2327,8 +2327,6 @@ declare class PaymasterRpc implements PaymasterInterface {
     getSupportedTokens(): Promise<TokenData[]>;
 }
 
-declare const defaultPaymaster: PaymasterRpc;
-
 /**
  * Configuration options for creating an Account instance
  */
@@ -2973,7 +2971,6 @@ type RpcProviderOptions = {
     blockIdentifier?: BlockIdentifier;
     chainId?: _StarknetChainId;
     specVersion?: _SupportedRpcVersion;
-    default?: boolean;
     waitMode?: boolean;
     baseFetch?: WindowOrWorkerGlobalScope['fetch'];
     resourceBoundsOverhead?: ResourceBoundsOverhead | false;
@@ -3574,7 +3571,7 @@ type ContractOptions = {
     /**
      * Connect account to read and write methods
      * Connect provider to read methods
-     * @default defaultProvider
+     * @default creates a new RpcProvider if not provided
      */
     providerOrAccount?: ProviderOrAccount;
     /**
@@ -5575,8 +5572,6 @@ declare function verifyMessageInStarknet(provider: ProviderInterface, message: B
 
 declare function getGasPrices(channel: RpcChannel$1 | RpcChannel, blockIdentifier?: BlockIdentifier): Promise<GasPrices>;
 
-declare const defaultProvider: RpcProvider;
-
 declare class Account implements AccountInterface {
     provider: RpcProvider;
     signer: SignerInterface;
@@ -5891,8 +5886,9 @@ declare abstract class ContractInterface {
     abstract address: string;
     /**
      * Provider for read operations or Account for write operations
+     * Optional - a default RpcProvider will be created on first async operation if not provided
      */
-    abstract providerOrAccount: ProviderOrAccount;
+    abstract providerOrAccount?: ProviderOrAccount;
     /**
      * Optional contract class hash for optimization
      */
@@ -6081,10 +6077,11 @@ type TypedContractV2<TAbi extends Abi$1> = TypedContract<TAbi> & Contract;
 declare class Contract implements ContractInterface {
     abi: Abi;
     address: string;
-    providerOrAccount: ProviderOrAccount;
+    providerOrAccount?: ProviderOrAccount;
     classHash?: string;
     parseRequest: boolean;
     parseResponse: boolean;
+    private defaultProvider?;
     private structs;
     private events;
     readonly functions: {
@@ -6108,11 +6105,16 @@ declare class Contract implements ContractInterface {
      * @private
      */
     private get provider();
+    /**
+     * Lazily initialize and cache the default provider with node version detection
+     * @private
+     */
+    private ensureProvider;
     /**
      * @param options
      *  - abi: Abi of the contract object (required)
      *  - address: address to connect to (required)
-     *  - providerOrAccount?: Provider or Account to attach to (fallback to defaultProvider)
+     *  - providerOrAccount?: Provider or Account to attach to (optional, creates default RpcProvider on first use with auto node detection)
      *  - parseRequest?: compile and validate arguments (optional, default true)
      *  - parseResponse?: Parse elements of the response array and structuring them into response object (optional, default true)
      *  - parser?: Abi parser (optional, default createAbiParser(options.abi))
@@ -8461,16 +8463,15 @@ declare function extractAbi(contract: ContractClass): Abi;
 /**
  * Return randomly select available public node
  * @param {NetworkName} networkName NetworkName
- * @param {boolean} mute mute public node warning
  * @returns {string} default node url
  * @example
  * ```typescript
- * const result= provider.getDefaultNodeUrl(constants.NetworkName.SN_MAIN,false);
+ * const result= provider.getDefaultNodeUrl(constants.NetworkName.SN_MAIN);
  * // console : "Using default public node url, please provide nodeUrl in provider options!"
  * // result = "https://starknet-mainnet.public.blastapi.io/rpc/v0_9"
  * ```
  */
-declare const getDefaultNodeUrl: (networkName?: _NetworkName, mute?: boolean, rpcVersion?: _SupportedRpcVersion) => string;
+declare const getDefaultNodeUrl: (networkName?: _NetworkName, rpcVersion?: _SupportedRpcVersion) => string;
 /**
  * return Defaults RPC Nodes endpoints
  */
@@ -10184,4 +10185,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, 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, ESubscriptionTag, ETH_ADDRESS, ETraceFlag, ETransactionExecutionStatus, ETransactionStatus, ETransactionVersion, ETransactionVersion2, 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 FeeEstimate, type FeeMode, type FormatResponse, type FunctionAbi, type GasPrices, type GetBlockResponse, type GetTransactionReceiptResponse, type GetTransactionResponse, type GetTxReceiptResponseWithoutHelper, type HexCalldata, type Hint, 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$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 StarknetIdAccountMethods, StarknetIdImpl, type StarknetIdProviderMethods, type StarknetPlugin, 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, brotherId, byteArray, cairo, compareVersions, config, constants, contractClassResponseToLegacyCompiledContract, contractLoader, createAbiParser, createTransactionReceipt, defaultDeployer, defaultPaymaster, defaultPlugins, defaultProvider, ec, encode, eth, index as events, extractContractHashes, type fastExecuteResponse, fastParsingStrategy, type fastWaitForTransactionOptions, 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, 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, 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, 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, ESubscriptionTag, ETH_ADDRESS, ETraceFlag, ETransactionExecutionStatus, ETransactionStatus, ETransactionVersion, ETransactionVersion2, 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 FeeEstimate, type FeeMode, type FormatResponse, type FunctionAbi, type GasPrices, type GetBlockResponse, type GetTransactionReceiptResponse, type GetTransactionResponse, type GetTxReceiptResponseWithoutHelper, type HexCalldata, type Hint, 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$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 StarknetIdAccountMethods, StarknetIdImpl, type StarknetIdProviderMethods, type StarknetPlugin, 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, brotherId, byteArray, cairo, compareVersions, config, constants, contractClassResponseToLegacyCompiledContract, contractLoader, createAbiParser, createTransactionReceipt, defaultDeployer, defaultPlugins, ec, encode, eth, index as events, extractContractHashes, type fastExecuteResponse, fastParsingStrategy, type fastWaitForTransactionOptions, 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, 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

@@ -159,9 +159,7 @@ var starknet = (() => {
     createAbiParser: () => createAbiParser,
     createTransactionReceipt: () => createTransactionReceipt,
     defaultDeployer: () => defaultDeployer,
-    defaultPaymaster: () => defaultPaymaster,
     defaultPlugins: () => defaultPlugins,
-    defaultProvider: () => defaultProvider,
     ec: () => ec_exports,
     encode: () => encode_exports,
     eth: () => eth_exports,
@@ -10902,10 +10900,8 @@ ${indent}}` : "}";
   function extractAbi(contract) {
     return isString(contract.abi) ? parse2(contract.abi) : contract.abi;
   }
-  var getDefaultNodeUrl = (networkName, mute = false, rpcVersion) => {
-    if (!mute) {
-      logger.info("Using default public node url, please provide nodeUrl in provider options!");
-    }
+  var getDefaultNodeUrl = (networkName, rpcVersion) => {
+    logger.info("Using default public node url, please provide nodeUrl in provider options!");
     const rpcNodes = getDefaultNodes(rpcVersion ?? config.get("rpcVersion"));
     const nodes = rpcNodes[networkName ?? _NetworkName.SN_SEPOLIA];
     const randIdx = Math.floor(Math.random() * nodes.length);
@@ -11123,19 +11119,11 @@ ${indent}}` : "}";
         waitMode
       } = optionsOrProvider || {};
       if (Object.values(_NetworkName).includes(nodeUrl)) {
-        this.nodeUrl = getDefaultNodeUrl(
-          nodeUrl,
-          optionsOrProvider?.default,
-          this.channelSpecVersion
-        );
+        this.nodeUrl = getDefaultNodeUrl(nodeUrl, this.channelSpecVersion);
       } else if (nodeUrl) {
         this.nodeUrl = nodeUrl;
       } else {
-        this.nodeUrl = getDefaultNodeUrl(
-          void 0,
-          optionsOrProvider?.default,
-          this.channelSpecVersion
-        );
+        this.nodeUrl = getDefaultNodeUrl(void 0, this.channelSpecVersion);
       }
       const channelDefaults = config.get("channelDefaults");
       this.baseFetch = baseFetch || config.get("fetch") || fetch_default;
@@ -11721,19 +11709,11 @@ ${indent}}` : "}";
         waitMode
       } = optionsOrProvider || {};
       if (Object.values(_NetworkName).includes(nodeUrl)) {
-        this.nodeUrl = getDefaultNodeUrl(
-          nodeUrl,
-          optionsOrProvider?.default,
-          this.channelSpecVersion
-        );
+        this.nodeUrl = getDefaultNodeUrl(nodeUrl, this.channelSpecVersion);
       } else if (nodeUrl) {
         this.nodeUrl = nodeUrl;
       } else {
-        this.nodeUrl = getDefaultNodeUrl(
-          void 0,
-          optionsOrProvider?.default,
-          this.channelSpecVersion
-        );
+        this.nodeUrl = getDefaultNodeUrl(void 0, this.channelSpecVersion);
       }
       const channelDefaults = config.get("channelDefaults");
       this.baseFetch = baseFetch || config.get("fetch") || fetch_default;
@@ -14893,9 +14873,6 @@ ${indent}}` : "}";
   var ProviderInterface = class {
   };
 
-  // src/provider/index.ts
-  var defaultProvider = new RpcProvider({ default: true });
-
   // src/signer/interface.ts
   var SignerInterface = class {
   };
@@ -16435,9 +16412,6 @@ ${indent}}` : "}";
   var PaymasterInterface = class {
   };
 
-  // src/paymaster/index.ts
-  var defaultPaymaster = new PaymasterRpc({ default: true });
-
   // src/deployer/default.ts
   var Deployer = class {
     address;
@@ -16551,7 +16525,7 @@ ${indent}}` : "}";
         this.cairoVersion = cairoVersion.toString();
       }
       this.transactionVersion = transactionVersion ?? config.get("transactionVersion");
-      this.paymaster = paymaster ? new PaymasterRpc(paymaster) : defaultPaymaster;
+      this.paymaster = paymaster ? new PaymasterRpc(paymaster) : new PaymasterRpc();
       this.deployer = options.deployer ?? defaultDeployer;
       this.defaultTipType = defaultTipType ?? config.get("defaultTipType");
       this.accountPluginManager = new PluginManager();
@@ -17876,6 +17850,7 @@ ${indent}}` : "}";
     classHash;
     parseRequest;
     parseResponse;
+    defaultProvider;
     structs;
     events;
     functions;
@@ -17890,13 +17865,36 @@ ${indent}}` : "}";
      * @private
      */
     get provider() {
+      if (!this.providerOrAccount) {
+        throw new Error(
+          "Contract is not connected to a provider or account. Provide one during construction or call an async method to auto-initialize."
+        );
+      }
       return isAccount(this.providerOrAccount) ? this.providerOrAccount.provider : this.providerOrAccount;
     }
+    /**
+     * Lazily initialize and cache the default provider with node version detection
+     * @private
+     */
+    async ensureProvider() {
+      if (this.defaultProvider) {
+        return this.defaultProvider;
+      }
+      if (this.providerOrAccount) {
+        if (isAccount(this.providerOrAccount)) {
+          return this.providerOrAccount.provider;
+        }
+        return this.providerOrAccount;
+      }
+      this.defaultProvider = await RpcProvider.create();
+      this.providerOrAccount = this.defaultProvider;
+      return this.defaultProvider;
+    }
     /**
      * @param options
      *  - abi: Abi of the contract object (required)
      *  - address: address to connect to (required)
-     *  - providerOrAccount?: Provider or Account to attach to (fallback to defaultProvider)
+     *  - providerOrAccount?: Provider or Account to attach to (optional, creates default RpcProvider on first use with auto node detection)
      *  - parseRequest?: compile and validate arguments (optional, default true)
      *  - parseResponse?: Parse elements of the response array and structuring them into response object (optional, default true)
      *  - parser?: Abi parser (optional, default createAbiParser(options.abi))
@@ -17906,7 +17904,7 @@ ${indent}}` : "}";
       const parser = createAbiParser(options.abi, options.parsingStrategy);
       this.abi = parser.getLegacyFormat();
       this.address = options.address && options.address.toLowerCase();
-      this.providerOrAccount = options.providerOrAccount ?? defaultProvider;
+      this.providerOrAccount = options.providerOrAccount;
       this.parseRequest = options.parseRequest ?? true;
       this.parseResponse = options.parseResponse ?? true;
       this.classHash = options.classHash;
@@ -17971,7 +17969,8 @@ ${indent}}` : "}";
     }
     async isDeployed() {
       try {
-        await this.provider.getClassHashAt(this.address);
+        const provider = await this.ensureProvider();
+        await provider.getClassHashAt(this.address);
       } catch (error) {
         const errorMessage = error instanceof Error ? error.message : String(error);
         throw new Error(`Contract not deployed at address ${this.address}: ${errorMessage}`);
@@ -17993,7 +17992,8 @@ ${indent}}` : "}";
         logger.warn("Call skipped parsing but provided rawArgs, possible malfunction request");
         return args;
       });
-      return this.provider.callContract(
+      const provider = await this.ensureProvider();
+      return provider.callContract(
         {
           contractAddress: this.address,
           calldata,
@@ -18026,6 +18026,7 @@ ${indent}}` : "}";
         calldata,
         entrypoint: method
       };
+      await this.ensureProvider();
       if (isAccount(this.providerOrAccount)) {
         if (restInvokeOptions.paymasterDetails) {
           const myCall = {
@@ -18043,7 +18044,8 @@ ${indent}}` : "}";
           ...restInvokeOptions
         });
         if (waitForTransaction) {
-          const result2 = await this.provider.waitForTransaction(
+          const provider2 = await this.ensureProvider();
+          const result2 = await provider2.waitForTransaction(
             result.transaction_hash
           );
           if (result2.isSuccess()) {
@@ -18056,7 +18058,8 @@ ${indent}}` : "}";
       if (!restInvokeOptions.nonce)
         throw new Error(`Manual nonce is required when invoking a function without an account`);
       logger.warn(`Invoking ${method} without an account.`);
-      return this.provider.invokeFunction(
+      const provider = await this.ensureProvider();
+      return provider.invokeFunction(
         {
           ...invocation,
           signature
@@ -18073,6 +18076,7 @@ ${indent}}` : "}";
         this.callData.validate(ValidateType.INVOKE, method, args);
       }
       const invocation = this.populate(method, args);
+      await this.ensureProvider();
       if (isAccount(this.providerOrAccount)) {
         if (estimateDetails.paymasterDetails) {
           const myCall = {
@@ -18115,7 +18119,8 @@ ${indent}}` : "}";
       return cairo_exports.isCairo1Abi(this.abi);
     }
     async getVersion() {
-      return this.provider.getContractVersion(this.address);
+      const provider = await this.ensureProvider();
+      return provider.getContractVersion(this.address);
     }
     typedv2(tAbi) {
       return this;