starknet 10.2.0 → 10.3.1

package/dist/index.mjs

@@ -1509,8 +1509,11 @@ var CairoUint512 = class _CairoUint512 {
 var isLen = (name) => /_len$/.test(name);
 var isTypeFelt = (type) => type === "felt" || type === "core::felt252";
 var isTypeArray = (type) => /\*/.test(type) || type.startsWith("core::array::Array::") || type.startsWith("core::array::Span::");
-var isTypeTuple = (type) => /^\(.*\)$/i.test(type);
-var isTypeNamedTuple = (type) => /\(.*\)/i.test(type) && type.includes(":");
+var isTypeTuple = (type) => type.startsWith("(") && type.endsWith(")");
+var isTypeNamedTuple = (type) => {
+  const start = type.indexOf("(");
+  return start !== -1 && type.indexOf(")", start + 1) !== -1 && type.includes(":");
+};
 var isTypeStruct = (type, structs) => type in structs;
 var isTypeEnum = (type, enums) => type in enums;
 var isTypeOption = (type) => type.startsWith("core::option::Option::");
@@ -1526,7 +1529,7 @@ var isTypeU96 = (type) => type === "core::internal::bounded_int::BoundedInt::<0,
 var isTypeSecp256k1Point = (type) => type === Literal.Secp256k1Point;
 var isCairo1Type = (type) => type.includes("::");
 var getArrayType = (type) => {
-  return isCairo1Type(type) ? type.substring(type.indexOf("<") + 1, type.lastIndexOf(">")) : type.replace("*", "");
+  return isCairo1Type(type) ? type.substring(type.indexOf("<") + 1, type.lastIndexOf(">")) : type.replaceAll("*", "");
 };
 function isCairo1Abi(abi) {
   const { cairo } = getAbiContractVersion(abi);
@@ -3329,6 +3332,18 @@ var CairoFixedArray = class _CairoFixedArray {
    * Cairo fixed array type.
    */
   arrayType;
+  static parseFixedArrayType(type) {
+    if (!type.startsWith("[") || !type.endsWith("]")) {
+      return void 0;
+    }
+    const separator = type.lastIndexOf("; ");
+    const itemType = type.slice(1, separator);
+    const size = type.slice(separator + 2, -1);
+    if (separator <= 1 || size.length === 0 || ![...size].every((char) => char >= "0" && char <= "9")) {
+      return void 0;
+    }
+    return { itemType, size };
+  }
   /**
    * Create an instance representing a Cairo fixed Array.
    * @param {any[]} content JS array representing a Cairo fixed array.
@@ -3372,10 +3387,10 @@ var CairoFixedArray = class _CairoFixedArray {
    * ```
    */
   static getFixedArraySize(type) {
-    const matchArray = type.match(/(?<=; )\d+(?=\])/);
-    if (matchArray === null)
+    const fixedArrayType = _CairoFixedArray.parseFixedArrayType(type);
+    if (!fixedArrayType)
       throw new Error(`ABI type ${type} do not includes a valid number after ';' character.`);
-    return Number(matchArray[0]);
+    return Number(fixedArrayType.size);
   }
   /**
    * Retrieves the Cairo fixed array size from the CairoFixedArray instance.
@@ -3401,10 +3416,9 @@ var CairoFixedArray = class _CairoFixedArray {
    * ```
    */
   static getFixedArrayType = (type) => {
-    const matchArray = type.match(/(?<=\[).+(?=;)/);
-    if (matchArray === null)
-      throw new Error(`ABI type ${type} do not includes a valid type of data.`);
-    return matchArray[0];
+    const fixedArrayType = _CairoFixedArray.parseFixedArrayType(type);
+    if (!fixedArrayType) throw new Error(`ABI type ${type} do not includes a valid type of data.`);
+    return fixedArrayType.itemType;
   };
   /**
    * Retrieve the Cairo content type of the Cairo fixed array.
@@ -3462,7 +3476,7 @@ var CairoFixedArray = class _CairoFixedArray {
    * // result = true
    */
   static isTypeFixedArray(type) {
-    return /^\[.*;\s.*\]$/.test(type) && /(?<=\[).+(?=;)/.test(type) && /(?<=; )\d+(?=\])/.test(type);
+    return _CairoFixedArray.parseFixedArrayType(type) !== void 0;
   }
 };
 
@@ -4130,7 +4144,7 @@ function responseParser({
           parsedDataArr.push(
             parseResponseValue(
               responseIterator,
-              { name, type: output.type.replace("*", "") },
+              { name, type: output.type.replaceAll("*", "") },
               parser,
               structs,
               enums
@@ -6443,6 +6457,12 @@ var RpcChannel = class {
     });
     return this.waitMode ? this.waitForTransaction((await promise).transaction_hash) : promise;
   }
+  async invokeSignedTx(transaction) {
+    const promise = this.fetchEndpoint("starknet_addInvokeTransaction", {
+      invoke_transaction: transaction
+    });
+    return this.waitMode ? this.waitForTransaction((await promise).transaction_hash) : promise;
+  }
   async declare(declareTransaction, details) {
     const transaction = await this.buildTransaction(
       {
@@ -7052,6 +7072,12 @@ var RpcChannel2 = class {
     });
     return this.waitMode ? this.waitForTransaction((await promise).transaction_hash) : promise;
   }
+  async invokeSignedTx(transaction) {
+    const promise = this.fetchEndpoint("starknet_addInvokeTransaction", {
+      invoke_transaction: transaction
+    });
+    return this.waitMode ? this.waitForTransaction((await promise).transaction_hash) : promise;
+  }
   async declare(declareTransaction, details) {
     const transaction = await this.buildTransaction(
       {
@@ -8996,7 +9022,19 @@ function dynamicCallData(hardcoded, reference = void 0, arrayReference = void 0)
   });
 }
 function isStarkDomain(domain) {
-  return /^(?:[a-z0-9-]{1,48}(?:[a-z0-9-]{1,48}[a-z0-9-])?\.)*[a-z0-9-]{1,48}\.stark$/.test(domain);
+  const starkSuffix = ".stark";
+  if (!domain.endsWith(starkSuffix)) {
+    return false;
+  }
+  const name = domain.slice(0, -starkSuffix.length);
+  if (name.length === 0) {
+    return false;
+  }
+  return name.split(".").every((label) => {
+    return label.length > 0 && label.length <= 48 && [...label].every((char) => {
+      return char >= "a" && char <= "z" || char >= "0" && char <= "9" || char === "-";
+    });
+  });
 }
 
 // src/plugins/starknet-id/index.ts
@@ -9742,6 +9780,34 @@ var RpcProvider = class {
   async invokeFunction(functionInvocation, details) {
     return this.channel.invoke(functionInvocation, details);
   }
+  /**
+   * Submit a pre-signed INVOKE_TXN_V3 transaction to the network.
+   *
+   * Broadcasts a transaction previously built and signed by `Account.getSignedTransaction()`.
+   * Fees are already included in the signed transaction and will not be re-estimated.
+   *
+   * @param transaction - A fully signed `RPC.INVOKE_TXN_V3` object, as returned by `Account.getSignedTransaction()`
+   *
+   * @returns The transaction hash if `waitMode` is disabled (default), or the transaction receipt if `waitMode` is enabled.
+   *
+   * @remarks
+   * - The transaction must be signed before calling this method ; use `Account.getSignedTransaction()` to produce it.
+   * - Resubmitting the same signed transaction (same nonce) will be rejected by the network.
+   * - If `waitMode` is enabled on the provider, this method waits for the transaction to be included in a block before returning.
+   *
+   * @example
+   * ```typescript
+   * const signedTx = await account.getSignedTransaction([
+   *   { contractAddress: erc20Address, entrypoint: 'transfer', calldata: [recipient, amount, 0] }
+   * ]);
+   * // inspect or store signedTx, then submit when ready:
+   * const { transaction_hash } = await provider.invokeSignedTx(signedTx);
+   * await provider.waitForTransaction(transaction_hash);
+   * ```
+   */
+  async invokeSignedTx(transaction) {
+    return this.channel.invokeSignedTx(transaction);
+  }
   async declareContract(transaction, details) {
     return this.channel.declare(transaction, details);
   }
@@ -11624,7 +11690,12 @@ var Account = class {
       returnInitialReads
     });
   }
-  async execute(transactions, transactionsDetail = {}) {
+  /**
+   * Shared preparation logic for execute() and buildExecute().
+   * Runs hooks, estimates fees, and builds accountInvocations.
+   * @private
+   */
+  async prepareInvoke(transactions, transactionsDetail = {}) {
     const hookResult = this.accountPluginManager.runAccountHook("beforeExecute", {
       calls: transactions,
       details: transactionsDetail
@@ -11649,7 +11720,15 @@ var Account = class {
         skipValidate: false
       }
     );
-    const invocation = accountInvocations[0];
+    return {
+      invocation: accountInvocations[0],
+      hookedTransactions,
+      hookedDetails,
+      detailsWithTip
+    };
+  }
+  async execute(transactions, transactionsDetail = {}) {
+    const { invocation, hookedTransactions, hookedDetails, detailsWithTip } = await this.prepareInvoke(transactions, transactionsDetail);
     const result = await this.provider.invokeFunction(
       {
         contractAddress: invocation.contractAddress,
@@ -11671,6 +11750,51 @@ var Account = class {
     });
     return result;
   }
+  /**
+   * Build a signed INVOKE_TXN_V3 transaction without submitting it to the network.
+   *
+   * Produces a fully signed transaction object that can be inspected, stored,
+   * or submitted later via `provider.channel.sendTransaction()`.
+   * Main usage is to send a virtual transaction to a proof server.
+   * Fees are estimated automatically if not provided.
+   *
+   * @param transactions - Single call or array of calls to include in the transaction
+   * @param transactionsDetail - Transaction execution options
+   * @returns A fully signed `RPC.INVOKE_TXN_V3` object, ready to broadcast
+   *
+   * @remarks
+   * - Unlike `execute()`, this method does **not** submit the transaction ; the account nonce is unchanged after the call.
+   * - The `afterExecute` plugin hook is intentionally **not** triggered.
+   * - The returned object can be broadcast with `provider.channel.sendTransaction()`.
+   *
+   * @example
+   * ```typescript
+   * const signedTx = await account.getSignedTransaction(
+   *   { contractAddress: erc20Address, entrypoint: 'transfer', calldata: [recipient, amount, 0] }
+   * );
+   * ```
+   */
+  async getSignedTransaction(transactions, transactionsDetail = {}) {
+    const { invocation, hookedDetails, detailsWithTip } = await this.prepareInvoke(
+      transactions,
+      transactionsDetail
+    );
+    return this.provider.channel.buildTransaction(
+      {
+        type: api_exports.ETransactionType.INVOKE,
+        contractAddress: invocation.contractAddress,
+        calldata: invocation.calldata,
+        signature: invocation.signature,
+        ...hookedDetails.proofFacts && { proofFacts: hookedDetails.proofFacts },
+        ...hookedDetails.proof && { proof: hookedDetails.proof },
+        ...v3Details(detailsWithTip),
+        resourceBounds: invocation.resourceBounds,
+        nonce: invocation.nonce,
+        version: invocation.version
+      },
+      "transaction"
+    );
+  }
   /**
    * First check if contract is already declared, if not declare it
    * If contract already declared returned transaction_hash is ''.