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

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

Import crate

Add to your Cargo.toml:

[dependencies]
substreams-solana-idls = { git = "https://github.com/pinax-network/substreams-solana-idls", tag = "v1.0.0" }

Module Layout

substreams_solana_idls::
├── <protocol>::PROGRAM_ID        // Program ID constant
├── <protocol>::instructions      // Instruction enum + `unpack(&[u8])`
├── <protocol>::accounts          // Account structs + `get_*_accounts`
└── <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 module under src/<protocol>/ with instructions.rs, events.rs, and mod.rs.
• Register the module in src/lib.rs.
• Follow existing modules for structure & doc style.
• Keep dependencies minimal (borsh, solana_program only).

PRs and issues welcome!