sol-parser-sdk-python 0.4.4__py3-none-any.whl

sol_parser/__init__.py

@@ -0,0 +1,400 @@
+"""Solana DEX 日志解析 — 与本仓库 TS 包事件形态及解析约定对齐的子集与扩展入口。"""
+
+from .json_util import dex_event_json_dumps, dex_event_to_jsonable, format_dex_event_json
+from .parser import (
+    EventListener,
+    StreamingEventListener,
+    parse_log,
+    parse_log_optimized,
+    parse_log_unified,
+    parse_logs_only,
+    parse_logs_streaming,
+    parse_transaction_events,
+    parse_transaction_events_streaming,
+    parse_transaction_with_listener,
+    parse_transaction_with_streaming_listener,
+    warmup_parser,
+)
+from .clock import now_micros
+from .grpc_types import (
+    OrderMode,
+    CommitmentLevel,
+    SlotStatus,
+    EventType,
+    EventMetadata,
+    ClientConfig,
+    TransactionFilter,
+    AccountFilter,
+    Protocol,
+    SlotFilter,
+    account_filter_memcmp,
+    EventTypeFilter,
+    IncludeOnlyFilter,
+    ExcludeFilter,
+    SubscribeCallbacks,
+    SubscribeRequest,
+    SubscribeUpdate,
+    GetLatestBlockhashResponse,
+    GetBlockHeightResponse,
+    GetSlotResponse,
+    GetVersionResponse,
+    IsBlockhashValidResponse,
+    PongResponse,
+    SubscribeReplayInfoResponse,
+    event_type_filter_include_only,
+    event_type_filter_exclude,
+    event_type_filter_includes_pumpfun,
+    event_type_filter_includes_pumpswap,
+    event_type_filter_includes_meteora_damm_v2,
+    event_type_filter_includes_pump_fees,
+    event_type_filter_allows_instruction_parsing,
+    all_event_types,
+    program_ids_for_protocols,
+    transaction_filter_for_protocols,
+    account_filter_for_protocols,
+)
+from .event_types import (
+    # Base type
+    DexEventBase,
+    # PumpFun events
+    PumpFunTradeEvent,
+    PumpFunCreateEvent,
+    PumpFunCreateV2TokenEvent,
+    PumpFunMigrateEvent,
+    PumpFeesShareholder,
+    PumpFeesFees,
+    PumpFeesFeeTier,
+    PumpFeesCreateFeeSharingConfigEvent,
+    PumpFeesInitializeFeeConfigEvent,
+    PumpFeesResetFeeSharingConfigEvent,
+    PumpFeesRevokeFeeSharingAuthorityEvent,
+    PumpFeesTransferFeeSharingAuthorityEvent,
+    PumpFeesUpdateAdminEvent,
+    PumpFeesUpdateFeeConfigEvent,
+    PumpFeesUpdateFeeSharesEvent,
+    PumpFeesUpsertFeeTiersEvent,
+    PumpFunMigrateBondingCurveCreatorEvent,
+    # PumpSwap events
+    PumpSwapBuyEvent,
+    PumpSwapSellEvent,
+    PumpSwapCreatePoolEvent,
+    PumpSwapLiquidityAddedEvent,
+    PumpSwapLiquidityRemovedEvent,
+    # Raydium CLMM events
+    RaydiumClmmSwapEvent,
+    RaydiumClmmIncreaseLiquidityEvent,
+    RaydiumClmmDecreaseLiquidityEvent,
+    RaydiumClmmCreatePoolEvent,
+    RaydiumClmmOpenPositionEvent,
+    RaydiumClmmOpenPositionWithTokenExtNftEvent,
+    RaydiumClmmClosePositionEvent,
+    RaydiumClmmCollectFeeEvent,
+    # Raydium AMM V4 (legacy)
+    RaydiumAmmV4SwapEvent,
+    RaydiumAmmV4DepositEvent,
+    RaydiumAmmV4WithdrawEvent,
+    RaydiumAmmV4WithdrawPnlEvent,
+    RaydiumAmmV4Initialize2Event,
+    # Raydium CPMM events
+    RaydiumCpmmSwapEvent,
+    RaydiumCpmmDepositEvent,
+    RaydiumCpmmWithdrawEvent,
+    RaydiumCpmmInitializeEvent,
+    # Orca Whirlpool events
+    OrcaWhirlpoolSwapEvent,
+    OrcaWhirlpoolLiquidityIncreasedEvent,
+    OrcaWhirlpoolLiquidityDecreasedEvent,
+    OrcaWhirlpoolPoolInitializedEvent,
+    # Meteora DLMM events
+    MeteoraDlmmSwapEvent,
+    MeteoraDlmmAddLiquidityEvent,
+    MeteoraDlmmRemoveLiquidityEvent,
+    MeteoraDlmmInitializePoolEvent,
+    MeteoraDlmmInitializeBinArrayEvent,
+    MeteoraDlmmCreatePositionEvent,
+    MeteoraDlmmClosePositionEvent,
+    MeteoraDlmmClaimFeeEvent,
+    # Meteora Pools events
+    MeteoraPoolsSetPoolFeesEvent,
+    MeteoraPoolsSwapEvent,
+    MeteoraPoolsAddLiquidityEvent,
+    MeteoraPoolsRemoveLiquidityEvent,
+    MeteoraPoolsBootstrapLiquidityEvent,
+    MeteoraPoolsPoolCreatedEvent,
+    # Meteora DAMM v2 events
+    MeteoraDammV2SwapEvent,
+    MeteoraDammV2CreatePositionEvent,
+    MeteoraDammV2ClosePositionEvent,
+    MeteoraDammV2AddLiquidityEvent,
+    MeteoraDammV2RemoveLiquidityEvent,
+    MeteoraDammV2InitializePoolEvent,
+    # Bonk events
+    BonkTradeEvent,
+    BonkPoolCreateEvent,
+    BonkMigrateAmmEvent,
+    # Union type and helper
+    TypedDexEvent,
+    to_typed_event,
+    legacy_dict_to_dex_event,
+)
+from .pumpfun_fee_enrich import (
+    enrich_create_v2_observed_fee_recipient,
+    enrich_pumpfun_same_tx_post_merge,
+    enrich_pumpfun_trades_from_create_instructions,
+)
+from .grpc_instruction_parser import (
+    apply_account_fill_to_events,
+    enrich_dex_events_with_subscribe_tx_info,
+    parse_instructions_enhanced_from_parsed,
+    parse_instructions_enhanced_from_subscribe_tx_info,
+    merge_instruction_events,
+    detect_pumpfun_create_from_logs,
+)
+from .merger import merge_dex_events
+from .account_dispatcher import fill_accounts_with_owned_keys, fill_data
+from .entries_decode import decode_entries_bincode_flat
+from .shredstream_client import ShredStreamClient, ShredStreamConfig
+from .env_config import (
+    load_dotenv_silent,
+    parse_grpc_credentials,
+    parse_optional_rpc_url,
+    parse_rpc_and_tx_signature,
+    parse_shredstream_url,
+    require_grpc_env,
+)
+from .grpc_client import parse_commitment_level
+from .grpc_client import (
+    YellowstoneGrpc,
+    Subscription,
+)
+from .rpc_parser import (
+    ParseError,
+    RpcClient,
+    RpcTransactionResponse,
+    RpcTransactionMeta,
+    RpcTransaction,
+    enrich_dex_events_from_rpc_get_transaction_result,
+    parse_transaction_from_rpc,
+    parse_rpc_transaction,
+    convert_rpc_to_grpc,
+    rpc_get_transaction_result_dict_to_response,
+    rpc_response_to_solana_storage,
+)
+from .accounts import (
+    AccountData,
+    parse_account_unified,
+    parse_token_account,
+    parse_nonce_account,
+    parse_pumpfun_global,
+    is_nonce_account,
+    is_pumpfun_global_account,
+    parse_pumpswap_global_config,
+    parse_pumpswap_pool,
+    is_global_config_account,
+    is_pool_account,
+    has_discriminator,
+    rpc_resolve_user_wallet_pubkey,
+    user_wallet_pubkey_for_onchain_account,
+)
+from .grpc.subscribe_builder import (
+    build_subscribe_request,
+    build_subscribe_request_with_commitment,
+    build_subscribe_transaction_filters_named,
+)
+from .instructions import (
+    parse_instruction_unified,
+    parse_pumpfun_instruction,
+    parse_pumpswap_instruction,
+    parse_meteora_damm_instruction,
+    parse_pump_fees_instruction,
+)
+
+__all__ = [
+    # Parser functions
+    "dex_event_json_dumps",
+    "dex_event_to_jsonable",
+    "format_dex_event_json",
+    "apply_account_fill_to_events",
+    "enrich_dex_events_with_subscribe_tx_info",
+    "parse_log_unified",
+    "parse_log_optimized",
+    "parse_log",
+    "parse_logs_only",
+    "parse_logs_streaming",
+    "parse_transaction_events",
+    "parse_transaction_events_streaming",
+    "parse_transaction_with_listener",
+    "parse_transaction_with_streaming_listener",
+    "EventListener",
+    "StreamingEventListener",
+    "warmup_parser",
+    "now_micros",
+    # RPC parser
+    "ParseError",
+    "RpcClient",
+    "RpcTransactionResponse",
+    "RpcTransactionMeta",
+    "RpcTransaction",
+    "parse_transaction_from_rpc",
+    "parse_rpc_transaction",
+    "convert_rpc_to_grpc",
+    "enrich_dex_events_from_rpc_get_transaction_result",
+    "rpc_get_transaction_result_dict_to_response",
+    "rpc_response_to_solana_storage",
+    # Accounts
+    "AccountData",
+    "parse_account_unified",
+    "parse_token_account",
+    "parse_nonce_account",
+    "parse_pumpfun_global",
+    "is_nonce_account",
+    "is_pumpfun_global_account",
+    "parse_pumpswap_global_config",
+    "parse_pumpswap_pool",
+    "is_global_config_account",
+    "is_pool_account",
+    "has_discriminator",
+    "rpc_resolve_user_wallet_pubkey",
+    "user_wallet_pubkey_for_onchain_account",
+    "build_subscribe_request",
+    "build_subscribe_request_with_commitment",
+    "build_subscribe_transaction_filters_named",
+    # Instructions
+    "parse_instruction_unified",
+    "parse_pumpfun_instruction",
+    "parse_pumpswap_instruction",
+    "parse_meteora_damm_instruction",
+    "parse_pump_fees_instruction",
+    # gRPC types
+    "OrderMode",
+    "CommitmentLevel",
+    "SlotStatus",
+    "EventType",
+    "EventMetadata",
+    "ClientConfig",
+    "TransactionFilter",
+    "AccountFilter",
+    "Protocol",
+    "SlotFilter",
+    "account_filter_memcmp",
+    "EventTypeFilter",
+    "IncludeOnlyFilter",
+    "ExcludeFilter",
+    "SubscribeCallbacks",
+    "SubscribeRequest",
+    "SubscribeUpdate",
+    "GetLatestBlockhashResponse",
+    "GetBlockHeightResponse",
+    "GetSlotResponse",
+    "GetVersionResponse",
+    "IsBlockhashValidResponse",
+    "PongResponse",
+    "SubscribeReplayInfoResponse",
+    # gRPC filter helpers
+    "event_type_filter_include_only",
+    "event_type_filter_exclude",
+    "event_type_filter_includes_pumpfun",
+    "event_type_filter_includes_pumpswap",
+    "event_type_filter_includes_meteora_damm_v2",
+    "event_type_filter_includes_pump_fees",
+    "event_type_filter_allows_instruction_parsing",
+    "all_event_types",
+    "program_ids_for_protocols",
+    "transaction_filter_for_protocols",
+    "account_filter_for_protocols",
+    "parse_commitment_level",
+    # Env / CLI (aligned with sol-parser-sdk-nodejs)
+    "load_dotenv_silent",
+    "parse_grpc_credentials",
+    "parse_optional_rpc_url",
+    "parse_rpc_and_tx_signature",
+    "parse_shredstream_url",
+    "require_grpc_env",
+    # gRPC client
+    "YellowstoneGrpc",
+    "Subscription",
+    # Typed events
+    "DexEventBase",
+    "PumpFunTradeEvent",
+    "PumpFunCreateEvent",
+    "PumpFunCreateV2TokenEvent",
+    "PumpFunMigrateEvent",
+    "PumpFeesShareholder",
+    "PumpFeesFees",
+    "PumpFeesFeeTier",
+    "PumpFeesCreateFeeSharingConfigEvent",
+    "PumpFeesInitializeFeeConfigEvent",
+    "PumpFeesResetFeeSharingConfigEvent",
+    "PumpFeesRevokeFeeSharingAuthorityEvent",
+    "PumpFeesTransferFeeSharingAuthorityEvent",
+    "PumpFeesUpdateAdminEvent",
+    "PumpFeesUpdateFeeConfigEvent",
+    "PumpFeesUpdateFeeSharesEvent",
+    "PumpFeesUpsertFeeTiersEvent",
+    "PumpFunMigrateBondingCurveCreatorEvent",
+    "PumpSwapBuyEvent",
+    "PumpSwapSellEvent",
+    "PumpSwapCreatePoolEvent",
+    "PumpSwapLiquidityAddedEvent",
+    "PumpSwapLiquidityRemovedEvent",
+    "RaydiumClmmSwapEvent",
+    "RaydiumClmmIncreaseLiquidityEvent",
+    "RaydiumClmmDecreaseLiquidityEvent",
+    "RaydiumClmmCreatePoolEvent",
+    "RaydiumClmmOpenPositionEvent",
+    "RaydiumClmmOpenPositionWithTokenExtNftEvent",
+    "RaydiumClmmClosePositionEvent",
+    "RaydiumClmmCollectFeeEvent",
+    "RaydiumAmmV4SwapEvent",
+    "RaydiumAmmV4DepositEvent",
+    "RaydiumAmmV4WithdrawEvent",
+    "RaydiumAmmV4WithdrawPnlEvent",
+    "RaydiumAmmV4Initialize2Event",
+    "RaydiumCpmmSwapEvent",
+    "RaydiumCpmmDepositEvent",
+    "RaydiumCpmmWithdrawEvent",
+    "RaydiumCpmmInitializeEvent",
+    "OrcaWhirlpoolSwapEvent",
+    "OrcaWhirlpoolLiquidityIncreasedEvent",
+    "OrcaWhirlpoolLiquidityDecreasedEvent",
+    "OrcaWhirlpoolPoolInitializedEvent",
+    "MeteoraDlmmSwapEvent",
+    "MeteoraDlmmAddLiquidityEvent",
+    "MeteoraDlmmRemoveLiquidityEvent",
+    "MeteoraDlmmInitializePoolEvent",
+    "MeteoraDlmmInitializeBinArrayEvent",
+    "MeteoraDlmmCreatePositionEvent",
+    "MeteoraDlmmClosePositionEvent",
+    "MeteoraDlmmClaimFeeEvent",
+    "MeteoraPoolsSetPoolFeesEvent",
+    "MeteoraPoolsSwapEvent",
+    "MeteoraPoolsAddLiquidityEvent",
+    "MeteoraPoolsRemoveLiquidityEvent",
+    "MeteoraPoolsBootstrapLiquidityEvent",
+    "MeteoraPoolsPoolCreatedEvent",
+    "MeteoraDammV2SwapEvent",
+    "MeteoraDammV2CreatePositionEvent",
+    "MeteoraDammV2ClosePositionEvent",
+    "MeteoraDammV2AddLiquidityEvent",
+    "MeteoraDammV2RemoveLiquidityEvent",
+    "MeteoraDammV2InitializePoolEvent",
+    "BonkTradeEvent",
+    "BonkPoolCreateEvent",
+    "BonkMigrateAmmEvent",
+    "TypedDexEvent",
+    "to_typed_event",
+    "legacy_dict_to_dex_event",
+    "enrich_create_v2_observed_fee_recipient",
+    "enrich_pumpfun_same_tx_post_merge",
+    "enrich_pumpfun_trades_from_create_instructions",
+    "parse_instructions_enhanced_from_parsed",
+    "parse_instructions_enhanced_from_subscribe_tx_info",
+    "merge_instruction_events",
+    "merge_dex_events",
+    "detect_pumpfun_create_from_logs",
+    "fill_accounts_with_owned_keys",
+    "fill_data",
+    "decode_entries_bincode_flat",
+    "ShredStreamClient",
+    "ShredStreamConfig",
+]

