sol-parser-sdk-python 0.5.12__py3-none-any.whl → 0.5.14__py3-none-any.whl

sol_parser/__init__.py

@@ -511,3 +511,8 @@ from .pump_upgrade import decode_pump_multi_hop_intent
 
 from .pump_upgrade import PumpFunPostCompleteBuyEvent, PumpFunSweepBondingCurveFeeEvent, PumpFunCompleteEvent, PumpSwapSweepPoolFeeEvent
 __all__ += ['decode_pump_multi_hop_intent','PumpFunPostCompleteBuyEvent','PumpFunSweepBondingCurveFeeEvent','PumpFunCompleteEvent','PumpSwapSweepPoolFeeEvent']
+
+from .pump_routes import PumpRouteHop, PumpRouteIntentEvent
+from .shredstream_client import parse_shred_transaction, parse_shred_transaction_with_loaded_addresses, parse_shred_transaction_best_effort
+
+__all__ += ["PumpRouteHop", "PumpRouteIntentEvent", "parse_shred_transaction", "parse_shred_transaction_with_loaded_addresses", "parse_shred_transaction_best_effort"]

sol_parser/event_type_parity.py

@@ -119,6 +119,7 @@ RUST_EVENT_TYPES = [
     "AccountOrcaTickArray",
     "AccountOrcaFeeTier",
     "AccountOrcaWhirlpoolsConfig",
+    "PumpRouteIntent",
 ]
 
 

sol_parser/event_types.py

@@ -19,10 +19,13 @@
 from __future__ import annotations
 
 from dataclasses import dataclass, field
-from typing import Union, List, Optional, Any, Generic, TypeVar, Dict, Tuple
+from typing import TYPE_CHECKING, Union, List, Optional, Any, Generic, TypeVar, Dict, Tuple
 
 from .grpc_types import EventMetadata, EventType
 
+if TYPE_CHECKING:
+    from .pump_routes import PumpRouteIntentEvent
+
 T = TypeVar('T')
 
 
