walletpermissions
Agent permissions · ERC-7715 (Draft)

An ERC-7715 grant with a spend limit and expiry

An agent asks your wallet for an execution permission with a periodic token limit and an expiry. Read each field: who gets it, how much per period, until when, and whether you can change it.

Request: wallet_requestExecutionPermissions

Education only: this page does not assess any real request, wallet or app, and is not advice to sign or not sign. Checked against the sources below on November 4, 2026. Drafted with AI assistance and awaiting human review against the cited standards. Markdown version

What to read

  • to: the session account that will act. ERC-7715 calls it “the DApp session account associated with the permission”.
  • permission.type and its data. For MetaMask’s erc20-token-periodic: tokenAddress, periodAmount, periodDuration, startTime, justification.
  • rules: ERC-7715’s expiry rule makes a permission “only valid until a specified timestamp.”
  • isAdjustmentAllowed: whether the wallet “MAY attenuate(reduce or increase)” the permission.

What the limit covers

  • An amount per period that resets each period, until the expiry.
  • The justification is text written by the requester. It explains; it does not restrict.

What it does not cover

  • A recipient. The documented periodic permission parameters do not name one.
  • A promise that the grant matches the request: “it is not guaranteed that the values received are equivalent to those requested.” Read what your wallet shows you are granting.

How to stop it

  • ERC-7715 defines wallet_revokeExecutionPermission. The standard is a Draft and wallet screens differ, so look for granted permissions in your wallet’s settings.
Fictional practice

Practice question

A fictional research agent asks your wallet for a permission.

Fictional request card
to
Fieldnotes Agent session account (fictional)
permission.type
erc20-token-periodic
Token
DOLLR (fictional)
periodAmount
10 DOLLR
periodDuration
86400 seconds (1 day)
rules
expiry in 14 days
justification
“Pay for research APIs”

Does this permission restrict the agent to paying research APIs?

Show the answer

Answer: No. The justification is the requester’s description. The documented parameters limit the token, the amount per day and the time window; none names who can be paid.

Sources

  1. ERC-7715: Request Permissions from Wallets. Ethereum ERCs. Draft; created 2024-05-24; text last changed 2026-01-16. Checked 2026-11-04.
  2. Advanced Permissions reference: permission types. MetaMask Smart Accounts Kit docs. Page as published on the check date. Checked 2026-11-04.
  3. Advanced Permissions (ERC-7715). MetaMask Smart Accounts Kit docs. Page as published on the check date. Checked 2026-11-04.

Quotes are from these sources. Found an error? Corrections are logged publicly on the changelog.