para 2.6.0 copy "para: ^2.6.0" to clipboard
para: ^2.6.0 copied to clipboard

Flutter package for Para SDK

Release 2.6.0 (Thu Dec 11 2025) #

Features #

  • Added issueJwt() method for server-side authentication - issue JWTs that can be verified server-side using Para's JWKS endpoint at /.well-known/jwks.json
  • Added JwtResponse class containing the signed token and key ID for JWKS lookup

Release 2.5.0 (Thu Nov 14 2025) #

Features #

  • Added deleteAccount() method to permanently delete user accounts and clear all associated session data (#76)

Changes #

  • Refactored session cleanup logic into reusable _clearLocalSessionState() method for consistent state management across logout and account deletion operations (#76)

Release 2.4.1 (Fri Oct 17 2025) #

Fixes #

  • Fixed iOS UIWindow optional unwrap crash by pinning passkeys_ios to version 2.8.0
  • Ensured compatibility across passkeys package suite with explicit version overrides for passkeys_android (2.7.1), passkeys_platform_interface (2.3.1), and passkeys_web (2.6.0)

Release 2.4.0 (Thu Oct 16 2025) #

Features #

  • Added automatic session persistence and restoration - user sessions now automatically save to secure storage and restore on app restart, eliminating the need for manual re-authentication (#75)
  • Added new session management APIs (keepSessionAlive, importSession, enhanced exportSession) enabling apps to manage session lifecycle without custom JavaScript (#75)
  • Introduced SessionPersistenceService with secure storage backend to safely persist and restore authentication sessions (#75)
  • Added sessionStatus notifier to provide real-time session state updates for UI integration (#75)

Changes #

  • Enhanced session refresh logic to automatically run after session restoration, maintaining fresh authentication state (#75)
  • Improved transmission keyshare tracking to reset properly on session import for reliable wallet operations (#75)
  • Added diagnostic logging for session persistence behavior to aid development and debugging (#75)

Release 2.3.0 (Tue Oct 14 2025) #

Features #

  • Added Single Logout (SLO) support with async bridge client architecture (#74)

Release 2.2.0 (Wed Jan 15 2025) #

Features #

  • Improved MetaMask connector deeplink handling with configurable app metadata for better wallet integration
  • Added MetaMaskConfig class to customize app identification in wallet connections
  • Enhanced deeplink URL construction for more reliable MetaMask communication

Changes #

  • Channel ID now uses uppercase format for consistency with MetaMask specifications
  • Improved error handling and connection state management for MetaMask operations
  • Added support for custom API versions in MetaMask configurations

Release 2.1.2-alpha.1 (Tue Jan 03 2025) #

Features #

  • Added support for returning complete RLP-encoded signed transactions for EVM chains, enabling direct submission to blockchain networks (#73)
  • Extended SignatureResult class with signedTransaction field for full EVM transaction data (#73)

Changes #

  • Enhanced EVM transaction signing to provide both signature and complete signed transaction while maintaining backward compatibility (#73)

Release 2.1.1-alpha.1 (Sat Aug 31 2025) #

Fixes #

  • Fixed wallet operations requiring manual transmission keyshares initialization - operations now automatically load required keyshares (#72)

Changes #

  • Wallet operations (fetchWallets(), signMessage(), signTransaction(), transfer()) now handle keyshares loading automatically (#72)
  • Keyshares loading state properly resets on logout and new sessions for consistent behavior (#72)
  • Operations continue gracefully even if keyshares loading fails, improving resilience (#72)

Release 2.1.0-alpha.1 (Tue Aug 27 2025) #

Breaking Changes #

  • Removed chain-specific signer classes - ParaEvmSigner, ParaSolanaWeb3Signer, ParaCosmosSigner have been removed in favor of unified methods (#71)
  • Replaced direct signer instantiation with unified formatAndSignMessage() and formatAndSignTransaction() methods (#71)

Features #

  • Unified wallet architecture - All signing and formatting logic moved to bridge, reducing SDK complexity (#71)
  • Type-safe transaction models - New EVMTransaction, SolanaTransaction, and CosmosTransaction classes for structured transaction building (#71)
  • Improved error messages - Clearer, actionable error descriptions with better extraction from bridge responses (#69)

Improvements #

  • Enhanced error parsing with robust handling of various error formats (Map, String, null) (#69)
  • Maintained backward compatibility for external wallet integrations (MetaMask, Phantom) (#71)

Migration Guide #

// Before:
final evmSigner = ParaEvmSigner();
final result = await evmSigner.signTransaction(walletId: walletId, to: '0x...', value: '1000000000000000000');

// After:
final evmTx = EVMTransaction(to: '0x...', value: '1000000000000000000', gasLimit: '21000', type: 2);
final result = await para.formatAndSignTransaction(walletId: walletId, transaction: evmTx.toJson());

Release 2.0.0-alpha.2 (Thu Aug 14 2025) #

Features #

  • Added comprehensive error tracking system for development, sandbox, and beta environments (#68)

Fixes #

  • Fixed password login wallet persistence to resolve "wallet with id does not exist" errors after authentication (#70)

Release 2.0.0-alpha.1 #

Breaking Changes #

  • Aligned Flutter SDK with Swift SDK architecture
  • Updated authentication flow and parameters

Features #

  • Added Phantom wallet support (#65)
  • Added automatic wallet creation after signup (#64)
  • Added Cosmos blockchain support (#62)
  • Added cross-repo Flutter E2E testing workflow
  • Added AuthInfo getter for mobile SDKs (#59)
  • Added passkey support detection in bridge initializer (#58)

Changes #

  • Renamed deeplinkUrl to appScheme in OAuth parameters (#63)
  • Updated bridge URLs
  • Enhanced Flutter SDK README with comprehensive documentation
  • Updated Flutter to latest stable version 3.32.0

CI/CD #

  • Added changelog generation script for Flutter SDK (#67)
  • Improved E2E testing infrastructure

1.4.0-dev.1 #

  • Added new ParaEvmSigner implementation for Ethereum transaction signing
  • Integrated web3dart support for EIP1559 and legacy transactions

1.3.2 #

  • Fixed incorrect relying party id for production environment.

1.3.1 #

  • Fixed malformed URLs for production environment in jsBridgeUri and relyingPartyId.

1.3.0 #

  • Swapped out solana_web3 for solana package

0.8.0 #

  • Renaming classes to be Para specific

0.7.0 #

  • Adds External Wallet Methods
  • Updates to use wrapped future for requestId
  • Fixes type handling for Wallet and WalletType

0.6.0 #

  • Adds Farcaster authentication support
    • New getFarcasterConnectURL() method for initiating Farcaster auth
    • New waitForFarcasterStatus() method for handling Farcaster auth flow
    • New FarcasterStatus model for typed Farcaster responses
  • Improves error handling for OAuth and Farcaster authentication flows
  • Adds proper error logging for authentication polling methods

0.5.2 #

  • Adds ability to pass in email or phone identifier to login method.
  • Adds new webChallenge model type.
  • Cleanup print statements in the Capsule Class.

0.5.1 #

  • Adds method for canceling webview operations.
  • Add try/catch to waitForOAuth to prevent unhandled promise rejection.

0.5.0 #

  • Refactors the Capsule Class for maintainability and readability.
  • Adds additional bridge methods to the Capsule Class.
  • Strongly types bridge postMessage responses.
  • Adds supported for multiwallets and wallet types.