viem 0.0.0-w-20230822145918 → 0.0.0-w-20230829165118

package/src/clients/decorators/public.ts

@@ -53,11 +53,21 @@ import {
   type EstimateContractGasReturnType,
   estimateContractGas,
 } from '../../actions/public/estimateContractGas.js'
+import {
+  type EstimateFeesPerGasParameters,
+  type EstimateFeesPerGasReturnType,
+  estimateFeesPerGas,
+} from '../../actions/public/estimateFeesPerGas.js'
 import {
   type EstimateGasParameters,
   type EstimateGasReturnType,
   estimateGas,
 } from '../../actions/public/estimateGas.js'
+import {
+  type EstimateMaxPriorityFeePerGasParameters,
+  type EstimateMaxPriorityFeePerGasReturnType,
+  estimateMaxPriorityFeePerGas,
+} from '../../actions/public/estimateMaxPriorityFeePerGas.js'
 import {
   type GetBalanceParameters,
   type GetBalanceReturnType,
@@ -196,6 +206,16 @@ import {
   type WatchPendingTransactionsReturnType,
   watchPendingTransactions,
 } from '../../actions/public/watchPendingTransactions.js'
+import {
+  type PrepareTransactionRequestParameters,
+  type PrepareTransactionRequestReturnType,
+  prepareTransactionRequest,
+} from '../../actions/wallet/prepareTransactionRequest.js'
+import {
+  type SendRawTransactionParameters,
+  type SendRawTransactionReturnType,
+  sendRawTransaction,
+} from '../../actions/wallet/sendRawTransaction.js'
 import type { Account } from '../../types/account.js'
 import type { BlockNumber, BlockTag } from '../../types/block.js'
 import type { Chain } from '../../types/chain.js'
@@ -205,6 +225,7 @@ import type {
   MaybeAbiEventName,
   MaybeExtractEventArgsFromAbi,
 } from '../../types/contract.js'
+import type { FeeValuesType } from '../../types/fee.js'
 import type { FilterType } from '../../types/filter.js'
 import type { Client } from '../createClient.js'
 import type { Transport } from '../transports/createTransport.js'
@@ -776,6 +797,33 @@ export type PublicActions<
   getFeeHistory: (
     args: GetFeeHistoryParameters,
   ) => Promise<GetFeeHistoryReturnType>
+  /**
+   * Returns an estimate for the fees per gas for a transaction to be included
+   * in the next block.
+   *
+   * - Docs: https://viem.sh/docs/actions/public/estimateFeesPerGas.html
+   *
+   * @param client - Client to use
+   * @param parameters - {@link EstimateFeesPerGasParameters}
+   * @returns An estimate (in wei) for the fees per gas. {@link EstimateFeesPerGasReturnType}
+   *
+   * @example
+   * import { createPublicClient, http } from 'viem'
+   * import { mainnet } from 'viem/chains'
+   *
+   * const client = createPublicClient({
+   *   chain: mainnet,
+   *   transport: http(),
+   * })
+   * const maxPriorityFeePerGas = await client.estimateFeesPerGas()
+   * // { maxFeePerGas: ..., maxPriorityFeePerGas: ... }
+   */
+  estimateFeesPerGas: <
+    TChainOverride extends Chain | undefined,
+    TType extends FeeValuesType = 'eip1559',
+  >(
+    args?: EstimateFeesPerGasParameters<TChain, TChainOverride, TType>,
+  ) => Promise<EstimateFeesPerGasReturnType>
   /**
    * Returns a list of logs or hashes based on a [Filter](/docs/glossary/terms#filter) since the last time it was called.
    *
@@ -982,6 +1030,29 @@ export type PublicActions<
   ) => Promise<
     GetLogsReturnType<TAbiEvent, TAbiEvents, TStrict, TFromBlock, TToBlock>
   >
+  /**
+   * Returns an estimate for the max priority fee per gas (in wei) for a transaction
+   * to be included in the next block.
+   *
+   * - Docs: https://viem.sh/docs/actions/public/estimateMaxPriorityFeePerGas.html
+   *
+   * @param client - Client to use
+   * @returns An estimate (in wei) for the max priority fee per gas. {@link EstimateMaxPriorityFeePerGasReturnType}
+   *
+   * @example
+   * import { createPublicClient, http } from 'viem'
+   * import { mainnet } from 'viem/chains'
+   *
+   * const client = createPublicClient({
+   *   chain: mainnet,
+   *   transport: http(),
+   * })
+   * const maxPriorityFeePerGas = await client.estimateMaxPriorityFeePerGas()
+   * // 10000000n
+   */
+  estimateMaxPriorityFeePerGas: <TChainOverride extends Chain | undefined,>(
+    args?: EstimateMaxPriorityFeePerGasParameters<TChain, TChainOverride>,
+  ) => Promise<EstimateMaxPriorityFeePerGasReturnType>
   /**
    * Returns the value from a storage slot at a given address.
    *
@@ -1150,6 +1221,47 @@ export type PublicActions<
   >(
     args: MulticallParameters<contracts, allowFailure>,
   ) => Promise<MulticallReturnType<contracts, allowFailure>>
+  /**
+   * Prepares a transaction request for signing.
+   *
+   * - Docs: https://viem.sh/docs/actions/wallet/prepareTransactionRequest.html
+   *
+   * @param args - {@link PrepareTransactionRequestParameters}
+   * @returns The transaction request. {@link PrepareTransactionRequestReturnType}
+   *
+   * @example
+   * import { createWalletClient, custom } from 'viem'
+   * import { mainnet } from 'viem/chains'
+   *
+   * const client = createWalletClient({
+   *   chain: mainnet,
+   *   transport: custom(window.ethereum),
+   * })
+   * const request = await client.prepareTransactionRequest({
+   *   account: '0xA0Cf798816D4b9b9866b5330EEa46a18382f251e',
+   *   to: '0x0000000000000000000000000000000000000000',
+   *   value: 1n,
+   * })
+   *
+   * @example
+   * // Account Hoisting
+   * import { createWalletClient, http } from 'viem'
+   * import { privateKeyToAccount } from 'viem/accounts'
+   * import { mainnet } from 'viem/chains'
+   *
+   * const client = createWalletClient({
+   *   account: privateKeyToAccount('0x…'),
+   *   chain: mainnet,
+   *   transport: custom(window.ethereum),
+   * })
+   * const request = await client.prepareTransactionRequest({
+   *   to: '0x0000000000000000000000000000000000000000',
+   *   value: 1n,
+   * })
+   */
+  prepareTransactionRequest: <TChainOverride extends Chain | undefined,>(
+    args: PrepareTransactionRequestParameters<TChain, TAccount, TChainOverride>,
+  ) => Promise<PrepareTransactionRequestReturnType>
   /**
    * Calls a read-only function on a contract, and returns the response.
    *
@@ -1188,6 +1300,33 @@ export type PublicActions<
   >(
     args: ReadContractParameters<abi, functionName, args>,
   ) => Promise<ReadContractReturnType<abi, functionName, args>>
+  /**
+   * Sends a **signed** transaction to the network
+   *
+   * - Docs: https://viem.sh/docs/actions/wallet/sendRawTransaction.html
+   * - JSON-RPC Method: [`eth_sendRawTransaction`](https://ethereum.github.io/execution-apis/api-documentation/)
+   *
+   * @param client - Client to use
+   * @param parameters - {@link SendRawTransactionParameters}
+   * @returns The transaction hash. {@link SendRawTransactionReturnType}
+   *
+   * @example
+   * import { createWalletClient, custom } from 'viem'
+   * import { mainnet } from 'viem/chains'
+   * import { sendRawTransaction } from 'viem/wallet'
+   *
+   * const client = createWalletClient({
+   *   chain: mainnet,
+   *   transport: custom(window.ethereum),
+   * })
+   *
+   * const hash = await client.sendRawTransaction({
+   *   serializedTransaction: '0x02f850018203118080825208808080c080a04012522854168b27e5dc3d5839bab5e6b39e1a0ffd343901ce1622e3d64b48f1a04e00902ae0502c4728cbf12156290df99c3ed7de85b1dbfe20b5c36931733a33'
+   * })
+   */
+  sendRawTransaction: (
+    args: SendRawTransactionParameters,
+  ) => Promise<SendRawTransactionReturnType>
   /**
    * Simulates/validates a contract interaction. This is useful for retrieving **return data** and **revert reasons** of contract write functions.
    *
@@ -1511,10 +1650,13 @@ export function publicActions<
     getEnsResolver: (args) => getEnsResolver(client, args),
     getEnsText: (args) => getEnsText(client, args),
     getFeeHistory: (args) => getFeeHistory(client, args),
+    estimateFeesPerGas: (args) => estimateFeesPerGas(client, args),
     getFilterChanges: (args) => getFilterChanges(client, args),
     getFilterLogs: (args) => getFilterLogs(client, args),
     getGasPrice: () => getGasPrice(client),
     getLogs: (args) => getLogs(client, args as any),
+    estimateMaxPriorityFeePerGas: (args) =>
+      estimateMaxPriorityFeePerGas(client, args),
     getStorageAt: (args) => getStorageAt(client, args),
     getTransaction: (args) => getTransaction(client, args),
     getTransactionConfirmations: (args) =>
@@ -1522,7 +1664,10 @@ export function publicActions<
     getTransactionCount: (args) => getTransactionCount(client, args),
     getTransactionReceipt: (args) => getTransactionReceipt(client, args),
     multicall: (args) => multicall(client, args),
+    prepareTransactionRequest: (args) =>
+      prepareTransactionRequest(client as any, args as any),
     readContract: (args) => readContract(client, args),
+    sendRawTransaction: (args) => sendRawTransaction(client, args),
     simulateContract: (args) => simulateContract(client, args),
     verifyMessage: (args) => verifyMessage(client, args),
     verifyTypedData: (args) => verifyTypedData(client, args),

package/src/clients/decorators/wallet.ts

@@ -22,6 +22,11 @@ import {
   type GetPermissionsReturnType,
   getPermissions,
 } from '../../actions/wallet/getPermissions.js'
+import {
+  type PrepareTransactionRequestParameters,
+  type PrepareTransactionRequestReturnType,
+  prepareTransactionRequest,
+} from '../../actions/wallet/prepareTransactionRequest.js'
 import {
   type RequestAddressesReturnType,
   requestAddresses,
@@ -31,6 +36,11 @@ import {
   type RequestPermissionsReturnType,
   requestPermissions,
 } from '../../actions/wallet/requestPermissions.js'
+import {
+  type SendRawTransactionParameters,
+  type SendRawTransactionReturnType,
+  sendRawTransaction,
+} from '../../actions/wallet/sendRawTransaction.js'
 import {
   type SendTransactionParameters,
   type SendTransactionReturnType,
@@ -41,6 +51,11 @@ import {
   type SignMessageReturnType,
   signMessage,
 } from '../../actions/wallet/signMessage.js'
+import {
+  type SignTransactionParameters,
+  type SignTransactionReturnType,
+  signTransaction,
+} from '../../actions/wallet/signTransaction.js'
 import {
   type SignTypedDataParameters,
   type SignTypedDataReturnType,
@@ -179,6 +194,47 @@ export type WalletActions<
    * const permissions = await client.getPermissions()
    */
   getPermissions: () => Promise<GetPermissionsReturnType>
+  /**
+   * Prepares a transaction request for signing.
+   *
+   * - Docs: https://viem.sh/docs/actions/wallet/prepareTransactionRequest.html
+   *
+   * @param args - {@link PrepareTransactionRequestParameters}
+   * @returns The transaction request. {@link PrepareTransactionRequestReturnType}
+   *
+   * @example
+   * import { createWalletClient, custom } from 'viem'
+   * import { mainnet } from 'viem/chains'
+   *
+   * const client = createWalletClient({
+   *   chain: mainnet,
+   *   transport: custom(window.ethereum),
+   * })
+   * const request = await client.prepareTransactionRequest({
+   *   account: '0xA0Cf798816D4b9b9866b5330EEa46a18382f251e',
+   *   to: '0x0000000000000000000000000000000000000000',
+   *   value: 1n,
+   * })
+   *
+   * @example
+   * // Account Hoisting
+   * import { createWalletClient, http } from 'viem'
+   * import { privateKeyToAccount } from 'viem/accounts'
+   * import { mainnet } from 'viem/chains'
+   *
+   * const client = createWalletClient({
+   *   account: privateKeyToAccount('0x…'),
+   *   chain: mainnet,
+   *   transport: custom(window.ethereum),
+   * })
+   * const request = await client.prepareTransactionRequest({
+   *   to: '0x0000000000000000000000000000000000000000',
+   *   value: 1n,
+   * })
+   */
+  prepareTransactionRequest: <TChainOverride extends Chain | undefined,>(
+    args: PrepareTransactionRequestParameters<TChain, TAccount, TChainOverride>,
+  ) => Promise<PrepareTransactionRequestReturnType>
   /**
    * Requests a list of accounts managed by a wallet.
    *
@@ -226,6 +282,33 @@ export type WalletActions<
   requestPermissions: (
     args: RequestPermissionsParameters,
   ) => Promise<RequestPermissionsReturnType>
+  /**
+   * Sends a **signed** transaction to the network
+   *
+   * - Docs: https://viem.sh/docs/actions/wallet/sendRawTransaction.html
+   * - JSON-RPC Method: [`eth_sendRawTransaction`](https://ethereum.github.io/execution-apis/api-documentation/)
+   *
+   * @param client - Client to use
+   * @param parameters - {@link SendRawTransactionParameters}
+   * @returns The transaction hash. {@link SendRawTransactionReturnType}
+   *
+   * @example
+   * import { createWalletClient, custom } from 'viem'
+   * import { mainnet } from 'viem/chains'
+   * import { sendRawTransaction } from 'viem/wallet'
+   *
+   * const client = createWalletClient({
+   *   chain: mainnet,
+   *   transport: custom(window.ethereum),
+   * })
+   *
+   * const hash = await client.sendRawTransaction({
+   *   serializedTransaction: '0x02f850018203118080825208808080c080a04012522854168b27e5dc3d5839bab5e6b39e1a0ffd343901ce1622e3d64b48f1a04e00902ae0502c4728cbf12156290df99c3ed7de85b1dbfe20b5c36931733a33'
+   * })
+   */
+  sendRawTransaction: (
+    args: SendRawTransactionParameters,
+  ) => Promise<SendRawTransactionReturnType>
   /**
    * Creates, signs, and sends a new transaction to the network.
    *
@@ -317,6 +400,52 @@ export type WalletActions<
   signMessage: (
     args: SignMessageParameters<TAccount>,
   ) => Promise<SignMessageReturnType>
+  /**
+   * Signs a transaction.
+   *
+   * - Docs: https://viem.sh/docs/actions/wallet/signTransaction.html
+   * - JSON-RPC Methods:
+   *   - JSON-RPC Accounts: [`eth_signTransaction`](https://ethereum.github.io/execution-apis/api-documentation/)
+   *   - Local Accounts: Signs locally. No JSON-RPC request.
+   *
+   * @param args - {@link SignTransactionParameters}
+   * @returns The signed message. {@link SignTransactionReturnType}
+   *
+   * @example
+   * import { createWalletClient, custom } from 'viem'
+   * import { mainnet } from 'viem/chains'
+   *
+   * const client = createWalletClient({
+   *   chain: mainnet,
+   *   transport: custom(window.ethereum),
+   * })
+   * const request = await client.prepareTransactionRequest({
+   *   account: '0xA0Cf798816D4b9b9866b5330EEa46a18382f251e',
+   *   to: '0x0000000000000000000000000000000000000000',
+   *   value: 1n,
+   * })
+   * const signature = await client.signTransaction(request)
+   *
+   * @example
+   * // Account Hoisting
+   * import { createWalletClient, http } from 'viem'
+   * import { privateKeyToAccount } from 'viem/accounts'
+   * import { mainnet } from 'viem/chains'
+   *
+   * const client = createWalletClient({
+   *   account: privateKeyToAccount('0x…'),
+   *   chain: mainnet,
+   *   transport: custom(window.ethereum),
+   * })
+   * const request = await client.prepareTransactionRequest({
+   *   to: '0x0000000000000000000000000000000000000000',
+   *   value: 1n,
+   * })
+   * const signature = await client.signTransaction(request)
+   */
+  signTransaction: <TChainOverride extends Chain | undefined,>(
+    args: SignTransactionParameters<TChain, TAccount, TChainOverride>,
+  ) => Promise<SignTransactionReturnType>
   /**
    * Signs typed data and calculates an Ethereum-specific signature in [EIP-191 format](https://eips.ethereum.org/EIPS/eip-191): `keccak256("\x19Ethereum Signed Message:\n" + len(message) + message))`.
    *
@@ -542,10 +671,14 @@ export function walletActions<
     getAddresses: () => getAddresses(client),
     getChainId: () => getChainId(client),
     getPermissions: () => getPermissions(client),
+    prepareTransactionRequest: (args) =>
+      prepareTransactionRequest(client as any, args as any),
     requestAddresses: () => requestAddresses(client),
     requestPermissions: (args) => requestPermissions(client, args),
+    sendRawTransaction: (args) => sendRawTransaction(client, args),
     sendTransaction: (args) => sendTransaction(client, args),
     signMessage: (args) => signMessage(client, args),
+    signTransaction: (args) => signTransaction(client, args),
     signTypedData: (args) => signTypedData(client, args),
     switchChain: (args) => switchChain(client, args),
     watchAsset: (args) => watchAsset(client, args),

package/src/errors/fee.ts

@@ -0,0 +1,27 @@
+import { formatGwei } from '../utils/unit/formatGwei.js'
+import { BaseError } from './base.js'
+
+export class BaseFeeScalarError extends BaseError {
+  override name = 'BaseFeeScalarError'
+  constructor() {
+    super('`baseFeeMultiplier` must be greater than 1.')
+  }
+}
+
+export class Eip1559FeesNotSupportedError extends BaseError {
+  override name = 'Eip1559FeesNotSupportedError'
+  constructor() {
+    super('Chain does not support EIP-1559 fees.')
+  }
+}
+
+export class MaxFeePerGasTooLowError extends BaseError {
+  override name = 'MaxFeePerGasTooLowError'
+  constructor({ maxPriorityFeePerGas }: { maxPriorityFeePerGas: bigint }) {
+    super(
+      `\`maxFeePerGas\` cannot be less than the \`maxPriorityFeePerGas\` (${formatGwei(
+        maxPriorityFeePerGas,
+      )} gwei).`,
+    )
+  }
+}

package/src/errors/rpc.ts

@@ -60,7 +60,7 @@ export type ProviderRpcErrorCode =
   | 4200 // Unsupported Method
   | 4900 // Disconnected
   | 4901 // Chain Disconnected
-  | 4902 // Chain Not Recongnized
+  | 4902 // Chain Not Recognized
 
 /**
  * Error subclass implementing Ethereum Provider errors per EIP-1193.

package/src/index.ts

@@ -71,6 +71,14 @@ export type {
   EstimateGasParameters,
   EstimateGasReturnType,
 } from './actions/public/estimateGas.js'
+export type {
+  EstimateFeesPerGasParameters,
+  EstimateFeesPerGasReturnType,
+} from './actions/public/estimateFeesPerGas.js'
+export type {
+  EstimateMaxPriorityFeePerGasParameters,
+  EstimateMaxPriorityFeePerGasReturnType,
+} from './actions/public/estimateMaxPriorityFeePerGas.js'
 export type { GetAddressesReturnType } from './actions/wallet/getAddresses.js'
 export type {
   GetBalanceParameters,
@@ -202,6 +210,12 @@ export type {
   SendTransactionParameters,
   SendTransactionReturnType,
 } from './actions/wallet/sendTransaction.js'
+export type {
+  PrepareTransactionRequestParameters,
+  PrepareTransactionRequestReturnType,
+  /** @deprecated import `prepareTransactionRequest` from `viem/actions` instead. */
+  prepareTransactionRequest as prepareRequest,
+} from './actions/wallet/prepareTransactionRequest.js'
 export type {
   SendUnsignedTransactionParameters,
   SendUnsignedTransactionReturnType,
@@ -252,6 +266,29 @@ export type {
   WriteContractParameters,
   WriteContractReturnType,
 } from './actions/wallet/writeContract.js'
+export type {
+  Chain,
+  ChainContract,
+  ChainFees,
+  ChainFormatter,
+  /** @deprecated use `ChainFormatter` instead. */
+  ChainFormatter as Formatter,
+  ChainFormatters,
+  /** @deprecated use `ChainFormatters` instead. */
+  ChainFormatters as Formatters,
+  ChainSerializers,
+  /** @deprecated use `ChainSerializers` instead. */
+  ChainSerializers as Serializers,
+  ExtractChainFormatterExclude,
+  /** @deprecated use `ExtractChainFormatterExclude` instead. */
+  ExtractChainFormatterExclude as ExtractFormatterExclude,
+  ExtractChainFormatterParameters,
+  /** @deprecated use `ExtractChainFormatterParameters` instead. */
+  ExtractChainFormatterParameters as ExtractFormatterParameters,
+  ExtractChainFormatterReturnType,
+  /** @deprecated use `ExtractChainFormatterReturnType` instead. */
+  ExtractChainFormatterReturnType as ExtractFormatterReturnType,
+} from './types/chain.js'
 export {
   type Client,
   type ClientConfig,
@@ -442,6 +479,11 @@ export {
   ContractFunctionZeroDataError,
   RawContractError,
 } from './errors/contract.js'
+export {
+  BaseFeeScalarError,
+  Eip1559FeesNotSupportedError,
+  MaxFeePerGasTooLowError,
+} from './errors/fee.js'
 export {
   ChainDisconnectedError,
   InternalRpcError,
@@ -581,32 +623,10 @@ export type {
   Signature,
   SignableMessage,
 } from './types/misc.js'
-export type {
-  Chain,
-  ChainContract,
-  ChainFees,
-  ChainFormatter,
-  /** @deprecated use `ChainFormatter` instead. */
-  ChainFormatter as Formatter,
-  ChainFormatters,
-  /** @deprecated use `ChainFormatters` instead. */
-  ChainFormatters as Formatters,
-  ChainSerializers,
-  /** @deprecated use `ChainSerializers` instead. */
-  ChainSerializers as Serializers,
-  ExtractChainFormatterExclude,
-  /** @deprecated use `ExtractChainFormatterExclude` instead. */
-  ExtractChainFormatterExclude as ExtractFormatterExclude,
-  ExtractChainFormatterParameters,
-  /** @deprecated use `ExtractChainFormatterParameters` instead. */
-  ExtractChainFormatterParameters as ExtractFormatterParameters,
-  ExtractChainFormatterReturnType,
-  /** @deprecated use `ExtractChainFormatterReturnType` instead. */
-  ExtractChainFormatterReturnType as ExtractFormatterReturnType,
-  GetChain,
-} from './types/chain.js'
+export type { GetChain } from './types/chain.js'
 export type {
   AddEthereumChainParameter,
+  EIP1193EventMap,
   EIP1193Events,
   EIP1193Parameters,
   EIP1193Provider,
@@ -630,6 +650,7 @@ export type {
   FeeValues,
   FeeValuesEIP1559,
   FeeValuesLegacy,
+  FeeValuesType,
 } from './types/fee.js'
 export type { Filter } from './types/filter.js'
 export type { TypedDataDefinition } from './types/typedData.js'
@@ -728,6 +749,7 @@ export {
   type FormattedTransactionRequest,
   defineTransactionRequest,
   formatTransactionRequest,
+  rpcTransactionType,
 } from './utils/formatters/transactionRequest.js'
 export {
   type GetAbiItemParameters,
@@ -850,7 +872,6 @@ export { parseEther } from './utils/unit/parseEther.js'
 export { parseGwei } from './utils/unit/parseGwei.js'
 export { parseTransaction } from './utils/transaction/parseTransaction.js'
 export { parseUnits } from './utils/unit/parseUnits.js'
-export { prepareRequest } from './utils/transaction/prepareRequest.js'
 export { serializeAccessList } from './utils/transaction/serializeAccessList.js'
 export {
   serializeTransaction,

package/src/public.ts

@@ -53,6 +53,11 @@ export {
   type GetFeeHistoryParameters,
   type GetFeeHistoryReturnType,
 } from './actions/public/getFeeHistory.js'
+export {
+  estimateFeesPerGas,
+  type EstimateFeesPerGasParameters,
+  type EstimateFeesPerGasReturnType,
+} from './actions/public/estimateFeesPerGas.js'
 export {
   getFilterChanges,
   type GetFilterChangesParameters,
@@ -68,6 +73,11 @@ export {
   getGasPrice,
   type GetGasPriceReturnType,
 } from './actions/public/getGasPrice.js'
+export {
+  estimateMaxPriorityFeePerGas,
+  type EstimateMaxPriorityFeePerGasParameters,
+  type EstimateMaxPriorityFeePerGasReturnType,
+} from './actions/public/estimateMaxPriorityFeePerGas.js'
 export {
   getTransaction,
   type GetTransactionParameters,