Use-Wallet: Open-Source Wallet Integration Library for Algorand

Summary

This proposal requests 250,000 ALGO in retroactive funding to cover 6 months of maintenance, development, and community support for @txnlab/use-wallet (https://github.com/TxnLab/use-wallet) from January 1, 2025 through June 30, 2025.

Our previously awarded xGov grants for Use-Wallet covered:

• January 2024 – May 2024 — xGov-186 (https://github.com/algorandfoundation/xGov/pull/186) (old xGov system)
• June 2024 – December 2024 — Proposal 3247418179 (https://xgov.algorand.co/proposal/3247418179), 175,000 ALGO

This proposal covers the period immediately following the last grant, with no overlap. The increased ask reflects the scope of this period's work: the stable v4.0.0 major release (a ground-up migration to Algorand SDK v3), a new framework adapter (Svelte), and the growing maintenance burden of supporting 5 published packages across 4 framework adapters.

About Use-Wallet

Use-Wallet is an open-source, framework-agnostic wallet integration library maintained by TxnLab. It enables Algorand dApps to seamlessly integrate with multiple wallets including Pera, Defly, Exodus, Lute, Kibisis, and WalletConnect. It can be used in any modern front-end stack, with official adapters for:

• React (https://txnlab.gitbook.io/use-wallet/framework/react)
• Vue (https://txnlab.gitbook.io/use-wallet/framework/vue)
• SolidJS (https://txnlab.gitbook.io/use-wallet/framework/solidjs)
• Svelte (https://txnlab.gitbook.io/use-wallet/framework/svelte)

With Use-Wallet's hooks and utility functions, you can:

• Easily add or remove wallet support with a few lines of code
• Configure each wallet provider as needed for your application
• Allow users to easily switch between active accounts and wallet providers
• Sign and send transactions
• Restore sessions for returning users

Use-Wallet is the standard wallet integration library for the Algorand ecosystem. It is used by the Algorand Foundation's own xGov voting platform (https://github.com/algorandfoundation/xgov-beta-web uses @txnlab/use-wallet-react v4.0.0), the community-built xGov Explorer (https://xgov.app), and the vast majority of Algorand dApps including Folks Finance, Tinyman, Vestige, Humble DeFi, and many others.

Work Completed: January – June 2025

This was one of the most significant development periods in Use-Wallet's history. The library shipped its v4.0.0 stable major release, added an entirely new framework adapter, and continued active maintenance of the v3.x line while supporting developers migrating between versions.

Releases Shipped

During this 6-month period, the following releases were published to npm across 5 packages (use-wallet, use-wallet-react, use-wallet-vue, use-wallet-solid, use-wallet-svelte):

• v3.12.0 — Q1 2025

  • Unified isReady state (#335: https://github.com/TxnLab/use-wallet/pull/335)
  • isReconnecting in React (#330: https://github.com/TxnLab/use-wallet/pull/330)
  • E2E testing framework (#331: https://github.com/TxnLab/use-wallet/pull/331)

• v4.0.0-beta.5 — Q1 2025

  • New useNetwork hook (#339: https://github.com/TxnLab/use-wallet/pull/339)
  • Merged all v3.11.1 and v3.12.0 changes into v4 line

• v4.0.0 — Q1 2025
  Stable release — Full algosdk v3 migration, runtime node configuration, custom network support, Defly Web extension, Pera Discover auto-connect

• v4.1.0 — Q1–Q2 2025

  • Svelte adapter (@txnlab/use-wallet-svelte) by @acfunk (https://github.com/acfunk)
  • Liquid Auth provider restored

• v4.2.x — Q2 2025

  • React 19 support (#354: https://github.com/TxnLab/use-wallet/pull/354)
  • v4 documentation sync (#357: https://github.com/TxnLab/use-wallet/pull/357)
  • algosdk v3.2.0 (#349: https://github.com/TxnLab/use-wallet/pull/349)
  • TypeScript v5.8.2 (#340: https://github.com/TxnLab/use-wallet/pull/340)

Each release was published across all 5 packages simultaneously. The v4 release cycle required coordinating breaking changes, migration guides, and documentation updates across every adapter.

Key Pull Requests Merged (January – June 2025)

Feature Development and Major Changes

• PR #339 — Separate useNetwork hook — https://github.com/TxnLab/use-wallet/pull/339 — @drichar
• PR #335 — Replace isReconnecting with unified isReady state — https://github.com/TxnLab/use-wallet/pull/335 — @drichar
• PR #330 — Return isReconnecting from useWallet in React adapter — https://github.com/TxnLab/use-wallet/pull/330 — @stefanofa
• PR #354 — React 19.0.0 peer dependency support — https://github.com/TxnLab/use-wallet/pull/354 — @birdmanmandbir
• PR #357 — Sync v4 documentation from GitBook — https://github.com/TxnLab/use-wallet/pull/357 — @drichar

Testing and Developer Experience

• PR #331 — End-to-end testing examples and documentation — https://github.com/TxnLab/use-wallet/pull/331 — @No-Cash-7970
• PR #336 — Fix React testing warnings — https://github.com/TxnLab/use-wallet/pull/336 — @drichar

Dependency Updates and Maintenance

• PR #349 — Update algosdk to v3.2.0 — https://github.com/TxnLab/use-wallet/pull/349
• PR #340 — Update TypeScript to v5.8.2 — https://github.com/TxnLab/use-wallet/pull/340
• PR #352 — Update jsdom to v26 — https://github.com/TxnLab/use-wallet/pull/352
• PR #351 — Update eslint-config-prettier to v10 — https://github.com/TxnLab/use-wallet/pull/351
• PR #348 — Update pnpm to v9.15.9 — https://github.com/TxnLab/use-wallet/pull/348

v4.0.0 Major Release

Comprehensive migration guide available at: https://txnlab.gitbook.io/use-wallet/guides/migrating-from-v3.x

Adoption Metrics

• GitHub Stars (101)
• GitHub Forks (47)
• NPM Downloads Q1 - Q2 2025: 19,109

About the team TxnLab is a 3-person development team building on Algorand since 2021.