appkit

What's Changed

• fix: manualWalletsTemplate not loading MobileWallets by @justraman in https://github.com/WalletConnect/web3modal/pull/996

New Contributors

• @justraman made their first contribution in https://github.com/WalletConnect/web3modal/pull/996

Full Changelog: https://github.com/WalletConnect/web3modal/compare/2.5.0...2.3.6

What's Changed

• Fix regression where error style was not applied in mobile view

Full Changelog: https://github.com/WalletConnect/web3modal/compare/2.3.4...2.5.0

What's Changed

• Improve stability on ios safari <-> wallet redirects where some pairings didn't resolve infinitely

Full Changelog: https://github.com/WalletConnect/web3modal/compare/2.3.3...2.3.4

What's Changed

• closes #991 (fixes search)
• show recent wallet in "view all" view

Full Changelog: https://github.com/WalletConnect/web3modal/compare/2.3.2...2.3.3

What's Changed

• Handle case where ios wallet selection only has 1 row of wallets and needs to show view all option.
• Fix regression with image display due to newly introduced prop

Full Changelog: https://github.com/WalletConnect/web3modal/compare/2.3.1...2.3.2

Changes

• fix: Mobile animation where spring was overshooting
• Expose W3mQrCode component by @devceline
• fix edge cases when setting small amount of reccomended wallets https://github.com/WalletConnect/web3modal/issues/981#issuecomment-1513005714

Full Changelog: https://github.com/WalletConnect/web3modal/compare/2.3.0...2.3.1

Changes

• closes #792 (Use new web3modal api)
• fix: Respect image overrides for explorer wallet id's
• add: --w3m-wallet-icon-large-border-radius theme variable
• add: --w3m-wallet-icon-small-border-radius theme variable
• fix: flickering network icon within network button component in safari
• add: error state / shake animation feedback to connector "loading" screens
• add: connector loading screen in iOS to display app store links and useful info
• add: new network switching loading screen
• add: WalletConnect connector now pre-heats pairing and caches it up to 3 minutes. This reduces loading views and un-necesary websocket requests. Cache is invalidated if: connection is requested for expired pairing (3min), user has connected, there was connection error
• add: closes #958 closes #865 (add tokenContracts option to define custom erc-20 token for account view balance, per chain)
• fix: closes #946 (Add small vertical padding in low vertical space screen mode)
• remove: closes #892 closes #879 closes #820 Hardcoded injected wallet presets in favour of cloud data and add info notices about common pitfalls
• add: dynamic wallet "connection" view that adopts to platform, installed wallets and listing data
• add: closes #909 if injected wallet is detected on a mobile device, use it once user clicks on connect button
• fix: closes #978 by phanthai12 (inset css property not working in safari 13)
• add: new explorerRecommendedWalletIds option that can be used to override default recommended wallets and order them by passing an array of explorer wallet ids from https://explorer.walletconnect.com/?type=wallet or setting this to NONE in order to not fetch any recommended wallets closes #812 closes #933
• add: new explorerExcludedWalletIds option that can be used to exclude wallets by passing their ids to an array. Can also be set to ALL to exclude all wallets. Recommended wallets will still be fetched.
• android: New android ui when opening modal, with more clarity and easier access to non WalletConnect options.

Breaking Changes

• ios: closes #930 closes #937 (To improve stability around mobile linking, deeplinks are now prioritised over universal links, this requires users to interact with native prompt when performing connection or transaction, but results in much more reliable linking between dapps and mobile)
• closes #956 - Modal no longer sets defaultChain to mainnet or first chain defined in wagmi config. So when connecting user's active wallet chain will be used. You can set defaultChain to get back previous behaviour or ask user to select your dapp supported chain before connection using enableNetworkView option.
• removed: explorerAllowList and explorerDenyList options in favour of explorerRecommendedWalletIds and explorerExcludedWalletIds
• rpc: WalletConnect rpc support list for evm/eip155 chains was updated to 1, 3, 4, 5, 10, 42, 56, 69, 97, 100, 137, 280, 324, 420, 42161, 42220, 43114, 80001, 421611, 421613, 1313161554, 1313161555

