Update README.md

README.md

@@ -142,23 +142,93 @@ python -m src.generate_benchmark --output ./data/benchmark_dataset.json
 
 Note: `data/prepared_dataset.json` is a **generated artifact** (optional) and is intentionally **not committed**.
 
-## Tool Protocols (Standardized)
-
-**SEARCH_TOKEN** — search on-chain token info.  
-Params: `symbol`, `address`, `chain` (solana|ethereum|bsc|base), `keyword`.
-
-**EXECUTE_SWAP** — execute token swap.  
-Params: `inputTokenSymbol`, `inputTokenCA`, `outputTokenCA`, `inputTokenAmount`, `inputTokenPercentage` (0-1), `outputTokenAmount`.
-
-Output format:
+## Tool Definitions & Schemas
+
+To ensure interoperability, DMind-3-nano uses strict JSON schemas for tool definitions. Below are the standard definitions used during training and inference.
+
+**1. SEARCH_TOKEN**
+Used to find token metadata or address on a specific chain.
+
+```json
+{
+  "name": "SEARCH_TOKEN",
+  "description": "Search for a cryptocurrency token on-chain to retrieve its metadata or address.",
+  "parameters": {
+    "type": "object",
+    "properties": {
+      "symbol": {
+        "type": "string",
+        "description": "The ticker symbol of the token (e.g., 'SOL', 'USDC')."
+      },
+      "address": {
+        "type": "string",
+        "description": "The specific contract address (CA) of the token, if known."
+      },
+      "chain": {
+        "type": "string",
+        "enum": ["solana", "ethereum", "bsc", "base"],
+        "description": "The target blockchain network."
+      },
+      "keyword": {
+        "type": "string",
+        "description": "General search keywords (e.g., project name) if symbol/address are unclear."
+      }
+    },
+    "required": []
+  }
+}
 ```
-<start_function_call>call:FUNCTION_NAME{key1:val1,key2:val2}<end_function_call>
+
+**2. EXECUTE_SWAP**
+Used to construct a swap transaction intent between two assets.
+```json
+{
+  "name": "EXECUTE_SWAP",
+  "description": "Propose a token swap transaction.",
+  "parameters": {
+    "type": "object",
+    "properties": {
+      "inputTokenSymbol": {
+        "type": "string",
+        "description": "Symbol of the token being sold (e.g., 'SOL')."
+      },
+      "inputTokenCA": {
+        "type": "string",
+        "description": "Contract address of the token being sold."
+      },
+      "outputTokenCA": {
+        "type": "string",
+        "description": "Contract address of the token being bought."
+      },
+      "inputTokenAmount": {
+        "type": "number",
+        "description": "Absolute amount of input token to swap."
+      },
+      "inputTokenPercentage": {
+        "type": "number",
+        "description": "Percentage of balance to swap (0.0 to 1.0), used if exact amount is not specified."
+      },
+      "outputTokenAmount": {
+        "type": "number",
+        "description": "Minimum amount of output token expected (optional/slippage related)."
+      }
+    },
+    "required": ["inputTokenSymbol"]
+  }
+}
 ```
 
-Example (Chinese input retained for coverage):
+**Output Format**
+The model outputs the function call wrapped in special tokens (standard FunctionGemma format):
+```plaintext
+<start_function_call>call:FUNCTION_NAME{key1:val1, key2:val2}<end_function_call>
 ```
-User: "查一下 Solana 上的 SOL"
-Model: <start_function_call>call:SEARCH_TOKEN{symbol:"SOL",chain:"solana"}<end_function_call>
+
+**Example:**
+
+User: "查一下 Solana 上的 SOL" Model:
+```plaintext
+<start_function_call>call:SEARCH_TOKEN{symbol:"SOL", chain:"solana"}<end_function_call>
 ```