@@ -1620,6 +1623,7 @@ class RaydiumLaunchlabMigrateAmmEvent(DexEventBase):
 # ============================================================
 
 TypedDexEvent = Union[
+    "PumpRouteIntentEvent",
     PumpFunTradeEvent,
     PumpFunCreateEvent,
     PumpFunCreateV2TokenEvent,
@@ -1812,6 +1816,14 @@ def to_typed_event(event: dict) -> Optional[TypedDexEvent]:
             values={name:(_get_str(data,name) if typ=='pubkey' else _get_int(data,name)) for name,typ in fields}
             return cls(metadata=meta,**values)
 
+    if event_type == EventType.PUMP_ROUTE_INTENT:
+        from .pump_routes import PumpRouteHop, PumpRouteIntentEvent
+        return PumpRouteIntentEvent(metadata=meta,kind=data['kind'],program=data['program'],
+            instruction_index=int(data['instruction_index']),user=data['user'],input_account=data['input_account'],output_account=data['output_account'],
+            amount_in=None if data.get('amount_in') is None else int(data['amount_in']),min_amount_out=None if data.get('min_amount_out') is None else int(data['min_amount_out']),
+            hops=[PumpRouteHop(**h) for h in data['hops']],instruction_data=list(data['instruction_data']),
+            is_buy=data.get('is_buy'),ix_name=data.get('ix_name'))
+
     # PumpFun events
     if event_type in (EventType.PUMP_FUN_TRADE, EventType.PUMP_FUN_BUY,
                       EventType.PUMP_FUN_SELL, EventType.PUMP_FUN_BUY_EXACT_SOL_IN):

sol_parser/grpc_types.py

@@ -47,6 +47,7 @@ class EventType(str, Enum):
     RAYDIUM_LAUNCHLAB_TRADE = "RaydiumLaunchlabTrade"
     RAYDIUM_LAUNCHLAB_POOL_CREATE = "RaydiumLaunchlabPoolCreate"
     RAYDIUM_LAUNCHLAB_MIGRATE_AMM = "RaydiumLaunchlabMigrateAmm"
+    PUMP_ROUTE_INTENT = "PumpRouteIntent"
     # PumpFun
     PUMP_FUN_TRADE = "PumpFunTrade"
     PUMP_FUN_BUY = "PumpFunBuy"
@@ -312,6 +313,7 @@ RAYDIUM_LAUNCHLAB_FILTER_TYPES = (
     EventType.RAYDIUM_LAUNCHLAB_MIGRATE_AMM,
 )
 INSTRUCTION_EVENT_TYPES = (
+    EventType.PUMP_ROUTE_INTENT,
     *PUMPFUN_FILTER_TYPES,
     *PUMP_FEES_EVENT_TYPES,
     *PUMPSWAP_FILTER_TYPES,
@@ -458,6 +460,7 @@ def all_event_types() -> List[EventType]:
         EventType.ACCOUNT_ORCA_TICK_ARRAY,
         EventType.ACCOUNT_ORCA_FEE_TIER,
         EventType.ACCOUNT_ORCA_WHIRLPOOLS_CONFIG,
+        EventType.PUMP_ROUTE_INTENT,
     ]
 
 

sol_parser/pump_routes.py

@@ -0,0 +1,96 @@
+"""Program-bound offline route intents. These are never confirmed fills."""
+from dataclasses import dataclass, field
+from typing import Optional
+from .event_types import DexEvent, DexEventBase
+from .grpc_types import EventType
+
+PUMP='6EF8rrecthR5Dkzon8Nwu78hRvfCKubJ14M5uBEwF6P'
+AMM='pAMMBay6oceH9fJKBRHGP5D4bD4sWpmSwMn52FMfXEA'
+RAPID='rapidV5DAKtecYzetwCNoxXWHpezjeg4hGt9BGiVcGW'
+DELTA='J7pourVwqP1VtRNBiFNqbdGxwkx7ta2LHAURURRRJqmd'
+TOKEN='TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA'
+TOKEN22='TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb'
+SYSTEM='11111111111111111111111111111111'
+ATA='ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL'
+GLOBAL='4wTV1YmiEkRvAtNtsSGPtUrqRYQMe5SKy2uB4Jjaxnjf'
+EVENT='Ce6TQqeHC9p8KetsN6JsjHK7UTZk7nasjjnr7XxXp9F1'
+FEES='pfeeUxB6jkeY1Hxd7CsFCAjcbHA9rWtchMGdZ6VojVZ'
+MULTI=bytes([43,100,73,19,233,246,111,148])
+CURVE=bytes([225,154,117,22,215,86,246,103])
+
+@dataclass
+class PumpRouteHop:
+    base_mint: str
+    quote_mint: str
+    venue: str
+    base_vault: str
+    quote_vault: str
+
+@dataclass
+class PumpRouteIntentEvent(DexEventBase):
+    kind: str = ''
+    program: str = ''
+    instruction_index: int = 0
+    user: str = ''
+    input_account: str = ''
+    output_account: str = ''
+    amount_in: Optional[int] = None
+    min_amount_out: Optional[int] = None
+    hops: list[PumpRouteHop] = field(default_factory=list)
+    instruction_data: list[int] = field(default_factory=list)
+    # Intended direction relative to the wrapper hop's base mint, not a fill.
+    is_buy: Optional[bool] = None
+    # Official underlying instruction name encoded in the wrapper; unknown is None.
+    ix_name: Optional[str] = None
+
+
+def allows_route(filter, program):
+    if filter is None:
+        return True
+    excluded=getattr(filter,'exclude_types',())
+    if EventType.PUMP_ROUTE_INTENT in excluded or EventType.PUMP_FUN_TRADE in excluded or (program==AMM and EventType.PUMP_SWAP_TRADE in excluded):
+        return False
+    included=getattr(filter,'include_only',None)
+    if included is not None:
+        return any(k in included for k in (EventType.PUMP_ROUTE_INTENT,EventType.PUMP_FUN_TRADE)) or (program==AMM and EventType.PUMP_SWAP_TRADE in included)
+    return filter.should_include(EventType.PUMP_ROUTE_INTENT)
+
+
+def may_parse_route(program, data):
+    return ((program==AMM and data[:8]==MULTI) or (program==PUMP and data[:8]==CURVE)
+        or (program==DELTA and len(data)==28 and data[:8]==bytes([122,28,94,147,180,45,240,97]))
+        or (program==RAPID and len(data)==41 and data[0]==0 and data[9:17]==bytes([1,0,0,27,15,14,8,24]) and data[17:25]==bytes([194,171,28,70,104,77,91,47]) and data[25:33]==bytes(8)))
+
+
+def multi_hop_args(program,data,a):
+    if program!=AMM or len(data)!=24 or data[:8]!=MULTI or len(a)<21 or (len(a)-16)%5 or any(a[i]!=v for i,v in {7:TOKEN,8:TOKEN22,9:SYSTEM,11:AMM,12:PUMP}.items()):
+        return None
+    amount=int.from_bytes(data[8:16],'little')
+    return (amount,int.from_bytes(data[16:24],'little')) if amount else None
+
+
+def parse_route(program,data,a,metadata,index,filter=None):
+    if not may_parse_route(program,data) or not allows_route(filter,program):
+        return None
+    u=lambda at:int.from_bytes(data[at:at+8],'little')
+    if program==AMM:
+        args=multi_hop_args(program,data,a)
+        if args is None:return None
+        kind,fixed,user,source,dest,amount,minimum='MultiHopSwap',16,0,1,2,*args
+    elif program==PUMP:
+        if len(data)<20:return None
+        count=int.from_bytes(data[16:20],'little')
+        if not count or len(data)!=20+count or len(a)!=13+count*5 or any(a[i]!=v for i,v in {8:TOKEN,9:TOKEN22,10:SYSTEM,11:EVENT,12:PUMP}.items()):return None
+        kind,fixed,user,source,dest,amount,minimum='MultiHopCurveSwap',13,3,5,6,u(8),None
+    elif program==RAPID:
+        if len(a)!=33 or a[0]!=a[19] or a[2]!=a[8] or a[9] not in (TOKEN,TOKEN22) or any(a[i]!=v for i,v in {3:TOKEN,4:SYSTEM,5:PUMP,6:GLOBAL,10:TOKEN,11:ATA,29:FEES,30:SYSTEM,31:EVENT,32:PUMP}.items()):return None
+        kind,fixed,user,source,dest,amount,minimum='RapidBuy',0,0,21,20,u(1),u(33)
+    else:
+        if len(a)!=30 or a[0]!=a[14] or a[4] not in (TOKEN,TOKEN22) or a[5] not in (TOKEN,TOKEN22) or any(a[i]!=v for i,v in {1:GLOBAL,6:ATA,24:FEES,25:SYSTEM,26:EVENT,27:PUMP}.items()):return None
+        kind,fixed,user,source,dest,amount,minimum='BuyPumpDelta',0,0,16,15,None,None
+    if amount==0:return None
+    hops=[PumpRouteHop(*a[i:i+5]) for i in range(fixed,len(a),5)] if fixed else [PumpRouteHop(*(a[i] for i in ((7,2,16,17,18) if program==RAPID else (2,3,11,12,13))))]
+    return DexEvent(EventType.PUMP_ROUTE_INTENT,PumpRouteIntentEvent(
+        metadata,kind,program,index,a[user],a[source],a[dest],amount,minimum,hops,list(data),
+        is_buy=True if kind in ('RapidBuy', 'BuyPumpDelta') else None,
+        ix_name='buy_exact_quote_in_v2' if kind == 'RapidBuy' else None))

sol_parser/pump_upgrade.py

@@ -163,18 +163,11 @@ def parse_pump_upgrade_event(disc, data, metadata, program_id=None):
 
 def decode_pump_multi_hop_intent(program, data, accounts):
     """Instruction limits only. Actual execution is reported by per-hop trade events."""
-    if (
-        program != "pAMMBay6oceH9fJKBRHGP5D4bD4sWpmSwMn52FMfXEA"
-        or len(data) != 24
-        or data[:8] != bytes([43, 100, 73, 19, 233, 246, 111, 148])
-        or len(accounts) < 21
-        or (len(accounts) - 16) % 5
-    ):
-        return None
-    amount_in = int.from_bytes(data[8:16], "little")
-    minimum = int.from_bytes(data[16:24], "little")
-    if not amount_in or not minimum:
+    from .pump_routes import multi_hop_args
+    args = multi_hop_args(program, data, accounts)
+    if args is None:
         return None
+    amount_in, minimum = args
     return dict(
         user=accounts[0],
         input_account=accounts[1],

sol_parser/shredstream_client.py

@@ -1,8 +1,7 @@
 """ShredStream gRPC 客户端：SubscribeEntries + bincode 解码 + DEX 外层指令。
 
 限制：与 Rust 文档一致——不解析 inner CPI 日志；当前 Python 热路径只使用静态账户，
-V0 ALT 加载账户用默认 pubkey 占位继续 best-effort 解析；若 program id 来自 ALT，
-会按候选 program id 尝试 discriminator 解析。需安装 ``solders``（``pip install 'sol-parser-sdk-python[shredstream]'``）。
+默认跳过未解析账户；ALT 只使用调用方预热缓存，不回退 RPC。Legacy/V0/V1 使用原生线格式解码。
 """
 
 from __future__ import annotations
@@ -133,102 +132,94 @@ def _should_parse_shred_instructions(filter: Optional[EventTypeFilter]) -> bool:
     return event_type_filter_allows_instruction_parsing(list(include_only))
 
 
-def _events_from_versioned_tx_wire(
-    raw: bytes,
-    signature: str,
-    slot: int,
-    tx_index: int,
-    recv_us: int,
-    filter: Optional[EventTypeFilter],
-) -> List[DexEvent]:
+def _parse_decoded_shred(tx, keys, signature, slot, tx_index, recv_us, filter, best_effort=False):
+    from .pump_routes import may_parse_route, parse_route
+    from .grpc_types import EventMetadata
     if not _should_parse_shred_instructions(filter):
         return []
+    msg = tx['message']
+    signature = signature or tx['signatures'][0]
+    instructions = [(keys[ix['programIdIndex']] if ix['programIdIndex'] < len(keys) else None,
+                     (ix['data'] if isinstance(ix['data'], bytes) else base58.b58decode(ix['data'])), bytes(ix['accounts'])) for ix in msg['instructions']]
+    created, mayhem = set(), set()
+    if _pumpfun_filter_allows(filter):
+        for pid, data, indices in instructions:
+            if pid == PUMPFUN_PROGRAM_ID and (best_effort or all(i < len(keys) for i in indices)):
+                c, m = detect_pumpfun_create_mints(pid, data, indices, keys)
+                created |= c
+                mayhem |= m
+    out = []
+    for index, (pid, data, indices) in enumerate(instructions):
+        resolved = pid is not None and all(i < len(keys) for i in indices)
+        if not resolved and not best_effort:
+            continue
+        if pid and may_parse_route(pid, data):
+            if resolved:
+                metadata = EventMetadata(signature=signature, slot=slot, tx_index=tx_index, grpc_recv_us=recv_us,
+                                         recent_blockhash=msg['recentBlockhash'])
+                event = parse_route(pid, data, [keys[i] for i in indices], metadata, index, filter)
+                if event:out.append(event)
+            continue
+        if pid == PUMPFUN_PROGRAM_ID:
+            if not _pumpfun_filter_allows(filter):continue
+            event = _filter_parsed_event(parse_pumpfun_shred_ix(data, keys, indices, pid, signature,
+                        slot, tx_index, recv_us, created, mayhem), filter)
+        else:
+            accounts = _static_ix_account_strings(keys, indices)
+            event = None
+            for program in ([pid] if pid else _UNKNOWN_PROGRAM_CANDIDATES):
+                event = parse_instruction_unified(data, accounts, signature, slot, tx_index, None, recv_us, filter, program)
+                if event:break
+        if event:
+            if hasattr(event.data, 'metadata'):event.data.metadata.recent_blockhash = msg['recentBlockhash']
+            out.append(event)
+    enrich_pumpfun_same_tx_post_merge(out)
+    return out
 
-    try:
-        from solders.message import Message as LegacyMessage  # type: ignore
-        from solders.message import MessageV0  # type: ignore
-        from solders.transaction import VersionedTransaction  # type: ignore
-    except ImportError:
-        return []
 
+def _decode_shred(raw, raw_instructions=True):
+    from .wire_transaction import _decode_wire_transaction
+    return _decode_wire_transaction(raw, raw_instructions=raw_instructions)[0]
+
+
+def parse_shred_transaction_with_loaded_addresses(raw, writable, readonly, signature='', slot=0, tx_index=0, recv_us=0, filter=None):
+    """Strict, offline parsing. Reject inconsistent ALT counts before producing events."""
+    tx = _decode_shred(raw)
+    return _parse_loaded_shred(tx, writable, readonly, signature, slot, tx_index, recv_us, filter)
+
+
+def _parse_loaded_shred(tx, writable, readonly, signature, slot, tx_index, recv_us, filter):
+    msg = tx['message']
+    lookups = msg.get('addressTableLookups', [])
+    if len(writable) != sum(len(l['writableIndexes']) for l in lookups) or len(readonly) != sum(len(l['readonlyIndexes']) for l in lookups):
+        raise ValueError('ALT address counts do not match transaction')
+    keys = [*msg['accountKeys'], *writable, *readonly]
+    if any(ix['programIdIndex'] >= len(keys) or any(i >= len(keys) for i in ix['accounts']) for ix in msg['instructions']):
+        raise ValueError('Unresolved instruction index')
+    return _parse_decoded_shred(tx, keys, signature, slot, tx_index, recv_us, filter)
+
+
+def parse_shred_transaction(raw, signature='', slot=0, tx_index=0, recv_us=0, filter=None, *, best_effort=False, address_lookup_resolver=None):
+    """Static keys by default; optional slot-aware resolver must read only a prewarmed cache."""
     try:
-        vt = VersionedTransaction.from_bytes(raw)
-        # Decoding does not validate header/account/program indexes. Loaded ALT
-        # addresses may remain unresolved, but the wire structure must be valid.
-        vt.sanitize()
-    except Exception:
-        return []
-    if not vt.signatures:
-        return []
-    sig = signature or base58.b58encode(bytes(vt.signatures[0])).decode("ascii")
-    msg = vt.message
-    out: List[DexEvent] = []
-
-    if isinstance(msg, MessageV0):
-        keys = [str(k) for k in msg.account_keys]
-        ixs: List[tuple] = []
-        for cix in msg.instructions:
-            pid = keys[cix.program_id_index] if cix.program_id_index < len(keys) else None
-            ixs.append((pid, bytes(cix.data), _ix_accounts_bytes(cix.accounts)))
-    elif isinstance(msg, LegacyMessage):
-        keys = [str(k) for k in msg.account_keys]
-        ixs = []
-        for ix in msg.instructions:
-            pid = keys[ix.program_id_index] if ix.program_id_index < len(keys) else None
-            ixs.append((pid, bytes(ix.data), _ix_accounts_bytes(ix.accounts)))
-    else:
+        # Resolver callbacks retain the public JSON-compatible decoded shape.
+        tx = _decode_shred(raw, raw_instructions=address_lookup_resolver is None)
+    except (ValueError, IndexError, TypeError):
         return []
+    if address_lookup_resolver is not None and tx['message'].get('addressTableLookups'):
+        loaded = address_lookup_resolver(tx, slot)
+        if loaded is None:return []
+        return _parse_loaded_shred(tx, *loaded, signature, slot, tx_index, recv_us, filter)
+    return _parse_decoded_shred(tx, tx['message']['accountKeys'], signature, slot, tx_index, recv_us, filter, best_effort)
 
-    created: set = set()
-    mayhem: set = set()
-    if _pumpfun_filter_allows(filter):
-        for pid, data, ix_acc in ixs:
-            if pid is not None and pid != PUMPFUN_PROGRAM_ID:
-                continue
-            c, m = detect_pumpfun_create_mints(PUMPFUN_PROGRAM_ID, data, ix_acc, keys)
-            created |= c
-            mayhem |= m
-
-    for pid, data, ix_acc in ixs:
-        if pid == PUMPFUN_PROGRAM_ID:
-            if not _pumpfun_filter_allows(filter):
-                continue
-            ev = parse_pumpfun_shred_ix(
-                data, keys, ix_acc, pid, sig, slot, tx_index, recv_us, created, mayhem
-            )
-            ev = _filter_parsed_event(ev, filter)
-            if ev:
-                out.append(ev)
-            continue
-        accounts = _static_ix_account_strings(keys, ix_acc)
-        if pid is None:
-            for candidate in _UNKNOWN_PROGRAM_CANDIDATES:
-                if candidate == PUMPFUN_PROGRAM_ID:
-                    if not _pumpfun_filter_allows(filter):
-                        continue
-                    ev = parse_pumpfun_shred_ix(
-                        data, keys, ix_acc, PUMPFUN_PROGRAM_ID, sig, slot, tx_index, recv_us, created, mayhem
-                    )
-                    ev = _filter_parsed_event(ev, filter)
-                else:
-                    ev = parse_instruction_unified(
-                        bytes(data), accounts, sig, slot, tx_index, None, recv_us, filter, candidate
-                    )
-                if ev:
-                    out.append(ev)
-                    break
-            continue
-        ev = parse_instruction_unified(
-            bytes(data), accounts, sig, slot, tx_index, None, recv_us, filter, pid
-        )
-        if ev:
-            out.append(ev)
 
-    for ev in out:
-        if hasattr(ev.data, "metadata"):
-            ev.data.metadata.grpc_recv_us = recv_us
-    enrich_pumpfun_same_tx_post_merge(out)
-    return out
+def _events_from_versioned_tx_wire(raw, signature, slot, tx_index, recv_us, filter):
+    return parse_shred_transaction(raw, signature, slot, tx_index, recv_us, filter)
+
+
+def parse_shred_transaction_best_effort(raw, signature='', slot=0, tx_index=0, recv_us=0, filter=None):
+    """Explicit legacy placeholder mapping; route adapters still require resolved keys."""
+    return parse_shred_transaction(raw, signature, slot, tx_index, recv_us, filter, best_effort=True)
 
 
 class ShredStreamClient:
@@ -237,6 +228,12 @@ class ShredStreamClient:
     def __init__(self, endpoint: str, config: Optional[ShredStreamConfig] = None):
         self.endpoint = endpoint
         self.config = config or ShredStreamConfig()
+        self.address_lookup_resolver = None
+
+    def with_address_lookup_resolver(self, resolver):
+        """Set a synchronous slot-aware cache callback; no automatic RPC fallback."""
+        self.address_lookup_resolver = resolver
+        return self
 
     @classmethod
     def new_with_config(cls, endpoint: str, config: ShredStreamConfig) -> ShredStreamClient:
@@ -273,14 +270,12 @@ class ShredStreamClient:
                         on_error(e)
                     continue
                 for tx_counter, raw in enumerate(raws):
-                    sig0 = ""
                     try:
-                        from solders.transaction import VersionedTransaction  # type: ignore
-
-                        sig0 = base58.b58encode(bytes(VersionedTransaction.from_bytes(raw).signatures[0])).decode("ascii")
-                    except Exception:
-                        pass
-                    for ev in _events_from_versioned_tx_wire(raw, sig0, slot, tx_counter, recv_us, f):
-                        yield ev
+                        events = parse_shred_transaction(raw, slot=slot, tx_index=tx_counter, recv_us=recv_us,
+                                                       filter=f, address_lookup_resolver=self.address_lookup_resolver)
+                    except Exception as error:
+                        if on_error:on_error(error)
+                        continue
+                    yield from events
         finally:
             channel.close()

sol_parser/wire_transaction.py

@@ -2,6 +2,19 @@
 
 from __future__ import annotations
 import base58
+try:
+    from solders.pubkey import Pubkey
+    from solders.signature import Signature
+except ImportError:
+    # solders is an optional ShredStream accelerator; core parsing stays usable.
+    def _key_string(raw):
+        return base58.b58encode(raw).decode()
+    _signature_string = _key_string
+else:
+    def _key_string(raw):
+        return str(Pubkey.from_bytes(raw))
+    def _signature_string(raw):
+        return str(Signature.from_bytes(raw))
 
 
 class _Reader:
@@ -32,9 +45,12 @@ class _Reader:
         raise ValueError("Invalid short-u16")
 
 
-def decode_wire_transaction(
-    data: bytes, offset: int = 0, require_complete: bool = True
-) -> tuple[dict, int]:
+def decode_wire_transaction(data: bytes, offset: int = 0, require_complete: bool = True) -> tuple[dict, int]:
+    return _decode_wire_transaction(data, offset, require_complete)
+
+
+def _decode_wire_transaction(data: bytes, offset: int = 0, require_complete: bool = True,
+                             *, raw_instructions: bool = False) -> tuple[dict, int]:
     if not isinstance(offset, int) or offset < 0 or offset >= len(data):
         raise ValueError("Invalid wire offset")
     r = _Reader(data, offset)
@@ -69,7 +85,7 @@ def decode_wire_transaction(
             {
                 "programIdIndex": program,
                 "accounts": list(r.take(accounts)),
-                "data": base58.b58encode(r.take(length)).decode(),
+                "data": (r.take(length) if raw_instructions else base58.b58encode(r.take(length)).decode()),
             }
             for program, accounts, length in headers
         ]
@@ -103,7 +119,7 @@ def decode_wire_transaction(
                 {
                     "programIdIndex": program,
                     "accounts": accounts,
-                    "data": base58.b58encode(payload).decode(),
+                    "data": (payload if raw_instructions else base58.b58encode(payload).decode()),
                 }
             )
         if version == 0:
@@ -113,7 +129,7 @@ def decode_wire_transaction(
                 readonly = list(r.take(r.short()))
                 lookups.append(
                     {
-                        "accountKey": base58.b58encode(key).decode(),
+                        "accountKey": _key_string(key),
                         "writableIndexes": writable,
                         "readonlyIndexes": readonly,
                     }
@@ -152,15 +168,15 @@ def decode_wire_transaction(
                 header,
             )
         ),
-        "accountKeys": [base58.b58encode(key).decode() for key in keys],
-        "recentBlockhash": base58.b58encode(blockhash).decode(),
+        "accountKeys": [_key_string(key) for key in keys],
+        "recentBlockhash": _key_string(blockhash),
         "instructions": instructions,
         "addressTableLookups": lookups,
     }
     if config is not None:
         message["config"] = config
     return {
-        "signatures": [base58.b58encode(s).decode() for s in signatures],
+        "signatures": [_signature_string(s) for s in signatures],
         "message": message,
         "version": version,
     }, r.pos - offset

{sol_parser_sdk_python-0.5.12.dist-info → sol_parser_sdk_python-0.5.14.dist-info}/METADATA

@@ -1,6 +1,6 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: sol-parser-sdk-python
-Version: 0.5.12
+Version: 0.5.14
 Summary: Solana DEX program log parsing (pure Python, API aligned with sol-parser-sdk)
 Requires-Python: >=3.10
 Requires-Dist: base58>=2.0
@@ -13,8 +13,11 @@ Requires-Dist: pytest-asyncio>=0.21; extra == 'dev'
 Requires-Dist: pytest-benchmark>=4.0; extra == 'dev'
 Requires-Dist: pytest>=8.0; extra == 'dev'
 Requires-Dist: requests>=2.31; extra == 'dev'
+Requires-Dist: solders==0.26.0; extra == 'dev'
 Provides-Extra: shredstream
 Requires-Dist: solders>=0.21.0; extra == 'shredstream'
+Provides-Extra: simulation
+Requires-Dist: solders==0.26.0; extra == 'simulation'
 Description-Content-Type: text/markdown
 
 <div align="center">
@@ -57,15 +60,27 @@ Parser SDK language versions and related Rust SDKs:
 
 | Language | Repository | Description | Version |
 |----------|------------|-------------|---------|
-| Rust | [sol-parser-sdk](https://github.com/0xfnzero/sol-parser-sdk) | Solana DEX transaction and account event parsing | `v0.7.13` |
-| Node.js | [sol-parser-sdk-nodejs](https://github.com/0xfnzero/sol-parser-sdk-nodejs) | TypeScript/JavaScript for Node.js | `v0.5.19` |
-| Python | [sol-parser-sdk-python](https://github.com/0xfnzero/sol-parser-sdk-python) | Async/await native support | `v0.5.12` |
-| Go | [sol-parser-sdk-golang](https://github.com/0xfnzero/sol-parser-sdk-golang) | Go transaction and account event parsing | `v0.5.12` |
-| **Rust** | [sol-shred-sdk](https://github.com/0xfnzero/sol-shred-sdk) | Raw Solana shred decoding and ShredStream DEX event parsing | `v4.0.4` |
-| **Rust** | [sol-trade-sdk](https://github.com/0xfnzero/sol-trade-sdk) | Solana DEX trade construction and transaction execution | `v6.0.1` |
+| Rust | [sol-parser-sdk](https://github.com/0xfnzero/sol-parser-sdk) | Solana DEX transaction and account event parsing | `v0.7.15` |
+| Node.js | [sol-parser-sdk-nodejs](https://github.com/0xfnzero/sol-parser-sdk-nodejs) | TypeScript/JavaScript for Node.js | `v0.5.21` |
+| Python | [sol-parser-sdk-python](https://github.com/0xfnzero/sol-parser-sdk-python) | Async/await native support | `v0.5.14` |
+| Go | [sol-parser-sdk-golang](https://github.com/0xfnzero/sol-parser-sdk-golang) | Go transaction and account event parsing | `v0.5.14` |
+| **Rust** | [sol-shred-sdk](https://github.com/0xfnzero/sol-shred-sdk) | Raw Solana shred decoding and ShredStream DEX event parsing | `v4.0.6` |
+| **Rust** | [sol-trade-sdk](https://github.com/0xfnzero/sol-trade-sdk) | Solana DEX trade construction and transaction execution | `v6.0.2` |
 
 ---
 
+## v0.5.14 — Pump route direction and instruction names
+
+Route intents now expose `is_buy` and `ix_name`, following existing trade field names and official IDL instruction names. RapidBuy reports a buy intent and `buy_exact_quote_in_v2`; BuyPumpDelta reports only a buy intent. Multi-hop direction and unknown methods remain null. Read currencies from `hops[].base_mint` / `quote_mint`. These hints do not confirm execution, and filters do not convert intents into trades.
+
+Older JSON without the fields remains readable as unknown. Rust struct literals must supply the new fields; Go uses pointers and Node.js/Python use null/None for unknown values. Streamer now forwards `DexEvent::PumpRouteIntentEvent` with protocol and event filtering.
+
+## v0.5.13 — Pump routes and offline replay
+
+Adds native Pump route-intent parsing for official multi-hop instructions and the exact RapidBuy/BuyPumpDelta wrapper layouts captured in reported transactions. Adds locally cached ALT resolution and rejects unresolved account identities by default, with explicit best-effort compatibility APIs where supported. Route intents expose instruction constraints and hop identities; confirmed execution amounts require execution metadata.
+
+Includes the latest complete implementation, signed transaction fixtures, native offline-bank regression examples and reproducible local hot-path benchmarks. Unknown wrapper layouts are not inferred from embedded bytes. Local tests do not measure production network latency.
+
 ## v0.5.12 — Pump depth-2 compatibility
 
 Adds signed Pump depth-2 create-event replay coverage, including ALT-loaded accounts and executed logs. Existing event layouts and public parsing interfaces remain unchanged.
@@ -141,7 +156,7 @@ This is the Python implementation of the FnZero Solana DEX parser SDK for asynci
 **From PyPI**
 
 ```bash
-pip install sol-parser-sdk-python==0.5.12
+pip install sol-parser-sdk-python==0.5.14
 ```
 
 **From source**
@@ -246,7 +261,7 @@ asyncio.run(main())
 
 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.
+The Python ShredStream hot path uses strict static-account parsing by default. Supply loaded addresses or a slot-aware prewarmed-cache resolver for V0 ALT instructions; unresolved instructions are skipped. Legacy placeholders require the explicit `parse_shred_transaction_best_effort` API. Recognized wrapper/official routes emit `PumpRouteIntent`; raw shreds cannot reconstruct arbitrary CPI. Inner CPI/log-only events still require the Yellowstone/RPC paths.
 
 ---
 
@@ -257,18 +272,18 @@ From the **package root** after `pip install -e .`. Run with `python examples/<f
 | 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) | `v0.5.12` |
-| 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) | `v0.5.12` |
-| 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) | `v0.5.12` |
+| 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) | `v0.5.14` |
+| 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) | `v0.5.14` |
+| 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) | `v0.5.14` |
 | **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) | `v0.5.12` |
-| 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) | `v0.5.12` |
+| 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) | `v0.5.14` |
+| 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) | `v0.5.14` |
 | **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) | `v0.5.12` |
+| 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) | `v0.5.14` |
 | **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) | `v0.5.12` |
+| 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) | `v0.5.14` |
 | **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) | `v0.5.12` |
+| 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) | `v0.5.14` |
 
 **Env:** gRPC examples need **`GRPC_URL`** or **`GRPC_ENDPOINT`**, plus **`GRPC_AUTH_TOKEN`** or **`GRPC_TOKEN`** (or legacy `GEYSER_*`). See **`.env.example`**.
 
@@ -371,3 +386,14 @@ Full cross-language API parity is still in progress. See the [API migration guid
 实时 parser → trade 接入使用 Yellowstone **gRPC**；见 [gRPC 缓存接入与三语言示例](docs/USAGE.md#grpc-cache)。此路径不使用 WebSocket，报价和构建热路径不调用 RPC。
 
 Shared PumpFun create/create_v2 mainnet fixtures, replay instructions and verification limits are documented in the [validation guide](https://github.com/0xfnzero/sol-parser-sdk-golang/tree/main/validation/pumpfun_create_20261007).
+
+### Offline Pump ShredStream regressions
+
+Pump route intents, strict cached ALT resolution and native signed replay/SBF simulation examples are documented in [examples/offline_bank/README.md](examples/offline_bank/README.md). Run the language-native examples and tests from this repository; no other-language test driver or RPC endpoint is needed. Unresolved instructions now skip by default; use the explicit best-effort API only for legacy behavior. Route intents must not be treated as confirmed fills.
+
+Native offline CPU benchmark: `python -m examples.hot_path_benchmark`.
+`examples/hot_path_benchmark.json` fixes warmup and measured iterations for six
+signed wrapped-CPI/ALT transactions. Reported percentiles are per six-transaction
+batch; fixture decoding and I/O occur before timing. Parsing performs no RPC.
+Public wire-decoder dictionaries and resolver callbacks retain base58 strings;
+the internal ShredStream path avoids an instruction-data base58 round trip.

{sol_parser_sdk_python-0.5.12.dist-info → sol_parser_sdk_python-0.5.14.dist-info}/RECORD

@@ -1,4 +1,4 @@
-sol_parser/__init__.py,sha256=65QWzCkS993lUiDSLPaY0tu0cpvq5bzsFPabwFoyzEU,17166
+sol_parser/__init__.py,sha256=0SBivj4hJynvlD617cEWSEUJScO04zIA0e_KUnw36r8,17535
 sol_parser/account_dispatcher.py,sha256=WgWD0833ArPtXuRGMO7_URDxPhLaCcnHc-e8RNeGCJI,19947
 sol_parser/block_meta.py,sha256=LuJ4oy6xvRmFjSIUDUG9k4Dg7q9l2xW9z35wYJdBmCw,854
 sol_parser/check_migration.py,sha256=PsRE_Zhnw2g_iaP_iYtlGsQutE2w_FsaZIP4GPeN8-o,537
@@ -6,13 +6,13 @@ sol_parser/clock.py,sha256=RHF99qMerKvEsT55krkftIh-uqy_uTzpgdKCqKBMDmA,278
 sol_parser/dex_parsers.py,sha256=eOigBKLpMQGZT_3dJwq18niDhY0fSGJrULDx_TGNC8Q,146032
 sol_parser/entries_decode.py,sha256=MOhGadNxWLerxBhGvuNatoWa2hzw2MXVz9NmNUhWvS8,3665
 sol_parser/env_config.py,sha256=Lw0SdZuy_MvUaVkyFxS0qPBgMzR9UBbxbN0CVz8nxg4,7296
-sol_parser/event_type_parity.py,sha256=089Ylls_I531kJP24i5BQBg6QBOHWuB-LP-KI_Vdu0Q,4498
-sol_parser/event_types.py,sha256=h8CT9-6Hm5PXVWPGGXe50cOGRGJJzDldO6L0OgdTj0s,97554
+sol_parser/event_type_parity.py,sha256=mD9Lg43aPzJGvz0Ft94NxKw6XnpgBio5yL2xin9Wfdg,4521
+sol_parser/event_types.py,sha256=m63dNNVxjx9baTSsKIcwZXK1EAlx4cdh2Vy0TBrAq0o,98387
 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=fusMuSJsTPEUxgobdeimQ7s3Hu9n0bD8pIH7rEL40jM,37370
 sol_parser/grpc_instruction_parser.py,sha256=ogpnD3dTEeduxORH5VmwCnubGkQe9bbMCTC-NSH9Wkw,17107
-sol_parser/grpc_types.py,sha256=zqOx_JUsBQjKhZzeWqbiMw8LPzA8-3fKtU9j6HAS5u0,41276
+sol_parser/grpc_types.py,sha256=cqBuHmUuRqE8MvCwGzPtRR-T7BKNonT5-k4P6yDzspI,41388
 sol_parser/inner_instruction_parser.py,sha256=i5tkKS7F1aZWUdE9pzm2o5_1EXWM8-v71cjo45jM-d8,21668
 sol_parser/instr_account_utils.py,sha256=MY8bgoIDiv2yJKeWxqhpfKc3pV4xUFTcYKnSXtnQMWc,1990
 sol_parser/instructions.py,sha256=XZt73ZJmCZE5LWF8A-yLmxGmF0dcPxnVuRmhMf-7ynY,88373
@@ -23,12 +23,13 @@ sol_parser/market.py,sha256=p_N6n3b4hEtUjHAQQyGSnrKdHYmkHdY1hXXObHRKc0Y,1858
 sol_parser/merger.py,sha256=hVIeocXYnLTP5qtXb4lZtED5EteE_g3a84ZeUwUmda0,13498
 sol_parser/order_buffer.py,sha256=f3yvvYglHX800hyF8JhFbjb1VoNtOvrqUR8lm3lvF-Y,7874
 sol_parser/parser.py,sha256=aSDbsbnUqBHEJ6UMdnZIuR-01fWs4_GxUwTJ3vQ0GXU,11906
-sol_parser/pump_upgrade.py,sha256=IiIjjbXqjkBp433PY4MnjDYYtFZyyKsBZrkM-AUPhVg,5470
+sol_parser/pump_routes.py,sha256=U7FWxZYyP860jUZh5F8YKAoauki-hgmfu2DNDjEcplM,4868
+sol_parser/pump_upgrade.py,sha256=BnVB8PVHfPtILBOlI29nbXABihVuXZUO82Yw6upFhRM,5212
 sol_parser/pumpfun_fee_enrich.py,sha256=NHC_chCv2wuaOW5taYG8R6M1bu8cmdxcLf8cjSfo7Kc,4688
 sol_parser/rpc_parser.py,sha256=Ft1VSBk66RLbwURKIoGtsRFDwjorh4EE6Gdqkil5tHY,25871
 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=HwCgFPsXC8N1gq_8VhNnx2jxV6W1-wg9pFwwLgw4X-w,10141
+sol_parser/shredstream_client.py,sha256=0D6dPZ366mmSuE-bMfjyt-Y3vrB35VMt1cJlCUuZQ_Y,11660
 sol_parser/shredstream_pb2.py,sha256=BMrgCTcvRu5sY_QG1nj5AhWK9RL1fqF9Ga0xYihQfio,1703
 sol_parser/shredstream_pb2_grpc.py,sha256=zfRJaDj-76Gbr6tC3x4gFOz6Xpu2fmJFWWcTOTmyIXs,3013
 sol_parser/shredstream_pumpfun.py,sha256=agTryEilG7c9Ttlek2-d2fyhzwGHIKrUD9YMAJjvXfk,11187
@@ -39,7 +40,7 @@ sol_parser/stonkfun_registry.py,sha256=el8xm3FGU5Eo4D5yq7-NCINSdsn7Pzl-9i1nKNgLa
 sol_parser/transaction_route.py,sha256=aPUy95_RHUDl6MFGzQ9hJbpv69LSHxFYCeRTBVc9SLY,19668
 sol_parser/u128_parity.py,sha256=D8PYuy1l-1QwkIEeGCLvrGfzAfTzpBDcGINxRIJAEPs,3487
 sol_parser/verify_discriminators.py,sha256=oqCBWL065ixBIjhHW255nk4S-F1F0x4zfTzs68nXMqA,3011
-sol_parser/wire_transaction.py,sha256=CVaVdeaNuVwgECir8MGCVApSHATMhxSwvELWA8a2A3E,6143
+sol_parser/wire_transaction.py,sha256=ATJSDY1D-m0vCBMooEe2g8F5a1QVOZyl7k-lEDSheSQ,6858
 sol_parser/account_fillers/__init__.py,sha256=q4q7HZF0Z4-rxhKoRMzV52HSkJ_n_POm4vimYUQlCOA,235
 sol_parser/account_fillers/meteora.py,sha256=ecY3F4KkjnVxBc-Zsnzru52DggkYOdbeauaYrznDxFY,2111
 sol_parser/account_fillers/orca.py,sha256=2s-hfi20fa5sy6p1rGc7_7NxzkpaleJdqn3YD41aBAw,895
@@ -58,7 +59,7 @@ sol_parser/grpc/subscribe_builder.py,sha256=xH9NZ1Lp-7AQKcgxoqyE0PrB3vdOqnScm_Ht
 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.12.dist-info/METADATA,sha256=Sv80DT_XBQDzK3gidPHx1qlG3YNd77o4WSYT4rIVV-0,17969
-sol_parser_sdk_python-0.5.12.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-sol_parser_sdk_python-0.5.12.dist-info/entry_points.txt,sha256=ZGXRb-2jBdc56d8PCAZFiJBLTAzUKFeHPohysJnKVbA,206
-sol_parser_sdk_python-0.5.12.dist-info/RECORD,,
+sol_parser_sdk_python-0.5.14.dist-info/METADATA,sha256=SruOAOSNW0NilLlGbiS2CnYu4M19rLdyl5Q2H8iM9Gc,20745
+sol_parser_sdk_python-0.5.14.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
+sol_parser_sdk_python-0.5.14.dist-info/entry_points.txt,sha256=ZGXRb-2jBdc56d8PCAZFiJBLTAzUKFeHPohysJnKVbA,206
+sol_parser_sdk_python-0.5.14.dist-info/RECORD,,

{sol_parser_sdk_python-0.5.12.dist-info → sol_parser_sdk_python-0.5.14.dist-info}/WHEEL

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