@wowok/agent-mcp 2.4.1 → 2.5.0

package/dist/schemas/onchain_operations_proof.schema.json

@@ -0,0 +1,699 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://wowok.net/schemas/onchain_operations_proof.json",
+  "title": "Proof Operation",
+  "description": "On-chain proof operation schema",
+  "type": "object",
+  "properties": {
+    "operation_type": {
+      "const": "proof"
+    },
+    "data": {
+      "$ref": "#/definitions/data",
+      "$schema": "http://json-schema.org/draft-07/schema#"
+    },
+    "env": {
+      "$ref": "#/definitions/env",
+      "$schema": "http://json-schema.org/draft-07/schema#"
+    },
+    "submission": {
+      "$ref": "#/definitions/submission",
+      "$schema": "http://json-schema.org/draft-07/schema#"
+    }
+  },
+  "required": [
+    "operation_type",
+    "data"
+  ],
+  "definitions": {
+    "data": {
+      "type": "object",
+      "properties": {
+        "namedNew": {
+          "type": "object",
+          "properties": {
+            "name": {
+              "type": "string",
+              "description": "The name of the object"
+            },
+            "tags": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "description": "The tags of the object"
+            },
+            "onChain": {
+              "type": "boolean",
+              "description": "CRITICAL: Whether to sync the name to the blockchain. DEFAULT (undefined/false): The name is stored LOCALLY ONLY on your device (PRIVATE). If set to true: The name is published ON-CHAIN and becomes PUBLICLY VISIBLE to everyone. Only set to true for displaying the relationships you are willing to make public on the chain."
+            },
+            "replaceExistName": {
+              "type": "boolean",
+              "description": "FORCE CLAIM: Set to true ONLY when the user explicitly expresses a STRONG INTENTION to forcefully take over an existing name (e.g., 'I must use this name', 'force rename', 'replace the existing one'). WARNING: This will UNBIND the name from its original object and rebind it to the new one, potentially breaking existing references. If not specified or false: the operation will FAIL with an error when the name is already in use (safe default behavior)."
+            }
+          },
+          "additionalProperties": false,
+          "description": "Assign a name and optional tags to a new object. By default, names are stored LOCALLY (private) on your device. Set 'onChain: true' to create a PUBLIC on-chain identity visible to everyone. IMPORTANT: If the requested name is already taken, the operation will FAIL by default. Only set 'replaceExistName: true' when the user EXPLICITLY demands to forcefully claim the name."
+        },
+        "description": {
+          "type": "string",
+          "description": "Human-readable description of this Proof. Required field."
+        },
+        "proof": {
+          "type": "string",
+          "maxLength": 10240,
+          "description": "Proof content. e.g. merkle tree root"
+        },
+        "server_pubkey": {
+          "type": "string",
+          "maxLength": 2048,
+          "description": "Server public key"
+        },
+        "server_signature": {
+          "type": "string",
+          "maxLength": 40480,
+          "description": "Server signature"
+        },
+        "proof_type": {
+          "anyOf": [
+            {
+              "type": "integer",
+              "minimum": 1
+            },
+            {
+              "type": "string",
+              "pattern": "^\\d+$"
+            }
+          ],
+          "description": "Proof type. 1: WOWOK_WTS_PROOF_TYPE (WTS proof); 1-100 reserved for Wowok; user-defined must be > 100. Numeric string accepted."
+        },
+        "item_count": {
+          "anyOf": [
+            {
+              "type": "integer",
+              "minimum": 0
+            },
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "Item count. e.g. number of items in the merkle tree"
+        },
+        "about_address": {
+          "anyOf": [
+            {
+              "type": "string",
+              "description": "Valid ID: 0x prefix + 64 hex characters, or builtin ID (0x5-0x9, 0xa, 0xc, 0xd, 0x403, 0xaaa, 0xaab, 0xacc)"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "About address. Accepts null/undefined (→ Move Option::none). When provided, must be a raw 0x-prefixed address (NOT a name). e.g. address of the entity being proved."
+        }
+      },
+      "required": [
+        "description",
+        "proof",
+        "server_pubkey",
+        "server_signature",
+        "proof_type"
+      ],
+      "additionalProperties": false,
+      "description": "On-chain Proof creation. USAGE: Set 'namedNew' field with {name, tag?} to create a named Proof. Proof is an immutable object - it can only be created, not modified. The 'namedNew' field is CRITICAL and REQUIRED."
+    },
+    "env": {
+      "type": "object",
+      "properties": {
+        "account": {
+          "type": "string",
+          "description": "Account/Object name or ID. If specifying an account, use empty string '' for the default account. If it starts with '0x', it will be treated as an ID. Otherwise, it will be treated as a name (max 64 bcs characters).",
+          "default": ""
+        },
+        "permission_guard": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "List of permission guard IDs. Used to extend additional operation permissions (requires verification and configuration in the Permission object)."
+        },
+        "no_cache": {
+          "type": "boolean",
+          "description": "Whether to disable caching."
+        },
+        "network": {
+          "type": "string",
+          "enum": [
+            "localnet",
+            "testnet",
+            "mainnet"
+          ],
+          "description": "Network entrypoint: Specifies which network the operation occurs on"
+        },
+        "referrer": {
+          "$ref": "#/definitions/env/properties/account",
+          "description": "Referrer ID. If the user is using the network for the first time, the referrer ID will be recorded."
+        },
+        "confirmed": {
+          "type": "boolean",
+          "description": "Phase 2 ConfirmGate: set to true to proceed after a 'pending_confirmation' result. The operation is NOT executed until you re-call with confirmed=true after user consent."
+        },
+        "user_intent_phrases": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Phase 2 ConfirmGate: explicit user intent phrases collected from conversation context (e.g. 'use default account', 'force publish'). Used to bypass confirmation rules whose bypass_on_explicit_intent matches."
+        },
+        "project": {
+          "type": "string",
+          "description": "Phase 2 ProjectService: explicit project prefix to assign this object to (e.g. 'myshop'). When set, the object is tagged with 'project:<prefix>' automatically. Overrides the prefix parsed from the object name."
+        },
+        "client_schema_version": {
+          "type": "string",
+          "description": "Client-side schema version (semver, e.g. '1.0.0'). When provided, the server checks compatibility and attaches warnings if mismatched."
+        },
+        "schema_strict_mode": {
+          "type": "boolean",
+          "description": "When true, schema incompatibility returns an error instead of a warning. Default: false (warn mode)."
+        }
+      },
+      "additionalProperties": false,
+      "description": "IMPORTANT: Execution environment includes: account for signing operations, network selection ([object Object]), additional Guard permissions, and more. Used to specify context information during the call. If account is not specified, the default account (\"\") will be used."
+    },
+    "submission": {
+      "type": "object",
+      "properties": {
+        "type": {
+          "type": "string",
+          "const": "submission",
+          "description": "Discriminator for this result variant. Constraint: always 'submission'. Example: 'submission'"
+        },
+        "guard": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "object": {
+                "type": "string",
+                "description": "Guard object name or ID to verify against. Example: 'my-delivery-guard' or '0x123...'"
+              },
+              "impack": {
+                "type": "boolean",
+                "description": "Whether this Guard's verification result participates in the final logic. Constraint: if false, the Guard is checked but does not block the operation. Example: true"
+              }
+            },
+            "required": [
+              "object",
+              "impack"
+            ],
+            "additionalProperties": false
+          },
+          "maxItems": 20,
+          "description": "Array of Guard objects to verify. Constraint: at most 20 entries (MAX_GUARD_COUNT_PASSPORT). Relation: each entry corresponds to a Guard bound to the operation."
+        },
+        "submission": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "guard": {
+                "$ref": "#/definitions/submission/properties/guard/items/properties/object",
+                "description": "Guard object name or ID that requires submission data. Example: 'my-delivery-guard'"
+              },
+              "submission": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "properties": {
+                    "identifier": {
+                      "type": "integer",
+                      "minimum": 0,
+                      "maximum": 255,
+                      "description": "Identifier (0-255) for data lookup in Guard table."
+                    },
+                    "b_submission": {
+                      "type": "boolean",
+                      "description": "Whether user submission is required for this data"
+                    },
+                    "value_type": {
+                      "anyOf": [
+                        {
+                          "type": "number",
+                          "const": 0,
+                          "description": "Bool (0)"
+                        },
+                        {
+                          "type": "number",
+                          "const": 1,
+                          "description": "Address (1)"
+                        },
+                        {
+                          "type": "number",
+                          "const": 2,
+                          "description": "String (2)"
+                        },
+                        {
+                          "type": "number",
+                          "const": 3,
+                          "description": "U8 (3)"
+                        },
+                        {
+                          "type": "number",
+                          "const": 4,
+                          "description": "U16 (4)"
+                        },
+                        {
+                          "type": "number",
+                          "const": 5,
+                          "description": "U32 (5)"
+                        },
+                        {
+                          "type": "number",
+                          "const": 6,
+                          "description": "U64 (6)"
+                        },
+                        {
+                          "type": "number",
+                          "const": 7,
+                          "description": "U128 (7)"
+                        },
+                        {
+                          "type": "number",
+                          "const": 8,
+                          "description": "U256 (8)"
+                        },
+                        {
+                          "type": "number",
+                          "const": 9,
+                          "description": "VecBool (9)"
+                        },
+                        {
+                          "type": "number",
+                          "const": 10,
+                          "description": "VecAddress (10)"
+                        },
+                        {
+                          "type": "number",
+                          "const": 11,
+                          "description": "VecString (11)"
+                        },
+                        {
+                          "type": "number",
+                          "const": 12,
+                          "description": "VecU8 (12)"
+                        },
+                        {
+                          "type": "number",
+                          "const": 13,
+                          "description": "VecU16 (13)"
+                        },
+                        {
+                          "type": "number",
+                          "const": 14,
+                          "description": "VecU32 (14)"
+                        },
+                        {
+                          "type": "number",
+                          "const": 15,
+                          "description": "VecU64 (15)"
+                        },
+                        {
+                          "type": "number",
+                          "const": 16,
+                          "description": "VecU128 (16)"
+                        },
+                        {
+                          "type": "number",
+                          "const": 17,
+                          "description": "VecU256 (17)"
+                        },
+                        {
+                          "type": "number",
+                          "const": 18,
+                          "description": "VecVecU8 (18)"
+                        },
+                        {
+                          "type": "string",
+                          "const": "Bool",
+                          "description": "Bool"
+                        },
+                        {
+                          "type": "string",
+                          "const": "Address",
+                          "description": "Address"
+                        },
+                        {
+                          "type": "string",
+                          "const": "String",
+                          "description": "String"
+                        },
+                        {
+                          "type": "string",
+                          "const": "U8",
+                          "description": "U8"
+                        },
+                        {
+                          "type": "string",
+                          "const": "U16",
+                          "description": "U16"
+                        },
+                        {
+                          "type": "string",
+                          "const": "U32",
+                          "description": "U32"
+                        },
+                        {
+                          "type": "string",
+                          "const": "U64",
+                          "description": "U64"
+                        },
+                        {
+                          "type": "string",
+                          "const": "U128",
+                          "description": "U128"
+                        },
+                        {
+                          "type": "string",
+                          "const": "U256",
+                          "description": "U256"
+                        },
+                        {
+                          "type": "string",
+                          "const": "VecBool",
+                          "description": "VecBool"
+                        },
+                        {
+                          "type": "string",
+                          "const": "VecAddress",
+                          "description": "VecAddress"
+                        },
+                        {
+                          "type": "string",
+                          "const": "VecString",
+                          "description": "VecString"
+                        },
+                        {
+                          "type": "string",
+                          "const": "VecU8",
+                          "description": "VecU8"
+                        },
+                        {
+                          "type": "string",
+                          "const": "VecU16",
+                          "description": "VecU16"
+                        },
+                        {
+                          "type": "string",
+                          "const": "VecU32",
+                          "description": "VecU32"
+                        },
+                        {
+                          "type": "string",
+                          "const": "VecU64",
+                          "description": "VecU64"
+                        },
+                        {
+                          "type": "string",
+                          "const": "VecU128",
+                          "description": "VecU128"
+                        },
+                        {
+                          "type": "string",
+                          "const": "VecU256",
+                          "description": "VecU256"
+                        },
+                        {
+                          "type": "string",
+                          "const": "VecVecU8",
+                          "description": "VecVecU8"
+                        },
+                        {
+                          "type": "string",
+                          "const": "bool",
+                          "description": "bool"
+                        },
+                        {
+                          "type": "string",
+                          "const": "address",
+                          "description": "address"
+                        },
+                        {
+                          "type": "string",
+                          "const": "string",
+                          "description": "string"
+                        },
+                        {
+                          "type": "string",
+                          "const": "u8",
+                          "description": "u8"
+                        },
+                        {
+                          "type": "string",
+                          "const": "u16",
+                          "description": "u16"
+                        },
+                        {
+                          "type": "string",
+                          "const": "u32",
+                          "description": "u32"
+                        },
+                        {
+                          "type": "string",
+                          "const": "u64",
+                          "description": "u64"
+                        },
+                        {
+                          "type": "string",
+                          "const": "u128",
+                          "description": "u128"
+                        },
+                        {
+                          "type": "string",
+                          "const": "u256",
+                          "description": "u256"
+                        },
+                        {
+                          "type": "string",
+                          "const": "vecbool",
+                          "description": "vecbool"
+                        },
+                        {
+                          "type": "string",
+                          "const": "vecaddress",
+                          "description": "vecaddress"
+                        },
+                        {
+                          "type": "string",
+                          "const": "vecstring",
+                          "description": "vecstring"
+                        },
+                        {
+                          "type": "string",
+                          "const": "vecu8",
+                          "description": "vecu8"
+                        },
+                        {
+                          "type": "string",
+                          "const": "vecu16",
+                          "description": "vecu16"
+                        },
+                        {
+                          "type": "string",
+                          "const": "vecu32",
+                          "description": "vecu32"
+                        },
+                        {
+                          "type": "string",
+                          "const": "vecu64",
+                          "description": "vecu64"
+                        },
+                        {
+                          "type": "string",
+                          "const": "vecu128",
+                          "description": "vecu128"
+                        },
+                        {
+                          "type": "string",
+                          "const": "vecu256",
+                          "description": "vecu256"
+                        },
+                        {
+                          "type": "string",
+                          "const": "vecvecu8",
+                          "description": "vecvecu8"
+                        }
+                      ],
+                      "description": "Type of the value"
+                    },
+                    "value": {
+                      "anyOf": [
+                        {
+                          "type": "boolean"
+                        },
+                        {
+                          "anyOf": [
+                            {
+                              "type": "object",
+                              "properties": {
+                                "name_or_address": {
+                                  "$ref": "#/definitions/submission/properties/guard/items/properties/object",
+                                  "description": "Account/Object name or ID. If specifying an account, use empty string '' for the default account. If it starts with '0x', it will be treated as an ID. Otherwise, it will be treated as a name (max 64 bcs characters)."
+                                },
+                                "local_mark_first": {
+                                  "type": "boolean",
+                                  "description": "Whether to prioritize local marks, if true, prioritize local marks, otherwise prioritize global marks"
+                                }
+                              },
+                              "additionalProperties": false,
+                              "description": "Account or address lookup object. Use this to specify which account to use for an operation. EXAMPLE: { name_or_address: 'testor2' } - looks up account by name; EXAMPLE: { name_or_address: '0x1234...' } - uses address directly; If name_or_address is empty string '', uses the default local account."
+                            },
+                            {
+                              "type": "string"
+                            }
+                          ]
+                        },
+                        {
+                          "type": "string"
+                        },
+                        {
+                          "type": "number"
+                        },
+                        {
+                          "type": "array",
+                          "items": {
+                            "type": "boolean"
+                          }
+                        },
+                        {
+                          "anyOf": [
+                            {
+                              "type": "object",
+                              "properties": {
+                                "entities": {
+                                  "type": "array",
+                                  "items": {
+                                    "$ref": "#/definitions/submission/properties/submission/items/properties/submission/items/properties/value/anyOf/1/anyOf/0"
+                                  }
+                                },
+                                "check_all_founded": {
+                                  "type": "boolean",
+                                  "description": "Whether to check all entities are found, if true, all entities must be found (abort and throw exception if any ID not found); if false, only return found IDs"
+                                }
+                              },
+                              "required": [
+                                "entities"
+                              ],
+                              "additionalProperties": false,
+                              "description": "Used to batch find account or object IDs by name"
+                            },
+                            {
+                              "type": "array",
+                              "items": {
+                                "type": "string"
+                              }
+                            }
+                          ]
+                        },
+                        {
+                          "type": "array",
+                          "items": {
+                            "type": "string"
+                          }
+                        },
+                        {
+                          "type": "array",
+                          "items": {
+                            "type": "number"
+                          }
+                        },
+                        {
+                          "type": "array",
+                          "items": {
+                            "type": "array",
+                            "items": {
+                              "type": "number"
+                            }
+                          }
+                        }
+                      ],
+                      "description": "The actual value data"
+                    },
+                    "name": {
+                      "type": "string",
+                      "default": "",
+                      "description": "Name or description of this data"
+                    },
+                    "object_type": {
+                      "type": "string",
+                      "enum": [
+                        "Permission",
+                        "Repository",
+                        "Arb",
+                        "Arbitration",
+                        "Service",
+                        "Machine",
+                        "Order",
+                        "Progress",
+                        "Payment",
+                        "Treasury",
+                        "Guard",
+                        "Demand",
+                        "Passport",
+                        "Allocation",
+                        "Resource",
+                        "Reward",
+                        "Discount",
+                        "EntityRegistrar",
+                        "EntityLinker",
+                        "Proof",
+                        "WReceivedObject",
+                        "Contact",
+                        "TableItem_ProgressHistory",
+                        "TableItem_PermissionPerm",
+                        "TableItem_DemandPresenter",
+                        "TableItem_MachineNode",
+                        "TableItem_TreasuryHistory",
+                        "TableItem_RepositoryData",
+                        "TableItem_RewardRecord",
+                        "TableItem_EntityLinker",
+                        "TableItem_AddressMark",
+                        "TableItem_EntityRegistrar"
+                      ],
+                      "description": "Object type when value_type is Address and represents a specific object"
+                    }
+                  },
+                  "required": [
+                    "identifier",
+                    "b_submission",
+                    "value_type"
+                  ],
+                  "additionalProperties": false,
+                  "description": "Guard table item"
+                },
+                "description": "User-submitted data matching the Guard's required fields. Relation: structure must match the Guard table's column definitions. Example: [{field:'delivery_proof', value:'Qm...'}]"
+              }
+            },
+            "required": [
+              "guard",
+              "submission"
+            ],
+            "additionalProperties": false,
+            "description": "One Guard's submission data: the Guard to verify plus the user-provided data that satisfies its requirements."
+          },
+          "description": "User-submitted data for each Guard. Relation: one entry per Guard in the guard array; fill submission fields and resubmit via call_with_submission."
+        }
+      },
+      "required": [
+        "type",
+        "guard",
+        "submission"
+      ],
+      "additionalProperties": false,
+      "description": "Guard verification required. The operation was blocked because one or more Guards require user-submitted data. Fill the submission array and resubmit. Semantic status is 'pending_input'."
+    }
+  }
+}