import type { BaseUnits, NativeUnits } from '../types.js';
export { InvalidDecimalNumberError } from 'viem';
/**
 * Formats a value from base units to formatted units.
 *
 * @param value - The value to be formatted, either in base units or formatted units.
 * @param decimals - The number of decimal places to consider for base units.
 * @returns The value in formatted units.
 * @throws {@link InvalidDecimalNumberError} If the value is not a valid number.
 *
 * @example
 * ```typescript
 * formatUnits(1000000000000000000n, 18)
 * // => '1'
 * formatUnits('1', 18)
 * // => '1'
 * ```
 */
export declare function formatUnits(value: BaseUnits | NativeUnits, decimals?: number): NativeUnits;