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/decode_from_blockSubscribe.py

@@ -19,23 +19,52 @@ def load_transaction(file_path):
 
 
 def decode_instruction(ix_data, ix_def):
+    """Decode an instruction's args based on its IDL definition.
+
+    Supports the primitive scalar types and the `OptionBool` defined type
+    (added in the late-Feb 2026 cashback upgrade — `OptionBool` is a struct
+    wrapping a single bool, so it serializes as 1 byte on the wire).
+    """
     args = {}
     offset = 8  # Skip 8-byte discriminator
 
     for arg in ix_def["args"]:
-        if arg["type"] == "u64":
+        t = arg["type"]
+        if t == "u64":
             value = struct.unpack_from("<Q", ix_data, offset)[0]
             offset += 8
-        elif arg["type"] == "pubkey":
+        elif t == "i64":
+            value = struct.unpack_from("<q", ix_data, offset)[0]
+            offset += 8
+        elif t == "u32":
+            value = struct.unpack_from("<I", ix_data, offset)[0]
+            offset += 4
+        elif t == "u16":
+            value = struct.unpack_from("<H", ix_data, offset)[0]
+            offset += 2
+        elif t == "u8":
+            value = ix_data[offset]
+            offset += 1
+        elif t == "bool":
+            value = bool(ix_data[offset])
+            offset += 1
+        elif t == "pubkey":
             value = ix_data[offset : offset + 32].hex()
             offset += 32
-        elif arg["type"] == "string":
+        elif t == "string":
             length = struct.unpack_from("<I", ix_data, offset)[0]
             offset += 4
             value = ix_data[offset : offset + length].decode("utf-8")
             offset += length
+        elif isinstance(t, dict) and "defined" in t:
+            defined_name = t["defined"]["name"] if isinstance(t["defined"], dict) else t["defined"]
+            if defined_name == "OptionBool":
+                value = bool(ix_data[offset])
+                offset += 1
+            else:
+                raise ValueError(f"Unsupported defined type: {defined_name}")
         else:
-            raise ValueError(f"Unsupported type: {arg['type']}")
+            raise ValueError(f"Unsupported type: {t}")
 
         args[arg["name"]] = value