viem 2.55.2 → 2.55.4

package/_types/utils/unit/Value.d.ts

@@ -0,0 +1,115 @@
+/**
+ * Formats a `bigint` Value to its string representation (divided by the given exponent).
+ *
+ * @example
+ * ```ts twoslash
+ * import { Value } from 'ox'
+ *
+ * Value.format(420_000_000_000n, 9)
+ * // @log: '420'
+ * ```
+ *
+ * @param value - The `bigint` Value to format.
+ * @param decimals - The exponent to divide the `bigint` Value by.
+ * @returns The string representation of the Value.
+ */
+export declare function format(value: bigint, decimals?: number): string;
+export declare namespace format {
+    type ErrorType = Error;
+}
+/**
+ * Formats a `bigint` Value (default: wei) to a string representation of Ether.
+ *
+ * @example
+ * ```ts twoslash
+ * import { Value } from 'ox'
+ *
+ * Value.formatEther(1_000_000_000_000_000_000n)
+ * // @log: '1'
+ * ```
+ *
+ * @param wei - The Value to format.
+ * @param unit - The unit to format the Value in. @default 'wei'.
+ * @returns The Ether string representation of the Value.
+ */
+export declare function formatEther(wei: bigint, unit?: 'wei' | 'gwei' | 'szabo' | 'finney'): string;
+export declare namespace formatEther {
+    type ErrorType = format.ErrorType | Error;
+}
+/**
+ * Formats a `bigint` Value (default: wei) to a string representation of Gwei.
+ *
+ * @example
+ * ```ts twoslash
+ * import { Value } from 'ox'
+ *
+ * Value.formatGwei(1_000_000_000n)
+ * // @log: '1'
+ * ```
+ *
+ * @param wei - The Value to format.
+ * @param unit - The unit to format the Value in. @default 'wei'.
+ * @returns The Gwei string representation of the Value.
+ */
+export declare function formatGwei(wei: bigint, unit?: 'wei'): string;
+export declare namespace formatGwei {
+    type ErrorType = format.ErrorType | Error;
+}
+/**
+ * Parses a `string` representation of a Value to `bigint` (multiplied by the given exponent).
+ *
+ * @example
+ * ```ts twoslash
+ * import { Value } from 'ox'
+ *
+ * Value.from('420', 9)
+ * // @log: 420000000000n
+ * ```
+ *
+ * @param value - The string representation of the Value.
+ * @param decimals - The exponent to multiply the Value by.
+ * @returns The `bigint` representation of the Value.
+ */
+export declare function from(value: string, decimals?: number): bigint;
+export declare namespace from {
+    type ErrorType = Error;
+}
+/**
+ * Parses a string representation of Ether to a `bigint` Value (default: wei).
+ *
+ * @example
+ * ```ts twoslash
+ * import { Value } from 'ox'
+ *
+ * Value.fromEther('420')
+ * // @log: 420000000000000000000n
+ * ```
+ *
+ * @param ether - String representation of Ether.
+ * @param unit - The unit to parse to. @default 'wei'.
+ * @returns A `bigint` Value.
+ */
+export declare function fromEther(ether: string, unit?: 'wei' | 'gwei' | 'szabo' | 'finney'): bigint;
+export declare namespace fromEther {
+    type ErrorType = from.ErrorType | Error;
+}
+/**
+ * Parses a string representation of Gwei to a `bigint` Value (default: wei).
+ *
+ * @example
+ * ```ts twoslash
+ * import { Value } from 'ox'
+ *
+ * Value.fromGwei('420')
+ * // @log: 420000000000n
+ * ```
+ *
+ * @param gwei - String representation of Gwei.
+ * @param unit - The unit to parse to. @default 'wei'.
+ * @returns A `bigint` Value.
+ */
+export declare function fromGwei(gwei: string, unit?: 'wei'): bigint;
+export declare namespace fromGwei {
+    type ErrorType = from.ErrorType | Error;
+}
+//# sourceMappingURL=Value.d.ts.map

