Skip to content

@reown/[email protected]

Latest
Latest

Choose a tag to compare

View all tags
@github-actions github-actions released this 08 Oct 18:47
· 132 commits to develop since this release
@reown/[email protected]
fc8fbcb
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Major Changes

  • MULTICHAIN SUPPORT: Complete architectural overhaul introducing comprehensive multichain support for EVM-compatible chains, Solana, Bitcoin, and more blockchain ecosystems coming soon.

  • SIWX AUTHENTICATION: Introducing "Sign In With X" feature enabling decentralized authentication across multiple blockchain networks following CAIP-122 standard.

Added

  • Core Multichain Architecture:

    • New @reown/appkit-react-native core library as the central hub for managing multichain connections, adapters, and events
    • Modular adapter system with dedicated packages for different blockchain ecosystems:
      • @reown/appkit-ethers-react-native - EVM support via Ethers.js
      • @reown/appkit-wagmi-react-native - EVM support via Wagmi
      • @reown/appkit-solana-react-native - Native Solana blockchain support
      • @reown/appkit-bitcoin-react-native - Native Bitcoin blockchain support

  • SIWX (Sign In With X) Authentication:

    • Chain-agnostic authentication framework supporting Ethereum, Polygon, Solana, and more
    • Plugin-based architecture with siwx parameter in createAppKit configuration
    • Reown Authentication: Cloud-managed SIWX sessions with Dashboard integration
    • Custom Implementation: DefaultSIWX scaffold for custom authentication flows
    • Automatic signature prompts and session management across network switches
    • Session persistence and automatic sign-in for returning users
    • Compliance with CAIP-122 standard for blockchain-based authentication

  • Enhanced Social Login:

    • Google Authentication: Added missing Google social login provider
    • Complete social authentication suite now includes Google, Apple, Facebook, GitHub, Discord, and more

  • Enhanced Configuration:

    • New createAppKit factory function with centralized configuration
    • adapters array for pluggable blockchain support
    • siwx configuration for authentication setup

Changed

  • ⚠️ BREAKING: Initialization Process:

  • Replaced monolithic package imports with modular adapter system

  • createAppKit now requires adapters and networks arrays instead of chain-specific configs

  • createAppKit now requires storage to handles data persistence

  • Configuration moved from adapter-specific functions to centralized AppKitConfig

  • ⚠️ BREAKING: Package Structure:

  • Primary entry point changed from @reown/appkit-wagmi-react-native or @reown/appkit-ethers-react-native to @reown/appkit-react-native

  • Chain-specific packages now serve as adapters rather than primary libraries

  • All hooks and components now imported from @reown/appkit-react-native

  • ⚠️ BREAKING: Provider Setup:

  • New AppKitProvider wrapper required for all applications

  • Wagmi users must now access config via wagmiAdapter.wagmiConfig

  • Enhanced provider hierarchy supporting multiple blockchain contexts

  • Configuration Options:

    • defaultChain renamed to defaultNetwork
    • chainImages renamed to networkImages
    • New tokens property for cross-chain token balance display
    • New siwx property for authentication configuration
    • Enhanced metadata and project configuration options

Deprecated

  • SIWE Authentication:

    • SIWE Configuration: Deprecated in favor of new SIWX authentication system
    • Legacy SIWE setup methods - Use siwx parameter with SIWX providers instead

  • Hooks:

    • useDisconnect() - Use const { disconnect } = useAppKit() instead
    • All hooks now available from core package

Migration Required

This is a major release requiring migration for existing applications.

For detailed migration instructions, see: Migration Guide

Documentation

Assets 2
Loading