@wowok/agent-mcp 2.2.13 → 2.2.14

package/dist/schemas/onchain_operations_order.schema.json

@@ -0,0 +1,830 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://wowok.net/schemas/onchain_operations_order.json",
+  "title": "Order Operation",
+  "description": "On-chain order operation schema",
+  "type": "object",
+  "properties": {
+    "operation_type": {
+      "const": "order"
+    },
+    "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": {
+        "object": {
+          "type": "string",
+          "description": "Order object ID or name."
+        },
+        "agents": {
+          "type": "object",
+          "properties": {
+            "entities": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "name_or_address": {
+                    "$ref": "#/definitions/data/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."
+              }
+            },
+            "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": "Order agents. Agents can operate the order, such as canceling the order, modifying the order status, etc.; but cannot receive the funds received by the order."
+        },
+        "required_info": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/data/properties/agents/properties/entities/items/properties/name_or_address"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "Contact object ID (recipient) or WTS Proof object (delivery proof) that information has been delivered via Wowok Messenger."
+        },
+        "progress": {
+          "type": "object",
+          "properties": {
+            "operation": {
+              "type": "object",
+              "properties": {
+                "next_node_name": {
+                  "type": "string",
+                  "description": "Next node name."
+                },
+                "forward": {
+                  "$ref": "#/definitions/data/properties/progress/properties/operation/properties/next_node_name",
+                  "description": "Next forward name."
+                }
+              },
+              "required": [
+                "next_node_name",
+                "forward"
+              ],
+              "additionalProperties": false,
+              "description": "Specify a specific operation between current node and next node."
+            },
+            "hold": {
+              "type": "boolean",
+              "description": "Whether to lock operation permission. When true, locks the permission; when false or omitted, submits operation result directly."
+            },
+            "adminUnhold": {
+              "type": "boolean",
+              "description": "Whether to allow admin to force unlock. Only applicable when hold is true."
+            },
+            "message": {
+              "type": "string",
+              "description": "Operation result message."
+            }
+          },
+          "required": [
+            "operation"
+          ],
+          "additionalProperties": false,
+          "description": "Advance order process"
+        },
+        "arb_confirm": {
+          "type": "object",
+          "properties": {
+            "arb": {
+              "$ref": "#/definitions/data/properties/object",
+              "description": "Arb object ID or name."
+            },
+            "confirm": {
+              "type": "boolean",
+              "description": "Whether to confirm that the submitted arbitration materials are valid for arbitration."
+            },
+            "description": {
+              "type": "string",
+              "description": "Message description for compensation application."
+            },
+            "proposition": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "description": "Compensation claims."
+            }
+          },
+          "required": [
+            "arb",
+            "confirm"
+          ],
+          "additionalProperties": false,
+          "description": "Submit compensation request and apply for arbitration"
+        },
+        "arb_objection": {
+          "type": "object",
+          "properties": {
+            "arb": {
+              "$ref": "#/definitions/data/properties/object",
+              "description": "Arb object ID or name."
+            },
+            "objection": {
+              "$ref": "#/definitions/data/properties/arb_confirm/properties/description",
+              "description": "Oppose and appeal the arbitration result, request re-arbitration"
+            }
+          },
+          "required": [
+            "arb",
+            "objection"
+          ],
+          "additionalProperties": false,
+          "description": "Oppose and appeal the arbitration result, request re-arbitration."
+        },
+        "arb_claim_compensation": {
+          "type": "object",
+          "properties": {
+            "arb": {
+              "$ref": "#/definitions/data/properties/object",
+              "description": "Arb object ID or name."
+            }
+          },
+          "required": [
+            "arb"
+          ],
+          "additionalProperties": false,
+          "description": "Specify the adjudicated Arb object to obtain order compensation."
+        },
+        "receive": {
+          "type": "object",
+          "properties": {
+            "result": {
+              "anyOf": [
+                {
+                  "type": "object",
+                  "properties": {
+                    "balance": {
+                      "type": [
+                        "number",
+                        "string"
+                      ],
+                      "description": "Balance type"
+                    },
+                    "token_type": {
+                      "type": "string",
+                      "description": "Asset type of Coin objects. Supports CoinWrapper<...> format for order receive operations."
+                    },
+                    "received": {
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "properties": {
+                          "id": {
+                            "type": "string",
+                            "description": "Received CoinWrapper object ID"
+                          },
+                          "balance": {
+                            "$ref": "#/definitions/data/properties/receive/properties/result/anyOf/0/properties/balance"
+                          },
+                          "payment": {
+                            "type": "string",
+                            "description": "Payment object ID"
+                          }
+                        },
+                        "required": [
+                          "id",
+                          "balance",
+                          "payment"
+                        ],
+                        "additionalProperties": false,
+                        "description": "Received CoinWrapper object record"
+                      },
+                      "description": "Received records of Coin objects"
+                    }
+                  },
+                  "required": [
+                    "balance",
+                    "token_type",
+                    "received"
+                  ],
+                  "additionalProperties": false,
+                  "description": "Received record of Coin objects"
+                },
+                {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "id": {
+                        "type": "string",
+                        "minLength": 1,
+                        "description": "Received object ID"
+                      },
+                      "type": {
+                        "type": "string",
+                        "minLength": 1,
+                        "description": "Object type"
+                      },
+                      "content_raw": {
+                        "description": "Raw content data"
+                      }
+                    },
+                    "required": [
+                      "id",
+                      "type"
+                    ],
+                    "additionalProperties": false,
+                    "description": "Received normal object record"
+                  }
+                }
+              ],
+              "description": "Received CoinWrapper object record or received other objects array"
+            }
+          },
+          "required": [
+            "result"
+          ],
+          "additionalProperties": false,
+          "description": "Unwrap CoinWrapper objects or other objects received by the order and transfer them to the order owner"
+        },
+        "transfer_to": {
+          "$ref": "#/definitions/data/properties/agents/properties/entities/items",
+          "description": "Set new owner of the order. Requires order owner permission to set."
+        }
+      },
+      "required": [
+        "object"
+      ],
+      "additionalProperties": false,
+      "description": "On-chain, operate on an Order object."
+    },
+    "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"
+          ],
+          "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."
+        }
+      },
+      "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": "Type of call response: submission"
+        },
+        "guard": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "object": {
+                "type": "string",
+                "description": "Guard object name or ID."
+              },
+              "impack": {
+                "type": "boolean",
+                "description": "Whether the verification result of this Guard participates in the final verification logic. If true, the verification result of this Guard will be included in the final verification result; if false, the verification result of this Guard will not be included."
+              }
+            },
+            "required": [
+              "object",
+              "impack"
+            ],
+            "additionalProperties": false
+          }
+        },
+        "submission": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "guard": {
+                "$ref": "#/definitions/submission/properties/guard/items/properties/object",
+                "description": "Guard object name or ID."
+              },
+              "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 required for Guard verification."
+              }
+            },
+            "required": [
+              "guard",
+              "submission"
+            ],
+            "additionalProperties": false,
+            "description": "Permission guard submission data."
+          }
+        }
+      },
+      "required": [
+        "type",
+        "guard",
+        "submission"
+      ],
+      "additionalProperties": false,
+      "description": "Guard verification submission data required to complete an operation. Contains: (1) 'guard' - array of Guard objects to verify, each with an object ID and an 'impack' flag indicating if its result affects the final outcome; (2) 'submission' - array of user data submissions matching the Guard's requirements. The operation proceeds only after all Guards with impack=true are successfully verified."
+    }
+  }
+}