Convert Wei to a human-readable ETH string with up to 18 significant decimal places. Trailing zeros are trimmed.

formatEther zero         == "0"
formatEther (10^18 wei)  == "1"
formatEther (1.5×10^18)  == "1.5"
formatEther (10^15 wei)  == "0.001"

Parse a human-readable ETH string to Wei. Returns Nothing for invalid input, non-numeric strings, or negative values.

parseEther "1"                       == Just <10^18>
parseEther "1.5"                     == Just <1.5×10^18>
parseEther "0.000000000000000001"    == Just (BigInt.fromInt 1)
parseEther "not-a-number"            == Nothing
parseEther "-1"                      == Nothing

Convert a token amount (in its smallest unit) to a human-readable string for a token with the given number of decimal places. Trailing zeros are trimmed.

formatUnits 6 (BigInt.fromInt 1500000)  == "1.5"   -- USDC
formatUnits 8 (BigInt.fromInt 100000000) == "1"    -- WBTC

Parse a human-readable token amount to its smallest unit, given the token's decimal count. Returns Nothing for invalid or negative input.

parseUnits 6 "1.5"  == Just (BigInt.fromInt 1500000)   -- USDC
parseUnits 6 "0"    == Just BigInt.zero
parseUnits 6 "-1"   == Nothing