@wowok/agent-mcp 2.5.2 → 2.5.3

package/dist/schemas/query_toolkit.schema.json

@@ -456,6 +456,138 @@
           ],
           "additionalProperties": false,
           "description": "Query objects (Payments, Tokens, NFTs) received by a specific object. Use to track incoming payments or items sent to an on-chain object. Supports pagination and type filter. Returns: ReceivedBalance | ReceivedNormal[]"
+        },
+        {
+          "type": "object",
+          "properties": {
+            "query_type": {
+              "type": "string",
+              "const": "onchain_transaction"
+            },
+            "digest": {
+              "type": "string",
+              "description": "Transaction digest (0x...) to verify. Use after any on-chain operation to confirm what actually happened on-chain — object changes, balance changes, gas used, success/failure status. This is the 'OperationProof' primitive for the Verify step."
+            },
+            "no_cache": {
+              "type": "boolean",
+              "description": "Set to true to bypass cache and fetch fresh on-chain data"
+            },
+            "network": {
+              "$ref": "#/definitions/query_toolkit/anyOf/4/properties/network",
+              "description": "Network entrypoint: Specifies which network the operation occurs on"
+            }
+          },
+          "required": [
+            "query_type",
+            "digest"
+          ],
+          "additionalProperties": false,
+          "description": "Verify what a specific transaction did on-chain — the 'OperationProof' primitive. After executing any operation, call this with the returned digest to confirm: status (success/failed), object changes (created/mutated/deleted), balance changes, gas used, and events. Essential for the 5-step loop's Verify step. Returns: TransactionDetail | undefined"
+        },
+        {
+          "type": "object",
+          "properties": {
+            "query_type": {
+              "type": "string",
+              "const": "onchain_object_history"
+            },
+            "object": {
+              "$ref": "#/definitions/query_toolkit/anyOf/4/properties/name_or_address",
+              "description": "Object ID (0x...) or LocalMark name. Query the provenance chain — every transaction that created, mutated, or deleted this object. Use to trace how an object reached its current state."
+            },
+            "cursor": {
+              "type": [
+                "string",
+                "null"
+              ],
+              "description": "Pagination cursor from previous page's next_cursor"
+            },
+            "limit": {
+              "type": [
+                "number",
+                "null"
+              ],
+              "description": "Max results per page (default 20, max 50)"
+            },
+            "order": {
+              "type": "string",
+              "enum": [
+                "ascending",
+                "descending"
+              ],
+              "description": "Sort order: ascending=oldest first, descending=newest first (default)"
+            },
+            "no_cache": {
+              "type": "boolean",
+              "description": "Set to true to bypass cache and fetch fresh on-chain data"
+            },
+            "network": {
+              "$ref": "#/definitions/query_toolkit/anyOf/4/properties/network",
+              "description": "Network entrypoint: Specifies which network the operation occurs on"
+            }
+          },
+          "required": [
+            "query_type",
+            "object"
+          ],
+          "additionalProperties": false,
+          "description": "FORENSICS TOOL — query all transactions that touched an object. WARNING: this can lead to non-convergent queries (each tx touches more objects with their own history). For AI context building, use assemble_context instead — it extracts embedded history from object states (ProgressSession.forwards, etc.) without infinite recursion. This tool is for auditing/forensics only. Returns: TransactionHistoryAnswer | undefined"
+        },
+        {
+          "type": "object",
+          "properties": {
+            "query_type": {
+              "type": "string",
+              "const": "onchain_address_activity"
+            },
+            "name_or_address": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/query_toolkit/anyOf/8/properties/name_or_address/anyOf/0"
+                },
+                {
+                  "$ref": "#/definitions/query_toolkit/anyOf/8/properties/name_or_address/anyOf/1"
+                }
+              ],
+              "description": "Address (0x...) or account name. Query all on-chain activity by this actor — every transaction they sent. Use to build a user's on-chain activity profile or verify an actor's history."
+            },
+            "cursor": {
+              "type": [
+                "string",
+                "null"
+              ],
+              "description": "Pagination cursor from previous page's next_cursor"
+            },
+            "limit": {
+              "type": [
+                "number",
+                "null"
+              ],
+              "description": "Max results per page (default 20, max 50)"
+            },
+            "order": {
+              "type": "string",
+              "enum": [
+                "ascending",
+                "descending"
+              ],
+              "description": "Sort order: ascending=oldest first, descending=newest first (default)"
+            },
+            "no_cache": {
+              "type": "boolean",
+              "description": "Set to true to bypass cache and fetch fresh on-chain data"
+            },
+            "network": {
+              "$ref": "#/definitions/query_toolkit/anyOf/4/properties/network",
+              "description": "Network entrypoint: Specifies which network the operation occurs on"
+            }
+          },
+          "required": [
+            "query_type",
+            "name_or_address"
+          ],
+          "additionalProperties": false,
+          "description": "FORENSICS TOOL — query all transactions sent by an address. WARNING: like onchain_object_history, this can lead to non-convergent queries. For AI context building, use assemble_context (extracts embedded history) or query_events (real-time transitions) instead. This tool is for auditing/user-activity profiling only. Returns: TransactionHistoryAnswer | undefined"
         }
       ]
     }