add better descriptions

Author: laviniat1996

ecosystem/rpc/toncenter/v3.yaml

@@ -1411,8 +1411,7 @@ paths:
                 $ref: '#/components/schemas/RequestError'
   /api/v3/runGetMethod:
     post:
-      description: 'Run get method of smart contract. Stack supports only `num`, `cell`
-        and `slice` types.'
+      description: 'Executes a read only get-method of a smart contract. Use this endpoint to call TVM methods without creating a transaction onchain. The request must include the method name and "stack" array with input arguments.'
       tags:
       - Legacy (v2-compatible)
       summary: Run smart contract get-method
@@ -2905,10 +2904,31 @@ components:
           type: string
     V2StackEntity:
       type: object
+      required: ["type", "value"]
+      description: "Represents one argument passed to a TVM get-method call. Each argument has a type and a value."
       properties:
         type:
           type: string
-        value: {}
+          description: 'Specifies the data type of this stack argument. Use "int", "uint", or "num" for numbers; "cell", "slice", or "builder" for base64-encoded BOC strings; "address" for TON addresses; "tuple" or "list" for arrays of nested arguments; or "null" when the value is empty.'
+          enum:
+            - "int"
+            - "uint"
+            - "num"
+            - "cell"
+            - "slice"
+            - "builder"
+            - "address"
+            - "tuple"
+            - "list"
+            - "null"
+        value:
+          description: 'Holds the actual value for this argument. For numeric types, use a decimal or hex string (for example "1435" or "0x7B"). For cell, slice, or builder, use a base64-encoded BOC string. For address, use a TON address string. For tuple or list, provide an array of nested stack items. The value can be null if no data is expected.'
+          nullable: true
+          anyOf:
+            - type: string
+            - type: array
+              items:
+                $ref: "#/components/schemas/V2StackEntity"
     V2WalletInformation:
       type: object
       properties: