viem/utils/unit/formatEther.ts

TypeScript Interface for Ethereum

import type { FormatUnitsErrorType } from './formatUnits.js'
import * as Value from './Value.js'

export type FormatEtherErrorType = FormatUnitsErrorType

/**
 * Converts numerical wei to a string representation of ether.
 *
 * - Docs: https://viem.sh/docs/utilities/formatEther
 *
 * @example
 * import { formatEther } from 'viem'
 *
 * formatEther(1000000000000000000n)
 * // '1'
 */
export function formatEther(wei: bigint, unit: 'wei' | 'gwei' = 'wei') {
  return Value.formatEther(wei, unit)
}