Solana Inner Instructions and Token Balance Decoding for Bot Developers

Why top-level instructions are insufficient for understanding Solana swaps and wallet activity.

Top-level limits

Aggregators invoke multiple programs through CPI, so the economic transfer often appears only in inner instructions and balance deltas.

Account resolution

Resolve versioned transaction address lookup tables and map token accounts back to owners and mints.

Net effects

Compare pre/post SOL and token balances, then subtract fees and temporary wrapped-SOL movements.

Decoder strategy

Use protocol-specific parsers when available but keep a generic balance-delta fallback and preserve raw unknown events.

See Solana copytrading bots and indexer development.