Skip to content

docs(wallet): add regtest journey-state guide and friction audit#1227

Open
rxiddhi wants to merge 2 commits into
joinmarket-webui:develfrom
rxiddhi:journey-state-docs-audit
Open

docs(wallet): add regtest journey-state guide and friction audit#1227
rxiddhi wants to merge 2 commits into
joinmarket-webui:develfrom
rxiddhi:journey-state-docs-audit

Conversation

@rxiddhi
Copy link
Copy Markdown

@rxiddhi rxiddhi commented Apr 22, 2026

What does this PR do?

This PR adds two documentation improvements to support wallet journey guidance work:

  • a new section in docs/developing.md for simulating wallet journey states in regtest
  • a new docs/wallet-state-friction-audit.md covering route-level friction around fee-config blockers, coinjoin preconditions, and empty-wallet states

The regtest guide gives contributors a practical way to verify:

  • empty wallet
  • funded wallet
  • pending confirmation
  • fee config incomplete
  • coinjoin ready

The friction audit summarizes where users can currently get blocked without a clear next step and outlines small, incremental opportunities for improvement.

Motivation / Context

The codebase already contains most of the relevant wallet and service checks, but contributor guidance for reproducing these states was missing, and the current UX friction is spread across several routes.

This PR improves contributor onboarding and provides a clearer baseline for follow-up wallet guidance work.

Dependencies

  • No code changes
  • No runtime changes
  • No new dependencies

Risk

Low. This PR is documentation-only.

Visual Demo (For contributors especially)

Image Demo (if applicable):

Not applicable for this PR because it only adds documentation.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant