Tech Week

• feat: go back after network switch by @tomiir in https://github.com/WalletConnect/web3modal/pull/1540
• fix: network image access in account button and account page by @enesozturk in https://github.com/WalletConnect/web3modal/pull/1561
• fix: all wallets shimmer bug by @enesozturk in https://github.com/WalletConnect/web3modal/pull/1568
• fix: all wallets display count by @saintmaxi
• fix: build pipeline by @0xAsimetriq in https://github.com/WalletConnect/web3modal/pull/1567
• fix: syncing profile info on network switch by @enesozturk in https://github.com/WalletConnect/web3modal/pull/1563
• Fix/ethers chain currency by @svenvoskamp in https://github.com/WalletConnect/web3modal/pull/1571
• feat: installed icon box by @tomiir in https://github.com/WalletConnect/web3modal/pull/1550
• Chore/error hook ethers by @svenvoskamp in https://github.com/WalletConnect/web3modal/pull/1570
• Make chains required & remove 0 chain config by @glitch-txs in https://github.com/WalletConnect/web3modal/pull/1553
• Show copy link button when QR code is loaded by @svenvoskamp in https://github.com/WalletConnect/web3modal/pull/1575

New Contributors

• @tomiir made their first contribution in https://github.com/WalletConnect/web3modal/pull/1540
• @saintmaxi made his first contribution in https://github.com/WalletConnect/web3modal/pull/1499 (merged to another branch)

Full Changelog: https://github.com/WalletConnect/web3modal/compare/3.5.0...3.5.1

Email

• feat: Email resend functionality
• feat: Email "send action" throttling of 30s
• feat: Add and pass initial chain selection when connecting via email
• chore: Add custom logic / workaround to improve initial loading time when email login was not used beforehand
• chore: Handle ZodError format
• chore: Handle email iframe sdk loading error
• fix: Size issues when overlaying iframe "approve tx" view over modal
• chore: Various small ui updates to align with figma for email views
• feat: Add ui changes when only email connector is enabled
• feat: Add "Upgrade Wallet" view
• chore: Further build improvements, separating build:clean command from build
• chore: Update dependencies

Tech Week

• feat: go back after network switch by @tomiir in https://github.com/WalletConnect/web3modal/pull/1540
• fix: network image access in account button and account page by @enesozturk in https://github.com/WalletConnect/web3modal/pull/1561
• fix: all wallets shimmer bug by @enesozturk in https://github.com/WalletConnect/web3modal/pull/1568
• fix: build pipeline by @0xAsimetriq in https://github.com/WalletConnect/web3modal/pull/1567
• fix: syncing profile info on network switch by @enesozturk in https://github.com/WalletConnect/web3modal/pull/1563
• Fix/ethers chain currency by @svenvoskamp in https://github.com/WalletConnect/web3modal/pull/1571
• feat: installed icon box by @tomiir in https://github.com/WalletConnect/web3modal/pull/1550
• Chore/error hook ethers by @svenvoskamp in https://github.com/WalletConnect/web3modal/pull/1570
• Make chains required & remove 0 chain config by @glitch-txs in https://github.com/WalletConnect/web3modal/pull/1553
• Show copy link button when QR code is loaded by @svenvoskamp in https://github.com/WalletConnect/web3modal/pull/1575

New Contributors

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

Full Changelog: https://github.com/WalletConnect/web3modal/compare/3.5.0...3.6.0-alpha.0

• feat: Add @web3modal/siwe package, powering SIWE through a built-in Web3Modal UX.

Changes

• Add @web3modal/wallet to wagmi package
• Add default, siwe and email options to lab

Full Changelog: https://github.com/WalletConnect/web3modal/compare/3.5.0-alpha.0...3.5.0-alpha.1

Breaking Changes

N/A

Changes

• feat: Add @web3modal/wallet package, powering email login and iframe wallet sdk's
• feat: Add wui-notice-card component
• feat: Add enableWalletConnect, enableInjected, enableEIP6963, enableCoinbase, enableEmail options to default wagmi's defaultWagmiConfig to enable or disable default connectors. All options except enableEmail default to true
• feat: Add enableEmail option to default Ethers defaultConfig
• feat: Add JSXTypeUtil utility that can be imported in react projects to use all web3modal/ui web-components
• chore: Update dependencies
• chore: Update dangerfile to react only to index.ts file creation in ui package (creating style files for existing components triggered them to be viewed as new ones)

Associated Issues

N/A

Full Changelog: https://github.com/WalletConnect/web3modal/compare/3.4.0...3.5.0-alpha.0

Breaking Changes

• We deprecated useWeb3ModalSigner for ethers5 package. To align with v5 and v6 package, we chose to export raw provider. You can export the raw provider with useWeb3ModalProvider

Features

• Adding support for Ethers V6

Full Changelog: https://github.com/WalletConnect/web3modal/compare/3.3.2...3.4.0

Changes

• fix: update dayjs plugin module imports

Full Changelog: https://github.com/WalletConnect/web3modal/compare/3.3.1...3.3.2

Patch

• hotfix: Fix correct build

Full Changelog: https://github.com/WalletConnect/web3modal/compare/3.3.0...3.3.1

Breaking Changes

N/A

Changes

• feat: add web3modal/common monorepo package for common utilities, constants, types, etc.
• feat: add transaction history page
• feat: add transaction controller and API calls
• feat: add transaction controller and date utility tests
• feat: add new theme variables
• feat: add disconnect functions for ethers5
• refactor: update transaction list item component
• refactor: update transaction list item visual component
• refactor: update Storybook components
• refactor: update some primitive component rendering logics like wui-icon and wui-shimmer

Full Changelog: https://github.com/WalletConnect/web3modal/compare/3.2.1...3.3.0

Changes

• hotfix: fix vue reacitvity issues
• hotfix: fix ethers examples with new chain format

Resolves: https://github.com/WalletConnect/web3modal/issues/1460

Full Changelog: https://github.com/WalletConnect/web3modal/compare/3.2.0...3.2.1

Ethers.js V5 Support 🧪

• ethers.js V5 now supported by Web3Modal
• support for WalletConnectProvider
• support for InjectedProvider
• support for CoinbaseProvider
• support for EIP6963
• added several hooks/compositions/getters

Changes

• feat: created @web3modal/ethers5 package
• feat: added react hooks to get several properties
• feat: added vue compositions to get several properties
• feat: added vanillaJS getters to get several properties
• feat: Created utils package to store shared constants, presets and helpers
• feat: Created scaffold-react package to store shared react hooks
• feat: Created scaffold-vue package to store shared vue compositions
• feat: Created new react, vue and html examples with ethers.js
• chore: Update dependencies

Visit the docs for more info on how to use this new package

Full Changelog: https://github.com/WalletConnect/web3modal/compare/3.1.0...3.2.0

Ethers.js V5 Support 🧪

• ethers.js V5 now supported by Web3Modal
• support for WalletConnectProvider
• support for InjectedProvider
• support for CoinbaseProvider
• support for EIP6963
• added several hooks/compositions/getters

Changes

• feat: created @web3modal/ethers5 package
• feat: added react hooks to get several properties
• feat: added vue compositions to get several properties
• feat: added vanillaJS getters to get several properties
• feat: Created utils package to store shared constants, presets and helpers
• feat: Created scaffold-react package to store shared react hooks
• feat: Created scaffold-vue package to store shared vue compositions
• feat: Created new react, vue and html examples with ethers.js
• chore: Update dependencies

Visit the docs for more info on how to use this new package

Full Changelog: https://github.com/WalletConnect/web3modal/compare/3.1.0...3.2.0-alpha.1

Highlights ✨

• Multi injected providers now supported via eip6963
• New modal events system

Changes

• feat: Add web3modal events system

// Html usage
modal.getEvent() // get last event
modal.subscribeEvents(event => console.log(event)) // subscribe to events

// React usage
import {  useWeb3ModalEvents } from '@web3modal/wagmi/react'
const events = useWeb3ModalEvents()

// Vue usage
import {  useWeb3ModalEvents } from '@web3modal/wagmi/vue'
const events = useWeb3ModalEvents()

• feat: Synchronise eip6963 wallets with WalletConnect cloud data through rdns value
• feat: Add EIP6963Connector to defaults
• feat: Allow to disable recommended wallets by setting featuredIds: [] or customWallets: [] as empty
• feat: Add eip6963 rdns based checks and logic to deduplication utils
• fix: Don't show recommended wallets when featuredIds or customWallets are set
• fix: Allow to switch network when only 1 network is supported by dapp, but user is on un-supported one
• fix: Create custom createElement decorator for "lit" to add a check for already created web-components
• chore: Update styling for "Copy Link" button to make it less prominent
• chore: Rename various utility files for better consistency
• chore: Update dependencies
• chore: Improve ens and balance displays via #1372
• chore: Increase WalletConnect logo size in qrcode view via #1372

Associated Issues

closes #871
closes #1374
closes #1377
closes #1371

Full Changelog: https://github.com/WalletConnect/web3modal/compare/3.0.2...3.1.0

Changes

• feat: connectorImages option allowing you to set or override connector images based on their id. Does not affect wallets fetched from web3modal api (recommended). You will only need to use this when you remove metamask that comes in the modal by default and replace it with wagmi connector. For example:

createWeb3Modal({
   connectorImages: {
      coinbaseWallet: 'https://images.mydapp.com/coinbase.png',
      metamask: 'https://images.mydapp.com/metamask.png'
   }
})

• chore: Update dependencies

Full Changelog: https://github.com/WalletConnect/web3modal/compare/3.0.1...3.0.2

Changes

• fix: Add correct detection for Browser Wallet display / installed tag

Full Changelog: https://github.com/WalletConnect/web3modal/compare/3.0.0...3.0.1

Breaking Changes

Web3Modal v3 is a ground up re-write based on on feedback and experience we gathered from v2. It is a more efficient and lightweight sdk with multiple ux/ui improvements.

Due to this we had to make some breaking changes, but don't worry it only takes few minutes to update and we create a handy upgrade guide available at https://docs.walletconnect.com/2.0/web3modal/upgrade

What's new? ✨

• Overhauled design
• Unified experience on android, ios and desktop
• Ability to to use any platform supported by wallet (mobile, desktop, web or browser extension)
• Optimised new api delivering better performance and stability for web3modal data
• New and simpler theming options
• New and simpler to use npm package
• Native Vue support
• Reduced package size - by roughly ~35%
• Experimental support for https://eips.ethereum.org/EIPS/eip-6963 standard
• Simplified internal logic that will allow us to ship new features faster and with higher confidence
• Better and simpler defaults

And much much more!

Full Changelog: https://github.com/WalletConnect/web3modal/compare/2.4.7...3.0.0

Breaking Changes

• defaultWagmiConfig no longer takes in "appName" as an option, instead you can provide "metadata" like this:

export const wagmiConfig = defaultWagmiConfig({
  // ..
  metadata: {
    name: 'Web3Modal',
    description: 'Web3Modal Example',
    url: 'https://web3modal.com',
    icons: ['https://avatars.githubusercontent.com/u/37784886']
  }
})

Changes

• chore: Update dependencies
• fix: Add correct default export order in @web3modal/wagmi package
• chore: Round down total wallet count badge to nearest 10's
• fix: Add optionalDependencies for older yarn versions
• fix: Hide block explorer button when switching to a chain with undefined block explorer url

Experimental

Experimental support added for https://eips.ethereum.org/EIPS/eip-6963 standard, you can add Web3Modal's special connector as part of custom wagmi setup i.e.

import { EIP6963Connector } from '@web3modal/wagmi/react'

// or
// import { EIP6963Connector } from '@web3modal/wagmi/vue'
// import { EIP6963Connector } from '@web3modal/wagmi'

  createConfig({
    connectors: [
      new WalletConnectConnector({ chains, options: { projectId, showQrModal: false, metadata } }),
      new EIP6963Connector({chains}), // <-- Add new connector
      new InjectedConnector({ chains, options: { shimDisconnect: true } }),
      new CoinbaseWalletConnector({ chains, options: { appName: metadata?.name ?? 'Unknown' } })
    ]
    // ...
  })

Associated Issues

closes #1298
closes #1092

Full Changelog: https://github.com/WalletConnect/web3modal/compare/3.0.0-alpha.4...3.0.0-beta.5

Breaking Changes

N/A

Changes

• chore: If explorer url for connected chain is not available, don't show "Block Explorer" btn in account view
• fix: Use explicit index.js imports inside dynamic import() to fix some issues on older bundlers
• fix: Remove scrollbar-gutter adjustment, behaved differently in browsers and caused more issues than it solved
• chore: Use reactive on vue's useWeb3ModalState composable to avoid .value
• chore: Update dependencies
• chore: Improve and cleanup w3m-modal / wui-overlay layout
• fix: Overlay flickering on mobile safari
• fix: revert delay of mobile linking action, was causing issues on slower networks

Associated Issues

close #1343

Breaking Changes

N/A

Changes

• feat: Add IANA timezone based fallback to .org domains for web3modal and blockchain apis (including rpc provider in wagmi package)

• chore: Respect provided id order in featuredWalletIds option when displaying them in the modal

• chore: Updated dependencies

• chore: Delay mobile connection prompt slightly for better ux feel

• feat: Expose getState and subscribeState on modal i.e.

const modal = createWeb3Modal({})
const state = modal.getState()
// or
modal.subscribeState(( newState ) => console.log(newState))

• feat: Expose useWeb3ModalState hook from @web3modal/wagmi/react i.e

const state = useWeb3ModalState()

• feat: Expose useWeb3ModalState composable from @web3modal/wagmi/vue i.e.

const state = useWeb3ModalState()

• feat: Added new chainImages option to add or override network images i.e.

createWeb3Modal({
   // ...
   chainImages: {
      1: 'https://my.images.com/eth.png'
   }
})

Associated Issues

closes #1341
closes #1338
closes #1337

Full Changelog: https://github.com/WalletConnect/web3modal/compare/2.7.1...3.0.0-beta.3

Breaking Changes

N/A

Changes

• fix: fix z-index theme variable
• chore: New handling for light / dark mode that doesn't violate ssr rules (doesn't update html tag)
• chore: Update dependencies
• chore: Remove websocket provider from walletconnect rpc (not deemed production ready yet)
• feat: Add publicProvider() as a fallback to walletConenctProvider in defaultWagmiConfig helper (i.e. if our provider doesn't support a chain)

Associated Issues

N/A

Full Changelog: https://github.com/WalletConnect/web3modal/compare/2.7.1...3.0.0-beta.2