starknet 6.22.0 → 6.23.0

package/CHANGELOG.md

@@ -1,3 +1,9 @@
+# [6.23.0](https://github.com/starknet-io/starknet.js/compare/v6.22.0...v6.23.0) (2025-01-29)
+
+### Features
+
+- logger, config, deprecate legacy tx ([#1302](https://github.com/starknet-io/starknet.js/issues/1302)) ([d0ffbcc](https://github.com/starknet-io/starknet.js/commit/d0ffbcc9bef8b6069f79644d3b54667b3d75dbf2))
+
 # [6.22.0](https://github.com/starknet-io/starknet.js/compare/v6.21.2...v6.22.0) (2025-01-29)
 
 ### Features

package/dist/index.d.ts

@@ -1352,6 +1352,17 @@ var index$3 = /*#__PURE__*/_mergeNamespaces({
   RPCSPEC07: RPCSPEC07
 }, [RPCSPEC07]);
 
+declare const LogLevelIndex: {
+    DEBUG: number;
+    INFO: number;
+    WARN: number;
+    ERROR: number;
+    FATAL: number;
+    OFF: number;
+};
+type LogLevelIndex = ValuesType<typeof LogLevelIndex>;
+type LogLevel = keyof typeof LogLevelIndex;
+
 declare const IS_BROWSER: boolean;
 /**
  * Some functions recreated from https://github.com/pedrouid/enc-utils/blob/master/src/index.ts
@@ -1654,11 +1665,19 @@ declare const SNIP9_V1_INTERFACE_ID = "0x68cfd18b92d1907b8ba3cc324900277f5a36220
 declare const SNIP9_V2_INTERFACE_ID = "0x1d1144bb2138366ff28d8e9ab57456b1d332ac42196230c3a602003c89872";
 declare const HARDENING_BYTE = 128;
 declare const HARDENING_4BYTES = 2147483648n;
+declare const DEFAULT_GLOBAL_CONFIG: {
+    legacyMode: boolean;
+    logLevel: LogLevel;
+};
+declare const SYSTEM_MESSAGES: {
+    legacyTxWarningMessage: string;
+};
 
 declare const constants_ADDR_BOUND: typeof ADDR_BOUND;
 declare const constants_API_VERSION: typeof API_VERSION;
 type constants_BaseUrl = BaseUrl;
 declare const constants_BaseUrl: typeof BaseUrl;
+declare const constants_DEFAULT_GLOBAL_CONFIG: typeof DEFAULT_GLOBAL_CONFIG;
 type constants_FeeMarginPercentage = FeeMarginPercentage;
 declare const constants_FeeMarginPercentage: typeof FeeMarginPercentage;
 declare const constants_HARDENING_4BYTES: typeof HARDENING_4BYTES;
@@ -1678,6 +1697,7 @@ declare const constants_RPC_DEFAULT_VERSION: typeof RPC_DEFAULT_VERSION;
 declare const constants_RPC_NODES: typeof RPC_NODES;
 declare const constants_SNIP9_V1_INTERFACE_ID: typeof SNIP9_V1_INTERFACE_ID;
 declare const constants_SNIP9_V2_INTERFACE_ID: typeof SNIP9_V2_INTERFACE_ID;
+declare const constants_SYSTEM_MESSAGES: typeof SYSTEM_MESSAGES;
 type constants_StarknetChainId = StarknetChainId;
 declare const constants_StarknetChainId: typeof StarknetChainId;
 declare const constants_TEXT_TO_FELT_MAX_LEN: typeof TEXT_TO_FELT_MAX_LEN;
@@ -1686,7 +1706,7 @@ declare const constants_TransactionHashPrefix: typeof TransactionHashPrefix;
 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, constants_BaseUrl as BaseUrl, constants_FeeMarginPercentage as FeeMarginPercentage, constants_HARDENING_4BYTES as HARDENING_4BYTES, constants_HARDENING_BYTE as HARDENING_BYTE, constants_IS_BROWSER as IS_BROWSER, constants_MASK_250 as MASK_250, constants_MASK_31 as MASK_31, constants_MAX_STORAGE_ITEM_SIZE as MAX_STORAGE_ITEM_SIZE, constants_NetworkName as NetworkName, constants_OutsideExecutionCallerAny as OutsideExecutionCallerAny, constants_PRIME as PRIME, constants_RANGE_FELT as RANGE_FELT, constants_RANGE_I128 as RANGE_I128, constants_RANGE_U128 as RANGE_U128, constants_RPC_DEFAULT_VERSION as RPC_DEFAULT_VERSION, constants_RPC_NODES as RPC_NODES, constants_SNIP9_V1_INTERFACE_ID as SNIP9_V1_INTERFACE_ID, constants_SNIP9_V2_INTERFACE_ID as SNIP9_V2_INTERFACE_ID, constants_StarknetChainId as StarknetChainId, constants_TEXT_TO_FELT_MAX_LEN as TEXT_TO_FELT_MAX_LEN, ETransactionVersion$1 as TRANSACTION_VERSION, constants_TransactionHashPrefix as TransactionHashPrefix, constants_UDC as UDC, constants_ZERO as ZERO };
+  export { constants_ADDR_BOUND as ADDR_BOUND, constants_API_VERSION as API_VERSION, constants_BaseUrl as BaseUrl, constants_DEFAULT_GLOBAL_CONFIG as DEFAULT_GLOBAL_CONFIG, constants_FeeMarginPercentage as FeeMarginPercentage, constants_HARDENING_4BYTES as HARDENING_4BYTES, constants_HARDENING_BYTE as HARDENING_BYTE, constants_IS_BROWSER as IS_BROWSER, constants_MASK_250 as MASK_250, constants_MASK_31 as MASK_31, constants_MAX_STORAGE_ITEM_SIZE as MAX_STORAGE_ITEM_SIZE, constants_NetworkName as NetworkName, constants_OutsideExecutionCallerAny as OutsideExecutionCallerAny, constants_PRIME as PRIME, constants_RANGE_FELT as RANGE_FELT, constants_RANGE_I128 as RANGE_I128, constants_RANGE_U128 as RANGE_U128, constants_RPC_DEFAULT_VERSION as RPC_DEFAULT_VERSION, constants_RPC_NODES as RPC_NODES, constants_SNIP9_V1_INTERFACE_ID as SNIP9_V1_INTERFACE_ID, constants_SNIP9_V2_INTERFACE_ID as SNIP9_V2_INTERFACE_ID, constants_SYSTEM_MESSAGES as SYSTEM_MESSAGES, constants_StarknetChainId as StarknetChainId, constants_TEXT_TO_FELT_MAX_LEN as TEXT_TO_FELT_MAX_LEN, ETransactionVersion$1 as TRANSACTION_VERSION, constants_TransactionHashPrefix as TransactionHashPrefix, constants_UDC as UDC, constants_ZERO as ZERO };
 }
 
 declare const ec_weierstrass: typeof weierstrass;
@@ -8053,6 +8073,87 @@ declare namespace connect {
   export { connect_addDeclareTransaction as addDeclareTransaction, connect_addInvokeTransaction as addInvokeTransaction, connect_addStarknetChain as addStarknetChain, connect_deploymentData as deploymentData, connect_getPermissions as getPermissions, connect_onAccountChange as onAccountChange, connect_onNetworkChanged as onNetworkChanged, connect_requestAccounts as requestAccounts, connect_requestChainId as requestChainId, connect_signMessage as signMessage, connect_supportedSpecs as supportedSpecs, connect_switchStarknetChain as switchStarknetChain, connect_watchAsset as watchAsset };
 }
 
+type ConfigData = {
+    [key: string]: any;
+} & typeof DEFAULT_GLOBAL_CONFIG;
+declare class Configuration {
+    private static instance;
+    private config;
+    private constructor();
+    private initialize;
+    static getInstance(): Configuration;
+    get<K extends keyof ConfigData>(key: K, defaultValue?: ConfigData[K]): ConfigData[K] | undefined;
+    set<K extends keyof ConfigData>(key: K, value: ConfigData[K]): void;
+    update(configData: Partial<ConfigData>): void;
+    getAll(): ConfigData;
+    reset(): void;
+    delete(key: keyof ConfigData): void;
+    hasKey(key: keyof ConfigData): boolean;
+}
+declare const config: Configuration;
+
+/**
+ * Logging class providing different levels of log
+ */
+declare class Logger {
+    private static instance;
+    private config;
+    private constructor();
+    static getInstance(): Logger;
+    private getTimestamp;
+    private shouldLog;
+    private formatMessage;
+    private log;
+    /**
+     * debug will be displayed when LogLevel level is set to DEBUG(5)
+     */
+    debug(message: string, data?: any): void;
+    /**
+     * info will be displayed when LogLevel level is set to DEBUG(5), INFO(4)
+     */
+    info(message: string, data?: any): void;
+    /**
+     * warn will be displayed when LogLevel level is set to DEBUG(5), INFO(4), WARN(3)
+     */
+    warn(message: string, data?: any): void;
+    /**
+     * error will be displayed when LogLevel level is set to DEBUG(5), INFO(4), WARN(3), ERROR(2)
+     */
+    error(message: string, data?: any): void;
+    /**
+     * fatal will be displayed when LogLevel level is set to DEBUG(5), INFO(4), WARN(3), ERROR(2), FATAL(1)
+     */
+    fatal(message: string, data?: any): void;
+    /**
+     * Set the logging level you would like system to display
+     * * 5 DEBUG  - show all logs
+     * * 4 INFO
+     * * 3 WARN
+     * * 2 ERROR
+     * * 1 FATAL
+     * * 0 OFF    - disable logs
+     */
+    setLogLevel(level: LogLevel): void;
+    getLogLevel(): LogLevel;
+    /**
+     *
+     * @returns logs levels displayed on the configured LogLevel
+     */
+    getEnabledLogLevels(): string[];
+}
+/**
+ * Logger instance, use for the system logging.
+ * Higher the logger level index, higher the LogLevel required to display log.
+ * Default should be INFO
+ *
+ * DEBUG: 5,
+ * INFO: 4,
+ * WARN: 3,
+ * ERROR: 2,
+ * FATAL: 1,
+ */
+declare const logger: Logger;
+
 /**
  * Main
  */
@@ -8060,4 +8161,4 @@ declare namespace connect {
 /** @deprecated prefer the 'num' naming */
 declare const number: typeof num;
 
-export { type Abi, type AbiEntry, type AbiEnum, type AbiEnums, type AbiEvent, type AbiEvents, type AbiInterfaces, type AbiStruct, type AbiStructs, Account, AccountInterface, type AccountInvocationItem, type AccountInvocations, type AccountInvocationsFactoryDetails, type AllowArray, type Args, type ArgsOrCalldata, type ArgsOrCalldataWithOptions, type ArraySignatureType, type AsyncContractFunction, 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, type CairoContract, CairoCustomEnum, type CairoEnum, type CairoEnumRaw, type CairoEvent, type CairoEventDefinition, type CairoEventVariant, CairoOption, CairoOptionVariant, CairoResult, CairoResultVariant, CairoUint256, CairoUint512, type CairoVersion, type Call, type CallContractResponse, CallData, type CallDetails, type CallOptions, type CallStruct, type Calldata, type CompiledContract, type CompiledSierra, type CompiledSierraCasm, type CompilerVersion, type CompleteDeclareContractPayload, type CompressedProgram, Contract, type ContractClass, type ContractClassIdentifier, type ContractClassPayload, type ContractClassResponse, type ContractEntryPointFields, ContractFactory, type ContractFactoryParams, type ContractFunction, ContractInterface, type ContractOptions, type ContractVersion, CustomError, type DeclareAndDeployContractPayload, type DeclareContractPayload, type DeclareContractResponse, type DeclareContractTransaction, type DeclareDeployUDCResponse, type DeclareSignerDetails, type DeclareTransactionReceiptResponse, type DeployAccountContractPayload, type DeployAccountContractTransaction, type DeployAccountSignerDetails, type DeployAccountTransactionReceiptResponse, type DeployContractResponse, type DeployContractUDCResponse, type DeployTransactionReceiptResponse, type Details, ETH_ADDRESS, EntryPointType, type EntryPointsByType, type EstimateFee, type EstimateFeeAction, type EstimateFeeBulk, type EstimateFeeDetails, type EstimateFeeResponse, type EstimateFeeResponseBulk, EthSigner, type EventEntry, type FeeEstimate, type FunctionAbi, type GetBlockResponse, type GetTransactionReceiptResponse, type GetTransactionResponse, type GetTxReceiptResponseWithoutHelper, type HexCalldata, type InterfaceAbi, type Invocation, type Invocations, type InvocationsDetails, type InvocationsDetailsWithNonce, type InvocationsSignerDetails, type InvokeFunctionResponse, type InvokeOptions, type InvokeTransactionReceiptResponse, type L1HandlerTransactionReceiptResponse, type LedgerPathCalculation, LedgerSigner111 as LedgerSigner, LedgerSigner111, LedgerSigner221, type LegacyCompiledContract, type LegacyContractClass, type LegacyEvent, LibraryError, Literal, type MessageToL1, type MultiDeployContractResponse, type MultiType, NON_ZERO_PREFIX, type Nonce, type OptionalPayload, type OutsideCall, type OutsideExecution, type OutsideExecutionOptions, OutsideExecutionTypesV1, OutsideExecutionTypesV2, OutsideExecutionVersion, type OutsideTransaction, type ParsedEvent, type ParsedEvents, type ParsedStruct, type PendingBlock, type PendingStateUpdate, type Program, RpcProvider as Provider, ProviderInterface, type ProviderOptions, type PythonicHints, index$3 as RPC, rpc_0_6 as RPC06, rpc_0_7 as RPC07, RPCResponseParser, type RPC_ERROR, type RPC_ERROR_SET, type RawArgs, type RawArgsArray, type RawArgsObject, type RawCalldata, ReceiptTx, type RejectedTransactionReceiptResponse, ResponseParser, type Result, type RevertedTransactionReceiptResponse, RpcChannel, RpcError, RpcProvider, type RpcProviderOptions, type SIMULATION_FLAG, type SierraContractClass, type SierraContractEntryPointFields, type SierraEntryPointsByType, type SierraProgramDebugInfo, type Signature, Signer, SignerInterface, type SimulateTransactionDetails, type SimulateTransactionResponse, type SimulatedTransaction, type SimulationFlags, type StarkProfile, type StateUpdate, type StateUpdateResponse, type Storage, type SuccessfulTransactionReceiptResponse, TransactionExecutionStatus, TransactionFinalityStatus, type TransactionReceipt, type TransactionReceiptCallbacks, type TransactionReceiptCallbacksDefault, type TransactionReceiptCallbacksDefined, type TransactionReceiptStatus, type TransactionReceiptUtilityInterface, type TransactionReceiptValue, TransactionStatus, type TransactionStatusReceiptSets, TransactionType, 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 UniversalSuggestedFee, type V2DeclareSignerDetails, type V2DeployAccountSignerDetails, type V2InvocationsSignerDetails, type V3DeclareSignerDetails, type V3DeployAccountSignerDetails, type V3InvocationsSignerDetails, type V3TransactionDetails, ValidateType, WalletAccount, type WeierstrassSignatureType, addAddressPadding, byteArray, cairo, constants, contractClassResponseToLegacyCompiledContract, defaultProvider, ec, encode, eth, index as events, extractContractHashes, fixProto, fixStack, getCalldata, getChecksumAddress, type getContractVersionOptions, type getEstimateFeeBulkOptions, getLedgerPathBuffer111 as getLedgerPathBuffer, getLedgerPathBuffer111, getLedgerPathBuffer221, type getSimulateTransactionOptions, index$1 as hash, isSierra, json, merkle, num, number, outsideExecution, parseCalldataField, provider, selector, shortString, splitArgsAndOptions, src5, stark, starknetId, transaction, typedData, index$2 as types, uint256$1 as uint256, units, v2 as v2hash, v3 as v3hash, validateAndParseAddress, validateChecksumAddress, type waitForTransactionOptions, connect as wallet };
+export { type Abi, type AbiEntry, type AbiEnum, type AbiEnums, type AbiEvent, type AbiEvents, type AbiInterfaces, type AbiStruct, type AbiStructs, Account, AccountInterface, type AccountInvocationItem, type AccountInvocations, type AccountInvocationsFactoryDetails, type AllowArray, type Args, type ArgsOrCalldata, type ArgsOrCalldataWithOptions, type ArraySignatureType, type AsyncContractFunction, 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, type CairoContract, CairoCustomEnum, type CairoEnum, type CairoEnumRaw, type CairoEvent, type CairoEventDefinition, type CairoEventVariant, CairoOption, CairoOptionVariant, CairoResult, CairoResultVariant, CairoUint256, CairoUint512, type CairoVersion, type Call, type CallContractResponse, CallData, type CallDetails, type CallOptions, type CallStruct, type Calldata, type CompiledContract, type CompiledSierra, type CompiledSierraCasm, type CompilerVersion, type CompleteDeclareContractPayload, type CompressedProgram, Contract, type ContractClass, type ContractClassIdentifier, type ContractClassPayload, type ContractClassResponse, type ContractEntryPointFields, ContractFactory, type ContractFactoryParams, type ContractFunction, ContractInterface, type ContractOptions, type ContractVersion, CustomError, type DeclareAndDeployContractPayload, type DeclareContractPayload, type DeclareContractResponse, type DeclareContractTransaction, type DeclareDeployUDCResponse, type DeclareSignerDetails, type DeclareTransactionReceiptResponse, type DeployAccountContractPayload, type DeployAccountContractTransaction, type DeployAccountSignerDetails, type DeployAccountTransactionReceiptResponse, type DeployContractResponse, type DeployContractUDCResponse, type DeployTransactionReceiptResponse, type Details, ETH_ADDRESS, EntryPointType, type EntryPointsByType, type EstimateFee, type EstimateFeeAction, type EstimateFeeBulk, type EstimateFeeDetails, type EstimateFeeResponse, type EstimateFeeResponseBulk, EthSigner, type EventEntry, type FeeEstimate, type FunctionAbi, type GetBlockResponse, type GetTransactionReceiptResponse, type GetTransactionResponse, type GetTxReceiptResponseWithoutHelper, type HexCalldata, type InterfaceAbi, type Invocation, type Invocations, type InvocationsDetails, type InvocationsDetailsWithNonce, type InvocationsSignerDetails, type InvokeFunctionResponse, type InvokeOptions, type InvokeTransactionReceiptResponse, type L1HandlerTransactionReceiptResponse, type LedgerPathCalculation, LedgerSigner111 as LedgerSigner, LedgerSigner111, LedgerSigner221, type LegacyCompiledContract, type LegacyContractClass, type LegacyEvent, LibraryError, Literal, type LogLevel, LogLevelIndex, type MessageToL1, type MultiDeployContractResponse, type MultiType, NON_ZERO_PREFIX, type Nonce, type OptionalPayload, type OutsideCall, type OutsideExecution, type OutsideExecutionOptions, OutsideExecutionTypesV1, OutsideExecutionTypesV2, OutsideExecutionVersion, type OutsideTransaction, type ParsedEvent, type ParsedEvents, type ParsedStruct, type PendingBlock, type PendingStateUpdate, type Program, RpcProvider as Provider, ProviderInterface, type ProviderOptions, type PythonicHints, index$3 as RPC, rpc_0_6 as RPC06, rpc_0_7 as RPC07, RPCResponseParser, type RPC_ERROR, type RPC_ERROR_SET, type RawArgs, type RawArgsArray, type RawArgsObject, type RawCalldata, ReceiptTx, type RejectedTransactionReceiptResponse, ResponseParser, type Result, type RevertedTransactionReceiptResponse, RpcChannel, RpcError, RpcProvider, type RpcProviderOptions, type SIMULATION_FLAG, type SierraContractClass, type SierraContractEntryPointFields, type SierraEntryPointsByType, type SierraProgramDebugInfo, type Signature, Signer, SignerInterface, type SimulateTransactionDetails, type SimulateTransactionResponse, type SimulatedTransaction, type SimulationFlags, type StarkProfile, type StateUpdate, type StateUpdateResponse, type Storage, type SuccessfulTransactionReceiptResponse, TransactionExecutionStatus, TransactionFinalityStatus, type TransactionReceipt, type TransactionReceiptCallbacks, type TransactionReceiptCallbacksDefault, type TransactionReceiptCallbacksDefined, type TransactionReceiptStatus, type TransactionReceiptUtilityInterface, type TransactionReceiptValue, TransactionStatus, type TransactionStatusReceiptSets, TransactionType, 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 UniversalSuggestedFee, type V2DeclareSignerDetails, type V2DeployAccountSignerDetails, type V2InvocationsSignerDetails, type V3DeclareSignerDetails, type V3DeployAccountSignerDetails, type V3InvocationsSignerDetails, type V3TransactionDetails, ValidateType, WalletAccount, type WeierstrassSignatureType, addAddressPadding, byteArray, cairo, config, constants, contractClassResponseToLegacyCompiledContract, defaultProvider, ec, encode, eth, index as events, extractContractHashes, fixProto, fixStack, getCalldata, getChecksumAddress, type getContractVersionOptions, type getEstimateFeeBulkOptions, getLedgerPathBuffer111 as getLedgerPathBuffer, getLedgerPathBuffer111, getLedgerPathBuffer221, type getSimulateTransactionOptions, index$1 as hash, isSierra, json, logger, merkle, num, number, outsideExecution, parseCalldataField, provider, selector, shortString, splitArgsAndOptions, src5, stark, starknetId, transaction, typedData, index$2 as types, uint256$1 as uint256, units, v2 as v2hash, v3 as v3hash, validateAndParseAddress, validateChecksumAddress, type waitForTransactionOptions, connect as wallet };

package/dist/index.global.js

@@ -3231,6 +3231,7 @@ var starknet = (() => {
     LedgerSigner221: () => LedgerSigner221,
     LibraryError: () => LibraryError,
     Literal: () => Literal,
+    LogLevelIndex: () => LogLevelIndex,
     NON_ZERO_PREFIX: () => NON_ZERO_PREFIX,
     OutsideExecutionTypesV1: () => OutsideExecutionTypesV1,
     OutsideExecutionTypesV2: () => OutsideExecutionTypesV2,
@@ -3269,6 +3270,7 @@ var starknet = (() => {
     addAddressPadding: () => addAddressPadding,
     byteArray: () => byteArray_exports,
     cairo: () => cairo_exports,
+    config: () => config2,
     constants: () => constants_exports,
     contractClassResponseToLegacyCompiledContract: () => contractClassResponseToLegacyCompiledContract,
     defaultProvider: () => defaultProvider,
@@ -3287,6 +3289,7 @@ var starknet = (() => {
     hash: () => hash_exports,
     isSierra: () => isSierra,
     json: () => json_exports,
+    logger: () => logger,
     merkle: () => merkle_exports,
     num: () => num_exports,
     number: () => number,
@@ -3311,12 +3314,13 @@ var starknet = (() => {
     wallet: () => connect_exports
   });
 
-  // src/constants.ts
+  // src/global/constants.ts
   var constants_exports = {};
   __export(constants_exports, {
     ADDR_BOUND: () => ADDR_BOUND,
     API_VERSION: () => API_VERSION,
     BaseUrl: () => BaseUrl,
+    DEFAULT_GLOBAL_CONFIG: () => DEFAULT_GLOBAL_CONFIG,
     FeeMarginPercentage: () => FeeMarginPercentage,
     HARDENING_4BYTES: () => HARDENING_4BYTES,
     HARDENING_BYTE: () => HARDENING_BYTE,
@@ -3334,6 +3338,7 @@ var starknet = (() => {
     RPC_NODES: () => RPC_NODES,
     SNIP9_V1_INTERFACE_ID: () => SNIP9_V1_INTERFACE_ID,
     SNIP9_V2_INTERFACE_ID: () => SNIP9_V2_INTERFACE_ID,
+    SYSTEM_MESSAGES: () => SYSTEM_MESSAGES,
     StarknetChainId: () => StarknetChainId,
     TEXT_TO_FELT_MAX_LEN: () => TEXT_TO_FELT_MAX_LEN,
     TRANSACTION_VERSION: () => ETransactionVersion4,
@@ -3842,7 +3847,7 @@ var starknet = (() => {
     return result;
   }
 
-  // src/constants.ts
+  // src/global/constants.ts
   var TEXT_TO_FELT_MAX_LEN = 31;
   var ZERO = 0n;
   var MASK_250 = 2n ** 250n - 1n;
@@ -3904,6 +3909,13 @@ var starknet = (() => {
   var SNIP9_V2_INTERFACE_ID = "0x1d1144bb2138366ff28d8e9ab57456b1d332ac42196230c3a602003c89872";
   var HARDENING_BYTE = 128;
   var HARDENING_4BYTES = 2147483648n;
+  var DEFAULT_GLOBAL_CONFIG = {
+    legacyMode: false,
+    logLevel: "INFO"
+  };
+  var SYSTEM_MESSAGES = {
+    legacyTxWarningMessage: "You are using a deprecated transaction version (V0,V1,V2)!\nUpdate to the latest V3 transactions!"
+  };
 
   // src/channel/rpc_0_6.ts
   var rpc_0_6_exports = {};
@@ -3929,7 +3941,7 @@ var starknet = (() => {
     return NUMBER_REGEX.test(value);
   }
   var NUMBER_REGEX = /^-?(?:0|[1-9]\d*)(?:\.\d+)?(?:[eE][+-]?\d+)?$/;
-  function isSafeNumber(value, config2) {
+  function isSafeNumber(value, config3) {
     const num = Number.parseFloat(value);
     const str = String(num);
     const v = extractSignificantDigits(value);
@@ -3937,7 +3949,7 @@ var starknet = (() => {
     if (v === s) {
       return true;
     }
-    if (config2?.approx === true) {
+    if (config3?.approx === true) {
       const requiredDigits = 14;
       if (!isInteger(value) && s.length >= requiredDigits && v.startsWith(s.substring(0, requiredDigits))) {
         return true;
@@ -14763,6 +14775,184 @@ ${indent}}` : "}";
     validBlockTags: () => validBlockTags,
     wait: () => wait
   });
+
+  // src/global/config.ts
+  var Configuration = class _Configuration {
+    static instance;
+    config;
+    constructor() {
+      this.initialize();
+    }
+    initialize() {
+      this.config = { ...DEFAULT_GLOBAL_CONFIG };
+    }
+    static getInstance() {
+      if (!_Configuration.instance) {
+        _Configuration.instance = new _Configuration();
+      }
+      return _Configuration.instance;
+    }
+    get(key, defaultValue) {
+      return this.config[key] ?? defaultValue;
+    }
+    set(key, value) {
+      this.config[key] = value;
+    }
+    update(configData) {
+      this.config = {
+        ...this.config,
+        ...configData
+      };
+    }
+    getAll() {
+      return { ...this.config };
+    }
+    reset() {
+      this.initialize();
+    }
+    delete(key) {
+      delete this.config[key];
+    }
+    hasKey(key) {
+      return key in this.config;
+    }
+  };
+  var config2 = Configuration.getInstance();
+
+  // src/global/logger.type.ts
+  var LogLevelIndex = {
+    DEBUG: 5,
+    INFO: 4,
+    WARN: 3,
+    ERROR: 2,
+    FATAL: 1,
+    OFF: 0
+  };
+
+  // src/global/logger.ts
+  var Logger = class _Logger {
+    static instance;
+    config;
+    constructor() {
+      this.config = config2;
+    }
+    static getInstance() {
+      if (!_Logger.instance) {
+        _Logger.instance = new _Logger();
+      }
+      return _Logger.instance;
+    }
+    getTimestamp() {
+      return (/* @__PURE__ */ new Date()).toISOString();
+    }
+    shouldLog(messageLevel) {
+      const configLevel = this.config.get("logLevel", "INFO");
+      return messageLevel <= LogLevelIndex[configLevel];
+    }
+    formatMessage(logMessage) {
+      const { level, message, timestamp, data } = logMessage;
+      let formattedMessage = `[${timestamp}] ${level}: ${message}`;
+      if (data) {
+        try {
+          formattedMessage += `
+${JSON.stringify(data, null, 2)}`;
+        } catch (error2) {
+          formattedMessage += `
+[JSON.stringify Error/Circular]: ${error2}`;
+        }
+      }
+      return formattedMessage;
+    }
+    log(level, message, data) {
+      if (!this.shouldLog(LogLevelIndex[level])) {
+        return;
+      }
+      const logMessage = {
+        level,
+        message,
+        timestamp: this.getTimestamp(),
+        data
+      };
+      const formattedMessage = this.formatMessage(logMessage);
+      switch (level) {
+        case "DEBUG":
+          console.debug(formattedMessage);
+          break;
+        case "INFO":
+          console.info(formattedMessage);
+          break;
+        case "WARN":
+          console.warn(formattedMessage);
+          break;
+        case "ERROR":
+        case "FATAL":
+          console.error(formattedMessage);
+          break;
+        case "OFF":
+          break;
+        default:
+          console.log(formattedMessage);
+          break;
+      }
+    }
+    /**
+     * debug will be displayed when LogLevel level is set to DEBUG(5)
+     */
+    debug(message, data) {
+      this.log("DEBUG", message, data);
+    }
+    /**
+     * info will be displayed when LogLevel level is set to DEBUG(5), INFO(4)
+     */
+    info(message, data) {
+      this.log("INFO", message, data);
+    }
+    /**
+     * warn will be displayed when LogLevel level is set to DEBUG(5), INFO(4), WARN(3)
+     */
+    warn(message, data) {
+      this.log("WARN", message, data);
+    }
+    /**
+     * error will be displayed when LogLevel level is set to DEBUG(5), INFO(4), WARN(3), ERROR(2)
+     */
+    error(message, data) {
+      this.log("ERROR", message, data);
+    }
+    /**
+     * fatal will be displayed when LogLevel level is set to DEBUG(5), INFO(4), WARN(3), ERROR(2), FATAL(1)
+     */
+    fatal(message, data) {
+      this.log("FATAL", message, data);
+    }
+    /**
+     * Set the logging level you would like system to display
+     * * 5 DEBUG  - show all logs
+     * * 4 INFO
+     * * 3 WARN
+     * * 2 ERROR
+     * * 1 FATAL
+     * * 0 OFF    - disable logs
+     */
+    setLogLevel(level) {
+      this.config.set("logLevel", level);
+    }
+    getLogLevel() {
+      return this.config.get("logLevel", "INFO");
+    }
+    /**
+     *
+     * @returns logs levels displayed on the configured LogLevel
+     */
+    getEnabledLogLevels() {
+      return Object.keys(LogLevelIndex).filter((s) => {
+        return this.shouldLog(LogLevelIndex[s]) && s !== "OFF";
+      });
+    }
+  };
+  var logger = Logger.getInstance();
+
+  // src/utils/provider.ts
   function wait(delay) {
     return new Promise((res) => {
       setTimeout(res, delay);
@@ -14788,7 +14978,7 @@ ${indent}}` : "}";
   }
   var getDefaultNodeUrl = (networkName, mute = false) => {
     if (!mute) {
-      console.warn("Using default public node url, please provide nodeUrl in provider options!");
+      logger.info("Using default public node url, please provide nodeUrl in provider options!");
     }
     const nodes = RPC_NODES[networkName ?? "SN_SEPOLIA" /* SN_SEPOLIA */];
     const randIdx = Math.floor(Math.random() * nodes.length);
@@ -15343,6 +15533,10 @@ ${indent}}` : "}";
             nonce: toHex(details.nonce)
           }
         });
+        logger.warn(SYSTEM_MESSAGES.legacyTxWarningMessage, {
+          version: rpcspec_0_6_exports.ETransactionVersion.V1,
+          type: rpcspec_0_6_exports.ETransactionType.INVOKE
+        });
       } else {
         promise = this.fetchEndpoint("starknet_addInvokeTransaction", {
           invoke_transaction: {
@@ -15381,6 +15575,10 @@ ${indent}}` : "}";
             nonce: toHex(details.nonce)
           }
         });
+        logger.warn(SYSTEM_MESSAGES.legacyTxWarningMessage, {
+          version: rpcspec_0_6_exports.ETransactionVersion.V1,
+          type: rpcspec_0_6_exports.ETransactionType.DECLARE
+        });
       } else if (isSierra(contract) && !isV3Tx(details)) {
         promise = this.fetchEndpoint("starknet_addDeclareTransaction", {
           declare_transaction: {
@@ -15399,6 +15597,10 @@ ${indent}}` : "}";
             nonce: toHex(details.nonce)
           }
         });
+        logger.warn(SYSTEM_MESSAGES.legacyTxWarningMessage, {
+          version: rpcspec_0_6_exports.ETransactionVersion.V2,
+          type: rpcspec_0_6_exports.ETransactionType.DECLARE
+        });
       } else if (isSierra(contract) && isV3Tx(details)) {
         promise = this.fetchEndpoint("starknet_addDeclareTransaction", {
           declare_transaction: {
@@ -15442,6 +15644,10 @@ ${indent}}` : "}";
             nonce: toHex(details.nonce)
           }
         });
+        logger.warn(SYSTEM_MESSAGES.legacyTxWarningMessage, {
+          version: rpcspec_0_6_exports.ETransactionVersion.V1,
+          type: rpcspec_0_6_exports.ETransactionType.DEPLOY_ACCOUNT
+        });
       } else {
         promise = this.fetchEndpoint("starknet_addDeployAccountTransaction", {
           deploy_account_transaction: {
@@ -15514,6 +15720,10 @@ ${indent}}` : "}";
           nonce: toHex(invocation.nonce),
           max_fee: toHex(invocation.maxFee || 0)
         };
+        logger.warn(SYSTEM_MESSAGES.legacyTxWarningMessage, {
+          version: invocation.version,
+          type: invocation.type
+        });
       } else {
         details = {
           signature: signatureToHexArray(invocation.signature),
@@ -15910,6 +16120,10 @@ ${indent}}` : "}";
             nonce: toHex(details.nonce)
           }
         });
+        logger.warn(SYSTEM_MESSAGES.legacyTxWarningMessage, {
+          version: esm_exports.ETransactionVersion.V1,
+          type: esm_exports.ETransactionType.INVOKE
+        });
       } else {
         promise = this.fetchEndpoint("starknet_addInvokeTransaction", {
           invoke_transaction: {
@@ -15948,6 +16162,10 @@ ${indent}}` : "}";
             nonce: toHex(details.nonce)
           }
         });
+        logger.warn(SYSTEM_MESSAGES.legacyTxWarningMessage, {
+          version: esm_exports.ETransactionVersion.V1,
+          type: esm_exports.ETransactionType.DECLARE
+        });
       } else if (isSierra(contract) && !isV3Tx(details)) {
         promise = this.fetchEndpoint("starknet_addDeclareTransaction", {
           declare_transaction: {
@@ -15966,6 +16184,10 @@ ${indent}}` : "}";
             nonce: toHex(details.nonce)
           }
         });
+        logger.warn(SYSTEM_MESSAGES.legacyTxWarningMessage, {
+          version: esm_exports.ETransactionVersion.V2,
+          type: esm_exports.ETransactionType.DECLARE
+        });
       } else if (isSierra(contract) && isV3Tx(details)) {
         promise = this.fetchEndpoint("starknet_addDeclareTransaction", {
           declare_transaction: {
@@ -16009,6 +16231,10 @@ ${indent}}` : "}";
             nonce: toHex(details.nonce)
           }
         });
+        logger.warn(SYSTEM_MESSAGES.legacyTxWarningMessage, {
+          version: esm_exports.ETransactionVersion.V1,
+          type: esm_exports.ETransactionType.DEPLOY_ACCOUNT
+        });
       } else {
         promise = this.fetchEndpoint("starknet_addDeployAccountTransaction", {
           deploy_account_transaction: {
@@ -16081,6 +16307,10 @@ ${indent}}` : "}";
           nonce: toHex(invocation.nonce),
           max_fee: toHex(invocation.maxFee || 0)
         };
+        logger.warn(SYSTEM_MESSAGES.legacyTxWarningMessage, {
+          version: invocation.version,
+          type: invocation.type
+        });
       } else {
         details = {
           signature: signatureToHexArray(invocation.signature),
@@ -19894,7 +20124,7 @@ ${indent}}` : "}";
         this.channel.setChainId(res);
       });
       if (!address.length) {
-        console.warn(
+        logger.warn(
           "@deprecated Use static method WalletAccount.connect or WalletAccount.connectSilent instead. Constructor {@link WalletAccount.(format:2)}."
         );
         requestAccounts(this.walletProvider).then(([accountAddress]) => {
@@ -20136,7 +20366,7 @@ ${indent}}` : "}";
           this.callData.validate(ValidateType.CALL, method, args);
           return this.callData.compile(method, args);
         }
-        console.warn("Call skipped parsing but provided rawArgs, possible malfunction request");
+        logger.warn("Call skipped parsing but provided rawArgs, possible malfunction request");
         return args;
       });
       return this.providerOrAccount.callContract(
@@ -20163,7 +20393,7 @@ ${indent}}` : "}";
           this.callData.validate(ValidateType.INVOKE, method, args);
           return this.callData.compile(method, args);
         }
-        console.warn("Invoke skipped parsing but provided rawArgs, possible malfunction request");
+        logger.warn("Invoke skipped parsing but provided rawArgs, possible malfunction request");
         return args;
       });
       const invocation = {
@@ -20178,7 +20408,7 @@ ${indent}}` : "}";
         });
       }
       if (!nonce) throw new Error(`Nonce is required when invoking a function without an account`);
-      console.warn(`Invoking ${method} without an account. This will not work on a public node.`);
+      logger.warn(`Invoking ${method} without an account. This will not work on a public node.`);
       return this.providerOrAccount.invokeFunction(
         {
           ...invocation,
@@ -20291,7 +20521,7 @@ ${indent}}` : "}";
           this.CallData.validate(ValidateType.DEPLOY, "constructor", param);
           return this.CallData.compile("constructor", param);
         }
-        console.warn("Call skipped parsing but provided rawArgs, possible malfunction request");
+        logger.warn("Call skipped parsing but provided rawArgs, possible malfunction request");
         return param;
       });
       const {