parseUsdc

SV3 amounts are branded bigint values. USDC is 6 decimals (UsdcRaw). AVM is 18 decimals (AvmAtoms). Prices are 18-decimal WAD (Wad). Never pass a JavaScript number into math.

parseUsdc('1') equals 1 USDC in raw units (asUsdcRaw(1000000n)).

Import

import { parseUsdc, parseAvm, parsePrice } from "@repo/contract-client";
import { asUsdcRaw, asAvmAtoms, asWad } from "@repo/contract-client/types";

sv3.units.parseUsdc is the same function.

Usage

import { parseUsdc, parseAvm } from "@repo/contract-client";
import { quoteBuyExactReserveIn } from "@repo/contract-client/math";

const quote = quoteBuyExactReserveIn(snapshot, parseUsdc("1.5"));
const sell = quoteSellExactAvmIn(snapshot, parseAvm("100"));

Already in atoms:

import { asUsdcRaw, asAvmAtoms, asWad } from "@repo/contract-client/types";

asUsdcRaw(1_500_000n); // 1.5 USDC
asAvmAtoms(10n ** 18n); // 1 AVM
asWad(10n ** 18n); // 1.0 as WAD

Format for UI:

import { formatTokenAmount, formatPrice } from "@repo/contract-client";

formatTokenAmount(1_500_000n, 6); // '1.5'
formatPrice(snapshot.spotPriceWad); // spot as a decimal string

Return Value

parseUsdc → UsdcRaw
parseAvm → AvmAtoms
parsePrice → Wad
asUsdcRaw / asAvmAtoms / asWad → the same branded bigint you passed in

Parameters

value (parseUsdc / parseAvm / parsePrice)

• Type: string

Decimal string. Too many fractional digits throws InvalidAmountError. Negative values throw.

parseUsdc("10");
parseUsdc("0.000001"); // 1 raw unit
parseAvm("1.5");
parsePrice("0.0004555");

n (asUsdcRaw / asAvmAtoms / asWad)

• Type: bigint

Already-scaled integer. These helpers only brand the value.

asUsdcRaw(1_000_000n);

Error

InvalidAmountError if the string is not a decimal, has too many fractional digits, or is negative.

Tips

• 1e6 in JavaScript is a number. Use 1_000_000n or parseUsdc('1').
• Slippage helpers applyMinSlippage / applyMaxSlippage also live on sv3.units.
• 6dp ↔ 18dp conversion without branding is rawToWad / wadToRaw.