keynesol-shared 1.0.0

package/src/utils/tokenUtils.ts

@@ -0,0 +1,75 @@
+/**
+ * Token Utilities
+ * Helper functions for handling SOL and SPL tokens
+ */
+import { PublicKey, SystemProgram, LAMPORTS_PER_SOL } from '@solana/web3.js';
+import { TOKEN_PROGRAM_ID, NATIVE_MINT } from '@solana/spl-token';
+
+// SOL native mint (System Program)
+export const SOL_MINT = SystemProgram.programId;
+
+// USDC devnet mint
+export const USDC_DEVNET_MINT = new PublicKey('EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v');
+
+// USDC mainnet mint
+export const USDC_MAINNET_MINT = new PublicKey('EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v');
+
+/**
+ * Check if a token mint is native SOL
+ */
+export function isNativeSOL(tokenMint: PublicKey | string): boolean {
+  const mint = typeof tokenMint === 'string' ? new PublicKey(tokenMint) : tokenMint;
+  // Native SOL uses SystemProgram
+  // We can also check against NATIVE_MINT (wrapped SOL)
+  return mint.equals(SOL_MINT) || mint.equals(NATIVE_MINT);
+}
+
+/**
+ * Check if a token mint is USDC
+ */
+export function isUSDC(tokenMint: PublicKey | string): boolean {
+  const mint = typeof tokenMint === 'string' ? new PublicKey(tokenMint) : tokenMint;
+  return mint.equals(USDC_DEVNET_MINT) || mint.equals(USDC_MAINNET_MINT);
+}
+
+/**
+ * Get token name from mint
+ */
+export function getTokenName(tokenMint: PublicKey | string): string {
+  if (isNativeSOL(tokenMint)) {
+    return 'SOL';
+  }
+  if (isUSDC(tokenMint)) {
+    return 'USDC';
+  }
+  return 'Token';
+}
+
+/**
+ * Get token decimals
+ */
+export function getTokenDecimals(tokenMint: PublicKey | string): number {
+  if (isNativeSOL(tokenMint)) {
+    return 9; // SOL has 9 decimals
+  }
+  if (isUSDC(tokenMint)) {
+    return 6; // USDC has 6 decimals
+  }
+  return 9; // Default to 9
+}
+
+/**
+ * Convert amount to lamports based on token type
+ */
+export function toLamports(amount: number, tokenMint: PublicKey | string): number {
+  const decimals = getTokenDecimals(tokenMint);
+  return Math.floor(amount * Math.pow(10, decimals));
+}
+
+/**
+ * Convert lamports to amount based on token type
+ */
+export function fromLamports(lamports: number, tokenMint: PublicKey | string): number {
+  const decimals = getTokenDecimals(tokenMint);
+  return lamports / Math.pow(10, decimals);
+}

package/src/utils/validation.ts

@@ -0,0 +1,107 @@
+/**
+ * Validation Utilities
+ * Centralized validation functions for user inputs
+ */
+
+import { PublicKey } from '@solana/web3.js';
+
+export interface ValidationResult {
+  valid: boolean;
+  error?: string;
+  number?: number;
+}
+
+/**
+ * Validate and parse numeric input
+ */
+export function validateNumericInput(input: string): ValidationResult {
+  if (!input || input.trim() === '') {
+    return { valid: false, error: 'Please enter an amount' };
+  }
+
+  const trimmed = input.trim();
+  const number = parseFloat(trimmed);
+
+  if (isNaN(number)) {
+    return { valid: false, error: 'Please enter a valid number' };
+  }
+
+  if (number <= 0) {
+    return { valid: false, error: 'Amount must be greater than 0' };
+  }
+
+  if (!isFinite(number)) {
+    return { valid: false, error: 'Amount must be a finite number' };
+  }
+
+  return { valid: true, number };
+}
+
+/**
+ * Validate stake amount
+ */
+export function validateStakeAmount(amount: number, balance: number, minStake: number = 0): ValidationResult {
+  if (isNaN(amount) || amount <= 0) {
+    return { valid: false, error: 'Amount must be greater than 0' };
+  }
+
+  if (amount < minStake) {
+    return { valid: false, error: `Minimum stake amount is ${minStake}` };
+  }
+
+  if (amount > balance) {
+    return { valid: false, error: 'Insufficient balance' };
+  }
+
+  return { valid: true };
+}
+
+/**
+ * Validate unstake amount
+ */
+export function validateUnstakeAmount(amount: number, stakedAmount: number): ValidationResult {
+  if (isNaN(amount) || amount <= 0) {
+    return { valid: false, error: 'Amount must be greater than 0' };
+  }
+
+  if (amount > stakedAmount) {
+    return { valid: false, error: 'Insufficient staked balance' };
+  }
+
+  return { valid: true };
+}
+
+/**
+ * Validate PublicKey
+ */
+export function validatePublicKey(address: string | PublicKey): ValidationResult {
+  try {
+    const pubkey = typeof address === 'string' ? new PublicKey(address) : address;
+    // PublicKey constructor will throw if invalid
+    return { valid: true };
+  } catch (error) {
+    return { valid: false, error: 'Invalid public key address' };
+  }
+}
+
+/**
+ * Validate vault ID
+ */
+export function validateVaultId(vaultId: number): ValidationResult {
+  if (!Number.isInteger(vaultId) || vaultId <= 0) {
+    return { valid: false, error: 'Invalid vault ID' };
+  }
+
+  return { valid: true };
+}
+
+/**
+ * Validate percentage (0-100)
+ */
+export function validatePercentage(value: number): ValidationResult {
+  if (isNaN(value) || value < 0 || value > 100) {
+    return { valid: false, error: 'Percentage must be between 0 and 100' };
+  }
+
+  return { valid: true };
+}