Class DfnsWallet

Readonlyprovider

authorize

• authorize(authorization: AuthorizationRequest): Promise<Authorization>

  Signs an %%authorization%% to be used in [[link-eip-7702]] transactions.

  Parameters

  • authorization: AuthorizationRequest

  Returns Promise<Authorization>

call

• call(tx: TransactionRequest): Promise<string>

  Evaluates the //tx// by running it against the current Blockchain state. This cannot change state and has no cost in ether, as it is effectively simulating execution.

  This can be used to have the Blockchain perform computations based on its state (e.g. running a Contract's getters) or to simulate the effect of a transaction before actually performing an operation.

  Parameters

  • tx: TransactionRequest

  Returns Promise<string>

estimateGas

• estimateGas(tx: TransactionRequest): Promise<bigint>

  Estimates the required gas required to execute //tx// on the Blockchain. This will be the expected amount a transaction will require as its gasLimit to successfully run all the necessary computations and store the needed state that the transaction intends.

  Keep in mind that this is best efforts, since the state of the Blockchain is in flux, which could affect transaction gas requirements.

  Parameters

  • tx: TransactionRequest

  Returns Promise<bigint>

  Throws

  UNPREDICTABLE_GAS_LIMIT A transaction that is believed by the node to likely fail will throw an error during gas estimation. This could indicate that it will actually fail or that the circumstances are simply too complex for the node to take into account. In these cases, a manually determined gasLimit will need to be made.

getNonce

• getNonce(blockTag?: BlockTag): Promise<number>

  Gets the next nonce required for this Signer to send a transaction.

  Parameters

  • OptionalblockTag: BlockTag

    The blocktag to base the transaction count on, keep in mind many nodes do not honour this value and silently ignore it [default: "latest"]

  Returns Promise<number>

populateAuthorization

• populateAuthorization(
      _auth: AuthorizationRequest,
  ): Promise<AuthorizationRequest>

  Prepares an [[AuthorizationRequest]] for authorization by populating any missing properties:

  • resolves address (if an Addressable or ENS name)
  • populates nonce via signer.getNonce("pending")
  • populates chainId via signer.provider.getNetwork()

  Parameters

  • _auth: AuthorizationRequest

  Returns Promise<AuthorizationRequest>

populateCall

• populateCall(tx: TransactionRequest): Promise<TransactionLike<string>>

  Prepares a TransactionRequest for calling:

  • resolves to and from addresses
  • if from is specified , check that it matches this Signer

  Parameters

  • tx: TransactionRequest

    The call to prepare

  Returns Promise<TransactionLike<string>>

populateTransaction

• populateTransaction(tx: TransactionRequest): Promise<TransactionLike<string>>

  Prepares a TransactionRequest for sending to the network by populating any missing properties:

  • resolves to and from addresses
  • if from is specified , check that it matches this Signer
  • populates nonce via signer.getNonce("pending")
  • populates gasLimit via signer.estimateGas(tx)
  • populates chainId via signer.provider.getNetwork()
  • populates type and relevant fee data for that type (gasPrice for legacy transactions, maxFeePerGas for EIP-1559, etc)

  Parameters

  • tx: TransactionRequest

    The call to prepare

  Returns Promise<TransactionLike<string>>

  Note

  Some Signer implementations may skip populating properties that are populated downstream; for example JsonRpcSigner defers to the node to populate the nonce and fee data.

resolveName

• resolveName(name: string): Promise<null | string>

  Resolves an ENS Name to an address.

  Parameters

  • name: string

  Returns Promise<null | string>

sendTransaction

• sendTransaction(tx: TransactionRequest): Promise<TransactionResponse>

  Sends %%tx%% to the Network. The signer.populateTransaction(tx) is called first to ensure all necessary properties for the transaction to be valid have been popualted first.

  Parameters

  • tx: TransactionRequest

  Returns Promise<TransactionResponse>