Precision and Types

import { BN, PRICE_PRECISION, BASE_PRECISION, QUOTE_PRECISION, convertToNumber } from "@velocity-exchange/sdk";
 
// Oracle price: raw 150_500_000 → 150.5 USD
const rawPrice = new BN(150_500_000);
const price = convertToNumber(rawPrice, PRICE_PRECISION);
console.log(price); // 150.5
 
// Position size: raw 2_500_000_000 → 2.5 SOL
const rawBase = new BN(2_500_000_000);
const size = convertToNumber(rawBase, BASE_PRECISION);
console.log(size); // 2.5
 
// Collateral: raw 10_000_000 → 10 USDT (or dUSDT on devnet)
const rawQuote = new BN(10_000_000);
const usd = convertToNumber(rawQuote, QUOTE_PRECISION);
console.log(usd); // 10

import { BN, BASE_PRECISION, PRICE_PRECISION } from "@velocity-exchange/sdk";
 
// 1 SOL in base precision
const oneSol = new BN(1).mul(BASE_PRECISION); // BN(1_000_000_000)
 
// $21.23 in price precision
const price = new BN(21_230_000); // 21.23 * 1e6
 
// Or use VelocityClient convenience helpers (available after setup):
const size = velocityClient.convertToPerpPrecision(1);     // 1 base unit as BN
const px = velocityClient.convertToPricePrecision(21.23);   // price as BN
const spot = velocityClient.convertToSpotPrecision(0, 100); // 100 quote-asset units as BN

import {
  BN,
  BigNum,
  PRICE_PRECISION_EXP,
  BASE_PRECISION_EXP,
} from "@velocity-exchange/sdk";
 
// Raw oracle price (1e6) wrapped with its exponent
const price = BigNum.from(new BN(150_500_000), PRICE_PRECISION_EXP);
price.print();        // "150.5"
price.toFixed(2);     // "150.50"
price.toNotional();   // "$150.50"
price.toNum();        // 150.5
 
// Parse a user-entered string into the right precision
const size = BigNum.fromPrint("2.5", BASE_PRECISION_EXP);
size.toString();      // "2500000000"  (the raw BN, 1e9)

import {
  BN,
  activeSlotDurationFromState,
  millisFromSecs,
  millisToSlotsCeil,
  millisFromSlots,
  msToSlotsCeilNum,
  slotsToMsNum,
  SLOT_DURATION_BASELINE,
} from "@velocity-exchange/sdk";
 
const state = velocityClient.getStateAccount();
const currentSlot = new BN(await connection.getSlot());
 
// The slot length the program itself would use right now
const slotDuration = activeSlotDurationFromState(state, currentSlot);
 
// A 10 second window, expressed in actual slots
const tenSeconds = millisFromSecs(10);
const slots = millisToSlotsCeil(tenSeconds, slotDuration); // 25 slots at 400ms, 50 at 200ms
 
// A measured slot delta, back to wall-clock ms
const elapsedMs = millisFromSlots(new BN(20), slotDuration);
 
// Plain-number variants for pacing and thresholds
const auctionSlots = msToSlotsCeilNum(8_000, slotDuration);
const auctionMs = slotsToMsNum(auctionSlots, slotDuration);
 
console.log(SLOT_DURATION_BASELINE); // 400, the pre-gate baseline

import { getTokenAmount, SpotBalanceType, convertToNumber } from "@velocity-exchange/sdk";
 
const spotMarket = velocityClient.getSpotMarketAccount(0); // e.g. dUSDT on devnet, USDT on mainnet
const user = velocityClient.getUser();
const spotPosition = user.getUserAccount().spotPositions[0];
 
const tokenAmount = getTokenAmount(
  spotPosition.scaledBalance,
  spotMarket,
  spotPosition.balanceType
);
console.log("Token amount:", tokenAmount.toString());

import { getTokenAmount, getSignedTokenAmount } from "@velocity-exchange/sdk";
 
const spotMarket = velocityClient.getSpotMarketAccount(0);
const spotPosition = velocityClient.getUser().getUserAccount().spotPositions[0];
 
const tokenAmount = getTokenAmount(
  spotPosition.scaledBalance,
  spotMarket,
  spotPosition.balanceType
);
const signed = getSignedTokenAmount(tokenAmount, spotPosition.balanceType);
// signed > 0 means deposit, signed < 0 means borrow
console.log("Signed amount:", signed.toString());