Document solver_pubkey in restore-session response

[BraCR10]

• Clarifies that orders currently in dispute are reported solely through the disputes array, not orders.
• Introduces the solver_pubkey field to the dispute object, indicating the assigned solver for a dispute and its use for chat key derivation.
• Updates field descriptions and examples to accurately reflect the new structure and the solver_pubkey field.

Summary by CodeRabbit

• Documentation
  • Updated restore session API response documentation to reflect new dispute handling semantics: disputed orders now appear exclusively in the disputes section instead of orders.
  • Added solver_pubkey field to dispute objects with explicit status values (initiated, in-progress) and initiator indicators (buyer, seller).

[coderabbitai]

Walkthrough

Documentation update to the restore-session endpoint that restructures dispute representation. Disputed orders are relocated from the restore_data.orders collection to restore_data.disputes, and dispute objects are enhanced with solver assignment tracking and explicit status clarification.

Changes

Cohort / File(s)	Summary
Restore Session Documentation src/restore_session.md	Restructures dispute representation by moving disputed orders from restore_data.orders to restore_data.disputes, adds solver_pubkey field to dispute objects for solver assignment tracking, clarifies explicit dispute status values (initiated, in-progress), and updates field documentation to reflect the new schema organization.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~5 minutes

Possibly related PRs

• chore: updated restore message #19: Modifies restore response structure by introducing the restore_data wrapper and initial dispute status representation.
• Documents initiator field in restore data #29: Updates the dispute object schema by adding the initiator field to clarify dispute origin.

Suggested reviewers

• grunch
• Catrya
• arkanoider

Poem

🐰 Disputes find their rightful home,
In a separate nest they now roam,
With solver's key and status clear,
The schema's now precisely dear!
No longer mixed with orders fine,
Each element shines in its line. ✨

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title directly and concisely describes the main change: documenting the new solver_pubkey field in the restore-session response, which is the primary focus of the pull request.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[coderabbitai]

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents

Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@src/restore_session.md`:
- Line 90: Update the `solver_pubkey` field description in the
restore_session.md diff to remove the incorrect claim that it is "used to derive
the ECDH shared key for the dispute chat"; keep that it is the hex pubkey of the
assigned solver (or null) and is set via `admin-add-solver`, and if needed add a
clarifying note that the dispute chat ECDH shared key is derived from the
admin's pubkey (see `admin-took-dispute` / dispute_chat.md) rather than from
`solver_pubkey`.

🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

• Push a commit to this branch (recommended)
• Create a new PR with the fixes

---

ℹ️ Review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: ecf38a3c-c5e7-401e-a1fa-aeb27d14f1ae

📥 Commits

Reviewing files that changed from the base of the PR and between f90c8ae and 18ab96d.

📒 Files selected for processing (1)

• src/restore_session.md

[grunch]

no need to tell that the solver pubkey was added once via admin-add-solver because a mostro node can have many solvers added that way, what it should say is the solver_pubkey value is the pubkey of one of the solvers previously added that took that dispute via admin-take-dispute