@straton/utils 1.1.2

package/dist/index.d.mts

@@ -0,0 +1,237 @@
+import { ClassValue } from 'clsx';
+import { z } from 'zod';
+
+/**
+ * Utility function to merge Tailwind CSS classes with clsx
+ */
+declare function cn(...inputs: ClassValue[]): string;
+
+/**
+ * Format a number as currency
+ */
+declare function formatCurrency(value: number, currency?: string, locale?: string): string;
+/**
+ * Format a number as percentage
+ */
+declare function formatPercentage(value: number, decimals?: number): string;
+/**
+ * Format a bigint token amount with decimals
+ */
+declare function formatTokenAmount(amount: bigint, decimals: number, displayDecimals?: number): string;
+/**
+ * Format an address for display (truncated)
+ */
+declare function formatAddress(address: string, chars?: number): string;
+/**
+ * Format a date relative to now
+ */
+declare function formatRelativeTime(date: Date, locale?: string): string;
+/**
+ * Format APY for display
+ */
+declare function formatAPY(apy: number): string;
+/**
+ * Format large numbers with abbreviations
+ */
+declare function formatCompactNumber(value: number, locale?: string): string;
+
+/**
+ * Ethereum address validation
+ */
+declare const addressSchema: z.ZodString;
+/**
+ * Transaction hash validation
+ */
+declare const txHashSchema: z.ZodString;
+/**
+ * UUID validation
+ */
+declare const uuidSchema: z.ZodString;
+/**
+ * Email validation
+ */
+declare const emailSchema: z.ZodString;
+/**
+ * Brazilian CPF validation
+ */
+declare const cpfSchema: z.ZodString;
+/**
+ * Brazilian CNPJ validation
+ */
+declare const cnpjSchema: z.ZodString;
+/**
+ * Positive number validation
+ */
+declare const positiveNumberSchema: z.ZodNumber;
+/**
+ * BigInt string validation (for token amounts)
+ */
+declare const bigIntStringSchema: z.ZodString;
+/**
+ * ISO country code validation
+ */
+declare const countryCodeSchema: z.ZodString;
+/**
+ * Pagination params schema
+ */
+declare const paginationSchema: z.ZodObject<{
+    page: z.ZodDefault<z.ZodNumber>;
+    perPage: z.ZodDefault<z.ZodNumber>;
+    sortBy: z.ZodOptional<z.ZodString>;
+    sortOrder: z.ZodDefault<z.ZodEnum<["asc", "desc"]>>;
+}, "strip", z.ZodTypeAny, {
+    page: number;
+    perPage: number;
+    sortOrder: "asc" | "desc";
+    sortBy?: string | undefined;
+}, {
+    page?: number | undefined;
+    perPage?: number | undefined;
+    sortBy?: string | undefined;
+    sortOrder?: "asc" | "desc" | undefined;
+}>;
+type PaginationParams = z.infer<typeof paginationSchema>;
+
+/**
+ * Supported chain IDs
+ */
+declare const CHAIN_IDS: {
+    readonly ETHEREUM: 1;
+    readonly ETHEREUM_SEPOLIA: 11155111;
+    readonly POLYGON: 137;
+    readonly ARBITRUM: 42161;
+    readonly AVALANCHE: 43114;
+    readonly AVALANCHE_FUJI: 43113;
+    readonly BASE: 8453;
+    readonly POLYGON_AMOY: 80002;
+    readonly ARBITRUM_SEPOLIA: 421614;
+    readonly BASE_SEPOLIA: 84532;
+};
+/**
+ * Chain names
+ */
+declare const CHAIN_NAMES: Record<number, string>;
+/**
+ * Chain metadata for multi-chain support
+ */
+declare const CHAIN_METADATA: Record<number, {
+    isEvm: boolean;
+    isTestnet: boolean;
+    explorerUrl: string;
+    nativeCurrency: string;
+}>;
+/**
+ * Token decimals
+ */
+declare const TOKEN_DECIMALS: {
+    readonly DEFAULT: 18;
+    readonly USDC: 6;
+    readonly USDT: 6;
+};
+/**
+ * Common token addresses (mainnet)
+ */
+declare const TOKEN_ADDRESSES: {
+    readonly USDC: {
+        readonly 1: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48";
+        readonly 137: "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359";
+        readonly 42161: "0xaf88d065e77c8cC2239327C5EDb3A432268e5831";
+        readonly 8453: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913";
+    };
+};
+/**
+ * Risk parameters by asset type
+ */
+declare const RISK_PARAMETERS: {
+    readonly REAL_ESTATE: {
+        readonly maxLTV: 0.7;
+        readonly liquidationThreshold: 0.8;
+        readonly interestBase: 0.12;
+    };
+    readonly CREDIT: {
+        readonly maxLTV: 0.6;
+        readonly liquidationThreshold: 0.75;
+        readonly interestBase: 0.15;
+    };
+    readonly COMMODITY: {
+        readonly maxLTV: 0.5;
+        readonly liquidationThreshold: 0.65;
+        readonly interestBase: 0.18;
+    };
+    readonly EQUITY: {
+        readonly maxLTV: 0.5;
+        readonly liquidationThreshold: 0.65;
+        readonly interestBase: 0.16;
+    };
+};
+/**
+ * KYC status labels
+ */
+declare const KYC_STATUS_LABELS: {
+    readonly PENDING: "Pendente";
+    readonly IN_REVIEW: "Em análise";
+    readonly VERIFIED: "Verificado";
+    readonly REJECTED: "Rejeitado";
+    readonly EXPIRED: "Expirado";
+};
+/**
+ * Accreditation level labels
+ */
+declare const ACCREDITATION_LABELS: {
+    readonly RETAIL: "Varejo";
+    readonly QUALIFIED: "Qualificado";
+    readonly PROFESSIONAL: "Profissional";
+};
+/**
+ * Asset type labels
+ */
+declare const ASSET_TYPE_LABELS: {
+    readonly REAL_ESTATE: "Imobiliário";
+    readonly CREDIT: "Crédito";
+    readonly COMMODITY: "Commodity";
+    readonly EQUITY: "Equity";
+};
+
+/**
+ * Sleep for a given number of milliseconds
+ */
+declare function sleep(ms: number): Promise<void>;
+/**
+ * Retry a function with exponential backoff
+ */
+declare function retry<T>(fn: () => Promise<T>, options?: {
+    maxRetries?: number;
+    initialDelay?: number;
+    maxDelay?: number;
+    backoffFactor?: number;
+}): Promise<T>;
+/**
+ * Check if a value is defined (not null or undefined)
+ */
+declare function isDefined<T>(value: T | null | undefined): value is T;
+/**
+ * Create a debounced function
+ */
+declare function debounce<T extends (...args: unknown[]) => unknown>(fn: T, delay: number): (...args: Parameters<T>) => void;
+/**
+ * Create a throttled function
+ */
+declare function throttle<T extends (...args: unknown[]) => unknown>(fn: T, limit: number): (...args: Parameters<T>) => void;
+/**
+ * Parse a bigint from various input types
+ */
+declare function parseBigInt(value: string | number | bigint): bigint;
+/**
+ * Calculate percentage change
+ */
+declare function percentageChange(oldValue: number, newValue: number): number;
+/**
+ * Chunk an array into smaller arrays
+ */
+declare function chunk<T>(array: T[], size: number): T[][];
+/**
+ * Generate a unique ID
+ */
+declare function generateId(): string;
+
+export { ACCREDITATION_LABELS, ASSET_TYPE_LABELS, CHAIN_IDS, CHAIN_METADATA, CHAIN_NAMES, KYC_STATUS_LABELS, type PaginationParams, RISK_PARAMETERS, TOKEN_ADDRESSES, TOKEN_DECIMALS, addressSchema, bigIntStringSchema, chunk, cn, cnpjSchema, countryCodeSchema, cpfSchema, debounce, emailSchema, formatAPY, formatAddress, formatCompactNumber, formatCurrency, formatPercentage, formatRelativeTime, formatTokenAmount, generateId, isDefined, paginationSchema, parseBigInt, percentageChange, positiveNumberSchema, retry, sleep, throttle, txHashSchema, uuidSchema };

