https://github.com/0xfnzero/sol-parser-sdk-golang

High-performance Go library for parsing Solana DEX events in real-time via Yellowstone gRPC
https://github.com/0xfnzero/sol-parser-sdk-golang

bonk copy-trading-bot fnzero grpc jito letsbonk pumpfun pumpswap raydium raydium-launchlab raydium-launchpad shreds shredstream sniper streaming swqos yellowstone yellowstonegrpc yellowstonegrpc-golang

Last synced: 20 days ago
JSON representation

High-performance Go library for parsing Solana DEX events in real-time via Yellowstone gRPC

Host: GitHub
URL: https://github.com/0xfnzero/sol-parser-sdk-golang
Owner: 0xfnzero
Created: 2026-04-05T16:47:14.000Z (3 months ago)
Default Branch: main
Last Pushed: 2026-06-01T06:48:05.000Z (21 days ago)
Last Synced: 2026-06-01T08:24:25.623Z (21 days ago)
Topics: bonk, copy-trading-bot, fnzero, grpc, jito, letsbonk, pumpfun, pumpswap, raydium, raydium-launchlab, raydium-launchpad, shreds, shredstream, sniper, streaming, swqos, yellowstone, yellowstonegrpc, yellowstonegrpc-golang
Language: Go
Homepage: https://fnzero.dev
Size: 406 KB
Stars: 2
Watchers: 0
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.md

Awesome Lists containing this project

README

          


    ⚡ Sol Parser SDK - Go

    High-performance Solana DEX event parser for Go





    

    





    中文 |

    English |

    Website |

    Telegram |

    Discord



> ☕ **Support This Project**

>

> This SDK is completely free and open source. However, maintaining and continuously updating it requires significant AI computing resources and token consumption. If this SDK helps with your development, consider making a monthly SOL donation — any amount is appreciated and helps keep this project alive!

>

> **Donation Wallet:** `6oW7AXz1yRb57pYSxysuXnMs2aR1ha5rzGzReZ1MjPV8`

---

## Other language SDKs

| Language | Repository |

|----------|------------|

