sol-parser-sdk-python 0.5.9__tar.gz → 0.5.10__tar.gz

{sol_parser_sdk_python-0.5.9 → sol_parser_sdk_python-0.5.10}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: sol-parser-sdk-python
-Version: 0.5.9
+Version: 0.5.10
 Summary: Solana DEX program log parsing (pure Python, API aligned with sol-parser-sdk)
 Requires-Python: >=3.10
 Requires-Dist: base58>=2.0
@@ -76,6 +76,13 @@ This is the Python implementation of the FnZero Solana DEX parser SDK for asynci
 
 ## Release notes
 
+### v0.5.10
+
+- Matches PumpFun create/create_v2 accounts by the actual instruction discriminator and event mint, including CPI calls; ambiguous matches are left unspecified.
+- Stops inferring quote mint/vault/token-program fields from arbitrary remaining create_v2 accounts and preserves authoritative decoded fields.
+- Restores historical CreateEvent decoding and verifies successful and failed transactions using saved mainnet fixtures.
+- Suppresses rolled-back DEX events from failed transactions and preserves failure status through RPC/gRPC adapters.
+
 ### v0.5.9
 
 - Adds native gRPC lifecycle and block metadata support, instruction-level route analysis and StonkFun registry/snapshot examples.
@@ -117,7 +124,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.9
+pip install sol-parser-sdk-python==0.5.10
 ```
 
 **From source**

{sol_parser_sdk_python-0.5.9 → sol_parser_sdk_python-0.5.10}/README.md

@@ -58,6 +58,13 @@ This is the Python implementation of the FnZero Solana DEX parser SDK for asynci
 
 ## Release notes
 
+### v0.5.10
+
+- Matches PumpFun create/create_v2 accounts by the actual instruction discriminator and event mint, including CPI calls; ambiguous matches are left unspecified.
+- Stops inferring quote mint/vault/token-program fields from arbitrary remaining create_v2 accounts and preserves authoritative decoded fields.
+- Restores historical CreateEvent decoding and verifies successful and failed transactions using saved mainnet fixtures.
+- Suppresses rolled-back DEX events from failed transactions and preserves failure status through RPC/gRPC adapters.
+
 ### v0.5.9
 
 - Adds native gRPC lifecycle and block metadata support, instruction-level route analysis and StonkFun registry/snapshot examples.
@@ -99,7 +106,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.9
+pip install sol-parser-sdk-python==0.5.10
 ```
 
 **From source**

{sol_parser_sdk_python-0.5.9 → sol_parser_sdk_python-0.5.10}/README_CN.md

@@ -58,6 +58,13 @@
 
 ## 发布说明
 
+### v0.5.10
+
+- 按实际指令 discriminator 和事件 mint 匹配 PumpFun create/create_v2 账户，支持 CPI，并拒绝猜测有歧义的匹配。
+- 停止从 create_v2 的任意尾部账户推断 quote mint、vault、token program，保留权威解码字段。
+- 恢复历史 CreateEvent 布局，并通过保存的真实主网成功、失败交易验证。
+- 过滤失败交易中已经回滚的 Create/Buy 等 DEX 事件，并在 RPC/gRPC 转换中保留失败状态。
+
 ### v0.5.9
 
 - Adds native gRPC lifecycle and block metadata support, instruction-level route analysis and StonkFun registry/snapshot examples.
@@ -99,7 +106,7 @@
 **PyPI**
 
 ```bash
-pip install sol-parser-sdk-python==0.5.9
+pip install sol-parser-sdk-python==0.5.10
 ```
 
 **源码**

sol_parser_sdk_python-0.5.10/docs/FAILED_TRANSACTION_AUDIT_20261007.md

