From 0fc4a3224af945a8d643a9de8946e53ad578b0da Mon Sep 17 00:00:00 2001
From: "coderabbitai[bot]"
 <136622811+coderabbitai[bot]@users.noreply.github.com>
Date: Tue, 22 Sep 2026 13:56:16 +0000
Subject: [PATCH] docs(arbiter): clarify decision error handling when request
 writes fail

---
 src/contract/src/arbiter.rs | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/src/contract/src/arbiter.rs b/src/contract/src/arbiter.rs
index 4b920e4..ec26c34 100644
--- a/src/contract/src/arbiter.rs
+++ b/src/contract/src/arbiter.rs
@@ -187,6 +187,12 @@ impl ArbiterClient {
     }
 
     /// Ask the arbiter for a consensus decision.
+    ///
+    /// If the arbiter closes its input before the request is fully written,
+    /// the response still determines the outcome: no response returns
+    /// [`ArbiterError::Closed`], while malformed output returns
+    /// [`ArbiterError::Malformed`]. Other request-write failures return
+    /// [`ArbiterError::Transport`].
     pub fn decide(
         &self,
         llm_confidence: f64,