New Contributors

• @thomas-waite
• @phanthai12

Full Changelog: https://github.com/WalletConnect/web3modal/compare/2.2.2...2.3.0

What's Changed

• Update dependencies
• Fix injected wallet name resolutions
• Expose web3modal version for debugging
• Expose types for web3modal config / props
• closes #943
• All examples have been simplified and de-coupled from monorepo. They are now available at https://github.com/WalletConnect/web3modal-examples

Full Changelog: https://github.com/WalletConnect/web3modal/compare/2.2.1...2.2.2

Changes

• Preload custom theme assets, closes #935
• Handle balance display edge case where less than 6 chars were present, closes #923
• Fix issue where account modal didn't close when user disconnected from within wallet
• Add explicit dependency of @web3modal/standalone to react and html packages so that there is no conflict between modal sub-dependencies in wagmi's ethereum-provider (between ui and core packages).

New Contributors

• @ryosukemori made their first contribution in https://github.com/WalletConnect/web3modal/pull/885

Full Changelog: https://github.com/WalletConnect/web3modal/compare/2.2.0...2.2.1

Breaking Changes

• Wagmi CoinbaseConnector was removed from defaults in modalConnectors() (now w3mConnectors) utility
• Renamed modalConnectors to w3mConnectors
• Renamed walletConnectProvider to w3mProvider
• w3mConnectors() utility option for version now expects number (1 or 2) instead of string ('1' or '1')
• w3mConnectors() utility option for version is now required
• w3mConnectors() utility option for appName was removed
• w3mConnectors() utility option for projectId is now required
• Following options were removed in favour of new themeVariables option:
  • removed themeColor, use --w3m-accent-color inside themeVariables option instead
  • removed themeBackground, use --w3m-background-color and/or --w3m-background-image-url inside themeVariables option instead
  • removed themeZIndex, use --w3m-z-index inside themeVariables option instead
• Minimum wagmi version is now 0.12.x and @wagmi/core is 0.10.x
• WebGL animated gradient was removed, after plentiful user feedback and new theming options we decided to remove this part of the modal due to additional size and performance hit. (~50kb size reduction)

Changes

• (make modal scrollable in smaller landscape screens) closes #886
• (extended modal customisation through theme variabloes) closes #893
• (update legal notice text) closes #884
• (silence errors for image preloading) closes #860
• (add enableExplorer feature flag) closes #875
• (enable single chain switching, if user is on unsupported network) closes #878
• (skip fetching ens if mainnet is not present in chains) closes #908
• (added option to hide/show avatar in web3button component) closes #910
• (update to wagmi 0.12.x / 0.10.x) closes #920 closes #921

Full Changelog: https://github.com/WalletConnect/web3modal/compare/2.1.3...2.2.0

What's Changed

• closes https://github.com/WalletConnect/web3modal/issues/918 a regression caused by regression in valtio dependency update

Full Changelog: https://github.com/WalletConnect/web3modal/compare/2.1.2...2.1.3

What's Changed

• Add ability to select non WalletConnect option (i.e. wagmi connector) in android view

What's Changed

• Update dependencies
• Fix recent wallet display in standalone mode
• Add wallet version filter when fetching from explorer in standalone

Full Changelog: https://github.com/WalletConnect/web3modal/compare/2.1.0...2.1.1

Breaking changes

• Make projectId required
• Removed setSelectedChain, getSelectedChain and subscribeSelectedChain in favor of using wagmi/core actions and new setDefaultChain action
• closes #846 (Removed useWeb3ModalNetwork hook in favor of using wagmi network hooks and setDefaultChain from useWeb3Modal)
• Update dependencies, new minimum requirements of @wagmi/core >=0.9 and wagmi >=0.11, see wagmi migration guide

Changes

• closes #838 (Add missing state cleanup to watchAccount listener)
• closes #826 (Gnosis, EVMos, zkSync, Filecoin, Iotx, Metis, Moonbeam, Moonriver)
• closes #825 (prefix css variables)
• closes #824 (added enableAccountView config option that allows users who manage their own ui for accs to disable web3modal one thus not fetching balance / ens data etc unnecessarily)
• WalletConnect v2 support (WIP)
• (html) Added new web3modal.setDefaultChain action
• (react) Added setDefaultChain to useWeb3Modal hook
• closes #815 (memoise web3modal react component, there is no need for it to re-render unnecessarily)
• closes #840 (mobile localhost testing notes)
• Simplified react example
• Created laboratory example for consolidated testing

Full Changelog: https://github.com/WalletConnect/web3modal/compare/2.0.0...2.1.0

What's Changed

• Fix some parent styling leaking into core web components
• closes #817
• Fix web3-button layout shift when in "connecting" state

Full Changelog: https://github.com/WalletConnect/web3modal/compare/2.0.0-rc.3...2.0.0

• Dependency updates
• Fix bug where waleltConnect session was not persisted due to undefined version

What's Changed

• fix: typo in fetchEnsName by @fachryadhitya in https://github.com/WalletConnect/web3modal/pull/823
• Rc.3 by @0xAsimetriq in https://github.com/WalletConnect/web3modal/pull/816

New Contributors

• @fachryadhitya made their first contribution in https://github.com/WalletConnect/web3modal/pull/823

Full Changelog: https://github.com/WalletConnect/web3modal/compare/2.0.0-rc.2...2.0.0-rc.3

What's Changed

• closes #799 (fix router logic for undefined options)
• closes #805 (add support for version: '2' in wagmi)
• closes #804 (remove duplicate extension listings for custom connectors on best effort / case-insensitive name matches)
• closes #797 (add "I don't have a wallet" option to android view)
• closes #781 (resolved via updated rpc management)
• closes #809 (We need to load modal's web-component ui asynchronously as well as fetch preview wallets from explorer if projectId was provided. These might not be ready before modal's open method is called (slow networks, modal is only initialised on a specific user action). To ensure good ux, open is now async and will wait for these to become resolved, thus allowing users to show spinners / loaders in rare ocassions where it takes longer to bootstrap things.)
• Similarly to above, on very slow networks it takes some time to generate uri for qr code, thus we added fallback to show loader in those cases.

Full Changelog: https://github.com/WalletConnect/web3modal/compare/2.0.0-rc.1...2.0.0-rc.2

Changes

• closes #718 (android mobile view)
• closes #784 (added themeZIndex config)
• closes #785 (added defaultChain config)
• closes #720 (added network switch component)
• closes #725 (add explorerAllowList and explorerDenyList)
• closes #710 (Modal focus management)
• closes #793 (Account for deeplinks with nested paths when parsing / cleaning them up)
• closes #714 (No wallets displayed when empty [] chains provided to EthereumClient)
• closes #681 (Add configs for terms and policy)

Breaking Changes

• Changed enableNetworkView config option to be false by default (was true)

Full Changelog: https://github.com/WalletConnect/web3modal/compare/2.0.0-beta.10...2.0.0-rc.1

Changes

• closes #765
• Remove custom logic / views associated to wagmi (non WalletConnect and Injected) connectors in favor of using their own defaults
• closes #773
• closes #766
• close #719 (balances, ens, new balance button)
• added new config option for tokenImages
• added html-standalone example
• Updated dependencies
• Fix wallet de-duplication inside mobile in app browsers
• walletConnectProvider will now fall back to rpc's defined in chain config if our rpc does not support that chain id

Full Changelog: https://github.com/WalletConnect/web3modal/compare/2.0.0-beta.9...2.0.0-beta.10

What's Changed

• Re-shuffle connector priority
• Updated to @wagmi/core@8 and wagmi@9, support all new chain exports
• "installed" and "recent" connectors (close #690)
• Add presets for "Spot' wallet extension
• Add useWeb3ModalNetwork hook and associated actions in html package (close #762)
• Add support for "ABC Wallet" extension (close #735)

Full Changelog: https://github.com/WalletConnect/web3modal/compare/2.0.0-beta.8...2.0.0-beta.9