starknet 9.1.1 → 9.2.1

package/dist/index.mjs

@@ -78,12 +78,32 @@ import { PAYMASTER_API } from "@starknet-io/starknet-types-010";
 
 // src/types/api/rpc.ts
 var rpc_exports = {};
-__reExport(rpc_exports, starknet_types_09_star);
-import * as starknet_types_09_star from "@starknet-io/starknet-types-09";
+__reExport(rpc_exports, starknet_types_010_star);
+import * as starknet_types_010_star from "@starknet-io/starknet-types-010";
 
 // src/types/api/index.ts
 __reExport(api_exports, rpc_exports);
 
+// src/provider/types/spec.type.ts
+var { ETransactionVersion } = RPCSPEC09;
+var { ETransactionVersion2 } = RPCSPEC09;
+var { ETransactionVersion3 } = RPCSPEC09;
+var { EDataAvailabilityMode } = RPCSPEC010;
+var { EDAMode } = RPCSPEC010;
+function isRPC08Plus_ResourceBounds(entry) {
+  return "l1_data_gas" in entry;
+}
+function isRPC08Plus_ResourceBoundsBN(entry) {
+  return "l1_data_gas" in entry;
+}
+var { ETransactionStatus } = RPCSPEC010;
+var { ETransactionExecutionStatus } = RPCSPEC010;
+var { ETransactionType: TransactionType } = RPCSPEC09;
+var { EBlockStatus: BlockStatus } = RPCSPEC09;
+var { ETransactionFinalityStatus: TransactionFinalityStatus } = RPCSPEC09;
+var { ETransactionExecutionStatus: TransactionExecutionStatus } = RPCSPEC09;
+var { EBlockTag: BlockTag } = RPCSPEC09;
+
 // src/utils/encode.ts
 var encode_exports = {};
 __export(encode_exports, {
@@ -314,6 +334,22 @@ var DEFAULT_GLOBAL_CONFIG = {
     }
   },
   defaultTipType: "recommendedTip",
+  channelDefaults: {
+    options: {
+      headers: { "Content-Type": "application/json" },
+      blockIdentifier: BlockTag.LATEST,
+      retries: 200
+    },
+    methods: {
+      simulateTransaction: {
+        skipValidate: true,
+        skipFeeCharge: true
+      },
+      getEstimateFee: {
+        skipValidate: true
+      }
+    }
+  },
   fetch: void 0,
   websocket: void 0,
   buffer: void 0,
@@ -358,11 +394,51 @@ var Configuration = class _Configuration {
     }
     return _Configuration.instance;
   }
