Skip to content

feat: add eip1193-compatilble as a supported session property#8731

Merged
adonesky1 merged 6 commits intomainfrom
jc/WAPI-1482
May 7, 2026
Merged

feat: add eip1193-compatilble as a supported session property#8731
adonesky1 merged 6 commits intomainfrom
jc/WAPI-1482

Conversation

@ffmcgee725
Copy link
Copy Markdown
Member

@ffmcgee725 ffmcgee725 commented May 7, 2026

Explanation

The @metamask/connect-evm package is adding support for sending sessionProperties: { 'eip1193-compatible': true } on every wallet_createSession request (MetaMask/connect-monorepo#285). This lets the wallet distinguish EIP-1193-style connections established through connect-evm from pure Multichain API connections and other provider types like Solana Wallet Standard.

However, the chain-agnostic-permission package validates session properties against a known set (KnownSessionProperties enum), and any unrecognized property causes the CAIP-25 caveat validator to throw. Without this change, the new eip1193-compatible session property would be rejected.

This PR adds Eip1193Compatible = 'eip1193-compatible' to the KnownSessionProperties enum so the wallet accepts it as a valid session property.

References

Checklist

  • I've updated the test suite for new or updated code as appropriate
  • I've updated documentation (JSDoc, Markdown, etc.) for new or updated code as appropriate
  • I've communicated my changes to consumers by updating changelogs for packages I've changed
  • I've introduced breaking changes in this PR and have prepared draft pull requests for clients and consumer packages to resolve them

Note

Low Risk
Low risk: adds a new allowed CAIP-25 sessionProperties key and tags legacy permission conversions with it, with no changes to scope/account validation logic beyond accepting this new flag.

Overview
Adds support for the eip1193-compatible CAIP-25 session property by extending KnownSessionProperties and related validation/tests so wallet_createSession requests carrying this flag are no longer rejected.

Updates getCaip25PermissionFromLegacyPermissions to always set sessionProperties: { 'eip1193-compatible': true }, and adjusts unit tests plus the package changelog accordingly.

Reviewed by Cursor Bugbot for commit fb7fa99. Bugbot is set up for automated code reviews on this repo. Configure here.

@ffmcgee725
Copy link
Copy Markdown
Member Author

@metamaskbot publish-preview

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented May 7, 2026

Preview builds have been published. Learn how to use preview builds in other projects.

Expand for full list of packages and versions.
@metamask-previews/account-tree-controller@7.3.0-preview-902014de8
@metamask-previews/accounts-controller@38.0.0-preview-902014de8
@metamask-previews/address-book-controller@7.1.1-preview-902014de8
@metamask-previews/ai-controllers@0.6.3-preview-902014de8
@metamask-previews/analytics-controller@1.0.1-preview-902014de8
@metamask-previews/analytics-data-regulation-controller@0.0.0-preview-902014de8
@metamask-previews/announcement-controller@8.1.0-preview-902014de8
@metamask-previews/app-metadata-controller@2.0.1-preview-902014de8
@metamask-previews/approval-controller@9.0.1-preview-902014de8
@metamask-previews/assets-controller@6.4.0-preview-902014de8
@metamask-previews/assets-controllers@106.0.0-preview-902014de8
@metamask-previews/authenticated-user-storage@1.0.0-preview-902014de8
@metamask-previews/base-controller@9.1.0-preview-902014de8
@metamask-previews/base-data-service@0.1.1-preview-902014de8
@metamask-previews/bridge-controller@71.1.1-preview-902014de8
@metamask-previews/bridge-status-controller@71.1.0-preview-902014de8
@metamask-previews/build-utils@3.0.4-preview-902014de8
@metamask-previews/chain-agnostic-permission@1.5.0-preview-902014de8
@metamask-previews/chomp-api-service@3.0.0-preview-902014de8
@metamask-previews/claims-controller@0.5.0-preview-902014de8
@metamask-previews/client-controller@1.0.1-preview-902014de8
@metamask-previews/compliance-controller@2.0.0-preview-902014de8
@metamask-previews/composable-controller@12.0.1-preview-902014de8
@metamask-previews/config-registry-controller@0.3.0-preview-902014de8
@metamask-previews/connectivity-controller@0.2.0-preview-902014de8
@metamask-previews/controller-utils@11.20.0-preview-902014de8
@metamask-previews/core-backend@6.2.1-preview-902014de8
@metamask-previews/delegation-controller@3.0.0-preview-902014de8
@metamask-previews/earn-controller@12.1.0-preview-902014de8
@metamask-previews/eip-5792-middleware@3.0.3-preview-902014de8
@metamask-previews/eip-7702-internal-rpc-middleware@0.1.0-preview-902014de8
@metamask-previews/eip1193-permission-middleware@2.0.0-preview-902014de8
@metamask-previews/ens-controller@19.1.1-preview-902014de8
@metamask-previews/eth-block-tracker@15.0.1-preview-902014de8
@metamask-previews/eth-json-rpc-middleware@23.1.3-preview-902014de8
@metamask-previews/eth-json-rpc-provider@6.0.1-preview-902014de8
@metamask-previews/foundryup@1.0.1-preview-902014de8
@metamask-previews/gas-fee-controller@26.2.0-preview-902014de8
@metamask-previews/gator-permissions-controller@4.1.0-preview-902014de8
@metamask-previews/geolocation-controller@0.1.2-preview-902014de8
@metamask-previews/json-rpc-engine@10.3.0-preview-902014de8
@metamask-previews/json-rpc-middleware-stream@8.0.8-preview-902014de8
@metamask-previews/keyring-controller@25.5.0-preview-902014de8
@metamask-previews/logging-controller@8.0.1-preview-902014de8
@metamask-previews/message-manager@14.1.1-preview-902014de8
@metamask-previews/messenger@1.2.0-preview-902014de8
@metamask-previews/messenger-cli@0.2.0-preview-902014de8
@metamask-previews/money-account-balance-service@0.2.0-preview-902014de8
@metamask-previews/money-account-controller@0.3.0-preview-902014de8
@metamask-previews/money-account-upgrade-controller@1.3.1-preview-902014de8
@metamask-previews/multichain-account-service@9.0.0-preview-902014de8
@metamask-previews/multichain-api-middleware@3.0.0-preview-902014de8
@metamask-previews/multichain-network-controller@3.1.0-preview-902014de8
@metamask-previews/multichain-transactions-controller@7.1.0-preview-902014de8
@metamask-previews/name-controller@9.1.1-preview-902014de8
@metamask-previews/network-controller@30.1.0-preview-902014de8
@metamask-previews/network-enablement-controller@5.1.0-preview-902014de8
@metamask-previews/notification-services-controller@23.1.0-preview-902014de8
@metamask-previews/passkey-controller@2.0.1-preview-902014de8
@metamask-previews/permission-controller@13.1.0-preview-902014de8
@metamask-previews/permission-log-controller@5.1.0-preview-902014de8
@metamask-previews/perps-controller@6.0.0-preview-902014de8
@metamask-previews/phishing-controller@17.1.1-preview-902014de8
@metamask-previews/polling-controller@16.0.4-preview-902014de8
@metamask-previews/preferences-controller@23.1.0-preview-902014de8
@metamask-previews/profile-metrics-controller@3.1.3-preview-902014de8
@metamask-previews/profile-sync-controller@28.0.2-preview-902014de8
@metamask-previews/ramps-controller@13.3.0-preview-902014de8
@metamask-previews/rate-limit-controller@7.0.1-preview-902014de8
@metamask-previews/react-data-query@0.2.0-preview-902014de8
@metamask-previews/remote-feature-flag-controller@4.2.0-preview-902014de8
@metamask-previews/sample-controllers@4.0.4-preview-902014de8
@metamask-previews/seedless-onboarding-controller@9.1.0-preview-902014de8
@metamask-previews/selected-network-controller@26.1.1-preview-902014de8
@metamask-previews/shield-controller@5.1.1-preview-902014de8
@metamask-previews/signature-controller@39.2.0-preview-902014de8
@metamask-previews/snap-account-service@0.0.0-preview-902014de8
@metamask-previews/social-controllers@2.2.0-preview-902014de8
@metamask-previews/storage-service@1.0.1-preview-902014de8
@metamask-previews/subscription-controller@6.1.2-preview-902014de8
@metamask-previews/transaction-controller@65.2.0-preview-902014de8
@metamask-previews/transaction-pay-controller@21.1.0-preview-902014de8
@metamask-previews/user-operation-controller@41.2.0-preview-902014de8

Copy link
Copy Markdown
Contributor

@adonesky1 adonesky1 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks right to me!

@adonesky1 adonesky1 added this pull request to the merge queue May 7, 2026
Merged via the queue into main with commit 40465f7 May 7, 2026
366 checks passed
@adonesky1 adonesky1 deleted the jc/WAPI-1482 branch May 7, 2026 22:26
@ffmcgee725 ffmcgee725 mentioned this pull request May 8, 2026
github-merge-queue Bot pushed a commit that referenced this pull request May 8, 2026
## @metamask/chain-agnostic-permission

## [1.6.0]

### Added

- Add `Eip1193Compatible` property in `KnownSessionProperties` enum to
support EIP-1193-style connections established through `connect-evm`
([#8731](#8731))
- Set `sessionProperties: { 'eip1193-compatible': true }` in
`getCaip25PermissionFromLegacyPermissions` so that legacy EIP-1193
permission requests are tagged as EIP-1193-compatible
([#8731](#8731))

### Changed

- Bump `@metamask/permission-controller` from `^12.2.1` to `^13.1.0`
([#8317](#8317),
[#8661](#8661),
[#8722](#8722))
- Bump `@metamask/controller-utils` from `^11.19.0` to `^11.20.0`
([#8344](#8344))

## @metamask/multichain-api-middleware

## [3.1.0]

### Changed

- Bump `@metamask/chain-agnostic-permission` from `^1.5.0` to `^1.6.0`
([#8290](#8749))
- Bump `@metamask/multichain-transactions-controller` from `^7.0.4` to
`^7.1.0` ([#8665](#8665))
- Bump `@metamask/accounts-controller` from `^37.2.0` to `^38.0.0`
([#8665](#8665))
- Bump `@metamask/permission-controller` from `^13.0.0` to `^13.1.0`
([#8722](#8722))
- Bump `@metamask/json-rpc-engine` from `^10.3.0` to `^10.4.0`
([#8746](#8746))

<!-- CURSOR_SUMMARY -->
---

> [!NOTE]
> **Low Risk**
> Primarily version/changelog updates and dependency range bumps; no
functional source changes are included in this diff, so runtime risk is
low aside from typical release packaging/versioning issues.
> 
> **Overview**
> Bumps the monorepo release version to `971.0.0` and publishes new
package versions for `@metamask/chain-agnostic-permission` (`1.6.0`) and
`@metamask/multichain-api-middleware` (`3.1.0`).
> 
> Updates changelogs and lockfile, and bumps downstream dependencies
(`@metamask/eip1193-permission-middleware` and
`@metamask/multichain-api-middleware`) to consume
`@metamask/chain-agnostic-permission@^1.6.0`.
> 
> <sup>Reviewed by [Cursor Bugbot](https://cursor.com/bugbot) for commit
90d6560. Bugbot is set up for automated
code reviews on this repo. Configure
[here](https://www.cursor.com/dashboard/bugbot).</sup>
<!-- /CURSOR_SUMMARY -->
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants