Method transaction

lib/TransactionKit.ts:879–946

* Specifies or updates the transaction details to be sent. * * This method sets up a new transaction or updates the currently selected transaction with the provided parameters. It validates the input parameters and throws an error if any are invalid. If a transaction is already selected, it up

({
    chainId,
    to,
    value = '0',
    data = '0x',
  }: TransactionParams)

   * - The transaction context is stored in the instance until it is named or added to a batch.
   */
  transaction({
    chainId,
    to,
    value = '0',
    data = '0x',
  }: TransactionParams): ITransaction {
    if (chainId === undefined || chainId === null) {
      this.throwError(
        'transaction(): chainId is required. Please specify the target network explicitly.'
      );
    }

    if (typeof chainId !== 'number' || !Number.isInteger(chainId)) {
      this.throwError('transaction(): chainId must be a valid number.');
    }

    if (!to) {
      this.throwError('transaction(): to is required.');
    }

    if (!isAddress(to)) {
      this.throwError(`transaction(): '${to}' is not a valid address.`);
    }

    let parsedValue: bigint;
    try {
      parsedValue = typeof value === 'bigint' ? value : BigInt(value);
      if (parsedValue < BigInt(0)) {
        throw new Error();
      }
    } catch {
      this.throwError(
        'transaction(): value must be a non-negative bigint or numeric string.'
      );
    }

    // Start new transaction or update existing
    if (this.selectedTransactionName) {
      // Updating existing transaction
      this.workingTransaction = {
        ...this.workingTransaction,
        chainId,
        to,
        value,
        data,
      };
      log(
        'transaction(): Updated existing transaction',
        this.workingTransaction,
        this.debugMode
      );
    } else {
      // Creating new transaction
      this.workingTransaction = {
        chainId,
        to,
        value,
        data,