Skip to content

Replace legacy Wallets Kit v1 references in current tutorials #2609

Description

@kalepail

Finding

Two current Docs tutorial surfaces still teach the legacy Wallets Kit v1 package
or API. The English Example Application tutorial installs
@creit.tech/stellar-wallets-kit and includes that legacy scope in its Vite SSR
configuration. The Spanish dapp-frontend translation goes further: it installs
and imports the legacy scope and uses new StellarWalletsKit(...) with
allowAllModules().

The current maintained package is the JSR v2 package
@creit-tech/stellar-wallets-kit (latest 2.5.0). Its current initialization
guidance uses static StellarWalletsKit.init(...) with defaultModules() or
explicitly selected modules. The English dapp-frontend source no longer has a
Wallets Kit example, so the Spanish page is also an untranslated obsolete
section rather than a current English counterpart.

Evidence

Live source re-check on 2026-07-14:

The Wallet Integration page at
https://developers.stellar.org/docs/tools/developer-tools/wallets was separately
checked. It only links to the maintained Kit site and contains no package or
API example; it is deliberately excluded from this finding.

Additional recorded evidence:

  • re-verified 2026-07-14: docs/build/apps/example-application-tutorial/overview.mdx installs the legacy dotted npm package @creit.tech/stellar-wallets-kit (line 199) and lists it in Vite ssr.noExternal (line 254)
  • re-verified 2026-07-14: i18n/es/docusaurus-plugin-content-docs/current/build/apps/dapp-frontend.mdx installs and imports @creit.tech/stellar-wallets-kit, then constructs StellarWalletsKit with allowAllModules (lines 240-266)
  • re-verified 2026-07-14: the English docs/build/apps/dapp-frontend.mdx has no @Creit, allowAllModules, or StellarWalletsKit reference; the former tools/developer-tools/wallets page is link-out only and is not evidence for this finding
  • current maintainer sources: JSR lists @creit-tech/stellar-wallets-kit 2.5.0 as latest (published 2026-06-29), and the current kit README/init guide uses static StellarWalletsKit.init with defaultModules

Recommendation

Update the Example Application tutorial's dependency and Vite configuration to
the current supported Wallets Kit path, and either remove the obsolete Spanish
Wallets Kit section or translate a current v2 example. A retained example should
use the JSR v2 package and static initialization with defaultModules() or
explicit module selection; if either tutorial must remain a v1 historical
example, label it clearly as legacy and pin that version rather than presenting
it as current integration guidance.

Source Record

This was found by the downstream Raven eval/improvements loop and recorded as sd-035 (stellar-docs, discovered 2026-07-11).

Public source record: improvements/stellar-docs/sd-035-wallets-kit-jsr-package-api-drift.md

Immutable source snapshot: b9098a92cab9

Resolution Handoff

When a fix is deployed, please link the resolving issue or PR to the source record above and notify Raven through:

https://github.com/kalepail/stellar-raven/issues/new?template=upstream-improvement-ready.yml&title=%5Bupstream-ready%5D%20sd-035%3A%20

Include the finding id, resolving issue/PR, deployed version or timestamp, and the smallest live recheck. Raven independently verifies the upstream surface before changing the finding to fixed-upstream; issue closure or a merged PR alone is not treated as proof. After a distinct reviewer repeats the live check, the active finding is retired to Raven's resolved ledger while the immutable snapshot remains available.

Metadata

Metadata

Assignees

Labels

ravenissues discovered by Stellar Raven QA passes

Type

No type

Projects

Status
No status

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions