debug, schemas: make timeout advisory for streaming clients

Clients that do not support execution timeouts (e.g. streaming JSON-RPC
implementations) MAY ignore the timeout field. When a timeout is supported
and reached, the client MUST still return an error with no partial results.

Made-with: Cursor

Author: MysticRyuujin

src/debug/trace.yaml

@@ -19,8 +19,9 @@
 
     The response is an array ordered by transaction index within the block.
     Each entry includes the transaction hash paired with its trace result.
-    If the execution timeout is reached before tracing completes, the client
-    MUST return an error; no partial results are returned.
+    If a timeout is configured and reached before tracing completes, the
+    client MUST return an error; no partial results are returned. Clients
+    that do not support execution timeouts MAY ignore the timeout field.
   params:
     - name: Block
       required: true
@@ -127,8 +128,9 @@
 
     The response is an array ordered by transaction index within the block.
     Each entry includes the transaction hash paired with its trace result.
-    If the execution timeout is reached before tracing completes, the client
-    MUST return an error; no partial results are returned.
+    If a timeout is configured and reached before tracing completes, the
+    client MUST return an error; no partial results are returned. Clients
+    that do not support execution timeouts MAY ignore the timeout field.
 
     Clients MUST return an error if no block with the given hash is found.
   params:

src/schemas/opcode-tracer.yaml

@@ -38,10 +38,11 @@ TraceConfig:
     timeout:
       title: execution timeout
       description: >-
-        Duration string specifying a timeout for trace execution. Applies to
-        all tracers. Accepts Go duration strings (e.g. "5s", "300ms", "2m").
-        Default: "5s". When the timeout is reached, the client MUST return an
-        error; no partial results are returned.
+        Optional duration string specifying a timeout for trace execution.
+        Clients that do not support execution timeouts (e.g. streaming
+        implementations) MAY ignore this field. When supported and the timeout
+        is reached, the client MUST return an error; no partial results are
+        returned. Accepts Go duration strings (e.g. "5s", "300ms", "2m").
       type: string
     disableStorage:
       title: disable storage capture