package/_types/utils/unit/Value.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Value.d.ts","sourceRoot":"","sources":["../../../utils/unit/Value.ts"],"names":[],"mappings":"AAWA;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,SAAI,UAmBjD;AAED,MAAM,CAAC,OAAO,WAAW,MAAM,CAAC;IAC9B,KAAK,SAAS,GAAG,KAAK,CAAA;CACvB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,WAAW,CACzB,GAAG,EAAE,MAAM,EACX,IAAI,GAAE,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,QAAgB,UAGlD;AAED,MAAM,CAAC,OAAO,WAAW,WAAW,CAAC;IACnC,KAAK,SAAS,GAAG,MAAM,CAAC,SAAS,GAAG,KAAK,CAAA;CAC1C;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,KAAa,UAE1D;AAED,MAAM,CAAC,OAAO,WAAW,UAAU,CAAC;IAClC,KAAK,SAAS,GAAG,MAAM,CAAC,SAAS,GAAG,KAAK,CAAA;CAC1C;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,SAAI,UAmD/C;AAwBD,MAAM,CAAC,OAAO,WAAW,IAAI,CAAC;IAC5B,KAAK,SAAS,GAAG,KAAK,CAAA;CACvB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,SAAS,CACvB,KAAK,EAAE,MAAM,EACb,IAAI,GAAE,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,QAAgB,UAGlD;AAED,MAAM,CAAC,OAAO,WAAW,SAAS,CAAC;IACjC,KAAK,SAAS,GAAG,IAAI,CAAC,SAAS,GAAG,KAAK,CAAA;CACxC;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,KAAa,UAEzD;AAED,MAAM,CAAC,OAAO,WAAW,QAAQ,CAAC;IAChC,KAAK,SAAS,GAAG,IAAI,CAAC,SAAS,GAAG,KAAK,CAAA;CACxC"}

package/_types/utils/unit/formatEther.d.ts

