sol-parser-sdk-python 0.4.5__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.5 → 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==0.4.5
+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.5 → 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==0.4.5
+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.4.5 → sol_parser_sdk_python-0.5.5}/examples/multi_protocol_grpc.py

@@ -28,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,

{sol_parser_sdk_python-0.4.5 → sol_parser_sdk_python-0.5.5}/pyproject.toml

@@ -1,7 +1,8 @@
 [project]
 name = "sol-parser-sdk-python"
-version = "0.4.5"
+version = "0.5.5"
 description = "Solana DEX program log parsing (pure Python, API aligned with sol-parser-sdk)"
+readme = "README.md"
 requires-python = ">=3.10"
 dependencies = [
     "base58>=2.0",

{sol_parser_sdk_python-0.4.5 → sol_parser_sdk_python-0.5.5}/sol_parser/__init__.py

@@ -16,6 +16,12 @@ from .parser import (
     warmup_parser,
 )
 from .clock import now_micros
+from .market import (
+    sqrt_price_x64_to_price,
+    vault_price_from_balances,
+    normalize_buy_sell_from_token_delta,
+    normalize_buy_sell_from_input_mint,
+)
 from .grpc_types import (
     OrderMode,
     CommitmentLevel,
@@ -46,6 +52,14 @@ from .grpc_types import (
     event_type_filter_includes_pumpfun,
     event_type_filter_includes_pumpswap,
     event_type_filter_includes_meteora_damm_v2,
+    event_type_filter_includes_meteora_dbc,
+    event_type_filter_includes_meteora_pools,
+    event_type_filter_includes_meteora_dlmm,
+    event_type_filter_includes_raydium_clmm,
+    event_type_filter_includes_raydium_cpmm,
+    event_type_filter_includes_raydium_amm_v4,
+    event_type_filter_includes_orca_whirlpool,
+    event_type_filter_includes_raydium_launchlab,
     event_type_filter_includes_pump_fees,
     event_type_filter_allows_instruction_parsing,
     all_event_types,
@@ -128,16 +142,17 @@ from .event_types import (
     MeteoraDammV2AddLiquidityEvent,
     MeteoraDammV2RemoveLiquidityEvent,
     MeteoraDammV2InitializePoolEvent,
-    # Bonk events
-    BonkTradeEvent,
-    BonkPoolCreateEvent,
-    BonkMigrateAmmEvent,
+    # RaydiumLaunchlab events
+    RaydiumLaunchlabTradeEvent,
+    RaydiumLaunchlabPoolCreateEvent,
+    RaydiumLaunchlabMigrateAmmEvent,
     # Union type and helper
     TypedDexEvent,
     to_typed_event,
     legacy_dict_to_dex_event,
 )
 from .pumpfun_fee_enrich import (
+    enrich_create_v2_from_create_events,
     enrich_create_v2_observed_fee_recipient,
     enrich_pumpfun_same_tx_post_merge,
     enrich_pumpfun_trades_from_create_instructions,
@@ -206,6 +221,8 @@ from .instructions import (
     parse_pumpfun_instruction,
     parse_pumpswap_instruction,
     parse_meteora_damm_instruction,
+    parse_meteora_pools_instruction,
+    parse_meteora_dlmm_instruction,
     parse_pump_fees_instruction,
 )
 
@@ -229,6 +246,10 @@ __all__ = [
     "StreamingEventListener",
     "warmup_parser",
     "now_micros",
+    "sqrt_price_x64_to_price",
+    "vault_price_from_balances",
+    "normalize_buy_sell_from_token_delta",
+    "normalize_buy_sell_from_input_mint",
     # RPC parser
     "ParseError",
     "RpcClient",
@@ -264,6 +285,8 @@ __all__ = [
     "parse_pumpfun_instruction",
     "parse_pumpswap_instruction",
     "parse_meteora_damm_instruction",
+    "parse_meteora_pools_instruction",
+    "parse_meteora_dlmm_instruction",
     "parse_pump_fees_instruction",
     # gRPC types
     "OrderMode",
@@ -296,6 +319,14 @@ __all__ = [
     "event_type_filter_includes_pumpfun",
     "event_type_filter_includes_pumpswap",
     "event_type_filter_includes_meteora_damm_v2",
+    "event_type_filter_includes_meteora_dbc",
+    "event_type_filter_includes_meteora_pools",
+    "event_type_filter_includes_meteora_dlmm",
+    "event_type_filter_includes_raydium_clmm",
+    "event_type_filter_includes_raydium_cpmm",
+    "event_type_filter_includes_raydium_amm_v4",
+    "event_type_filter_includes_orca_whirlpool",
+    "event_type_filter_includes_raydium_launchlab",
     "event_type_filter_includes_pump_fees",
     "event_type_filter_allows_instruction_parsing",
     "all_event_types",
@@ -378,12 +409,13 @@ __all__ = [
     "MeteoraDammV2AddLiquidityEvent",
     "MeteoraDammV2RemoveLiquidityEvent",
     "MeteoraDammV2InitializePoolEvent",
-    "BonkTradeEvent",
-    "BonkPoolCreateEvent",
-    "BonkMigrateAmmEvent",
+    "RaydiumLaunchlabTradeEvent",
+    "RaydiumLaunchlabPoolCreateEvent",
+    "RaydiumLaunchlabMigrateAmmEvent",
     "TypedDexEvent",
     "to_typed_event",
     "legacy_dict_to_dex_event",
+    "enrich_create_v2_from_create_events",
     "enrich_create_v2_observed_fee_recipient",
     "enrich_pumpfun_same_tx_post_merge",
     "enrich_pumpfun_trades_from_create_instructions",

{sol_parser_sdk_python-0.4.5 → sol_parser_sdk_python-0.5.5}/sol_parser/account_dispatcher.py

@@ -6,12 +6,12 @@ from typing import Any, Dict, List, Optional, Tuple
 
 import base58
 
-from .account_fillers import bonk, meteora, orca, pumpfun, pumpswap, raydium
+from .account_fillers import raydium_launchlab, meteora, orca, pumpfun, pumpswap, raydium
 from .event_types import DexEvent
 from .grpc_types import EventType
 from .instr_account_utils import get_instruction_account_getter
 from .instructions import (
-    BONK_LAUNCHPAD_PROGRAM_ID,
+    RAYDIUM_LAUNCHLAB_PROGRAM_ID,
     METEORA_DAMM_V2_PROGRAM_ID,
     METEORA_DLMM_PROGRAM_ID,
     METEORA_POOLS_PROGRAM_ID,
@@ -179,10 +179,10 @@ def fill_accounts_with_owned_keys(
         run(METEORA_DLMM_PROGRAM_ID, lambda g: meteora.fill_dlmm_add_liquidity_accounts(data, g))
     elif et == EventType.METEORA_DLMM_REMOVE_LIQUIDITY:
         run(METEORA_DLMM_PROGRAM_ID, lambda g: meteora.fill_dlmm_remove_liquidity_accounts(data, g))
-    elif et == EventType.BONK_TRADE:
-        run(BONK_LAUNCHPAD_PROGRAM_ID, lambda g: bonk.fill_trade_accounts(data, g))
-    elif et == EventType.BONK_POOL_CREATE:
-        run(BONK_LAUNCHPAD_PROGRAM_ID, lambda g: bonk.fill_pool_create_accounts(data, g))
+    elif et == EventType.RAYDIUM_LAUNCHLAB_TRADE:
+        run(RAYDIUM_LAUNCHLAB_PROGRAM_ID, lambda g: raydium_launchlab.fill_trade_accounts(data, g))
+    elif et == EventType.RAYDIUM_LAUNCHLAB_POOL_CREATE:
+        run(RAYDIUM_LAUNCHLAB_PROGRAM_ID, lambda g: raydium_launchlab.fill_pool_create_accounts(data, g))
 
 
 def fill_data(

sol_parser_sdk_python-0.5.5/sol_parser/account_fillers/__init__.py

@@ -0,0 +1,5 @@
+"""账户填充子模块（对齐 Rust ``core/account_fillers``）。"""
+
+from . import raydium_launchlab, meteora, orca, pumpfun, pumpswap, raydium
+
+__all__ = ["raydium_launchlab", "meteora", "orca", "pumpfun", "pumpswap", "raydium"]

{sol_parser_sdk_python-0.4.5 → sol_parser_sdk_python-0.5.5}/sol_parser/account_fillers/pumpfun.py

@@ -29,9 +29,7 @@ def fill_trade_accounts(e: PumpFunTradeEvent, get: AccountGetter) -> None:
         if _empty(getattr(e, name)):
             setattr(e, name, get(idx))
 
-    is_v2 = e.ix_name in ("buy_v2", "sell_v2", "buy_exact_quote_in_v2") or (
-        e.ix_name == "buy_exact_quote_in" and account_at_matches_mint(1)
-    )
+    is_v2 = e.ix_name in ("buy_v2", "sell_v2", "buy_exact_quote_in_v2") or account_at_matches_mint(1)
     if is_v2:
         set_attr("global_account", 0)
         set_attr("quote_mint", 2)
@@ -51,7 +49,7 @@ def fill_trade_accounts(e: PumpFunTradeEvent, get: AccountGetter) -> None:
         set_attr("associated_quote_buyback_fee_recipient", 9)
         set_attr("associated_creator_vault", 17)
         set_attr("sharing_config", 18)
-        if e.ix_name == "sell_v2":
+        if e.ix_name == "sell_v2" or (e.ix_name == "sell" and not e.is_buy):
             set_attr("user_volume_accumulator", 19)
             set_attr("associated_user_volume_accumulator", 20)
             set_attr("fee_config", 21)

sol_parser_sdk_python-0.5.5/sol_parser/account_fillers/raydium_launchlab.py

@@ -0,0 +1,30 @@
+"""RaydiumLaunchlab 账户填充（对齐 ``account_fillers/raydium_launchlab.rs``）。"""
+
+from __future__ import annotations
+
+from typing import Callable
+
+from ..event_types import RaydiumLaunchlabPoolCreateEvent, RaydiumLaunchlabTradeEvent
+
+Z = "11111111111111111111111111111111"
+
+
+def _empty(s: str) -> bool:
+    return not s or s == Z
+
+
+AccountGetter = Callable[[int], str]
+
+
+def fill_trade_accounts(e: RaydiumLaunchlabTradeEvent, get: AccountGetter) -> None:
+    if _empty(e.user):
+        e.user = get(0)
+    if _empty(e.pool_state):
+        e.pool_state = get(4)
+
+
+def fill_pool_create_accounts(e: RaydiumLaunchlabPoolCreateEvent, get: AccountGetter) -> None:
+    if _empty(e.pool_state):
+        e.pool_state = get(5)
+    if _empty(e.creator):
+        e.creator = get(1)