> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getpara.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Changelog

> Release notes and version history for Para Web SDK

<Update label="v3.1.0" description="June 4, 2026">
  This release improves authentication reliability with better session management, enhanced external wallet support for Solana and Cosmos, and streamlined developer tools including CLI improvements and modal designer enhancements.

  ### Features

  * Improved modal designer auto-theme feature with client-side brand extraction for better logo and color detection
  * Added explicit CLI update command for easier SDK maintenance
  * Added Phantom wallet integration for Solana external wallet connections
  * Enhanced CLI help documentation with improved command guidance and JSON output support
  * Improved telemetry reliability during authentication flows with automatic data transmission on window close

  ### Bug Fixes

  * Fixed SDK release pipeline compatibility issues with build environments
  * Resolved Solana external wallet connection issues after page refresh and re-login sequences
  * Fixed cross-environment asset upload invalidation for developer portal logos
  * Corrected modal designer auto-theme functionality
  * Enhanced Cosmos external wallet signature verification with better fallback handling
  * Improved CLI runtime stability with better error handling and configuration management
  * Stabilized end-to-end test reliability with better element detection
  * Fixed mobile dependency caching to include patch file changes
  * Enhanced end-to-end test flow stability with improved wait conditions
  * Updated mobile test selectors for new authentication interface layout
  * Prevented Android Chrome keyboard from dropping first character during email input

  ### Performance

  * Reduced redundant session validation requests after login completion

  ### Maintenance

  * Added Stellar SDK example to hosted demo environment
  * Added comprehensive Android mobile end-to-end test coverage
</Update>

<Update label="v2.32.1" description="June 4, 2026">
  This release fixes a bug with Solana external wallet connection where the adapter wasn't properly reconnecting after a refresh and subsequent logout.

  ### Bug Fixes

  * Solana adapter not reconnecting after refresh and logout
</Update>

<Update label="v2.32.0" description="May 21, 2026">
  This release introduces the new REST SDK for server-side TypeScript development and fixes authentication flow issues with external wallet connections.

  ### Features

  * Added production-ready REST SDK package with TypeScript support for server-side wallet management and signing operations

  ### Bug Fixes

  * Fixed authentication flow state not resetting properly when logging out via useLogout hook with external wallets
  * Improved mobile end-to-end test stability and expanded account abstraction test coverage

  ### Maintenance

  * Removed deprecation warnings from pre-generated wallet methods
</Update>

<Update label="v2.31.0" description="May 14, 2026">
  This release adds support for private key export and transaction review for external wallet authenticated users, enabling full functionality across all authentication methods.

  ### Features

  * Added support for private key export and transaction review for users authenticated with external wallets

  ### Bug Fixes

  * correct e2e web matrix slack reporting
</Update>

<Update label="v2.28.0" description="May 7, 2026">
  Added Solana private key export functionality and multi-channel OTP delivery with WhatsApp and SMS options, plus several authentication flow improvements.

  ### Features

  * Added private key export support for Solana wallets
  * Improved CLI request tracking with standardized identity headers
  * Added multi-channel OTP delivery with WhatsApp and SMS fallback options
  * Added configurable Send functionality with partner-level controls

  ### Bug Fixes

  * Fixed Solana message signing reliability with improved error recovery and retry logic
  * Fixed wallet creation for existing users when new wallet types are required
  * Fixed authentication flow hanging when passkey login fails
  * Fixed customer logo sizing and centered footer branding in authentication UI
  * Fixed internal package version consistency

  ### Maintenance

  * autodeploy sandbox sites on merge to main (ENG-6770)
  * verify internal @getpara/\* version pins after lerna version (ENG-6778)
  * split mobile e2e tests into standalone workflow
</Update>

<Update label="v2.27.0" description="April 29, 2026">
  This release fixes wallet claiming issues and improves developer portal permissions, ensuring smoother authentication flows and better user experience.

  ### Bug Fixes

  * Fixed wallet claiming process hanging when some pre-generated wallets lack local authentication material
  * Fixed Create Project button appearing for users without proper organization permissions

  ### Maintenance

  * Update pregen claim example and add e2e coverage
</Update>

