- #4042
b4d9ef79deb554ee20fed6666a474be5e7cdd522Thanks @tmm! - RemovedinjectedconnectorisAuthorizedtimeout.
9c862d8d63e3d692a22cef2a90782b74a9103f17Thanks @tmm! - Reverted internal module loading utility.
- #3816
06bb598a7f04c7b167f5b7ff6d46bd15886a6a14Thanks @marthendalnunes! - AddeddeployContractaction.
24a45b269bd0214a29d6f82a84ac66ef8c3f3822Thanks @tmm! - AddedSameSitedefault tocookieStorage
-
#4009
f2a7cefab96691ebed8b8e45ffde071c47b58dbeThanks @roninjin10! - Markedtoas optional forsendTransaction. -
#4023
f0ea0b2a7fe193dadfeb49a4c8031ee451c638b5Thanks @jxom! - Added chain check togetConnectorClientsince it's possible for connection state chain ID to get out of sync with the connector (e.g. wallet bug).
- #3970
030c7c2cb380dfd67a2182f62e2aa7a6e1601898Thanks @nanxiaobei! - FixedcookieStoragenot working across paths.
- #3984
51fde8a0433b4fff357c1a8d7e08b41b4c86c968Thanks @tmm! - FixedwriteContractquery types forvalueproperty.
- #3962
2804a8a583b1874271154898b4bae38756ef581cThanks @tmm! - Added catch toreconnect.
- #3940
a5071f581dfdfb961718873643a2fc629101c72aThanks @jxom! - Fixed usage ofmetaMaskconnector in Vite environments.
- Bumped versions.
- #3928
3117e71825f9c58a0d718f3d1686f1a191fa9cb1Thanks @tmm! - Updated the default Coinbase SDK incoinbaseWalletConnector to v4.x.
- #3906
32fcb4a31dde6b0206961d8ffe9c651f8a459c67Thanks @tmm! - Added support for Vue.
- #3924
1f58734f88458e0f6adb05c99f0c90f36ab286b8Thanks @jxom! - RefactoredisChainsStalelogic inwalletConnectconnector.
- #3917
05948fdad5bb4a56b08916d45b3dec2cb1e5f55bThanks @jxom! - Updated@metamask/sdk.
4fecbbb66d0aacd03b8c62a6455d11a33cde8f85Thanks @jxom! - Fixed address comparison ingetConnectorClient.
- #3910
e6139a97c4b8804d734b1547b5e3921ce01fbe24Thanks @tmm! - Added experimentalwallet_revokePermissionssupport toinjected.
- #3904
addca28ebc20f1a4367c35fe9ef786decff9c87eThanks @jxom! - Updated@walletconnect/ethereum-provider.
- #3902
204b7b624612405500ec098fb9e35facd3f74ca4Thanks @jxom! - Made third-party SDK imports type-only.
- #3869
d4a78eb0Thanks @jxom! - Fixed issue whereprepareTransactionRequestwould internally call unsupported wallet RPC methods.
- #3868
c2af20b8Thanks @jxom! - AddedsupportsSimulationproperty to connectors that indicates if the connector's wallet supports contract simulation.
- #3858
0d141f17Thanks @yulafezmesi! - Fixed accessing reverted reason property insidewaitForTransactionReceipt.
-
#3849
4781a405Thanks @tmm! - FixedshimDisconnect: falsebehavior. -
#3859
400c960bThanks @holic! - Added workaround to injected connector for MetaMask bug, where chain switching does not work if target chain RPC'net_version'request fails.
- #3822
a97bfbaeThanks @jxom! - Fixed an issue where Wagmi would not correctly rehydrate the active chain when a persisted store was being used.
-
#3777
b3b54ef1Thanks @desfero! - FixedwriteContractto forwardchainInwhen simulating contract call -
#3779
3da20bb8Thanks @jxom! - Fixed an issue whereeth_requestAccountswould be called upon reconnect instead ofeth_accounts. -
a3d1858fThanks @jxom! - Fixed hydration conditional increateConfig.
-
#3763
a59069e9Thanks @tmm! - FixedgetConnectorClientinternal address comparison. -
#3608
0acd3132Thanks @mqklin! - Disabledwallet_requestPermissionsprompt whenshimDisconnectisfalse.
dbdca8fdThanks @jxom! - Fixed issue where duplicate connectors could be instantiated if injected after page mount.
-
#3642
b479b5e8Thanks @johanneskares! - Fixed a bug where minification caused the wrong functions to be called on the client. -
f5648dd2Thanks @jxom! - UpdatedprepareTransactionRequesttypes forviem@2.8.0. -
1c1fee6aThanks @jxom! - Updated@walletconnect/ethereum-provider. -
#3653
88a2d744Thanks @tash-2s! - Fixed error occurring when adding chains without explorers to MetaMask.
- #3644
a91c0b64Thanks @nishuzumi! - Exported types
-
#3533
9c3b85ddThanks @tmm! - Fixedaccountproperty passthrough for actions. -
2a72214aThanks @tmm! - Shimmed EIP-1193removeListenerfor injected since some wallets do not follow spec.
-
#3519
414eb048Thanks @tmm! - Fixed multicall passing through all properties to Viem method. -
#3518
338e857dThanks @tmm! - Fixed internal store migration between versions.
-
#3510
660ff80dThanks @tmm! - Fixed issue where connectors returning multiple addresses didn't checksum correctly. -
#3433
101a7dd1Thanks @tmm! - FixedgetClientandgetPublicClientthrowing when used with unconfiguredchainId.
- #3461
ca98041dThanks @marthendalnunes! - AddedgetTransactionConfirmationsaction.
- #3427
370f1b4aThanks @marthendalnunes! - AddedprepareTransactionRequestaction.
- #3476
3be5bb7bThanks @jxom! - Modified persist strategy to only store "critical" properties that are needed before hydration.
- #3459
d950b666Thanks @marthendalnunes! - AddedgetEnsTextaction.
-
#3467
90ef39bbThanks @jxom! - Fixed an issue where connectors that share the same provider instance could reconnect when they have never been connected before. -
1cfb6e5aThanks @jxom! - Bumped listener limit on WalletConnect connector.
-
#3434
00bf10a4Thanks @marthendalnunes! - AddedgetBytecodeandgetStorageAtactions. -
#3416
64c073f6Thanks @marthendalnunes! - AddedgetTransactionReceiptaction. -
#3408
fb6c4148Thanks @marthendalnunes! - AddedgetProofaction.
- #3407
e00b8205Thanks @jxom! - Added a prelude gas estimate check tosendTransaction/useSendTransaction.
-
#3402
64b82282Thanks @Songkeys! - Fixed SSR cookie support for cookies that have special characters, e.g.=.
- #3387
c9cd302eThanks @marthendalnunes! - Addedcallaction.
- #3384
ee868c33Thanks @tmm! - Fixed connectors not bubbling error when connecting withchainIdand subsequent user rejection.
-
#3333
b3a0baaaThanks @tmm! - Wagmi Core 2.0 featuring:- Full TanStack Query support + queryKeys
- Connect multiple connectors
- Switch chains while disconnected
- EIP-6963 enabled
- Strongly typed chainId and chain properties
- Smaller bundle size
- Miscellaneous improvements and bug fixes
- Updated dependencies [
bbbbf587]:- @wagmi/connectors@3.1.11
-
53ca1f7eThanks @tmm! - Removed LedgerConnector due to security vulnerability -
Updated dependencies [
53ca1f7e]:- @wagmi/connectors@3.1.10
-
#3299
b02020b3Thanks @dasanra! - Fixed issue with Safe SDK by bumping@safe-global/safe-apps-provider@0.18.1 -
Updated dependencies [
51eca0fb,b02020b3]:- @wagmi/connectors@3.1.9
- Updated dependencies [
e8f7bcbc]:- @wagmi/connectors@3.1.8
-
#3276
83223a06Thanks @glitch-txs! - Removed required namespaces from WalletConnect connector -
Updated dependencies [
83223a06]:- @wagmi/connectors@3.1.7
- Updated dependencies [
a1950449]:- @wagmi/connectors@3.1.5
- Updated dependencies [
4e6ec415]:- @wagmi/connectors@3.1.4
- Updated dependencies [
e78aa337]:- @wagmi/connectors@3.1.3
- #3125
725e73feThanks @lukasrosario! - Fixed an issue wheredataSuffixwas not being passed down into viem'ssimulateContract, causing the data to be omitted from requests.
-
#3076
4c36831bThanks @jxom! - Passchainto viemsendTransaction/writeContract. -
#3006
f2ddce23Thanks @jxom! - Changednormalizeto a dynamic import.
- Updated dependencies [
3aaba328]:- @wagmi/connectors@3.1.2
- Updated dependencies [
bf831bb3]:- @wagmi/connectors@3.1.1
- Updated dependencies [
2abeb285]:- @wagmi/connectors@3.1.0
- #2619
0d79748cThanks @jxom! - Updated references:- Updated
@safe-global/safe-apps-sdkto^8.0.0(the one withviemsupport)
- Updated
-
#2589
9680c347Thanks @jxom! - FixedwriteContractparameters to be compatible withprepareWriteContract.
- #2433
54fcff5fThanks @jxom! - Added ability to pass anaccounttowriteContract/prepareWriteContract.
- #2338
92bfdc2cThanks @jxom! - Fixed an issue where synchronous switch chain behavior (WalletConnect v2) would encounter chain id race conditions inwatchWalletClient.
-
Updated dependencies [
ea651cd7]:- @wagmi/connectors@1.0.1
- #2235
5be0655cThanks @jxom! - Released v1. Read Migration Guide.
-
#2235
708b2ce2Thanks @jxom! - Addedconfig.setPublicClient&config.setWebSocketPublicClient -
Updated references.
- Updated dependencies []:
- @wagmi/connectors@1.0.0-next.5
-
#2235
708b2ce2Thanks @jxom! - Addedconfig.setPublicClient&config.setWebSocketPublicClient -
Added
config.setConnectors
- Updated dependencies []:
- @wagmi/connectors@1.0.0-next.6
- Updated viem.
Removed
goerliexport from main entrypoint.
- Updated dependencies []:
- @wagmi/connectors@1.0.0-next.5
- Updated references.
- Updated dependencies []:
- @wagmi/connectors@1.0.0-next.4
- Breaking: Renamed
createClienttocreateConfig - Breaking: Renamed
getClienttogetConfig - Breaking: Removed
requestas an argument toprepareSendTransaction&sendTransation. Arguments now belong on the root level of the Action.
- Updated dependencies []:
- @wagmi/chains@1.0.0-next.0
- @wagmi/connectors@1.0.0-next.3
- updated viem
- Updated dependencies []:
- @wagmi/connectors@1.0.0-next.2
- Updated dependencies [
a7dda00c]:- @wagmi/connectors@1.0.0-next.1
-
Updated dependencies []:
- @wagmi/connectors@0.3.19
-
#2208
cfc696d8Thanks @bangtoven! - Bumped references to apply coinbase wallet sdk updates -
Updated dependencies []:
- @wagmi/connectors@0.3.16
-
Updated dependencies []:
- @wagmi/connectors@0.3.12
-
#2099
f1fee5b3Thanks @jxom! - Added chains:nexipolygonZkEvmxdcxdcTestnet
-
#2085
7d64e3f5Thanks @jxom! - Fixed an issue where multicall would not throw if the target chain was not configured on the wagmi client. -
Updated dependencies []:
- @wagmi/connectors@0.3.10
-
Updated dependencies []:
- @wagmi/connectors@0.3.10
-
#2053
665df1bfThanks @tmm! - Fixed issue where you add a new chain to MetaMask, but the switch after is rejected. -
Updated dependencies []:
- @wagmi/connectors@0.3.7
-
Updated dependencies []:
- @wagmi/connectors@0.3.6
-
#2043
49a58320Thanks @tmm! - RemovedInjectedConnectorshimChainChangedDisconnectshim (no longer necessary). -
Updated dependencies []:
- @wagmi/connectors@0.3.6
-
#2016
06bf61deThanks @jxom! - Added chains:bobachronoscrossbelldfkdogechainflareflareTestnetklaytnscrollTestnetshardeumSphinxskaleCalypsoskaleCalypsoTestnetskaleChaosTestnetskaleCryptoBladesskaleCryptoColosseumskaleEuropaskaleEuropaTestnetskaleExordeskaleHumanProtocolskaleNebulaskaleNebulaTestnetskaleRazorskaleTitanskaleTitanTestnetsongbirdsongbirdTestnettitantitanTestnetwanchainwanchainTestnet
-
#2016
06bf61deThanks @jxom! - Updated references/ submodule. -
Updated dependencies []:
- @wagmi/connectors@0.3.4
-
#1902
0994e896Thanks @jxom! - Breaking: Removed theversionconfig option forWalletConnectConnector.WalletConnectConnectornow uses WalletConnect v2 by default. WalletConnect v1 is nowWalletConnectLegacyConnector.import { WalletConnectConnector } from 'wagmi/connectors/walletConnect' const connector = new WalletConnectConnector({ options: { - version: '2', projectId: 'abc', }, })-import { WalletConnectConnector } from 'wagmi/connectors/walletConnect' +import { WalletConnectConnector } from 'wagmi/connectors/walletConnectLegacy' -const connector = new WalletConnectConnector({ +const connector = new WalletConnectLegacyConnector({ options: { qrcode: true, }, })
- Updated dependencies []:
- @wagmi/connectors@0.3.2
-
#1907
cc4e74eeThanks @jxom! - Added the following chains to thewagmi/chainsentrypoint:baseGoerliharmonyOnepolygonZkEvmTestnet
-
Updated dependencies []:
- @wagmi/connectors@0.2.7
-
#1812
c7fd7fbdThanks @jxom! - Added the following chains to thewagmi/chainsentrypoint:filecoinCalibrationmoonbaseAlphamoonbeammoonriver
-
Updated dependencies []:
- @wagmi/connectors@0.2.5
-
#1786
b173a431Thanks @tmm! - Locked ethers peer dependency version to >=5.5.1 <6 -
Updated dependencies []:
- @wagmi/connectors@0.2.4
-
#1773
9aaf1955Thanks @jxom! - Updated@walletconnect/universal-provideronWalletConnectConnectorv2. Added more signable methods toWalletConnectConnectorv2. -
#1773
9aaf1955Thanks @jxom! - Added Telos to thewagmi/chainsentrypoint. Thanks @donnyquixotic! -
Updated dependencies []:
- @wagmi/connectors@0.2.3
-
#1756
31d06b8cThanks @jxom! - Added OKC Chain. Thanks @clark-cui! -
#1756
31d06b8cThanks @jxom! - Fixed race condition betweenswitchNetworkand mutation Actions that usechainId(e.g.sendTransaction). Thanks @DanInTheD4rk! -
Updated dependencies []:
- @wagmi/connectors@0.2.2
-
#1752
144a0e76Thanks @jxom! - ImprovedWalletConnectConnector(v2) initialization & updated dependencies. -
#1752
144a0e76Thanks @jxom! - Added the following chains to thewagmi/chainsentrypoint:- Aurora – thanks @salil-naik
- Bronos – thanks @chedetinaveen
- Canto – thanks @tster
- Celo – thanks @aaronmgdr
-
Updated dependencies []:
- @wagmi/connectors@0.2.1
- #1732
01e21897Thanks @tmm! - Bumped minimum TypeScript version to typescript@>=4.9.4. TypeScript 5.0 is coming soon and has some great features we are excited to bring into wagmi. To prepare for this, update your TypeScript version to 4.9.4 or higher. There are likely no breaking changes if you are coming from typescript@4.7.x || typescript@4.8.x.
-
#1705
9ff797dcThanks @jxom! - Added the following chains to the@wagmi/core/chainsentrypoint:crossbell(thanks @Songkeys)filecoin&filecoinHyperspace(thanks @neil0x46dc)gnosisChiado(thanks @theNvN)metis&metisGoerli(thanks @CookedCookee)
- #1685
917f5bc1Thanks @jxom! - Replaced qrcodemodal with web3modal for the WalletConnect v2 Connector.
- #1636
025f6771Thanks @DanielSinclair! - AddedisRainbowflag to injectedwindow.ethereumtypes.
-
#1570
216f585bThanks @wslyvh! - AddedwatchPendingTransactions -
#1470
3a1a6c9fThanks @jxom! - TheWalletConnectConnectornow supports WalletConnect v2.It can be enabled by setting
versionto'2'and supplying a WalletConnect CloudprojectId.
-
#1539
732da004Thanks @0xFlicker! - All Providers (ie. Alchemy, Infura, Public) now use the ENS Registry address on the wagmiChainobject (chain.contracts.ensRegistry). -
#1574
ecde3d10Thanks @jxom! - Added the following chains:iotexiotexTestnetzkSynczkSyncTestnet
-
#1542
731b3b73Thanks @jxom! - Added the following chains:evmosevmosTestnetgnosis
-
#1542
731b3b73Thanks @jxom! - Updated Goerli symbol to"ETH". -
#1542
731b3b73Thanks @jxom! - Updated Arbitrum Goerli RPC and Block Explorer. -
#1542
731b3b73Thanks @jxom! - Fixed issue where connecting to MetaMask may return with a stale address. -
#1542
731b3b73Thanks @jxom! - Removed ENS registry for Sepolia.
-
#1508
0b50b62fThanks @jxom! - Updated@wagmi/chainsto0.1.3. -
#1504
11b8b794Thanks @tmm! - Converted ethers custom "ACTION_REJECTED" error to standard RPC Error.
-
#1431
af28f8f9Thanks @jxom! - Re-export connectors from@wagmi/connectors -
#1431
af28f8f9Thanks @jxom! - AddedLedgerConnectorconnector
-
#1442
cde15289Thanks @0xproflupin! - Added Phantom wallet support toInjectedConnector -
#1444
310a8bc4Thanks @jxom! - Assert that aconnectorexists before invoking the callback inwatchSigner. -
#1434
100e2a3bThanks @tmm! - UpdatedMockConnectorchainIdbehavior to default to first chain fromchainsif not provided inoptions.
-
#1437
c34a3dc6Thanks @jxom! - Omitted"EIP712Domain"type fromsignTypedDatatypesarg since ethers throws an internal error if you include it. -
#1445
51dd53cbThanks @jxom! - Fixed an issue where the wagmi client wouldn't rehydrate the store in local storage whenautoConnectis truthy.
-
#1344
57a19374Thanks @jxom! - Breaking: the shape of theChaintype has been modified.The
rpcUrlsshape has changed to include an array of URLs, and also the transport method (httporwebSocket):type Chain = { ... rpcUrls: { - [key: string]: string + [key: string]: { + http: string[] + webSocket: string[] + } } ... }Note that you will also need to ensure that usage is migrated:
- const rpcUrl = mainnet.rpcUrls.alchemy + const rpcUrl = mainnet.rpcUrls.alchemy.http[0]
The
multicallandensattributes have been moved into thecontractsobject:type Contract = { address: Address blockCreated?: number } type Chain = { ... - multicall: Contract - ens: Contract + contracts: { + multicall3: Contract + ensRegistry: Contract + } ... }Note that you will also need to ensure that usage is migrated:
- const multicallContract = mainnet.multicall + const multicallContract = mainnet.contracts.multicall3
-
#1344
57a19374Thanks @jxom! - Breaking: Upgraded@coinbase/wallet-sdkpeer dependency to3.6.0.Migration steps: Update
@coinbase/wallet-sdkto^3.6.0. -
#1344
57a19374Thanks @jxom! - Breaking: Removed thewaitargument onwaitForTransaction. Use the transactionhashinstead.const data = await waitForTransaction({ - wait: transaction.wait + hash: transaction.hash }) -
#1344
57a19374Thanks @jxom! - Breaking: With the introduction of the@wagmi/core/chainsentrypoint,@wagmi/coreno longer exports the following:chainallChainsdefaultChainsdefaultL2ChainschainIdetherscanBlockExplorersalchemyRpcUrls,infuraRpcUrls,publicRpcUrls
Read below for migration steps.
The
chainexport has been removed.@wagmi/corenow only exports themainnet&goerlichains. If you need to use an alternative chain (polygon,optimism, etc), you will need to import it from the@wagmi/core/chainsentrypoint.import { - chain configureChains } from '@wagmi/core' + import { mainnet, polygon, optimism } from '@wagmi/core/chains' const { ... } = configureChains( - [chain.mainnet, chain.polygon, chain.optimism], + [mainnet, polygon, optimism], { ... } )The
allChainsexport has been removed. If you need a list of all chains, you can utilize@wagmi/core/chainsentrypoint.- import { allChains } from '@wagmi/core' + import * as allChains from '@wagmi/core/chains' const { ... } = configureChains(allChains, ...)
The
defaultChains&defaultL2Chainsexports have been removed. If you still need thedefaultChainsordefaultL2Chainsexports, you can build them yourself:- import { defaultChains } from '@wagmi/core' + import { mainnet, goerli } from '@wagmi/core/chains' + const defaultChains = [mainnet, goerli]
The
defaultChainsexport was previously populated withmainnet&goerli.- import { defaultL2Chains } from '@wagmi/core' + import { + arbitrum, + arbitrumGoerli, + polygon, + polygonMumbai, + optimism, + optimismGoerli + } from '@wagmi/core/chains' + const defaultL2Chains = [ + arbitrum, + arbitrumGoerli, + polygon, + polygonMumbai, + optimism + optimismGoerli + ]
The
defaultL2Chainsexport was previously populated witharbitrum&optimism.The
chainIdexport has been removed. You can extract a chain ID from the chain itself.- import { chainId } from '@wagmi/core' + import { mainnet, polygon, optimism } from '@wagmi/core/chains' -const mainnetChainId = chainId.mainnet -const polygonChainId = chainId.polygon -const optimismChainId = chainId.optimism +const mainnetChainId = mainnet.chainId +const polygonChainId = polygon.chainId +const optimismChainId = optimism.chainId
The
etherscanBlockExplorersexport has been removed. You can extract a block explorer from the chain itself.- import { etherscanBlockExplorers } from '@wagmi/core' + import { mainnet, polygon, optimism } from '@wagmi/core/chains' -const mainnetEtherscanBlockExplorer = etherscanBlockExplorers.mainnet -const polygonEtherscanBlockExplorer = etherscanBlockExplorers.polygon -const optimismEtherscanBlockExplorer = etherscanBlockExplorers.optimism +const mainnetEtherscanBlockExplorer = mainnet.blockExplorer +const polygonEtherscanBlockExplorer = polygon.blockExplorer +const optimismEtherscanBlockExplorer = optimism.blockExplorer
The
alchemyRpcUrls,infuraRpcUrls&publicRpcUrlsexports have been removed. You can extract a RPC URL from the chain itself.- import { alchemyRpcUrls, infuraRpcUrls, publicRpcUrls } from '@wagmi/core' + import { mainnet } from '@wagmi/core/chains' -const mainnetAlchemyRpcUrl = alchemyRpcUrls.mainnet -const mainnetInfuraRpcUrl = infuraRpcUrls.mainnet -const mainnetOptimismRpcUrl = publicRpcUrls.mainnet +const mainnetAlchemyRpcUrl = mainnet.rpcUrls.alchemy +const mainnetInfuraRpcUrl = mainnet.rpcUrls.infura +const mainnetOptimismRpcUrl = mainnet.rpcUrls.optimism
-
#1344
57a19374Thanks @jxom! - Breaking: ChangedwaitForTransactionbehavior to throw an error if the transaction reverted. -
#1344
57a19374Thanks @jxom! - Updated errors to usecauseinstead ofinternal
-
#1344
57a19374Thanks @jxom! -waitForTransactionnow respects repriced (sped up) transactions. -
#1344
57a19374Thanks @jxom! -waitForTransactionnow throws an error for cancelled or replaced transactions.
- #1411
659be184Thanks @tmm! - Fixed issue where block invalidation was not properly disabled when settingenabled: false.
-
#1406
4f18c450Thanks @tmm! - Function for selecting the EIP-1193 Ethereum Provider to target. Defaults to() => typeof window !== 'undefined' ? window.ethereum : undefined.import { InjectedConnector } from "@wagmi/core/connectors/injected"; const connector = new InjectedConnector({ options: { name: "My Injected Wallet", getProvider: () => typeof window !== "undefined" ? window.myInjectedWallet : undefined, }, });
-
#1386
206a2adbThanks @jxom! - Fixed an issue wherepersisterwould still usewindow.localStorageinstead of the wagmistorage. -
#1376
a70a9528Thanks @jxom! - Fixed issue whereswitchChainonWalletConnectConnectorwould not resolve. -
#1386
206a2adbThanks @jxom! - Addedserialize/deserializeas config options tocreateStorage. -
#1392
88afc849Thanks @tmm! - Added check for active connector when connecting
- #1384
027e88d6Thanks @tmm! - Fixed issue reconnecting after disconnect withMetaMaskConnectorin MetaMask mobile browser.
- #1294
b2f88949Thanks @tmm! - Setabireturn type value forprepareContractWriteas more permissive when not inferrable asAbi.
-
#1202
9bf56afThanks @tmm! - Breaking: Removed the following deprecated chains:ropstenrinkebykovanoptimismKovanarbitrumRinkeby
If you feel you still need to include one of these testnets in your application, you will have to define it manually:
-import { rinkeby } from 'wagmi' +import { Chain } from 'wagmi' +export const rinkeby: Chain = { + id: 4, + name: 'Rinkeby', + network: 'rinkeby', + nativeCurrency: { name: 'Rinkeby Ether', symbol: 'ETH', decimals: 18 }, + rpcUrls: { + alchemy: 'https://eth-rinkeby.alchemyapi.io/v2', + default: 'https://rpc.ankr.com/eth_rinkeby', + infura: 'https://rinkeby.infura.io/v3', + public: 'https://rpc.ankr.com/eth_rinkeby', + }, + blockExplorers: { + etherscan: 'https://rinkeby.etherscan.io', + default: 'https://rinkeby.etherscan.io', + }, + ens: { + address: '0x00000000000C2E074eC69A0dFb2997BA6C7d2e1e', + }, + multicall: { + address: '0xca11bde05977b3631167028862be2a173976ca11', + blockCreated: 10299530, + }, + testnet: true, }
You can reference these removed chains here.
-
#1202
9bf56afThanks @tmm! - Breaking:addressOrNamerenamed toaddressforfetchBalanceandfetchEnsAvatar.const result = await fetchBalance({ - addressOrName: '0x…', + address: '0x…', })If you were using an ENS name instead of an address, you can resolve the name to an address before passing it to the action.
+ const { data: address } = await fetchEnsAddress({ name: 'example.eth' }) const result = await fetchBalance({ - addressOrName: 'example.eth', + address, })
-
#1202
9bf56afThanks @tmm! - Breaking: MadeapiKeyrequired oninfuraProviderandalchemyProvider.import { configureChains } from 'wagmi' const config = configureChains(defaultChains, [ - alchemyProvider(), + alchemyProvider({ apiKey: process.env.ALCHEMY_API_KEY }) ])You can find your Alchemy API key from the Alchemy Dashboard, or your Infura API key from the Infura Dashboard.
- #1232
c0ca509Thanks @tmm! - Added validation to check that chain is configured for connector when accessingSigner.
- #1207
c73d463Thanks @lvshaoping007! - Added Kucoin wallet support toInjectedConnector
-
#1132
d41c0d6Thanks @toniocodo! - Added ERC-4626 ABI -
#1201
9a07efaThanks @jxom! - Fixed issue where non-checksum addresses did not resolve with an ENS name
-
#1174
196a458Thanks @jxom! - Fixed an issue whereclient.chains(active connector chains) would be populated when there is no active connector (disconnected user). -
#1176
389765fThanks @jxom! - Migrate away from Alchemy RPC URLs in the public RPC URL list
-
81ce9e6Thanks @jxom! - AddisPortalto injected MetaMask flags. -
c2c0109Thanks @jxom! - Add etherscan block explorer to Optimism Goerli
-
#1162
30335b3Thanks @tmm! - Fixed issue where non-indexed event parameter types were set tonull. -
#1162
30335b3Thanks @tmm! - Fixed issue whereuseContractReadsanduseContractInfiniteReadstypes were slowing down TypeScript compiler.
- #1074
8db807fThanks @IljaDaderko! - ExportedEventListenertype
-
#940
b6cb8f4Thanks @jxom! - Breaking:watchSignernow requires an arguments object (that accepts an optionalchainId) as it's first parameter.import { watchSigner } from `@wagmi/core` -watchSigner(signer => { +watchSigner({}, signer => { console.log('new signer!', signer) }) -
#940
b6cb8f4Thanks @jxom! - Breaking:prepareSendTransactionnow throws when achainIdis specified and the end-user is on a different chain id (the wrong network). -
#941
0c96009Thanks @tmm! - Breaking:addressOrNameandcontractInterfacerenamed toaddressandabirespectively for contract actions:getContract,multicall,prepareWriteContract,readContract,readContracts,watchContractEvent,watchMulticall,watchReadContract,watchReadContracts,writeContract.import { readContract } from '@wagmi/core' const result = await readContract({ - addressOrName: '0x…', + address: '0x…', - contractInterface: […] as const, + abi: […] as const, functionName: 'balanceOf', args: ['0x…'], })If you were using an ENS name instead of an address, you can resolve the name to an address before passing it to the action.
- import { readContract } from '@wagmi/core' + import { fetchEnsAddress, readContract } from '@wagmi/core' + const address = await fetchEnsAddress('example.eth') const result = await readContract({ - addressOrName: 'example.eth', + address, abi: […] as const, functionName: 'balanceOf', args: ['0x…'], })
-
#940
b6cb8f4Thanks @jxom! - Breaking:prepareWriteContractnow throws when achainIdis specified and the end-user is on a different chain id (the wrong network). -
#940
b6cb8f4Thanks @jxom! - Breaking:prepareSendTransactionnow only accepts asignerinstead ofsignerOrProvider.This is to reach parity with
prepareWriteContract.If no
signeris provided, wagmi will use the signer that is currently connected. If no user is connected, thenprepareWriteContractwill throw an error. -
#941
0c96009Thanks @tmm! - Breaking:argsconfig option must now be an array for the following actions:readContract,writeContract,prepareWriteContract,multicall,readContracts,watchMulticall, andwatchReadContracts.import { readContract } from '@wagmi/core' const result = await readContract({ address: '0x…', abi: […], functionName: 'balanceOf', - args: '0x…', + args: ['0x…'], }) -
#941
0c96009Thanks @tmm! - Breaking:watchContractEventnow accepts a configuration object and callback instead of positional arguments.import { watchContractEvent } from '@wagmi/core' - const unsubscribe = watchContractEvent( - { - address: '0x…', - abi: […], - }, - 'Transfer', - (from, to, tokenId) => { - // ... - }, - { once: true }, - ) + const unsubscribe = watchContractEvent( + { + address: '0x…', + abi: […], + eventName: 'Transfer', + once: true, + }, + (from, to, tokenId) => { + // ... + }, + ) -
#941
0c96009Thanks @tmm! - Breaking: Updated TypeScript version totypescript@>=4.7.4.@wagmi/corecan now infer types based on ABI and EIP-712 Typed Data definitions, giving you full end-to-end type-safety from your contracts to your frontend and incredible developer experience (e.g. autocomplete contract function names and catch misspellings, type contract function arguments, etc.).For this to work, you must upgrade to
typescript@>=4.7.4. Why is TypeScript v4.7.4 or greater necessary? TypeScript 4.7.4 introduced the ability to extend constraints on inferred type variables, which is used extensively to help narrow types for ABIs. Good news! When upgrading TypeScript from 4.6 to 4.7 there are likely no breaking changes for your set up. -
#941
0c96009Thanks @tmm! - Breaking: Updated TypeScript generics for contract interaction and typed data actions.Adding a const assertion to
abiallows TypeScript to inferfunctionName,args,overrides, and return types for functions, andeventNameandlistenertypes for events.import { readContract } from '@wagmi/core' const result = await readContract({ address: '0x…', - abi: […], + abi: […] as const, functionName: 'balanceOf', // will autocomplete and catch typos args: ['0x…'], // inferred based on `functionName` }) result // inferred based on `functionName`This works for the following actions:
readContract,writeContract,prepareWriteContract,multicall,readContracts,watchMulticall,watchReadContracts, andwatchContractEvent.Adding a const assertion to
signTypedData's config option,types, allows TypeScript to infervalue.import { signTypedData } from '@wagmi/core' const result = await signTypedData({ domain: { name: 'Ether Mail', version: '1', chainId: 1, verifyingContract: '0xCcCCccccCCCCcCCCCCCcCcCccCcCCCcCcccccccC', }, types: { Person: [ { name: 'name', type: 'string' }, { name: 'wallet', type: 'address' }, ], Mail: [ { name: 'from', type: 'Person' }, { name: 'to', type: 'Person' }, { name: 'contents', type: 'string' }, ], - }, + } as const, value: { // `value` is inferred based on `types` from: { name: 'Cow', wallet: '0xCD2a3d9F938E13CD947Ec05AbC7FE734Df8DD826', }, to: { name: 'Bob', wallet: '0xbBbBBBBbbBBBbbbBbbBbbbbBBbBbbbbBbBbbBBbB', }, contents: 'Hello, Bob!', }, })
-
#1061
a4ffe8bThanks @alecananian! - Added Arbitrum Goerli Arbiscan block explorer -
#940
b6cb8f4Thanks @jxom! - ThefetchSigneraction now accepts an optionalchainIdto use for signer initialization as an argument.import { fetchSigner } from "@wagmi/core"; import { optimism } from "@wagmi/core/chains"; // ... fetchSigner({ chainId: optimism.id });
-
#1048
ed13074Thanks @Max-3-7! - Added support for Avalanche core wallet -
#1046
ab9ecaaThanks @jxom! - make ethers block format validator compatible with Celo -
#1050
73d4d47Thanks @jxom! - update dependencieszustand@4.1.1
aa51bc4dThanks @jxom! - Fixed an issue inCoinbaseWalletConnectorwhere the browser extension would unintendedly reset the network when the browser is refreshed.
- #955
e326cd80Thanks @0xFlicker! - Added Infura RPC URL for Sepolia
cec14089Thanks @jxom! - Fixed an issue whereuseProvider&getProviderwere not returning referentially equal providers.
cec14089Thanks @jxom! - Fixed an issue where thewatchoption was not respecting the neighboringchainIdoption inuseBlockNumber.
cec14089Thanks @jxom! - Fixed an issue where block listeners (viawatch) were firing excessively on L2 chains.
-
#936
3329d1fThanks @jxom! - Added the ability to provide a custom logger to override how logs are broadcasted to the consumer in wagmi.A custom logger can be provided to the wagmi client via
logger.logger?: { warn: typeof console.warn | null }
Passing in a custom logger
You can pass in a function to define your own custom logger.
+ import { logWarn } from './logger'; const client = createClient({ ... + logger: { + warn: message => logWarn(message) + } ... })
Disabling a logger
You can disable a logger by passing
nullas the value.const client = createClient({ ... + logger: { + warn: null + } ... })
-
#912
e529e12Thanks @zouhangwithsweet! - Added BitKeep to injected flags -
#912 Thanks @mytangying! - Added MathWallet to injected flags
-
#904
c231058Thanks @jxom! - Minimized contract interface returned fromprepareWriteContract.
- #767
e9392f3Thanks @klyap! - Add Optimism Goerli chain ahead of Kovan deprecation.
- #817
7e5cac7Thanks @alecananian! - Added custom name mapping for 1inch Wallet injected provider
- #806
0b34e56Thanks @vmichalik! - Fix canonical testnet native asset symbols by changing them to ETH
-
#658
d70c115Thanks @jxom! - Breaking: The configuration passed to thesendTransactionaction now needs to be:- prepared with the
prepareSendTransactionaction (new functionality), or - recklessly unprepared (previous functionality)
Why? Read here
import { prepareSendTransaction, sendTransaction } from '@wagmi/core' +const config = await prepareSendTransaction({ + request: { + to: 'moxey.eth', + value: parseEther('1'), + } +}) const result = await sendTransaction({ - request: { - to: 'moxey.eth', - value: parseEther('1') - } + ...config })It is possible to use
sendTransactionwithout preparing the configuration first by passingmode: 'recklesslyUnprepared'.import { sendTransaction } from '@wagmi/core' const result = await sendTransaction({ + mode: 'recklesslyUnprepared', request: { to: 'moxey.eth', value: parseEther('1'), } }) - prepared with the
-
#760
d8af6bfThanks @tmm! - Breaking:alchemyProviderandinfuraProvidernow use a genericapiKeyconfiguration option instead ofalchemyIdandinfuraId.import { alchemyProvider } from '@wagmi/core/providers/alchemy' import { infuraProvider } from '@wagmi/core/providers/infura' alchemyProvider({ - alchemyId: 'yourAlchemyApiKey', + apiKey: 'yourAlchemyApiKey', }) infuraProvider({ - infuraId: 'yourInfuraApiKey', + apiKey: 'yourInfuraApiKey', })
-
#727
ac3b9b8Thanks @tmm! - Breaking: Moved thepollingIntervalconfig option from the chain provider config toconfigureChainsconfig.const { chains, provider } = configureChains( [chain.mainnet, chain.polygon], [ - alchemyProvider({ apiKey, pollingInterval: 5000 }), - publicProvider({ pollingInterval: 5000 }) + alchemyProvider({ apiKey }), + publicProvider() ], + { pollingInterval: 5000 } )
-
#658
d70c115Thanks @jxom! - Breaking: ThesendTransactionaction now returns an object only consisting ofhash&wait, and not the fullTransactionResponse.If you require the full
TransactionResponse, you can usefetchTransaction:import { sendTransaction, fetchTransaction } from '@wagmi/core' const { hash, wait, - ...transaction } = sendTransaction(...) +const transaction = fetchTransaction({ hash })Why? The old implementation of
sendTransactioncreated a long-running async task, causing UX pitfalls when invoked in a click handler.
-
#658
d70c115Thanks @jxom! - Breaking: If achainIdis passed towriteContractorsendTransaction, it will no longer attempt to switch chain before sending the transaction. Instead, it will throw an error if the user is on the wrong chain.Why?
- Eagerly prompting to switch chain in these actions created a long-running async task that that makes iOS App Links vulnerable.
- Not all wallets support programmatic chain switching.
-
#658
d70c115Thanks @jxom! - Breaking: The configuration passed to thewriteContractaction now needs to be:- prepared with the
prepareWriteContractaction (new functionality), or - recklessly unprepared (previous functionality)
Why? Read here
import { prepareWriteContract, writeContract } from '@wagmi/core' const tokenId = 69 +const config = await prepareWriteContract({ + addressOrName: '0x...', + contractInterface: wagmiAbi, + functionName: 'mint', + args: [tokenId] +}) const result = await writeContract({ - addressOrName: '0x...', - contractInterface: wagmiAbi, - functionName: 'mint', - args: [tokenId], + ...config })It is possible to use
writeContractwithout preparing the configuration first by passingmode: 'recklesslyUnprepared'.import { writeContract } from '@wagmi/core' const tokenId = 69 const result = await writeContract({ + mode: 'recklesslyUnprepared', addressOrName: '0x...', contractInterface: wagmiAbi, functionName: 'mint', args: [tokenId], }) - prepared with the
-
#658
d70c115Thanks @jxom! - Added theprepareSendTransactionhook that prepares the parameters required for sending a transaction.It returns config to be passed through to
sendTransaction.import { prepareSendTransaction, sendTransaction } from "@wagmi/core"; const config = await prepareSendTransaction({ request: { to: "moxey.eth", value: parseEther("1"), }, }); const result = await sendTransaction(config);
-
#658
d70c115Thanks @jxom! - Added theprepareWriteContracthook that prepares the parameters required for a contract write transaction.It returns config to be passed through to
writeContract.Example:
import { prepareWriteContract, writeContract } from "@wagmi/core"; const config = await prepareWriteContract({ addressOrName: "0x...", contractInterface: wagmiAbi, functionName: "mint", }); const result = await writeContract(config);
-
#759
959953dThanks @tmm! - AddedfetchTransactionaction:import { fetchTransaction } from "@wagmi/core"; const transaction = await fetchTransaction({ hash: "0x5c504ed432cb51138bcf09aa5e8a410dd4a1e204ef84bfed1be16dfba1b22060", });
- #721
abea25fThanks @tmm! - Stay connected to existingclient.connectorwhenconnectaction fails to connect to new connector.
- #693
56e468cThanks @markdalgleish! - Fix import errors with Coinbase Wallet SDK in Vite
- #616
7a7a17aThanks @tmm! - AddsUNSTABLE_shimOnConnectSelectAccountflag. With this flag and "disconnected" withshimDisconnectenabled, the user is prompted to select a different MetaMask account (than the currently connected account) when trying to connect (e.g.useConnect/connectaction).
- #622
d171581Thanks @tmm! - Usedomain.chainIdto validate and switch chain before signing insignTypedData.
- #618
a5138e8Thanks @tmm! - Fix adding chains when using MetaMask mobile app, addpublicRpcUrlsconstant, and default to public endpoint when adding chain.
-
fc94210Thanks @jxom! - Breaking: Theproviderconfig option is now required oncreateClient. It is recommended to pass theprovidergiven fromconfigureChains.import { createClient, + defaultChains, + configureChains } from 'wagmi' +import { publicProvider } from 'wagmi/providers/publicProvider' +const { provider } = configureChains(defaultChains, [ + publicProvider +]) const client = createClient({ + provider })If you previously used an ethers.js Provider, you now need to provide your
chainson the Provider instance:import { createClient, + defaultChains } from 'wagmi' import ethers from 'ethers' const client = createClient({ - provider: getDefaultProvider() + provider: Object.assign(getDefaultProvider(), { chains: defaultChains }) })
4f8f3c0Thanks @nachoiacovino! - Use ethereum-lists chains symbols
-
fc94210Thanks @jxom! - Breaking: Removed thechainIdparameter fromconnectorsfunction oncreateClient.const client = createClient({ - connectors({ chainId }) { + connectors() { ... } })If you previously derived RPC URLs from the
chainIdonconnectors, you can now remove that logic aswagminow handles RPC URLs internally when used withconfigureChains.import { chain, + configureChains, createClient } from 'wagmi'; +import { publicProvider } from 'wagmi/providers/public' import { CoinbaseWalletConnector } from 'wagmi/connectors/coinbaseWallet' import { InjectedConnector } from 'wagmi/connectors/injected' import { MetaMaskConnector } from 'wagmi/connectors/metaMask' import { WalletConnectConnector } from 'wagmi/connectors/walletConnect' +const { chains } = configureChains( + [chain.mainnet], + [publicProvider()] +); const client = createClient({ - connectors({ chainId }) { - const chain = chains.find((x) => x.id === chainId) ?? defaultChain - const rpcUrl = chain.rpcUrls.alchemy - ? `${chain.rpcUrls.alchemy}/${alchemyId}` - : chain.rpcUrls.default - return [ + connectors: [ new MetaMaskConnector({ chains }), new CoinbaseWalletConnector({ chains, options: { appName: 'wagmi', - chainId: chain.id, - jsonRpcUrl: rpcUrl, }, }), new WalletConnectConnector({ chains, options: { qrcode: true, - rpc: { [chain.id]: rpcUrl }, }, }), new InjectedConnector({ chains, options: { name: 'Injected' }, }), ] - }, })
- #611
3089c34Thanks @tmm! - Breaking:ConnectorsgetProvidermethod no longer supports thecreateconfig parameter. Use thechainIdconfig option instead.
- #596
a770af7Thanks @tmm! - Breaking:TypedDataDomainandTypedDataFieldtypes were removed and incorporated intoSignTypedDataArgs.
4f8f3c0Thanks @nachoiacovino! - Update symbols to match ethereum-lists/chains
-
fc94210Thanks @jxom! - Breaking: ThewriteContractfunction parameters have been consolidated into a singular config parameter.Before:
writeContract( { addressOrName: "0xecb504d39723b0be0e3a9aa33d646642d1051ee1", contractInterface: wagmigotchiABI, }, "feed", );
After:
readContract({ addressOrName: "0xecb504d39723b0be0e3a9aa33d646642d1051ee1", contractInterface: wagmigotchiABI, functionName: "feed", });
-
fc94210Thanks @jxom! - Breaking: ThereadContract&watchReadContractfunction parameters have been consolidated into a singular config parameter.Before:
readContract( { addressOrName: "0xecb504d39723b0be0e3a9aa33d646642d1051ee1", contractInterface: wagmigotchiABI, }, "getHunger", { args: [0] }, ); watchReadContract( { addressOrName: "0xecb504d39723b0be0e3a9aa33d646642d1051ee1", contractInterface: wagmigotchiABI, }, "getHunger", { args: [0] }, (result) => {}, );
After:
readContract({ addressOrName: "0xecb504d39723b0be0e3a9aa33d646642d1051ee1", contractInterface: wagmigotchiABI, functionName: "getHunger", args: [0], }); watchReadContract( { addressOrName: "0xecb504d39723b0be0e3a9aa33d646642d1051ee1", contractInterface: wagmigotchiABI, functionName: "getHunger", args: [0], }, (result) => {}, );
- #598
fef26bfThanks @markdalgleish! - Update@coinbase/wallet-sdkpeer dependency to>=3.3.0to fix errors when connecting with older versions of the Coinbase Wallet extension and mobile app.
-
#611
3089c34Thanks @tmm! - AddedchainIdconfig parameter forwriteContractandsendTransaction.If
chainIdis provided, the connector will validate thatchainIdis the active chain before sending a transaction (and switch tochainIdif necessary).
- #582
b03830aThanks @jxom! - Fixed an issue where the wagmi client'sstatuswould not update from"disconnected"to"connecting" -> "connected"when theconnectaction is invoked.
-
fc94210Thanks @jxom! - Added amulticall&watchMulticallaction that provides multicall support.Internally uses the
multicall3contract.
fc94210Thanks @jxom! - Added areadContracts&watchReadContractsaction that provides the ability to batch up multiple ethers Contract read-only methods.
- #549
89b3a74Thanks @tmm! - Turns onnoUncheckedIndexedAccessandstrictNullChecksfor better runtime safety.
- #526
e95c5f9Thanks @jxom! - AddedshimChainChangedDisconnectoption toInjectedConnector. Defaults totrueforMetaMaskConnector.
-
#526
e95c5f9Thanks @jxom! - AddedchainIdconfig option to theconnectaction.Example:
import { connect } from "@wagmi/core"; await connect({ chainId: 69 });
-
#408
bfcc3a5Thanks @jxom! - Breaking: Theconnectorsoption oncreateClientno longer reacts to chain switching.Passing a function to
connectorshas been deprecated.If you previously derived an RPC URL from the
chainIdinconnectors, you will need to migrate to use theconfigureChainsAPI.import { providers } from "ethers"; import { chain, createClient, defaultChains } from "wagmi"; import { CoinbaseWalletConnector } from "wagmi/connectors/coinbaseWallet"; import { InjectedConnector } from "wagmi/connectors/injected"; import { MetaMaskConnector } from "wagmi/connectors/metaMask"; import { WalletConnectConnector } from "wagmi/connectors/walletConnect"; const alchemyId = process.env.ALCHEMY_ID; const chains = defaultChains; const defaultChain = chain.mainnet; const client = createClient({ autoConnect: true, connectors({ chainId }) { const chain = chains.find((x) => x.id === chainId) ?? defaultChain; const rpcUrl = chain.rpcUrls.alchemy ? `${chain.rpcUrls.alchemy}/${alchemyId}` : chain.rpcUrls.default; return [ new MetaMaskConnector({ chains }), new CoinbaseWalletConnector({ chains, options: { appName: "wagmi", chainId: chain.id, jsonRpcUrl: rpcUrl, }, }), new WalletConnectConnector({ chains, options: { qrcode: true, rpc: { [chain.id]: rpcUrl }, }, }), new InjectedConnector({ chains, options: { name: "Injected", shimDisconnect: true, }, }), ]; }, });
import { chain, createClient, defaultChains } from "wagmi"; import { alchemyProvider } from "wagmi/providers/alchemy"; import { publicProvider } from "wagmi/providers/public"; import { CoinbaseWalletConnector } from "wagmi/connectors/coinbaseWallet"; import { InjectedConnector } from "wagmi/connectors/injected"; import { MetaMaskConnector } from "wagmi/connectors/metaMask"; import { WalletConnectConnector } from "wagmi/connectors/walletConnect"; const alchemyId = process.env.ALCHEMY_ID; const { chains } = configureChains(defaultChains, [ alchemyProvider({ alchemyId }), publicProvider(), ]); const client = createClient({ autoConnect: true, connectors: [ new MetaMaskConnector({ chains }), new CoinbaseWalletConnector({ chains, options: { appName: "wagmi", }, }), new WalletConnectConnector({ chains, options: { qrcode: true, }, }), new InjectedConnector({ chains, options: { name: "Injected", shimDisconnect: true, }, }), ], });
-
#468
44a884bThanks @tmm! - Breaking: Duplicate exports with different names and the same functionality were removed to simplify the public API. In addition, confusing exports were renamed to be more descriptive.createWagmiClientalias was removed. UsecreateClientinstead.useWagmiClientalias was removed. UseuseClientinstead.WagmiClientalias was removed. UseClientinstead.createWagmiStoragealias was removed. UsecreateStorageinstead.Providerwas renamed andWagmiProvideralias was removed. UseWagmiConfiginstead.
-
#408
bfcc3a5Thanks @jxom! - AddconfigureChainsAPI.The
configureChainsfunction allows you to configure your chains with a selected provider (Alchemy, Infura, JSON RPC, Public RPC URLs). This means you don't have to worry about deriving your own RPC URLs for each chain, or instantiating a Ethereum Provider.configureChainsaccepts 3 parameters: an array of chains, and an array of providers, and a config object.Learn more about configuring chains & providers.
import { providers } from "ethers"; import { chain, createClient, defaultChains } from "wagmi"; import { CoinbaseWalletConnector } from "wagmi/connectors/coinbaseWallet"; import { InjectedConnector } from "wagmi/connectors/injected"; import { MetaMaskConnector } from "wagmi/connectors/metaMask"; import { WalletConnectConnector } from "wagmi/connectors/walletConnect"; const alchemyId = process.env.ALCHEMY_ID; const chains = defaultChains; const defaultChain = chain.mainnet; const client = createClient({ autoConnect: true, connectors({ chainId }) { const chain = chains.find((x) => x.id === chainId) ?? defaultChain; const rpcUrl = chain.rpcUrls.alchemy ? `${chain.rpcUrls.alchemy}/${alchemyId}` : chain.rpcUrls.default; return [ new MetaMaskConnector({ chains }), new CoinbaseWalletConnector({ chains, options: { appName: "wagmi", chainId: chain.id, jsonRpcUrl: rpcUrl, }, }), new WalletConnectConnector({ chains, options: { qrcode: true, rpc: { [chain.id]: rpcUrl }, }, }), new InjectedConnector({ chains, options: { name: "Injected", shimDisconnect: true, }, }), ]; }, provider: ({ chainId }) => new providers.AlchemyProvider(chainId, alchemyId), });
import { chain, createClient, defaultChains } from "wagmi"; import { alchemyProvider } from "wagmi/providers/alchemy"; import { publicProvider } from "wagmi/providers/public"; import { CoinbaseWalletConnector } from "wagmi/connectors/coinbaseWallet"; import { InjectedConnector } from "wagmi/connectors/injected"; import { MetaMaskConnector } from "wagmi/connectors/metaMask"; import { WalletConnectConnector } from "wagmi/connectors/walletConnect"; const alchemyId = process.env.ALCHEMY_ID; const { chains, provider, webSocketProvider } = configureChains( defaultChains, [alchemyProvider({ alchemyId }), publicProvider()], ); const client = createClient({ autoConnect: true, connectors: [ new MetaMaskConnector({ chains }), new CoinbaseWalletConnector({ chains, options: { appName: "wagmi", }, }), new WalletConnectConnector({ chains, options: { qrcode: true, }, }), new InjectedConnector({ chains, options: { name: "Injected", shimDisconnect: true, }, }), ], provider, webSocketProvider, });
-
#404
f81c156Thanks @holic! - AddProviderRpcErrorandRpcErrorerror classes.Certain wagmi-standardized errors may wrap
ProviderRpcErrororRpcError. For these cases, you can access the original provider rpc or rpc error value using theinternalproperty.
- #447
b9ebf78Thanks @tmm! - Fix case where connector disconnected while app was closed and stale data was returned when autoconnecting. For example, MetaMask was locked when page was closed.
4e03666Thanks @tmm! - bump dependencies #429 add imToken support for WC switch chains #432 fix MetaMask and Brave Wallet collision #436
- #412
80bef4fThanks @markdalgleish! - Import providers frometherspeer dependency rather than@ethersproject/providersto avoid multiple conflicting versions being installed
-
018c2a1Thanks @tmm! - - warn and fallback to default client #380-
remove signerOrProvider option from read contract #390
-
MetaMaskConnector #391
-
afc4607Thanks @tmm! - - Fix time scaling e9593df- Use fully-specified path for use-sync-external-store import 7b235c1
- Update serialize 236fc17
- #311
24ce011Thanks @tmm! - - Favourmessageevent overconnectingevent to conform to EIP-1193- Export
useWaitForTransaction
- Export
- #311
24ce011Thanks @tmm! - AddcacheOnBlockconfig foruseContractReadUpdatereact-queryto v4 FixwatchBlockNumberlistener leak
- showtime
- update block explorers and rpc urls structure
- last beta
- update zustand
- Add
cacheOnBlockconfig foruseContractRead - Update
react-queryto v4 - Fix
watchBlockNumberlistener leak
- keep previous data when watching
- add chainId to actions and hooks
- fix stale connectors when switching chains
- republish
- improve type support for ethers providers
- update babel target
-
- Favour
messageevent overconnectingevent to conform to EIP-1193 - Export
useWaitForTransaction
- Favour
- add
connectingevent to connectors
- don't persist account data when
autoConnectis falsy
- remove storage persistence of
connector - add
chainsto client state
- Fix issue where
getProviderwas not being awaited ingetSigner
- fix: persist connector chains to local storage
- Initial 0.3.0 release
- #236
53bad61Thanks @markdalgleish! - Updated@walletconnect/ethereum-providerto v1.7.4
-
e338c3bThanks @tmm! - checksum connector address on change eventsadd shim to injected connector for simulating disconnect
-
#52
da7a3a6Thanks @tmm! - Moves connectors to their own entrypoints to reduce bundle size.// old - WalletLinkConnector unused, but still in final bundle import { InjectedConnector, WalletConnectConnector } from "wagmi"; // new - WalletLinkConnector not in final bundle import { InjectedConnector } from "wagmi/connectors/injected"; import { WalletConnectConnector } from "wagmi/connectors/walletConnect";