package/dist/index.d.ts

@@ -0,0 +1,237 @@
+import { ClassValue } from 'clsx';
+import { z } from 'zod';
+
+/**
+ * Utility function to merge Tailwind CSS classes with clsx
+ */
+declare function cn(...inputs: ClassValue[]): string;
+
+/**
+ * Format a number as currency
+ */
+declare function formatCurrency(value: number, currency?: string, locale?: string): string;
+/**
+ * Format a number as percentage
+ */
+declare function formatPercentage(value: number, decimals?: number): string;
+/**
+ * Format a bigint token amount with decimals
+ */
+declare function formatTokenAmount(amount: bigint, decimals: number, displayDecimals?: number): string;
+/**
+ * Format an address for display (truncated)
+ */
+declare function formatAddress(address: string, chars?: number): string;
+/**
+ * Format a date relative to now
+ */
+declare function formatRelativeTime(date: Date, locale?: string): string;
+/**
+ * Format APY for display
+ */
+declare function formatAPY(apy: number): string;
+/**
+ * Format large numbers with abbreviations
+ */
+declare function formatCompactNumber(value: number, locale?: string): string;
+
+/**
+ * Ethereum address validation
+ */
+declare const addressSchema: z.ZodString;
+/**
+ * Transaction hash validation
+ */
+declare const txHashSchema: z.ZodString;
+/**
+ * UUID validation
+ */
+declare const uuidSchema: z.ZodString;
+/**
+ * Email validation
+ */
+declare const emailSchema: z.ZodString;
+/**
+ * Brazilian CPF validation
+ */
+declare const cpfSchema: z.ZodString;
+/**
+ * Brazilian CNPJ validation
+ */
+declare const cnpjSchema: z.ZodString;
+/**
+ * Positive number validation
+ */
+declare const positiveNumberSchema: z.ZodNumber;
+/**
+ * BigInt string validation (for token amounts)
+ */
+declare const bigIntStringSchema: z.ZodString;
+/**
+ * ISO country code validation
+ */
+declare const countryCodeSchema: z.ZodString;
+/**
+ * Pagination params schema
+ */
+declare const paginationSchema: z.ZodObject<{
+    page: z.ZodDefault<z.ZodNumber>;
+    perPage: z.ZodDefault<z.ZodNumber>;
+    sortBy: z.ZodOptional<z.ZodString>;
+    sortOrder: z.ZodDefault<z.ZodEnum<["asc", "desc"]>>;
+}, "strip", z.ZodTypeAny, {
+    page: number;
+    perPage: number;
+    sortOrder: "asc" | "desc";
+    sortBy?: string | undefined;
+}, {
+    page?: number | undefined;
+    perPage?: number | undefined;
+    sortBy?: string | undefined;
+    sortOrder?: "asc" | "desc" | undefined;
+}>;
+type PaginationParams = z.infer<typeof paginationSchema>;
+
+/**
+ * Supported chain IDs
+ */
+declare const CHAIN_IDS: {
+    readonly ETHEREUM: 1;
+    readonly ETHEREUM_SEPOLIA: 11155111;
+    readonly POLYGON: 137;
+    readonly ARBITRUM: 42161;
+    readonly AVALANCHE: 43114;
+    readonly AVALANCHE_FUJI: 43113;
+    readonly BASE: 8453;
+    readonly POLYGON_AMOY: 80002;
+    readonly ARBITRUM_SEPOLIA: 421614;
+    readonly BASE_SEPOLIA: 84532;
+};
+/**
+ * Chain names
+ */
+declare const CHAIN_NAMES: Record<number, string>;
+/**
+ * Chain metadata for multi-chain support
+ */
+declare const CHAIN_METADATA: Record<number, {
+    isEvm: boolean;
+    isTestnet: boolean;
+    explorerUrl: string;
+    nativeCurrency: string;
+}>;
+/**
+ * Token decimals
+ */
+declare const TOKEN_DECIMALS: {
+    readonly DEFAULT: 18;
+    readonly USDC: 6;
+    readonly USDT: 6;
+};
+/**
+ * Common token addresses (mainnet)
+ */
+declare const TOKEN_ADDRESSES: {
+    readonly USDC: {
+        readonly 1: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48";
+        readonly 137: "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359";
+        readonly 42161: "0xaf88d065e77c8cC2239327C5EDb3A432268e5831";
+        readonly 8453: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913";
+    };
+};
+/**
+ * Risk parameters by asset type
+ */
+declare const RISK_PARAMETERS: {
+    readonly REAL_ESTATE: {
+        readonly maxLTV: 0.7;
+        readonly liquidationThreshold: 0.8;
+        readonly interestBase: 0.12;
+    };
+    readonly CREDIT: {
+        readonly maxLTV: 0.6;
+        readonly liquidationThreshold: 0.75;
+        readonly interestBase: 0.15;
+    };
+    readonly COMMODITY: {
+        readonly maxLTV: 0.5;
+        readonly liquidationThreshold: 0.65;
+        readonly interestBase: 0.18;
+    };
+    readonly EQUITY: {
+        readonly maxLTV: 0.5;
+        readonly liquidationThreshold: 0.65;
+        readonly interestBase: 0.16;
+    };
+};
+/**
+ * KYC status labels
+ */
+declare const KYC_STATUS_LABELS: {
+    readonly PENDING: "Pendente";
+    readonly IN_REVIEW: "Em análise";
+    readonly VERIFIED: "Verificado";
+    readonly REJECTED: "Rejeitado";
+    readonly EXPIRED: "Expirado";
+};
+/**
+ * Accreditation level labels
+ */
+declare const ACCREDITATION_LABELS: {
+    readonly RETAIL: "Varejo";
+    readonly QUALIFIED: "Qualificado";
+    readonly PROFESSIONAL: "Profissional";
+};
+/**
+ * Asset type labels
+ */
+declare const ASSET_TYPE_LABELS: {
+    readonly REAL_ESTATE: "Imobiliário";
+    readonly CREDIT: "Crédito";
+    readonly COMMODITY: "Commodity";
+    readonly EQUITY: "Equity";
+};
+
+/**
+ * Sleep for a given number of milliseconds
+ */
+declare function sleep(ms: number): Promise<void>;
+/**
+ * Retry a function with exponential backoff
+ */
+declare function retry<T>(fn: () => Promise<T>, options?: {
+    maxRetries?: number;
+    initialDelay?: number;
+    maxDelay?: number;
+    backoffFactor?: number;
+}): Promise<T>;
+/**
+ * Check if a value is defined (not null or undefined)
+ */
+declare function isDefined<T>(value: T | null | undefined): value is T;
+/**
+ * Create a debounced function
+ */
+declare function debounce<T extends (...args: unknown[]) => unknown>(fn: T, delay: number): (...args: Parameters<T>) => void;
+/**
+ * Create a throttled function
+ */
+declare function throttle<T extends (...args: unknown[]) => unknown>(fn: T, limit: number): (...args: Parameters<T>) => void;
+/**
+ * Parse a bigint from various input types
+ */
+declare function parseBigInt(value: string | number | bigint): bigint;
+/**
+ * Calculate percentage change
+ */
+declare function percentageChange(oldValue: number, newValue: number): number;
+/**
+ * Chunk an array into smaller arrays
+ */
+declare function chunk<T>(array: T[], size: number): T[][];
+/**
+ * Generate a unique ID
+ */
+declare function generateId(): string;
+
+export { ACCREDITATION_LABELS, ASSET_TYPE_LABELS, CHAIN_IDS, CHAIN_METADATA, CHAIN_NAMES, KYC_STATUS_LABELS, type PaginationParams, RISK_PARAMETERS, TOKEN_ADDRESSES, TOKEN_DECIMALS, addressSchema, bigIntStringSchema, chunk, cn, cnpjSchema, countryCodeSchema, cpfSchema, debounce, emailSchema, formatAPY, formatAddress, formatCompactNumber, formatCurrency, formatPercentage, formatRelativeTime, formatTokenAmount, generateId, isDefined, paginationSchema, parseBigInt, percentageChange, positiveNumberSchema, retry, sleep, throttle, txHashSchema, uuidSchema };

