feat: align with 7715 specification #7603

MoMannn · 2026-01-12T12:32:42Z

Explanation

What is the current state of things and why does it need to change?

The @metamask/eth-json-rpc-middleware package currently supports two EIP-7715 methods:

wallet_requestExecutionPermissions — for requesting new execution permissions
wallet_revokeExecutionPermission — for revoking existing execution permissions

However, the EIP-7715 specification also defines two additional "discoverability" methods that allow dApps to query the wallet about its execution permission capabilities. Without these methods, dApps have no way to:

Discover which permission types the wallet supports and on which chains
Retrieve the list of currently granted (non-revoked) permissions for the user

What is the solution your changes offer and how does it work?

This PR adds support for the two missing EIP-7715 discoverability methods:

wallet_getSupportedExecutionPermissions — Returns an object keyed by permission type (e.g., native-token-allowance, erc20-token-allowance) with their supported chain IDs and rule types. This allows dApps to understand what the wallet can handle before making permission requests.
wallet_getGrantedExecutionPermissions — Returns an array of all currently active (non-revoked) execution permissions. Each permission includes chain ID, addresses, permission details, context, dependencies, and delegation manager information.

The implementation follows the established patterns in this package:

Each method has a dedicated handler file with a factory function (createWallet*Handler)
Hook-based architecture allows consumers to provide their own processing logic
Superstruct schemas are defined for result types, enabling runtime validation
Types and structs are exported from the package index for consumer use

EIP-7715 spec alignment for `wallet_requestExecutionPermissions`

The request/response schema has been updated to align with the latest EIP-7715 specification:

Simplified address fields: Replaced the nested address + signer: { type, data: { address } } structure with flat from (optional) and to (required) fields
Removed isAdjustmentAllowed from rules: This property is only relevant at the permission level, not individual rules
Extended result type: Added dependencies (array of { factory, factoryData }) and delegationManager to the response
New export: Added PermissionDependency type export for consumers
Consistent address validation: Updated GrantedExecutionPermissionStruct to use HexChecksumAddressStruct for address fields

Are there any changes whose purpose might not obvious to those unfamiliar with the domain?

The handlers don't perform parameter validation since these methods don't accept parameters (they're pure query methods). This is intentional and differs from wallet_requestExecutionPermissions and wallet_revokeExecutionPermission which validate their params using Superstruct schemas.

References

Needed for: feat: align with updated 7715 standard metamask-extension#39176
Related to: feat: add 7715 discoverability methods snap-7715-permissions#249

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

Implements EIP-7715 discoverability methods and integrates them into the wallet middleware.

New handlers: createWalletGetSupportedExecutionPermissionsHandler and createWalletGetGrantedExecutionPermissionsHandler using hook-based processing and NoParamsStruct validation
Exports new types and structs from index.ts (SupportedExecutionPermissionConfig*, GrantedExecutionPermission*, results)
Adds EmptyArrayStruct/NoParamsStruct in utils/structs for "no params" validation
Wires methods into createWalletMiddleware via optional processGet* hooks
Unit tests for both methods: hook invocation, result passthrough, missing-hook error, and params validation
Changelog updated to note new RPC support

^{Written by Cursor Bugbot for commit 8e94f86. This will update automatically on new commits. Configure here.}

…pport-7715-discoverability-methods

packages/eth-json-rpc-middleware/src/methods/wallet-get-granted-execution-permissions.ts

mj-kiwi

Let's go

V00D00-child

LGTM

mcmire

LGTM.

jiexi · 2026-01-14T18:41:39Z

packages/eth-json-rpc-middleware/src/methods/wallet-get-granted-execution-permissions.ts

+
+    const { params } = request;
+
+    validateParams(params, GetGrantedExecutionPermissionsParamsStruct);


we can probably just forgo validation in this case?

jiexi · 2026-01-14T18:45:57Z

packages/eth-json-rpc-middleware/CHANGELOG.md


+### Added
+
+- Support for `wallet_getSupportedExecutionPermissions` and `wallet_getGrantedExecutionPermissions` RPC methods ([#7603](https://github.com/MetaMask/core/pull/7603))


PermissionDependency is also exported now

jiexi · 2026-01-14T18:49:14Z

packages/eth-json-rpc-middleware/src/methods/wallet-get-granted-execution-permissions.test.ts

+
+const REQUEST_MOCK = {
+  params: [],
+} as unknown as JsonRpcRequest;


nit. if we add, id, jsonrpc, and method, we can drop the typecast here and the several below. Seems like the trouble might be worth it

## **Description** This PR updates the codebase to align with API changes in the `@metamask/gator-permissions-controller` package. **Reason for the change:** The upstream `@metamask/gator-permissions-controller` package has updated its type definitions and data structures. This PR ensures compatibility with those changes. **Changes included:** 1. **Type simplification**: Removed the `Signer` generic parameter from `StoredGatorPermissionSanitized<Signer, PermissionTypesWithCustom>` → `StoredGatorPermissionSanitized<PermissionTypesWithCustom>` across all files (selectors, hooks, components, and tests). 2. **Data structure updates**: - `permissionResponse.address` → `permissionResponse.from` (delegator address) - `decodedPermission.signer.data.address` → `decodedPermission.to` (delegate/recipient address) - `permissionResponse.signerMeta.delegationManager` → `permissionResponse.delegationManager` (flattened structure) - `permission.rules` → `permissionResponse.rules` (rules array location change) 3. **New RPC methods**: Added support for two new unrestricted methods: - `wallet_getSupportedExecutionPermissions` - Returns supported permission types (filtered by enabled advanced permissions) - `wallet_getGrantedExecutionPermissions` - Returns granted execution permissions [![Open in GitHub Codespaces](https://github.com/codespaces/badge.svg)](https://codespaces.new/MetaMask/metamask-extension/pull/39176?quickstart=1) ## **Changelog**  CHANGELOG entry: Added support for `wallet_getSupportedExecutionPermissions` and `wallet_getGrantedExecutionPermissions` RPC methods. CHANGELOG entry: Updated to latest 7715 standart. ## **Related issues** Depends on: MetaMask/core#7603 Relates to: MetaMask/snap-7715-permissions#249 Requires: MetaMask/core#7634 Requires: MetaMask/snap-7715-permissions#254 ## **Manual testing steps** For manual testing check: MetaMask/snap-7715-permissions#249 ## **Pre-merge author checklist** - [x] I've followed [MetaMask Contributor Docs](https://github.com/MetaMask/contributor-docs) and [MetaMask Extension Coding Standards](https://github.com/MetaMask/metamask-extension/blob/main/.github/guidelines/CODING_GUIDELINES.md). - [x] I've completed the PR template to the best of my ability - [x] I’ve included tests if applicable - [x] I’ve documented my code using [JSDoc](https://jsdoc.app/) format if applicable - [x] I’ve applied the right labels on the PR (see [labeling guidelines](https://github.com/MetaMask/metamask-extension/blob/main/.github/guidelines/LABELING_GUIDELINES.md)). Not required for external contributors. ## **Pre-merge reviewer checklist** - [ ] I've manually tested the PR (e.g. pull and build branch, run the app, test code being changed). - [ ] I confirm that this PR addresses all acceptance criteria described in the ticket it closes and includes the necessary testing evidence such as recordings and or screenshots.  --- > [!NOTE] > Updates codebase to the 7715/gator-permissions v1 API and introduces execution-permissions query RPCs. > > - Refactors to `@metamask/gator-permissions-controller@^1.0.0`: remove `Signer` generic, move `permission.rules` to `permissionResponse.rules`, rename `permissionResponse.address`→`from`, `signerMeta.delegationManager`→`delegationManager`, and decoded permission `signer...address`→`to`; applies across hooks, selectors, components, and tests > - Adds `wallet_getSupportedExecutionPermissions` (filters by enabled advanced types) and `wallet_getGrantedExecutionPermissions`; wires through `createMetamaskMiddleware` and forwards to the permissions kernel snap > - Bumps related deps (`eth-json-rpc-middleware@^23`, `permissions-kernel-snap@^1.0.0`, `signature-controller@^39`, `shield-controller@^5`, etc.) and adjusts LavaMoat policies to use the updated middleware pathing > - Updates PPOM/confirmation tests and stories to the new permission shape; no functional changes beyond API alignment > > <sup>Written by [Cursor Bugbot](https://cursor.com/dashboard?tab=bugbot) for commit a522169. This will update automatically on new commits. Configure [here](https://cursor.com/dashboard?tab=bugbot).</sup>  --------- Co-authored-by: MetaMask Bot <metamaskbot@users.noreply.github.com>

MoMannn added 4 commits January 12, 2026 13:14

add 7715 discoverability methods

e175c6a

Merge branch 'main' of https://github.com/MetaMask/core into feat--su…

b3b63f8

…pport-7715-discoverability-methods

update changelog

4f99615

linter fixes

97e7cca

MoMannn requested review from a team as code owners January 12, 2026 12:32

MoMannn mentioned this pull request Jan 12, 2026

feat: align with updated 7715 standard MetaMask/metamask-extension#39176

Merged

7 tasks

MoMannn added 2 commits January 12, 2026 13:35

update changeloc

3dfabd4

fix tests snapshot

1dc77d1

mj-kiwi reviewed Jan 13, 2026

View reviewed changes

packages/eth-json-rpc-middleware/src/methods/wallet-get-granted-execution-permissions.ts Show resolved Hide resolved

validate params

19d4a56

MoMannn requested a review from mj-kiwi January 13, 2026 09:42

cursor bot reviewed Jan 13, 2026

View reviewed changes

packages/eth-json-rpc-middleware/src/methods/wallet-get-granted-execution-permissions.ts Outdated Show resolved Hide resolved

mj-kiwi previously approved these changes Jan 13, 2026

View reviewed changes

MoMannn added 2 commits January 13, 2026 10:58

add check for empty array and undefined

9682e1c

linter fixes

8e94f86

MoMannn dismissed mj-kiwi’s stale review via 8e94f86 January 13, 2026 10:04

mj-kiwi previously approved these changes Jan 13, 2026

View reviewed changes

MoMannn added this to PR review queue Jan 13, 2026

github-project-automation bot moved this to Needs dev review in PR review queue Jan 13, 2026

MoMannn moved this from Needs dev review to Has approvals, needs CODEOWNER in PR review queue Jan 13, 2026

V00D00-child previously approved these changes Jan 13, 2026

View reviewed changes

mcmire previously approved these changes Jan 13, 2026

View reviewed changes

github-project-automation bot moved this from Has approvals, needs CODEOWNER to Review finalised - Ready to be merged in PR review queue Jan 13, 2026

MoMannn added 2 commits January 14, 2026 10:30

align request execution permission with 7715

2789a30

update types

9b72205

MoMannn changed the title ~~feat: support 7715 discoverability methods~~ feat: align with 7715 specification Jan 14, 2026

MoMannn dismissed stale reviews from mcmire and V00D00-child via 9b72205 January 14, 2026 09:33

MoMannn dismissed mj-kiwi’s stale review via 9b72205 January 14, 2026 09:33

revert to more inclusive rules check

8665f45

MoMannn requested review from V00D00-child, mcmire and mj-kiwi January 14, 2026 09:45

ffmcgee725 approved these changes Jan 14, 2026

View reviewed changes

mcmire approved these changes Jan 14, 2026

View reviewed changes

jiexi reviewed Jan 14, 2026

View reviewed changes

jiexi approved these changes Jan 14, 2026

View reviewed changes

MoMannn added this pull request to the merge queue Jan 14, 2026

Merged via the queue into main with commit d4c3591 Jan 14, 2026
290 checks passed

MoMannn deleted the feat--support-7715-discoverability-methods branch January 14, 2026 19:56

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

feat: align with 7715 specification #7603

feat: align with 7715 specification #7603

Uh oh!

MoMannn commented Jan 12, 2026 •

edited

Loading

Uh oh!

Uh oh!

Uh oh!

mj-kiwi left a comment

Uh oh!

V00D00-child left a comment

Uh oh!

mcmire left a comment

Uh oh!

jiexi Jan 14, 2026

Uh oh!

jiexi Jan 14, 2026

Uh oh!

jiexi Jan 14, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

7 participants


		const { params } = request;

		validateParams(params, GetGrantedExecutionPermissionsParamsStruct);


		### Added

		- Support for `wallet_getSupportedExecutionPermissions` and `wallet_getGrantedExecutionPermissions` RPC methods ([#7603](https://github.com/MetaMask/core/pull/7603))

Uh oh!

feat: align with 7715 specification #7603

feat: align with 7715 specification #7603

Uh oh!

Conversation

MoMannn commented Jan 12, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Explanation

What is the current state of things and why does it need to change?

What is the solution your changes offer and how does it work?

EIP-7715 spec alignment for wallet_requestExecutionPermissions

Are there any changes whose purpose might not obvious to those unfamiliar with the domain?

References

Checklist

Uh oh!

Uh oh!

Uh oh!

mj-kiwi left a comment

Choose a reason for hiding this comment

Uh oh!

V00D00-child left a comment

Choose a reason for hiding this comment

Uh oh!

mcmire left a comment

Choose a reason for hiding this comment

Uh oh!

jiexi Jan 14, 2026

Choose a reason for hiding this comment

Uh oh!

jiexi Jan 14, 2026

Choose a reason for hiding this comment

Uh oh!

jiexi Jan 14, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

7 participants

MoMannn commented Jan 12, 2026 •

edited

Loading

EIP-7715 spec alignment for `wallet_requestExecutionPermissions`