sol-parser-sdk-python 0.4.4__tar.gz → 0.5.5__tar.gz

sol_parser_sdk_python-0.5.5/PKG-INFO

@@ -0,0 +1,307 @@
+Metadata-Version: 2.4
+Name: sol-parser-sdk-python
+Version: 0.5.5
+Summary: Solana DEX program log parsing (pure Python, API aligned with sol-parser-sdk)
+Requires-Python: >=3.10
+Requires-Dist: base58>=2.0
+Requires-Dist: grpcio-tools>=1.64.0
+Requires-Dist: grpcio>=1.64.0
+Requires-Dist: python-dotenv>=1.0.0
+Provides-Extra: dev
+Requires-Dist: pytest-benchmark>=4.0; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Provides-Extra: shredstream
+Requires-Dist: solders>=0.21.0; extra == 'shredstream'
+Description-Content-Type: text/markdown
+
+<div align="center">
+    <h1>⚡ Sol Parser SDK - Python</h1>
+    <h3><em>High-performance Solana DEX event parser for Python</em></h3>
+</div>
+
+<p align="center">
+    <strong>High-performance Python library for parsing Solana DEX events in real-time via Yellowstone gRPC</strong>
+</p>
+
+<p align="center">
+    <a href="https://pypi.org/project/sol-parser-sdk-python/">
+        <img src="https://img.shields.io/pypi/v/sol-parser-sdk-python.svg" alt="PyPI">
+    </a>
+    <a href="https://github.com/0xfnzero/sol-parser-sdk-python/blob/main/LICENSE">
+        <img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="License">
+    </a>
+</p>
+
+<p align="center">
+    <img src="https://img.shields.io/badge/Python-3776AB?style=for-the-badge&logo=python&logoColor=white" alt="Python">
+    <img src="https://img.shields.io/badge/Solana-9945FF?style=for-the-badge&logo=solana&logoColor=white" alt="Solana">
+    <img src="https://img.shields.io/badge/gRPC-4285F4?style=for-the-badge&logo=grpc&logoColor=white" alt="gRPC">
+</p>
+
+<p align="center">
+    <a href="./README_CN.md">中文</a> |
+    <a href="./README.md">English</a> |
+    <a href="https://fnzero.dev/">Website</a> |
+    <a href="https://t.me/fnzero_group">Telegram</a> |
+    <a href="https://discord.gg/vuazbGkqQE">Discord</a>
+</p>
+
+> ☕ **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 | [sol-parser-sdk-golang](https://github.com/0xfnzero/sol-parser-sdk-golang) |
+
+---
+
+## Release notes
+
+### v0.5.5
+
+- Aligns ShredStream parsing with Rust/Node.js/Go for low-latency static-account paths.
+- 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.
+- Fixes Pump.fun ShredStream create/create_v2 fallback to use instruction-order accounts.
+- Improves Pump.fun v2 short-account parsing, event-type filtering, and multi-protocol routing parity.
+
+---
+
+## How to use
+
+### 1. Install
+
+**From PyPI**
+
+```bash
+pip install sol-parser-sdk-python==0.5.5
+```
+
+**From source**
+
+```bash
+git clone https://github.com/0xfnzero/sol-parser-sdk-python
+cd sol-parser-sdk-python
+pip install -e .
+pip install grpcio grpcio-tools protobuf base58 python-dotenv
+```
+
+### 2. Environment (Yellowstone gRPC examples)
+
+At the **package root** (next to `pyproject.toml`):
+
+```bash
+cp .env.example .env
+# Set GRPC_URL (or GRPC_ENDPOINT) and GRPC_AUTH_TOKEN or GRPC_TOKEN
+```
+
+Run examples from that directory so `.env` is picked up (same idea as the Node.js package).
+
+**CLI overrides:** `--grpc-url` / `-g`, `--grpc-token` / `--token` (also `--grpc-url=https://host:443`). **Rust-compatible names:** `GRPC_AUTH_TOKEN` (same as [sol-parser-sdk](https://github.com/0xfnzero/sol-parser-sdk) examples), `GRPC_ENDPOINT` (alias for URL). **Legacy env:** `GEYSER_ENDPOINT` / `GEYSER_API_TOKEN`. **Precedence:** CLI > `GRPC_URL` / `GRPC_ENDPOINT` > `GEYSER_*` > defaults; token: CLI > `GRPC_AUTH_TOKEN` > `GRPC_TOKEN` > `GEYSER_API_TOKEN`. Explicit shell `export` wins over `.env`; `python-dotenv` does not overwrite existing variables.
+
+Helpers: `sol_parser.env_config` (`parse_grpc_credentials`, `require_grpc_env`, `parse_shredstream_url`, …), re-exported from `sol_parser`.
+
+### 3. Smoke test
+
+```bash
+python examples/pumpfun_quick_test.py
+```
+
+Requires `GRPC_URL` (or `GRPC_ENDPOINT`) and (for most providers) `GRPC_AUTH_TOKEN` or `GRPC_TOKEN` in `.env` or the environment. You can pass credentials on the command line instead; see step 2.
+
+### 4. Minimal gRPC subscribe + parse
+
+```python
+import asyncio
+import os
+
+import base58
+
+from sol_parser import parse_logs_only
+from sol_parser.grpc_client import YellowstoneGrpc
+from sol_parser.grpc_types import Protocol, SubscribeCallbacks, transaction_filter_for_protocols
+
+async def main():
+    endpoint = (
+        os.environ.get("GRPC_URL", "").strip()
+        or os.environ.get("GRPC_ENDPOINT", "").strip()
+        or os.environ.get("GEYSER_ENDPOINT", "solana-yellowstone-grpc.publicnode.com:443")
+    )
+    token = (
+        os.environ.get("GRPC_AUTH_TOKEN", "").strip()
+        or os.environ.get("GRPC_TOKEN", "").strip()
+        or os.environ.get("GEYSER_API_TOKEN", "")
+    )
+
+    client = YellowstoneGrpc(endpoint)
+    if token:
+        client.set_x_token(token)
+    await client.connect()
+
+    filter_ = transaction_filter_for_protocols([Protocol.PUMP_FUN, Protocol.PUMP_SWAP])
+    filter_.vote = False
+    filter_.failed = False
+
+    def on_update(update):
+        if update.transaction is None or update.transaction.transaction is None:
+            return
+        tx_info = update.transaction.transaction
+        slot = update.transaction.slot
+        logs = tx_info.log_messages
+        if not logs:
+            return
+        sb = bytes(tx_info.signature) if tx_info.signature else b""
+        sig = base58.b58encode(sb).decode("ascii") if len(sb) == 64 else ""
+        events = parse_logs_only(
+            logs, sig, slot, None, subscribe_tx_info=tx_info
+        )  # tx_info from gRPC update — fills accounts from instruction keys
+        for ev in events:
+            print(ev)
+
+    sub = await client.subscribe_transactions(
+        filter_,
+        SubscribeCallbacks(on_update=on_update, on_error=print, on_end=lambda: None),
+    )
+    print("subscribed", sub.id)
+
+    try:
+        await asyncio.Event().wait()
+    except KeyboardInterrupt:
+        pass
+    await client.disconnect()
+
+asyncio.run(main())
+```
+
+**Lighter path:** `parse_logs_only(logs, …)` only needs log messages from the update (no full wire transaction).
+
+### 5. ShredStream (HTTP — not Yellowstone gRPC)
+
+Python includes a native ShredStream client (`ShredStreamClient`, `ShredStreamConfig`) plus the same env/CLI helpers as Node (`parse_shredstream_url`: `SHREDSTREAM_URL` / `SHRED_URL`, `--url` / `-u` / `--endpoint=`). Install the optional extra with `pip install 'sol-parser-sdk-python[shredstream]'`. ShredStream uses its own endpoint, **not** `GRPC_URL`.
+
+The Python ShredStream 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 the Yellowstone/RPC paths.
+
+---
+
+## Examples
+
+From the **package root** after `pip install -e .`. Run with `python examples/<file>.py`. Scripts are written to mirror the **output layout and env names** of [sol-parser-sdk/examples](https://github.com/0xfnzero/sol-parser-sdk/tree/main/examples) (Rust); streaming uses `subscribe_transactions` + `parse_logs_only` with the same program IDs as `TransactionFilter::for_protocols` in Rust.
+
+| Description | Run command | Source |
+|-------------|-------------|--------|
+| **PumpFun** | | |
+| PumpFun trade filtering | `python examples/pumpfun_trade_filter.py` | [pumpfun_trade_filter.py](https://github.com/0xfnzero/sol-parser-sdk-python/blob/main/examples/pumpfun_trade_filter.py) |
+| PumpFun events + metrics | `python examples/pumpfun_with_metrics.py` | [pumpfun_with_metrics.py](https://github.com/0xfnzero/sol-parser-sdk-python/blob/main/examples/pumpfun_with_metrics.py) |
+| Quick PumpFun connection test | `python examples/pumpfun_quick_test.py` | [pumpfun_quick_test.py](https://github.com/0xfnzero/sol-parser-sdk-python/blob/main/examples/pumpfun_quick_test.py) |
+| **PumpSwap** | | |
+| PumpSwap ultra-low latency | `python examples/pumpswap_low_latency.py` | [pumpswap_low_latency.py](https://github.com/0xfnzero/sol-parser-sdk-python/blob/main/examples/pumpswap_low_latency.py) |
+| PumpSwap events + metrics | `python examples/pumpswap_with_metrics.py` | [pumpswap_with_metrics.py](https://github.com/0xfnzero/sol-parser-sdk-python/blob/main/examples/pumpswap_with_metrics.py) |
+| **Meteora DAMM** | | |
+| Meteora DAMM V2 events | `python examples/meteora_damm_grpc.py` | [meteora_damm_grpc.py](https://github.com/0xfnzero/sol-parser-sdk-python/blob/main/examples/meteora_damm_grpc.py) |
+| **Multi-protocol** | | |
+| Subscribe to every program in Rust `Protocol` / `program_ids` | `python examples/multi_protocol_grpc.py` | [multi_protocol_grpc.py](https://github.com/0xfnzero/sol-parser-sdk-python/blob/main/examples/multi_protocol_grpc.py) |
+| **Utility** | | |
+| Parse tx by signature (HTTP RPC; not gRPC). `TX_SIGNATURE` / `RPC_URL` or `SOLANA_RPC_URL` in `.env` or `--sig` / `--rpc`. | `python examples/parse_tx_by_signature.py` | [parse_tx_by_signature.py](https://github.com/0xfnzero/sol-parser-sdk-python/blob/main/examples/parse_tx_by_signature.py) |
+
+**Env:** gRPC examples need **`GRPC_URL`** or **`GRPC_ENDPOINT`**, plus **`GRPC_AUTH_TOKEN`** or **`GRPC_TOKEN`** (or legacy `GEYSER_*`). See **`.env.example`**.
+
+---
+
+## Protocols
+
+PumpFun, PumpSwap, Raydium AMM V4 / CLMM / CPMM, Orca Whirlpool, Meteora DAMM V2 / DLMM, Raydium LaunchLab (see `sol_parser/`).
+
+---
+
+## Useful exports
+
+- `parse_logs_only` — log-based DEX events from gRPC log messages.
+- `format_dex_event_json` / `dex_event_to_jsonable` — pretty-print `DexEvent` as indented JSON (one field per line); `repr(ev)` is the default dataclass single-line form, not JSON.
+- `YellowstoneGrpc` — async Yellowstone gRPC client (`connect`, `subscribe_transactions`, `disconnect`).
+- `now_micros` — microsecond clock (same role as Rust `sol_parser_sdk::core::now_micros`).
+- `transaction_filter_for_protocols` / `program_ids_for_protocols` / `account_filter_for_protocols` — same program IDs as Rust `Protocol` + `for_protocols` in `grpc/filter.rs`.
+- `parse_grpc_credentials` / `require_grpc_env` — load `.env` + env + CLI (aligned with [sol-parser-sdk-nodejs](https://github.com/0xfnzero/sol-parser-sdk-nodejs) `grpc_env`).
+
+---
+
+## Advanced
+
+### Custom gRPC endpoint
+
+```python
+import os
+
+from sol_parser.grpc_client import YellowstoneGrpc
+
+endpoint = os.environ.get("GRPC_URL") or os.environ.get("GRPC_ENDPOINT") or os.environ.get(
+    "GEYSER_ENDPOINT", "solana-yellowstone-grpc.publicnode.com:443"
+)
+token = (
+    os.environ.get("GRPC_AUTH_TOKEN")
+    or os.environ.get("GRPC_TOKEN")
+    or os.environ.get("GEYSER_API_TOKEN", "")
+)
+client = YellowstoneGrpc(endpoint)
+if token:
+    client.set_x_token(token)
+```
+
+### Create + buy detection
+
+`parse_logs_only` can detect create-and-buy patterns from program logs; see the PumpFun examples.
+
+---
+
+## Project structure
+
+```
+sol-parser-sdk-python/
+├── sol_parser/
+│   ├── grpc_client.py          # YellowstoneGrpc (async connect / subscribe)
+│   ├── env_config.py           # GRPC_URL, .env, CLI helpers (Node parity)
+│   ├── clock.py                # now_micros()
+│   ├── grpc_types.py           # TransactionFilter, SubscribeCallbacks, for_protocols helpers, …
+│   ├── parser.py               # parse_logs_only, …
+│   ├── geyser_pb2.py           # Generated proto (Yellowstone)
+│   └── …
+├── examples/
+│   ├── pumpfun_trade_filter.py
+│   ├── pumpfun_quick_test.py
+│   └── …
+├── .env.example
+└── pyproject.toml
+```
+
+---
+
+## Development
+
+```bash
+pip install -e ".[dev]"
+pytest tests/
+```
+
+---
+
+## License
+
+MIT — https://github.com/0xfnzero/sol-parser-sdk-python
+
+---
+
+## Contact
+
+- **Repository**: https://github.com/0xfnzero/sol-parser-sdk-python  
+- **Website**: https://fnzero.dev/  
+- **Telegram**: https://t.me/fnzero_group  
+- **Discord**: https://discord.gg/vuazbGkqQE  

{sol_parser_sdk_python-0.4.4 → sol_parser_sdk_python-0.5.5}/README.md

@@ -49,6 +49,18 @@
 
 ---
 
+## Release notes
+
+### v0.5.5
+
+- Aligns ShredStream parsing with Rust/Node.js/Go for low-latency static-account paths.
+- 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.
+- Fixes Pump.fun ShredStream create/create_v2 fallback to use instruction-order accounts.
+- Improves Pump.fun v2 short-account parsing, event-type filtering, and multi-protocol routing parity.
+
+---
+
 ## How to use
 
 ### 1. Install
@@ -56,7 +68,7 @@
 **From PyPI**
 
 ```bash
-pip install sol-parser-sdk-python
+pip install sol-parser-sdk-python==0.5.5
 ```
 
 **From source**
@@ -159,7 +171,9 @@ asyncio.run(main())
 
 ### 5. ShredStream (HTTP — not Yellowstone gRPC)
 
-The Node.js SDK includes a ShredStream HTTP client. **Python** provides the same env/CLI helpers as Node (`parse_shredstream_url`: `SHREDSTREAM_URL` / `SHRED_URL`, `--url` / `-u` / `--endpoint=`) for configuration parity; a native ShredStream client may be added later. **Not** `GRPC_URL`.
+Python includes a native ShredStream client (`ShredStreamClient`, `ShredStreamConfig`) plus the same env/CLI helpers as Node (`parse_shredstream_url`: `SHREDSTREAM_URL` / `SHRED_URL`, `--url` / `-u` / `--endpoint=`). Install the optional extra with `pip install 'sol-parser-sdk-python[shredstream]'`. ShredStream uses its own endpoint, **not** `GRPC_URL`.
+
+The Python ShredStream 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 the Yellowstone/RPC paths.
 
 ---
 
@@ -189,7 +203,7 @@ From the **package root** after `pip install -e .`. Run with `python examples/<f
 
 ## Protocols
 
-PumpFun, PumpSwap, Raydium AMM V4 / CLMM / CPMM, Orca Whirlpool, Meteora DAMM V2 / DLMM, Bonk Launchpad (see `sol_parser/`).
+PumpFun, PumpSwap, Raydium AMM V4 / CLMM / CPMM, Orca Whirlpool, Meteora DAMM V2 / DLMM, Raydium LaunchLab (see `sol_parser/`).
 
 ---
 

{sol_parser_sdk_python-0.4.4 → sol_parser_sdk_python-0.5.5}/README_CN.md

@@ -49,6 +49,18 @@
 
 ---
 
+## 发布说明
+
+### v0.5.5
+
+- ShredStream 低延迟静态账户路径与 Rust/Node.js/Go 对齐。
+- V0 ALT-loaded 指令账户不再整条跳过，而是用默认 pubkey 占位继续 best-effort 解析。
+- 当 ShredStream 外层 program id 来自 ALT 时，按 discriminator 做候选 program id fallback。
+- 修复 Pump.fun ShredStream create/create_v2 fallback，确保按 instruction-order 账户解析。
+- 改进 Pump.fun v2 短账户解析、事件类型过滤和多协议路由一致性。
+
+---
+
 ## 怎么用
 
 ### 1. 安装
@@ -56,7 +68,7 @@
 **PyPI**
 
 ```bash
-pip install sol-parser-sdk-python
+pip install sol-parser-sdk-python==0.5.5
 ```
 
 **源码**
@@ -159,7 +171,9 @@ asyncio.run(main())
 
 ### 5. ShredStream（HTTP，不是 Yellowstone gRPC）
 
-Node 版提供 ShredStream HTTP 客户端。**Python** 侧提供与 Node 相同的配置方式（`parse_shredstream_url`：`SHREDSTREAM_URL` / `SHRED_URL`，`--url` / `-u` / `--endpoint=`）；原生 ShredStream 客户端后续可能补充。**不要**用 `GRPC_URL` 配 ShredStream。
+Python 已提供原生 ShredStream 客户端（`ShredStreamClient`、`ShredStreamConfig`），并保留与 Node 相同的配置方式（`parse_shredstream_url`：`SHREDSTREAM_URL` / `SHRED_URL`，`--url` / `-u` / `--endpoint=`）。安装可选依赖：`pip install 'sol-parser-sdk-python[shredstream]'`。ShredStream 使用独立端点，**不要**用 `GRPC_URL`。
+
+Python ShredStream 热路径只使用静态账户表。V0 ALT-loaded 指令账户会用默认 pubkey 占位，外层 program id 若来自 ALT 会按 discriminator best-effort 解析。Inner CPI / 仅日志事件仍需 Yellowstone/RPC 路径。
 
 ---
 
@@ -189,7 +203,7 @@ Node 版提供 ShredStream HTTP 客户端。**Python** 侧提供与 Node 相同
 
 ## 协议
 
-PumpFun、PumpSwap、Raydium AMM V4 / CLMM / CPMM、Orca Whirlpool、Meteora DAMM V2 / DLMM、Bonk Launchpad（见 `sol_parser/`）。
+PumpFun、PumpSwap、Raydium AMM V4 / CLMM / CPMM、Orca Whirlpool、Meteora DAMM V2 / DLMM、Raydium LaunchLab（见 `sol_parser/`）。
 
 ---
 

sol_parser_sdk_python-0.5.5/examples/meteora_damm_grpc.py

@@ -0,0 +1,145 @@
+#!/usr/bin/env python3
+"""Meteora DAMM gRPC — latest ``subscribe_dex_events`` queue API.
+
+Run: ``python examples/meteora_damm_grpc.py``
+"""
+
+from __future__ import annotations
+
+import asyncio
+import os
+import sys
+
+sys.path.insert(0, os.path.join(os.path.dirname(__file__), ".."))
+
+from sol_parser import now_micros
+from sol_parser.env_config import load_dotenv_silent, parse_grpc_credentials
+from sol_parser.event_types import DexEvent
+from sol_parser.grpc_client import YellowstoneGrpc
+from sol_parser.grpc_types import (
+    ClientConfig,
+    EventType,
+    OrderMode,
+    Protocol,
+    event_type_filter_include_only,
+    transaction_filter_for_protocols,
+)
+
+event_count = 0
+swap_count = 0
+add_liquidity_count = 0
+remove_liquidity_count = 0
+create_position_count = 0
+close_position_count = 0
+
+
+def _metadata(ev: DexEvent):
+    return getattr(ev.data, "metadata", None) if ev.data is not None else None
+
+
+def _latency_us(ev: DexEvent) -> int:
+    meta = _metadata(ev)
+    grpc_recv_us = int(getattr(meta, "grpc_recv_us", 0) or 0) if meta else 0
+    return max(0, now_micros() - grpc_recv_us) if grpc_recv_us else 0
+
+
+async def main() -> None:
+    global event_count, swap_count, add_liquidity_count, remove_liquidity_count
+    global create_position_count, close_position_count
+
+    load_dotenv_silent()
+    endpoint, token = parse_grpc_credentials(
+        sys.argv[1:],
+        default_endpoint="solana-yellowstone-grpc.publicnode.com:443",
+    )
+
+    print("🚀 Meteora DAMM gRPC Streaming Example")
+    print("========================================\n")
+
+    config = ClientConfig.default()
+    config.enable_metrics = True
+    config.connection_timeout_ms = 10000
+    config.request_timeout_ms = 30000
+    config.enable_tls = True
+    config.order_mode = OrderMode.UNORDERED
+
+    client = YellowstoneGrpc.new_with_config(endpoint, token or None, config)
+    protocols = [Protocol.METEORA_DAMM_V2]
+    print(f"📊 Protocols: {[p.value for p in protocols]}")
+
+    tx_filter = transaction_filter_for_protocols(protocols)
+    tx_filter.vote = False
+    tx_filter.failed = False
+    event_filter = event_type_filter_include_only(
+        [
+            EventType.METEORA_DAMM_V2_SWAP,
+            EventType.METEORA_DAMM_V2_ADD_LIQUIDITY,
+            EventType.METEORA_DAMM_V2_REMOVE_LIQUIDITY,
+            EventType.METEORA_DAMM_V2_CREATE_POSITION,
+            EventType.METEORA_DAMM_V2_CLOSE_POSITION,
+        ]
+    )
+
+    queue: asyncio.Queue[DexEvent] = await client.subscribe_dex_events(
+        [tx_filter],
+        [],
+        event_filter,
+    )
+
+    print("🎯 Event Filter: Swap, AddLiquidity, RemoveLiquidity, CreatePosition, ClosePosition")
+    print("🛑 Press Ctrl+C to stop...\n")
+
+    try:
+        while True:
+            ev = await queue.get()
+            if not isinstance(ev, DexEvent) or ev.data is None:
+                continue
+            event_count += 1
+            d = ev.data
+            meta = _metadata(ev)
+            sig = getattr(meta, "signature", "") if meta else ""
+            slot = int(getattr(meta, "slot", 0) or 0) if meta else 0
+            latency_us = _latency_us(ev)
+
+            if ev.type == EventType.METEORA_DAMM_V2_SWAP:
+                swap_count += 1
+                direction = "A->B" if getattr(d, "trade_direction", 0) == 0 else "B->A"
+                print("┌─────────────────────────────────────────────────────────────")
+                print(f"│ 🔄 Meteora DAMM SWAP (V2) #{event_count}")
+                print("├─────────────────────────────────────────────────────────────")
+                print(f"│ Signature  : {sig}")
+                print(f"│ Slot       : {slot}")
+                print("├─────────────────────────────────────────────────────────────")
+                print(f"│ Pool       : {getattr(d, 'pool', '')}")
+                print(f"│ Direction  : {direction}")
+                print(f"│ Amount In  : {getattr(d, 'amount_in', 0)}")
+                print(f"│ Actual Out : {getattr(d, 'output_amount', 0)}")
+                print(f"│ Protocol   : {getattr(d, 'protocol_fee', 0)}")
+                print("├─────────────────────────────────────────────────────────────")
+                print(f"│ 📊 Latency : {latency_us} μs")
+                print(
+                    f"│ 📊 Stats   : Swap={swap_count} AddLiq={add_liquidity_count} RemLiq={remove_liquidity_count}"
+                )
+                print("└─────────────────────────────────────────────────────────────\n")
+            elif ev.type == EventType.METEORA_DAMM_V2_ADD_LIQUIDITY:
+                add_liquidity_count += 1
+                print(f"➕ ADD_LIQUIDITY #{add_liquidity_count} sig={sig} slot={slot} latency={latency_us}μs")
+            elif ev.type == EventType.METEORA_DAMM_V2_REMOVE_LIQUIDITY:
+                remove_liquidity_count += 1
+                print(f"➖ REMOVE_LIQUIDITY #{remove_liquidity_count} sig={sig} slot={slot} latency={latency_us}μs")
+            elif ev.type == EventType.METEORA_DAMM_V2_CREATE_POSITION:
+                create_position_count += 1
+                print(f"📌 CREATE_POSITION #{create_position_count} sig={sig} slot={slot} latency={latency_us}μs")
+            elif ev.type == EventType.METEORA_DAMM_V2_CLOSE_POSITION:
+                close_position_count += 1
+                print(f"❌ CLOSE_POSITION #{close_position_count} sig={sig} slot={slot} latency={latency_us}μs")
+    finally:
+        await client.disconnect()
+        print("\n👋 Shutting down gracefully...")
+
+
+if __name__ == "__main__":
+    try:
+        asyncio.run(main())
+    except KeyboardInterrupt:
+        pass

{sol_parser_sdk_python-0.4.4 → sol_parser_sdk_python-0.5.5}/examples/multi_protocol_grpc.py

@@ -10,18 +10,17 @@ import asyncio
 import os
 import sys
 
-import base58
-
 sys.path.insert(0, os.path.join(os.path.dirname(__file__), ".."))
 
-from sol_parser import format_dex_event_json, parse_logs_only
+from sol_parser import format_dex_event_json
 from sol_parser.env_config import load_dotenv_silent, parse_grpc_credentials
 from sol_parser.event_types import DexEvent
 from sol_parser.grpc_client import YellowstoneGrpc
 from sol_parser.grpc_types import (
     ClientConfig,
+    OrderMode,
     Protocol,
-    SubscribeCallbacks,
+    account_filter_for_protocols,
     transaction_filter_for_protocols,
 )
 
@@ -29,7 +28,7 @@ from sol_parser.grpc_types import (
 PROTOCOLS = [
     Protocol.PUMP_FUN,
     Protocol.PUMP_SWAP,
-    Protocol.BONK,
+    Protocol.RAYDIUM_LAUNCHLAB,
     Protocol.RAYDIUM_CPMM,
     Protocol.RAYDIUM_CLMM,
     Protocol.RAYDIUM_AMM_V4,
@@ -64,50 +63,32 @@ async def main() -> None:
 
     cfg = ClientConfig.default()
     cfg.enable_metrics = True
+    cfg.order_mode = OrderMode.UNORDERED
     client = YellowstoneGrpc.new_with_config(endpoint, token or None, cfg)
 
-    await client.connect()
     asyncio.create_task(stats_reporter())
 
-    def on_update(update):
-        if update.transaction is None or update.transaction.transaction is None:
-            return
-        tx_info = update.transaction.transaction
-        slot = update.transaction.slot
-        logs = tx_info.log_messages
-        if not logs:
-            return
-
-        sb = bytes(tx_info.signature) if tx_info.signature else b""
-        sig_b58 = base58.b58encode(sb).decode("ascii") if len(sb) == 64 else ""
-
-        for ev in parse_logs_only(
-            logs, sig_b58, slot, None, subscribe_tx_info=tx_info
-        ):
-            if not isinstance(ev, DexEvent):
-                continue
-            key = str(ev.type.value)
-            stats[key] = stats.get(key, 0) + 1
-            print(format_dex_event_json(ev))
-
     tx_filter = transaction_filter_for_protocols(PROTOCOLS)
     tx_filter.vote = False
     tx_filter.failed = False
+    account_filter = account_filter_for_protocols(PROTOCOLS)
 
-    await client.subscribe_transactions(
-        tx_filter,
-        SubscribeCallbacks(
-            on_update=on_update,
-            on_error=lambda e: print(f"Stream error: {e}", file=sys.stderr),
-            on_end=lambda: print("Stream ended"),
-        ),
+    queue: asyncio.Queue[DexEvent] = await client.subscribe_dex_events(
+        [tx_filter],
+        [account_filter],
     )
 
     print(f"✅ Subscribed")
     print("🛑 Press Ctrl+C to stop...\n")
 
     try:
-        await asyncio.Event().wait()
+        while True:
+            ev = await queue.get()
+            if not isinstance(ev, DexEvent):
+                continue
+            key = str(ev.type.value)
+            stats[key] = stats.get(key, 0) + 1
+            print(format_dex_event_json(ev))
     except KeyboardInterrupt:
         pass
     finally:
@@ -118,4 +99,4 @@ async def main() -> None:
 
 
 if __name__ == "__main__":
-    asyncio.run(main())
+    asyncio.run(main())