fix(examples): align listeners and decoders with refreshed pump.fun IDL

Refreshes the read-only learning examples (Phase A3) against the post
Feb–Apr 2026 IDL changes:
  - CreateEvent now has 15 fields (timestamp, 4×u64 reserves, token_program,
    is_mayhem_mode, is_cashback_enabled). Listener parsers were truncating
    after `creator`; the v2 ones were also reading is_mayhem_mode at the
    wrong offset.
  - BondingCurve account is now 83 bytes (added is_cashback_coin).
  - PumpSwap Pool account is now 245 bytes (added is_cashback_coin) — the
    listen_programsubscribe dataSize filter was matching nothing.
  - IDL instruction `createV2` was renamed to `create_v2`; the legacy
    `create` instruction added a `creator: pubkey` arg in March 2026.
  - decode_from_blockSubscribe.py decoder now handles bool, i64, u32, u16,
    u8, and the OptionBool defined type (1-byte wire format).

Files touched (all under learning-examples/):
  bonding-curve-progress/get_bonding_curve_status.py  — V4 struct (cashback)
  bonding-curve-progress/poll_bonding_curve_progress.py
  decode_from_blockSubscribe.py
  decode_from_getAccountInfo.py
  decode_from_getTransaction.py
  listen-migrations/compare_migration_listeners.py
  listen-migrations/listen_programsubscribe.py
  listen-new-tokens/compare_listeners.py
  listen-new-tokens/listen_blocksubscribe.py
  listen-new-tokens/listen_geyser.py
  listen-new-tokens/listen_logsubscribe.py
  listen-new-tokens/listen_logsubscribe_abc.py

Verified live against mainnet — listeners decode tokens including
mayhem-mode and cashback-enabled curves correctly.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

learning-examples/bonding-curve-progress/get_bonding_curve_status.py

@@ -65,6 +65,19 @@ class BondingCurveState:
         "is_mayhem_mode" / Flag,  # Added mayhem mode flag - 1 byte
     )
 
+    # V4: V3 + is_cashback_coin (83 bytes total: 8 discriminator + 75 data) — added in the late-Feb 2026 cashback upgrade
+    _STRUCT_V4 = Struct(
+        "virtual_token_reserves" / Int64ul,
+        "virtual_sol_reserves" / Int64ul,
+        "real_token_reserves" / Int64ul,
+        "real_sol_reserves" / Int64ul,
+        "token_total_supply" / Int64ul,
+        "complete" / Flag,
+        "creator" / Bytes(32),
+        "is_mayhem_mode" / Flag,
+        "is_cashback_coin" / Flag,
+    )
+
     def __init__(self, data: bytes) -> None:
         """Parse bonding curve data."""
         if data[:8] != EXPECTED_DISCRIMINATOR:
@@ -75,14 +88,19 @@ class BondingCurveState:
         if total_length == 81:  # V2: Creator only
             parsed = self._STRUCT_V2.parse(data[8:])
             self.__dict__.update(parsed)
-            # Convert raw bytes to Pubkey for creator field
             self.creator = Pubkey.from_bytes(self.creator)
             self.is_mayhem_mode = False
+            self.is_cashback_coin = False
 
-        elif total_length >= 82:  # V3: Creator + mayhem mode
+        elif total_length == 82:  # V3: Creator + mayhem
             parsed = self._STRUCT_V3.parse(data[8:])
             self.__dict__.update(parsed)
-            # Convert raw bytes to Pubkey for creator field
+            self.creator = Pubkey.from_bytes(self.creator)
+            self.is_cashback_coin = False
+
+        elif total_length >= 83:  # V4: Creator + mayhem + cashback
+            parsed = self._STRUCT_V4.parse(data[8:])
+            self.__dict__.update(parsed)
             self.creator = Pubkey.from_bytes(self.creator)
 
         else:
@@ -162,6 +180,9 @@ async def check_token_status(mint_address: str) -> None:
                 print(
                     f"Mayhem Mode:         {'✅ Enabled' if curve_state.is_mayhem_mode else '❌ Disabled'}"
                 )
+                print(
+                    f"Cashback Coin:       {'✅ Enabled' if curve_state.is_cashback_coin else '❌ Disabled'}"
+                )
                 print(
                     f"Completed:           {'✅ Migrated' if curve_state.complete else '❌ Bonding curve'}"
                 )

learning-examples/bonding-curve-progress/poll_bonding_curve_progress.py

@@ -104,6 +104,12 @@ def parse_curve_state(data: bytes) -> dict:
     else:
         result["is_mayhem_mode"] = False
 
+    # Parse is_cashback_coin if present (added in late-Feb 2026 cashback upgrade)
+    if data_length >= 75:
+        result["is_cashback_coin"] = bool(data[82])
+    else:
+        result["is_cashback_coin"] = False
+
     return result