|
1 | | -# @reown/appkit-scaffold-react-native |
| 1 | +# @reown/appkit-react-native |
2 | 2 |
|
3 | | -## 2.0.0 |
| 3 | +## 2.0.1 |
4 | 4 |
|
5 | 5 | ### Major Changes |
6 | 6 |
|
7 | | -- c8ec10d: Release v2.0.0 stable version |
| 7 | +- **MULTICHAIN SUPPORT**: Complete architectural overhaul introducing comprehensive multichain support for EVM-compatible chains, Solana, Bitcoin, and more blockchain ecosystems coming soon. |
8 | 8 |
|
9 | | -### Patch Changes |
| 9 | +- **SIWX AUTHENTICATION**: Introducing "Sign In With X" feature enabling decentralized authentication across multiple blockchain networks following CAIP-122 standard. |
| 10 | + |
| 11 | +### Added |
| 12 | + |
| 13 | +- **Core Multichain Architecture**: |
| 14 | + - New `@reown/appkit-react-native` core library as the central hub for managing multichain connections, adapters, and events |
| 15 | + - Modular adapter system with dedicated packages for different blockchain ecosystems: |
| 16 | + - `@reown/appkit-ethers-react-native` - EVM support via Ethers.js |
| 17 | + - `@reown/appkit-wagmi-react-native` - EVM support via Wagmi |
| 18 | + - `@reown/appkit-solana-react-native` - Native Solana blockchain support |
| 19 | + - `@reown/appkit-bitcoin-react-native` - Native Bitcoin blockchain support |
| 20 | + |
| 21 | +- **SIWX (Sign In With X) Authentication**: |
| 22 | + - Chain-agnostic authentication framework supporting Ethereum, Polygon, Solana, and more |
| 23 | + - Plugin-based architecture with `siwx` parameter in `createAppKit` configuration |
| 24 | + - **Reown Authentication**: Cloud-managed SIWX sessions with Dashboard integration |
| 25 | + - **Custom Implementation**: `DefaultSIWX` scaffold for custom authentication flows |
| 26 | + - Automatic signature prompts and session management across network switches |
| 27 | + - Session persistence and automatic sign-in for returning users |
| 28 | + - Compliance with CAIP-122 standard for blockchain-based authentication |
| 29 | + |
| 30 | +- **Enhanced Social Login**: |
| 31 | + - **Google Authentication**: Added missing Google social login provider |
| 32 | + - Complete social authentication suite now includes Google, Apple, Facebook, GitHub, Discord, and more |
| 33 | + |
| 34 | +- **Enhanced Configuration**: |
| 35 | + - New `createAppKit` factory function with centralized configuration |
| 36 | + - `adapters` array for pluggable blockchain support |
| 37 | + - `siwx` configuration for authentication setup |
| 38 | + |
| 39 | +### Changed |
| 40 | + |
| 41 | +- ⚠️ **BREAKING: Initialization Process**: |
| 42 | + - Replaced monolithic package imports with modular adapter system |
| 43 | + - `createAppKit` now requires `adapters` and `networks` arrays instead of chain-specific configs |
| 44 | + - `createAppKit` now requires `storage` to handles data persistence |
| 45 | + - Configuration moved from adapter-specific functions to centralized `AppKitConfig` |
| 46 | + |
| 47 | +- ⚠️ **BREAKING: Package Structure**: |
| 48 | + - Primary entry point changed from `@reown/appkit-wagmi-react-native` or `@reown/appkit-ethers-react-native` to `@reown/appkit-react-native` |
| 49 | + - Chain-specific packages now serve as adapters rather than primary libraries |
| 50 | + - All hooks and components now imported from `@reown/appkit-react-native` |
| 51 | + |
| 52 | +- ⚠️ **BREAKING: Provider Setup**: |
| 53 | + - New `AppKitProvider` wrapper required for all applications |
| 54 | + - Wagmi users must now access config via `wagmiAdapter.wagmiConfig` |
| 55 | + - Enhanced provider hierarchy supporting multiple blockchain contexts |
| 56 | + |
| 57 | +- **Configuration Options**: |
| 58 | + - `defaultChain` renamed to `defaultNetwork` |
| 59 | + - `chainImages` renamed to `networkImages` |
| 60 | + - New `tokens` property for cross-chain token balance display |
| 61 | + - New `siwx` property for authentication configuration |
| 62 | + - Enhanced metadata and project configuration options |
| 63 | + |
| 64 | +### Deprecated |
| 65 | + |
| 66 | +- **SIWE Authentication**: |
| 67 | + - **SIWE Configuration**: Deprecated in favor of new SIWX authentication system |
| 68 | + - Legacy SIWE setup methods - Use `siwx` parameter with SIWX providers instead |
| 69 | + |
| 70 | +- **Hooks**: |
| 71 | + - `useDisconnect()` - Use `const { disconnect } = useAppKit()` instead |
| 72 | + - All hooks now available from core package |
| 73 | + |
| 74 | +### Migration Required |
| 75 | + |
| 76 | +This is a major release requiring migration for existing applications. |
| 77 | + |
| 78 | +For detailed migration instructions, see: [Migration Guide](https://docs.reown.com/appkit/react-native/core/migration-multichain) |
| 79 | + |
| 80 | +### Documentation |
10 | 81 |
|
11 | | -- Updated dependencies [c8ec10d] |
12 | | - - @reown/appkit-common-react-native@2.0.0 |
13 | | - - @reown/appkit-core-react-native@2.0.0 |
14 | | - - @reown/appkit-ui-react-native@2.0.0 |
| 82 | +- [Installation Guide](https://docs.reown.com/appkit/react-native/core/installation) for multichain setup |
| 83 | +- [Migration Guide](https://docs.reown.com/appkit/react-native/core/migration-multichain) for v2 upgrade |
| 84 | +- [SIWX Authentication Guide](https://docs.reown.com/appkit/react-native/core/siwx) |
15 | 85 |
|
16 | 86 | ## 2.0.0-alpha.6 |
17 | 87 |
|
|
0 commit comments