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

sol_parser/__init__.py

@@ -6,6 +6,7 @@ from .parser import (
     StreamingEventListener,
     parse_log,
     parse_log_optimized,
+    parse_log_optimized_with_program_id,
     parse_log_unified,
     parse_logs_only,
     parse_logs_streaming,
@@ -16,6 +17,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 +53,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 +143,20 @@ from .event_types import (
     MeteoraDammV2AddLiquidityEvent,
     MeteoraDammV2RemoveLiquidityEvent,
     MeteoraDammV2InitializePoolEvent,
-    # Bonk events
-    BonkTradeEvent,
-    BonkPoolCreateEvent,
-    BonkMigrateAmmEvent,
+    MeteoraDbcCurveCompleteEvent,
+    MeteoraDbcInitializePoolEvent,
+    MeteoraDbcSwapEvent,
+    # 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 +225,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,
 )
 
@@ -218,6 +239,7 @@ __all__ = [
     "enrich_dex_events_with_subscribe_tx_info",
     "parse_log_unified",
     "parse_log_optimized",
+    "parse_log_optimized_with_program_id",
     "parse_log",
     "parse_logs_only",
     "parse_logs_streaming",
@@ -229,6 +251,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 +290,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 +324,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 +414,16 @@ __all__ = [
     "MeteoraDammV2AddLiquidityEvent",
     "MeteoraDammV2RemoveLiquidityEvent",
     "MeteoraDammV2InitializePoolEvent",
-    "BonkTradeEvent",
-    "BonkPoolCreateEvent",
-    "BonkMigrateAmmEvent",
+    "MeteoraDbcCurveCompleteEvent",
+    "MeteoraDbcInitializePoolEvent",
+    "MeteoraDbcSwapEvent",
+    "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/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/account_fillers/__init__.py

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

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/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)

sol_parser/accounts/__init__.py

@@ -13,6 +13,14 @@ from ..dex_parsers import DexEvent
 
 from . import rpc_wallet
 from . import utils as acc_utils
+from .raydium_orca import (
+    ORCA_WHIRLPOOL_PROGRAM_ID,
+    RAYDIUM_CLMM_PROGRAM_ID,
+    RAYDIUM_CPMM_PROGRAM_ID,
+    parse_orca_whirlpool_account,
+    parse_raydium_clmm_account,
+    parse_raydium_cpmm_account,
+)
 
 # 程序 ID（与 Rust ``accounts/program_ids`` / ``instr/program_ids`` 一致）
 PUMPFUN_PROGRAM_ID = "6EF8rrecthR5Dkzon8Nwu78hRvfCKubJ14M5uBEwF6P"
@@ -151,6 +159,42 @@ def _read_pumpfun_shareholders(data: bytes, offset: int) -> Optional[tuple[list[
     return out, offset
 
 
+def _filter_account_event(
+    ev: Optional[DexEvent],
+    event_type_filter: Optional[EventTypeFilter],
+) -> Optional[DexEvent]:
+    if ev is None or event_type_filter is None:
+        return ev
+    return ev if event_type_filter.should_include(ev.type) else None
+
+
+ACCOUNT_EVENT_TYPES = frozenset(
+    (
+        EventType.TOKEN_ACCOUNT,
+        EventType.TOKEN_INFO,
+        EventType.NONCE_ACCOUNT,
+        EventType.ACCOUNT_PUMP_FUN_GLOBAL,
+        EventType.ACCOUNT_PUMP_FUN_BONDING_CURVE,
+        EventType.ACCOUNT_PUMP_FUN_FEE_CONFIG,
+        EventType.ACCOUNT_PUMP_FUN_SHARING_CONFIG,
+        EventType.ACCOUNT_PUMP_FUN_GLOBAL_VOLUME_ACCUMULATOR,
+        EventType.ACCOUNT_PUMP_FUN_USER_VOLUME_ACCUMULATOR,
+        EventType.ACCOUNT_PUMP_SWAP_GLOBAL_CONFIG,
+        EventType.ACCOUNT_PUMP_SWAP_POOL,
+        EventType.ACCOUNT_RAYDIUM_CLMM_AMM_CONFIG,
+        EventType.ACCOUNT_RAYDIUM_CLMM_POOL_STATE,
+        EventType.ACCOUNT_RAYDIUM_CLMM_TICK_ARRAY_STATE,
+        EventType.ACCOUNT_RAYDIUM_CPMM_AMM_CONFIG,
+        EventType.ACCOUNT_RAYDIUM_CPMM_POOL_STATE,
+        EventType.ACCOUNT_ORCA_WHIRLPOOL,
+        EventType.ACCOUNT_ORCA_POSITION,
+        EventType.ACCOUNT_ORCA_TICK_ARRAY,
+        EventType.ACCOUNT_ORCA_FEE_TIER,
+        EventType.ACCOUNT_ORCA_WHIRLPOOLS_CONFIG,
+    )
+)
+
+
 def parse_account_unified(
     account: AccountData,
     metadata: EventMetadata,
@@ -164,47 +208,71 @@ def parse_account_unified(
     if event_type_filter is not None:
         inc = getattr(event_type_filter, "include_only", None)
         if inc is not None and len(inc) > 0:
-            need = {
-                EventType.TOKEN_ACCOUNT,
-                EventType.TOKEN_INFO,
-                EventType.NONCE_ACCOUNT,
-                EventType.ACCOUNT_PUMP_FUN_GLOBAL,
-                EventType.ACCOUNT_PUMP_FUN_BONDING_CURVE,
-                EventType.ACCOUNT_PUMP_FUN_FEE_CONFIG,
-                EventType.ACCOUNT_PUMP_FUN_SHARING_CONFIG,
-                EventType.ACCOUNT_PUMP_FUN_GLOBAL_VOLUME_ACCUMULATOR,
-                EventType.ACCOUNT_PUMP_FUN_USER_VOLUME_ACCUMULATOR,
-                EventType.ACCOUNT_PUMP_SWAP_GLOBAL_CONFIG,
-                EventType.ACCOUNT_PUMP_SWAP_POOL,
-            }
-            if not any(t in need for t in inc):
+            if not any(t in ACCOUNT_EVENT_TYPES for t in inc):
                 return None
 
-    if account.owner == PUMPSWAP_PROGRAM_ID and event_type_filter is not None:
-        if event_type_filter.should_include(
-            EventType.ACCOUNT_PUMP_SWAP_GLOBAL_CONFIG
-        ) or event_type_filter.should_include(EventType.ACCOUNT_PUMP_SWAP_POOL):
+    if account.owner == PUMPSWAP_PROGRAM_ID:
+        should_parse_pumpswap = event_type_filter is None or (
+            event_type_filter.should_include(EventType.ACCOUNT_PUMP_SWAP_GLOBAL_CONFIG)
+            or event_type_filter.should_include(EventType.ACCOUNT_PUMP_SWAP_POOL)
+        )
+        if should_parse_pumpswap:
             ev = _parse_pumpswap_account(account, metadata)
             if ev is not None:
-                return ev
-
-    if account.owner in (PUMPFUN_PROGRAM_ID, PUMP_FEES_PROGRAM_ID) and event_type_filter is not None:
-        if event_type_filter.should_include(
-            EventType.ACCOUNT_PUMP_FUN_GLOBAL
-        ) or event_type_filter.should_include(
-            EventType.ACCOUNT_PUMP_FUN_BONDING_CURVE
-        ) or event_type_filter.should_include(
-            EventType.ACCOUNT_PUMP_FUN_FEE_CONFIG
-        ) or event_type_filter.should_include(
-            EventType.ACCOUNT_PUMP_FUN_SHARING_CONFIG
-        ) or event_type_filter.should_include(
-            EventType.ACCOUNT_PUMP_FUN_GLOBAL_VOLUME_ACCUMULATOR
-        ) or event_type_filter.should_include(
-            EventType.ACCOUNT_PUMP_FUN_USER_VOLUME_ACCUMULATOR
-        ):
+                return _filter_account_event(ev, event_type_filter)
+        return None
+
+    if account.owner in (PUMPFUN_PROGRAM_ID, PUMP_FEES_PROGRAM_ID):
+        should_parse_pumpfun = event_type_filter is None or (
+            event_type_filter.should_include(EventType.ACCOUNT_PUMP_FUN_GLOBAL)
+            or event_type_filter.should_include(EventType.ACCOUNT_PUMP_FUN_BONDING_CURVE)
+            or event_type_filter.should_include(EventType.ACCOUNT_PUMP_FUN_FEE_CONFIG)
+            or event_type_filter.should_include(EventType.ACCOUNT_PUMP_FUN_SHARING_CONFIG)
+            or event_type_filter.should_include(EventType.ACCOUNT_PUMP_FUN_GLOBAL_VOLUME_ACCUMULATOR)
+            or event_type_filter.should_include(EventType.ACCOUNT_PUMP_FUN_USER_VOLUME_ACCUMULATOR)
+        )
+        if should_parse_pumpfun:
             ev = _parse_pumpfun_account(account, metadata)
             if ev is not None:
-                return ev
+                return _filter_account_event(ev, event_type_filter)
+        return None
+
+    if account.owner == RAYDIUM_CLMM_PROGRAM_ID:
+        should_parse_clmm = event_type_filter is None or (
+            event_type_filter.should_include(EventType.ACCOUNT_RAYDIUM_CLMM_AMM_CONFIG)
+            or event_type_filter.should_include(EventType.ACCOUNT_RAYDIUM_CLMM_POOL_STATE)
+            or event_type_filter.should_include(EventType.ACCOUNT_RAYDIUM_CLMM_TICK_ARRAY_STATE)
+        )
+        if should_parse_clmm:
+            ev = parse_raydium_clmm_account(account, metadata)
+            if ev is not None:
+                return _filter_account_event(ev, event_type_filter)
+        return None
+
+    if account.owner == RAYDIUM_CPMM_PROGRAM_ID:
+        should_parse_cpmm = event_type_filter is None or (
+            event_type_filter.should_include(EventType.ACCOUNT_RAYDIUM_CPMM_AMM_CONFIG)
+            or event_type_filter.should_include(EventType.ACCOUNT_RAYDIUM_CPMM_POOL_STATE)
+        )
+        if should_parse_cpmm:
+            ev = parse_raydium_cpmm_account(account, metadata)
+            if ev is not None:
+                return _filter_account_event(ev, event_type_filter)
+        return None
+
+    if account.owner == ORCA_WHIRLPOOL_PROGRAM_ID:
+        should_parse_orca = event_type_filter is None or (
+            event_type_filter.should_include(EventType.ACCOUNT_ORCA_WHIRLPOOL)
+            or event_type_filter.should_include(EventType.ACCOUNT_ORCA_POSITION)
+            or event_type_filter.should_include(EventType.ACCOUNT_ORCA_TICK_ARRAY)
+            or event_type_filter.should_include(EventType.ACCOUNT_ORCA_FEE_TIER)
+            or event_type_filter.should_include(EventType.ACCOUNT_ORCA_WHIRLPOOLS_CONFIG)
+        )
+        if should_parse_orca:
+            ev = parse_orca_whirlpool_account(account, metadata)
+            if ev is not None:
+                return _filter_account_event(ev, event_type_filter)
+        return None
 
     if acc_utils.is_nonce_account(data):
         if event_type_filter is not None:
@@ -213,9 +281,11 @@ def parse_account_unified(
         return _parse_nonce_fast(account, metadata)
 
     if event_type_filter is not None:
-        if not event_type_filter.should_include(EventType.TOKEN_ACCOUNT):
+        if not event_type_filter.should_include(
+            EventType.TOKEN_ACCOUNT
+        ) and not event_type_filter.should_include(EventType.TOKEN_INFO):
             return None
-    return parse_token_account(account, metadata)
+    return _filter_account_event(parse_token_account(account, metadata), event_type_filter)
 
 
 def _parse_pumpswap_account(account: AccountData, metadata: EventMetadata) -> Optional[DexEvent]:
@@ -706,6 +776,9 @@ def _parse_pumpswap_pool_fast(account: AccountData, metadata: EventMetadata) ->
 
 
 def parse_token_account(account: AccountData, metadata: EventMetadata) -> Optional[DexEvent]:
+    if not acc_utils.is_token_program_account(account.owner):
+        return None
+
     if len(account.data) <= 100:
         event = _parse_mint_fast(account, metadata)
         if event:
@@ -830,12 +903,18 @@ __all__ = [
     "is_pumpfun_global_account",
     "parse_pumpswap_global_config",
     "parse_pumpswap_pool",
+    "parse_raydium_clmm_account",
+    "parse_raydium_cpmm_account",
+    "parse_orca_whirlpool_account",
     "is_global_config_account",
     "is_pool_account",
     "has_discriminator",
     "PUMPFUN_PROGRAM_ID",
     "PUMP_FEES_PROGRAM_ID",
     "PUMPSWAP_PROGRAM_ID",
+    "RAYDIUM_CLMM_PROGRAM_ID",
+    "RAYDIUM_CPMM_PROGRAM_ID",
+    "ORCA_WHIRLPOOL_PROGRAM_ID",
     "rpc_resolve_user_wallet_pubkey",
     "user_wallet_pubkey_for_onchain_account",
     "rpc_wallet",