starknet 7.1.0 → 7.3.0

package/dist/index.js

@@ -62,6 +62,7 @@ __export(index_exports, {
   LedgerSigner: () => LedgerSigner111,
   LedgerSigner111: () => LedgerSigner111,
   LedgerSigner221: () => LedgerSigner221,
+  LedgerSigner231: () => LedgerSigner231,
   LibraryError: () => LibraryError,
   Literal: () => Literal,
   LogLevelIndex: () => LogLevelIndex,
@@ -69,11 +70,13 @@ __export(index_exports, {
   OutsideExecutionTypesV1: () => OutsideExecutionTypesV1,
   OutsideExecutionTypesV2: () => OutsideExecutionTypesV2,
   OutsideExecutionVersion: () => OutsideExecutionVersion,
+  PaymasterInterface: () => PaymasterInterface,
+  PaymasterRpc: () => PaymasterRpc,
   Provider: () => RpcProvider2,
   ProviderInterface: () => ProviderInterface,
   RPC: () => api_exports,
-  RPC07: () => rpc_0_7_exports,
-  RPC08: () => rpc_0_8_exports,
+  RPC07: () => rpc_0_7_1_exports,
+  RPC08: () => rpc_0_8_1_exports,
   RPCResponseParser: () => RPCResponseParser,
   ReceiptTx: () => ReceiptTx,
   ResponseParser: () => ResponseParser,
@@ -107,6 +110,7 @@ __export(index_exports, {
   config: () => config,
   constants: () => constants_exports,
   contractClassResponseToLegacyCompiledContract: () => contractClassResponseToLegacyCompiledContract,
+  defaultPaymaster: () => defaultPaymaster,
   defaultProvider: () => defaultProvider,
   ec: () => ec_exports,
   encode: () => encode_exports,
@@ -121,21 +125,29 @@ __export(index_exports, {
   getLedgerPathBuffer111: () => getLedgerPathBuffer111,
   getLedgerPathBuffer221: () => getLedgerPathBuffer221,
   hash: () => hash_exports,
+  isPendingBlock: () => isPendingBlock,
+  isPendingStateUpdate: () => isPendingStateUpdate,
+  isPendingTransaction: () => isPendingTransaction,
   isRPC08_FeeEstimate: () => isRPC08_FeeEstimate,
   isRPC08_ResourceBounds: () => isRPC08_ResourceBounds,
   isSierra: () => isSierra,
+  isSupportedSpecVersion: () => isSupportedSpecVersion,
+  isV3Tx: () => isV3Tx,
+  isVersion: () => isVersion,
   json: () => json_exports,
   logger: () => logger,
   merkle: () => merkle_exports,
   num: () => num_exports,
   outsideExecution: () => outsideExecution_exports,
   parseCalldataField: () => parseCalldataField,
+  paymaster: () => paymaster_exports,
   provider: () => provider_exports,
   selector: () => selector_exports,
   shortString: () => shortString_exports,
   src5: () => src5_exports,
   stark: () => stark_exports,
   starknetId: () => starknetId_exports,
+  toAnyPatchVersion: () => toAnyPatchVersion,
   transaction: () => transaction_exports,
   typedData: () => typedData_exports,
   types: () => types_exports,
@@ -164,6 +176,7 @@ __export(constants_exports, {
   MAX_STORAGE_ITEM_SIZE: () => MAX_STORAGE_ITEM_SIZE,
   NetworkName: () => _NetworkName,
   OutsideExecutionCallerAny: () => OutsideExecutionCallerAny,
+  PAYMASTER_RPC_NODES: () => PAYMASTER_RPC_NODES,
   PRIME: () => PRIME,
   RANGE_FELT: () => RANGE_FELT,
   RANGE_I128: () => RANGE_I128,
@@ -185,6 +198,7 @@ __export(constants_exports, {
 var api_exports = {};
 __export(api_exports, {
   JRPC: () => jsonrpc_exports,
+  PAYMASTER_API: () => import_starknet_types_08.PAYMASTER_API,
   RPCSPEC07: () => RPCSPEC07,
   RPCSPEC08: () => RPCSPEC08
 });
@@ -195,6 +209,7 @@ var jsonrpc_exports = {};
 // src/types/api/index.ts
 var RPCSPEC07 = __toESM(require("starknet-types-07"));
 var RPCSPEC08 = __toESM(require("starknet-types-08"));
+var import_starknet_types_08 = require("starknet-types-08");
 __reExport(api_exports, require("starknet-types-08"));
 
 // src/utils/encode.ts
@@ -326,14 +341,14 @@ var _TransactionHashPrefix = {
   // encodeShortString('l1_handler'),
 };
 var _SupportedRpcVersion = {
-  0.7: "0.7",
-  0.8: "0.8",
-  v07: "0.7",
-  v08: "0.8"
+  "0.7.1": "0.7.1",
+  "0.8.1": "0.8.1",
+  v0_7_1: "0.7.1",
+  v0_8_1: "0.8.1"
 };
 var DEFAULT_GLOBAL_CONFIG = {
   legacyMode: false,
-  rpcVersion: "0.8",
+  rpcVersion: "0.8.1",
   transactionVersion: api_exports.ETransactionVersion.V3,
   logLevel: "INFO",
   feeMarginPercentage: {
@@ -352,7 +367,9 @@ var DEFAULT_GLOBAL_CONFIG = {
       }
     },
     maxFee: 50
-  }
+  },
+  fetch: void 0,
+  websocket: void 0
 };
 var RPC_DEFAULT_NODES = {
   SN_MAIN: [
@@ -364,159 +381,239 @@ var RPC_DEFAULT_NODES = {
     `https://free-rpc.nethermind.io/sepolia-juno/`
   ]
 };
+var PAYMASTER_RPC_NODES = {
+  SN_MAIN: [`https://starknet.paymaster.avnu.fi`],
+  SN_SEPOLIA: [`https://sepolia.paymaster.avnu.fi`]
+};
 var SYSTEM_MESSAGES = {
   legacyTxWarningMessage: "You are using a deprecated transaction version (V0,V1,V2)!\nUpdate to the latest V3 transactions!",
   legacyTxRPC08Message: "RPC 0.8 do not support legacy transactions",
-  SWOldV3: "RPC 0.7 V3 tx (improper resource bounds) not supported in RPC 0.8"
+  SWOldV3: "RPC 0.7 V3 tx (improper resource bounds) not supported in RPC 0.8",
+  channelVersionMismatch: "Channel specification version is not compatible with the connected node Specification Version",
+  unsupportedSpecVersion: "The connected node specification version is not supported by this library"
 };
 
-// src/channel/rpc_0_7.ts
-var rpc_0_7_exports = {};
-__export(rpc_0_7_exports, {
-  RpcChannel: () => RpcChannel
-});
-
-// src/utils/json.ts
-var json_exports = {};
-__export(json_exports, {
-  parse: () => parse2,
-  parseAlwaysAsBig: () => parseAlwaysAsBig,
-  stringify: () => stringify2
-});
-var json = __toESM(require("lossless-json"));
-var parseIntAsNumberOrBigInt = (str) => {
-  if (!json.isInteger(str)) return parseFloat(str);
-  const num = parseInt(str, 10);
-  return Number.isSafeInteger(num) ? num : BigInt(str);
+// 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 parse2 = (str) => json.parse(String(str), void 0, parseIntAsNumberOrBigInt);
-var parseAlwaysAsBig = (str) => json.parse(String(str), void 0, json.parseNumberAndBigInt);
-var stringify2 = (value, replacer, space, numberStringifiers) => json.stringify(value, replacer, space, numberStringifiers);
+var config = Configuration.getInstance();
 
-// src/utils/errors/rpc.ts
-var errorCodes = {
-  FAILED_TO_RECEIVE_TXN: 1,
-  NO_TRACE_AVAILABLE: 10,
-  CONTRACT_NOT_FOUND: 20,
-  ENTRYPOINT_NOT_FOUND: 21,
-  BLOCK_NOT_FOUND: 24,
-  INVALID_TXN_INDEX: 27,
-  CLASS_HASH_NOT_FOUND: 28,
-  TXN_HASH_NOT_FOUND: 29,
-  PAGE_SIZE_TOO_BIG: 31,
-  NO_BLOCKS: 32,
-  INVALID_CONTINUATION_TOKEN: 33,
-  TOO_MANY_KEYS_IN_FILTER: 34,
-  CONTRACT_ERROR: 40,
-  TRANSACTION_EXECUTION_ERROR: 41,
-  STORAGE_PROOF_NOT_SUPPORTED: 42,
-  CLASS_ALREADY_DECLARED: 51,
-  INVALID_TRANSACTION_NONCE: 52,
-  INSUFFICIENT_RESOURCES_FOR_VALIDATE: 53,
-  INSUFFICIENT_ACCOUNT_BALANCE: 54,
-  VALIDATION_FAILURE: 55,
-  COMPILATION_FAILED: 56,
-  CONTRACT_CLASS_SIZE_IS_TOO_LARGE: 57,
-  NON_ACCOUNT: 58,
-  DUPLICATE_TX: 59,
-  COMPILED_CLASS_HASH_MISMATCH: 60,
-  UNSUPPORTED_TX_VERSION: 61,
-  UNSUPPORTED_CONTRACT_CLASS_VERSION: 62,
-  UNEXPECTED_ERROR: 63,
-  INVALID_SUBSCRIPTION_ID: 66,
-  TOO_MANY_ADDRESSES_IN_FILTER: 67,
-  TOO_MANY_BLOCKS_BACK: 68,
-  COMPILATION_ERROR: 100
+// src/global/logger.type.ts
+var LogLevelIndex = {
+  DEBUG: 5,
+  INFO: 4,
+  WARN: 3,
+  ERROR: 2,
+  FATAL: 1,
+  OFF: 0
 };
-var rpc_default = errorCodes;
 
-// src/utils/errors/index.ts
-function fixStack(target, fn = target.constructor) {
-  const { captureStackTrace } = Error;
-  captureStackTrace && captureStackTrace(target, fn);
-}
-function fixProto(target, prototype) {
-  const { setPrototypeOf } = Object;
-  setPrototypeOf ? setPrototypeOf(target, prototype) : target.__proto__ = prototype;
-}
-var CustomError = class extends Error {
-  name;
-  constructor(message) {
-    super(message);
-    Object.defineProperty(this, "name", {
-      value: new.target.name,
-      enumerable: false,
-      configurable: true
-    });
-    fixProto(this, new.target.prototype);
-    fixStack(this);
+// src/global/logger.ts
+var Logger = class _Logger {
+  static instance;
+  config;
+  constructor() {
+    this.config = config;
   }
-};
-var LibraryError = class extends CustomError {
-};
-var RpcError = class extends LibraryError {
-  constructor(baseError, method, params) {
-    super(`RPC: ${method} with params ${stringify2(params, null, 2)}
-
-      ${baseError.code}: ${baseError.message}: ${stringify2(baseError.data)}`);
-    this.baseError = baseError;
-    this.request = { method, params };
+  static getInstance() {
+    if (!_Logger.instance) {
+      _Logger.instance = new _Logger();
+    }
+    return _Logger.instance;
   }
-  request;
-  get code() {
-    return this.baseError.code;
+  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 (error) {
+        formattedMessage += `
+[JSON.stringify Error/Circular]: ${error}`;
+      }
+    }
+    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;
+    }
   }
   /**
-   * Verifies the underlying RPC error, also serves as a type guard for the _baseError_ property
-   * @example
-   * ```typescript
-   * SomeError.isType('UNEXPECTED_ERROR');
-   * ```
+   * debug will be displayed when LogLevel level is set to DEBUG(5)
    */
-  isType(typeName) {
-    return rpc_default[typeName] === this.code;
+  debug(message, data) {
+    this.log("DEBUG", message, data);
   }
-};
-
-// src/types/index.ts
-var types_exports = {};
-__export(types_exports, {
-  BlockStatus: () => BlockStatus,
-  BlockTag: () => BlockTag,
-  EDAMode: () => EDAMode,
-  EDataAvailabilityMode: () => EDataAvailabilityMode,
-  ETH_ADDRESS: () => ETH_ADDRESS,
-  ETransactionExecutionStatus: () => ETransactionExecutionStatus,
-  ETransactionStatus: () => ETransactionStatus,
-  ETransactionVersion: () => ETransactionVersion2,
-  ETransactionVersion2: () => ETransactionVersion22,
-  ETransactionVersion3: () => ETransactionVersion3,
-  EntryPointType: () => EntryPointType,
-  Literal: () => Literal,
-  NON_ZERO_PREFIX: () => NON_ZERO_PREFIX,
-  OutsideExecutionTypesV1: () => OutsideExecutionTypesV1,
-  OutsideExecutionTypesV2: () => OutsideExecutionTypesV2,
-  OutsideExecutionVersion: () => OutsideExecutionVersion,
-  RPC: () => api_exports,
-  TransactionExecutionStatus: () => TransactionExecutionStatus,
-  TransactionFinalityStatus: () => TransactionFinalityStatus,
-  TransactionType: () => TransactionType,
-  TypedDataRevision: () => import_starknet_types_07.TypedDataRevision,
-  Uint: () => Uint,
-  ValidateType: () => ValidateType,
-  isRPC08_FeeEstimate: () => isRPC08_FeeEstimate,
-  isRPC08_ResourceBounds: () => isRPC08_ResourceBounds
-});
-
-// src/types/lib/contract/index.ts
-var EntryPointType = {
-  EXTERNAL: "EXTERNAL",
-  L1_HANDLER: "L1_HANDLER",
-  CONSTRUCTOR: "CONSTRUCTOR"
-};
-
-// src/types/lib/index.ts
-var TransactionType = {
+  /**
+   * 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/channel/rpc_0_7_1.ts
+var rpc_0_7_1_exports = {};
+__export(rpc_0_7_1_exports, {
+  RpcChannel: () => RpcChannel
+});
+
+// src/types/index.ts
+var types_exports = {};
+__export(types_exports, {
+  BlockStatus: () => BlockStatus,
+  BlockTag: () => BlockTag,
+  EDAMode: () => EDAMode,
+  EDataAvailabilityMode: () => EDataAvailabilityMode,
+  ETH_ADDRESS: () => ETH_ADDRESS,
+  ETransactionExecutionStatus: () => ETransactionExecutionStatus,
+  ETransactionStatus: () => ETransactionStatus,
+  ETransactionVersion: () => ETransactionVersion2,
+  ETransactionVersion2: () => ETransactionVersion22,
+  ETransactionVersion3: () => ETransactionVersion3,
+  EntryPointType: () => EntryPointType,
+  Literal: () => Literal,
+  NON_ZERO_PREFIX: () => NON_ZERO_PREFIX,
+  OutsideExecutionTypesV1: () => OutsideExecutionTypesV1,
+  OutsideExecutionTypesV2: () => OutsideExecutionTypesV2,
+  OutsideExecutionVersion: () => OutsideExecutionVersion,
+  RPC: () => api_exports,
+  TransactionExecutionStatus: () => TransactionExecutionStatus,
+  TransactionFinalityStatus: () => TransactionFinalityStatus,
+  TransactionType: () => TransactionType,
+  TypedDataRevision: () => import_starknet_types_07.TypedDataRevision,
+  Uint: () => Uint,
+  ValidateType: () => ValidateType,
+  isRPC08_FeeEstimate: () => isRPC08_FeeEstimate,
+  isRPC08_ResourceBounds: () => isRPC08_ResourceBounds
+});
+
+// src/types/lib/contract/index.ts
+var EntryPointType = {
+  EXTERNAL: "EXTERNAL",
+  L1_HANDLER: "L1_HANDLER",
+  CONSTRUCTOR: "CONSTRUCTOR"
+};
+
+// src/types/lib/index.ts
+var TransactionType = {
   DECLARE: "DECLARE",
   DEPLOY: "DEPLOY",
   DEPLOY_ACCOUNT: "DEPLOY_ACCOUNT",
@@ -639,6 +736,23 @@ var OutsideExecutionVersion = {
 // src/types/typedData.ts
 var import_starknet_types_07 = require("starknet-types-07");
 
+// src/utils/json.ts
+var json_exports = {};
+__export(json_exports, {
+  parse: () => parse2,
+  parseAlwaysAsBig: () => parseAlwaysAsBig,
+  stringify: () => stringify2
+});
+var json = __toESM(require("lossless-json"));
+var parseIntAsNumberOrBigInt = (str) => {
+  if (!json.isInteger(str)) return parseFloat(str);
+  const num = parseInt(str, 10);
+  return Number.isSafeInteger(num) ? num : BigInt(str);
+};
+var parse2 = (str) => json.parse(String(str), void 0, parseIntAsNumberOrBigInt);
+var parseAlwaysAsBig = (str) => json.parse(String(str), void 0, json.parseNumberAndBigInt);
+var stringify2 = (value, replacer, space, numberStringifiers) => json.stringify(value, replacer, space, numberStringifiers);
+
 // src/utils/batch/index.ts
 var BatchClient = class {
   nodeUrl;
@@ -3556,6 +3670,38 @@ __export(stark_exports, {
 var import_starknet4 = require("@scure/starknet");
 var import_pako = require("pako");
 
+// src/utils/resolve.ts
+function isV3Tx(details) {
+  const version = details.version ? toHex(details.version) : ETransactionVersion2.V3;
+  return version === ETransactionVersion2.V3 || version === ETransactionVersion2.F3;
+}
+function isVersion(expected, provided) {
+  const expectedParts = expected.split(".");
+  const providedParts = provided.split(".");
+  return expectedParts.every((part, index) => part === "*" || part === providedParts[index]);
+}
+function isSupportedSpecVersion(version, options = { allowAnyPatchVersion: false }) {
+  return Object.values(_SupportedRpcVersion).some(
+    (v) => isVersion(options.allowAnyPatchVersion ? toAnyPatchVersion(v) : v, version)
+  );
+}
+function toAnyPatchVersion(version) {
+  const parts = version.split(".");
+  if (parts.length < 3) {
+    return version;
+  }
+  return `${parts[0]}.${parts[1]}.*`;
+}
+function isPendingBlock(response) {
+  return response.status === "PENDING";
+}
+function isPendingTransaction(response) {
+  return !("block_hash" in response);
+}
+function isPendingStateUpdate(response) {
+  return !("block_hash" in response);
+}
+
 // src/utils/stark/rpc07.ts
 function estimateFeeToBounds(estimate, overhead) {
   const maxUnits = estimate.data_gas_consumed !== void 0 && estimate.data_gas_price !== void 0 ? toHex(
@@ -3595,49 +3741,6 @@ function estimateFeeToBounds2(estimate, overhead) {
   };
 }
 
-// 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 config = Configuration.getInstance();
-
 // src/utils/stark/index.ts
 function compressProgram(jsonProgram) {
   const stringified = isString(jsonProgram) ? jsonProgram : stringify2(jsonProgram);
@@ -3679,7 +3782,7 @@ function estimateFeeToBounds3(estimate, overhead = config.get("feeMarginPercenta
     return {
       l2_gas: { max_amount: "0x0", max_price_per_unit: "0x0" },
       l1_gas: { max_amount: "0x0", max_price_per_unit: "0x0" },
-      ...specVersion === "0.8" && {
+      ...specVersion && isVersion("0.8", specVersion) && {
         l1_data_gas: { max_amount: "0x0", max_price_per_unit: "0x0" }
       }
     };
@@ -3778,6 +3881,102 @@ function contractClassResponseToLegacyCompiledContract(ccr) {
   return { ...contract, program: decompressProgram(contract.program) };
 }
 
+// src/utils/errors/rpc.ts
+var errorCodes = {
+  FAILED_TO_RECEIVE_TXN: 1,
+  NO_TRACE_AVAILABLE: 10,
+  CONTRACT_NOT_FOUND: 20,
+  ENTRYPOINT_NOT_FOUND: 21,
+  BLOCK_NOT_FOUND: 24,
+  INVALID_TXN_INDEX: 27,
+  CLASS_HASH_NOT_FOUND: 28,
+  TXN_HASH_NOT_FOUND: 29,
+  PAGE_SIZE_TOO_BIG: 31,
+  NO_BLOCKS: 32,
+  INVALID_CONTINUATION_TOKEN: 33,
+  TOO_MANY_KEYS_IN_FILTER: 34,
+  CONTRACT_ERROR: 40,
+  TRANSACTION_EXECUTION_ERROR: 41,
+  STORAGE_PROOF_NOT_SUPPORTED: 42,
+  CLASS_ALREADY_DECLARED: 51,
+  INVALID_TRANSACTION_NONCE: 52,
+  INSUFFICIENT_RESOURCES_FOR_VALIDATE: 53,
+  INSUFFICIENT_ACCOUNT_BALANCE: 54,
+  VALIDATION_FAILURE: 55,
+  COMPILATION_FAILED: 56,
+  CONTRACT_CLASS_SIZE_IS_TOO_LARGE: 57,
+  NON_ACCOUNT: 58,
+  DUPLICATE_TX: 59,
+  COMPILED_CLASS_HASH_MISMATCH: 60,
+  UNSUPPORTED_TX_VERSION: 61,
+  UNSUPPORTED_CONTRACT_CLASS_VERSION: 62,
+  UNEXPECTED_ERROR: 63,
+  INVALID_SUBSCRIPTION_ID: 66,
+  TOO_MANY_ADDRESSES_IN_FILTER: 67,
+  TOO_MANY_BLOCKS_BACK: 68,
+  COMPILATION_ERROR: 100,
+  INVALID_ADDRESS: 150,
+  TOKEN_NOT_SUPPORTED: 151,
+  INVALID_SIGNATURE: 153,
+  MAX_AMOUNT_TOO_LOW: 154,
+  CLASS_HASH_NOT_SUPPORTED: 155,
+  PAYMASTER_TRANSACTION_EXECUTION_ERROR: 156,
+  INVALID_TIME_BOUNDS: 157,
+  INVALID_DEPLOYMENT_DATA: 158,
+  INVALID_CLASS_HASH: 159,
+  INVALID_ID: 160,
+  UNKNOWN_ERROR: 163
+};
+var rpc_default = errorCodes;
+
+// src/utils/errors/index.ts
+function fixStack(target, fn = target.constructor) {
+  const { captureStackTrace } = Error;
+  captureStackTrace && captureStackTrace(target, fn);
+}
+function fixProto(target, prototype) {
+  const { setPrototypeOf } = Object;
+  setPrototypeOf ? setPrototypeOf(target, prototype) : target.__proto__ = prototype;
+}
+var CustomError = class extends Error {
+  name;
+  constructor(message) {
+    super(message);
+    Object.defineProperty(this, "name", {
+      value: new.target.name,
+      enumerable: false,
+      configurable: true
+    });
+    fixProto(this, new.target.prototype);
+    fixStack(this);
+  }
+};
+var LibraryError = class extends CustomError {
+};
+var RpcError = class extends LibraryError {
+  constructor(baseError, method, params) {
+    super(`RPC: ${method} with params ${stringify2(params, null, 2)}
+
+      ${baseError.code}: ${baseError.message}: ${stringify2(baseError.data)}`);
+    this.baseError = baseError;
+    this.request = { method, params };
+  }
+  request;
+  get code() {
+    return this.baseError.code;
+  }
+  /**
+   * Verifies the underlying RPC error, also serves as a type guard for the _baseError_ property
+   * @example
+   * ```typescript
+   * SomeError.isType('UNEXPECTED_ERROR');
+   * ```
+   */
+  isType(typeName) {
+    return rpc_default[typeName] === this.code;
+  }
+};
+
 // src/utils/eth.ts
 var eth_exports = {};
 __export(eth_exports, {
@@ -3795,11 +3994,8 @@ function validateAndParseEthAddress(address) {
   return result;
 }
 
-// src/utils/fetch.ts
-var fetch_default = IS_BROWSER && window.fetch.bind(window) || // use built-in fetch in browser if available
-!isUndefined(global) && global.fetch || // use built-in fetch in node, react-native and service worker if available
-// throw with instructions when no fetch is detected
-(() => {
+// src/utils/connect/fetch.ts
+var fetch_default = typeof globalThis !== "undefined" && globalThis.fetch.bind(globalThis) || typeof window !== "undefined" && window.fetch.bind(window) || typeof global !== "undefined" && global.fetch.bind(global) || (() => {
   throw new LibraryError(
     "'fetch()' not detected, use the 'baseFetch' constructor parameter to set it"
   );
@@ -3812,151 +4008,10 @@ __export(provider_exports, {
   createSierraContractClass: () => createSierraContractClass,
   getDefaultNodeUrl: () => getDefaultNodeUrl,
   getDefaultNodes: () => getDefaultNodes,
-  isPendingBlock: () => isPendingBlock,
-  isPendingStateUpdate: () => isPendingStateUpdate,
-  isPendingTransaction: () => isPendingTransaction,
-  isV3Tx: () => isV3Tx,
-  isVersion: () => isVersion,
   parseContract: () => parseContract,
-  stringToSpecVersion: () => stringToSpecVersion,
   validBlockTags: () => validBlockTags,
   wait: () => wait
 });
-
-// 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 = config;
-  }
-  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 (error) {
-        formattedMessage += `
-[JSON.stringify Error/Circular]: ${error}`;
-      }
-    }
-    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);
@@ -4097,28 +4152,6 @@ var Block = class {
   valueOf = () => this.number;
   toString = () => this.hash;
 };
-function isV3Tx(details) {
-  const version = details.version ? toHex(details.version) : ETransactionVersion2.V3;
-  return version === ETransactionVersion2.V3 || version === ETransactionVersion2.F3;
-}
-function isVersion(version, response) {
-  const [majorS, minorS] = version.split(".");
-  const [majorR, minorR] = response.split(".");
-  return majorS === majorR && minorS === minorR;
-}
-function stringToSpecVersion(version) {
-  const [major, minor] = version.split(".");
-  return `${major}.${minor}`;
-}
-function isPendingBlock(response) {
-  return response.status === "PENDING";
-}
-function isPendingTransaction(response) {
-  return !("block_hash" in response);
-}
-function isPendingStateUpdate(response) {
-  return !("block_hash" in response);
-}
 
 // src/utils/transaction.ts
 var transaction_exports = {};
@@ -4211,14 +4244,18 @@ function getVersionsByType(versionType) {
   } : { v1: ETransactionVersion2.V1, v2: ETransactionVersion2.V2, v3: ETransactionVersion2.V3 };
 }
 
-// src/channel/rpc_0_7.ts
+// src/channel/rpc_0_7_1.ts
 var defaultOptions = {
   headers: { "Content-Type": "application/json" },
   blockIdentifier: BlockTag.PENDING,
   retries: 200
 };
 var RpcChannel = class {
-  id = "RPC07";
+  id = "RPC071";
+  /**
+   * RPC specification version this Channel class implements
+   */
+  channelSpecVersion = _SupportedRpcVersion.v0_7_1;
   nodeUrl;
   headers;
   requestId;
@@ -4227,6 +4264,9 @@ var RpcChannel = class {
   waitMode;
   // behave like web2 rpc and return when tx is processed
   chainId;
+  /**
+   * RPC specification version of the connected node
+   */
   specVersion;
   transactionRetryIntervalFallback;
   batchClient;
@@ -4245,13 +4285,21 @@ var RpcChannel = class {
       waitMode
     } = optionsOrProvider || {};
     if (Object.values(_NetworkName).includes(nodeUrl)) {
-      this.nodeUrl = getDefaultNodeUrl(nodeUrl, optionsOrProvider?.default, "0.7");
+      this.nodeUrl = getDefaultNodeUrl(
+        nodeUrl,
+        optionsOrProvider?.default,
+        this.channelSpecVersion
+      );
     } else if (nodeUrl) {
       this.nodeUrl = nodeUrl;
     } else {
-      this.nodeUrl = getDefaultNodeUrl(void 0, optionsOrProvider?.default, "0.7");
+      this.nodeUrl = getDefaultNodeUrl(
+        void 0,
+        optionsOrProvider?.default,
+        this.channelSpecVersion
+      );
     }
-    this.baseFetch = baseFetch ?? fetch_default;
+    this.baseFetch = baseFetch || config.get("fetch") || fetch_default;
     this.blockIdentifier = blockIdentifier ?? defaultOptions.blockIdentifier;
     this.chainId = chainId;
     this.headers = { ...defaultOptions.headers, ...headers };
@@ -4329,24 +4377,32 @@ var RpcChannel = class {
     return this.chainId;
   }
   /**
-   * fetch if undefined else just return this.specVersion
-   * return this.specVersion as 'M.m'
-   * @example this.specVersion = "0.8"
+   * fetch rpc node specVersion
+   * @example this.specVersion = "0.7.1"
    */
-  async getSpecVersion() {
-    if (!this.specVersion) {
-      const extendedVersion = await this.getSpecificationVersion();
-      const [major, minor] = extendedVersion.split(".");
-      const specVerson = `${major}.${minor}`;
-      this.specVersion ??= specVerson;
-    }
-    return this.specVersion;
+  getSpecVersion() {
+    return this.fetchEndpoint("starknet_specVersion");
   }
   /**
-   * fetch spec version in extended format "M.m.p-?"
+   * fetch if undefined test and set specVersion, else just return this.specVersion
+   * @example this.specVersion = "0.7.1"
    */
-  getSpecificationVersion() {
-    return this.fetchEndpoint("starknet_specVersion");
+  async setUpSpecVersion() {
+    if (!this.specVersion) {
+      const unknownSpecVersion = await this.fetchEndpoint("starknet_specVersion");
+      if (!isVersion(this.channelSpecVersion, unknownSpecVersion)) {
+        logger.error(SYSTEM_MESSAGES.channelVersionMismatch, {
+          channelId: this.id,
+          channelSpecVersion: this.channelSpecVersion,
+          nodeSpecVersion: this.specVersion
+        });
+      }
+      if (!isSupportedSpecVersion(unknownSpecVersion)) {
+        throw new LibraryError(`${SYSTEM_MESSAGES.unsupportedSpecVersion}, channelId: ${this.id}`);
+      }
+      this.specVersion = unknownSpecVersion;
+    }
+    return this.specVersion;
   }
   getNonceForAddress(contractAddress, blockIdentifier = this.blockIdentifier) {
     const contract_address = toHex(contractAddress);
@@ -4813,9 +4869,9 @@ var RpcChannel = class {
   }
 };
 
-// src/channel/rpc_0_8.ts
-var rpc_0_8_exports = {};
-__export(rpc_0_8_exports, {
+// src/channel/rpc_0_8_1.ts
+var rpc_0_8_1_exports = {};
+__export(rpc_0_8_1_exports, {
   RpcChannel: () => RpcChannel2
 });
 var defaultOptions2 = {
@@ -4824,7 +4880,11 @@ var defaultOptions2 = {
   retries: 200
 };
 var RpcChannel2 = class {
-  id = "RPC08";
+  id = "RPC081";
+  /**
+   * RPC specification version this Channel class implements
+   */
+  channelSpecVersion = _SupportedRpcVersion.v0_8_1;
   nodeUrl;
   headers;
   requestId;
@@ -4833,6 +4893,9 @@ var RpcChannel2 = class {
   waitMode;
   // behave like web2 rpc and return when tx is processed
   chainId;
+  /**
+   * RPC specification version of the connected node
+   */
   specVersion;
   transactionRetryIntervalFallback;
   batchClient;
@@ -4851,13 +4914,21 @@ var RpcChannel2 = class {
       waitMode
     } = optionsOrProvider || {};
     if (Object.values(_NetworkName).includes(nodeUrl)) {
-      this.nodeUrl = getDefaultNodeUrl(nodeUrl, optionsOrProvider?.default, "0.8");
+      this.nodeUrl = getDefaultNodeUrl(
+        nodeUrl,
+        optionsOrProvider?.default,
+        this.channelSpecVersion
+      );
     } else if (nodeUrl) {
       this.nodeUrl = nodeUrl;
     } else {
-      this.nodeUrl = getDefaultNodeUrl(void 0, optionsOrProvider?.default, "0.8");
+      this.nodeUrl = getDefaultNodeUrl(
+        void 0,
+        optionsOrProvider?.default,
+        this.channelSpecVersion
+      );
     }
-    this.baseFetch = baseFetch ?? fetch_default;
+    this.baseFetch = baseFetch || config.get("fetch") || fetch_default;
     this.blockIdentifier = blockIdentifier ?? defaultOptions2.blockIdentifier;
     this.chainId = chainId;
     this.headers = { ...defaultOptions2.headers, ...headers };
@@ -4933,6 +5004,34 @@ var RpcChannel2 = class {
     this.chainId ??= await this.fetchEndpoint("starknet_chainId");
     return this.chainId;
   }
+  /**
+   * fetch rpc node specVersion
+   * @example this.specVersion = "0.7.1"
+   */
+  getSpecVersion() {
+    return this.fetchEndpoint("starknet_specVersion");
+  }
+  /**
+   * fetch if undefined else just return this.specVersion
+   * @example this.specVersion = "0.8.1"
+   */
+  async setUpSpecVersion() {
+    if (!this.specVersion) {
+      const unknownSpecVersion = await this.fetchEndpoint("starknet_specVersion");
+      if (!isVersion(this.channelSpecVersion, unknownSpecVersion)) {
+        logger.error(SYSTEM_MESSAGES.channelVersionMismatch, {
+          channelId: this.id,
+          channelSpecVersion: this.channelSpecVersion,
+          nodeSpecVersion: this.specVersion
+        });
+      }
+      if (!isSupportedSpecVersion(unknownSpecVersion)) {
+        throw new LibraryError(`${SYSTEM_MESSAGES.unsupportedSpecVersion}, channelId: ${this.id}`);
+      }
+      this.specVersion = unknownSpecVersion;
+    }
+    return this.specVersion;
+  }
   // TODO: New Method add test
   /**
    * Given an l1 tx hash, returns the associated l1_handler tx hashes and statuses for all L1 -> L2 messages sent by the l1 transaction, ordered by the l1 tx sending order
@@ -4962,26 +5061,6 @@ var RpcChannel2 = class {
       class_hash
     });
   }
-  /**
-   * fetch if undefined else just return this.specVersion
-   * return this.specVersion as 'M.m'
-   * @example this.specVersion = "0.8"
-   */
-  async getSpecVersion() {
-    if (!this.specVersion) {
-      const extendedVersion = await this.getSpecificationVersion();
-      const [major, minor] = extendedVersion.split(".");
-      const specVerson = `${major}.${minor}`;
-      this.specVersion ??= specVerson;
-    }
-    return this.specVersion;
-  }
-  /**
-   * fetch spec version in extended format "M.m.p-?"
-   */
-  getSpecificationVersion() {
-    return this.fetchEndpoint("starknet_specVersion");
-  }
   getNonceForAddress(contractAddress, blockIdentifier = this.blockIdentifier) {
     const contract_address = toHex(contractAddress);
     const block_id = new Block(blockIdentifier).identifier;
@@ -5363,8 +5442,16 @@ var RpcChannel2 = class {
   }
 };
 
+// src/utils/connect/ws.ts
+var ws_default = typeof WebSocket !== "undefined" && WebSocket || typeof globalThis !== "undefined" && globalThis.WebSocket || typeof window !== "undefined" && window.WebSocket.bind(window) || typeof global !== "undefined" && global.WebSocket || class {
+  constructor() {
+    throw new LibraryError(
+      "WebSocket module not detected, use the 'websocket' constructor parameter to set a compatible connection"
+    );
+  }
+};
+
 // src/channel/ws_0_8.ts
-var import_isows = require("isows");
 var WSSubscriptions = {
   NEW_HEADS: "newHeads",
   EVENTS: "events",
@@ -5489,7 +5576,7 @@ var WebSocketChannel = class {
   constructor(options = {}) {
     const nodeUrl = options.nodeUrl || "http://localhost:3000 ";
     this.nodeUrl = options.websocket ? options.websocket.url : nodeUrl;
-    this.websocket = options.websocket ? options.websocket : new import_isows.WebSocket(nodeUrl);
+    this.websocket = options.websocket || config.get("websocket") || new ws_default(nodeUrl);
     this.websocket.addEventListener("open", this.onOpen.bind(this));
     this.websocket.addEventListener("close", this.onCloseProxy.bind(this));
     this.websocket.addEventListener("message", this.onMessageProxy.bind(this));
@@ -5558,7 +5645,7 @@ var WebSocketChannel = class {
    * Helper to check connection is open
    */
   isConnected() {
-    return this.websocket.readyState === import_isows.WebSocket.OPEN;
+    return this.websocket.readyState === ws_default.OPEN;
   }
   /**
    * await while websocket is connected
@@ -5569,7 +5656,7 @@ var WebSocketChannel = class {
    * ```
    */
   async waitForConnection() {
-    if (this.websocket.readyState !== import_isows.WebSocket.OPEN) {
+    if (this.websocket.readyState !== ws_default.OPEN) {
       return new Promise((resolve, reject) => {
         if (!this.websocket) return;
         this.websocket.onopen = () => resolve(this.websocket.readyState);
@@ -5594,7 +5681,7 @@ var WebSocketChannel = class {
    * ```
    */
   async waitForDisconnection() {
-    if (this.websocket.readyState !== import_isows.WebSocket.CLOSED) {
+    if (this.websocket.readyState !== ws_default.CLOSED) {
       return new Promise((resolve, reject) => {
         if (!this.websocket) return;
         this.websocket.onclose = () => resolve(this.websocket.readyState);
@@ -5647,7 +5734,7 @@ var WebSocketChannel = class {
    * Reconnect re-create this.websocket instance
    */
   reconnect() {
-    this.websocket = new import_isows.WebSocket(this.nodeUrl);
+    this.websocket = new ws_default(this.nodeUrl);
     this.websocket.addEventListener("open", this.onOpen.bind(this));
     this.websocket.addEventListener("close", this.onCloseProxy.bind(this));
     this.websocket.addEventListener("message", this.onMessageProxy.bind(this));
@@ -6372,15 +6459,15 @@ var RpcProvider = class {
     } else {
       if (optionsOrProvider && optionsOrProvider.specVersion) {
         if (isVersion("0.8", optionsOrProvider.specVersion)) {
-          this.channel = new rpc_0_8_exports.RpcChannel({ ...optionsOrProvider, waitMode: false });
+          this.channel = new rpc_0_8_1_exports.RpcChannel({ ...optionsOrProvider, waitMode: false });
         } else if (isVersion("0.7", optionsOrProvider.specVersion)) {
-          this.channel = new rpc_0_7_exports.RpcChannel({ ...optionsOrProvider, waitMode: false });
+          this.channel = new rpc_0_7_1_exports.RpcChannel({ ...optionsOrProvider, waitMode: false });
         } else
           throw new Error(`unsupported channel for spec version: ${optionsOrProvider.specVersion}`);
       } else if (isVersion("0.8", config.get("rpcVersion"))) {
-        this.channel = new rpc_0_8_exports.RpcChannel({ ...optionsOrProvider, waitMode: false });
+        this.channel = new rpc_0_8_1_exports.RpcChannel({ ...optionsOrProvider, waitMode: false });
       } else if (isVersion("0.7", config.get("rpcVersion"))) {
-        this.channel = new rpc_0_7_exports.RpcChannel({ ...optionsOrProvider, waitMode: false });
+        this.channel = new rpc_0_7_1_exports.RpcChannel({ ...optionsOrProvider, waitMode: false });
       } else throw new Error("unable to define spec version for channel");
       this.responseParser = new RPCResponseParser(optionsOrProvider?.feeMarginPercentage);
     }
@@ -6391,15 +6478,26 @@ var RpcProvider = class {
    */
   // NOTE: the generic T and 'this' reference are used so that the expanded class is generated when a mixin is applied
   static async create(optionsOrProvider) {
-    const channel = new rpc_0_7_exports.RpcChannel({ ...optionsOrProvider });
+    const channel = new rpc_0_7_1_exports.RpcChannel({ ...optionsOrProvider });
     const spec = await channel.getSpecVersion();
+    if (!isSupportedSpecVersion(spec)) {
+      logger.warn(`Using incompatible node spec version ${spec}`);
+    }
     if (isVersion("0.7", spec)) {
-      return new this({ ...optionsOrProvider, specVersion: "0.7" });
+      return new this({
+        ...optionsOrProvider,
+        specVersion: _SupportedRpcVersion.v0_7_1
+      });
     }
     if (isVersion("0.8", spec)) {
-      return new this({ ...optionsOrProvider, specVersion: "0.8" });
+      return new this({
+        ...optionsOrProvider,
+        specVersion: _SupportedRpcVersion.v0_8_1
+      });
     }
-    throw new LibraryError("Unable to detect specification version");
+    throw new LibraryError(
+      `Provided RPC node specification version ${spec} is not compatible with the SDK. SDK supported RPC versions ${Object.keys(_SupportedRpcVersion).toString()}`
+    );
   }
   fetch(method, params, id = 0) {
     return this.channel.fetch(method, params, id);
@@ -6408,16 +6506,22 @@ var RpcProvider = class {
     return this.channel.getChainId();
   }
   /**
-   * return spec version in format "M.m"
+   * read channel spec version
+   */
+  readSpecVersion() {
+    return this.channel.readSpecVersion();
+  }
+  /**
+   * get channel spec version
    */
   async getSpecVersion() {
     return this.channel.getSpecVersion();
   }
   /**
-   * @returns return spec version in format 'M.m.p-rc'
+   * setup channel spec version and return it
    */
-  async getSpecificationVersion() {
-    return this.channel.getSpecificationVersion();
+  setUpSpecVersion() {
+    return this.channel.setUpSpecVersion();
   }
   async getNonceForAddress(contractAddress, blockIdentifier) {
     return this.channel.getNonceForAddress(contractAddress, blockIdentifier);
@@ -6782,18 +6886,18 @@ var RpcProvider = class {
   /**
    * Given an l1 tx hash, returns the associated l1_handler tx hashes and statuses for all L1 -> L2 messages sent by the l1 transaction, ordered by the l1 tx sending order
    */
-  getL1MessagesStatus(transactionHash) {
-    if (this.channel instanceof rpc_0_8_exports.RpcChannel) {
-      this.channel.getMessagesStatus(transactionHash);
+  async getL1MessagesStatus(transactionHash) {
+    if (this.channel instanceof rpc_0_8_1_exports.RpcChannel) {
+      return this.channel.getMessagesStatus(transactionHash);
     }
     throw new LibraryError("Unsupported method for RPC version");
   }
   /**
    * Get merkle paths in one of the state tries: global state, classes, individual contract
    */
-  getStorageProof(classHashes, contractAddresses, contractsStorageKeys, blockIdentifier) {
-    if (this.channel instanceof rpc_0_8_exports.RpcChannel) {
-      this.channel.getStorageProof(
+  async getStorageProof(classHashes, contractAddresses, contractsStorageKeys, blockIdentifier) {
+    if (this.channel instanceof rpc_0_8_1_exports.RpcChannel) {
+      return this.channel.getStorageProof(
         classHashes,
         contractAddresses,
         contractsStorageKeys,
@@ -6805,9 +6909,9 @@ var RpcProvider = class {
   /**
    * Get the contract class definition in the given block associated with the given hash
    */
-  getCompiledCasm(classHash) {
-    if (this.channel instanceof rpc_0_8_exports.RpcChannel) {
-      this.channel.getCompiledCasm(classHash);
+  async getCompiledCasm(classHash) {
+    if (this.channel instanceof rpc_0_8_1_exports.RpcChannel) {
+      return this.channel.getCompiledCasm(classHash);
     }
     throw new LibraryError("Unsupported method for RPC version");
   }
@@ -7887,7 +7991,7 @@ var LedgerSigner221 = class extends LedgerSigner111 {
       const ledgerResponse = await this.signTxV1(det, transactions);
       assert(
         toBigInt(msgHash) === ledgerResponse.hash,
-        "The transaction hash calculated by Starknet.js is different from the one calculated by the Ledger."
+        "The V1 transaction hash calculated by Starknet.js is different from the one calculated by the Ledger."
       );
       return ledgerResponse.signature;
     }
@@ -7904,7 +8008,7 @@ var LedgerSigner221 = class extends LedgerSigner111 {
       const ledgerResponse = await this.signTxV3(det, transactions);
       assert(
         toBigInt(msgHash) === ledgerResponse.hash,
-        "The transaction hash calculated by Starknet.js is different from the one calculated by the Ledger."
+        "The V3 transaction hash calculated by Starknet.js is different from the one calculated by the Ledger."
       );
       return ledgerResponse.signature;
     }
@@ -7985,25 +8089,369 @@ var LedgerSigner221 = class extends LedgerSigner111 {
    * @param {Call} call A Call to convert.
    * @return {Uint8Array[]} Call encoded in an array of Uint8Array (each containing 7 u256).
    */
-  encodeCall(call) {
-    const toBuf = this.convertBnToLedger(call.contractAddress);
-    const selectorBuf = hexToBytes(addAddressPadding(getSelector(call.entrypoint)));
-    let calldataBuf = new Uint8Array([]);
-    if (call.calldata) {
-      const compiledCalldata = CallData.compile(call.calldata);
-      calldataBuf = concatenateArrayBuffer(
-        compiledCalldata.map((parameter) => {
-          const a = this.convertBnToLedger(parameter);
-          return a;
-        })
-      );
-    }
-    const callBuf = concatenateArrayBuffer([toBuf, selectorBuf, calldataBuf]);
-    const calldatas = [];
-    const chunkSize = 7 * 32;
-    for (let i = 0; i < callBuf.length; i += chunkSize)
-      calldatas.push(callBuf.subarray(i, i + chunkSize));
-    return calldatas;
+  encodeCall(call) {
+    const toBuf = this.convertBnToLedger(call.contractAddress);
+    const selectorBuf = hexToBytes(addAddressPadding(getSelector(call.entrypoint)));
+    let calldataBuf = new Uint8Array([]);
+    if (call.calldata) {
+      const compiledCalldata = CallData.compile(call.calldata);
+      calldataBuf = concatenateArrayBuffer(
+        compiledCalldata.map((parameter) => {
+          const a = this.convertBnToLedger(parameter);
+          return a;
+        })
+      );
+    }
+    const callBuf = concatenateArrayBuffer([toBuf, selectorBuf, calldataBuf]);
+    const calldatas = [];
+    const chunkSize = 7 * 32;
+    for (let i = 0; i < callBuf.length; i += chunkSize)
+      calldatas.push(callBuf.subarray(i, i + chunkSize));
+    return calldatas;
+  }
+  /**
+   * Ask the Ledger Nano to display and sign a Starknet V1 transaction.
+   * @param {V2InvocationsSignerDetails} txDetails All the details needed for a txV1.
+   * @param {Call[]} calls array of Starknet invocations
+   * @returns an object including the transaction Hash and the signature
+   * @example
+   * ```typescript
+   * const calls: Call[] = [{contractAddress: "0x049d36570d4e46f48e99674bd3fcc84644ddd6b96f7c741b1562b82f9e004dc7",
+   *      entrypoint: "transfer",
+   *      calldata:["0x11f5fc2a92ac03434a7937fe982f5e5293b65ad438a989c5b78fb8f04a12016",
+   *        "0x9184e72a000", "0x0"]}];
+   * const txDet: V2InvocationsSignerDetails = {
+   *    walletAddress: txDetails.accountAddress,
+   *    chainId: constants.StarknetChainId.SN_MAIN,
+   *    cairoVersion: "1", maxFee: txDetails.max_fee,
+   *    nonce: txDetails.nonce, version: "0x1"
+   *  };
+   * const res = await myLedgerSigner.signTxV1(txDet, calls);
+   * // res = {hash:
+   * //   signature:
+   * // }
+   * ```
+   */
+  async signTxV1(txDetails, calls) {
+    await this._transporter.send(Number("0x5a"), 4, 0, 0, Buffer.from(this.pathBuffer));
+    const accountAddressBuf = this.convertBnToLedger(txDetails.walletAddress);
+    const maxFeeBuf = this.convertBnToLedger(txDetails.maxFee);
+    const chainIdBuf = this.convertBnToLedger(txDetails.chainId);
+    const nonceBuf = this.convertBnToLedger(txDetails.nonce);
+    const dataBuf = concatenateArrayBuffer([
+      accountAddressBuf,
+      maxFeeBuf,
+      chainIdBuf,
+      nonceBuf
+    ]);
+    await this._transporter.send(Number("0x5a"), 4, 1, 0, Buffer.from(dataBuf));
+    const nbCallsBuf = this.convertBnToLedger(calls.length);
+    await this._transporter.send(Number("0x5a"), 4, 2, 0, Buffer.from(nbCallsBuf));
+    let respSign = new Uint8Array(0);
+    for (const call of calls) {
+      const calldatas = this.encodeCall(call);
+      await this._transporter.send(Number("0x5a"), 4, 3, 0, Buffer.from(calldatas[0]));
+      if (calldatas.length > 1) {
+        calldatas.slice(1).forEach(async (part) => {
+          await this._transporter.send(Number("0x5a"), 4, 3, 1, Buffer.from(part));
+        });
+      }
+      respSign = await this._transporter.send(Number("0x5a"), 4, 3, 2);
+    }
+    return this.decodeSignatureLedger(respSign);
+  }
+  /**
+   * Ask to the Ledger Nano to display and sign a Starknet V3 transaction.
+   * @param {V3InvocationsSignerDetails} txDetails All the details needed for a txV3.
+   * @param {Call[]} calls array of Starknet invocations
+   * @returns an object including the transaction Hash and the signature
+   * @example
+   * ```typescript
+   * const calls: Call[] = [{contractAddress: "0x049d36570d4e46f48e99674bd3fcc84644ddd6b96f7c741b1562b82f9e004dc7",
+   *      entrypoint: "transfer",
+   *      calldata:["0x11f5fc2a92ac03434a7937fe982f5e5293b65ad438a989c5b78fb8f04a12016",
+   *        "0x9184e72a000", "0x0"]}];
+   * const txDetailsV3: V3InvocationsSignerDetails = {
+   *   chainId: constants.StarknetChainId.SN_MAIN,
+   *   nonce: "28", accountDeploymentData: [],
+   *   paymasterData: [], cairoVersion: "1",
+   *   feeDataAvailabilityMode: "L1", nonceDataAvailabilityMode: "L1",
+   *   resourceBounds: {
+   *     l1_gas: { max_amount: "0x2a00", max_price_per_unit: "0x5c00000"
+   *     },
+   *     l2_gas: { max_amount: "0x00", max_price_per_unit: "0x00"},
+   *   }, tip: 0, version: "0x3", walletAddress: account0.address
+   *  };
+   * const res = await myLedgerSigner.signTxV3(txDetailsV3, calls);
+   * // res = {hash:
+   * //   signature:
+   * // }
+   * ```
+   */
+  async signTxV3(txDetails, calls) {
+    assert(txDetails.paymasterData.length <= 7, "Paymaster data includes more than 7 items.");
+    assert(
+      txDetails.accountDeploymentData.length <= 7,
+      "accountDeploymentData includes more than 7 items"
+    );
+    await this._transporter.send(Number("0x5a"), 3, 0, 0, Buffer.from(this.pathBuffer));
+    const accountAddressBuf = this.convertBnToLedger(txDetails.walletAddress);
+    const tipBuf = this.convertBnToLedger(txDetails.tip);
+    const chainIdBuf = this.convertBnToLedger(txDetails.chainId);
+    const nonceBuf = this.convertBnToLedger(txDetails.nonce);
+    const dAModeHashBuf = this.convertBnToLedger(
+      hashDAMode(
+        txDetails.nonceDataAvailabilityMode === api_exports.EDataAvailabilityMode.L1 ? api_exports.EDAMode.L1 : api_exports.EDAMode.L2,
+        txDetails.feeDataAvailabilityMode === api_exports.EDataAvailabilityMode.L1 ? api_exports.EDAMode.L1 : api_exports.EDAMode.L2
+      )
+    );
+    const l1_gasBuf = this.convertBnToLedger(encodeResourceBoundsL1(txDetails.resourceBounds));
+    const l2_gasBuf = this.convertBnToLedger(encodeResourceBoundsL2(txDetails.resourceBounds));
+    const dataBuf = concatenateArrayBuffer([
+      accountAddressBuf,
+      tipBuf,
+      l1_gasBuf,
+      l2_gasBuf,
+      chainIdBuf,
+      nonceBuf,
+      dAModeHashBuf
+    ]);
+    await this._transporter.send(Number("0x5a"), 3, 1, 0, Buffer.from(dataBuf));
+    const paymasterBuf = concatenateArrayBuffer(
+      txDetails.paymasterData.map((value) => {
+        const a = this.convertBnToLedger(value);
+        return a;
+      })
+    );
+    await this._transporter.send(Number("0x5a"), 3, 2, 0, Buffer.from(paymasterBuf));
+    const accountDeployDataBuf = concatenateArrayBuffer(
+      txDetails.paymasterData.map((value) => {
+        const a = this.convertBnToLedger(value);
+        return a;
+      })
+    );
+    await this._transporter.send(Number("0x5a"), 3, 3, 0, Buffer.from(accountDeployDataBuf));
+    const nbCallsBuf = this.convertBnToLedger(calls.length);
+    await this._transporter.send(Number("0x5a"), 3, 4, 0, Buffer.from(nbCallsBuf));
+    let respSign = new Uint8Array(0);
+    for (const call of calls) {
+      const calldatas = this.encodeCall(call);
+      await this._transporter.send(Number("0x5a"), 3, 5, 0, Buffer.from(calldatas[0]));
+      if (calldatas.length > 1) {
+        calldatas.slice(1).forEach(async (part) => {
+          await this._transporter.send(Number("0x5a"), 3, 5, 1, Buffer.from(part));
+        });
+      }
+      respSign = await this._transporter.send(Number("0x5a"), 3, 5, 2);
+    }
+    return this.decodeSignatureLedger(respSign);
+  }
+  /**
+   * Ask the Ledger Nano to display and sign a Starknet V1 account deployment.
+   * @param {V2DeployAccountSignerDetails} deployAccountDetail All the details needed for a V1 deploy account.
+   * @returns an object including the transaction Hash and the signature
+   * @example
+   * ```typescript
+   * const deployData: V2DeployAccountSignerDetails =
+   * {
+   *  tip: 0, paymasterData: [], accountDeploymentData: [],
+   *  nonceDataAvailabilityMode: 'L1', feeDataAvailabilityMode: 'L1',
+   *  resourceBounds: {
+   *    l2_gas: { max_amount: '0x0', max_price_per_unit: '0x0' },
+   *    l1_gas: { max_amount: '0x0', max_price_per_unit: '0x0' }
+   *   },
+   *  classHash: '0x540d7f5ec7ecf317e68d48564934cb99259781b1ee3cedbbc37ec5337f8e688',
+   *  constructorCalldata: [
+   *    '89832696000889662999767022750851886674077821293893187900664573372145410755'
+   *  ],
+   *  contractAddress: '0x32c60fba64eb96831d064bbb2319375b7b7381543abe66da872e4344bcd72a0',
+   *  addressSalt: '0x0032d7efe2a9232f9b463e7206c68fdea4aeb13fec0cb308c6ba1d197d5922c3',
+   *  chainId: '0x534e5f5345504f4c4941', maxFee: 55050000000000n,
+   *  version: '0x1', nonce: 0n
+   *}
+   * const res = await myLedgerSigner.signDeployAccountV1(deployData);
+   * // res = {hash:
+   * //   signature:
+   * // }
+   * ```
+   */
+  async signDeployAccountV1(deployAccountDetail) {
+    await this._transporter.send(Number("0x5a"), 6, 0, 0, Buffer.from(this.pathBuffer));
+    const accountAddressBuf = this.convertBnToLedger(
+      deployAccountDetail.contractAddress
+    );
+    const classHashBuf = this.convertBnToLedger(deployAccountDetail.classHash);
+    const saltBuf = this.convertBnToLedger(deployAccountDetail.addressSalt);
+    const chainIdBuf = this.convertBnToLedger(deployAccountDetail.chainId);
+    const nonceBuf = this.convertBnToLedger(deployAccountDetail.nonce);
+    const dataBuf = concatenateArrayBuffer([
+      accountAddressBuf,
+      classHashBuf,
+      saltBuf,
+      chainIdBuf,
+      nonceBuf
+    ]);
+    await this._transporter.send(Number("0x5a"), 6, 1, 0, Buffer.from(dataBuf));
+    const maxFreeBuf = this.convertBnToLedger(deployAccountDetail.maxFee);
+    await this._transporter.send(Number("0x5a"), 6, 2, 0, Buffer.from(maxFreeBuf));
+    const compiledConstructor = CallData.compile(deployAccountDetail.constructorCalldata);
+    const constructorLengthBuf = this.convertBnToLedger(compiledConstructor.length);
+    await this._transporter.send(Number("0x5a"), 6, 3, 0, Buffer.from(constructorLengthBuf));
+    const constructorBuf = concatenateArrayBuffer(
+      compiledConstructor.map((parameter) => {
+        const a = this.convertBnToLedger(parameter);
+        return a;
+      })
+    );
+    const constructorChunks = [];
+    const chunkSize = 7 * 32;
+    for (let i = 0; i < constructorBuf.length; i += chunkSize)
+      constructorChunks.push(constructorBuf.subarray(i, i + chunkSize));
+    let respSign = new Uint8Array(0);
+    for (const chunk of constructorChunks) {
+      respSign = await this._transporter.send(Number("0x5a"), 6, 4, 0, Buffer.from(chunk));
+    }
+    return this.decodeSignatureLedger(respSign);
+  }
+  /**
+   *Ask the Ledger Nano to display and sign a Starknet V3 account deployment.
+   * @param {V3DeployAccountSignerDetails} deployAccountDetail All the details needed for a V3 deploy account.
+   * @returns an object including the transaction Hash and the signature
+   * @example
+   * ```typescript
+   * const deployData: V3DeployAccountSignerDetails =
+   * {
+   *  tip: 0, paymasterData: [], accountDeploymentData: [],
+   *  nonceDataAvailabilityMode: 'L1', feeDataAvailabilityMode: 'L1',
+   *  resourceBounds: {
+   *    l2_gas: { max_amount: '0x0', max_price_per_unit: '0x0' },
+   *    l1_gas: { max_amount: '0x226', max_price_per_unit: '0x22ecb25c00' }
+   *   },
+   *  classHash: '0x540d7f5ec7ecf317e68d48564934cb99259781b1ee3cedbbc37ec5337f8e688',
+   *  constructorCalldata: [
+   *    '3571125127744830445572285574469842579401255431821644822726857471463672199621'
+   *  ],
+   *  contractAddress: '0x4ca062add1cf12a107be1107af17981cf6e544a24d987693230ea481d3d5e34',
+   *  addressSalt: '0x07e52f68e3160e1ef698211cdf6d3792368fe347e7e2d4a8ace14d9b248f39c5',
+   *  chainId: '0x534e5f5345504f4c4941', maxFee: 0,
+   *  version: '0x3', nonce: 0n
+   *}
+   * const res = await myLedgerSigner.signDeployAccountV3(deployData);
+   * // res = {hash:
+   * //   signature:
+   * // }
+   * ```
+   */
+  async signDeployAccountV3(deployAccountDetail) {
+    await this._transporter.send(Number("0x5a"), 5, 0, 0, Buffer.from(this.pathBuffer));
+    const accountAddressBuf = this.convertBnToLedger(
+      deployAccountDetail.contractAddress
+    );
+    const chainIdBuf = this.convertBnToLedger(deployAccountDetail.chainId);
+    const nonceBuf = this.convertBnToLedger(deployAccountDetail.nonce);
+    const dAModeHashBuf = this.convertBnToLedger(
+      hashDAMode(
+        deployAccountDetail.nonceDataAvailabilityMode === api_exports.EDataAvailabilityMode.L1 ? api_exports.EDAMode.L1 : api_exports.EDAMode.L2,
+        deployAccountDetail.feeDataAvailabilityMode === api_exports.EDataAvailabilityMode.L1 ? api_exports.EDAMode.L1 : api_exports.EDAMode.L2
+      )
+    );
+    const classHashBuf = this.convertBnToLedger(deployAccountDetail.classHash);
+    const saltBuf = this.convertBnToLedger(deployAccountDetail.addressSalt);
+    const dataBuf = concatenateArrayBuffer([
+      accountAddressBuf,
+      chainIdBuf,
+      nonceBuf,
+      dAModeHashBuf,
+      classHashBuf,
+      saltBuf
+    ]);
+    await this._transporter.send(Number("0x5a"), 5, 1, 0, Buffer.from(dataBuf));
+    const tipBuf = this.convertBnToLedger(deployAccountDetail.tip);
+    const l1_gasBuf = this.convertBnToLedger(
+      encodeResourceBoundsL1(deployAccountDetail.resourceBounds)
+    );
+    const l2_gasBuf = this.convertBnToLedger(
+      encodeResourceBoundsL2(deployAccountDetail.resourceBounds)
+    );
+    const feeBuf = concatenateArrayBuffer([tipBuf, l1_gasBuf, l2_gasBuf]);
+    await this._transporter.send(Number("0x5a"), 5, 2, 0, Buffer.from(feeBuf));
+    const paymasterBuf = concatenateArrayBuffer(
+      deployAccountDetail.paymasterData.map((value) => {
+        const a = this.convertBnToLedger(value);
+        return a;
+      })
+    );
+    await this._transporter.send(Number("0x5a"), 5, 3, 0, Buffer.from(paymasterBuf));
+    const compiledConstructor = CallData.compile(deployAccountDetail.constructorCalldata);
+    const constructorLengthBuf = this.convertBnToLedger(compiledConstructor.length);
+    await this._transporter.send(Number("0x5a"), 5, 4, 0, Buffer.from(constructorLengthBuf));
+    const constructorBuf = concatenateArrayBuffer(
+      compiledConstructor.map((parameter) => {
+        const a = this.convertBnToLedger(parameter);
+        return a;
+      })
+    );
+    const constructorChunks = [];
+    const chunkSize = 7 * 32;
+    for (let i = 0; i < constructorBuf.length; i += chunkSize)
+      constructorChunks.push(constructorBuf.subarray(i, i + chunkSize));
+    let respSign = new Uint8Array(0);
+    for (const chunk of constructorChunks) {
+      respSign = await this._transporter.send(Number("0x5a"), 5, 5, 0, Buffer.from(chunk));
+    }
+    return this.decodeSignatureLedger(respSign);
+  }
+};
+function getLedgerPathBuffer221(accountId, applicationName = "LedgerW") {
+  const path0buff = new Uint8Array([HARDENING_BYTE, 0, 10, 85]);
+  const path1buff = new Uint8Array([71 | HARDENING_BYTE, 65, 233, 201]);
+  const path2Base = applicationName === "LedgerW" ? new Uint8Array([43, 206, 231, 219]) : stringToSha256ToArrayBuff4(applicationName);
+  const path2buff = concatenateArrayBuffer([
+    new Uint8Array([path2Base[0] | HARDENING_BYTE]),
+    path2Base.subarray(1)
+  ]);
+  const path3buff = new Uint8Array([HARDENING_BYTE, 0, 0, 0]);
+  const hex = toHex(BigInt(accountId) | HARDENING_4BYTES);
+  const padded = addHexPrefix(removeHexPrefix(hex).padStart(8, "0"));
+  const path4buff = hexToBytes(padded);
+  const path5buff = new Uint8Array([0, 0, 0, 0]);
+  const pathBuff = concatenateArrayBuffer([
+    path0buff,
+    path1buff,
+    path2buff,
+    path3buff,
+    path4buff,
+    path5buff
+  ]);
+  return pathBuff;
+}
+
+// src/signer/ledgerSigner231.ts
+var LedgerSigner231 = class extends LedgerSigner221 {
+  /**
+   * constructor of the LedgerSigner class.
+   * @param {Transport} transport 5 transports are available to handle USB, bluetooth, Node, Web, Mobile.
+   * See Guides for more details.
+   * @param {number} accountID ID of Ledger Nano account (can handle 2**31 accounts).
+   * @param {string} [eip2645application='LedgerW'] A wallet is defined by an ERC2645 derivation path (6 items).
+   * One item is called `application` and can be customized.
+   * Default value is `LedgerW`.
+   * @param {LedgerPathCalculation} [pathFunction=getLedgerPathBuffer221]
+   * defines the function that will calculate the path. By default `getLedgerPathBuffer221` is selected.
+   *
+   * If you are using APP v2.3.1 with an account created with the v1.1.1, you need to use :
+   * ```typescript
+   * const myLedgerSigner = new LedgerSigner231(myNodeTransport, 0, undefined, getLedgerPathBuffer111);
+   * ```
+   * @example
+   * ```typescript
+   * import TransportNodeHid from "@ledgerhq/hw-transport-node-hid";
+   * const myNodeTransport = await TransportNodeHid.create();
+   * const myLedgerSigner = new LedgerSigner231(myNodeTransport, 0);
+   * ```
+   */
+  constructor(transport, accountID, eip2645application = "LedgerW", pathFunction = getLedgerPathBuffer221) {
+    super(transport, accountID, eip2645application, pathFunction);
   }
   /**
    * Ask the Ledger Nano to display and sign a Starknet V1 transaction.
@@ -8046,18 +8494,17 @@ var LedgerSigner221 = class extends LedgerSigner111 {
     let respSign = new Uint8Array(0);
     for (const call of calls) {
       const calldatas = this.encodeCall(call);
-      await this._transporter.send(Number("0x5a"), 4, 3, 0, Buffer.from(calldatas[0]));
+      respSign = await this._transporter.send(Number("0x5a"), 4, 3, 0, Buffer.from(calldatas[0]));
       if (calldatas.length > 1) {
         calldatas.slice(1).forEach(async (part) => {
-          await this._transporter.send(Number("0x5a"), 4, 3, 1, Buffer.from(part));
+          respSign = await this._transporter.send(Number("0x5a"), 4, 3, 1, Buffer.from(part));
         });
       }
-      respSign = await this._transporter.send(Number("0x5a"), 4, 3, 2);
     }
     return this.decodeSignatureLedger(respSign);
   }
   /**
-   * Ask to the Ledger Nano to display and sign a Starknet V3 transaction.
+   * Ask to the Ledger Nano to display and sign a Starknet V3 transaction (Rpc 0.7 & Rpc 0.8).
    * @param {V3InvocationsSignerDetails} txDetails All the details needed for a txV3.
    * @param {Call[]} calls array of Starknet invocations
    * @returns an object including the transaction Hash and the signature
@@ -8077,7 +8524,7 @@ var LedgerSigner221 = class extends LedgerSigner111 {
    *     },
    *     l2_gas: { max_amount: "0x00", max_price_per_unit: "0x00"},
    *   }, tip: 0, version: "0x3", walletAddress: account0.address
-   *  };
+   *  }; // Rpc 0.7 transaction.
    * const res = await myLedgerSigner.signTxV3(txDetailsV3, calls);
    * // res = {hash:
    * //   signature:
@@ -8092,53 +8539,67 @@ var LedgerSigner221 = class extends LedgerSigner111 {
     );
     await this._transporter.send(Number("0x5a"), 3, 0, 0, Buffer.from(this.pathBuffer));
     const accountAddressBuf = this.convertBnToLedger(txDetails.walletAddress);
-    const tipBuf = this.convertBnToLedger(txDetails.tip);
     const chainIdBuf = this.convertBnToLedger(txDetails.chainId);
     const nonceBuf = this.convertBnToLedger(txDetails.nonce);
     const dAModeHashBuf = this.convertBnToLedger(
       hashDAMode(
-        txDetails.nonceDataAvailabilityMode === api_exports.EDataAvailabilityMode.L1 ? api_exports.EDAMode.L1 : api_exports.EDAMode.L2,
-        txDetails.feeDataAvailabilityMode === api_exports.EDataAvailabilityMode.L1 ? api_exports.EDAMode.L1 : api_exports.EDAMode.L2
+        intDAM(txDetails.nonceDataAvailabilityMode),
+        intDAM(txDetails.feeDataAvailabilityMode)
       )
     );
-    const l1_gasBuf = this.convertBnToLedger(encodeResourceBoundsL1(txDetails.resourceBounds));
-    const l2_gasBuf = this.convertBnToLedger(encodeResourceBoundsL2(txDetails.resourceBounds));
     const dataBuf = concatenateArrayBuffer([
       accountAddressBuf,
-      tipBuf,
-      l1_gasBuf,
-      l2_gasBuf,
       chainIdBuf,
       nonceBuf,
       dAModeHashBuf
     ]);
     await this._transporter.send(Number("0x5a"), 3, 1, 0, Buffer.from(dataBuf));
+    if (isRPC08_ResourceBounds(txDetails.resourceBounds)) {
+      const tipBuf = this.convertBnToLedger(txDetails.tip);
+      const l1_gasBuf = this.convertBnToLedger(encodeResourceBoundsL1(txDetails.resourceBounds));
+      const l2_gasBuf = this.convertBnToLedger(encodeResourceBoundsL2(txDetails.resourceBounds));
+      const l1_data_gasBuf = this.convertBnToLedger(
+        encodeDataResourceBoundsL1(txDetails.resourceBounds)
+      );
+      const feeBuf = concatenateArrayBuffer([
+        tipBuf,
+        l1_gasBuf,
+        l2_gasBuf,
+        l1_data_gasBuf
+      ]);
+      await this._transporter.send(Number("0x5a"), 3, 2, 0, Buffer.from(feeBuf));
+    } else {
+      const tipBuf = this.convertBnToLedger(txDetails.tip);
+      const l1_gasBuf = this.convertBnToLedger(encodeResourceBoundsL1(txDetails.resourceBounds));
+      const l2_gasBuf = this.convertBnToLedger(encodeResourceBoundsL2(txDetails.resourceBounds));
+      const feeBuf = concatenateArrayBuffer([tipBuf, l1_gasBuf, l2_gasBuf]);
+      await this._transporter.send(Number("0x5a"), 3, 2, 0, Buffer.from(feeBuf));
+    }
     const paymasterBuf = concatenateArrayBuffer(
       txDetails.paymasterData.map((value) => {
         const a = this.convertBnToLedger(value);
         return a;
       })
     );
-    await this._transporter.send(Number("0x5a"), 3, 2, 0, Buffer.from(paymasterBuf));
+    await this._transporter.send(Number("0x5a"), 3, 3, 0, Buffer.from(paymasterBuf));
     const accountDeployDataBuf = concatenateArrayBuffer(
       txDetails.paymasterData.map((value) => {
         const a = this.convertBnToLedger(value);
         return a;
       })
     );
-    await this._transporter.send(Number("0x5a"), 3, 3, 0, Buffer.from(accountDeployDataBuf));
+    await this._transporter.send(Number("0x5a"), 3, 4, 0, Buffer.from(accountDeployDataBuf));
     const nbCallsBuf = this.convertBnToLedger(calls.length);
-    await this._transporter.send(Number("0x5a"), 3, 4, 0, Buffer.from(nbCallsBuf));
+    await this._transporter.send(Number("0x5a"), 3, 5, 0, Buffer.from(nbCallsBuf));
     let respSign = new Uint8Array(0);
     for (const call of calls) {
       const calldatas = this.encodeCall(call);
-      await this._transporter.send(Number("0x5a"), 3, 5, 0, Buffer.from(calldatas[0]));
+      respSign = await this._transporter.send(Number("0x5a"), 3, 6, 0, Buffer.from(calldatas[0]));
       if (calldatas.length > 1) {
         calldatas.slice(1).forEach(async (part) => {
-          await this._transporter.send(Number("0x5a"), 3, 5, 1, Buffer.from(part));
+          respSign = await this._transporter.send(Number("0x5a"), 3, 6, 1, Buffer.from(part));
         });
       }
-      respSign = await this._transporter.send(Number("0x5a"), 3, 5, 2);
     }
     return this.decodeSignatureLedger(respSign);
   }
@@ -8178,21 +8639,21 @@ var LedgerSigner221 = class extends LedgerSigner111 {
     );
     const classHashBuf = this.convertBnToLedger(deployAccountDetail.classHash);
     const saltBuf = this.convertBnToLedger(deployAccountDetail.addressSalt);
+    const maxFeeBuf = this.convertBnToLedger(deployAccountDetail.maxFee);
     const chainIdBuf = this.convertBnToLedger(deployAccountDetail.chainId);
     const nonceBuf = this.convertBnToLedger(deployAccountDetail.nonce);
     const dataBuf = concatenateArrayBuffer([
       accountAddressBuf,
       classHashBuf,
       saltBuf,
+      maxFeeBuf,
       chainIdBuf,
       nonceBuf
     ]);
     await this._transporter.send(Number("0x5a"), 6, 1, 0, Buffer.from(dataBuf));
-    const maxFreeBuf = this.convertBnToLedger(deployAccountDetail.maxFee);
-    await this._transporter.send(Number("0x5a"), 6, 2, 0, Buffer.from(maxFreeBuf));
     const compiledConstructor = CallData.compile(deployAccountDetail.constructorCalldata);
     const constructorLengthBuf = this.convertBnToLedger(compiledConstructor.length);
-    await this._transporter.send(Number("0x5a"), 6, 3, 0, Buffer.from(constructorLengthBuf));
+    await this._transporter.send(Number("0x5a"), 6, 2, 0, Buffer.from(constructorLengthBuf));
     const constructorBuf = concatenateArrayBuffer(
       compiledConstructor.map((parameter) => {
         const a = this.convertBnToLedger(parameter);
@@ -8205,12 +8666,12 @@ var LedgerSigner221 = class extends LedgerSigner111 {
       constructorChunks.push(constructorBuf.subarray(i, i + chunkSize));
     let respSign = new Uint8Array(0);
     for (const chunk of constructorChunks) {
-      respSign = await this._transporter.send(Number("0x5a"), 6, 4, 0, Buffer.from(chunk));
+      respSign = await this._transporter.send(Number("0x5a"), 6, 3, 0, Buffer.from(chunk));
     }
     return this.decodeSignatureLedger(respSign);
   }
   /**
-   *Ask the Ledger Nano to display and sign a Starknet V3 account deployment.
+   *Ask the Ledger Nano to display and sign a Starknet V3 account deployment (Rpc 0.7 & Rpc 0.8).
    * @param {V3DeployAccountSignerDetails} deployAccountDetail All the details needed for a V3 deploy account.
    * @returns an object including the transaction Hash and the signature
    * @example
@@ -8231,7 +8692,7 @@ var LedgerSigner221 = class extends LedgerSigner111 {
    *  addressSalt: '0x07e52f68e3160e1ef698211cdf6d3792368fe347e7e2d4a8ace14d9b248f39c5',
    *  chainId: '0x534e5f5345504f4c4941', maxFee: 0,
    *  version: '0x3', nonce: 0n
-   *}
+   *} // Rpc 0.7 transaction.
    * const res = await myLedgerSigner.signDeployAccountV3(deployData);
    * // res = {hash:
    * //   signature:
@@ -8247,8 +8708,8 @@ var LedgerSigner221 = class extends LedgerSigner111 {
     const nonceBuf = this.convertBnToLedger(deployAccountDetail.nonce);
     const dAModeHashBuf = this.convertBnToLedger(
       hashDAMode(
-        deployAccountDetail.nonceDataAvailabilityMode === api_exports.EDataAvailabilityMode.L1 ? api_exports.EDAMode.L1 : api_exports.EDAMode.L2,
-        deployAccountDetail.feeDataAvailabilityMode === api_exports.EDataAvailabilityMode.L1 ? api_exports.EDAMode.L1 : api_exports.EDAMode.L2
+        intDAM(deployAccountDetail.nonceDataAvailabilityMode),
+        intDAM(deployAccountDetail.feeDataAvailabilityMode)
       )
     );
     const classHashBuf = this.convertBnToLedger(deployAccountDetail.classHash);
@@ -8262,15 +8723,35 @@ var LedgerSigner221 = class extends LedgerSigner111 {
       saltBuf
     ]);
     await this._transporter.send(Number("0x5a"), 5, 1, 0, Buffer.from(dataBuf));
-    const tipBuf = this.convertBnToLedger(deployAccountDetail.tip);
-    const l1_gasBuf = this.convertBnToLedger(
-      encodeResourceBoundsL1(deployAccountDetail.resourceBounds)
-    );
-    const l2_gasBuf = this.convertBnToLedger(
-      encodeResourceBoundsL2(deployAccountDetail.resourceBounds)
-    );
-    const feeBuf = concatenateArrayBuffer([tipBuf, l1_gasBuf, l2_gasBuf]);
-    await this._transporter.send(Number("0x5a"), 5, 2, 0, Buffer.from(feeBuf));
+    if (isRPC08_ResourceBounds(deployAccountDetail.resourceBounds)) {
+      const tipBuf = this.convertBnToLedger(deployAccountDetail.tip);
+      const l1_gasBuf = this.convertBnToLedger(
+        encodeResourceBoundsL1(deployAccountDetail.resourceBounds)
+      );
+      const l2_gasBuf = this.convertBnToLedger(
+        encodeResourceBoundsL2(deployAccountDetail.resourceBounds)
+      );
+      const l1_data_gasBuf = this.convertBnToLedger(
+        encodeDataResourceBoundsL1(deployAccountDetail.resourceBounds)
+      );
+      const feeBuf = concatenateArrayBuffer([
+        tipBuf,
+        l1_gasBuf,
+        l2_gasBuf,
+        l1_data_gasBuf
+      ]);
+      await this._transporter.send(Number("0x5a"), 5, 2, 0, Buffer.from(feeBuf));
+    } else {
+      const tipBuf = this.convertBnToLedger(deployAccountDetail.tip);
+      const l1_gasBuf = this.convertBnToLedger(
+        encodeResourceBoundsL1(deployAccountDetail.resourceBounds)
+      );
+      const l2_gasBuf = this.convertBnToLedger(
+        encodeResourceBoundsL2(deployAccountDetail.resourceBounds)
+      );
+      const feeBuf = concatenateArrayBuffer([tipBuf, l1_gasBuf, l2_gasBuf]);
+      await this._transporter.send(Number("0x5a"), 5, 2, 0, Buffer.from(feeBuf));
+    }
     const paymasterBuf = concatenateArrayBuffer(
       deployAccountDetail.paymasterData.map((value) => {
         const a = this.convertBnToLedger(value);
@@ -8297,30 +8778,35 @@ var LedgerSigner221 = class extends LedgerSigner111 {
     }
     return this.decodeSignatureLedger(respSign);
   }
+  /** Internal function to convert a Call to an array of Uint8Array.
+   * @param {Call} call A Call to convert.
+   * @return {Uint8Array[]} Call encoded in an array of Uint8Array (each containing 7 u256).
+   */
+  encodeCall(call) {
+    const toBuf = this.convertBnToLedger(call.contractAddress);
+    const selectorBuf = hexToBytes(addAddressPadding(getSelector(call.entrypoint)));
+    let calldataBuf = new Uint8Array([]);
+    if (call.calldata) {
+      const compiledCalldata = CallData.compile(call.calldata);
+      const calldataSizeBuf = this.convertBnToLedger(compiledCalldata.length);
+      calldataBuf = concatenateArrayBuffer([
+        calldataSizeBuf,
+        ...compiledCalldata.map((parameter) => {
+          const a = this.convertBnToLedger(parameter);
+          return a;
+        })
+      ]);
+    } else {
+      calldataBuf = this.convertBnToLedger("0x00");
+    }
+    const callBuf = concatenateArrayBuffer([toBuf, selectorBuf, calldataBuf]);
+    const calldatas = [];
+    const chunkSize = 7 * 32;
+    for (let i = 0; i < callBuf.length; i += chunkSize)
+      calldatas.push(callBuf.subarray(i, i + chunkSize));
+    return calldatas;
+  }
 };
-function getLedgerPathBuffer221(accountId, applicationName = "LedgerW") {
-  const path0buff = new Uint8Array([HARDENING_BYTE, 0, 10, 85]);
-  const path1buff = new Uint8Array([71 | HARDENING_BYTE, 65, 233, 201]);
-  const path2Base = applicationName === "LedgerW" ? new Uint8Array([43, 206, 231, 219]) : stringToSha256ToArrayBuff4(applicationName);
-  const path2buff = concatenateArrayBuffer([
-    new Uint8Array([path2Base[0] | HARDENING_BYTE]),
-    path2Base.subarray(1)
-  ]);
-  const path3buff = new Uint8Array([HARDENING_BYTE, 0, 0, 0]);
-  const hex = toHex(BigInt(accountId) | HARDENING_4BYTES);
-  const padded = addHexPrefix(removeHexPrefix(hex).padStart(8, "0"));
-  const path4buff = hexToBytes(padded);
-  const path5buff = new Uint8Array([0, 0, 0, 0]);
-  const pathBuff = concatenateArrayBuffer([
-    path0buff,
-    path1buff,
-    path2buff,
-    path3buff,
-    path4buff,
-    path5buff
-  ]);
-  return pathBuff;
-}
 
 // src/utils/events/index.ts
 var events_exports = {};
@@ -8574,13 +9060,257 @@ async function supportsInterface(provider, contractAddress, interfaceId) {
   }
 }
 
+// src/utils/paymaster.ts
+var paymaster_exports = {};
+__export(paymaster_exports, {
+  getDefaultPaymasterNodeUrl: () => getDefaultPaymasterNodeUrl
+});
+var getDefaultPaymasterNodeUrl = (networkName, mute = false) => {
+  if (!mute) {
+    logger.info("Using default public node url, please provide nodeUrl in provider options!");
+  }
+  const nodes = PAYMASTER_RPC_NODES[networkName ?? _NetworkName.SN_SEPOLIA];
+  const randIdx = Math.floor(Math.random() * nodes.length);
+  return nodes[randIdx];
+};
+
+// src/paymaster/rpc.ts
+var convertCalls = (calls) => calls.map((call) => ({
+  to: call.contractAddress,
+  selector: getSelectorFromName(call.entrypoint),
+  calldata: CallData.toHex(call.calldata)
+}));
+var convertFeeMode = (feeMode) => {
+  if (feeMode.mode === "sponsored") {
+    return { mode: "sponsored" };
+  }
+  return { mode: "default", gas_token: feeMode.gasToken };
+};
+var convertFEE_MODE = (feeMode) => {
+  if (feeMode.mode === "sponsored") {
+    return { mode: "sponsored" };
+  }
+  return { mode: "default", gasToken: feeMode.gas_token };
+};
+var convertTimeBounds = (timeBounds) => timeBounds && timeBounds.executeAfter && timeBounds.executeBefore ? {
+  execute_after: timeBounds.executeAfter.getTime().toString(),
+  execute_before: timeBounds.executeBefore.getTime().toString()
+} : void 0;
+var convertTIME_BOUNDS = (timeBounds) => timeBounds && timeBounds.execute_after && timeBounds.execute_before ? {
+  executeAfter: new Date(timeBounds.execute_after),
+  executeBefore: new Date(timeBounds.execute_before)
+} : void 0;
+var convertEXECUTION_PARAMETERS = (parameters) => ({
+  version: parameters.version,
+  feeMode: convertFEE_MODE(parameters.fee_mode),
+  timeBounds: convertTIME_BOUNDS(parameters.time_bounds)
+});
+var defaultOptions3 = {
+  headers: { "Content-Type": "application/json" }
+};
+var PaymasterRpc = class _PaymasterRpc {
+  nodeUrl;
+  headers;
+  baseFetch;
+  requestId;
+  constructor(options) {
+    if (options instanceof _PaymasterRpc) {
+      this.nodeUrl = options.nodeUrl;
+      this.headers = { ...defaultOptions3.headers, ...options.headers };
+      this.baseFetch = options.baseFetch;
+      this.requestId = options.requestId;
+      return;
+    }
+    if (options && "nodeUrl" in options && "headers" in options && "baseFetch" in options) {
+      this.nodeUrl = options.nodeUrl ?? getDefaultPaymasterNodeUrl(void 0);
+      this.headers = { ...defaultOptions3.headers, ...options.headers };
+      this.baseFetch = options.baseFetch ?? fetch_default;
+      this.requestId = 0;
+      return;
+    }
+    const { nodeUrl, headers, baseFetch } = options || {};
+    if (nodeUrl && Object.values(_NetworkName).includes(nodeUrl)) {
+      this.nodeUrl = getDefaultPaymasterNodeUrl(nodeUrl, options?.default);
+    } else if (nodeUrl) {
+      this.nodeUrl = nodeUrl;
+    } else {
+      this.nodeUrl = getDefaultPaymasterNodeUrl(void 0, options?.default);
+    }
+    this.baseFetch = baseFetch ?? fetch_default;
+    this.headers = { ...defaultOptions3.headers, ...headers };
+    this.requestId = 0;
+  }
+  fetch(method, params, id = 0) {
+    const rpcRequestBody = {
+      id,
+      jsonrpc: "2.0",
+      method,
+      ...params && { params }
+    };
+    return this.baseFetch(this.nodeUrl, {
+      method: "POST",
+      body: stringify2(rpcRequestBody),
+      headers: this.headers
+    });
+  }
+  errorHandler(method, params, rpcError, otherError) {
+    if (rpcError) {
+      throw new RpcError(rpcError, method, params);
+    }
+    if (otherError instanceof LibraryError) {
+      throw otherError;
+    }
+    if (otherError) {
+      throw Error(otherError.message);
+    }
+  }
+  async fetchEndpoint(method, params) {
+    try {
+      this.requestId += 1;
+      const rawResult = await this.fetch(method, params, this.requestId);
+      const { error, result } = await rawResult.json();
+      this.errorHandler(method, params, error);
+      return result;
+    } catch (error) {
+      this.errorHandler(method, params, error?.response?.data, error);
+      throw error;
+    }
+  }
+  async isAvailable() {
+    return this.fetchEndpoint("paymaster_isAvailable");
+  }
+  async buildTransaction(transaction, parameters) {
+    let userTransaction;
+    switch (transaction.type) {
+      case "invoke":
+        userTransaction = {
+          ...transaction,
+          invoke: {
+            user_address: transaction.invoke.userAddress,
+            calls: convertCalls(transaction.invoke.calls)
+          }
+        };
+        break;
+      case "deploy_and_invoke":
+        userTransaction = {
+          ...transaction,
+          invoke: {
+            user_address: transaction.invoke.userAddress,
+            calls: convertCalls(transaction.invoke.calls)
+          }
+        };
+        break;
+      case "deploy":
+      default:
+        userTransaction = transaction;
+        break;
+    }
+    const executionParameters = {
+      version: parameters.version,
+      fee_mode: convertFeeMode(parameters.feeMode),
+      time_bounds: convertTimeBounds(parameters.timeBounds)
+    };
+    const response = await this.fetchEndpoint("paymaster_buildTransaction", {
+      transaction: userTransaction,
+      parameters: executionParameters
+    });
+    const fee = {
+      gas_token_price_in_strk: BigInt(response.fee.gas_token_price_in_strk),
+      estimated_fee_in_strk: BigInt(response.fee.estimated_fee_in_strk),
+      estimated_fee_in_gas_token: BigInt(response.fee.estimated_fee_in_gas_token),
+      suggested_max_fee_in_strk: BigInt(response.fee.suggested_max_fee_in_strk),
+      suggested_max_fee_in_gas_token: BigInt(response.fee.suggested_max_fee_in_gas_token)
+    };
+    switch (response.type) {
+      case "invoke":
+        return {
+          type: "invoke",
+          typed_data: response.typed_data,
+          parameters: convertEXECUTION_PARAMETERS(response.parameters),
+          fee
+        };
+      case "deploy_and_invoke":
+        return {
+          type: "deploy_and_invoke",
+          deployment: response.deployment,
+          typed_data: response.typed_data,
+          parameters: convertEXECUTION_PARAMETERS(response.parameters),
+          fee
+        };
+      case "deploy":
+      default:
+        return {
+          type: "deploy",
+          deployment: response.deployment,
+          parameters: convertEXECUTION_PARAMETERS(response.parameters),
+          fee
+        };
+    }
+  }
+  async executeTransaction(transaction, parameters) {
+    let user_transaction;
+    switch (transaction.type) {
+      case "invoke":
+        user_transaction = {
+          ...transaction,
+          invoke: {
+            user_address: transaction.invoke.userAddress,
+            typed_data: transaction.invoke.typedData,
+            signature: signatureToHexArray(transaction.invoke.signature)
+          }
+        };
+        break;
+      case "deploy_and_invoke":
+        user_transaction = {
+          ...transaction,
+          invoke: {
+            user_address: transaction.invoke.userAddress,
+            typed_data: transaction.invoke.typedData,
+            signature: signatureToHexArray(transaction.invoke.signature)
+          }
+        };
+        break;
+      case "deploy":
+      default:
+        user_transaction = transaction;
+        break;
+    }
+    const executionParameters = {
+      version: parameters.version,
+      fee_mode: convertFeeMode(parameters.feeMode),
+      time_bounds: convertTimeBounds(parameters.timeBounds)
+    };
+    return this.fetchEndpoint("paymaster_executeTransaction", {
+      transaction: user_transaction,
+      parameters: executionParameters
+    });
+  }
+  async getSupportedTokens() {
+    return this.fetchEndpoint("paymaster_getSupportedTokens").then(
+      (tokens) => tokens.map((token) => ({
+        token_address: token.token_address,
+        decimals: token.decimals,
+        priceInStrk: BigInt(token.price_in_strk)
+      }))
+    );
+  }
+};
+
+// src/paymaster/interface.ts
+var PaymasterInterface = class {
+};
+
+// src/paymaster/index.ts
+var defaultPaymaster = new PaymasterRpc({ default: true });
+
 // src/account/default.ts
 var Account = class extends RpcProvider2 {
   signer;
   address;
   cairoVersion;
   transactionVersion;
-  constructor(providerOrOptions, address, pkOrSigner, cairoVersion, transactionVersion = config.get("transactionVersion")) {
+  paymaster;
+  constructor(providerOrOptions, address, pkOrSigner, cairoVersion, transactionVersion = config.get("transactionVersion"), paymaster) {
     super(providerOrOptions);
     this.address = address.toLowerCase();
     this.signer = isString(pkOrSigner) || pkOrSigner instanceof Uint8Array ? new Signer(pkOrSigner) : pkOrSigner;
@@ -8588,6 +9318,7 @@ var Account = class extends RpcProvider2 {
       this.cairoVersion = cairoVersion.toString();
     }
     this.transactionVersion = transactionVersion;
+    this.paymaster = paymaster ? new PaymasterRpc(paymaster) : defaultPaymaster;
     logger.debug("Account setup", {
       transactionVersion: this.transactionVersion,
       cairoVersion: this.cairoVersion,
@@ -8645,7 +9376,7 @@ var Account = class extends RpcProvider2 {
     );
     const chainId = await this.getChainId();
     const signerDetails = {
-      ...v3Details(details, await this.channel.getSpecVersion()),
+      ...v3Details(details, await this.channel.setUpSpecVersion()),
       walletAddress: this.address,
       nonce,
       maxFee: ZERO,
@@ -8657,7 +9388,7 @@ var Account = class extends RpcProvider2 {
     const invocation = await this.buildInvocation(transactions, signerDetails);
     return super.getInvokeEstimateFee(
       { ...invocation },
-      { ...v3Details(details, await this.channel.getSpecVersion()), version, nonce },
+      { ...v3Details(details, await this.channel.setUpSpecVersion()), version, nonce },
       blockIdentifier,
       details.skipValidate
     );
@@ -8676,7 +9407,7 @@ var Account = class extends RpcProvider2 {
     );
     const chainId = await this.getChainId();
     const declareContractTransaction = await this.buildDeclarePayload(payload, {
-      ...v3Details(details, await this.channel.getSpecVersion()),
+      ...v3Details(details, await this.channel.setUpSpecVersion()),
       nonce,
       chainId,
       version,
@@ -8688,7 +9419,7 @@ var Account = class extends RpcProvider2 {
     });
     return super.getDeclareEstimateFee(
       declareContractTransaction,
-      { ...v3Details(details, await this.channel.getSpecVersion()), version, nonce },
+      { ...v3Details(details, await this.channel.setUpSpecVersion()), version, nonce },
       blockIdentifier,
       details.skipValidate
     );
@@ -8709,7 +9440,7 @@ var Account = class extends RpcProvider2 {
     const payload = await this.buildAccountDeployPayload(
       { classHash, addressSalt, constructorCalldata, contractAddress },
       {
-        ...v3Details(details, await this.channel.getSpecVersion()),
+        ...v3Details(details, await this.channel.setUpSpecVersion()),
         nonce,
         chainId,
         version,
@@ -8723,7 +9454,7 @@ var Account = class extends RpcProvider2 {
     );
     return super.getDeployAccountEstimateFee(
       { ...payload },
-      { ...v3Details(details, await this.channel.getSpecVersion()), version, nonce },
+      { ...v3Details(details, await this.channel.setUpSpecVersion()), version, nonce },
       blockIdentifier,
       details.skipValidate
     );
@@ -8736,7 +9467,7 @@ var Account = class extends RpcProvider2 {
     if (!invocations.length) throw TypeError("Invocations should be non-empty array");
     const { nonce, blockIdentifier, version, skipValidate } = details;
     const accountInvocations = await this.accountInvocationsFactory(invocations, {
-      ...v3Details(details, await this.channel.getSpecVersion()),
+      ...v3Details(details, await this.channel.setUpSpecVersion()),
       versions: [
         ETransactionVersion2.F1,
         // non-sierra
@@ -8759,7 +9490,7 @@ var Account = class extends RpcProvider2 {
     if (!invocations.length) throw TypeError("Invocations should be non-empty array");
     const { nonce, blockIdentifier, skipValidate = true, skipExecute, version } = details;
     const accountInvocations = await this.accountInvocationsFactory(invocations, {
-      ...v3Details(details, await this.channel.getSpecVersion()),
+      ...v3Details(details, await this.channel.setUpSpecVersion()),
       versions: [
         ETransactionVersion2.V1,
         // non-sierra
@@ -8780,6 +9511,13 @@ var Account = class extends RpcProvider2 {
   }
   async execute(transactions, transactionsDetail = {}) {
     const calls = Array.isArray(transactions) ? transactions : [transactions];
+    if (transactionsDetail.paymaster) {
+      return this.executePaymasterTransaction(
+        calls,
+        transactionsDetail.paymaster,
+        transactionsDetail.maxFee
+      );
+    }
     const nonce = toBigInt(transactionsDetail.nonce ?? await this.getNonce());
     const version = toTransactionVersion(
       this.getPreferredVersion(ETransactionVersion2.V1, ETransactionVersion2.V3),
@@ -8796,7 +9534,7 @@ var Account = class extends RpcProvider2 {
     );
     const chainId = await this.getChainId();
     const signerDetails = {
-      ...v3Details(transactionsDetail, await this.channel.getSpecVersion()),
+      ...v3Details(transactionsDetail, await this.channel.setUpSpecVersion()),
       resourceBounds: estimate.resourceBounds,
       walletAddress: this.address,
       nonce,
@@ -8810,7 +9548,7 @@ var Account = class extends RpcProvider2 {
     return this.invokeFunction(
       { contractAddress: this.address, calldata, signature },
       {
-        ...v3Details(transactionsDetail, await this.channel.getSpecVersion()),
+        ...v3Details(transactionsDetail, await this.channel.setUpSpecVersion()),
         resourceBounds: estimate.resourceBounds,
         nonce,
         maxFee: estimate.maxFee,
@@ -8818,6 +9556,88 @@ var Account = class extends RpcProvider2 {
       }
     );
   }
+  async buildPaymasterTransaction(calls, paymasterDetails) {
+    if (!paymasterDetails.deploymentData) {
+      const snip9Version = await this.getSnip9Version();
+      if (snip9Version === OutsideExecutionVersion.UNSUPPORTED) {
+        throw Error("Account is not compatible with SNIP-9");
+      }
+    }
+    const parameters = {
+      version: "0x1",
+      feeMode: paymasterDetails.feeMode,
+      timeBounds: paymasterDetails.timeBounds
+    };
+    let transaction;
+    if (paymasterDetails.deploymentData) {
+      if (calls.length > 0) {
+        transaction = {
+          type: "deploy_and_invoke",
+          invoke: { userAddress: this.address, calls },
+          deployment: paymasterDetails.deploymentData
+        };
+      } else {
+        transaction = {
+          type: "deploy",
+          deployment: paymasterDetails.deploymentData
+        };
+      }
+    } else {
+      transaction = {
+        type: "invoke",
+        invoke: { userAddress: this.address, calls }
+      };
+    }
+    return this.paymaster.buildTransaction(transaction, parameters);
+  }
+  async estimatePaymasterTransactionFee(calls, paymasterDetails) {
+    const preparedTransaction = await this.buildPaymasterTransaction(calls, paymasterDetails);
+    return preparedTransaction.fee;
+  }
+  async executePaymasterTransaction(calls, paymasterDetails, maxFee) {
+    const preparedTransaction = await this.buildPaymasterTransaction(calls, paymasterDetails);
+    if (maxFee && preparedTransaction.fee.gas_token_price_in_strk > maxFee) {
+      throw Error("Gas token price is too high");
+    }
+    let transaction;
+    switch (preparedTransaction.type) {
+      case "deploy_and_invoke": {
+        const signature = await this.signMessage(preparedTransaction.typed_data);
+        transaction = {
+          type: "deploy_and_invoke",
+          invoke: {
+            userAddress: this.address,
+            typedData: preparedTransaction.typed_data,
+            signature: signatureToHexArray(signature)
+          },
+          deployment: preparedTransaction.deployment
+        };
+        break;
+      }
+      case "invoke": {
+        const signature = await this.signMessage(preparedTransaction.typed_data);
+        transaction = {
+          type: "invoke",
+          invoke: {
+            userAddress: this.address,
+            typedData: preparedTransaction.typed_data,
+            signature: signatureToHexArray(signature)
+          }
+        };
+        break;
+      }
+      case "deploy": {
+        transaction = {
+          type: "deploy",
+          deployment: preparedTransaction.deployment
+        };
+        break;
+      }
+      default:
+        throw Error("Invalid transaction type");
+    }
+    return this.paymaster.executeTransaction(transaction, preparedTransaction.parameters).then((response) => ({ transaction_hash: response.transaction_hash }));
+  }
   /**
    * First check if contract is already declared, if not declare it
    * If contract already declared returned transaction_hash is ''.
@@ -8855,7 +9675,7 @@ var Account = class extends RpcProvider2 {
       }
     );
     const declareDetails = {
-      ...v3Details(details, await this.channel.getSpecVersion()),
+      ...v3Details(details, await this.channel.setUpSpecVersion()),
       resourceBounds: estimate.resourceBounds,
       maxFee: estimate.maxFee,
       nonce: toBigInt(nonce ?? await this.getNonce()),
@@ -8925,7 +9745,7 @@ var Account = class extends RpcProvider2 {
       details
     );
     const signature = await this.signer.signDeployAccountTransaction({
-      ...v3Details(details, await this.channel.getSpecVersion()),
+      ...v3Details(details, await this.channel.setUpSpecVersion()),
       classHash,
       constructorCalldata: compiledCalldata,
       contractAddress,
@@ -8939,7 +9759,7 @@ var Account = class extends RpcProvider2 {
     return this.deployAccountContract(
       { classHash, addressSalt, constructorCalldata, signature },
       {
-        ...v3Details(details, await this.channel.getSpecVersion()),
+        ...v3Details(details, await this.channel.setUpSpecVersion()),
         nonce,
         resourceBounds: estimate.resourceBounds,
         maxFee: estimate.maxFee,
@@ -9106,7 +9926,7 @@ var Account = class extends RpcProvider2 {
     let resourceBounds = estimateFeeToBounds3(
       ZERO,
       void 0,
-      await this.channel.getSpecVersion()
+      await this.channel.setUpSpecVersion()
     );
     if (version === ETransactionVersion2.V3) {
       resourceBounds = details.resourceBounds ?? (await this.getSuggestedFee({ type, payload }, details)).resourceBounds;
@@ -9129,14 +9949,14 @@ var Account = class extends RpcProvider2 {
       case TransactionType.DEPLOY:
         return this.estimateDeployFee(payload, details);
       default:
-        return ZEROFee(await this.channel.getSpecVersion());
+        return ZEROFee(await this.channel.setUpSpecVersion());
     }
   }
   async buildInvocation(call, details) {
     const calldata = getExecuteCalldata(call, await this.getCairoVersion());
     const signature = !details.skipValidate ? await this.signer.signTransaction(call, details) : [];
     return {
-      ...v3Details(details, await this.channel.getSpecVersion()),
+      ...v3Details(details, await this.channel.setUpSpecVersion()),
       contractAddress: this.address,
       calldata,
       signature
@@ -9150,7 +9970,7 @@ var Account = class extends RpcProvider2 {
     }
     const signature = !details.skipValidate ? await this.signer.signDeclareTransaction({
       ...details,
-      ...v3Details(details, await this.channel.getSpecVersion()),
+      ...v3Details(details, await this.channel.setUpSpecVersion()),
       classHash,
       compiledClassHash,
       // TODO: TS, cast because optional for v2 and required for v3, thrown if not present
@@ -9173,14 +9993,14 @@ var Account = class extends RpcProvider2 {
     const contractAddress = providedContractAddress ?? calculateContractAddressFromHash(addressSalt, classHash, compiledCalldata, 0);
     const signature = !details.skipValidate ? await this.signer.signDeployAccountTransaction({
       ...details,
-      ...v3Details(details, await this.channel.getSpecVersion()),
+      ...v3Details(details, await this.channel.setUpSpecVersion()),
       classHash,
       contractAddress,
       addressSalt,
       constructorCalldata: compiledCalldata
     }) : [];
     return {
-      ...v3Details(details, await this.channel.getSpecVersion()),
+      ...v3Details(details, await this.channel.setUpSpecVersion()),
       classHash,
       addressSalt,
       constructorCalldata: compiledCalldata,
@@ -9221,7 +10041,7 @@ var Account = class extends RpcProvider2 {
       [].concat(invocations).map(async (transaction, index) => {
         const txPayload = "payload" in transaction ? transaction.payload : transaction;
         const signerDetails = {
-          ...v3Details(details, await this.channel.getSpecVersion()),
+          ...v3Details(details, await this.channel.setUpSpecVersion()),
           walletAddress: this.address,
           nonce: toBigInt(Number(safeNonce) + index),
           maxFee: ZERO,
@@ -9364,8 +10184,8 @@ function onNetworkChanged(swo, callback) {
 // src/wallet/account.ts
 var WalletAccount = class _WalletAccount extends Account {
   walletProvider;
-  constructor(providerOrOptions, walletProvider, address, cairoVersion) {
-    super(providerOrOptions, address, "", cairoVersion);
+  constructor(providerOrOptions, walletProvider, address, cairoVersion, paymaster) {
+    super(providerOrOptions, address, "", cairoVersion, void 0, paymaster);
     this.walletProvider = walletProvider;
     this.walletProvider.on("accountsChanged", (res) => {
       if (!res) return;
@@ -9406,7 +10226,14 @@ var WalletAccount = class _WalletAccount extends Account {
   /**
    * ACCOUNT METHODS
    */
-  execute(calls) {
+  execute(calls, arg2, transactionsDetail = {}) {
+    const details = arg2 === void 0 || Array.isArray(arg2) ? transactionsDetail : arg2;
+    if (details.paymaster) {
+      return this.executePaymasterTransaction(
+        Array.isArray(calls) ? calls : [calls],
+        details.paymaster
+      );
+    }
     const txCalls = [].concat(calls).map((it) => {
       const { contractAddress, entrypoint, calldata } = it;
       return {
@@ -9447,12 +10274,12 @@ var WalletAccount = class _WalletAccount extends Account {
   signMessage(typedData) {
     return signMessage(this.walletProvider, typedData);
   }
-  static async connect(provider, walletProvider, cairoVersion, silentMode = false) {
+  static async connect(provider, walletProvider, cairoVersion, paymaster, silentMode = false) {
     const [accountAddress] = await requestAccounts(walletProvider, silentMode);
-    return new _WalletAccount(provider, walletProvider, accountAddress, cairoVersion);
+    return new _WalletAccount(provider, walletProvider, accountAddress, cairoVersion, paymaster);
   }
-  static async connectSilent(provider, walletProvider, cairoVersion) {
-    return _WalletAccount.connect(provider, walletProvider, cairoVersion, true);
+  static async connectSilent(provider, walletProvider, cairoVersion, paymaster) {
+    return _WalletAccount.connect(provider, walletProvider, cairoVersion, paymaster, true);
   }
   // TODO: MISSING ESTIMATES
 };
@@ -9863,6 +10690,7 @@ function units(amount, simbol = "fri") {
   LedgerSigner,
   LedgerSigner111,
   LedgerSigner221,
+  LedgerSigner231,
   LibraryError,
   Literal,
   LogLevelIndex,
@@ -9870,6 +10698,8 @@ function units(amount, simbol = "fri") {
   OutsideExecutionTypesV1,
   OutsideExecutionTypesV2,
   OutsideExecutionVersion,
+  PaymasterInterface,
+  PaymasterRpc,
   Provider,
   ProviderInterface,
   RPC,
@@ -9908,6 +10738,7 @@ function units(amount, simbol = "fri") {
   config,
   constants,
   contractClassResponseToLegacyCompiledContract,
+  defaultPaymaster,
   defaultProvider,
   ec,
   encode,
@@ -9922,21 +10753,29 @@ function units(amount, simbol = "fri") {
   getLedgerPathBuffer111,
   getLedgerPathBuffer221,
   hash,
+  isPendingBlock,
+  isPendingStateUpdate,
+  isPendingTransaction,
   isRPC08_FeeEstimate,
   isRPC08_ResourceBounds,
   isSierra,
+  isSupportedSpecVersion,
+  isV3Tx,
+  isVersion,
   json,
   logger,
   merkle,
   num,
   outsideExecution,
   parseCalldataField,
+  paymaster,
   provider,
   selector,
   shortString,
   src5,
   stark,
   starknetId,
+  toAnyPatchVersion,
   transaction,
   typedData,
   types,