docs: add wallet provider migration guide for Base App WebView (2026)#1433
Open
schoolkamsergj wants to merge 1 commit into
Open
docs: add wallet provider migration guide for Base App WebView (2026)#1433schoolkamsergj wants to merge 1 commit into
schoolkamsergj wants to merge 1 commit into
Conversation
Closes base#1420 Base App's April 2026 update changed mini-app launch behavior from a Farcaster mini-app host to a standard WebView. This breaks sdk.wallet.getEthereumProvider() — it hangs indefinitely. This guide covers: - How to detect Base App WebView vs true Farcaster embed - How to fall back to injected EIP-1193 (window.ethereum) - Why sdk.isInMiniApp() returns false in Base App WebView
Collaborator
🟡 Heimdall Review Status
|
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Adds a new technical guide covering the breaking wallet provider change introduced by Base App's April 2026 update.
Base App now opens mini-apps in a standard WebView instead of a Farcaster mini-app host. This causes
sdk.wallet.getEthereumProvider()to hang indefinitely — no error, no timeout — breaking any mini-app that relies on the SDK for wallet access.This guide documents the issue and provides a working detection + fallback pattern.
What's added
docs/apps/technical-guides/wallet-provider-base-app-webview-2026.mdxsdk.isInMiniApp()to distinguish Base App WebView from true Farcaster embed (Warpcast)window.ethereum/window.coinbaseWalletExtension) for Base App WebView contextfarcasterMiniApp()+injected()connectors and auto-connect hookContext
Discovered while building a mini-app on Base mainnet. The app silently hung on every transaction when opened via Base App — no console error, no rejection, just an indefinite loading state. Root cause:
sdk.isInMiniApp()returnsfalsein Base App WebView, so the Farcaster host is never present.Fixes #1420
Tested
window.ethereuminjected provider works correctly as fallbacksdk.isInMiniApp()correctly returnsfalsein Base App WebView,truein Warpcast