<Update label="v2.26.0" description="April 28, 2026">
  This release adds Account Abstraction support to Bridge V2 and mobile examples, while improving pre-generated wallet handling and Expo one-click-login reliability.

  ### Features

  * Added Account Abstraction support over Bridge V2, including Swift and Flutter example flows

  ### Bug Fixes

  * Normalized pre-generated wallet responses for more consistent client handling
  * Restored `nativeCallbackUrl` for Expo one-click-login authentication flows
  * Improved asset cache invalidation so deployed signing components load the latest worker and WASM files

  ### Maintenance

  * Migrated the Expo one-click-login example to the latest auth API
</Update>

<Update label="v2.25.0" description="April 23, 2026">
  This release adds testnet faucet functionality and Solana transaction signing support, while fixing several authentication flow issues including modal reset problems and external wallet verification failures.

  ### Features

  * Added testnet faucet SDK method and React hook for requesting test tokens
  * Added support for Solana transactions in REST API transaction signing endpoints
  * add testnet faucet SDK method and hook
  * accept Solana transactions in rest-with-node sign-transaction (ENG-6721)

  ### Bug Fixes

  * Fixed authentication flow hanging when users have wallets from different Para partners
  * Fixed Phantom Solana wallet verification failing intermittently in mobile iframe environments
  * Fixed excessive API calls during SDK initialization that caused performance issues
  * Fixed authentication modal not resetting properly when popup is closed during wallet verification
  * Fixed Solana wallet sign message errors after logout and re-login
</Update>

<Update label="v2.24.0" description="April 16, 2026">
  This release adds structured error handling for React Native passkey operations and updates example applications with improved Para branding and chain-native signing patterns.

  ### Features

  * Added structured error handling for React Native passkey operations with typed error codes, platform detection, and actionable suggestions for common authentication failures

  ### Bug Fixes

  * Fixed mobile end-to-end test failures by explicitly targeting iOS platform in test configurations
  * add --platform ios to Maestro mobile e2e tests

  ### Maintenance

  * Updated example application dependencies to use latest Para SDK versions
  * Redesigned modal examples with consistent Para branding and updated chain-specific examples to use native signing hooks for EVM, Cosmos, and Solana
</Update>

<Update label="v2.23.0" description="April 13, 2026">
  This release adds Expo authentication and Account Abstraction examples, and fixes Solflare detection in mobile in-app browsers.

  ### Features

  * Added Expo authentication examples for passkeys, passwords, PINs, and basic login
  * Added an Account Abstraction screen to the Expo example app

  ### Bug Fixes

  * Fixed Solflare detection in mobile in-app browsers
  * Fixed the changelog generator so scoped commits and commit titles containing colons are included correctly
</Update>

<Update label="v2.22.0" description="April 9, 2026">
  This release adds pre-warming capabilities for faster signing operations, improves React provider flexibility with loading states, and fixes critical authentication issues on React Native.

  ### Features

  * Added `initializeWorker()` method to pre-warm key management components for faster first-time signing operations
  * Added `waitForReady` and `fallback` props to `ParaProvider` for better loading state control and custom loading UI
  * Improved React hooks architecture with factory and enhancer patterns for better extensibility
  * Deprecated pre-generated wallet methods in favor of the new REST API migration path
  * require /test comment to run tests on PRs

  ### Bug Fixes

  * Fixed authentication failures on React Native where session headers and query parameters were not properly sent to the server
  * Improved error handling during SDK initialization to prevent startup failures
  * add pull-requests

  ### Maintenance

  * Improve error handling on react-sdk startup
</Update>

<Update label="v2.21.0" description="April 6, 2026">
  This release fixes Phantom wallet detection in mobile in-app browsers.

  ### Bug Fixes

  * Fixed Phantom wallet detection in mobile in-app browsers during Solana external wallet connection
</Update>

<Update label="v2.20.0" description="April 2, 2026">
  Added Stellar blockchain support and wallet migration capabilities, along with improved test reliability and authentication UI fixes.

  ### Features

  * Added `migrateWalletShare` method to securely migrate existing wallet shares with ECIES encryption
  * Added full Stellar blockchain integration with signing support for transactions and authentication
  * add Stellar blockchain integration

  ### Bug Fixes

  * Improved Stellar signer implementation and wallet factory for better reliability
  * Fixed stale preview images in the developer portal branding interface
  * improve daily E2E test reliability for mobile tests
  * Dev portal - stale preview images
</Update>

<Update label="v2.19.0" description="March 26, 2026">
  This release adds React Native platform support, EIP-7702 authorization signing, and wallet switching capabilities while fixing React Native compatibility issues and improving developer tooling.

  ### Features

  * Added EIP-7702 authorization signing support to REST API examples
  * Added platform-agnostic ParaProvider and hooks for React Native development
  * Added wallet switching functionality with complete end-to-end flow
  * Added CLI command to inspect API key configuration without entering edit mode
  * Added permissions management page to developer portal with policy viewer

  ### Bug Fixes

  * Fixed build pipeline issues that were causing end-to-end test failures
  * Fixed React Native compatibility for Android 15+ with 16KB memory page alignment
  * Improved mobile test reliability with failure screenshots and independent test execution
  * Fixed Metro bundler errors when using React Native SDK without Smart Account features
  * Added request timeout and retry logic for better network reliability
  * Fixed React Native compatibility with react-native-quick-crypto v1.x Nitro modules

  ### Documentation

  * Added EIP-712 typed data signing example to REST API documentation

  ### Maintenance

  * Increased pull request approval threshold to reduce review friction
  * Added automatic cleanup of test organizations after end-to-end runs
  * Unified pull request review process with comment-triggered commands
  * Updated documentation files to fix outdated commands and paths
  * Moved onramp components from shared library to portal for better dependency management

  ### Tests

  * Added comprehensive test coverage for wallet switching, guest mode, and account linking
  * Added end-to-end tests for onramp provider integration flows
</Update>

<Update label="v2.18.0" description="March 19, 2026">
  This release improves authentication UI screens, fixes Solana external wallet logout issues, and adds wagmi v3 compatibility for better developer experience.

  ### Features

  * Updated authentication UI with improved permissions and approval screens for better user experience
  * Enhanced error reporting for production environments to improve debugging capabilities

  ### Bug Fixes

  * Fixed Solana external wallet users being logged out on page refresh
  * Fixed switch wallets modal loading state not clearing properly after wallet selection
  * Added wagmi v3 compatibility to eliminate peer dependency warnings
  * Improved transaction approval handling for mobile bridge integrations when permissions policies are enabled

  ### Maintenance

  * Added async session export method for improved session management capabilities
</Update>

<Update label="v2.17.0" description="March 13, 2026">
  This release adds support for external wallets (MetaMask, Rainbow, Phantom) as Account Abstraction signers with automatic chain switching.

  ### Bug Fixes

  * support external wallets as AA signers with chain switching
</Update>

<Update label="v2.16.0" description="March 12, 2026">
  This release adds account abstraction support, improves permissions handling with longer review timeouts and consent flows, and enhances mobile testing coverage with iOS E2E tests.

  ### Features

  * Added account abstraction actions and hooks for enhanced wallet functionality
  * Added permissions worksheet tool for generating policy configurations
  * Added comprehensive iOS E2E tests for Swift, Flutter, and Expo mobile integrations
  * add Maestro E2E tests for Swift, Flutter, and Expo iOS

  ### Bug Fixes

  * Fixed Vercel deployment authentication in CI workflows
  * Increased permissions timeout to allow more time for transaction review
  * Fixed permissions worksheet UI issues and removed unsupported features
  * Fixed mobile E2E test results missing from CI notifications
  * Improved environment handling by separating backend and API key configurations
  * Added validation to prevent saving empty on-ramp provider configurations
  * Fixed recovery secret regeneration in Para Connect
  * Fixed permissions consent screen to properly display when required

  ### Maintenance

  * Updated design app with new permissions, login UI, and transaction screens
  * Removed GitHub Pages deployment for permissions worksheet in favor of Vercel
  * Updated Next.js example configuration for E2E testing
  * Improved useIsFullyLoggedIn hook implementation
</Update>

<Update label="v2.15.0" description="March 5, 2026">
  This release introduces a new CLI tool for developers, adds modal theming capabilities, and includes a new configuration option to customize the add funds experience.

  ### Features

  * Added `disableAddFundsPrompt` prop to hide the Add Funds button on the post-signup wallet creation screen while keeping it available in the main account view
  * Added new `@getpara/cli` package with 18 commands for authentication, project management, and configuration via browser OAuth flow

  ### Bug Fixes

  * Fixed EVM provider initialization to properly track setup state

  ### Maintenance

  * update nextjs example for e2e

  ### Tests

  * Added initial end-to-end test suite for developer portal functionality
