@metamask/connect-evm 1.4.0 → 2.1.0

package/CHANGELOG.md

@@ -7,6 +7,39 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [2.1.0]
+
+### Changed
+
+- `@metamask/connect-multichain` is no longer a peer dependency and will be installed transitively as a regular dependency ([#323](https://github.com/MetaMask/connect-monorepo/pull/323))
+
+### Fixed
+
+- `EIP1193Provider.request()` now preserves JSON-RPC error `data` on provider-facing errors when `connect-multichain` surfaces a wallet error through `RPCInvokeMethodErr`. Dapps can read revert reasons, custom-error bytes, and other wallet-provided error metadata from `error.data` alongside the original wallet `error.code` and `error.message`. ([#312](https://github.com/MetaMask/connect-monorepo/pull/312))
+
+## [2.0.0]
+
+### Added
+
+- Validate `@metamask/connect-multichain` peer version at runtime and warn on mismatch ([#253](https://github.com/MetaMask/connect-monorepo/pull/253))
+- Announce the MMConnect-managed EIP-1193 provider through EIP-6963 by default when native MetaMask has not already announced, with `skipAutoAnnounce` and `announceProvider()` for manual control. ([#304](https://github.com/MetaMask/connect-monorepo/pull/304))
+
+### Changed
+
+- **BREAKING:** `@metamask/connect-multichain` is now a peer dependency.
+  Add it to your own `dependencies` (e.g. `npm install @metamask/connect-multichain`)
+  — it is no longer installed transitively.
+- Adopts breaking removal of the public `transport` accessor in `@metamask/connect-multichain`. ([#318](https://github.com/MetaMask/connect-monorepo/pull/318))
+
+### Removed
+
+- **BREAKING** Remove the `transport.onNotification` option from `createEVMClient()`. The option was a fan-out of typed events already exposed via the EIP-1193 provider (`accountsChanged`, `chainChanged`, `connect`, `disconnect`, `display_uri`) and via `eventHandlers`. Migrate to those listeners instead ([#318](https://github.com/MetaMask/connect-monorepo/pull/318))
+
+### Fixed
+
+- MWP-backed EIP-1193 requests now surface wallet errors through rejected promises consistently with the default transport, so `EvmClient.switchChain()` no longer has to handle returned error payloads. ([#311](https://github.com/MetaMask/connect-monorepo/pull/311))
+- Return spec-compatible values from additional intercepted EIP-1193 provider requests: `wallet_requestPermissions` now resolves to requested permissions, while successful `wallet_switchEthereumChain` and `wallet_addEthereumChain` requests resolve to `null`. ([#310](https://github.com/MetaMask/connect-monorepo/pull/310))
+
 ## [1.4.0]
 
 ### Added
@@ -239,7 +272,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 - Initial release ([#58](https://github.com/MetaMask/connect-monorepo/pull/58))
 
-[Unreleased]: https://github.com/MetaMask/connect-monorepo/compare/@metamask/connect-evm@1.4.0...HEAD
+[Unreleased]: https://github.com/MetaMask/connect-monorepo/compare/@metamask/connect-evm@2.1.0...HEAD
+[2.1.0]: https://github.com/MetaMask/connect-monorepo/compare/@metamask/connect-evm@2.0.0...@metamask/connect-evm@2.1.0
+[2.0.0]: https://github.com/MetaMask/connect-monorepo/compare/@metamask/connect-evm@1.4.0...@metamask/connect-evm@2.0.0
 [1.4.0]: https://github.com/MetaMask/connect-monorepo/compare/@metamask/connect-evm@1.3.1...@metamask/connect-evm@1.4.0
 [1.3.1]: https://github.com/MetaMask/connect-monorepo/compare/@metamask/connect-evm@1.3.0...@metamask/connect-evm@1.3.1
 [1.3.0]: https://github.com/MetaMask/connect-monorepo/compare/@metamask/connect-evm@1.2.0...@metamask/connect-evm@1.3.0

package/README.md

@@ -46,6 +46,9 @@ const client = await createEVMClient({
   },
 });
 
+// The MMConnect-managed provider is announced through EIP-6963 by default.
+// Pass `skipAutoAnnounce: true` to opt out and call `client.announceProvider()` manually.
+
 // Connect to MetaMask
 let accounts, chainId;
 try {
@@ -179,8 +182,8 @@ Factory function to create a new MetaMask Connect EVM instance.
 | `analytics.enabled`         | `boolean`                                     | No       | Enables dapp-side analytics. Defaults to `true`; set to `false` to disable analytics events and wallet correlation metadata. |
 | `analytics.integrationType` | `string`                                      | No       | Integration type for analytics                                                                                               |
 | `transport.extensionId`     | `string`                                      | No       | Custom extension ID                                                                                                          |
-| `transport.onNotification`  | `(notification: unknown) => void`             | No       | Notification handler                                                                                                         |
 | `eventHandlers`             | `Partial<EventHandlers>`                      | No       | Event handlers for provider events                                                                                           |
+| `skipAutoAnnounce`          | `boolean`                                     | No       | Skip automatic EIP-6963 provider announcement                                                                                |
 | `debug`                     | `boolean`                                     | No       | Enable debug logging                                                                                                         |
 
 #### Returns
@@ -306,6 +309,22 @@ None.
 await client.disconnect();
 ```
 
+##### `announceProvider()`
+
+Announces the MMConnect-managed EIP-1193 provider through EIP-6963 unless a native MetaMask provider has already announced with `rdns` `io.metamask` or `io.metamask.mobile`. This is called automatically by `createEVMClient()` unless `skipAutoAnnounce: true` is set. The first call may take up to 300 ms while native providers are requested.
+
+**Parameters**
+
+None.
+
+**Returns**
+
+`Promise<void>`
+
+```typescript
+await client.announceProvider();
+```
+
 ##### `switchChain(options)`
 
 Switches to a different chain. Will attempt to add the chain if not configured in the wallet.