@@ -0,0 +1,42 @@
+# Failed-transaction and skipped-test audit — 2026-10-07
+
+## Findings and fix
+
+The eight failed mainnet transactions failed on-chain: six attempted to allocate an already-used mint account; two had insufficient SOL. No parser fix can change their historical chain outcome. A new launch must use an unused mint account and sufficient SOL for the transfer/rent/fees.
+
+Reviewing these previously excluded samples exposed an SDK defect: Go, Node.js and Python could emit instruction/log Create or Buy events for failed transactions, even though all of the transaction's program effects were rolled back. Python RPC metadata omitted `err`; Go and Node.js Yellowstone adapters also lost the failure flag.
+
+The corrected high-level RPC/gRPC event paths suppress all DEX events when the transaction has a failure status. RPC metadata retains the original error; RPC-to-Yellowstone conversion preserves error **presence**, without pretending the JSON error is a Yellowstone binary error enum. Native protobuf errors remain usable as failure indicators even when their encoded payload is empty. Python's full subscription callback suppresses both instruction and log events.
+
+The Rust RPC parser already suppressed failed transactions; the mainnet regression now explicitly asserts this behavior for the eight failed fixtures instead of skipping them. Raw ShredStream instruction decoding in sol-shred-sdk has no execution status and reports instruction intent; callers must use confirmed RPC/gRPC status to decide whether a launch committed.
+
+## Actual failed transactions
+
+| Signature | Slot | Confirmed chain failure |
+| --- | ---: | --- |
+| [2dabmQiykzC1tsNmgtRFbsRJjEKMfUySgScJc2J2uq8CQtoXWZ3YyT99p3nVuCXifEhLkyUe4Sf4nfe2UkFT8AJr](https://solscan.io/tx/2dabmQiykzC1tsNmgtRFbsRJjEKMfUySgScJc2J2uq8CQtoXWZ3YyT99p3nVuCXifEhLkyUe4Sf4nfe2UkFT8AJr) | 299999997 | Mint account already in use |
+| [3GufGVVRrnrH1Yuto57jDeTKXeki6ooE9w6h4qYRvNm5FcCpxwDHNvzHXdpAMbxRmukWJpSPHUKHEjnFTCC979ka](https://solscan.io/tx/3GufGVVRrnrH1Yuto57jDeTKXeki6ooE9w6h4qYRvNm5FcCpxwDHNvzHXdpAMbxRmukWJpSPHUKHEjnFTCC979ka) | 454059364 | Insufficient SOL / lamports |
+| [3LQK2JHVbVSSfyCYwTwzoYTY9NEN4gZXzqw3TvAvMJHsvPsopCHtsa5ALhj4tFn8xWbmJ5DsYMMcnPukTBkSjtQf](https://solscan.io/tx/3LQK2JHVbVSSfyCYwTwzoYTY9NEN4gZXzqw3TvAvMJHsvPsopCHtsa5ALhj4tFn8xWbmJ5DsYMMcnPukTBkSjtQf) | 299999997 | Mint account already in use |
+| [3MRWKDUcD5CGn5Xz4qWyGA8Y9udw4SsSr4gcxCjTUqCFt6Zc6uiwHF1wLZXKoqBcGEM2kruBS85ymYxmYk8FLGBk](https://solscan.io/tx/3MRWKDUcD5CGn5Xz4qWyGA8Y9udw4SsSr4gcxCjTUqCFt6Zc6uiwHF1wLZXKoqBcGEM2kruBS85ymYxmYk8FLGBk) | 299999997 | Mint account already in use |
+| [3NBSCgAXpNqg7JBUzp6RsfZYzf2QbbHi6r2wcoBF4Lpuzozae7ExUJUGoqpVCXXs8cbibr6aWySH1bsg86Enuhez](https://solscan.io/tx/3NBSCgAXpNqg7JBUzp6RsfZYzf2QbbHi6r2wcoBF4Lpuzozae7ExUJUGoqpVCXXs8cbibr6aWySH1bsg86Enuhez) | 299999991 | Mint account already in use |
+| [3QVpcUq64D4DUV9empFr3G98pCEa1Cp2fAcFJKyiJGsQ2ir2S4yBLhHYXPNmLfCE8KVDgLApfBYTFM7pf9JVPbsb](https://solscan.io/tx/3QVpcUq64D4DUV9empFr3G98pCEa1Cp2fAcFJKyiJGsQ2ir2S4yBLhHYXPNmLfCE8KVDgLApfBYTFM7pf9JVPbsb) | 389243699 | Insufficient SOL / lamports |
+| [3REXMDkvZsWvgc8czYpfn24avz18APMuzbV2VgQBeymArdJvfQcfcpKr46f3j1H2bAiymFneaNocPH7KzPUPbR1S](https://solscan.io/tx/3REXMDkvZsWvgc8czYpfn24avz18APMuzbV2VgQBeymArdJvfQcfcpKr46f3j1H2bAiymFneaNocPH7KzPUPbR1S) | 299999991 | Mint account already in use |
+| [3zC4bw1osyebZ77KagXYP3b5rEBHvJCgcwCriCLc5gAUp9Ev6Bx5ZMbqnYpkKE2VgZgMFcZN5FYKQfcKL45MWpyu](https://solscan.io/tx/3zC4bw1osyebZ77KagXYP3b5rEBHvJCgcwCriCLc5gAUp9Ev6Bx5ZMbqnYpkKE2VgZgMFcZN5FYKQfcKL45MWpyu) | 299999991 | Mint account already in use |
+
+The detailed JSON audit retains `meta.err` and the actual failure log message for each signature. The eight actual failures are now checked by Go/Node.js/Python/Rust RPC regressions; they produce no committed DEX events.
+
+## Previously skipped or ignored tests
+
+- The eight Node.js tests in `current_mainnet_transactions.test.ts` were opt-in network tests. Enabled them with `RUN_MAINNET_TESTS=1`: all eight passed against the public mainnet RPC, including PumpFun/PumpSwap, Meteora, Orca and Raydium fixtures.
+- The Rust parser's ignored route timing test passed when run with `cargo test --lib -- --ignored`.
+- sol-shred-sdk's ignored route timing and decoder microbenchmark tests both passed with the same command. These are manual timing tests, not previously failed tests.
+
+## Final validation
+
+- Go: `go test ./...` and `go vet ./...` passed, including the eight real failed transactions and native gRPC failure status tests.
+- Node.js: build passed; full suite with `RUN_MAINNET_TESTS=1` and the shared 36-transaction corpus: **311 passed, zero skipped**.
+- Python: full suite with the shared 36-transaction corpus: **277 passed**. Tests include RPC conversion, instruction-only gRPC parsing and the full subscription callback on failed transactions.
+- Rust: shared-corpus RPC regression: **2 passed** (covering every successful sample plus all eight actual failed transactions); the ignored timing test passed.
+- sol-shred-sdk: both ignored manual tests passed; its existing default/zero-copy correctness suites passed in the earlier synchronized-fix verification.
+
+At verification time, changes were local and uncommitted. No transactions were submitted to Solana. Publication is tracked by the repository release.

sol_parser_sdk_python-0.5.10/docs/PUMPFUN_CREATE_REGRESSION_20261007.md

@@ -0,0 +1,41 @@
+# PumpFun create / create_v2 cross-language regression verification
+
+Date: 2026-10-07. At verification time, changes were local and uncommitted. Publication is tracked by the repository release.
+
+## Corrected behavior
+
+- Select creation account context by the actual create/create_v2 discriminator and event mint, including CPI invocations. Require the corresponding minimum IDL account count (14/16). Decline ambiguous matches; never select a larger buy invocation as creation context.
+- The current official public Pump IDL defines 16 fixed create_v2 accounts and **no quote mint/vault/token-program accounts**. Positions 16/17/18 are not interpreted as quote accounts. Preserve quote fields from decoded events and existing authoritative enrichment.
+- Recognize the historical CreateEvent layout: three Borsh strings followed by exactly 96 bytes (mint, curve, user). Reject partial historical/modern layouts. Rust handles both direct logs and pre-decoded log/CPI event paths under both parser features.
+- Rust and sol-shred-sdk also recognize historical create instruction arguments ending after the three strings, leaving unavailable creator metadata unspecified.
+- Node.js and Python fill the complete legacy creation account context. Python declares the canonical create account fields so dataclass serialization retains them.
+- sol-shred-sdk and the Rust parser SDK apply the quote fix to their ShredStream instruction paths as well.
+
+## Mainnet evidence
+
+Source: `sol-parser-sdk-golang/validation/pumpfun_create_20261007/transactions` and its `sources.json`, `pump_public_idl.json`, and `REPORT.md`.
+Official IDL source: https://raw.githubusercontent.com/pump-fun/pump-public-docs/main/idl/pump.json
+
+The shared corpus contains 36 signed getTransaction responses: 3 successful legacy creates, 25 successful create_v2 transactions, and 8 failed transactions. All four SDKs replayed the corpus. For each successful transaction, regression assertions compare creation mint/user/token program against the actual creating instruction and reject unrelated quote account values. Failed transactions are excluded from successful-launch assertions.
+
+Rust RPC verification reconstructs the original signed binary transaction from the unparsed JSON response because its RPC parser expects binary encoding. sol-shred-sdk replays that same reconstructed signed transaction with the actual loaded addresses. These are offline RPC-derived replays, not independent live gRPC or raw-shred captures. This corpus does not establish USDC-launch coverage.
+
+Each repository also includes five self-contained RPC fixtures: two historical legacy creates, a newer legacy create, and two recent create_v2 transactions. Regression tests additionally cover CPI creates, multiple mints, ambiguous duplicate creates, a longer unrelated buy, arbitrary remaining accounts, preservation of decoded quote fields, and historical payload bounds.
+
+## Validation
+
+| SDK | Full test results |
+| --- | --- |
+| sol-parser-sdk (Rust) | Default: 476 passed / 1 ignored; zero-copy: 474 passed / 1 ignored |
+| sol-shred-sdk | Default: 398 passed / 2 ignored; zero-copy: 396 passed / 2 ignored |
+| sol-parser-sdk-nodejs | TypeScript build passed; full suite with shared corpus: 302 passed / 8 skipped |
+| sol-parser-sdk-python | Full suite with shared corpus: 275 passed |
+
+All repositories passed `git diff --check`. Existing unrelated sol-shred-sdk working changes were preserved.
+
+Run the new regression tests from each repository with `PUMPFUN_CREATE_CORPUS` pointing to the shared transactions directory to repeat all 36 samples; without that variable they use the repository's five saved fixtures.
+
+- Rust: `cargo test --test pumpfun_create_regression`; also `cargo test --no-default-features --features parse-zero-copy --test pumpfun_create_regression`.
+- sol-shred-sdk: the same Cargo test commands. On this macOS host, Cargo required `DYLD_LIBRARY_PATH` and `LIBCLANG_PATH` to point to the Xcode toolchain `usr/lib` directory for its existing RocksDB build dependency.
+- Node.js: `npm test -- --run src/pumpfun_create_regression.test.ts`.
+- Python: `.venv/bin/python -m pytest -q tests/test_pumpfun_create_regression.py`.

{sol_parser_sdk_python-0.5.9 → sol_parser_sdk_python-0.5.10}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "sol-parser-sdk-python"
-version = "0.5.9"
+version = "0.5.10"
 description = "Solana DEX program log parsing (pure Python, API aligned with sol-parser-sdk)"
 readme = "README.md"
 requires-python = ">=3.10"

{sol_parser_sdk_python-0.5.9 → sol_parser_sdk_python-0.5.10}/sol_parser/account_dispatcher.py

@@ -110,6 +110,31 @@ def fill_accounts_with_owned_keys(
             return
         filler(get)
 
+    def fill_create(v2_only=False):
+        selected = None
+        for ix in invokes.get(base58.b58decode(PUMPFUN_PROGRAM_ID), []):
+            raw = get_instruction_data(meta_pb, transaction_pb, ix)
+            if raw is None:
+                continue
+            v2 = raw[:8] == bytes([214,144,76,236,95,139,49,180])
+            legacy = raw[:8] == bytes([24,30,200,40,5,28,7,119])
+            if not v2 and (v2_only or not legacy):
+                continue
+            get = get_instruction_account_getter(meta_pb, transaction_pb, static_keys, w, r, ix)
+            oi, ii = ix
+            instruction = (transaction_pb.message.instructions[oi] if ii < 0 else
+                           next(g for g in meta_pb.inner_instructions if g.index == oi).instructions[ii])
+            if len(instruction.accounts) < (16 if v2 else 14) or get is None:
+                continue
+            if data.mint and data.mint != "11111111111111111111111111111111" and get(0) != data.mint:
+                continue
+            if selected is not None:
+                return  # Multiple matching creates: do not guess.
+            selected = (get, v2)
+        if selected:
+            get, v2 = selected
+            (pumpfun.fill_create_v2_accounts if v2 else pumpfun.fill_create_accounts)(data, get)
+
     et = event.type
     data = event.data
 
@@ -121,9 +146,9 @@ def fill_accounts_with_owned_keys(
     ):
         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))
+        fill_create()
     elif et == EventType.PUMP_FUN_CREATE_V2:
-        run(PUMPFUN_PROGRAM_ID, lambda g: pumpfun.fill_create_v2_accounts(data, g))
+        fill_create(True)
     elif et == EventType.PUMP_FUN_MIGRATE:
         run(PUMPFUN_PROGRAM_ID, lambda g: pumpfun.fill_migrate_accounts(data, g))
     elif et == EventType.PUMP_SWAP_BUY:

{sol_parser_sdk_python-0.5.9 → sol_parser_sdk_python-0.5.10}/sol_parser/account_fillers/pumpfun.py

@@ -113,15 +113,12 @@ def fill_trade_accounts(e: PumpFunTradeEvent, get: AccountGetter) -> None:
 
 
 def fill_create_accounts(e: PumpFunCreateEvent, get: AccountGetter) -> None:
-    if get(15) == "6EF8rrecthR5Dkzon8Nwu78hRvfCKubJ14M5uBEwF6P":
-        fill_create_v2_accounts(e, get)  # type: ignore[arg-type]
-        return
-    if _empty(e.mint):
-        e.mint = get(0)
-    if _empty(e.bonding_curve):
-        e.bonding_curve = get(2)
-    if _empty(e.user):
-        e.user = get(7)
+    for field, index in (("mint",0),("mint_authority",1),("bonding_curve",2),
+                         ("associated_bonding_curve",3),("global_account",4),("user",7),
+                         ("system_program",8),("token_program",9),("associated_token_program",10),
+                         ("event_authority",12),("program",13)):
+        if _empty(getattr(e, field, "")):
+            setattr(e, field, get(index))
 
 
 def fill_create_v2_accounts(e: PumpFunCreateV2TokenEvent, get: AccountGetter) -> None:
@@ -157,12 +154,6 @@ def fill_create_v2_accounts(e: PumpFunCreateV2TokenEvent, get: AccountGetter) ->
         e.event_authority = get(14)
     if _empty(e.program):
         e.program = get(15)
-    if _empty(e.quote_mint) or e.quote_mint == "So11111111111111111111111111111111111111111":
-        e.quote_mint = get(16)
-    if _empty(e.quote_vault):
-        e.quote_vault = get(17)
-    if _empty(e.quote_token_program):
-        e.quote_token_program = get(18)
     if getattr(e, "ix_name", "") in ("", "create"):
         e.ix_name = "create_v2"
 

{sol_parser_sdk_python-0.5.9 → sol_parser_sdk_python-0.5.10}/sol_parser/dex_parsers.py

@@ -324,6 +324,10 @@ def parse_create_from_data(data: bytes, meta: dict) -> DexEvent:
         uri, o = _borsh_str(data, o)
     except Exception:
         return DexEvent()
+    if len(data) - o == 96:
+        return DexEvent(type=EventType.PUMP_FUN_CREATE, data=PumpFunCreateEvent(
+            metadata=_make_meta(meta), name=name, symbol=sym, uri=uri,
+            mint=_pub(data, o), bonding_curve=_pub(data, o + 32), user=_pub(data, o + 64)))
     if len(data) < o + 32 * 4 + 8 * 5 + 32 + 1:
         return DexEvent()
     mint = _pub(data, o)

{sol_parser_sdk_python-0.5.9 → sol_parser_sdk_python-0.5.10}/sol_parser/event_types.py

@@ -219,6 +219,20 @@ class PumpFunCreateEvent(DexEventBase):
     virtual_quote_reserves: int = 0
     creator_fee_bps: int = 0
     is_holder_reward: bool = False
+    mint_authority: str = ""
+    associated_bonding_curve: str = ""
+    global_account: str = ""  # Rust `global` PumpFun global config
+    system_program: str = ""
+    associated_token_program: str = ""
+    mayhem_program_id: str = ""
+    global_params: str = ""
+    sol_vault: str = ""
+    mayhem_state: str = ""
+    mayhem_token_vault: str = ""
+    event_authority: str = ""
+    program: str = ""
+    observed_fee_recipient: str = ""
+    ix_name: str = "create"
 
 
 @dataclass

{sol_parser_sdk_python-0.5.9 → sol_parser_sdk_python-0.5.10}/sol_parser/grpc_client.py

@@ -517,6 +517,7 @@ class YellowstoneGrpc:
         signature = base58.b58encode(bytes(info.signature)).decode("ascii") if info.signature else ""
 
         from .grpc_instruction_parser import (
+            subscribe_transaction_failed,
             detect_pumpfun_create_from_logs,
             enrich_dex_events_with_subscribe_tx_info,
             parse_instructions_enhanced_from_subscribe_tx_info,
@@ -526,6 +527,9 @@ class YellowstoneGrpc:
         from .pumpfun_fee_enrich import enrich_pumpfun_same_tx_post_merge
         from .grpc_types import EventType
 
+        if subscribe_transaction_failed(info):
+            return  # Suppress both instruction events and rolled-back log events.
+
         instruction_events = parse_instructions_enhanced_from_subscribe_tx_info(
             info,
             slot,

{sol_parser_sdk_python-0.5.9 → sol_parser_sdk_python-0.5.10}/sol_parser/grpc_instruction_parser.py

@@ -229,6 +229,16 @@ def _meta_dict(
     return m
 
 
+def subscribe_transaction_failed(info: SubscribeUpdateTransactionInfo) -> bool:
+    """Read protobuf error presence, including errors with an empty encoded payload."""
+    if not info.meta_raw:
+        return False
+    from . import solana_storage_pb2 as sol_pb
+    meta = sol_pb.TransactionStatusMeta()
+    meta.ParseFromString(info.meta_raw)
+    return meta.HasField("err")
+
+
 def parse_instructions_enhanced_from_subscribe_tx_info(
     info: SubscribeUpdateTransactionInfo,
     slot: int,
@@ -268,7 +278,7 @@ def parse_instructions_enhanced_from_parsed(
     transaction_pb: Any = None,
 ) -> List[DexEvent]:
     """接受已 Parse 的 ``Message`` 与 ``TransactionStatusMeta``（来自 ``solana_storage_pb2``）。"""
-    if not should_parse_instructions(filter):
+    if meta.HasField("err") or not should_parse_instructions(filter):
         return []
 
     grpc_us = int(time.time() * 1_000_000) if grpc_recv_us is None else grpc_recv_us

{sol_parser_sdk_python-0.5.9 → sol_parser_sdk_python-0.5.10}/sol_parser/instructions.py

@@ -851,9 +851,9 @@ def _parse_pumpfun_create_v2(data: bytes, accounts: List[str], meta: EventMetada
             is_cashback_enabled=is_cashback_enabled,
             creator_fee_bps=creator_fee_bps,
             is_holder_reward=is_holder_reward,
-            quote_mint=_get_account_safe(accounts, 16) or Z,
-            quote_vault=_get_account_safe(accounts, 17),
-            quote_token_program=_get_account_safe(accounts, 18),
+            quote_mint=Z,
+            quote_vault=Z,
+            quote_token_program=Z,
             virtual_quote_reserves=0,
             observed_fee_recipient="",
         ),

{sol_parser_sdk_python-0.5.9 → sol_parser_sdk_python-0.5.10}/sol_parser/rpc_parser.py

@@ -71,6 +71,7 @@ class RpcTransactionMeta:
     post_token_balances: List[RpcTokenBalance]
     loaded_addresses: Optional[RpcLoadedAddresses]
     compute_units_consumed: Optional[int]
+    err: Optional[Any] = None
 
 
 @dataclass
@@ -200,6 +201,9 @@ def parse_rpc_transaction(
     if tx.transaction is None or tx.transaction.message is None:
         return [], ParseError("ConversionError", "Transaction message is nil")
 
+    if tx.meta is not None and tx.meta.err is not None:
+        return [], None  # All events from a failed transaction describe rolled-back work.
+
     msg = tx.transaction.message
     meta = tx.meta
     if meta is None:
@@ -429,6 +433,10 @@ def convert_rpc_to_grpc(
         log_messages=meta.log_messages,
     )
 
+    if meta.err is not None:
+        # Preserve failure presence without fabricating a Yellowstone binary error enum.
+        grpc_meta.err.SetInParent()
+
     # 转换内部指令
     for group in meta.inner_instructions:
         grpc_group = grpc_meta.inner_instructions.add()
@@ -676,6 +684,7 @@ def rpc_get_transaction_result_dict_to_response(
             post_token_balances=[],
             loaded_addresses=loaded,
             compute_units_consumed=meta_dict.get("computeUnitsConsumed"),
+            err=meta_dict.get("err"),
         )
 
     return RpcTransactionResponse(
@@ -743,6 +752,8 @@ def rpc_response_to_solana_storage(
             ii.data = ix.data
             if ix.stack_height is not None:
                 ii.stack_height = ix.stack_height
+    if m.err is not None:
+        meta.err.SetInParent()
     if m.loaded_addresses:
         for w in m.loaded_addresses.writable:
             meta.loaded_writable_addresses.append(base58.b58decode(w))