sol_parser/account_dispatcher.py

@@ -0,0 +1,209 @@
+"""账户上下文填充（对齐 Rust ``account_dispatcher`` / ``common_filler``）。"""
+
+from __future__ import annotations
+
+from typing import Any, Dict, List, Optional, Tuple
+
+import base58
+
+from .account_fillers import bonk, 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,
+    METEORA_DAMM_V2_PROGRAM_ID,
+    METEORA_DLMM_PROGRAM_ID,
+    METEORA_POOLS_PROGRAM_ID,
+    ORCA_WHIRLPOOL_PROGRAM_ID,
+    PUMPFUN_PROGRAM_ID,
+    PUMPSWAP_FEES_PROGRAM_ID,
+    PUMPSWAP_PROGRAM_ID,
+    RAYDIUM_AMM_V4_PROGRAM_ID,
+    RAYDIUM_CLMM_PROGRAM_ID,
+    RAYDIUM_CPMM_PROGRAM_ID,
+)
+
+
+def find_instruction_invoke(
+    invokes: List[Tuple[int, int]],
+    meta_pb: Any,
+    transaction_pb: Any,
+) -> Optional[Tuple[int, int]]:
+    """账户数最多的 invoke（与 Rust ``find_instruction_invoke`` 一致）。"""
+    best: Optional[Tuple[int, int]] = None
+    best_len = -1
+    for outer_idx, inner_idx in invokes:
+        n = 0
+        if inner_idx >= 0:
+            for inn in meta_pb.inner_instructions:
+                if int(inn.index) == int(outer_idx):
+                    if inner_idx < len(inn.instructions):
+                        n = len(inn.instructions[inner_idx].accounts)
+                    break
+        else:
+            msg = transaction_pb.message
+            if outer_idx < len(msg.instructions):
+                n = len(msg.instructions[outer_idx].accounts)
+        if n > best_len:
+            best_len = n
+            best = (outer_idx, inner_idx)
+    return best
+
+
+def get_instruction_data(
+    meta_pb: Any,
+    transaction_pb: Any,
+    index: Tuple[int, int],
+) -> Optional[bytes]:
+    oi, ii = index
+    if ii >= 0:
+        for inn in meta_pb.inner_instructions:
+            if int(inn.index) == int(oi):
+                if ii < len(inn.instructions):
+                    return bytes(inn.instructions[ii].data)
+                return None
+        return None
+    msg = transaction_pb.message
+    if oi < len(msg.instructions):
+        return bytes(msg.instructions[oi].data)
+    return None
+
+
+def fill_accounts_with_owned_keys(
+    event: DexEvent,
+    meta_pb: Any,
+    transaction_pb: Any,
+    invokes: Dict[bytes, List[Tuple[int, int]]],
+) -> None:
+    if transaction_pb is None:
+        return
+    static_keys = [bytes(x) for x in transaction_pb.message.account_keys]
+    w = [bytes(x) for x in meta_pb.loaded_writable_addresses]
+    r = [bytes(x) for x in meta_pb.loaded_readonly_addresses]
+
+    def run(program_b58: str, filler) -> None:
+        pid = base58.b58decode(program_b58)
+        inv = invokes.get(pid)
+        if not inv:
+            return
+        ix = find_instruction_invoke(inv, meta_pb, transaction_pb)
+        if ix is None:
+            return
+        get = get_instruction_account_getter(meta_pb, transaction_pb, static_keys, w, r, ix)
+        if get is None:
+            return
+        filler(get)
+
+    et = event.type
+    data = event.data
+
+    if et in (
+        EventType.PUMP_FUN_TRADE,
+        EventType.PUMP_FUN_BUY,
+        EventType.PUMP_FUN_SELL,
+        EventType.PUMP_FUN_BUY_EXACT_SOL_IN,
+    ):
+        run(PUMPFUN_PROGRAM_ID, lambda g: pumpfun.fill_trade_accounts(data, g))
+    elif et == EventType.PUMP_FUN_CREATE:
+        run(PUMPFUN_PROGRAM_ID, lambda g: pumpfun.fill_create_accounts(data, g))
+    elif et == EventType.PUMP_FUN_CREATE_V2:
+        run(PUMPFUN_PROGRAM_ID, lambda g: pumpfun.fill_create_v2_accounts(data, g))
+    elif et == EventType.PUMP_FUN_MIGRATE:
+        run(PUMPFUN_PROGRAM_ID, lambda g: pumpfun.fill_migrate_accounts(data, g))
+    elif et == EventType.PUMP_SWAP_BUY:
+        run(PUMPSWAP_PROGRAM_ID, lambda g: pumpswap.fill_buy_accounts(data, g))
+    elif et == EventType.PUMP_SWAP_SELL:
+        run(PUMPSWAP_PROGRAM_ID, lambda g: pumpswap.fill_sell_accounts(data, g))
+    elif et == EventType.PUMP_SWAP_TRADE:
+        run(PUMPSWAP_PROGRAM_ID, lambda g: pumpswap.fill_trade_accounts(data, g))
+    elif et == EventType.PUMP_SWAP_CREATE_POOL:
+        run(PUMPSWAP_PROGRAM_ID, lambda g: pumpswap.fill_create_pool_accounts(data, g))
+    elif et == EventType.PUMP_SWAP_LIQUIDITY_ADDED:
+        run(PUMPSWAP_PROGRAM_ID, lambda g: pumpswap.fill_liquidity_added_accounts(data, g))
+    elif et == EventType.PUMP_SWAP_LIQUIDITY_REMOVED:
+        run(PUMPSWAP_PROGRAM_ID, lambda g: pumpswap.fill_liquidity_removed_accounts(data, g))
+    elif et == EventType.RAYDIUM_CLMM_SWAP:
+        run(RAYDIUM_CLMM_PROGRAM_ID, lambda g: raydium.fill_clmm_swap_accounts(data, g))
+    elif et == EventType.RAYDIUM_CLMM_CREATE_POOL:
+        run(RAYDIUM_CLMM_PROGRAM_ID, lambda g: raydium.fill_clmm_create_pool_accounts(data, g))
+    elif et == EventType.RAYDIUM_CLMM_OPEN_POSITION:
+        run(RAYDIUM_CLMM_PROGRAM_ID, lambda g: raydium.fill_clmm_open_position_accounts(data, g))
+    elif et == EventType.RAYDIUM_CLMM_OPEN_POSITION_WITH_TOKEN_EXT_NFT:
+        run(RAYDIUM_CLMM_PROGRAM_ID, lambda g: raydium.fill_clmm_open_position_with_token_ext_nft_accounts(data, g))
+    elif et == EventType.RAYDIUM_CLMM_CLOSE_POSITION:
+        run(RAYDIUM_CLMM_PROGRAM_ID, lambda g: raydium.fill_clmm_close_position_accounts(data, g))
+    elif et == EventType.RAYDIUM_CLMM_INCREASE_LIQUIDITY:
+        run(RAYDIUM_CLMM_PROGRAM_ID, lambda g: raydium.fill_clmm_increase_liquidity_accounts(data, g))
+    elif et == EventType.RAYDIUM_CLMM_DECREASE_LIQUIDITY:
+        run(RAYDIUM_CLMM_PROGRAM_ID, lambda g: raydium.fill_clmm_decrease_liquidity_accounts(data, g))
+    elif et == EventType.RAYDIUM_CPMM_SWAP:
+        run(RAYDIUM_CPMM_PROGRAM_ID, lambda g: raydium.fill_cpmm_swap_accounts(data, g))
+    elif et == EventType.RAYDIUM_CPMM_DEPOSIT:
+        run(RAYDIUM_CPMM_PROGRAM_ID, lambda g: raydium.fill_cpmm_deposit_accounts(data, g))
+    elif et == EventType.RAYDIUM_CPMM_WITHDRAW:
+        run(RAYDIUM_CPMM_PROGRAM_ID, lambda g: raydium.fill_cpmm_withdraw_accounts(data, g))
+    elif et == EventType.RAYDIUM_CPMM_INITIALIZE:
+        run(RAYDIUM_CPMM_PROGRAM_ID, lambda g: raydium.fill_cpmm_initialize_accounts(data, g))
+    elif et == EventType.RAYDIUM_AMM_V4_SWAP:
+        run(RAYDIUM_AMM_V4_PROGRAM_ID, lambda g: raydium.fill_amm_v4_swap_accounts(data, g))
+    elif et == EventType.RAYDIUM_AMM_V4_DEPOSIT:
+        run(RAYDIUM_AMM_V4_PROGRAM_ID, lambda g: raydium.fill_amm_v4_deposit_accounts(data, g))
+    elif et == EventType.RAYDIUM_AMM_V4_WITHDRAW:
+        run(RAYDIUM_AMM_V4_PROGRAM_ID, lambda g: raydium.fill_amm_v4_withdraw_accounts(data, g))
+    elif et == EventType.ORCA_WHIRLPOOL_SWAP:
+        run(ORCA_WHIRLPOOL_PROGRAM_ID, lambda g: orca.fill_whirlpool_swap_accounts(data, g))
+    elif et == EventType.ORCA_WHIRLPOOL_LIQUIDITY_INCREASED:
+        run(ORCA_WHIRLPOOL_PROGRAM_ID, lambda g: orca.fill_whirlpool_liquidity_increased_accounts(data, g))
+    elif et == EventType.ORCA_WHIRLPOOL_LIQUIDITY_DECREASED:
+        run(ORCA_WHIRLPOOL_PROGRAM_ID, lambda g: orca.fill_whirlpool_liquidity_decreased_accounts(data, g))
+    elif et == EventType.METEORA_DAMM_V2_SWAP:
+        run(METEORA_DAMM_V2_PROGRAM_ID, lambda g: meteora.fill_damm_v2_swap_accounts(data, g))
+    elif et == EventType.METEORA_DAMM_V2_CREATE_POSITION:
+        run(METEORA_DAMM_V2_PROGRAM_ID, lambda g: meteora.fill_damm_v2_create_position_accounts(data, g))
+    elif et == EventType.METEORA_DAMM_V2_CLOSE_POSITION:
+        run(METEORA_DAMM_V2_PROGRAM_ID, lambda g: meteora.fill_damm_v2_close_position_accounts(data, g))
+    elif et == EventType.METEORA_DAMM_V2_ADD_LIQUIDITY:
+        run(METEORA_DAMM_V2_PROGRAM_ID, lambda g: meteora.fill_damm_v2_add_liquidity_accounts(data, g))
+    elif et == EventType.METEORA_DAMM_V2_REMOVE_LIQUIDITY:
+        run(METEORA_DAMM_V2_PROGRAM_ID, lambda g: meteora.fill_damm_v2_remove_liquidity_accounts(data, g))
+    elif et == EventType.METEORA_POOLS_SWAP:
+        run(METEORA_POOLS_PROGRAM_ID, lambda g: meteora.fill_pools_swap_accounts(data, g))
+    elif et == EventType.METEORA_POOLS_ADD_LIQUIDITY:
+        run(METEORA_POOLS_PROGRAM_ID, lambda g: meteora.fill_pools_add_liquidity_accounts(data, g))
+    elif et == EventType.METEORA_POOLS_REMOVE_LIQUIDITY:
+        run(METEORA_POOLS_PROGRAM_ID, lambda g: meteora.fill_pools_remove_liquidity_accounts(data, g))
+    elif et == EventType.METEORA_DLMM_SWAP:
+        run(METEORA_DLMM_PROGRAM_ID, lambda g: meteora.fill_dlmm_swap_accounts(data, g))
+    elif et == EventType.METEORA_DLMM_ADD_LIQUIDITY:
+        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))
+
+
+def fill_data(
+    event: DexEvent,
+    meta_pb: Any,
+    transaction_pb: Any,
+    invokes_str: Dict[str, List[Tuple[int, int]]],
+) -> None:
+    """对齐 Rust ``common_filler::fill_data``（PumpSwap Buy/Sell ``is_pump_pool``）。"""
+    if transaction_pb is None:
+        return
+    et = event.type
+    data = event.data
+    if et not in (EventType.PUMP_SWAP_BUY, EventType.PUMP_SWAP_SELL):
+        return
+    inv = invokes_str.get(PUMPSWAP_FEES_PROGRAM_ID)
+    if not inv:
+        return
+    ix = inv[-1]
+    raw = get_instruction_data(meta_pb, transaction_pb, ix)
+    if raw is None or len(raw) <= 9:
+        return
+    is_pump = raw[9] != 0
+    setattr(data, "is_pump_pool", is_pump)