package/dist/index.js

@@ -0,0 +1,365 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  ACCREDITATION_LABELS: () => ACCREDITATION_LABELS,
+  ASSET_TYPE_LABELS: () => ASSET_TYPE_LABELS,
+  CHAIN_IDS: () => CHAIN_IDS,
+  CHAIN_METADATA: () => CHAIN_METADATA,
+  CHAIN_NAMES: () => CHAIN_NAMES,
+  KYC_STATUS_LABELS: () => KYC_STATUS_LABELS,
+  RISK_PARAMETERS: () => RISK_PARAMETERS,
+  TOKEN_ADDRESSES: () => TOKEN_ADDRESSES,
+  TOKEN_DECIMALS: () => TOKEN_DECIMALS,
+  addressSchema: () => addressSchema,
+  bigIntStringSchema: () => bigIntStringSchema,
+  chunk: () => chunk,
+  cn: () => cn,
+  cnpjSchema: () => cnpjSchema,
+  countryCodeSchema: () => countryCodeSchema,
+  cpfSchema: () => cpfSchema,
+  debounce: () => debounce,
+  emailSchema: () => emailSchema,
+  formatAPY: () => formatAPY,
+  formatAddress: () => formatAddress,
+  formatCompactNumber: () => formatCompactNumber,
+  formatCurrency: () => formatCurrency,
+  formatPercentage: () => formatPercentage,
+  formatRelativeTime: () => formatRelativeTime,
+  formatTokenAmount: () => formatTokenAmount,
+  generateId: () => generateId,
+  isDefined: () => isDefined,
+  paginationSchema: () => paginationSchema,
+  parseBigInt: () => parseBigInt,
+  percentageChange: () => percentageChange,
+  positiveNumberSchema: () => positiveNumberSchema,
+  retry: () => retry,
+  sleep: () => sleep,
+  throttle: () => throttle,
+  txHashSchema: () => txHashSchema,
+  uuidSchema: () => uuidSchema
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/cn.ts
+var import_clsx = require("clsx");
+var import_tailwind_merge = require("tailwind-merge");
+function cn(...inputs) {
+  return (0, import_tailwind_merge.twMerge)((0, import_clsx.clsx)(inputs));
+}
+
+// src/format.ts
+function formatCurrency(value, currency = "USD", locale = "en-US") {
+  return new Intl.NumberFormat(locale, {
+    style: "currency",
+    currency,
+    minimumFractionDigits: 2,
+    maximumFractionDigits: 2
+  }).format(value);
+}
+function formatPercentage(value, decimals = 2) {
+  return `${(value * 100).toFixed(decimals)}%`;
+}
+function formatTokenAmount(amount, decimals, displayDecimals = 4) {
+  const divisor = BigInt(10 ** decimals);
+  const integerPart = amount / divisor;
+  const fractionalPart = amount % divisor;
+  const fractionalStr = fractionalPart.toString().padStart(decimals, "0");
+  const displayFractional = fractionalStr.slice(0, displayDecimals);
+  return `${integerPart}.${displayFractional}`;
+}
+function formatAddress(address, chars = 4) {
+  if (address.length < chars * 2 + 2) return address;
+  return `${address.slice(0, chars + 2)}...${address.slice(-chars)}`;
+}
+function formatRelativeTime(date, locale = "en-US") {
+  const rtf = new Intl.RelativeTimeFormat(locale, { numeric: "auto" });
+  const diff = date.getTime() - Date.now();
+  const diffDays = Math.round(diff / (1e3 * 60 * 60 * 24));
+  if (Math.abs(diffDays) < 1) {
+    const diffHours = Math.round(diff / (1e3 * 60 * 60));
+    if (Math.abs(diffHours) < 1) {
+      const diffMinutes = Math.round(diff / (1e3 * 60));
+      return rtf.format(diffMinutes, "minute");
+    }
+    return rtf.format(diffHours, "hour");
+  }
+  if (Math.abs(diffDays) < 30) {
+    return rtf.format(diffDays, "day");
+  }
+  if (Math.abs(diffDays) < 365) {
+    return rtf.format(Math.round(diffDays / 30), "month");
+  }
+  return rtf.format(Math.round(diffDays / 365), "year");
+}
+function formatAPY(apy) {
+  return `${(apy * 100).toFixed(2)}% APY`;
+}
+function formatCompactNumber(value, locale = "en-US") {
+  return new Intl.NumberFormat(locale, {
+    notation: "compact",
+    compactDisplay: "short",
+    maximumFractionDigits: 2
+  }).format(value);
+}
+
+// src/validation.ts
+var import_zod = require("zod");
+var addressSchema = import_zod.z.string().regex(/^0x[a-fA-F0-9]{40}$/, "Invalid Ethereum address");
+var txHashSchema = import_zod.z.string().regex(/^0x[a-fA-F0-9]{64}$/, "Invalid transaction hash");
+var uuidSchema = import_zod.z.string().uuid();
+var emailSchema = import_zod.z.string().email();
+var cpfSchema = import_zod.z.string().regex(/^\d{3}\.\d{3}\.\d{3}-\d{2}$/, "Invalid CPF format");
+var cnpjSchema = import_zod.z.string().regex(/^\d{2}\.\d{3}\.\d{3}\/\d{4}-\d{2}$/, "Invalid CNPJ format");
+var positiveNumberSchema = import_zod.z.number().positive();
+var bigIntStringSchema = import_zod.z.string().regex(/^\d+$/, "Must be a valid integer string");
+var countryCodeSchema = import_zod.z.string().length(2).toUpperCase();
+var paginationSchema = import_zod.z.object({
+  page: import_zod.z.number().int().positive().default(1),
+  perPage: import_zod.z.number().int().positive().max(100).default(20),
+  sortBy: import_zod.z.string().optional(),
+  sortOrder: import_zod.z.enum(["asc", "desc"]).default("desc")
+});
+
+// src/constants.ts
+var CHAIN_IDS = {
+  ETHEREUM: 1,
+  ETHEREUM_SEPOLIA: 11155111,
+  POLYGON: 137,
+  ARBITRUM: 42161,
+  AVALANCHE: 43114,
+  AVALANCHE_FUJI: 43113,
+  BASE: 8453,
+  POLYGON_AMOY: 80002,
+  ARBITRUM_SEPOLIA: 421614,
+  BASE_SEPOLIA: 84532
+};
+var CHAIN_NAMES = {
+  [CHAIN_IDS.ETHEREUM]: "Ethereum",
+  [CHAIN_IDS.ETHEREUM_SEPOLIA]: "Ethereum Sepolia",
+  [CHAIN_IDS.POLYGON]: "Polygon",
+  [CHAIN_IDS.ARBITRUM]: "Arbitrum",
+  [CHAIN_IDS.AVALANCHE]: "Avalanche",
+  [CHAIN_IDS.AVALANCHE_FUJI]: "Avalanche Fuji",
+  [CHAIN_IDS.BASE]: "Base",
+  [CHAIN_IDS.POLYGON_AMOY]: "Polygon Amoy",
+  [CHAIN_IDS.ARBITRUM_SEPOLIA]: "Arbitrum Sepolia",
+  [CHAIN_IDS.BASE_SEPOLIA]: "Base Sepolia"
+};
+var CHAIN_METADATA = {
+  [CHAIN_IDS.ETHEREUM]: {
+    isEvm: true,
+    isTestnet: false,
+    explorerUrl: "https://etherscan.io",
+    nativeCurrency: "ETH"
+  },
+  [CHAIN_IDS.ETHEREUM_SEPOLIA]: {
+    isEvm: true,
+    isTestnet: true,
+    explorerUrl: "https://sepolia.etherscan.io",
+    nativeCurrency: "ETH"
+  },
+  [CHAIN_IDS.POLYGON]: {
+    isEvm: true,
+    isTestnet: false,
+    explorerUrl: "https://polygonscan.com",
+    nativeCurrency: "MATIC"
+  },
+  [CHAIN_IDS.ARBITRUM]: {
+    isEvm: true,
+    isTestnet: false,
+    explorerUrl: "https://arbiscan.io",
+    nativeCurrency: "ETH"
+  },
+  [CHAIN_IDS.AVALANCHE]: {
+    isEvm: true,
+    isTestnet: false,
+    explorerUrl: "https://snowtrace.io",
+    nativeCurrency: "AVAX"
+  },
+  [CHAIN_IDS.AVALANCHE_FUJI]: {
+    isEvm: true,
+    isTestnet: true,
+    explorerUrl: "https://testnet.snowtrace.io",
+    nativeCurrency: "AVAX"
+  },
+  [CHAIN_IDS.BASE]: {
+    isEvm: true,
+    isTestnet: false,
+    explorerUrl: "https://basescan.org",
+    nativeCurrency: "ETH"
+  },
+  [CHAIN_IDS.POLYGON_AMOY]: {
+    isEvm: true,
+    isTestnet: true,
+    explorerUrl: "https://amoy.polygonscan.com",
+    nativeCurrency: "MATIC"
+  },
+  [CHAIN_IDS.ARBITRUM_SEPOLIA]: {
+    isEvm: true,
+    isTestnet: true,
+    explorerUrl: "https://sepolia.arbiscan.io",
+    nativeCurrency: "ETH"
+  },
+  [CHAIN_IDS.BASE_SEPOLIA]: {
+    isEvm: true,
+    isTestnet: true,
+    explorerUrl: "https://sepolia.basescan.org",
+    nativeCurrency: "ETH"
+  }
+};
+var TOKEN_DECIMALS = {
+  DEFAULT: 18,
+  USDC: 6,
+  USDT: 6
+};
+var TOKEN_ADDRESSES = {
+  USDC: {
+    [CHAIN_IDS.ETHEREUM]: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
+    [CHAIN_IDS.POLYGON]: "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
+    [CHAIN_IDS.ARBITRUM]: "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
+    [CHAIN_IDS.BASE]: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
+  }
+};
+var RISK_PARAMETERS = {
+  REAL_ESTATE: { maxLTV: 0.7, liquidationThreshold: 0.8, interestBase: 0.12 },
+  CREDIT: { maxLTV: 0.6, liquidationThreshold: 0.75, interestBase: 0.15 },
+  COMMODITY: { maxLTV: 0.5, liquidationThreshold: 0.65, interestBase: 0.18 },
+  EQUITY: { maxLTV: 0.5, liquidationThreshold: 0.65, interestBase: 0.16 }
+};
+var KYC_STATUS_LABELS = {
+  PENDING: "Pendente",
+  IN_REVIEW: "Em an\xE1lise",
+  VERIFIED: "Verificado",
+  REJECTED: "Rejeitado",
+  EXPIRED: "Expirado"
+};
+var ACCREDITATION_LABELS = {
+  RETAIL: "Varejo",
+  QUALIFIED: "Qualificado",
+  PROFESSIONAL: "Profissional"
+};
+var ASSET_TYPE_LABELS = {
+  REAL_ESTATE: "Imobili\xE1rio",
+  CREDIT: "Cr\xE9dito",
+  COMMODITY: "Commodity",
+  EQUITY: "Equity"
+};
+
+// src/helpers.ts
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+async function retry(fn, options = {}) {
+  const { maxRetries = 3, initialDelay = 1e3, maxDelay = 1e4, backoffFactor = 2 } = options;
+  let lastError;
+  let delay = initialDelay;
+  for (let i = 0; i <= maxRetries; i++) {
+    try {
+      return await fn();
+    } catch (error) {
+      lastError = error;
+      if (i < maxRetries) {
+        await sleep(delay);
+        delay = Math.min(delay * backoffFactor, maxDelay);
+      }
+    }
+  }
+  throw lastError;
+}
+function isDefined(value) {
+  return value !== null && value !== void 0;
+}
+function debounce(fn, delay) {
+  let timeoutId;
+  return (...args) => {
+    clearTimeout(timeoutId);
+    timeoutId = setTimeout(() => fn(...args), delay);
+  };
+}
+function throttle(fn, limit) {
+  let inThrottle = false;
+  return (...args) => {
+    if (!inThrottle) {
+      fn(...args);
+      inThrottle = true;
+      setTimeout(() => inThrottle = false, limit);
+    }
+  };
+}
+function parseBigInt(value) {
+  if (typeof value === "bigint") return value;
+  if (typeof value === "number") return BigInt(Math.floor(value));
+  return BigInt(value);
+}
+function percentageChange(oldValue, newValue) {
+  if (oldValue === 0) return newValue > 0 ? 100 : 0;
+  return (newValue - oldValue) / oldValue * 100;
+}
+function chunk(array, size) {
+  const result = [];
+  for (let i = 0; i < array.length; i += size) {
+    result.push(array.slice(i, i + size));
+  }
+  return result;
+}
+function generateId() {
+  return `${Date.now().toString(36)}-${Math.random().toString(36).slice(2)}`;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ACCREDITATION_LABELS,
+  ASSET_TYPE_LABELS,
+  CHAIN_IDS,
+  CHAIN_METADATA,
+  CHAIN_NAMES,
+  KYC_STATUS_LABELS,
+  RISK_PARAMETERS,
+  TOKEN_ADDRESSES,
+  TOKEN_DECIMALS,
+  addressSchema,
+  bigIntStringSchema,
+  chunk,
+  cn,
+  cnpjSchema,
+  countryCodeSchema,
+  cpfSchema,
+  debounce,
+  emailSchema,
+  formatAPY,
+  formatAddress,
+  formatCompactNumber,
+  formatCurrency,
+  formatPercentage,
+  formatRelativeTime,
+  formatTokenAmount,
+  generateId,
+  isDefined,
+  paginationSchema,
+  parseBigInt,
+  percentageChange,
+  positiveNumberSchema,
+  retry,
+  sleep,
+  throttle,
+  txHashSchema,
+  uuidSchema
+});

