Common Utilities Overview

import { NumLib } from '@drift-labs/common';

// Format notional dollar values
const formatted = NumLib.formatNum.toNotionalDisplay(1234.567);
// "$1,234.57"

// Convert to trade precision
const tradePrecision = NumLib.formatNum.toTradePrecision(0.123456789);
// 0.123457

// Format large numbers
const millified = NumLib.millify(1234567);
// { displayString: "1.23M", mantissa: 1000000, ... }

import { logger } from '@drift-labs/common';

logger.info('Processing transaction');
logger.error('Transaction failed');
logger.alert('Critical system alert'); // Sends to Slack if configured

import { getTokenAddress, createTokenAccountIx } from '@drift-labs/common';
import { PublicKey } from '@solana/web3.js';

// Get associated token address
const tokenAddress = await getTokenAddress(
  'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v', // USDC mint
  userPublicKey.toString()
);

// Create token account instruction
const createIx = await createTokenAccountIx(
  new PublicKey(userPublicKey),
  new PublicKey(mintAddress)
);

import { PriorityFeeCalculator } from '@drift-labs/common';

// Calculate dynamic compute unit price
const cuPrice = PriorityFeeCalculator.calculateDynamicCUPriceToUse({
  latestFeeSample: 5000,
  boostMultiplier: 1.5,
  extraMultiplier: 1.0
});

// Convert to SOL amount
const feeInSol = PriorityFeeCalculator.getPriorityFeeInSolForComputeUnitPrice(
  cuPrice,
  600_000 // compute units
);

import { MultiplexWebSocket } from '@drift-labs/common';

const { unsubscribe } = MultiplexWebSocket.createWebSocketSubscription({
  wsUrl: 'wss://api.example.com/ws',
  subscriptionId: 'my-subscription',
  subscribeMessage: JSON.stringify({ action: 'subscribe', channel: 'trades' }),
  unsubscribeMessage: JSON.stringify({ action: 'unsubscribe', channel: 'trades' }),
  onMessage: (message) => {
    console.log('Received:', message);
  },
  onError: (error) => {
    console.error('WebSocket error:', error);
  },
  enableHeartbeatMonitoring: true
});

// Later, unsubscribe
unsubscribe();

import {
  NumLib,
  logger,
  getTokenAddress,
  PriorityFeeCalculator,
  MultiplexWebSocket,
  COMMON_MATH
} from '@drift-labs/common';