</Update>

<Update label="v2.14.0" description="March 3, 2026">
  This release adds webhook configuration UI to the developer portal and fixes critical issues with server-side rendering and React Native OAuth flows.

  ### Features

  * Added webhook configuration interface to developer portal for setting up webhook URLs, selecting event types, and managing secrets

  ### Bug Fixes

  * Fixed SDK instantiation errors in Next.js server-side rendering environments
  * Fixed OAuth authentication hanging in React Native applications
  * Fixed changelog documentation sync to generate proper Mintlify components
  * Added validation for onramp providers to prevent invalid API calls
</Update>

<Update label="v2.13.0" description="February 26, 2026">
  This release includes a major state management refactor for improved reliability, along with authentication flow optimizations and several critical bug fixes.

  ### Features

  * Refactored internal state management system for improved authentication flow reliability and consistency

  ### Bug Fixes

  * Fixed secure session regeneration issues that could cause authentication failures
  * Fixed logout method to properly await completion before returning
  * Removed deprecated wallet creation configuration from examples to prevent unintended behavior
  * Fixed error reporting to correctly identify production vs sandbox environments
  * Enhanced security headers and configurations across all hosted components

  ### Performance

  * Reduced API calls during OAuth authentication flow for faster sign-in times
</Update>

<Update label="v2.12.0" description="February 20, 2026">
  This release adds dynamic authentication identifier support for the sign-in modal and fixes several wallet management issues including balance refresh, private key export, and React strict mode compatibility.

  ### Features

  * Added support for passing `defaultAuthIdentifier` directly to `openModal()` for dynamic authentication setup
  * Added REST API login method tracking in the developer portal analytics

  ### Bug Fixes

  * Fixed stale balance data when clicking 'max' after completing a transaction
  * Fixed wallet loading issues when all wallet types are configured as optional
  * Fixed missing wallet icons now showing chain-specific fallbacks instead of empty circles
  * Fixed wallet detail view and export button not appearing in React strict mode
  * Fixed passkey authentication errors when exporting private keys or switching wallets
  * Fixed mobile dropdown positioning issues in the authentication UI
  * Fixed export private key always showing the first wallet's key regardless of dropdown selection
  * CpslSelect mobile dropdown positioning
  * re-fetch private key when selected wallet changes

  ### Maintenance

  * Updated REST API examples with latest endpoints and improved documentation
  * Removed 'View Plans' button from developer portal onboarding flow
  * Modularized E2E test infrastructure with shared page objects and reusable test flows
</Update>

<Update label="v2.11.0" description="February 13, 2026">
  This release adds real-time transaction monitoring with WebSocket support, improves onramp provider filtering based on transaction limits, and fixes wallet recovery functionality.

  ### Features

  * Added automatic filtering of onramp providers based on transaction amount limits to prevent users from selecting incompatible payment methods
  * Added real-time transaction monitoring with live status updates (pending, confirmed, failed) and retry functionality for failed transactions
  * Added environment-aware Stripe configuration that automatically selects the correct publishable keys based on deployment environment

  ### Bug Fixes

  * Fixed changelog synchronization to use correct documentation repository
  * Fixed wallet recovery flow functionality to restore proper user experience
  * Fixed incorrect page redirects when refreshing the developer portal
  * Improved wallet switching behavior to maintain valid asset and network selections when changing between wallet types

  ### Maintenance

  * Combined buy crypto and withdraw configuration sections in the developer portal into a single unified interface
</Update>

<Update label="v2.10.0" description="February 11, 2026">
  This release improves authentication session persistence, wallet connection reliability, and on-ramp testing while removing deprecated dark theme support and streamlining the developer experience.

  ### Features

  * Added persistent authentication state that survives page reloads and browser sessions
  * Added automatic test mode enforcement for on-ramp functionality in development and staging environments
  * Added HTTPS support for balance override functionality in modals

  ### Bug Fixes

  * Fixed error when no pre-generated wallets are available during authentication
  * Fixed wallet selection buttons remaining clickable during connection process in sign-in flow
  * Removed outdated v1.x SDK code snippets from developer portal setup pages
  * Fixed wallet image display issues in authentication UI

  ### Maintenance

  * Removed deprecated dark theme CSS variables from all examples and SDK components
  * Decreased loading and redirect time in the developer portal
</Update>
