From 68b0d6073096d72afb0463e4f568ec9e6b46ada5 Mon Sep 17 00:00:00 2001 From: bracr10 Date: Mon, 16 Feb 2026 23:36:23 -0600 Subject: [PATCH] Documents initiator field in restore data Clarifies the structure of the restore data object by documenting the 'initiator' field within the disputes array. This addition ensures that clients restoring sessions can accurately identify which party initiated a dispute, which may be necessary for correct UI/UX and logic. --- src/restore_session.md | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/src/restore_session.md b/src/restore_session.md index 9aba905..607cfdd 100644 --- a/src/restore_session.md +++ b/src/restore_session.md @@ -53,7 +53,8 @@ Mostro will respond with a message containing all non-finalized orders (e.g., st "dispute_id": "", "order_id": "", "trade_index": 4, - "status": "initiated" + "status": "initiated", + "initiator": "seller" } ] } @@ -68,7 +69,7 @@ Mostro will respond with a message containing all non-finalized orders (e.g., st * `restore_data`: Wrapper object that contains the session recovery data. * `restore_data.orders`: An array of active or ongoing orders with their `id`, `trade_index`, and current `status`. -* `restore_data.disputes`: An array of ongoing disputes with `dispute_id`, the associated `order_id`, and `trade_index` and current `status` of the dispute. +* `restore_data.disputes`: An array of ongoing disputes with `dispute_id`, the associated `order_id`, `trade_index`, current `status`, and `initiator` (`"buyer"`, `"seller"`, or `null` if unknown). ## Example Use Case @@ -95,7 +96,7 @@ When switching to desktop, after restoring the mnemonic, the client sends `resto { "id": "xyz-999", "trade_index": 4, "status": "dispute" } ], "disputes": [ - { "dispute_id": "dis-001", "order_id": "xyz-999", "trade_index": 4, "status": "initiated" } + { "dispute_id": "dis-001", "order_id": "xyz-999", "trade_index": 4, "status": "initiated", "initiator": "seller" } ] } }