Substreams Solana IDLs

Type‑safe instruction & event decoders for any Solana program you want to index with Substreams.

This crate bundles thin, no_std‑friendly byte‑codecs that turn on‑chain instruction and event byte arrays into well‑typed Rust enums & structs, ready for use inside Substreams modules.

Protocol Coverage

Legend   ✅ done · 🚧 in progress · ❌ planned / help wanted

Want another program supported? Open an issue or PR with the program ID and IDL link.

Module Layout

substreams_solana_idls::
├── <protocol>::PROGRAM_ID        // Program ID constant
├── <protocol>::instructions      // Instruction enum + `unpack(&[u8])`
└── <protocol>::events            // Event enum + `unpack(&[u8])`

Every protocol lives in its own module so you only pull in what you need.

Quick Start (Pump.fun example)

use substreams_solana_idls::pumpfun;

#[substreams::handlers::map]
fn map_events(block: Block) -> Result<Events, Error> {
    for tx in block.transactions() {
        for ix in tx.walk_instructions() {
            // Fast path: ignore anything not coming from Pump.fun
            if ix.program() != pumpfun::PROGRAM_ID { continue; }

            match pumpfun::events::unpack(ix.data()) {
                pumpfun::events::PumpFunEvent::Trade(tr) => {
                    // …handle trade…
                }
                _ => {}
            }
        }
    }
    Ok(Default::default())
}

Swap pumpfun for any supported protocol and you get the same ergonomic API.

Contributing

• Add a new folder under src/<protocol> with instructions.rs, events.rs, and mod.rs.
• Follow existing modules for structure & doc style.
• Keep dependencies minimal (borsh, serde, solana_program only).

PRs and issues welcome!