Added more GraphQL docs to assist LLM agents.

linera-base/src/data_types.rs

@@ -1134,7 +1134,14 @@
 }
 
 doc_scalar!(Bytecode, "A WebAssembly module's bytecode");
-doc_scalar!(Amount, "A non-negative amount of tokens.");
+doc_scalar!(Amount, r#"
+A non-negative amount of tokens.
+
+An example of an `Amount`:
+```
+"1.234"
+```
+"#);
 doc_scalar!(BlockHeight, "A block height to identify blocks in a chain");
 doc_scalar!(
     Timestamp,
@@ -1147,14 +1154,14 @@
 );
 doc_scalar!(OracleResponse, "A record of a single oracle response.");
 doc_scalar!(BlobContent, "A blob of binary data.");
 doc_scalar!(
     Blob,
     "A blob of binary data, with its content-addressed blob ID."
 );
 doc_scalar!(
     UserApplicationDescription,
     "Description of the necessary information to run a user application"
 );
 
 /// The time it takes to compress a bytecode.
 #[cfg(with_metrics)]

linera-execution/src/graphql.rs

@@ -18,10 +18,21 @@
 };
 
 doc_scalar!(
     Epoch,
     "A number identifying the configuration of the chain (aka the committee)"
 );
-doc_scalar!(Recipient, "The recipient of a transfer");
+doc_scalar!(Recipient, r#"
+The recipient of a transfer.
+
+An example of a `Recipient`:
+```graphql
+{
+    Account: {
+        chain_id: <chain_id>
+    }
+}
+```
+"#);
 doc_scalar!(UserData, "Optional user message attached to a transfer");
 doc_scalar!(ValidatorName, "The identity of a validator");