sol-parser-sdk-python 0.5.6__py3-none-any.whl → 0.5.8__py3-none-any.whl

sol_parser/pumpfun_fee_enrich.py

@@ -82,7 +82,18 @@ def enrich_create_v2_from_create_events(events: List[DexEvent]) -> None:
         if c is None:
             continue
 
-        for attr in ("name", "symbol", "uri", "bonding_curve", "user", "creator", "token_program", "quote_mint"):
+        for attr in (
+            "name",
+            "symbol",
+            "uri",
+            "bonding_curve",
+            "user",
+            "creator",
+            "token_program",
+            "quote_mint",
+            "quote_vault",
+            "quote_token_program",
+        ):
             _fill_str_if_empty(c2, attr, getattr(c, attr))
         for attr in (
             "timestamp",
@@ -91,10 +102,12 @@ def enrich_create_v2_from_create_events(events: List[DexEvent]) -> None:
             "real_token_reserves",
             "token_total_supply",
             "virtual_quote_reserves",
+            "creator_fee_bps",
         ):
             _fill_int_if_zero(c2, attr, getattr(c, attr))
         c2.is_cashback_enabled = c2.is_cashback_enabled or c.is_cashback_enabled
         c2.is_mayhem_mode = c2.is_mayhem_mode or c.is_mayhem_mode
+        c2.is_holder_reward = c2.is_holder_reward or c.is_holder_reward
 
 
 def enrich_pumpfun_trades_from_create_instructions(events: List[DexEvent]) -> None:

sol_parser/rpc_parser.py

@@ -8,9 +8,14 @@ from dataclasses import dataclass
 
 import base58
 
-from .dex_parsers import DexEvent, dispatch_program_data, parse_trade_from_data
+from .dex_parsers import DexEvent
 from .grpc_types import EventTypeFilter, EventType, event_type_filter_allows_instruction_parsing
-from .instructions import parse_instruction_unified
+from .inner_instruction_parser import parse_inner_instruction
+from .instructions import (
+    METEORA_DLMM_PROGRAM_ID,
+    parse_inner_compiled_instruction_if_supported,
+    parse_instruction_unified,
+)
 from .log_instr_dedup import dedupe_log_instruction_events
 from .pumpfun_fee_enrich import enrich_pumpfun_same_tx_post_merge
 
@@ -29,6 +34,7 @@ class RpcCompiledInstruction:
     program_id_index: int
     accounts: Union[List[int], bytes]
     data: bytes
+    stack_height: Optional[int] = None
 
 
 @dataclass
@@ -214,11 +220,17 @@ def parse_rpc_transaction(
     block_tx_index = int(getattr(tx, "transaction_index", 0) or 0)
     full_account_keys = _merge_rpc_full_account_keys(msg.account_keys, meta)
 
-    instruction_events: List[DexEvent] = []
+    indexed_instruction_events: List[Tuple[Any, ...]] = []
+    from .grpc_instruction_parser import (
+        _is_dlmm_event_cpi,
+        detect_pumpfun_create_from_logs,
+        merge_instruction_events,
+    )
+    has_pumpfun_create_log = detect_pumpfun_create_from_logs(list(meta.log_messages))
 
     if _should_parse_rpc_instructions(filter):
         # 解析外层指令
-        for ix in msg.instructions:
+        for outer_idx, ix in enumerate(msg.instructions):
             ev = _parse_rpc_instruction(
                 ix,
                 full_account_keys,
@@ -228,13 +240,15 @@ def parse_rpc_transaction(
                 block_time_us,
                 grpc_recv_us,
                 filter,
+                inner=False,
+                is_created_buy=has_pumpfun_create_log,
             )
             if ev:
-                instruction_events.append(ev)
+                indexed_instruction_events.append((outer_idx, None, 1, False, ev))
 
         # 解析内层指令
         for group in meta.inner_instructions:
-            for ix in group.instructions:
+            for inner_idx, ix in enumerate(group.instructions):
                 ev = _parse_rpc_instruction(
                     ix,
                     full_account_keys,
@@ -244,12 +258,31 @@ def parse_rpc_transaction(
                     block_time_us,
                     grpc_recv_us,
                     filter,
+                    inner=True,
+                    is_created_buy=has_pumpfun_create_log,
                 )
                 if ev:
-                    instruction_events.append(ev)
+                    pid = (
+                        full_account_keys[ix.program_id_index]
+                        if ix.program_id_index < len(full_account_keys)
+                        else ""
+                    )
+                    indexed_instruction_events.append((
+                        int(group.index),
+                        inner_idx,
+                        ix.stack_height,
+                        pid == METEORA_DLMM_PROGRAM_ID and _is_dlmm_event_cpi(ix.data),
+                        ev,
+                    ))
+
+    instruction_events = merge_instruction_events(indexed_instruction_events)
+    enrich_pumpfun_same_tx_post_merge(instruction_events)
+    if msg.recent_blockhash:
+        for ev in instruction_events:
+            if hasattr(ev.data, "metadata"):
+                ev.data.metadata.recent_blockhash = msg.recent_blockhash
 
     # 解析日志
-    is_created_buy = False
     recent_blockhash = msg.recent_blockhash
     log_events: List[DexEvent] = []
 
@@ -271,13 +304,11 @@ def parse_rpc_transaction(
             block_time_us,
             grpc_recv_us,
             filter,
-            is_created_buy,
+            has_pumpfun_create_log,
             recent_blockhash,
             active_program_stack[-1] if active_program_stack else None,
         )
         if ev:
-            if ev.type in (EventType.PUMP_FUN_CREATE, EventType.PUMP_FUN_CREATE_V2):
-                is_created_buy = True
             log_events.append(ev)
 
         completed = parse_program_complete_info(log)
@@ -315,6 +346,8 @@ def _parse_rpc_instruction(
     block_time_us: Optional[int],
     grpc_recv_us: int,
     filter: Optional[EventTypeFilter],
+    inner: bool = False,
+    is_created_buy: bool = False,
 ) -> Optional[DexEvent]:
     """解析 RPC 指令"""
     # 获取程序 ID
@@ -334,6 +367,35 @@ def _parse_rpc_instruction(
         if acc_idx < len(account_keys):
             accounts.append(account_keys[acc_idx])
 
+    if inner:
+        ev = parse_inner_compiled_instruction_if_supported(
+            data,
+            accounts,
+            signature,
+            slot,
+            tx_index,
+            block_time_us,
+            grpc_recv_us,
+            filter,
+            program_id,
+        )
+        if ev:
+            return ev
+        return parse_inner_instruction(
+            data,
+            program_id,
+            {
+                "signature": signature,
+                "slot": slot,
+                "tx_index": tx_index,
+                "block_time_us": 0 if block_time_us is None else block_time_us,
+                "grpc_recv_us": grpc_recv_us,
+                "recent_blockhash": "",
+            },
+            filter,
+            is_created_buy,
+        )
+
     return parse_instruction_unified(
         data, accounts, signature, slot, tx_index, block_time_us, grpc_recv_us, filter, program_id
     )
@@ -480,6 +542,13 @@ def _parse_rpc_compiled_ix(ix: dict, account_keys: List[str]) -> RpcCompiledInst
         program_id_index=pidx,
         accounts=acc_list,
         data=_ix_data_from_rpc(ix),
+        stack_height=(
+            int(ix["stackHeight"])
+            if ix.get("stackHeight") is not None
+            else int(ix["stack_height"])
+            if ix.get("stack_height") is not None
+            else None
+        ),
     )
 
 
@@ -672,6 +741,8 @@ def rpc_response_to_solana_storage(
             acc = ix.accounts
             ii.accounts = bytes(acc) if not isinstance(acc, bytes) else acc
             ii.data = ix.data
+            if ix.stack_height is not None:
+                ii.stack_height = ix.stack_height
     if m.loaded_addresses:
         for w in m.loaded_addresses.writable:
             meta.loaded_writable_addresses.append(base58.b58decode(w))

{sol_parser_sdk_python-0.5.6.dist-info → sol_parser_sdk_python-0.5.8.dist-info}/METADATA

@@ -1,6 +1,6 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: sol-parser-sdk-python
-Version: 0.5.6
+Version: 0.5.8
 Summary: Solana DEX program log parsing (pure Python, API aligned with sol-parser-sdk)
 Requires-Python: >=3.10
 Requires-Dist: base58>=2.0
@@ -46,12 +46,6 @@ Description-Content-Type: text/markdown
     <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
@@ -65,8 +59,31 @@ Description-Content-Type: text/markdown
 
 ---
 
+## What This SDK Is For
+
+This is the Python implementation of the FnZero Solana DEX parser SDK for asyncio services, research scripts, indexers, copy-trading systems, sniper pipelines, and backend jobs that need normalized real-time DEX events.
+
+| Area | Coverage |
+|------|----------|
+| Parser inputs | Yellowstone gRPC, ShredStream, RPC transactions, encoded transactions, protocol account data |
+| DEX protocols | PumpFun, PumpSwap, Pump Fees, Raydium LaunchLab, Raydium CPMM, Raydium CLMM, Raydium AMM V4, Meteora DAMM v2, Meteora DLMM, Meteora DBC, Orca Whirlpool |
+| Use cases | Real-time DEX event parsing, token launch monitoring, copy trading, sniper bots, analytics notebooks, JSON event pipelines |
+| Runtime | Python 3.10+, asyncio workers, backend services, data pipelines, low-latency bot infrastructure |
+
+---
+
 ## Release notes
 
+### v0.5.8
+
+- Syncs with Rust **sol-parser-sdk 0.7.3**, including the current PumpFun, PumpSwap, and Pump Fees protocol definitions.
+- Adds Meteora DAMM v2 events: `UpdateDelegatePermission`, `WithdrawDeadLiquidityReward`, `CreateConfig`, `CreateDynamicConfig`.
+- Fixes DAMM v2 `EvtSwap2` full 180-byte layout, three swap modes, transfer fees, reserves, and compounding-fee layout activation slot `406048752`.
+- Routes unified `EvtLiquidityChange` by `change_type` to AddLiquidity / RemoveLiquidity.
+- Adds DLMM mint/user-token/`min_amount_out` context, PumpFun pre/post token & SOL balances, and LaunchLab quote/global/platform account fields.
+- Adds current PumpFun/PumpSwap creator-fee and holder-reward fields across instruction, log, account, gRPC, and JSON event paths.
+- Rejects truncated known PumpSwap trade and CreatePool tails while retaining complete historical layouts.
+
 ### v0.5.6
 
 - Adds Meteora DBC log parsing with program-context routing and filter parity.
@@ -92,7 +109,7 @@ Description-Content-Type: text/markdown
 **From PyPI**
 
 ```bash
-pip install sol-parser-sdk-python==0.5.6
+pip install sol-parser-sdk-python==0.5.8
 ```
 
 **From source**

{sol_parser_sdk_python-0.5.6.dist-info → sol_parser_sdk_python-0.5.8.dist-info}/RECORD

@@ -1,27 +1,28 @@
-sol_parser/__init__.py,sha256=ir7IT87fC7yaN_fyGO3-116lc7CFtU-0EwAbDoBZV0E,13873
-sol_parser/account_dispatcher.py,sha256=F88hfvWmwCLb2Pv8Fr_fYVa3_n80aHwcVdFtwWT-hwQ,9752
-sol_parser/check_migration.py,sha256=hW2qb-EVVoqBUTH3ARhEkSvP9aHcNEkg3ket7lfMVzQ,415
+sol_parser/__init__.py,sha256=2b7VW5C0aEbBsfkUPEUzuDXZIxLSm5Jwg2xkFvjHrR8,15031
+sol_parser/account_dispatcher.py,sha256=Zy--fqFypjDk_kU-6Z6Z3T5xqG1IvMHROYBd_n3VsKk,13028
+sol_parser/check_migration.py,sha256=PsRE_Zhnw2g_iaP_iYtlGsQutE2w_FsaZIP4GPeN8-o,537
 sol_parser/clock.py,sha256=RHF99qMerKvEsT55krkftIh-uqy_uTzpgdKCqKBMDmA,278
-sol_parser/dex_parsers.py,sha256=Ictl5Zeo4DayIquXicm3psUMy456kSeT9F4jLcUYfcE,82412
+sol_parser/dex_parsers.py,sha256=ogyuqBQro2MisryGrGfyGiZwxZc3ImiSNB8GAROaTLU,134727
 sol_parser/entries_decode.py,sha256=-eooIYrXOcpNtrSgSEVehY8NkBhwUMnziAR5Wx8S0Nk,5620
 sol_parser/env_config.py,sha256=Lw0SdZuy_MvUaVkyFxS0qPBgMzR9UBbxbN0CVz8nxg4,7296
-sol_parser/event_types.py,sha256=Q_HZNdJ0Yb5Mg__3Wv9yUD-nCG00_getYdJ_DHssqgI,68228
+sol_parser/event_type_parity.py,sha256=L_oxbUtCTQ9JLGyRiLXNhDTp0UUOcEbe_IPrisgdMBY,4206
+sol_parser/event_types.py,sha256=BtNNPUTniBh0sMJrEYDg3YhmRtQdtnc09LTThlszXw0,86841
 sol_parser/geyser_pb2.py,sha256=Hq66wmWxXD2jSbSVQW7vmBRB7nWmR1DuYDMQ6nKgl3o,20123
 sol_parser/geyser_pb2_grpc.py,sha256=ASPmZsCNvyCzt_j4IrhKjSacWUNLVuAiLfpjmyd-2Qc,15322
-sol_parser/grpc_client.py,sha256=7ONaCx8324mx2mcrKZH6JV68uQaeZBzrTERS0hh8J6A,32289
-sol_parser/grpc_instruction_parser.py,sha256=aKUOiWrA2QL9G28IinXyVWRr2IbypunAfD8wn2kkH8o,10662
-sol_parser/grpc_types.py,sha256=pPnp7RGRz5KGl0lpkn-qyX40rdnfGSAk0savIMfwQM4,36015
-sol_parser/inner_instruction_parser.py,sha256=3Klb9H6Aj2zOgFnGcl096f9WrKgiuRRV3HRQz7SCAug,13354
+sol_parser/grpc_client.py,sha256=LvYM7FOO-IOEB0GXf8wtGyJNtuiJHvDVRiOwT0kJoI8,32278
+sol_parser/grpc_instruction_parser.py,sha256=p_9BnhC5FHHIXLKPKEM2_infbMC7apr4CQEhMxfkKz4,13450
+sol_parser/grpc_types.py,sha256=750OCMauel0nVQWg2kAk5yFd0Tiwl5S7z-NCbHFFKjw,38327
+sol_parser/inner_instruction_parser.py,sha256=Mynr-pzSFG3AuRUl9wu2_G-wzDJZp_GcorGslP88f0s,20831
 sol_parser/instr_account_utils.py,sha256=MY8bgoIDiv2yJKeWxqhpfKc3pV4xUFTcYKnSXtnQMWc,1990
-sol_parser/instructions.py,sha256=Xo8pdRJtql6A9RNBCCzvxG9afScvfZaIVADSwyai2wU,61064
+sol_parser/instructions.py,sha256=3B3mrL0OJhzNs_K_8-0bLPkh2kF1jh-G3ofTK9tx-a8,78917
 sol_parser/json_util.py,sha256=qq0A5bs-HxxQH6vgg1Kja4tQ8cPaop9uItBcW7Ajox4,1458
-sol_parser/log_instr_dedup.py,sha256=3wRIZMOWAiFSQtjx-H3uJyxqPdz9VPY9485Dn_XHd88,11754
+sol_parser/log_instr_dedup.py,sha256=AWF3EMaEXI5V_bwjyF24uH_ozWTijRvd0zf7lGBXTMk,14559
 sol_parser/market.py,sha256=p_N6n3b4hEtUjHAQQyGSnrKdHYmkHdY1hXXObHRKc0Y,1858
-sol_parser/merger.py,sha256=ZrFONLnOwF1aw8GR0BibhPvIE_HguCrY2gT9PByHmJo,11684
+sol_parser/merger.py,sha256=NGjqSzTNDvDDlIH-8DV2Mk_Z5xJ3ItlnUiAGOAK6kPU,12362
 sol_parser/order_buffer.py,sha256=xW-Okii8a9t9tCqbBKtxFh1moTEi7RqycMFO2kwp-d4,6447
-sol_parser/parser.py,sha256=D-q7Jd92A9znUSyDFIfVA1_ZbyD2vh-8CSpvgxYp6jg,10079
-sol_parser/pumpfun_fee_enrich.py,sha256=hlEHE8sFHoKGDSvOMlSpjZoJJUIimUNrTxojokSAAb4,4416
-sol_parser/rpc_parser.py,sha256=BIPht00w5LcEvOhl6anNYlYXzN4bW9_2t6f1emm_Xbw,22899
+sol_parser/parser.py,sha256=jd-NkWXso7Rcp8TJiBFvjTmNO468tb7rsEElQkU-EV0,11286
+sol_parser/pumpfun_fee_enrich.py,sha256=NHC_chCv2wuaOW5taYG8R6M1bu8cmdxcLf8cjSfo7Kc,4688
+sol_parser/rpc_parser.py,sha256=iWTl_OtNOEpoOmvVEPVmum5QDdGyjSiX6r_3Hx4LOTg,25361
 sol_parser/rust_api_inventory.py,sha256=V5Bx1M3GT-ku_vj_kD6lnbqWExv1K_A00PrmhCFfRec,2257
 sol_parser/rust_event_json.py,sha256=7hho9TGfSOQjHev_8uRa4YHU1hrEsW1RfwcU9qHYz1o,1649
 sol_parser/shredstream_client.py,sha256=xBE6KE9kyTXkXO82iEi99dQCSHq-dIIkFF7u8NHBWHE,9967
@@ -33,13 +34,13 @@ sol_parser/solana_storage_pb2_grpc.py,sha256=-Gys-K2Kw5Uy3JjtgIXmaYE6YKnXd5ZfBaM
 sol_parser/u128_parity.py,sha256=D8PYuy1l-1QwkIEeGCLvrGfzAfTzpBDcGINxRIJAEPs,3487
 sol_parser/verify_discriminators.py,sha256=oqCBWL065ixBIjhHW255nk4S-F1F0x4zfTzs68nXMqA,3011
 sol_parser/account_fillers/__init__.py,sha256=q4q7HZF0Z4-rxhKoRMzV52HSkJ_n_POm4vimYUQlCOA,235
-sol_parser/account_fillers/meteora.py,sha256=seS80dMIeFE-E0Kd2U50p09w69wDi4sf4UxWFl-WP8U,1159
+sol_parser/account_fillers/meteora.py,sha256=ecY3F4KkjnVxBc-Zsnzru52DggkYOdbeauaYrznDxFY,2111
 sol_parser/account_fillers/orca.py,sha256=2s-hfi20fa5sy6p1rGc7_7NxzkpaleJdqn3YD41aBAw,895
-sol_parser/account_fillers/pumpfun.py,sha256=nFOVF7Om6gcxgIIDneswRCO6iU2B-DPobGhUOTx_my4,5474
+sol_parser/account_fillers/pumpfun.py,sha256=hZgvqquXRDAR1Vny7y69YX7BZyo0tWiqZlnJLu1Zlxs,5969
 sol_parser/account_fillers/pumpswap.py,sha256=1_JBmwFGMr_tAMZpYQsPnUJDoQlGvCpwB90iZzWHLzM,4042
-sol_parser/account_fillers/raydium.py,sha256=j5vNSKAV-8bJuakG2dicc8ao5I-ZD2TEthLM6ooZqQ4,3350
-sol_parser/account_fillers/raydium_launchlab.py,sha256=eBqDzKipeSJJo8s1WOLzdqnCKLGo6_IYpe6egLTVk10,781
-sol_parser/accounts/__init__.py,sha256=DcgCX6SVfrQsWK8X2-shl705ybg6tB3WzaWyKeDgr3M,32227
+sol_parser/account_fillers/raydium.py,sha256=av6SUeWVnvm6cxC_A3RIxPhQR1rONgqIzXTDVR-6q_g,3392
+sol_parser/account_fillers/raydium_launchlab.py,sha256=gED19-pyUySD6qe7ecBxMDnfzreCQRY3QlC0NZSb2To,2479
+sol_parser/accounts/__init__.py,sha256=YPhWgp5EBZO1Rc3Gbf_iWQlpnZvRpS7eFoDNLn0tznc,33924
 sol_parser/accounts/raydium_orca.py,sha256=Q3eYe5kBO18LnGOe-xRAGQu8RJv878CEnmPIyVFbZyo,17158
 sol_parser/accounts/rpc_wallet.py,sha256=IT0WEzna9phG7AzhJR8o4GA_BlB4ZvhuDWfCHQcMXwg,1944
 sol_parser/accounts/utils.py,sha256=BAACAIvA2Uz0U26BpYPTalTqiuarXYhkbS-i2o1uJUY,2140
@@ -50,7 +51,7 @@ sol_parser/grpc/subscribe_builder.py,sha256=fv6_jQAR6Q0seUhXjgcDPnPsG03Bxs59lHGe
 sol_parser/grpc/transaction_meta.py,sha256=NmIffIQ1_OIfWGjy6JY-f8pIK5ucjDZXXJryjnlgoQs,5894
 sol_parser/instr/__init__.py,sha256=0_Ky8KpVEoXzxszHcHLTuY2SDsJwu0uAF2Q0wMY1e-c,503
 sol_parser/logs/__init__.py,sha256=e1cbhbCNeXy-NZvVsYCpGksBpZf4NJBLmdlky06og-U,349
-sol_parser_sdk_python-0.5.6.dist-info/METADATA,sha256=O7OyZYSZvsiex9-JEm7U9uGiEr9LkJfQrjolJHqNBQM,13107
-sol_parser_sdk_python-0.5.6.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
-sol_parser_sdk_python-0.5.6.dist-info/entry_points.txt,sha256=ZGXRb-2jBdc56d8PCAZFiJBLTAzUKFeHPohysJnKVbA,206
-sol_parser_sdk_python-0.5.6.dist-info/RECORD,,
+sol_parser_sdk_python-0.5.8.dist-info/METADATA,sha256=hfEZwNMDJ3A-5OrDUyVoQg6kFf1GEMBuWb7UkCXDEOU,14402
+sol_parser_sdk_python-0.5.8.dist-info/WHEEL,sha256=zOwg4jB6zX2kU910N-cMawjivD6tO8NEWvE12je1bVk,87
+sol_parser_sdk_python-0.5.8.dist-info/entry_points.txt,sha256=ZGXRb-2jBdc56d8PCAZFiJBLTAzUKFeHPohysJnKVbA,206
+sol_parser_sdk_python-0.5.8.dist-info/RECORD,,

{sol_parser_sdk_python-0.5.6.dist-info → sol_parser_sdk_python-0.5.8.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: hatchling 1.29.0
+Generator: hatchling 1.32.0
 Root-Is-Purelib: true
 Tag: py3-none-any