state-diff-plugin

A Solana Geyser plugin that computes semantic, field-level diffs on account state changes and emits them as structured events.

Supported Programs

• SPL Token Program — Mint and Token account diffs (supply, authorities, balances)

Build

cargo build --release

The plugin compiles as a cdylib shared library for loading into a Solana validator.

Configuration

Create a config.json with the token program address:

{
  "token_program": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"
}

How It Works

1. Receives account updates from the validator via the Geyser plugin interface
2. Decodes raw account bytes into structured representations (Mint, Token)
3. Diffs against previously seen state
4. Emits change events with field-level diffs, slot, and transaction signature