sol_parser/account_fillers/__init__.py

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

sol_parser/account_fillers/bonk.py

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

sol_parser/account_fillers/meteora.py

@@ -0,0 +1,51 @@
+"""Meteora 账户填充（对齐 ``account_fillers/meteora.rs``，多数为占位）。"""
+
+from __future__ import annotations
+
+from typing import Any, Callable
+
+AccountGetter = Callable[[int], str]
+
+
+def fill_damm_v2_swap_accounts(_e: Any, _get: AccountGetter) -> None:
+    pass
+
+
+def fill_damm_v2_create_position_accounts(_e: Any, _get: AccountGetter) -> None:
+    pass
+
+
+def fill_damm_v2_close_position_accounts(_e: Any, _get: AccountGetter) -> None:
+    pass
+
+
+def fill_damm_v2_add_liquidity_accounts(_e: Any, _get: AccountGetter) -> None:
+    pass
+
+
+def fill_damm_v2_remove_liquidity_accounts(_e: Any, _get: AccountGetter) -> None:
+    pass
+
+
+def fill_pools_swap_accounts(_e: Any, _get: AccountGetter) -> None:
+    pass
+
+
+def fill_pools_add_liquidity_accounts(_e: Any, _get: AccountGetter) -> None:
+    pass
+
+
+def fill_pools_remove_liquidity_accounts(_e: Any, _get: AccountGetter) -> None:
+    pass
+
+
+def fill_dlmm_swap_accounts(_e: Any, _get: AccountGetter) -> None:
+    pass
+
+
+def fill_dlmm_add_liquidity_accounts(_e: Any, _get: AccountGetter) -> None:
+    pass
+
+
+def fill_dlmm_remove_liquidity_accounts(_e: Any, _get: AccountGetter) -> None:
+    pass