hardhat/src/internal/builtin-plugins/network-manager/request-handlers/handlers/accounts/fixed-sender-handler.ts

Hardhat is an extensible developer tool that helps smart contract developers increase productivity by reliably bringing together the tools they want.

import type { EthereumProvider } from "../../../../../../types/providers.js";

import { SenderHandler } from "./sender.js";

/**
 * This class provides a fixed sender address for transactions.
 * It overrides the getSender method of the base class to always return the sender address specified during instantiation,
 * ensuring that all JSON-RPC requests use this fixed sender.
 */
export class FixedSenderHandler extends SenderHandler {
  readonly #sender: string;

  constructor(provider: EthereumProvider, sender: string) {
    super(provider);
    this.#sender = sender;
  }

  protected async getSender(): Promise<string | undefined> {
    return this.#sender;
  }
}