npm install simpfor-fun-sdk

import { SimpforFunSDK } from 'simpfor-fun-sdk';

const sdk = new SimpforFunSDK();

// Authenticate
await sdk.sendVerificationCode('user@example.com');
const result = await sdk.verifyOtp('user@example.com', '123456');

// Get top traders
const traders = await sdk.fetchTopTraders();

// Start copy trading
const copyTrade = await sdk.createCopyTrade(
  result.data.user.uid,
  'trader-address',
  'your-wallet-address'
);

await sdk.sendVerificationCode(email: string)

const result = await sdk.verifyOtp(email: string, code: string)
// Returns: { data: { user: User } }

await sdk.privyLogin({
  privyAuthToken: string,
  privyEmail: string,
  referralCode?: string
})

// Get auth URL
const { url } = await sdk.googleLogin({ referralCode?: string })

// Handle callback
await sdk.googleCallback(code: string, state: string)

await sdk.createCopyTrade(
  userId: number,
  leaderAddress: string,
  followerAddress: string
)
// Returns: { data: { info: CopyTradeInfo } }

// Start copying trades
await sdk.runCopyTrade(userId: number, copyTradeId: number)

// Stop copying (with optional position close)
await sdk.stopCopyTrade(
  userId: number, 
  copyTradeId: number, 
  closePositions: boolean
)

// Remove copy trade entirely
await sdk.removeCopyTrade(userId: number, copyTradeId: number)

const result = await sdk.listCopyTrades(userId: number)
// Returns: { data: { infos: CopyTradeInfo[] } }

await sdk.getCopyTradeHistoryPnl(
  userId: number,
  walletAddress: string,
  sortByPnlDesc: boolean,
  pagination: { page: number, limit: number }
)

await sdk.getCopyTradeDetails(
  userId: number,
  copyTradeId: number,
  pagination: { page: number, limit: number }
)

await sdk.getCopyTradeTotalPnl(userId: number, walletAddress: string)
// Returns: { data: { pnl: number } }

const traders = await sdk.fetchTopTraders()
// Returns: Trader[]

await sdk.topTradersWithPeriod(
  sort: { field: string, order: 'asc' | 'desc' },
  pagination: { page: number, limit: number }
)

const categories = await sdk.smartTraders()
// Returns: {
//   topValueTrader: TraderInfo[],
//   topRoiTrader: TraderInfo[],
//   topPnlTrader: TraderInfo[],
//   topFollowValueTrader: TraderInfo[]
// }

await sdk.traderSnapshot(
  address: string, 
  period: '7d' | '30d' | '90d' | '180d'
)
// Returns comprehensive performance data

await sdk.traderOverview(address: string)
// Returns basic trader stats

await sdk.shareInfo(address: string, period: string)
// Returns formatted data for social sharing

await sdk.checkWallet(address: string)
// Returns: { isAvailable: boolean, message?: string, errorCode?: string }

await sdk.createKmsKey(address: string)
// Returns: { agentKmsAddress: string, kmsExpireTimestamp: number }

await sdk.activateKmsWallet(
  walletAddress: string,
  agentAddress: string,
  walletName: string,
  signRawAction: object,
  signature: string
)

const wallets = await sdk.walletList()
// Returns: { keys: KeyEntry[] }

await sdk.refreshAgentWallet(address: string)
// Returns new expiry timestamp

const feeInfo = await sdk.getBuilderFee()
// Returns: { builderAddress: string, builderFeeRate: string }

await sdk.bindBuilder(
  walletAddress: string,
  approveRequest: ApproveBuilderFeeRequest,
  signature: string
)

await sdk.getBridgeAddress(userId: number, walletAddress: string)
// Returns: { userBridgeAddress: string }

await sdk.listBridgeAddress(userId: number)
// Returns: { addresses: BridgeAddress[] }

await sdk.registerBridgeAddress(
  userId: number,
  permitRequest: PermitRequest
)

// Add to watchlist
await sdk.addWatchedTrader(address: string)

// Get watched traders
await sdk.getWatchedTraders(
  sort: { field: string, order: string },
  pagination: { page: number, limit: number }
)

// Remove from watchlist
await sdk.removeWatchedTrader(address: string)

await sdk.getReferralInfo()
// Returns referral stats and commissions

await sdk.getReferralList(
  filterId?: string,
  startTime?: string,
  endTime?: string,
  pagination: { page: number, limit: number }
)

await sdk.claimCommission(walletAddress: string)

await sdk.userCoupons(status: 'active' | 'used' | 'expired')

await sdk.claimCoupon(couponId: string, walletAddress: string)

await sdk.getSolanaAddresses()
// Returns: { address: string, linked: boolean }

// Get auth message
const authMsg = await sdk.getSolanaAuthMessage(address: string)

// Link address (after user signs message)
await sdk.linkSolanaAddress(
  address: string,
  message: string,
  signature: string
)

interface User {
  uid: number;
  email: string;
  referralCode: string;
  invitedByCode: string;
}

interface Trader {
  address: string;
  value: number;
  roi: number;
  pnl: number;
  apy: number;
  maxDrawdown: number;
  sharpeRatio: number;
  winRate: number;
  tradingVolume: number;
  followValue: number;
  watched: boolean;
  copying: boolean;
}

interface CopyTradeInfo {
  copyTradeId: number;
  active: boolean;
  description: string;
  followerAccount: string;
  leaderAccount: string;
  watched: boolean;
  createTime: string;
  updateTime: string;
}

interface ApiResponse<T> {
  code: number;
  message: string;
  data: T;
}

interface CreateCopyTradeReq {
  userId: number;
  leaderAccount: string;
  followerAccount: string;
}

interface ApproveBuilderFeeRequest {
  nonce: number;
  builder: number[];
  maxFeeRate: string;
  hyperliquidChain: string;
  signatureChainId: string;
}

interface PermitRequest {
  tokenAddress: string;
  userWalletAddress: string;
  userBridgeAddress: string;
  permitValue: string;
  permitDeadline: string;
  permitSig: string;
}

interface ApiError {
  code: number;
  message: string;
  data?: any;
}

try {
  const result = await sdk.someOperation();
  // Handle success
} catch (error: any) {
  switch (error.code) {
    case 400:
      console.error('Validation error:', error.message);
      break;
    case 401:
      console.error('Authentication required');
      // Redirect to login
      break;
    case 429:
      console.error('Rate limited - retry later');
      break;
    default:
      console.error('Unexpected error:', error);
  }
}

// Initialize with custom base URL
const sdk = new SimpforFunSDK('https://api.simpfor.fun');

// Access token is managed automatically after authentication
// But you can also set it manually if needed
sdk.accessToken = 'your-token';