+  /**
+   * Get a nested value from an object using a dot-notation path
+   * @param obj - The object to traverse
+   * @param path - The dot-notation path (e.g., 'a.b.c')
+   * @returns The value at the path, or undefined if not found
+   */
+  getNestedValue(obj, path) {
+    const keys = path.split(".");
+    return keys.reduce((current, key) => {
+      if (current === null || current === void 0) {
+        return void 0;
+      }
+      return current[key];
+    }, obj);
+  }
+  /**
+   * Set a nested value in an object using a dot-notation path
+   * @param obj - The object to modify
+   * @param path - The dot-notation path (e.g., 'a.b.c')
+   * @param value - The value to set
+   */
+  setNestedValue(obj, path, value) {
+    const keys = path.split(".");
+    const lastKey = keys.pop();
+    const target = keys.reduce((current, key) => {
+      if (!(key in current) || typeof current[key] !== "object" || current[key] === null) {
+        current[key] = {};
+      }
+      return current[key];
+    }, obj);
+    target[lastKey] = value;
+  }
   get(key, defaultValue) {
+    if (key.includes(".")) {
+      const value = this.getNestedValue(this.config, key);
+      return value ?? defaultValue;
+    }
     return this.config[key] ?? defaultValue;
   }
   set(key, value) {
-    this.config[key] = value;
+    if (key.includes(".")) {
+      this.setNestedValue(this.config, key, value);
+    } else {
+      this.config[key] = value;
+    }
   }
   update(configData) {
     this.config = {
@@ -531,26 +607,6 @@ var EntryPointType = {
   CONSTRUCTOR: "CONSTRUCTOR"
 };
 
-// src/provider/types/spec.type.ts
-var { ETransactionVersion: ETransactionVersion2 } = RPCSPEC09;
-var { ETransactionVersion2: ETransactionVersion22 } = RPCSPEC09;
-var { ETransactionVersion3 } = RPCSPEC09;
-var { EDataAvailabilityMode } = RPCSPEC010;
-var { EDAMode } = RPCSPEC010;
-function isRPC08Plus_ResourceBounds(entry) {
-  return "l1_data_gas" in entry;
-}
-function isRPC08Plus_ResourceBoundsBN(entry) {
-  return "l1_data_gas" in entry;
-}
-var { ETransactionStatus } = RPCSPEC010;
-var { ETransactionExecutionStatus } = RPCSPEC010;
-var { ETransactionType: TransactionType } = RPCSPEC09;
-var { EBlockStatus: BlockStatus } = RPCSPEC09;
-var { ETransactionFinalityStatus: TransactionFinalityStatus } = RPCSPEC09;
-var { ETransactionExecutionStatus: TransactionExecutionStatus } = RPCSPEC09;
-var { EBlockTag: BlockTag } = RPCSPEC09;
-
 // src/types/calldata.ts
 var ValidateType = {
   DEPLOY: "DEPLOY",
@@ -5181,8 +5237,8 @@ function computeCompiledClassHashBlake(casm) {
 
 // src/utils/resolve.ts
 function isV3Tx(details) {
-  const version = details.version ? toHex(details.version) : ETransactionVersion2.V3;
-  return version === ETransactionVersion2.V3 || version === ETransactionVersion2.F3;
+  const version = details.version ? toHex(details.version) : ETransactionVersion.V3;
+  return version === ETransactionVersion.V3 || version === ETransactionVersion.F3;
 }
 function isVersion(expected, provided) {
   const expectedParts = expected.split(".");
@@ -5387,10 +5443,10 @@ function toTransactionVersion(defaultVersion, providedVersion) {
 function toFeeVersion(providedVersion) {
   if (!providedVersion) return void 0;
   const version = toHex(providedVersion);
-  if (version === ETransactionVersion2.V0) return ETransactionVersion2.F0;
-  if (version === ETransactionVersion2.V1) return ETransactionVersion2.F1;
-  if (version === ETransactionVersion2.V2) return ETransactionVersion2.F2;
-  if (version === ETransactionVersion2.V3) return ETransactionVersion2.F3;
+  if (version === ETransactionVersion.V0) return ETransactionVersion.F0;
+  if (version === ETransactionVersion.V1) return ETransactionVersion.F1;
+  if (version === ETransactionVersion.V2) return ETransactionVersion.F2;
+  if (version === ETransactionVersion.V3) return ETransactionVersion.F3;
   throw Error(`toFeeVersion: ${version} is not supported`);
 }
 function v3Details(details) {
@@ -5714,16 +5770,11 @@ var getExecuteCalldata = (calls, cairoVersion = "0") => {
 };
 function getVersionsByType(versionType) {
   return versionType === "fee" ? {
-    v3: ETransactionVersion2.F3
-  } : { v3: ETransactionVersion2.V3 };
+    v3: ETransactionVersion.F3
+  } : { v3: ETransactionVersion.V3 };
 }
 
 // src/channel/rpc_0_9_0.ts
-var defaultOptions = {
-  headers: { "Content-Type": "application/json" },
-  blockIdentifier: BlockTag.LATEST,
-  retries: 200
-};
 var RpcChannel = class {
   id = "RPC090";
   /**
@@ -5773,11 +5824,12 @@ var RpcChannel = class {
         this.channelSpecVersion
       );
     }
+    const channelDefaults = config.get("channelDefaults");
     this.baseFetch = baseFetch || config.get("fetch") || fetch_default;
-    this.blockIdentifier = blockIdentifier ?? defaultOptions.blockIdentifier;
+    this.blockIdentifier = blockIdentifier ?? channelDefaults.options.blockIdentifier;
     this.chainId = chainId;
-    this.headers = { ...defaultOptions.headers, ...headers };
-    this.retries = retries ?? defaultOptions.retries;
+    this.headers = { ...channelDefaults.options.headers, ...headers };
+    this.retries = retries ?? channelDefaults.options.retries;
     this.specVersion = specVersion;
     this.transactionRetryIntervalFallback = transactionRetryIntervalFallback;
     this.waitMode = waitMode ?? false;
@@ -5991,14 +6043,16 @@ var RpcChannel = class {
    * @param invocations AccountInvocations
    * @param simulateTransactionOptions blockIdentifier and flags to skip validation and fee charge<br/>
    * - blockIdentifier<br/>
-   * - skipValidate (default false)<br/>
+   * - skipValidate (default true)<br/>
    * - skipFeeCharge (default true)<br/>
    */
   simulateTransaction(invocations, simulateTransactionOptions = {}) {
+    const channelDefaults = config.get("channelDefaults");
+    const methodDefaults = channelDefaults.methods.simulateTransaction || {};
     const {
       blockIdentifier = this.blockIdentifier,
-      skipValidate = true,
-      skipFeeCharge = true
+      skipValidate = methodDefaults.skipValidate,
+      skipFeeCharge = methodDefaults.skipFeeCharge
     } = simulateTransactionOptions;
     const block_id = new Block(blockIdentifier).identifier;
     const simulationFlags = [];
@@ -6158,7 +6212,10 @@ var RpcChannel = class {
       contract_address
     });
   }
-  async getEstimateFee(invocations, { blockIdentifier = this.blockIdentifier, skipValidate = true } = {}) {
+  async getEstimateFee(invocations, options = {}) {
+    const channelDefaults = config.get("channelDefaults");
+    const methodDefaults = channelDefaults.methods.getEstimateFee || {};
+    const { blockIdentifier = this.blockIdentifier, skipValidate = methodDefaults.skipValidate } = options;
     const block_id = new Block(blockIdentifier).identifier;
     const flags = {
       simulation_flags: skipValidate ? [RPCSPEC09.ESimulationFlag.SKIP_VALIDATE] : []
@@ -6316,11 +6373,6 @@ var rpc_0_10_0_exports = {};
 __export(rpc_0_10_0_exports, {
   RpcChannel: () => RpcChannel2
 });
-var defaultOptions2 = {
-  headers: { "Content-Type": "application/json" },
-  blockIdentifier: BlockTag.LATEST,
-  retries: 200
-};
 var RpcChannel2 = class {
   id = "RPC0.10.0";
   /**
@@ -6370,11 +6422,12 @@ var RpcChannel2 = class {
         this.channelSpecVersion
       );
     }
+    const channelDefaults = config.get("channelDefaults");
     this.baseFetch = baseFetch || config.get("fetch") || fetch_default;
-    this.blockIdentifier = blockIdentifier ?? defaultOptions2.blockIdentifier;
+    this.blockIdentifier = blockIdentifier ?? channelDefaults.options.blockIdentifier;
     this.chainId = chainId;
-    this.headers = { ...defaultOptions2.headers, ...headers };
-    this.retries = retries ?? defaultOptions2.retries;
+    this.headers = { ...channelDefaults.options.headers, ...headers };
+    this.retries = retries ?? channelDefaults.options.retries;
     this.specVersion = specVersion;
     this.transactionRetryIntervalFallback = transactionRetryIntervalFallback;
     this.waitMode = waitMode ?? false;
@@ -6588,14 +6641,16 @@ var RpcChannel2 = class {
    * @param invocations AccountInvocations
    * @param simulateTransactionOptions blockIdentifier and flags to skip validation and fee charge<br/>
    * - blockIdentifier<br/>
-   * - skipValidate (default false)<br/>
+   * - skipValidate (default true)<br/>
    * - skipFeeCharge (default true)<br/>
    */
   simulateTransaction(invocations, simulateTransactionOptions = {}) {
+    const channelDefaults = config.get("channelDefaults");
+    const methodDefaults = channelDefaults.methods.simulateTransaction || {};
     const {
       blockIdentifier = this.blockIdentifier,
-      skipValidate = true,
-      skipFeeCharge = true
+      skipValidate = methodDefaults.skipValidate,
+      skipFeeCharge = methodDefaults.skipFeeCharge
     } = simulateTransactionOptions;
     const block_id = new Block(blockIdentifier).identifier;
     const simulationFlags = [];
@@ -6755,7 +6810,10 @@ var RpcChannel2 = class {
       contract_address
     });
   }
-  async getEstimateFee(invocations, { blockIdentifier = this.blockIdentifier, skipValidate = true } = {}) {
+  async getEstimateFee(invocations, options = {}) {
+    const channelDefaults = config.get("channelDefaults");
+    const methodDefaults = channelDefaults.methods.getEstimateFee || {};
+    const { blockIdentifier = this.blockIdentifier, skipValidate = methodDefaults.skipValidate } = options;
     const block_id = new Block(blockIdentifier).identifier;
     const flags = {
       simulation_flags: skipValidate ? [RPCSPEC010.ESimulationFlag.SKIP_VALIDATE] : []
@@ -7044,7 +7102,7 @@ var Subscription = class {
   }
 };
 
-// src/channel/ws/ws_0_9.ts
+// src/channel/ws/ws_0_10.ts
 var WebSocketChannel = class {
   /**
    * The URL of the WebSocket RPC Node.
@@ -10712,7 +10770,7 @@ var convertEXECUTION_PARAMETERS = (parameters) => ({
   feeMode: convertFEE_MODE(parameters.fee_mode),
   timeBounds: convertTIME_BOUNDS(parameters.time_bounds)
 });
-var defaultOptions3 = {
+var defaultOptions = {
   headers: { "Content-Type": "application/json" }
 };
 var PaymasterRpc = class _PaymasterRpc {
@@ -10723,14 +10781,14 @@ var PaymasterRpc = class _PaymasterRpc {
   constructor(options) {
     if (options instanceof _PaymasterRpc) {
       this.nodeUrl = options.nodeUrl;
-      this.headers = { ...defaultOptions3.headers, ...options.headers };
+      this.headers = { ...defaultOptions.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.headers = { ...defaultOptions.headers, ...options.headers };
       this.baseFetch = options.baseFetch ?? fetch_default;
       this.requestId = 0;
       return;
@@ -10744,7 +10802,7 @@ var PaymasterRpc = class _PaymasterRpc {
       this.nodeUrl = getDefaultPaymasterNodeUrl(void 0, options?.default);
     }
     this.baseFetch = baseFetch ?? fetch_default;
-    this.headers = { ...defaultOptions3.headers, ...headers };
+    this.headers = { ...defaultOptions.headers, ...headers };
     this.requestId = 0;
   }
   fetch(method, params, id = 0) {
@@ -12136,7 +12194,10 @@ var WalletAccountV5 = class _WalletAccountV5 extends Account {
 // src/utils/events/index.ts
 var events_exports = {};
 __export(events_exports, {
+  addGetByPathMethod: () => addGetByPathMethod,
+  filterEventsByAddress: () => filterEventsByAddress,
   getAbiEvents: () => getAbiEvents,
+  getEmittedEvents: () => getEmittedEvents,
   isAbiEvent: () => isAbiEvent,
   parseEvents: () => parseEvents
 });
@@ -12210,52 +12271,79 @@ function mergeAbiEvents(target, source) {
   return output;
 }
 function parseEvents(providerReceivedEvents, abiEvents, abiStructs, abiEnums, parser) {
-  const ret = providerReceivedEvents.flat().reduce((acc, recEvent) => {
-    const currentEvent = JSON.parse(JSON.stringify(recEvent));
-    let abiEvent = abiEvents[currentEvent.keys.shift() ?? 0];
+  const ret = providerReceivedEvents.reduce((acc, recEvent) => {
+    const eventKeys = [...recEvent.keys];
+    const eventData = [...recEvent.data];
+    let abiEvent = abiEvents[eventKeys.shift() ?? 0];
     if (!abiEvent) {
       return acc;
     }
     while (!abiEvent.name) {
-      const hashName = currentEvent.keys.shift();
+      const hashName = eventKeys.shift();
       assert(!!hashName, 'Not enough data in "keys" property of this event.');
       abiEvent = abiEvent[hashName];
     }
-    const parsedEvent = {};
-    parsedEvent[abiEvent.name] = {};
-    const keysIter = currentEvent.keys[Symbol.iterator]();
-    const dataIter = currentEvent.data[Symbol.iterator]();
+    const { from_address: _from, keys: _keys, data: _data, ...eventMetadata } = recEvent;
+    const parsedEvent = eventMetadata;
+    const eventName = abiEvent.name;
+    parsedEvent[eventName] = {};
+    const keysIter = eventKeys[Symbol.iterator]();
+    const dataIter = eventData[Symbol.iterator]();
     const abiEventKeys = abiEvent.members?.filter((it) => it.kind === "key") || abiEvent.keys;
     const abiEventData = abiEvent.members?.filter((it) => it.kind === "data") || abiEvent.data;
+    const parsedEventData = parsedEvent[eventName];
     abiEventKeys.forEach((key) => {
-      parsedEvent[abiEvent.name][key.name] = responseParser({
+      parsedEventData[key.name] = responseParser({
         responseIterator: keysIter,
         output: key,
         structs: abiStructs,
         enums: abiEnums,
         parser,
-        parsedResult: parsedEvent[abiEvent.name]
+        parsedResult: parsedEventData
       });
     });
     abiEventData.forEach((data) => {
-      parsedEvent[abiEvent.name][data.name] = responseParser({
+      parsedEventData[data.name] = responseParser({
         responseIterator: dataIter,
         output: data,
         structs: abiStructs,
         enums: abiEnums,
         parser,
-        parsedResult: parsedEvent[abiEvent.name]
+        parsedResult: parsedEventData
       });
     });
-    if ("block_hash" in currentEvent) parsedEvent.block_hash = currentEvent.block_hash;
-    if ("block_number" in currentEvent) parsedEvent.block_number = currentEvent.block_number;
-    if ("transaction_hash" in currentEvent)
-      parsedEvent.transaction_hash = currentEvent.transaction_hash;
     acc.push(parsedEvent);
     return acc;
   }, []);
   return ret;
 }
+function addGetByPathMethod(parsedEvents) {
+  Object.defineProperty(parsedEvents, "getByPath", {
+    value: (path) => {
+      const event = parsedEvents.find((ev) => Object.keys(ev).some((key) => key.includes(path)));
+      const eventKey = Object.keys(event || {}).find((key) => key.includes(path));
+      return eventKey && event ? event[eventKey] : null;
+    },
+    writable: false,
+    enumerable: false,
+    configurable: false
+  });
+  return parsedEvents;
+}
+function getEmittedEvents(receipt, contractAddress) {
+  if (!receipt.events) return [];
+  const eventsToEnrich = contractAddress ? filterEventsByAddress(receipt.events, contractAddress) : receipt.events;
+  return eventsToEnrich.map((event) => ({
+    ...event,
+    transaction_hash: receipt.transaction_hash,
+    block_hash: receipt.block_hash,
+    block_number: receipt.block_number
+  }));
+}
+function filterEventsByAddress(events, contractAddress) {
+  if (!events) return [];
+  return events.filter((event) => toHex(event.from_address) === toHex(contractAddress));
+}
 
 // src/contract/default.ts
 function buildCall(contract, functionAbi) {
@@ -12516,45 +12604,19 @@ var Contract = class _Contract {
       calldata
     };
   }
-  // TODO: Demistify what is going on here ???
-  // TODO: receipt status filtering test and fix this do not look right
   parseEvents(receipt) {
-    let parsed = [];
-    receipt.match({
-      SUCCEEDED: (txR) => {
-        const emittedEvents = txR.events?.map((event) => {
-          return {
-            // TODO: this do not check that block is production and block_hash and block_number actually exists
-            // TODO: second issue is that ts do not complains about it
-            block_hash: txR.block_hash,
-            block_number: txR.block_number,
-            transaction_hash: txR.transaction_hash,
-            ...event
-          };
-        }).filter((event) => toHex(event.from_address) === toHex(this.address), []) || [];
-        parsed = parseEvents(
-          emittedEvents,
-          this.events,
-          this.structs,
-          CallData.getAbiEnum(this.abi),
-          this.callData.parser
-        );
-      },
-      _: () => {
-        throw Error("This transaction was not successful.");
-      }
-    });
-    Object.defineProperty(parsed, "getByPath", {
-      value: (path) => {
-        const event = parsed.find((ev) => Object.keys(ev).some((key) => key.includes(path)));
-        const eventKey = Object.keys(event || {}).find((key) => key.includes(path));
-        return eventKey && event ? event[eventKey] : null;
-      },
-      writable: false,
-      enumerable: false,
-      configurable: false
-    });
-    return parsed;
+    if (!receipt.isSuccess()) {
+      throw Error("This transaction was not successful.");
+    }
+    return addGetByPathMethod(
+      parseEvents(
+        getEmittedEvents(receipt.value, this.address),
+        this.events,
+        this.structs,
+        CallData.getAbiEnum(this.abi),
+        this.callData.parser
+      )
+    );
   }
   isCairo1() {
     return cairo_exports.isCairo1Abi(this.abi);
@@ -12770,8 +12832,8 @@ export {
   ETH_ADDRESS,
   ETransactionExecutionStatus,
   ETransactionStatus,
-  ETransactionVersion2 as ETransactionVersion,
-  ETransactionVersion22 as ETransactionVersion2,
+  ETransactionVersion,
+  ETransactionVersion2,
   ETransactionVersion3,
   EntryPointType,
   EthSigner,