Knowledge base for Solana transaction interpretation. Use when working with the transaction system — parsing Helius Enhanced Transactions, understanding balance changes, tax categorization, the parseWalletHistoryTx pipeline, or debugging transaction display issues.
This skill provides context for working with the transaction parsing and display pipeline in this project. See helius-enhanced-tx-api.md for the full Helius API reference and parsing-pipeline.md for how raw API data is transformed into our internal types.
Helius Enhanced Tx API (v0)
→ HeliusWalletHistoryTx (src/types/api.ts)
→ parseWalletHistoryTx() (src/lib/taxCategorizer.ts)
→ ParsedTransaction (src/types/transaction.ts)
→ stored in PostgreSQL `transactions` table
→ displayed in TransactionsPage / TaxSummaryPage
src/types/api.ts — Helius API response types (HeliusWalletHistoryTx, HeliusAccountData, etc.)src/types/transaction.ts — Internal types (ParsedTransaction, BalanceChange, InterpretedFlow, TaxCategory)src/types/groups.ts — Group types (TransactionGroup, GroupMember, GroupMemberInput, GroupMemberships)src/lib/taxCategorizer.ts — parseWalletHistoryTx(), categorize(), interpretTransaction(), isSolMint(), stakingRewardsToTransactions()src/lib/txSummary.ts — Display helpers: resolveSymbol(), formatAmount(), summarizeChanges(), summarizeSwap(), summarizeTx() — used by TransactionsPage and GroupsPage for rendering transaction summariessrc/lib/groupSummary.ts — aggregateBalances() — aggregates balance changes across group memberssrc/lib/groups.ts — computeUsdValues() — fetches historical prices and computes USD inflow/outflow per transactionsrc/lib/helius.ts — API client, fetches raw transactions from Heliussrc/hooks/useTransactions.ts — React hook managing fetch/cache lifecyclesrc/lib/storage.ts — PostgreSQL CRUD for transactions and groupsserver/routes/transactions.ts — Backend API routes for transactionsserver/routes/groups.ts — Backend API routes for transaction groupsTRADE, TRANSFER_IN, TRANSFER_OUT, STAKING_REWARD, NFT_SALE, NFT_BUY, AIRDROP, BURN, FEE, OTHER, STAKE_DELEGATE, STAKE_DEACTIVATE, STAKE_WITHDRAW