Skip to content

[SCF high] Add Stellar wallet readiness preflight for demo flow #174

Description

@karagozemin

Why this matters

SCF demos can fail for simple wallet setup reasons: wrong network, unfunded testnet account, or missing Freighter access. A read-only wallet readiness preflight makes demo failures easier to diagnose.

Scope

Add a frontend preflight panel/check for Stellar wallet readiness:

  • Freighter reachable;
  • connected account present;
  • testnet selected;
  • account funded/reachable where public Horizon/RPC check is available;
  • clear next-step copy for each failure state.

This should not submit transactions.

Suggested files

  • frontend/src/hooks/useFreighter.ts
  • frontend/src/components/NetworkMismatchBanner.tsx
  • new component under frontend/src/components/
  • frontend/src/config/rpc-urls.ts

Acceptance criteria

  • Preflight is read-only and visible before swap submission.
  • Wrong network and missing wallet states show actionable copy.
  • No private keys or sensitive wallet data are logged.
  • pnpm --filter @oversync/frontend build passes.

Metadata

Metadata

Assignees

Labels

SCF 7.0Issues that strengthen the SCF 7.0 resubmission packageStellar WaveIssues in the Stellar wave programenhancementNew feature or requestgood first issueGood for newcomersinvestor readinessWork that improves investor, grant, or partner diligence materialslow riskScoped work that should not change bridge settlement semanticspriority: highHigh-impact work for SCF, investor readiness, or launch confidence

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions