Narrow example error handling; document datetime semantics

- examples/issue_token.py: wallet sync failures catch RPC/JSON-RPC errors
  specifically instead of Exception (programming errors stay loud)
- indexer/pool.py: document naive-datetime interpretation for block stats

Author: nullPointerEnjoyer

examples/issue_token.py

@@ -40,10 +40,12 @@
 import sys
 import time
 
+from mintlayer._jsonrpc import JSONRPCError
 from mintlayer.wallet import (
     Amount,
     IssueTokenParams,
     MintParams,
+    RPCError,
     TokenMetadata,
     TokenSupply,
 )
@@ -99,8 +101,9 @@ def main() -> None:
     # ── 2. Sync the wallet ───────────────────────────────────────────────────
     try:
         wallet.sync_wallet()
-    except Exception as exc:
-        # Non-fatal: the daemon may already be syncing.
+    except (RPCError, JSONRPCError) as exc:
+        # Non-fatal: the daemon may already be syncing. Deliberately narrow —
+        # programming errors must not be silenced here.
         log.info("sync wallet: %s (continuing)", exc)
 
     # ── 3. Derive a fresh address to act as the token authority ──────────────

mintlayer/indexer/pool.py

@@ -19,7 +19,12 @@ def get_pool(self, pool_id: str) -> Pool:
         return Pool.from_json(self.get(f"/pool/{_seg(pool_id)}"))
 
     def get_pool_block_stats(self, pool_id: str, from_time: datetime, to_time: datetime) -> int:
-        """Return the block count produced in the half-open interval [from, to)."""
+        """Return the block count produced in the half-open interval [from, to).
+
+        Naive datetimes are interpreted in the system's local timezone
+        (standard ``datetime.timestamp()`` semantics); pass tz-aware
+        datetimes for unambiguous absolute times.
+        """
         data = self.get(
             f"/pool/{_seg(pool_id)}/block-stats",
             {"from": int(from_time.timestamp()), "to": int(to_time.timestamp())},