Skip to content

docs: clarify EOA wallet limitations for Base MCP onboarding#1646

Open
wichlene wants to merge 2 commits into
base:masterfrom
wichlene:patch-1
Open

docs: clarify EOA wallet limitations for Base MCP onboarding#1646
wichlene wants to merge 2 commits into
base:masterfrom
wichlene:patch-1

Conversation

@wichlene

Copy link
Copy Markdown

What changed? Why?

Closes #1558

Adds a <Warning> block to the Base MCP overview clarifying wallet compatibility. The documentation previously stated only that Base MCP provides access to a "Base Account" without explaining that standard EOAs are not supported. This adds explicit guidance that:

  • Base MCP supports only native Base Smart Wallet accounts created via email or passkey auth
  • Standard EOAs (12–24 word recovery phrase, no passkey configuration) cannot connect directly and cause schema errors
  • Upgrading an existing EOA to a Smart Wallet does not resolve this, since the original recovery-phrase structure is preserved

Notes to reviewers

Single additive change to docs/ai-agents/index.mdx — one <Warning> block inserted after the intro paragraph. No existing content was modified or removed.

How has it been tested?

Documentation-only change. Verified the <Warning> block placement and MDX syntax against the surrounding components in the file.

wichlene added 2 commits June 20, 2026 00:01
Closes base#1558

Adds a warning block to the Base MCP overview clarifying that only native Base Smart Wallet accounts (created via email or passkey auth) are supported, and that standard EOAs — including EOAs upgraded to a Smart Wallet — cannot connect directly due to recovery-phrase and passkey configuration differences.
@cb-heimdall

Copy link
Copy Markdown
Collaborator

🟡 Heimdall Review Status

Requirement Status More Info
Reviews 🟡 0/1
Denominator calculation
Show calculation
1 if user is bot 0
1 if user is external 0
2 if repo is sensitive 0
From .codeflow.yml 1
Additional review requirements
Show calculation
Max 0
0
From CODEOWNERS 0
Global minimum 0
Max 1
1
1 if commit is unverified 0
Sum 1

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.

[Docs Bug/Feature Request]: Clarify EOA Wallet limitations and upgrade restrictions for Base MCP Onboarding

2 participants