@@ -1,4 +1,4 @@
-import { type FormatUnitsErrorType } from './formatUnits.js';
+import type { FormatUnitsErrorType } from './formatUnits.js';
 export type FormatEtherErrorType = FormatUnitsErrorType;
 /**
  * Converts numerical wei to a string representation of ether.

package/_types/utils/unit/formatEther.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"formatEther.d.ts","sourceRoot":"","sources":["../../../utils/unit/formatEther.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,oBAAoB,EAAe,MAAM,kBAAkB,CAAA;AAEzE,MAAM,MAAM,oBAAoB,GAAG,oBAAoB,CAAA;AAEvD;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,KAAK,GAAG,MAAc,UAEpE"}
+{"version":3,"file":"formatEther.d.ts","sourceRoot":"","sources":["../../../utils/unit/formatEther.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAA;AAG5D,MAAM,MAAM,oBAAoB,GAAG,oBAAoB,CAAA;AAEvD;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,KAAK,GAAG,MAAc,UAEpE"}

package/_types/utils/unit/formatGwei.d.ts

@@ -1,4 +1,4 @@
-import { type FormatUnitsErrorType } from './formatUnits.js';
+import type { FormatUnitsErrorType } from './formatUnits.js';
 export type FormatGweiErrorType = FormatUnitsErrorType;
 /**
  * Converts numerical wei to a string representation of gwei.

package/_types/utils/unit/formatGwei.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"formatGwei.d.ts","sourceRoot":"","sources":["../../../utils/unit/formatGwei.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,oBAAoB,EAAe,MAAM,kBAAkB,CAAA;AAEzE,MAAM,MAAM,mBAAmB,GAAG,oBAAoB,CAAA;AAEtD;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,KAAa,UAE1D"}
+{"version":3,"file":"formatGwei.d.ts","sourceRoot":"","sources":["../../../utils/unit/formatGwei.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAA;AAG5D,MAAM,MAAM,mBAAmB,GAAG,oBAAoB,CAAA;AAEtD;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,KAAa,UAE1D"}

package/_types/utils/unit/formatUnits.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"formatUnits.d.ts","sourceRoot":"","sources":["../../../utils/unit/formatUnits.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AAEtD,MAAM,MAAM,oBAAoB,GAAG,SAAS,CAAA;AAE5C;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,UAgB1D"}
+{"version":3,"file":"formatUnits.d.ts","sourceRoot":"","sources":["../../../utils/unit/formatUnits.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AAGtD,MAAM,MAAM,oBAAoB,GAAG,SAAS,CAAA;AAE5C;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,UAE1D"}

package/_types/utils/unit/parseEther.d.ts

@@ -1,5 +1,5 @@
 import type { ErrorType } from '../../errors/utils.js';
-import { type ParseUnitsErrorType } from './parseUnits.js';
+import type { ParseUnitsErrorType } from './parseUnits.js';
 export type ParseEtherErrorType = ParseUnitsErrorType | ErrorType;
 /**
  * Converts a string representation of ether to numerical wei.

package/_types/utils/unit/parseEther.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parseEther.d.ts","sourceRoot":"","sources":["../../../utils/unit/parseEther.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AAEtD,OAAO,EAAE,KAAK,mBAAmB,EAAc,MAAM,iBAAiB,CAAA;AAEtE,MAAM,MAAM,mBAAmB,GAAG,mBAAmB,GAAG,SAAS,CAAA;AAEjE;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,GAAE,KAAK,GAAG,MAAc,UAErE"}
+{"version":3,"file":"parseEther.d.ts","sourceRoot":"","sources":["../../../utils/unit/parseEther.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AACtD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AAG1D,MAAM,MAAM,mBAAmB,GAAG,mBAAmB,GAAG,SAAS,CAAA;AAEjE;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,GAAE,KAAK,GAAG,MAAc,UAErE"}

package/_types/utils/unit/parseGwei.d.ts

@@ -1,5 +1,5 @@
 import type { ErrorType } from '../../errors/utils.js';
-import { type ParseUnitsErrorType } from './parseUnits.js';
+import type { ParseUnitsErrorType } from './parseUnits.js';
 export type ParseGweiErrorType = ParseUnitsErrorType | ErrorType;
 /**
  * Converts a string representation of gwei to numerical wei.

package/_types/utils/unit/parseGwei.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parseGwei.d.ts","sourceRoot":"","sources":["../../../utils/unit/parseGwei.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AAEtD,OAAO,EAAE,KAAK,mBAAmB,EAAc,MAAM,iBAAiB,CAAA;AAEtE,MAAM,MAAM,kBAAkB,GAAG,mBAAmB,GAAG,SAAS,CAAA;AAEhE;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,GAAE,KAAa,UAE3D"}
+{"version":3,"file":"parseGwei.d.ts","sourceRoot":"","sources":["../../../utils/unit/parseGwei.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AACtD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AAG1D,MAAM,MAAM,kBAAkB,GAAG,mBAAmB,GAAG,SAAS,CAAA;AAEhE;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,GAAE,KAAa,UAE3D"}

package/_types/utils/unit/parseUnits.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parseUnits.d.ts","sourceRoot":"","sources":["../../../utils/unit/parseUnits.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AAEtD,MAAM,MAAM,mBAAmB,GAAG,SAAS,CAAA;AAE3C;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,UAwCzD"}
+{"version":3,"file":"parseUnits.d.ts","sourceRoot":"","sources":["../../../utils/unit/parseUnits.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AAGtD,MAAM,MAAM,mBAAmB,GAAG,SAAS,CAAA;AAE3C;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,UAEzD"}

package/chains/definitions/mainnet.ts

@@ -7,7 +7,7 @@ export const mainnet = /*#__PURE__*/ defineChain({
   blockTime: 12_000,
   rpcUrls: {
     default: {
-      http: ['https://eth.merkle.io'],
+      http: ['https://ethereum.reth.rs/rpc'],
     },
   },
   blockExplorers: {

package/chains/definitions/robinhood.ts

@@ -4,6 +4,7 @@ export const robinhood = /*#__PURE__*/ defineChain({
   id: 4663,
   name: 'Robinhood Chain',
   nativeCurrency: { name: 'Ether', symbol: 'ETH', decimals: 18 },
+  blockTime: 100,
   rpcUrls: {
     default: {
       http: ['https://rpc.mainnet.chain.robinhood.com'],

package/chains/definitions/xLayer.ts

@@ -8,6 +8,7 @@ export const xLayer = /*#__PURE__*/ defineChain({
     name: 'OKB',
     symbol: 'OKB',
   },
+  blockTime: 1_000,
   rpcUrls: {
     default: { http: ['https://xlayerrpc.okx.com'] },
   },

package/errors/version.ts

@@ -1 +1 @@
-export const version = '2.55.2'
+export const version = '2.55.4'

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "viem",
   "description": "TypeScript Interface for Ethereum",
-  "version": "2.55.2",
+  "version": "2.55.4",
   "main": "./_cjs/index.js",
   "module": "./_esm/index.js",
   "types": "./_types/index.d.ts",

package/tempo/chainConfig.ts

@@ -22,6 +22,14 @@ import * as Transaction from './Transaction.js'
 
 const maxExpirySecs = 25
 
+/** Returns random past seconds to distinguish otherwise-identical expiring transactions. */
+function randomValidAfter(): number {
+  const now = BigInt(Math.floor(Date.now() / 1_000))
+  const latest = now - 60n
+  if (latest <= 0n) return 0
+  return Number(BigInt(Hex.random(8)) % latest)
+}
+
 export const chainConfig = {
   blockTime: 1_000,
   extendSchema: extendSchema<{
@@ -160,6 +168,8 @@ export const chainConfig = {
       if (useExpiringNonce) {
         request.nonceKey = maxUint256
         request.nonce = 0
+        if (typeof request.validAfter === 'undefined')
+          request.validAfter = randomValidAfter()
         if (typeof request.validBefore === 'undefined')
           request.validBefore = Math.floor(Date.now() / 1000) + maxExpirySecs
       } else if (typeof request.nonceKey !== 'undefined') {

package/utils/abi/decodeAbiParameters.ts

@@ -22,7 +22,6 @@ import {
 } from '../cursor.js'
 import { type SizeErrorType, size } from '../data/size.js'
 import { type SliceBytesErrorType, sliceBytes } from '../data/slice.js'
-import { type TrimErrorType, trim } from '../data/trim.js'
 import {
   type BytesToBigIntErrorType,
   type BytesToBoolErrorType,
@@ -355,7 +354,6 @@ function decodeTuple(
 type DecodeStringErrorType =
   | BytesToNumberErrorType
   | BytesToStringErrorType
-  | TrimErrorType
   | ErrorType
 
 function decodeString(
@@ -378,7 +376,7 @@ function decodeString(
   }
 
   const data = cursor.readBytes(length, 32)
-  const value = bytesToString(trim(data))
+  const value = bytesToString(data)
 
   // As we have gone wondering, restore to the original position + next slot.
   cursor.setPosition(staticPosition + 32)

package/utils/unit/Value.ts

@@ -0,0 +1,278 @@
+// Adapted from the Ox v1 `Value` module.
+
+/** @see https://ethereum.github.io/yellowpaper/paper.pdf */
+const exponents = {
+  wei: 0,
+  gwei: 9,
+  szabo: 12,
+  finney: 15,
+  ether: 18,
+} as const
+
+/**
+ * Formats a `bigint` Value to its string representation (divided by the given exponent).
+ *
+ * @example
+ * ```ts twoslash
+ * import { Value } from 'ox'
+ *
+ * Value.format(420_000_000_000n, 9)
+ * // @log: '420'
+ * ```
+ *
+ * @param value - The `bigint` Value to format.
+ * @param decimals - The exponent to divide the `bigint` Value by.
+ * @returns The string representation of the Value.
+ */
+export function format(value: bigint, decimals = 0) {
+  if (!Number.isInteger(decimals) || decimals < 0)
+    throw new InvalidDecimalsError({ decimals })
+
+  let display = value.toString()
+
+  const negative = display.startsWith('-')
+  if (negative) display = display.slice(1)
+
+  display = display.padStart(decimals, '0')
+
+  let [integer, fraction] = [
+    display.slice(0, display.length - decimals),
+    display.slice(display.length - decimals),
+  ]
+  fraction = fraction.replace(/(0+)$/, '')
+  return `${negative ? '-' : ''}${integer || '0'}${
+    fraction ? `.${fraction}` : ''
+  }`
+}
+
+export declare namespace format {
+  type ErrorType = Error
+}
+
+/**
+ * Formats a `bigint` Value (default: wei) to a string representation of Ether.
+ *
+ * @example
+ * ```ts twoslash
+ * import { Value } from 'ox'
+ *
+ * Value.formatEther(1_000_000_000_000_000_000n)
+ * // @log: '1'
+ * ```
+ *
+ * @param wei - The Value to format.
+ * @param unit - The unit to format the Value in. @default 'wei'.
+ * @returns The Ether string representation of the Value.
+ */
+export function formatEther(
+  wei: bigint,
+  unit: 'wei' | 'gwei' | 'szabo' | 'finney' = 'wei',
+) {
+  return format(wei, exponents.ether - exponents[unit])
+}
+
+export declare namespace formatEther {
+  type ErrorType = format.ErrorType | Error
+}
+
+/**
+ * Formats a `bigint` Value (default: wei) to a string representation of Gwei.
+ *
+ * @example
+ * ```ts twoslash
+ * import { Value } from 'ox'
+ *
+ * Value.formatGwei(1_000_000_000n)
+ * // @log: '1'
+ * ```
+ *
+ * @param wei - The Value to format.
+ * @param unit - The unit to format the Value in. @default 'wei'.
+ * @returns The Gwei string representation of the Value.
+ */
+export function formatGwei(wei: bigint, unit: 'wei' = 'wei') {
+  return format(wei, exponents.gwei - exponents[unit])
+}
+
+export declare namespace formatGwei {
+  type ErrorType = format.ErrorType | Error
+}
+
+/**
+ * Parses a `string` representation of a Value to `bigint` (multiplied by the given exponent).
+ *
+ * @example
+ * ```ts twoslash
+ * import { Value } from 'ox'
+ *
+ * Value.from('420', 9)
+ * // @log: 420000000000n
+ * ```
+ *
+ * @param value - The string representation of the Value.
+ * @param decimals - The exponent to multiply the Value by.
+ * @returns The `bigint` representation of the Value.
+ */
+export function from(value: string, decimals = 0) {
+  if (!Number.isInteger(decimals) || decimals < 0)
+    throw new InvalidDecimalsError({ decimals })
+
+  // Require at least one digit overall. Rejects '', '.', '-', '-.' which
+  // the previous regex accepted (and which then either produced garbage or
+  // threw a raw `SyntaxError` from `BigInt('')`).
+  if (!/^-?(?:[0-9]+(?:\.[0-9]*)?|\.[0-9]+)$/.test(value))
+    throw new InvalidDecimalNumberError({ value })
+
+  let [integer = '', fraction = '0'] = value.split('.')
+
+  const negative = integer.startsWith('-')
+  if (negative) integer = integer.slice(1)
+  if (integer === '') integer = '0'
+
+  // trim trailing zeros.
+  fraction = fraction.replace(/(0+)$/, '')
+
+  // round off if the fraction is larger than the number of decimals.
+  if (decimals === 0) {
+    // Round half-away-from-zero by inspecting the first fractional digit.
+    if (fraction.length > 0 && Number.parseInt(fraction[0]!, 10) >= 5)
+      integer = `${BigInt(integer) + 1n}`
+    fraction = ''
+  } else if (fraction.length > decimals) {
+    const left = fraction.slice(0, decimals)
+    const roundDigit = Number.parseInt(
+      fraction.slice(decimals, decimals + 1)!,
+      10,
+    )
+
+    if (roundDigit >= 5) {
+      // Carry through the truncated fraction digits into the integer part
+      // without converting to a JS Number (avoids float precision loss).
+      const carried = carry(left)
+      if (carried.length > decimals) {
+        // Carry overflowed into the integer part.
+        fraction = carried.slice(1)
+        integer = `${BigInt(integer) + 1n}`
+      } else {
+        fraction = carried
+      }
+    } else {
+      fraction = left
+    }
+  } else {
+    fraction = fraction.padEnd(decimals, '0')
+  }
+
+  return BigInt(`${negative ? '-' : ''}${integer}${fraction}`)
+}
+
+/**
+ * Adds 1 to a digit string with carry, returning a string of the same length
+ * unless the carry overflows past the most-significant digit (in which case
+ * the returned string is one digit longer).
+ *
+ * @internal
+ */
+function carry(digits: string): string {
+  const out = digits.split('')
+  let i = out.length - 1
+  while (i >= 0) {
+    const d = Number.parseInt(out[i]!, 10) + 1
+    if (d < 10) {
+      out[i] = String(d)
+      return out.join('')
+    }
+    out[i] = '0'
+    i--
+  }
+  return `1${out.join('')}`
+}
+
+export declare namespace from {
+  type ErrorType = Error
+}
+
+/**
+ * Parses a string representation of Ether to a `bigint` Value (default: wei).
+ *
+ * @example
+ * ```ts twoslash
+ * import { Value } from 'ox'
+ *
+ * Value.fromEther('420')
+ * // @log: 420000000000000000000n
+ * ```
+ *
+ * @param ether - String representation of Ether.
+ * @param unit - The unit to parse to. @default 'wei'.
+ * @returns A `bigint` Value.
+ */
+export function fromEther(
+  ether: string,
+  unit: 'wei' | 'gwei' | 'szabo' | 'finney' = 'wei',
+) {
+  return from(ether, exponents.ether - exponents[unit])
+}
+
+export declare namespace fromEther {
+  type ErrorType = from.ErrorType | Error
+}
+
+/**
+ * Parses a string representation of Gwei to a `bigint` Value (default: wei).
+ *
+ * @example
+ * ```ts twoslash
+ * import { Value } from 'ox'
+ *
+ * Value.fromGwei('420')
+ * // @log: 420000000000n
+ * ```
+ *
+ * @param gwei - String representation of Gwei.
+ * @param unit - The unit to parse to. @default 'wei'.
+ * @returns A `bigint` Value.
+ */
+export function fromGwei(gwei: string, unit: 'wei' = 'wei') {
+  return from(gwei, exponents.gwei - exponents[unit])
+}
+
+export declare namespace fromGwei {
+  type ErrorType = from.ErrorType | Error
+}
+
+/**
+ * Thrown when a value is not a valid decimal number.
+ *
+ * @example
+ * ```ts twoslash
+ * import { Value } from 'ox'
+ *
+ * Value.fromEther('123.456.789')
+ * // @error: Value.InvalidDecimalNumberError: Value `123.456.789` is not a valid decimal number.
+ * ```
+ */
+class InvalidDecimalNumberError extends Error {
+  override readonly name = 'Value.InvalidDecimalNumberError'
+  constructor({ value }: { value: string }) {
+    super(`Value \`${value}\` is not a valid decimal number.`)
+  }
+}
+
+/**
+ * Thrown when the `decimals` argument is not a non-negative integer.
+ *
+ * @example
+ * ```ts twoslash
+ * import { Value } from 'ox'
+ *
+ * Value.from('1', -1)
+ * // @error: Value.InvalidDecimalsError: `decimals` must be a non-negative integer. Got `-1`.
+ * ```
+ */
+class InvalidDecimalsError extends Error {
+  override readonly name = 'Value.InvalidDecimalsError'
+  constructor({ decimals }: { decimals: number }) {
+    super(`\`decimals\` must be a non-negative integer. Got \`${decimals}\`.`)
+  }
+}

package/utils/unit/formatEther.ts

@@ -1,6 +1,5 @@
-import { etherUnits } from '../../constants/unit.js'
-
-import { type FormatUnitsErrorType, formatUnits } from './formatUnits.js'
+import type { FormatUnitsErrorType } from './formatUnits.js'
+import * as Value from './Value.js'
 
 export type FormatEtherErrorType = FormatUnitsErrorType
 
@@ -16,5 +15,5 @@ export type FormatEtherErrorType = FormatUnitsErrorType
  * // '1'
  */
 export function formatEther(wei: bigint, unit: 'wei' | 'gwei' = 'wei') {
-  return formatUnits(wei, etherUnits[unit])
+  return Value.formatEther(wei, unit)
 }

package/utils/unit/formatGwei.ts

@@ -1,6 +1,5 @@
-import { gweiUnits } from '../../constants/unit.js'
-
-import { type FormatUnitsErrorType, formatUnits } from './formatUnits.js'
+import type { FormatUnitsErrorType } from './formatUnits.js'
+import * as Value from './Value.js'
 
 export type FormatGweiErrorType = FormatUnitsErrorType
 
@@ -16,5 +15,5 @@ export type FormatGweiErrorType = FormatUnitsErrorType
  * // '1'
  */
 export function formatGwei(wei: bigint, unit: 'wei' = 'wei') {
-  return formatUnits(wei, gweiUnits[unit])
+  return Value.formatGwei(wei, unit)
 }

package/utils/unit/formatUnits.ts

@@ -1,4 +1,5 @@
 import type { ErrorType } from '../../errors/utils.js'
+import * as Value from './Value.js'
 
 export type FormatUnitsErrorType = ErrorType
 
@@ -14,19 +15,5 @@ export type FormatUnitsErrorType = ErrorType
  * // '420'
  */
 export function formatUnits(value: bigint, decimals: number) {
-  let display = value.toString()
-
-  const negative = display.startsWith('-')
-  if (negative) display = display.slice(1)
-
-  display = display.padStart(decimals, '0')
-
-  let [integer, fraction] = [
-    display.slice(0, display.length - decimals),
-    display.slice(display.length - decimals),
-  ]
-  fraction = fraction.replace(/(0+)$/, '')
-  return `${negative ? '-' : ''}${integer || '0'}${
-    fraction ? `.${fraction}` : ''
-  }`
+  return Value.format(value, decimals)
 }

package/utils/unit/parseEther.ts

@@ -1,7 +1,6 @@
-import { etherUnits } from '../../constants/unit.js'
 import type { ErrorType } from '../../errors/utils.js'
-
-import { type ParseUnitsErrorType, parseUnits } from './parseUnits.js'
+import type { ParseUnitsErrorType } from './parseUnits.js'
+import * as Value from './Value.js'
 
 export type ParseEtherErrorType = ParseUnitsErrorType | ErrorType
 
@@ -17,5 +16,5 @@ export type ParseEtherErrorType = ParseUnitsErrorType | ErrorType
  * // 420000000000000000000n
  */
 export function parseEther(ether: string, unit: 'wei' | 'gwei' = 'wei') {
-  return parseUnits(ether, etherUnits[unit])
+  return Value.fromEther(ether, unit)
 }

package/utils/unit/parseGwei.ts

@@ -1,7 +1,6 @@
-import { gweiUnits } from '../../constants/unit.js'
 import type { ErrorType } from '../../errors/utils.js'
-
-import { type ParseUnitsErrorType, parseUnits } from './parseUnits.js'
+import type { ParseUnitsErrorType } from './parseUnits.js'
+import * as Value from './Value.js'
 
 export type ParseGweiErrorType = ParseUnitsErrorType | ErrorType
 
@@ -17,5 +16,5 @@ export type ParseGweiErrorType = ParseUnitsErrorType | ErrorType
  * // 420000000000n
  */
 export function parseGwei(ether: string, unit: 'wei' = 'wei') {
-  return parseUnits(ether, gweiUnits[unit])
+  return Value.fromGwei(ether, unit)
 }