package/dist/index.mjs

@@ -0,0 +1,303 @@
+// src/cn.ts
+import { clsx } from "clsx";
+import { twMerge } from "tailwind-merge";
+function cn(...inputs) {
+  return twMerge(clsx(inputs));
+}
+
+// src/format.ts
+function formatCurrency(value, currency = "USD", locale = "en-US") {
+  return new Intl.NumberFormat(locale, {
+    style: "currency",
+    currency,
+    minimumFractionDigits: 2,
+    maximumFractionDigits: 2
+  }).format(value);
+}
+function formatPercentage(value, decimals = 2) {
+  return `${(value * 100).toFixed(decimals)}%`;
+}
+function formatTokenAmount(amount, decimals, displayDecimals = 4) {
+  const divisor = BigInt(10 ** decimals);
+  const integerPart = amount / divisor;
+  const fractionalPart = amount % divisor;
+  const fractionalStr = fractionalPart.toString().padStart(decimals, "0");
+  const displayFractional = fractionalStr.slice(0, displayDecimals);
+  return `${integerPart}.${displayFractional}`;
+}
+function formatAddress(address, chars = 4) {
+  if (address.length < chars * 2 + 2) return address;
+  return `${address.slice(0, chars + 2)}...${address.slice(-chars)}`;
+}
+function formatRelativeTime(date, locale = "en-US") {
+  const rtf = new Intl.RelativeTimeFormat(locale, { numeric: "auto" });
+  const diff = date.getTime() - Date.now();
+  const diffDays = Math.round(diff / (1e3 * 60 * 60 * 24));
+  if (Math.abs(diffDays) < 1) {
+    const diffHours = Math.round(diff / (1e3 * 60 * 60));
+    if (Math.abs(diffHours) < 1) {
+      const diffMinutes = Math.round(diff / (1e3 * 60));
+      return rtf.format(diffMinutes, "minute");
+    }
+    return rtf.format(diffHours, "hour");
+  }
+  if (Math.abs(diffDays) < 30) {
+    return rtf.format(diffDays, "day");
+  }
+  if (Math.abs(diffDays) < 365) {
+    return rtf.format(Math.round(diffDays / 30), "month");
+  }
+  return rtf.format(Math.round(diffDays / 365), "year");
+}
+function formatAPY(apy) {
+  return `${(apy * 100).toFixed(2)}% APY`;
+}
+function formatCompactNumber(value, locale = "en-US") {
+  return new Intl.NumberFormat(locale, {
+    notation: "compact",
+    compactDisplay: "short",
+    maximumFractionDigits: 2
+  }).format(value);
+}
+
+// src/validation.ts
+import { z } from "zod";
+var addressSchema = z.string().regex(/^0x[a-fA-F0-9]{40}$/, "Invalid Ethereum address");
+var txHashSchema = z.string().regex(/^0x[a-fA-F0-9]{64}$/, "Invalid transaction hash");
+var uuidSchema = z.string().uuid();
+var emailSchema = z.string().email();
+var cpfSchema = z.string().regex(/^\d{3}\.\d{3}\.\d{3}-\d{2}$/, "Invalid CPF format");
+var cnpjSchema = z.string().regex(/^\d{2}\.\d{3}\.\d{3}\/\d{4}-\d{2}$/, "Invalid CNPJ format");
+var positiveNumberSchema = z.number().positive();
+var bigIntStringSchema = z.string().regex(/^\d+$/, "Must be a valid integer string");
+var countryCodeSchema = z.string().length(2).toUpperCase();
+var paginationSchema = z.object({
+  page: z.number().int().positive().default(1),
+  perPage: z.number().int().positive().max(100).default(20),
+  sortBy: z.string().optional(),
+  sortOrder: z.enum(["asc", "desc"]).default("desc")
+});
+
+// src/constants.ts
+var CHAIN_IDS = {
+  ETHEREUM: 1,
+  ETHEREUM_SEPOLIA: 11155111,
+  POLYGON: 137,
+  ARBITRUM: 42161,
+  AVALANCHE: 43114,
+  AVALANCHE_FUJI: 43113,
+  BASE: 8453,
+  POLYGON_AMOY: 80002,
+  ARBITRUM_SEPOLIA: 421614,
+  BASE_SEPOLIA: 84532
+};
+var CHAIN_NAMES = {
+  [CHAIN_IDS.ETHEREUM]: "Ethereum",
+  [CHAIN_IDS.ETHEREUM_SEPOLIA]: "Ethereum Sepolia",
+  [CHAIN_IDS.POLYGON]: "Polygon",
+  [CHAIN_IDS.ARBITRUM]: "Arbitrum",
+  [CHAIN_IDS.AVALANCHE]: "Avalanche",
+  [CHAIN_IDS.AVALANCHE_FUJI]: "Avalanche Fuji",
+  [CHAIN_IDS.BASE]: "Base",
+  [CHAIN_IDS.POLYGON_AMOY]: "Polygon Amoy",
+  [CHAIN_IDS.ARBITRUM_SEPOLIA]: "Arbitrum Sepolia",
+  [CHAIN_IDS.BASE_SEPOLIA]: "Base Sepolia"
+};
+var CHAIN_METADATA = {
+  [CHAIN_IDS.ETHEREUM]: {
+    isEvm: true,
+    isTestnet: false,
+    explorerUrl: "https://etherscan.io",
+    nativeCurrency: "ETH"
+  },
+  [CHAIN_IDS.ETHEREUM_SEPOLIA]: {
+    isEvm: true,
+    isTestnet: true,
+    explorerUrl: "https://sepolia.etherscan.io",
+    nativeCurrency: "ETH"
+  },
+  [CHAIN_IDS.POLYGON]: {
+    isEvm: true,
+    isTestnet: false,
+    explorerUrl: "https://polygonscan.com",
+    nativeCurrency: "MATIC"
+  },
+  [CHAIN_IDS.ARBITRUM]: {
+    isEvm: true,
+    isTestnet: false,
+    explorerUrl: "https://arbiscan.io",
+    nativeCurrency: "ETH"
+  },
+  [CHAIN_IDS.AVALANCHE]: {
+    isEvm: true,
+    isTestnet: false,
+    explorerUrl: "https://snowtrace.io",
+    nativeCurrency: "AVAX"
+  },
+  [CHAIN_IDS.AVALANCHE_FUJI]: {
+    isEvm: true,
+    isTestnet: true,
+    explorerUrl: "https://testnet.snowtrace.io",
+    nativeCurrency: "AVAX"
+  },
+  [CHAIN_IDS.BASE]: {
+    isEvm: true,
+    isTestnet: false,
+    explorerUrl: "https://basescan.org",
+    nativeCurrency: "ETH"
+  },
+  [CHAIN_IDS.POLYGON_AMOY]: {
+    isEvm: true,
+    isTestnet: true,
+    explorerUrl: "https://amoy.polygonscan.com",
+    nativeCurrency: "MATIC"
+  },
+  [CHAIN_IDS.ARBITRUM_SEPOLIA]: {
+    isEvm: true,
+    isTestnet: true,
+    explorerUrl: "https://sepolia.arbiscan.io",
+    nativeCurrency: "ETH"
+  },
+  [CHAIN_IDS.BASE_SEPOLIA]: {
+    isEvm: true,
+    isTestnet: true,
+    explorerUrl: "https://sepolia.basescan.org",
+    nativeCurrency: "ETH"
+  }
+};
+var TOKEN_DECIMALS = {
+  DEFAULT: 18,
+  USDC: 6,
+  USDT: 6
+};
+var TOKEN_ADDRESSES = {
+  USDC: {
+    [CHAIN_IDS.ETHEREUM]: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
+    [CHAIN_IDS.POLYGON]: "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
+    [CHAIN_IDS.ARBITRUM]: "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
+    [CHAIN_IDS.BASE]: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
+  }
+};
+var RISK_PARAMETERS = {
+  REAL_ESTATE: { maxLTV: 0.7, liquidationThreshold: 0.8, interestBase: 0.12 },
+  CREDIT: { maxLTV: 0.6, liquidationThreshold: 0.75, interestBase: 0.15 },
+  COMMODITY: { maxLTV: 0.5, liquidationThreshold: 0.65, interestBase: 0.18 },
+  EQUITY: { maxLTV: 0.5, liquidationThreshold: 0.65, interestBase: 0.16 }
+};
+var KYC_STATUS_LABELS = {
+  PENDING: "Pendente",
+  IN_REVIEW: "Em an\xE1lise",
+  VERIFIED: "Verificado",
+  REJECTED: "Rejeitado",
+  EXPIRED: "Expirado"
+};
+var ACCREDITATION_LABELS = {
+  RETAIL: "Varejo",
+  QUALIFIED: "Qualificado",
+  PROFESSIONAL: "Profissional"
+};
+var ASSET_TYPE_LABELS = {
+  REAL_ESTATE: "Imobili\xE1rio",
+  CREDIT: "Cr\xE9dito",
+  COMMODITY: "Commodity",
+  EQUITY: "Equity"
+};
+
+// src/helpers.ts
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+async function retry(fn, options = {}) {
+  const { maxRetries = 3, initialDelay = 1e3, maxDelay = 1e4, backoffFactor = 2 } = options;
+  let lastError;
+  let delay = initialDelay;
+  for (let i = 0; i <= maxRetries; i++) {
+    try {
+      return await fn();
+    } catch (error) {
+      lastError = error;
+      if (i < maxRetries) {
+        await sleep(delay);
+        delay = Math.min(delay * backoffFactor, maxDelay);
+      }
+    }
+  }
+  throw lastError;
+}
+function isDefined(value) {
+  return value !== null && value !== void 0;
+}
+function debounce(fn, delay) {
+  let timeoutId;
+  return (...args) => {
+    clearTimeout(timeoutId);
+    timeoutId = setTimeout(() => fn(...args), delay);
+  };
+}
+function throttle(fn, limit) {
+  let inThrottle = false;
+  return (...args) => {
+    if (!inThrottle) {
+      fn(...args);
+      inThrottle = true;
+      setTimeout(() => inThrottle = false, limit);
+    }
+  };
+}
+function parseBigInt(value) {
+  if (typeof value === "bigint") return value;
+  if (typeof value === "number") return BigInt(Math.floor(value));
+  return BigInt(value);
+}
+function percentageChange(oldValue, newValue) {
+  if (oldValue === 0) return newValue > 0 ? 100 : 0;
+  return (newValue - oldValue) / oldValue * 100;
+}
+function chunk(array, size) {
+  const result = [];
+  for (let i = 0; i < array.length; i += size) {
+    result.push(array.slice(i, i + size));
+  }
+  return result;
+}
+function generateId() {
+  return `${Date.now().toString(36)}-${Math.random().toString(36).slice(2)}`;
+}
+export {
+  ACCREDITATION_LABELS,
+  ASSET_TYPE_LABELS,
+  CHAIN_IDS,
+  CHAIN_METADATA,
+  CHAIN_NAMES,
+  KYC_STATUS_LABELS,
+  RISK_PARAMETERS,
+  TOKEN_ADDRESSES,
+  TOKEN_DECIMALS,
+  addressSchema,
+  bigIntStringSchema,
+  chunk,
+  cn,
+  cnpjSchema,
+  countryCodeSchema,
+  cpfSchema,
+  debounce,
+  emailSchema,
+  formatAPY,
+  formatAddress,
+  formatCompactNumber,
+  formatCurrency,
+  formatPercentage,
+  formatRelativeTime,
+  formatTokenAmount,
+  generateId,
+  isDefined,
+  paginationSchema,
+  parseBigInt,
+  percentageChange,
+  positiveNumberSchema,
+  retry,
+  sleep,
+  throttle,
+  txHashSchema,
+  uuidSchema
+};

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@straton/utils",
+  "version": "1.1.2",
+  "description": "Shared utilities for the Straton RWAFi platform",
+  "private": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Straton-Finance/Straton-Packages.git",
+    "directory": "packages/utils"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    },
+    "./*": {
+      "types": "./dist/*.d.ts",
+      "import": "./dist/*.mjs",
+      "require": "./dist/*.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "clsx": "^2.1.1",
+    "tailwind-merge": "^2.6.0",
+    "zod": "^3.24.1"
+  },
+  "devDependencies": {
+    "tsup": "^8.3.5",
+    "typescript": "^5.7.2",
+    "vitest": "^2.1.8"
+  },
+  "module": "./dist/index.mjs",
+  "scripts": {
+    "build": "tsup src/index.ts --format esm,cjs --dts",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run --passWithNoTests",
+    "clean": "rm -rf dist"
+  }
+}