| Rust | [sol-parser-sdk](https://github.com/0xfnzero/sol-parser-sdk) |

| Node.js | [sol-parser-sdk-nodejs](https://github.com/0xfnzero/sol-parser-sdk-nodejs) |

| Python | [sol-parser-sdk-python](https://github.com/0xfnzero/sol-parser-sdk-python) |

| Go | [github.com/0xfnzero/sol-parser-sdk-golang](https://github.com/0xfnzero/sol-parser-sdk-golang) |

## Release notes

### v0.5.6

- Adds Meteora DBC log parsing with program-context routing and filter parity.

- Adds Raydium CLMM/CPMM and Orca account parsers.

- Preserves block transaction indexes in RPC and Geyser-to-RPC conversion.

- Skips ShredStream instruction parsing early for account-only or empty include-only filters.

- Tightens RPC log active-program tracking for low-latency parser correctness.

### v0.5.5

- Aligns ShredStream wire-transaction parsing with Rust/Node.js/Python.

- Uses default pubkey placeholders for V0 ALT-loaded instruction accounts instead of dropping the instruction.

- Adds discriminator fallback when the ShredStream outer program id is ALT-loaded.

- Improves Pump.fun v2 short-account parsing, same-transaction post-merge enrichment, and multi-protocol routing parity.

- Adds regression coverage for ShredStream ALT account and ALT program-id fallback.

---

## How to use

### 1. Install

This repo’s `go.mod` module path is **`github.com/0xfnzero/sol-parser-sdk-golang`** (see [`go.mod`](go.mod)). Examples import `github.com/0xfnzero/sol-parser-sdk-golang/solparser`.

**From source** (recommended)

```bash

git clone https://github.com/0xfnzero/sol-parser-sdk-golang

cd sol-parser-sdk-golang

go mod tidy

```

**Use in another module**

```bash

go get github.com/0xfnzero/sol-parser-sdk-golang@v0.5.6

```

(Or use `replace github.com/0xfnzero/sol-parser-sdk-golang => ../sol-parser-sdk-golang` for local development.)

### 2. Environment (examples)

**Yellowstone / Geyser gRPC** (all examples that subscribe over gRPC use the same two names):

| Variable | Meaning |

|----------|---------|

| **`GRPC_URL`** | Endpoint host or full URL (e.g. `https://solana-yellowstone-grpc.publicnode.com:443` or `host:443`). Parsed to `host:port` where needed. |

| **`GRPC_TOKEN`** | `x-token` (or empty if the node allows unauthenticated access). |

**ShredStream** (separate binary / HTTP-style endpoint — **not** the same as `GRPC_URL`):

| Variable | Meaning |

|----------|---------|

| **`SHRED_URL`** | e.g. `http://127.0.0.1:10800` (plain-text gRPC to ShredStream proxy). |

Optional ShredStream tuning: `SHRED_PARSE_DEX`, `SHRED_MAX_JSON_PER_ENTRY`, `SHRED_JSON_COMPACT`, `SHREDSTREAM_QUIET`, `SHRED_MAX_MSG` — see [examples/shredstream_entries.go](examples/shredstream_entries.go).

**RPC utility** [parse_tx_by_signature.go](examples/parse_tx_by_signature.go): `TX_SIGNATURE`, `RPC_URL`.

### 3. Smoke test

```bash

go test ./...

```

### 4. Full gRPC transaction parse (recommended)

Use **`ParseSubscribeTransaction`** (Geyser `SubscribeUpdateTransactionInfo` → RPC-shaped tx + meta) for **instruction accounts + Program data logs + merge + Pump fills**, aligned with Rust `parse_rpc_transaction` behavior.

```go

import "github.com/0xfnzero/sol-parser-sdk-golang/solparser" // module path: see go.mod

events, err := solparser.ParseSubscribeTransaction(slot, txInfo, nil, grpcRecvUs)

if err != nil {

    // handle

}

for _, ev := range events {

    // ev.Type, ev.Data — JSON via json.Marshal(ev)

}

```

**Lighter path:** `ParseLogOptimized` / logs-only helpers when you do not have full transaction + meta.

### 5. ShredStream (HTTP endpoint — not Yellowstone gRPC)

Uses **`SHRED_URL`** only (e.g. `http://127.0.0.1:10800`). This is **not** `GRPC_URL` (different service).

```bash

export SHRED_URL="http://127.0.0.1:10800"

go run examples/shredstream_entries.go

```

The example decodes `Entry.entries`, optionally parses outer instructions to **`DexEvent` JSON** via **`DexEventsFromShredTransactionWire`**. This hot path uses static account keys only; V0 ALT-loaded instruction accounts are represented with default pubkey placeholders, and ALT-loaded outer program ids are parsed best-effort by discriminator. Inner CPI/log-only events still require Yellowstone/RPC paths.

---

## Examples

Run from the **repository root** after `go mod tidy`. One row per source file (links point to GitHub `main`).

| Description | Run command | Source |

|-------------|-------------|--------|

| **PumpFun** | | |

| PumpFun `DexEvent` + metrics | `GRPC_URL=… GRPC_TOKEN=… go run examples/pumpfun_with_metrics.go` | [pumpfun_with_metrics.go](https://github.com/0xfnzero/sol-parser-sdk-golang/blob/main/examples/pumpfun_with_metrics.go) |

| PumpFun trade filter | `GRPC_URL=… GRPC_TOKEN=… go run examples/pumpfun_trade_filter.go` | [pumpfun_trade_filter.go](https://github.com/0xfnzero/sol-parser-sdk-golang/blob/main/examples/pumpfun_trade_filter.go) |

| Quick connection test | `GRPC_URL=… GRPC_TOKEN=… go run examples/pumpfun_quick_test.go` | [pumpfun_quick_test.go](https://github.com/0xfnzero/sol-parser-sdk-golang/blob/main/examples/pumpfun_quick_test.go) |

| **PumpSwap** | | |

| PumpSwap + metrics | `GRPC_URL=… GRPC_TOKEN=… go run examples/pumpswap_with_metrics.go` | [pumpswap_with_metrics.go](https://github.com/0xfnzero/sol-parser-sdk-golang/blob/main/examples/pumpswap_with_metrics.go) |

| Ultra-low latency | `GRPC_URL=… GRPC_TOKEN=… go run examples/pumpswap_low_latency.go` | [pumpswap_low_latency.go](https://github.com/0xfnzero/sol-parser-sdk-golang/blob/main/examples/pumpswap_low_latency.go) |

| **Meteora DAMM** | | |

| Meteora DAMM V2 | `GRPC_URL=… GRPC_TOKEN=… go run examples/meteora_damm_grpc.go` | [meteora_damm_grpc.go](https://github.com/0xfnzero/sol-parser-sdk-golang/blob/main/examples/meteora_damm_grpc.go) |

| **ShredStream** (see **step 5** above) | | |

| SubscribeEntries + decode + optional `DexEvent` JSON | `SHRED_URL=http://host:port go run examples/shredstream_entries.go` | [shredstream_entries.go](https://github.com/0xfnzero/sol-parser-sdk-golang/blob/main/examples/shredstream_entries.go) |

| **Yellowstone** | | |

| Geyser subscribe + `ParseSubscribeTransaction` | `GRPC_URL=… GRPC_TOKEN=… go run examples/yellowstone_grpc_parse.go` | [yellowstone_grpc_parse.go](https://github.com/0xfnzero/sol-parser-sdk-golang/blob/main/examples/yellowstone_grpc_parse.go) |

| **Multi-protocol** | | |

| All supported DEX programs | `GRPC_URL=… GRPC_TOKEN=… go run examples/multi_protocol_grpc.go` | [multi_protocol_grpc.go](https://github.com/0xfnzero/sol-parser-sdk-golang/blob/main/examples/multi_protocol_grpc.go) |

| **Utility** | | |

| Parse tx by signature (RPC, not gRPC stream) | `TX_SIGNATURE=… RPC_URL=… go run examples/parse_tx_by_signature.go` | [parse_tx_by_signature.go](https://github.com/0xfnzero/sol-parser-sdk-golang/blob/main/examples/parse_tx_by_signature.go) |

---

## Protocols

PumpFun, PumpSwap, Raydium AMM V4 / CLMM / CPMM, Orca Whirlpool, Meteora DAMM V2 / DLMM, Raydium LaunchLab (see `solparser/`).

---

## Useful exports

- **`ParseSubscribeTransaction`** — Geyser single-tx → `[]DexEvent` (instructions + logs + merge + Pump account fill).

- **`ParseRpcTransaction`** / **`ParseTransactionFromRpc`** — HTTP RPC JSON → events.

- **`ParseInstructionUnified`** / **`ParseInnerInstructionUnified`** — outer 8-byte / inner 16-byte discriminators.

- **`DexEventsFromShredTransactionWire`** — wire tx bytes → outer `ParseInstructionUnified` (Shred static keys + ALT best-effort fallback).

- **`DecodeGRPCEntry`** / **`DecodeEntriesBincode`** — ShredStream `Entry.entries` bytes → `DecodedTransaction` slices.

- **`DexEvent`** — `json.Marshal` for `{ "PumpSwapBuy": { … } }` style output.

---

## Development

```bash

go test ./...

go build ./...

go vet ./...

```

---

## License

MIT — https://github.com/0xfnzero/sol-parser-sdk-golang

ecosyste.ms

Data

Tools

Indexes

Applications

Experiments

Awesome

https://github.com/0xfnzero/sol-parser-sdk-golang

Awesome Lists containing this project

README

⚡ Sol Parser SDK - Go

High-performance Solana DEX event parser for Go