@wowok/agent-mcp 2.2.11 → 2.2.13

package/docs/docs/arbitration.md

@@ -0,0 +1,1804 @@
+
+# Arbitration Component (⚖️ Dispute Resolution)
+
+---
+
+## Component Overview
+
+The Arbitration component is WoWok protocol's on-chain dispute resolution module, providing a transparent arbitration system for resolving order conflicts. Arbitration objects can be created with configurable voting rules, receive dispute submissions, confirm materials, vote on propositions, and provide final arbitration results.
+
+---
+
+## Function List
+
+| Function Name | Purpose | Usage Scenario | Significance |
+|---------------|---------|----------------|-------------|
+| **Create Arbitration** | Set up dispute resolution system | Establish order governance | Provides framework for fair conflict resolution |
+| **Initiate Dispute** | File conflict case | Report order issues, service failures | Formalizes dispute submission |
+| **Confirm Materials** | Validate evidence submission | Review dispute documents | Ensures arbitration based on verified data |
+| **Vote on Propositions** | Participate in decision-making | Jury voting, governance | Enables democratic dispute resolution |
+| **Issue Ruling** | Deliver final arbitration result | Resolve conflicts, decide compensation | Concludes dispute with binding outcome |
+
+---
+
+## Complete Tool Call Structure
+
+Arbitration operations use the following top-level structure:
+
+```json
+{
+  "operation_type": "arbitration",
+  "data": { ... },    // Arbitration data definition
+  "env": { ... },      // Execution environment (optional)
+  "submission": { ... } // Guard verification submission (optional)
+}
+```
+
+---
+
+## Schema Tree
+
+```
+arbitration (Arbitration Object)
+├── operation_type: "arbitration" (fixed value)
+├── data (Arbitration data definition)
+│   ├── object (TypedPermissionObject, required) - Arbitration object reference or creation
+│   │   ├── Option 1: Reference existing object (string) - object name or ID
+│   │   └── Option 2: Create new object (object)
+│   │       ├── name (string, optional) - local mark name, max 64 bcs characters
+│   │       ├── tags (array of string, optional) - tags array
+│   │       ├── onChain (boolean, optional) - whether to sync name to blockchain
+│   │       ├── replaceExistName (boolean, optional) - force claim existing name
+│   │       ├── type_parameter (string, optional) - token type, default: 0x2::wow::WOW
+│   │       └── permission (string | object, optional) - Permission object ID/name or new permission object
+│   │           ├── Option 1: Existing permission ID/name (string)
+│   │           └── Option 2: New permission object (object)
+│   │               ├── name (string, optional) - permission name
+│   │               ├── tags (array of string, optional) - tags array
+│   │               ├── onChain (boolean, optional) - whether to sync name to blockchain
+│   │               └── replaceExistName (boolean, optional) - force claim existing name
+│   ├── description (string, optional) - arbitration description, max 4000 bcs characters
+│   ├── location (string, optional) - arbitration location, max 256 bcs characters
+│   ├── fee (number or string, optional) - arbitration fee in smallest units
+│   ├── pause (boolean, optional) - whether to pause arbitration
+│   ├── dispute (Dispute object, optional) - create dispute for order
+│   │   ├── order (string, required) - order object ID or name
+│   │   ├── description (string, optional) - dispute description, max 4000 bcs characters
+│   │   ├── proposition (array of string, required) - list of dispute propositions, each max 256 bcs characters
+│   │   ├── fee (CoinParam, required) - dispute processing fee
+│   │   │   ├── Option 1: Balance object (object)
+│   │   │   │   └── balance (number) - balance amount
+│   │   │   └── Option 2: Coin object ID (string)
+│   │   └── namedArb (NamedObject, optional) - name for the newly created Arb object
+│   │       ├── name (string, optional) - arb object name
+│   │       ├── tags (array of string, optional) - tags array
+│   │       ├── onChain (boolean, optional) - whether to sync name to blockchain
+│   │       └── replaceExistName (boolean, optional) - force claim existing name
+│   ├── confirm (Confirm object, optional) - confirm arbitration materials
+│   │   ├── arb (string, required) - Arb object ID or name
+│   │   └── voting_deadline (number | null, required) - voting deadline in milliseconds
+│   ├── voting_deadline_change (VotingDeadlineChange object, optional) - change voting deadline
+│   │   ├── arb (string, required) - Arb object ID or name
+│   │   └── voting_deadline (number | null, required) - new voting deadline in milliseconds
+│   ├── vote (Vote object, optional) - vote on propositions
+│   │   ├── arb (string, required) - Arb object ID or name
+│   │   ├── votes (array of number, required) - vote list, each value 0-255
+│   │   └── voting_guard (string, optional) - voting Guard object ID/name
+│   ├── feedback (Feedback object, optional) - provide arbitration feedback
+│   │   ├── arb (string, required) - Arb object ID or name
+│   │   └── feedback (string, required) - arbitration feedback, max 4000 bcs characters
+│   ├── arbitration (ArbitrationAction object, optional) - provide final arbitration result
+│   │   ├── arb (string, required) - Arb object ID or name
+│   │   ├── feedback (string, required) - arbitration feedback, max 4000 bcs characters
+│   │   └── indemnity (number, required) - compensation amount in smallest units
+│   ├── reset (Reset object, optional) - apply to restart arbitration
+│   │   ├── arb (string, required) - Arb object ID or name
+│   │   └── feedback (string, required) - arbitration feedback, max 4000 bcs characters
+│   ├── arb_withdraw (ArbWithdraw object, optional) - withdraw arbitration fees
+│   │   └── arb (string, required) - Arb object ID or name
+│   ├── fees_transfer (FeesTransfer object, optional) - distribute arbitration fees
+│   │   ├── to (FeesTransferTo object, required) - receiving object
+│   │   │   ├── Option 1: Allocation reference (object)
+│   │   │   │   └── allocation (string) - Allocation object ID/name
+│   │   │   └── Option 2: Treasury reference (object)
+│   │   │       └── treasury (string) - Treasury object ID/name
+│   │   ├── payment_remark (string, required) - payment remark, max 64 bcs characters
+│   │   ├── payment_index (number, required) - payment index
+│   │   └── newPayment (NamedObject, optional) - name for new Payment object
+│   │       ├── name (string, optional) - payment name
+│   │       ├── tags (array of string, optional) - tags array
+│   │       ├── onChain (boolean, optional) - whether to sync name to blockchain
+│   │       └── replaceExistName (boolean, optional) - force claim existing name
+│   ├── usage_guard (string | null, optional) - Guard for user verification, null to unbind
+│   ├── voting_guard (VotingGuardAction object, optional) - manage voting Guards
+│   │   ├── op (string, required) - operation type: "add", "set", "remove", "clear"
+│   │   └── guards (array, required for add/set/remove) - list of VotingGuard objects or Guard names
+│   │       └── VotingGuard object (for add/set)
+│   │           ├── guard (string) - Guard object ID or name
+│   │           └── vote_weight (object) - vote weight
+│   │               ├── Option 1: FixedValue (object)
+│   │               │   └── FixedValue (number) - fixed weight value 0-65535
+│   │               └── Option 2: GuardIdentifier (object)
+│   │                   └── GuardIdentifier (number) - Guard table identifier 0-255
+│   ├── owner_receive (ReceivedObjectsOrRecently, optional) - receive objects to owner
+│   │   ├── Option 1: "recently" (string) - receive all recent objects
+│   │   ├── Option 2: ReceivedBalance object (object)
+│   │   │   ├── balance (number or string) - balance amount
+│   │   │   ├── token_type (string) - token type
+│   │   │   └── received (array of ReceivedItem) - received items list
+│   │   │       └── ReceivedItem object
+│   │   │           ├── id (string) - object ID
+│   │   │           └── type (string) - object type
+│   │   └── Option 3: Array of received objects
+│   │       └── [{ id: "object_id", type: "object_type" }]
+│   └── um (string | null, optional) - Contact object ID/name, null to unbind
+├── env (CallEnv, optional) - execution environment
+│   ├── account (string, optional) - account name or address, empty string for default
+│   ├── network (string, optional) - "testnet" or "localnet"
+│   ├── permission_guard (array of string, optional) - list of permission guard IDs
+│   ├── no_cache (boolean, optional) - disable caching
+│   └── referrer (string, optional) - referrer ID
+└── submission (SubmissionCall, optional) - submission data
+    ├── type (string) - fixed value "submission"
+    ├── guard (array of GuardInfo) - list of guards to verify
+    │   └── GuardInfo object
+    │       ├── object (string) - guard object ID
+    │       └── impack (boolean) - impact flag
+    └── submission (array of GuardSubmission) - submission data for guards
+        └── GuardSubmission object
+            ├── guard (string) - guard object ID
+            └── submission (array of GuardSubmissionItem) - submission items
+                └── GuardSubmissionItem object
+                    ├── identifier (number, 0-255) - Guard table item identifier
+                    ├── b_submission (boolean) - whether this item requires submission
+                    ├── value_type (number | string) - value type (e.g., 6 or "U64" for U64 type)
+                    ├── value (any) - submitted value
+                    └── name (string, optional) - item name
+```
+
+---
+
+### ⚠️ Important Note About Submission
+
+If the execution returns a `submission` field in the response, it indicates that additional Guard verification data is required. You must:
+
+1. Complete all required submission data within the `submission` structure
+2. Resubmit the operation with the completed submission data
+3. **Do not modify any other parts of the structure** - only fill in the required submission values
+
+The submission structure will specify which Guard objects need verification and what data needs to be provided for each Guard table item.
+
+**Query Value Types**: Use the `wowok_buildin_info` tool with `{ "info": "value types" }` to query all supported value types with their numeric and string representations. This helps you understand what `value_type` values are valid for submission data.
+
+---
+
+## Sub-feature 1: Create New Arbitration
+
+### Feature Description
+
+Create a new Arbitration object for resolving order disputes. Newly created arbitrations can be configured with descriptions, locations, fees, and voting guards.
+
+### Parameter Description
+
+| Parameter Path | Type | Required | Description | Constraints |
+|----------|------|------|------|------|
+| `operation_type` | string | Yes | Operation type | Fixed value "arbitration" |
+| `data.object` | object | Yes | Create new Arbitration | TypedPermissionObject structure |
+| `data.object.name` | string | No | Local mark name | Max 64 BCS characters |
+| `data.object.tags` | array | No | Tags array | String array |
+| `data.object.onChain` | boolean | No | Whether to mark on-chain | |
+| `data.object.replaceExistName` | boolean | No | Replace existing name | |
+| `data.object.permission` | string/object | No | Permission object | Can be existing permission ID/name, or new permission object |
+| `data.object.type_parameter` | string | No | Token type | Default: 0x2::wow::WOW |
+| `data.description` | string | No | Arbitration description | Max 4000 bcs characters |
+| `data.location` | string | No | Arbitration location | Max 256 BCS characters |
+| `data.fee` | number or string | No | Arbitration fee in smallest units | No decimals or negatives |
+
+---
+
+### Examples
+
+#### Example 1.1: Create Simple Arbitration
+
+**Prompt**: Create a new arbitration named "doc_test_arbitration" with: 1) Permission "arb_test_permission", 2) Description "Arbitration for documentation testing", 3) Location "Online arbitration system", 4) Fee at 1000000000 (1 WOW).
+
+```json
+{
+  "operation_type": "arbitration",
+  "data": {
+    "object": {
+      "name": "doc_test_arbitration",
+      "permission": "arb_test_permission",
+      "type_parameter": "0x2::wow::WOW",
+      "tags": ["arbitration", "test", "doc"],
+      "onChain": false
+    },
+    "description": "Arbitration for documentation testing",
+    "location": "Online arbitration system",
+    "fee": 1000000000
+  },
+  "env": {
+    "account": "arbitration_test_account",
+    "network": "testnet",
+    "no_cache": true
+  }
+}
+```
+
+**Execution Result**:
+```json
+{
+  "status": "success",
+  "object": "0xebc9dc62a87d05e87f6bad1f9fd600bb61734ab00a8bd7435818115a1709d6ec",
+  "type": "Arbitration",
+  "version": "1413284",
+  "change": "created"
+}
+```
+
+#### Example 1.2: Create Arbitration with New Permission and Guards
+
+**Prompt**: Create arbitration "product_arbitration" with: 1) New permission named "arb_permission", 2) Description "Product quality arbitration", 3) Usage guard "eligibility_guard", 4) Voting guards: "senior_judge" with FixedValue 100, "junior_judge" with GuardIdentifier 5.
+
+```json
+{
+  "operation_type": "arbitration",
+  "data": {
+    "object": {
+      "name": "product_arbitration",
+      "permission": {
+        "name": "arb_permission"
+      }
+    },
+    "description": "Product quality arbitration",
+    "usage_guard": "eligibility_guard",
+    "voting_guard": {
+      "op": "add",
+      "guards": [
+        {
+          "guard": "senior_judge",
+          "vote_weight": {
+            "FixedValue": 100
+          }
+        },
+        {
+          "guard": "junior_judge",
+          "vote_weight": {
+            "GuardIdentifier": 5
+          }
+        }
+      ]
+    }
+  }
+}
+```
+
+---
+
+## Sub-feature 2: Create Dispute (dispute)
+
+### Feature Description
+
+Create a new Arb object for an order to initiate dispute arbitration.
+
+### Parameter Description
+
+| Parameter Path | Type | Required | Description | Constraints |
+|----------|------|------|------|------|
+| `operation_type` | string | Yes | Operation type | Fixed value "arbitration" |
+| `data.object` | string | Yes | Reference existing Arbitration | Arbitration name or ID |
+| `data.dispute.order` | string | Yes | Order object ID or name | |
+| `data.dispute.description` | string | No | Dispute description | Max 4000 bcs characters |
+| `data.dispute.proposition` | array | Yes | List of dispute propositions | String array |
+| `data.dispute.fee` | object/string | Yes | Dispute processing fee | CoinParam structure |
+| `data.dispute.namedArb.name` | string | No | Name for the newly created arbitration object | Max 64 BCS characters |
+
+---
+
+### Example
+
+#### Example 2.1: Create Dispute
+
+**Prompt**: Create a dispute for "doc_test_arbitration" with: 1) Order "arb_test_order", 2) Description "Product quality does not match description", 3) Propositions ["Full refund", "Partial refund 50%", "No refund"], 4) Fee 1000000000 (1 WOW), 5) Name new dispute "test_dispute_2026".
+
+```json
+{
+  "operation_type": "arbitration",
+  "data": {
+    "object": "doc_test_arbitration",
+    "dispute": {
+      "order": "arb_test_order",
+      "description": "Product quality does not match description",
+      "proposition": ["Full refund", "Partial refund 50%", "No refund"],
+      "fee": {
+        "balance": 1000000000
+      },
+      "namedArb": {
+        "name": "test_dispute_2026",
+        "onChain": false
+      }
+    }
+  },
+  "env": {
+    "account": "arbitration_test_account",
+    "network": "testnet",
+    "no_cache": true
+  }
+}
+```
+
+**Execution Result**:
+```json
+{
+  "status": "success",
+  "results": [
+    {
+      "object": "0x2b1439093329363d108a9eef44414c3ae916762c030b63457ebfb351af7b5cc0",
+      "type": "Order",
+      "version": "1415870",
+      "change": "mutated"
+    },
+    {
+      "object": "0xebc9dc62a87d05e87f6bad1f9fd600bb61734ab00a8bd7435818115a1709d6ec",
+      "type": "Arbitration",
+      "version": "1415870",
+      "change": "mutated"
+    },
+    {
+      "object": "0xe8e2b96b03472a731a070cd244c3bd7fe25135ee99c05d61ac265cc62e50f9b2",
+      "type": "Arb",
+      "version": "1415870",
+      "change": "created"
+    }
+  ]
+}
+```
+
+---
+
+## Sub-feature 3: Confirm Materials (confirm)
+
+### Feature Description
+
+Confirm the arbitration materials submitted by the user.
+
+### Parameter Description
+
+| Parameter Path | Type | Required | Description | Constraints |
+|----------|------|------|------|------|
+| `operation_type` | string | Yes | Operation type | Fixed value "arbitration" |
+| `data.object` | string | Yes | Reference existing Arbitration | Arbitration name or ID |
+| `data.confirm.arb` | string | Yes | Arb object ID or name | |
+| `data.confirm.voting_deadline` | number or null | Yes | Voting deadline (milliseconds) | No decimals or negatives, or null |
+
+---
+
+### Example
+
+#### Example 3.1: Confirm Materials with Voting Deadline
+
+**Prompt**: For "doc_test_arbitration", confirm materials for "test_dispute_2026" with voting deadline at 1777830400000.
+
+```json
+{
+  "operation_type": "arbitration",
+  "data": {
+    "object": "doc_test_arbitration",
+    "confirm": {
+      "arb": "test_dispute_2026",
+      "voting_deadline": 1777830400000
+    }
+  },
+  "env": {
+    "account": "arbitration_test_account",
+    "network": "testnet",
+    "no_cache": true
+  }
+}
+```
+
+**Execution Result**:
+```json
+{
+  "status": "success",
+  "object": "0xe8e2b96b03472a731a070cd244c3bd7fe25135ee99c05d61ac265cc62e50f9b2",
+  "type": "Arb",
+  "version": "1415871",
+  "change": "mutated"
+}
+```
+
+---
+
+## Sub-feature 4: Change Voting Deadline (voting_deadline_change)
+
+### Feature Description
+
+Change the voting deadline for arbitration.
+
+### Parameter Description
+
+| Parameter Path | Type | Required | Description | Constraints |
+|----------|------|------|------|------|
+| `operation_type` | string | Yes | Operation type | Fixed value "arbitration" |
+| `data.object` | string | Yes | Reference existing Arbitration | Arbitration name or ID |
+| `data.voting_deadline_change.arb` | string | Yes | Arb object ID or name | |
+| `data.voting_deadline_change.voting_deadline` | number or null | Yes | New voting deadline (milliseconds) | No decimals or negatives, or null |
+
+---
+
+### Example
+
+#### Example 4.1: Remove Voting Deadline
+
+**Prompt**: For "service_arbitration", remove voting deadline for "order_123_dispute" (set to null).
+
+```json
+{
+  "operation_type": "arbitration",
+  "data": {
+    "object": "service_arbitration",
+    "voting_deadline_change": {
+      "arb": "order_123_dispute",
+      "voting_deadline": null
+    }
+  }
+}
+```
+
+---
+
+## Sub-feature 5: Vote (vote)
+
+### Feature Description
+
+Vote on user propositions.
+
+### Parameter Description
+
+| Parameter Path | Type | Required | Description | Constraints |
+|----------|------|------|------|------|
+| `operation_type` | string | Yes | Operation type | Fixed value "arbitration" |
+| `data.object` | string | Yes | Reference existing Arbitration | Arbitration name or ID |
+| `data.vote.arb` | string | Yes | Arb object ID or name | |
+| `data.vote.votes` | array | Yes | Vote list | Each value 0-255 |
+| `data.vote.voting_guard` | string | No | Voting Guard object ID/name | |
+
+---
+
+### Example
+
+#### Example 5.1: Vote on Propositions
+
+**Prompt**: For "service_arbitration", vote on "order_123_dispute" with votes [200, 100, 50] using "senior_judge" guard.
+
+```json
+{
+  "operation_type": "arbitration",
+  "data": {
+    "object": "service_arbitration",
+    "vote": {
+      "arb": "order_123_dispute",
+      "votes": [200, 100, 50],
+      "voting_guard": "senior_judge"
+    }
+  }
+}
+```
+
+---
+
+## Sub-feature 6: Provide Feedback (feedback)
+
+### Feature Description
+
+Provide arbitration feedback for an Arb object.
+
+### Parameter Description
+
+| Parameter Path | Type | Required | Description | Constraints |
+|----------|------|------|------|------|
+| `operation_type` | string | Yes | Operation type | Fixed value "arbitration" |
+| `data.object` | string | Yes | Reference existing Arbitration | Arbitration name or ID |
+| `data.feedback.arb` | string | Yes | Arb object ID or name | |
+| `data.feedback.feedback` | string | Yes | Arbitration feedback | Max 4000 bcs characters |
+
+---
+
+### Example
+
+#### Example 6.1: Provide Feedback
+
+**Prompt**: For "doc_test_arbitration", provide feedback on "test_dispute_2026" that "All evidence has been reviewed. The buyer provided sufficient proof of product quality issues."
+
+```json
+{
+  "operation_type": "arbitration",
+  "data": {
+    "object": "doc_test_arbitration",
+    "feedback": {
+      "arb": "test_dispute_2026",
+      "feedback": "All evidence has been reviewed. The buyer provided sufficient proof of product quality issues."
+    }
+  },
+  "env": {
+    "account": "arbitration_test_account",
+    "network": "testnet",
+    "no_cache": true
+  }
+}
+```
+
+**Execution Result**:
+```json
+{
+  "status": "success",
+  "object": "0xe8e2b96b03472a731a070cd244c3bd7fe25135ee99c05d61ac265cc62e50f9b2",
+  "type": "Arb",
+  "version": "1415872",
+  "change": "mutated"
+}
+```
+
+---
+
+## Sub-feature 7: Give Arbitration Result (arbitration)
+
+### Feature Description
+
+Provide the final arbitration result.
+
+### Parameter Description
+
+| Parameter Path | Type | Required | Description | Constraints |
+|----------|------|------|------|------|
+| `operation_type` | string | Yes | Operation type | Fixed value "arbitration" |
+| `data.object` | string | Yes | Reference existing Arbitration | Arbitration name or ID |
+| `data.arbitration.arb` | string | Yes | Arb object ID or name | |
+| `data.arbitration.feedback` | string | Yes | Arbitration feedback | Max 4000 bcs characters |
+| `data.arbitration.indemnity` | number | Yes | Compensation amount in smallest units | No decimals or negatives |
+
+---
+
+### Example
+
+#### Example 7.1: Give Arbitration Result
+
+**Prompt**: For "service_arbitration", give final result on "order_123_dispute": 1) Feedback "Based on all evidence, buyer wins the case", 2) Indemnity 5000000000 (5 WOW).
+
+```json
+{
+  "operation_type": "arbitration",
+  "data": {
+    "object": "service_arbitration",
+    "arbitration": {
+      "arb": "order_123_dispute",
+      "feedback": "Based on all evidence, buyer wins the case",
+      "indemnity": 5000000000
+    }
+  }
+}
+```
+
+---
+
+## Sub-feature 8: Reset Arbitration (reset)
+
+### Feature Description
+
+User applies to resubmit materials and restart arbitration.
+
+### Parameter Description
+
+| Parameter Path | Type | Required | Description | Constraints |
+|----------|------|------|------|------|
+| `operation_type` | string | Yes | Operation type | Fixed value "arbitration" |
+| `data.object` | string | Yes | Reference existing Arbitration | Arbitration name or ID |
+| `data.reset.arb` | string | Yes | Arb object ID or name | |
+| `data.reset.feedback` | string | Yes | Arbitration feedback | Max 4000 bcs characters |
+
+---
+
+### Example
+
+#### Example 8.1: Reset Arbitration
+
+**Prompt**: For "service_arbitration", apply to reset "order_123_dispute" with feedback "New evidence discovered, request to resubmit materials".
+
+```json
+{
+  "operation_type": "arbitration",
+  "data": {
+    "object": "service_arbitration",
+    "reset": {
+      "arb": "order_123_dispute",
+      "feedback": "New evidence discovered, request to resubmit materials"
+    }
+  }
+}
+```
+
+---
+
+## Sub-feature 9: Withdraw Arbitration Fee (arb_withdraw)
+
+### Feature Description
+
+Withdraw arbitration fees from the Arb object.
+
+### Parameter Description
+
+| Parameter Path | Type | Required | Description | Constraints |
+|----------|------|------|------|------|
+| `operation_type` | string | Yes | Operation type | Fixed value "arbitration" |
+| `data.object` | string | Yes | Reference existing Arbitration | Arbitration name or ID |
+| `data.arb_withdraw.arb` | string | Yes | Arb object ID or name | |
+
+---
+
+### Example
+
+#### Example 9.1: Withdraw Arbitration Fee
+
+**Prompt**: For "service_arbitration", withdraw fee from "order_123_dispute".
+
+```json
+{
+  "operation_type": "arbitration",
+  "data": {
+    "object": "service_arbitration",
+    "arb_withdraw": {
+      "arb": "order_123_dispute"
+    }
+  }
+}
+```
+
+---
+
+## Sub-feature 10: Distribute Arbitration Fees (fees_transfer)
+
+### Feature Description
+
+Distribute withdrawn arbitration fees.
+
+### Parameter Description
+
+| Parameter Path | Type | Required | Description | Constraints |
+|----------|------|------|------|------|
+| `operation_type` | string | Yes | Operation type | Fixed value "arbitration" |
+| `data.object` | string | Yes | Reference existing Arbitration | Arbitration name or ID |
+| `data.fees_transfer.to` | object | Yes | Receiving object | Must have either "allocation" or "treasury" |
+| `data.fees_transfer.to.allocation` | string | No | Allocation object ID/name | |
+| `data.fees_transfer.to.treasury` | string | No | Treasury object ID/name | |
+| `data.fees_transfer.payment_remark` | string | Yes | Payment remark | Max 64 BCS characters |
+| `data.fees_transfer.payment_index` | number | Yes | Payment index | No decimals or negatives |
+| `data.fees_transfer.newPayment.name` | string | No | Name for the newly created Payment object | Max 64 BCS characters |
+
+---
+
+### Examples
+
+#### Example 10.1: Distribute to Allocation
+
+**Prompt**: For "service_arbitration", distribute fees to "fee_allocation" with: 1) Remark "Arbitration fee distribution", 2) Index 0, 3) Name new payment "fee_payment".
+
+```json
+{
+  "operation_type": "arbitration",
+  "data": {
+    "object": "service_arbitration",
+    "fees_transfer": {
+      "to": {
+        "allocation": "fee_allocation"
+      },
+      "payment_remark": "Arbitration fee distribution",
+      "payment_index": 0,
+      "newPayment": {
+        "name": "fee_payment"
+      }
+    }
+  }
+}
+```
+
+#### Example 10.2: Distribute to Treasury
+
+**Prompt**: For "service_arbitration", distribute fees to "platform_treasury" with: 1) Remark "Arbitration fees to platform", 2) Index 0.
+
+```json
+{
+  "operation_type": "arbitration",
+  "data": {
+    "object": "service_arbitration",
+    "fees_transfer": {
+      "to": {
+        "treasury": "platform_treasury"
+      },
+      "payment_remark": "Arbitration fees to platform",
+      "payment_index": 0
+    }
+  }
+}
+```
+
+---
+
+## Sub-feature 11: Set Usage Guard (usage_guard)
+
+### Feature Description
+
+Set the verification Guard for users applying for arbitration.
+
+### Parameter Description
+
+| Parameter Path | Type | Required | Description | Constraints |
+|----------|------|------|------|------|
+| `operation_type` | string | Yes | Operation type | Fixed value "arbitration" |
+| `data.object` | string | Yes | Reference existing Arbitration | Arbitration name or ID |
+| `data.usage_guard` | string or null | Yes | Guard object ID/name, or null to unbind | |
+
+---
+
+### Examples
+
+#### Example 11.1: Set Usage Guard
+
+**Prompt**: For "service_arbitration", set usage guard to "eligibility_check".
+
+```json
+{
+  "operation_type": "arbitration",
+  "data": {
+    "object": "service_arbitration",
+    "usage_guard": "eligibility_check"
+  }
+}
+```
+
+#### Example 11.2: Unbind Usage Guard
+
+**Prompt**: For "service_arbitration", unbind usage guard (set to null).
+
+```json
+{
+  "operation_type": "arbitration",
+  "data": {
+    "object": "service_arbitration",
+    "usage_guard": null
+  }
+}
+```
+
+---
+
+## Sub-feature 12: Manage Voting Guards (voting_guard)
+
+### Feature Description
+
+Manage the verification Guards for arbitration voting.
+
+### Parameter Description
+
+| Parameter Path | Type | Required | Description | Constraints |
+|----------|------|------|------|------|
+| `operation_type` | string | Yes | Operation type | Fixed value "arbitration" |
+| `data.object` | string | Yes | Reference existing Arbitration | Arbitration name or ID |
+| `data.voting_guard.op` | string | Yes | Operation type | "add", "set", "remove", or "clear" |
+| `data.voting_guard.guards` | array | Required for add/set/remove | List of VotingGuard objects or Guard names |
+
+### Operation Type Description
+
+| Operation Type | Description |
+|----------------|-------------|
+| `add` | Add new Guard to existing list |
+| `set` | Replace entire Guard list |
+| `remove` | Remove specified Guard (use ID or name) |
+| `clear` | Clear all Guards |
+
+---
+
+### Examples
+
+#### Example 12.1: Add Voting Guard
+
+**Prompt**: For "service_arbitration", add voting guard "expert_judge" with FixedValue 50.
+
+```json
+{
+  "operation_type": "arbitration",
+  "data": {
+    "object": "service_arbitration",
+    "voting_guard": {
+      "op": "add",
+      "guards": [
+        {
+          "guard": "expert_judge",
+          "vote_weight": {
+            "FixedValue": 50
+          }
+        }
+      ]
+    }
+  }
+}
+```
+
+#### Example 12.2: Set Voting Guard List
+
+**Prompt**: For "service_arbitration", set voting guards to only "chief_judge" with GuardIdentifier 10.
+
+```json
+{
+  "operation_type": "arbitration",
+  "data": {
+    "object": "service_arbitration",
+    "voting_guard": {
+      "op": "set",
+      "guards": [
+        {
+          "guard": "chief_judge",
+          "vote_weight": {
+            "GuardIdentifier": 10
+          }
+        }
+      ]
+    }
+  }
+}
+```
+
+#### Example 12.3: Remove Voting Guard
+
+**Prompt**: For "service_arbitration", remove voting guard "old_judge".
+
+```json
+{
+  "operation_type": "arbitration",
+  "data": {
+    "object": "service_arbitration",
+    "voting_guard": {
+      "op": "remove",
+      "guards": ["old_judge"]
+    }
+  }
+}
+```
+
+#### Example 12.4: Clear All Voting Guards
+
+**Prompt**: For "service_arbitration", clear all voting guards.
+
+```json
+{
+  "operation_type": "arbitration",
+  "data": {
+    "object": "service_arbitration",
+    "voting_guard": {
+      "op": "clear"
+    }
+  }
+}
+```
+
+---
+
+## Sub-feature 13: Pause/Resume (pause)
+
+### Feature Description
+
+Pause or resume arbitration.
+
+### Parameter Description
+
+| Parameter Path | Type | Required | Description | Constraints |
+|----------|------|------|------|------|
+| `operation_type` | string | Yes | Operation type | Fixed value "arbitration" |
+| `data.object` | string | Yes | Reference existing Arbitration | Arbitration name or ID |
+| `data.pause` | boolean | Yes | Whether to pause | |
+
+---
+
+### Examples
+
+#### Example 13.1: Pause Arbitration
+
+**Prompt**: For "service_arbitration", pause arbitration operations.
+
+```json
+{
+  "operation_type": "arbitration",
+  "data": {
+    "object": "service_arbitration",
+    "pause": true
+  }
+}
+```
+
+#### Example 13.2: Resume Arbitration
+
+**Prompt**: For "service_arbitration", resume arbitration operations.
+
+```json
+{
+  "operation_type": "arbitration",
+  "data": {
+    "object": "service_arbitration",
+    "pause": false
+  }
+}
+```
+
+---
+
+## Sub-feature 14: Bind Contact (um)
+
+### Feature Description
+
+Bind a Contact object to Arbitration.
+
+### Parameter Description
+
+| Parameter Path | Type | Required | Description | Constraints |
+|----------|------|------|------|------|
+| `operation_type` | string | Yes | Operation type | Fixed value "arbitration" |
+| `data.object` | string | Yes | Reference existing Arbitration | Arbitration name or ID |
+| `data.um` | string or null | Yes | Contact object ID/name, or null to unbind | |
+
+---
+
+### Examples
+
+#### Example 14.1: Bind Contact
+
+**Prompt**: For "service_arbitration", bind contact "arb_support".
+
+```json
+{
+  "operation_type": "arbitration",
+  "data": {
+    "object": "service_arbitration",
+    "um": "arb_support"
+  }
+}
+```
+
+#### Example 14.2: Unbind Contact
+
+**Prompt**: For "service_arbitration", unbind contact (set to null).
+
+```json
+{
+  "operation_type": "arbitration",
+  "data": {
+    "object": "service_arbitration",
+    "um": null
+  }
+}
+```
+
+---
+
+## Sub-feature 15: Receive Objects (owner_receive)
+
+### Feature Description
+
+Receive objects sent to this Arbitration object and unpack them to send to the permission owner.
+
+### Parameter Description
+
+| Parameter Path | Type | Required | Description | Constraints |
+|----------|------|------|------|------|
+| `operation_type` | string | Yes | Operation type | Fixed value "arbitration" |
+| `data.object` | string | Yes | Reference existing Arbitration | Arbitration name or ID |
+| `data.owner_receive` | string/object/array | No | Receive objects configuration | "recently" or ReceivedBalance object or array |
+
+---
+
+### Examples
+
+#### Example 15.1: Receive Recent Objects
+
+**Prompt**: For "service_arbitration", receive all recent objects.
+
+```json
+{
+  "operation_type": "arbitration",
+  "data": {
+    "object": "service_arbitration",
+    "owner_receive": "recently"
+  }
+}
+```
+
+---
+
+## Sub-feature 16: Combined Operations
+
+### Feature Description
+
+Execute multiple operations in a single call.
+
+---
+
+### Example
+
+#### Example 16.1: Complete Arbitration Setup
+
+**Prompt**: Create "complete_arbitration" with: 1) Permission "arbitration_permission", 2) Description "Full-featured arbitration", 3) Location "Online", 4) Fee 1000000000 (1 WOW), 5) Usage guard "eligibility_guard", 6) Add voting guard "head_judge" with FixedValue 100, 7) Bind contact "arb_support".
+
+```json
+{
+  "operation_type": "arbitration",
+  "data": {
+    "object": {
+      "name": "complete_arbitration",
+      "permission": "arbitration_permission",
+      "type_parameter": "0x2::wow::WOW"
+    },
+    "description": "Full-featured arbitration",
+    "location": "Online",
+    "fee": 1000000000,
+    "usage_guard": "eligibility_guard",
+    "voting_guard": {
+      "op": "add",
+      "guards": [
+        {
+          "guard": "head_judge",
+          "vote_weight": {
+            "FixedValue": 100
+          }
+        }
+      ]
+    },
+    "um": "arb_support"
+  }
+}
+```
+
+---
+
+## Complete Arbitration Workflow Example
+
+This example demonstrates a complete arbitration workflow using existing Service and Order objects.
+
+### Prerequisites
+
+Before starting the arbitration process, ensure you have:
+1. A **Permission** object for the Arbitration
+2. A **Service** with arbitration support and published
+3. An **Order** created from the Service
+4. Sufficient WOW tokens for dispute fees
+
+### Step 1: Create Arbitration Object
+
+Create an Arbitration object that will handle disputes:
+
+```json
+{
+  "operation_type": "arbitration",
+  "data": {
+    "object": {
+      "name": "doc_test_arbitration",
+      "permission": "arb_test_permission",
+      "type_parameter": "0x2::wow::WOW",
+      "tags": ["arbitration", "test", "doc"],
+      "onChain": false
+    },
+    "description": "Arbitration for documentation testing",
+    "location": "Online arbitration system",
+    "fee": 1000000000
+  },
+  "env": {
+    "account": "arbitration_test_account",
+    "network": "testnet",
+    "no_cache": true
+  }
+}
+```
+
+**Returns**:
+```json
+{
+  "status": "success",
+  "object": "0xebc9dc62a87d05e87f6bad1f9fd600bb61734ab00a8bd7435818115a1709d6ec",
+  "type": "Arbitration",
+  "version": "1413284",
+  "change": "created"
+}
+```
+
+### Step 2: Create Service with Arbitration Support
+
+Create a Service that includes the Arbitration object:
+
+```json
+{
+  "operation_type": "service",
+  "data": {
+    "object": {
+      "name": "arb_test_service",
+      "permission": "arb_test_permission",
+      "type_parameter": "0x2::wow::WOW",
+      "tags": ["service", "arbitration", "test"],
+      "onChain": false
+    },
+    "description": "Service for arbitration testing",
+    "sales": {
+      "op": "add",
+      "sales": [{
+        "name": "test_product",
+        "price": 1000000000,
+        "stock": 100,
+        "suspension": false,
+        "wip": "https://example.com/wip",
+        "wip_hash": ""
+      }]
+    },
+    "arbitrations": {
+      "op": "add",
+      "objects": ["doc_test_arbitration"]
+    },
+    "order_allocators": {
+      "description": "Order fund allocators",
+      "threshold": 100000000,
+      "allocators": [{
+        "guard": "test_guard_arb",
+        "sharing": [{
+          "who": {"Signer": "signer"},
+          "sharing": 10000,
+          "mode": "Rate"
+        }]
+      }]
+    },
+    "publish": true
+  },
+  "env": {
+    "account": "arbitration_test_account",
+    "network": "testnet",
+    "no_cache": true
+  }
+}
+```
+
+**Returns**:
+```json
+{
+  "status": "success",
+  "object": "0x50ca67dfb163b8bbab3d3ed59052d28a8859de167ea101b19e012bc4a258f708",
+  "type": "Service",
+  "version": "1415003",
+  "change": "created"
+}
+```
+
+### Step 3: Create Order
+
+Create an Order from the Service:
+
+```json
+{
+  "operation_type": "service",
+  "data": {
+    "object": "arb_test_service",
+    "order_new": {
+      "buy": {
+        "items": [{
+          "name": "test_product",
+          "stock": 1,
+          "wip_hash": ""
+        }],
+        "total_pay": {"balance": 1000000000}
+      },
+      "order_required_info": "test_contact_2026",
+      "namedNewOrder": {
+        "name": "arb_test_order",
+        "onChain": false
+      }
+    }
+  },
+  "env": {
+    "account": "arbitration_test_account",
+    "network": "testnet",
+    "no_cache": true
+  }
+}
+```
+
+**Returns**:
+```json
+{
+  "status": "success",
+  "results": [
+    {
+      "object": "0x2b1439093329363d108a9eef44414c3ae916762c030b63457ebfb351af7b5cc0",
+      "type": "Order",
+      "version": "1415346",
+      "change": "created"
+    },
+    {
+      "object": "0x4488b2f85a3869b5c480d194c35270b1a449518f2bdd8a3641872cbc47d45dc2",
+      "type": "Allocation",
+      "version": "1415346",
+      "change": "created"
+    }
+  ]
+}
+```
+
+### Step 4: Resume Arbitration (if paused)
+
+Ensure the Arbitration is active:
+
+```json
+{
+  "operation_type": "arbitration",
+  "data": {
+    "object": "doc_test_arbitration",
+    "pause": false
+  },
+  "env": {
+    "account": "arbitration_test_account",
+    "network": "testnet",
+    "no_cache": true
+  }
+}
+```
+
+**Returns**:
+```json
+{
+  "status": "success",
+  "object": "0xebc9dc62a87d05e87f6bad1f9fd600bb61734ab00a8bd7435818115a1709d6ec",
+  "type": "Arbitration",
+  "version": "1415347",
+  "change": "mutated"
+}
+```
+
+### Step 5: Initiate Dispute
+
+Create a dispute for the Order:
+
+```json
+{
+  "operation_type": "arbitration",
+  "data": {
+    "object": "doc_test_arbitration",
+    "dispute": {
+      "order": "arb_test_order",
+      "description": "Product quality does not match description",
+      "proposition": ["Full refund", "Partial refund 50%", "No refund"],
+      "fee": {"balance": 1000000000},
+      "namedArb": {
+        "name": "test_dispute_2026",
+        "onChain": false
+      }
+    }
+  },
+  "env": {
+    "account": "arbitration_test_account",
+    "network": "testnet",
+    "no_cache": true
+  }
+}
+```
+
+**Returns**:
+```json
+{
+  "status": "success",
+  "results": [
+    {
+      "object": "0xe8e2b96b03472a731a070cd244c3bd7fe25135ee99c05d61ac265cc62e50f9b2",
+      "type": "Arb",
+      "version": "1415870",
+      "change": "created"
+    }
+  ]
+}
+```
+
+### Step 6: Confirm Materials
+
+Confirm the dispute materials and set voting deadline:
+
+```json
+{
+  "operation_type": "arbitration",
+  "data": {
+    "object": "doc_test_arbitration",
+    "confirm": {
+      "arb": "test_dispute_2026",
+      "voting_deadline": 1777830400000
+    }
+  },
+  "env": {
+    "account": "arbitration_test_account",
+    "network": "testnet",
+    "no_cache": true
+  }
+}
+```
+
+### Step 7: Provide Feedback
+
+Add arbitration feedback:
+
+```json
+{
+  "operation_type": "arbitration",
+  "data": {
+    "object": "doc_test_arbitration",
+    "feedback": {
+      "arb": "test_dispute_2026",
+      "feedback": "All evidence has been reviewed. The buyer provided sufficient proof of product quality issues."
+    }
+  },
+  "env": {
+    "account": "arbitration_test_account",
+    "network": "testnet",
+    "no_cache": true
+  }
+}
+```
+
+### Step 8: Issue Final Ruling
+
+Provide the final arbitration result with compensation:
+
+```json
+{
+  "operation_type": "arbitration",
+  "data": {
+    "object": "doc_test_arbitration",
+    "arbitration": {
+      "arb": "test_dispute_2026",
+      "feedback": "Based on all evidence provided, the buyer's claim is valid. The product quality does not match the description.",
+      "indemnity": 500000000
+    }
+  },
+  "env": {
+    "account": "arbitration_test_account",
+    "network": "testnet",
+    "no_cache": true
+  }
+}
+```
+
+**Note**: The `indemnity` amount requires sufficient compensation fund in the Service. If insufficient funds exist, the transaction will fail with error code 4.
+
+### Step 9: Claim Compensation (by Order Owner)
+
+After arbitration is finalized, the order owner can claim compensation:
+
+```json
+{
+  "operation_type": "order",
+  "data": {
+    "object": "arb_test_order",
+    "arb_claim_compensation": {
+      "arb": "test_dispute_2026"
+    }
+  },
+  "env": {
+    "account": "arbitration_test_account",
+    "network": "testnet",
+    "no_cache": true
+  }
+}
+```
+
+---
+
+## Complete Arbitration Workflow Example (Real On-Chain Data)
+
+This example demonstrates the **complete arbitration process** from dispute creation to compensation claim using **real on-chain objects and transaction data**. This showcases the transparent, auditable nature of on-chain arbitration.
+
+### 📊 Real Objects on Testnet
+
+| Object | ID | Type | Description |
+|--------|-----|------|-------------|
+| **Service** | `0x50ca67dfb163b8bbab3d3ed59052d28a8859de167ea101b19e012bc4a258f708` | Service | Published service with 7.999 WOW compensation fund |
+| **Arbitration** | `0xebc9dc62a87d05e87f6bad1f9fd600bb61734ab00a8bd7435818115a1709d6ec` | Arbitration | Active arbitration with 1 WOW fee |
+| **Order** | `0x934bf2d62b472082d91b5ba7425228bcb158c33d281ad01ed7fdd20bf5f00ff6` | Order | Completed order with 1 WOW payment |
+| **Arb (Dispute)** | `0x5e22bd716933ce89d620dd7976627110a0ed26672244516f31b83fd7f6903db0` | Arb | **Status: Finished (5)** - Compensation claimed |
+
+### 🔍 Real Transaction History
+
+| Step | Transaction | Block | Description |
+|------|-------------|-------|-------------|
+| Order Created | `8Rq9...` | 1651574 | Buyer created order for test_product |
+| Dispute Created | `HKkg...` | 1652451 | Buyer initiated dispute with 1 WOW fee |
+| Materials Confirmed | `2trT...` | 1654581 | Arbitrator confirmed, set 10s voting deadline |
+| Ruling Issued | `AZcM...` | 1660200 | Arbitrator ruled: 0.001 WOW compensation |
+| **Compensation Claimed** | `AZcM...` | 1660200 | **Buyer received 0.001 WOW** |
+
+### 📋 Arb Object Final State
+
+```json
+{
+  "object": "0x5e22bd716933ce89d620dd7976627110a0ed26672244516f31b83fd7f6903db0",
+  "type": "Arb",
+  "type_raw": "0x2::arb::Arb<0x2::wow::WOW>",
+  "description": "Product quality does not match description, requesting refund",
+  "order": "0x934bf2d62b472082d91b5ba7425228bcb158c33d281ad01ed7fdd20bf5f00ff6",
+  "arbitration": "0xebc9dc62a87d05e87f6bad1f9fd600bb61734ab00a8bd7435818115a1709d6ec",
+  "proposition": [
+    {"name": "Full refund", "votes": "0"},
+    {"name": "Partial refund 50%", "votes": "0"},
+    {"name": "No refund - keep product", "votes": "0"}
+  ],
+  "fee": "1000000000",
+  "feedback": "After review, support buyer claim, full refund granted",
+  "indemnity": {"amount": "1000000", "time": "1776834479869"},
+  "voting_deadline": "1776834427793",
+  "status": 5,
+  "compensation_time": "1776834773322",
+  "time": "1776834368972"
+}
+```
+
+### 🎯 Scenario: Product Quality Dispute
+
+**Background**: A buyer purchased "test_product" (1 WOW) from `arb_test_service` but received an item with quality issues that didn't match the description.
+
+**Timeline**:
+- **T+0**: Order created and paid
+- **T+1min**: Buyer discovers quality issue
+- **T+5min**: Buyer initiates dispute with 3 propositions
+- **T+6min**: Arbitrator confirms materials, sets 10-second voting deadline
+- **T+16s**: Voting deadline passes
+- **T+20s**: Arbitrator issues ruling: 0.001 WOW compensation
+- **T+25s**: Buyer claims compensation
+
+---
+
+## 🔄 Complete Arbitration State Machine
+
+### State Diagram
+
+```mermaid
+stateDiagram-v2
+    [*] --> PrincipalConfirming : create dispute
+    PrincipalConfirming --> ArbitratorConfirming : principal_confirm
+    ArbitratorConfirming --> Voting : arbitrator_confirm
+    Voting --> Arbitrated : arbitration
+    Arbitrated --> Finished : arb_claim_compensation
+    Arbitrated --> Objectionable : objection
+    Objectionable --> PrincipalConfirming : reset
+
+    note right of PrincipalConfirming
+        Status: 0
+        Buyer confirms dispute
+    end note
+
+    note right of ArbitratorConfirming
+        Status: 1
+        Arbitrator reviews case
+    end note
+
+    note right of Voting
+        Status: 2
+        Voting period active
+        voting_deadline must pass
+    end note
+
+    note right of Arbitrated
+        Status: 3
+        Ruling issued
+        indemnity set
+    end note
+
+    note right of Objectionable
+        Status: 4
+        Appeal window open
+    end note
+
+    note right of Finished
+        Status: 5
+        Compensation transferred
+    end note
+```
+
+### State Transitions with Time/Amount Conditions
+
+| From | To | Trigger | Time/Amount Condition |
+|------|-----|---------|----------------------|
+| 0 → 1 | Principal_confirming → Arbitrator_confirming | `principal_confirm` | None |
+| 1 → 2 | Arbitrator_confirming → Voting | `arbitrator_confirm` | voting_deadline set (optional) |
+| 2 → 3 | Voting → Arbitrated | `arbitration` | **Must pass voting_deadline** if set |
+| 3 → 5 | Arbitrated → Finished | `arb_claim_compensation` | None |
+| 3 → 4 | Arbitrated → Objectionable | `objection` | Within objection period |
+| 4 → 0 | Objectionable → Principal_confirming | `reset` | None |
+
+### 💰 Financial Flow
+
+```mermaid
+flowchart LR
+    subgraph BuyerAction["Buyer Actions"]
+        B1[Pay Dispute Fee]
+        B2[Submit Evidence]
+        B3[Claim Compensation]
+    end
+
+    subgraph ArbProcess["Arbitration Process"]
+        A1[Arb Object<br/>Fee Locked]
+        A2[Voting Period]
+        A3[Ruling Issued<br/>Indemnity Set]
+    end
+
+    subgraph ServiceFund["Service Compensation"]
+        S1[Compensation Fund]
+        S2[Deduct Indemnity]
+    end
+
+    B1 --> A1
+    A1 --> A2
+    A2 --> A3
+    A3 --> S2
+    S2 --> B3
+
+    style B1 fill:#ffcccc
+    style B3 fill:#ccffcc
+    style S2 fill:#ffffcc
+```
+
+**Fee Distribution**:
+- Dispute fee: 1 WOW (paid by buyer to Arb)
+- Compensation: 0.001 WOW (from Service fund to buyer)
+- Net buyer cost: 0.999 WOW (fee - compensation)
+
+### Permission Matrix
+
+| Operation | Status Required | Actor | Additional Requirements |
+|-----------|-----------------|-------|------------------------|
+| `dispute` | - | Buyer | Order owner, arbitration unpaused |
+| `principal_confirm` | 0 | Buyer | Must be dispute initiator |
+| `arbitrator_confirm` | 1 | Arbitrator | Must be designated arbitrator |
+| `arbitration` | 2 | Arbitrator | `voting_deadline` must pass |
+| `arb_claim_compensation` | 3 | Buyer | Order owner, indemnity > 0 |
+| `objection` | 3 | Buyer | Within appeal window |
+| `reset` | 4 | System | Automatic on objection |
+
+---
+
+## Transparent Arbitration Process
+
+The WoWok arbitration system is designed with complete transparency - all actions, evidence, and decisions are recorded on-chain and can be verified by anyone. This section details how the transparent arbitration process works and how parties can submit evidence.
+
+### Public Transparency Features
+
+| Aspect | Transparency Mechanism | Verification Method |
+|--------|------------------------|---------------------|
+| **Dispute Creation** | Arb object created on-chain with all parameters public | Query Arb object by ID |
+| **Evidence Submission** | Evidence hashes recorded in `feedback` field | Cross-reference with Messenger or IPFS |
+| **Voting Records** | All votes recorded with voter Guard verification | Query Arb object voting history |
+| **Arbitration Ruling** | Final decision and indemnity amount permanently stored | Query Arb object status and fields |
+| **Fund Movements** | All compensation transfers traceable on-chain | Query transaction effects |
+
+### Evidence Submission via Messenger
+
+The WoWok Messenger provides an encrypted, verifiable channel for submitting sensitive evidence during arbitration. This ensures privacy while maintaining transparency through cryptographic proofs.
+
+## Step-by-Step Real Execution
+
+### Step 1: Buyer Creates Dispute (Status: 0 → 1)
+
+The buyer creates a dispute for the order, paying the 1 WOW arbitration fee:
+
+**Request**:
+```json
+{
+  "operation_type": "arbitration",
+  "data": {
+    "object": "0xebc9dc62a87d05e87f6bad1f9fd600bb61734ab00a8bd7435818115a1709d6ec",
+    "dispute": {
+      "order": "0x934bf2d62b472082d91b5ba7425228bcb158c33d281ad01ed7fdd20bf5f00ff6",
+      "description": "Product quality does not match description, requesting refund",
+      "proposition": ["Full refund", "Partial refund 50%", "No refund - keep product"],
+      "fee": {"balance": 1000000000},
+      "namedArb": {"name": "real_dispute_2026", "onChain": false}
+    }
+  },
+  "env": {"account": "buyer_account", "network": "testnet", "no_cache": true}
+}
+```
+
+**Real Response**:
+```json
+{
+  "status": "success",
+  "results": [
+    {"object": "0x934bf2d62b472082d91b5ba7425228bcb158c33d281ad01ed7fdd20bf5f00ff6", "type": "Order", "version": "1652451", "change": "mutated"},
+    {"object": "0xebc9dc62a87d05e87f6bad1f9fd600bb61734ab00a8bd7435818115a1709d6ec", "type": "Arbitration", "version": "1652451", "change": "mutated"},
+    {"object": "0x5e22bd716933ce89d620dd7976627110a0ed26672244516f31b83fd7f6903db0", "type": "Arb", "version": "1652451", "change": "created"}
+  ]
+}
+```
+
+**On-Chain Evidence**: 
+- Arb created at: Block 1652451
+- Status: Status_Arbitrator_confirming (1)
+- Fee locked: 1 WOW
+
+---
+
+### Step 2: Arbitrator Confirms Materials (Status: 1 → 2)
+
+The arbitrator reviews the dispute and confirms materials, setting a short voting deadline:
+
+**Request**:
+```json
+{
+  "operation_type": "arbitration",
+  "data": {
+    "object": "0xebc9dc62a87d05e87f6bad1f9fd600bb61734ab00a8bd7435818115a1709d6ec",
+    "confirm": {
+      "arb": "0x5e22bd716933ce89d620dd7976627110a0ed26672244516f31b83fd7f6903db0",
+      "voting_deadline": 1776834427793
+    }
+  },
+  "env": {"account": "arbitration_admin", "network": "testnet", "no_cache": true}
+}
+```
+
+**Real Response**:
+```json
+{
+  "status": "success",
+  "object": "0x5e22bd716933ce89d620dd7976627110a0ed26672244516f31b83fd7f6903db0",
+  "type": "Arb",
+  "version": "1654581",
+  "change": "mutated"
+}
+```
+
+**State Change**:
+- Status: Status_Voting (2)
+- Voting deadline: 1776834427793 (Unix timestamp ms)
+- Time window: ~10 seconds for this demo
+
+---
+
+### Step 3: Voting Period (Optional)
+
+During the voting period (if configured), authorized voters can cast votes on propositions. **Proposition indices are 0-based**:
+
+- Index 0: "Full refund"
+- Index 1: "Partial refund 50%"
+- Index 2: "No refund - keep product"
+
+**Note**: In this real example, no voting guards were configured, so voting was skipped.
+
+---
+
+### Step 4: Arbitrator Issues Final Ruling (Status: 2 → 3)
+
+**⚠️ Critical**: Can only execute after `voting_deadline` has passed!
+
+The arbitrator provides the final decision with compensation amount:
+
+**Request**:
+```json
+{
+  "operation_type": "arbitration",
+  "data": {
+    "object": "0xebc9dc62a87d05e87f6bad1f9fd600bb61734ab00a8bd7435818115a1709d6ec",
+    "arbitration": {
+      "arb": "0x5e22bd716933ce89d620dd7976627110a0ed26672244516f31b83fd7f6903db0",
+      "feedback": "After review, support buyer claim, full refund granted",
+      "indemnity": 1000000
+    }
+  },
+  "env": {"account": "arbitration_admin", "network": "testnet", "no_cache": true}
+}
+```
+
+**Real Response**:
+```json
+{
+  "status": "success",
+  "object": "0x5e22bd716933ce89d620dd7976627110a0ed26672244516f31b83fd7f6903db0",
+  "type": "Arb",
+  "version": "1654581",
+  "change": "mutated"
+}
+```
+
+**State Change**:
+- Status: Status_Arbitrated (3)
+- Indemnity set: 0.001 WOW (1000000)
+- Feedback recorded on-chain
+- Service compensation fund: 7.999 → 7.998 WOW
+
+---
+
+### Step 5: Buyer Claims Compensation (Status: 3 → 5)
+
+After arbitration is finalized, the **order owner (buyer)** claims the awarded compensation via the Order component:
+
+**Request**:
+```json
+{
+  "operation_type": "order",
+  "data": {
+    "object": "0x934bf2d62b472082d91b5ba7425228bcb158c33d281ad01ed7fdd20bf5f00ff6",
+    "arb_claim_compensation": {
+      "arb": "0x5e22bd716933ce89d620dd7976627110a0ed26672244516f31b83fd7f6903db0"
+    }
+  },
+  "env": {"account": "buyer_account", "network": "testnet", "no_cache": true}
+}
+```
+
+**Real Response**:
+```json
+{
+  "status": "success",
+  "results": [
+    {"object": "0x50ca67dfb163b8bbab3d3ed59052d28a8859de167ea101b19e012bc4a258f708", "type": "Service", "version": "1660200", "change": "mutated"},
+    {"object": "0x5e22bd716933ce89d620dd7976627110a0ed26672244516f31b83fd7f6903db0", "type": "Arb", "version": "1660200", "change": "mutated"},
+    {"object": "0x934bf2d62b472082d91b5ba7425228bcb158c33d281ad01ed7fdd20bf5f00ff6", "type": "Order", "version": "1660200", "change": "mutated"}
+  ]
+}
+```
+
+**Final State**:
+- Status: Status_Finished (5)
+- Compensation time: 1776834773322 (claimed timestamp)
+- Buyer received: 0.001 WOW
+- Service fund: 7.998 WOW
+
+---
+
+## 📊 Complete Workflow Summary
+
+| Step | Actor | Status | Operation | Amount | Time |
+|------|-------|--------|-----------|--------|------|
+| 1 | Buyer | 0→1 | `dispute` | -1 WOW (fee) | Block 1652451 |
+| 2 | Arbitrator | 1→2 | `confirm` | 0 | Block 1654581 |
+| 3 | - | 2 | Voting period | 0 | 10 seconds |
+| 4 | Arbitrator | 2→3 | `arbitration` | Set 0.001 WOW | Block 1654581 |
+| 5 | Buyer | 3→5 | `arb_claim_compensation` | +0.001 WOW | Block 1660200 |
+
+**Net Result**: Buyer paid 0.999 WOW (1.0 fee - 0.001 compensation) for the arbitration process.
+
+---
+
+## 🔗 Related Documentation
+
+| Component | Link | Description |
+|-----------|------|-------------|
+| **Service Setup** | [Service - Compensation Fund](service.md#sub-feature-11-add-compensation-fund) | Configure service with arbitration support |
+| **Order Creation** | [Service - Create Order](service.md#sub-feature-12-configure-customer-required-info) | How orders are created from services |
+| **Claim Compensation** | [Order - Claim Compensation](order.md#function-6-claim-arbitration-compensation-arb_claim_compensation) | Detailed guide for buyers to claim |
+| **Objection Process** | [Order - Object to Arbitration](order.md#function-5-object-to-arbitration-result-arb_objection) | How to appeal arbitration decisions |
+| **Messenger Evidence** | [Messenger](messenger.md) | Submit encrypted evidence via WoWok Messenger |
+
+---
+
+## Important Notes
+
+⚠️ **Dispute fees are required to initiate arbitration.**
+
+⚠️ **Voting weights must be either FixedValue (0-65535) or GuardIdentifier (0-255).**
+
+⚠️ **Compensation fund must be sufficient in the Service to cover the indemnity amount.**
+
+⚠️ **Arbitration must be unpaused (pause: false) to accept disputes.**
+
+---
+
+## Related Components
+
+| Component | Description |
+|-----------|-------------|
+| **[Service](service.md)** | WYSIWYG product trading - creates orders that may need arbitration |
+| **[Order](order.md)** | Order management - subject of arbitration disputes |
+| **[Treasury](treasury.md)** | Team fund management - can receive arbitration fees |
+| **[Allocation](allocation.md)** | Automatic fund distribution - can receive arbitration fees |
+| **[Permission](permission.md)** | Permission management - controls arbitration operations |
+| **[Guard](guard.md)** | Trust verification engine - used for eligibility and voting |
+| **[Contact](contact.md)** | Public contact information - provides support channels |
+