If you spend any time in Farcaster clients like Warpcast or the Base App, you have probably tapped a card in your feed and ended up inside a small interactive app rather than a normal post. Maybe it was a game, a poll, a mint, or a tool that asked to connect your wallet. That is a Mini App, and understanding how it works is useful even if you never build one, because using one means putting your wallet in front of code you did not write.
What a Mini App is
A Mini App is a full web application, built with normal web technology, that runs embedded inside a Farcaster client instead of opening in a separate browser tab. Farcaster provides a software development kit that lets these apps do things a plain webpage in your feed could not: render a custom interface, remember state between visits, send you a notification, and, importantly, read your Farcaster identity and talk to a wallet to propose onchain transactions.
The pitch for developers is speed of distribution. Instead of building an app and hoping people find it in an app store, a Mini App shows up as a clickable card wherever it gets shared in the social graph. The pitch for users is convenience: you can mint something, join a game, or make a payment without leaving the app you are already in.
Why Base shows up so often
Mini Apps need somewhere to settle their onchain actions, and Base has become the default settlement layer for a large share of them. A few practical reasons line up here. Base is an Ethereum layer 2, so transaction fees are low enough that small, frequent, in-feed actions (like tipping, minting, or playing a game with onchain state) stay cheap. Farcaster and Base also share an overlapping builder community and tooling, including wallet kits designed specifically to make embedded wallet connections inside a social client straightforward. The practical result is that if you use Mini Apps at all, there is a good chance you are also, indirectly, a Base user.
What actually happens when you tap something
It helps to be precise about what a Mini App can and cannot do, because the embedded, app-like presentation can make the underlying mechanics feel invisible.
A Mini App itself does not hold your funds and cannot move them on its own. When it wants you to do something onchain, whether that is claiming an NFT, swapping a token, or sending a payment, it constructs a transaction and hands it to your connected wallet for approval. Your wallet then shows you the standard confirmation prompt, the same kind you would see connecting to any other decentralized app. Nothing executes until you sign.
That means every habit you already apply to a normal dapp connection still applies inside a Mini App:
- Read what you are signing. A prompt asking you to approve a token allowance is different from a prompt asking you to sign a message, and both are different from a one-time transaction. If your wallet shows a plain-language summary, read it before approving.
- Check the amount and the recipient. An embedded interface can display anything it wants. What matters is what the transaction itself actually requests, which your wallet's confirmation screen reflects more reliably than the app's own UI.
- Be cautious with open-ended approvals. If a Mini App asks for a token approval, an unusually large or unlimited allowance is worth questioning, the same way it would be from a standalone site. See our guide on checking and revoking token approvals if you want a regular habit for cleaning these up.
- Remember that social distribution is not a vetting process. An app appearing in your feed because a friend interacted with it means it was shared, not that it was audited. Popularity and legitimacy are separate things.
The identity layer is social, the money layer is not
One subtlety worth keeping straight: your Farcaster identity (your username, your social graph, your casts) and your wallet are connected but distinct. A Mini App can read your public Farcaster profile to personalize what it shows you, but it cannot read your wallet's private key or move funds without your explicit signature each time. If something asks you to type out a recovery phrase or private key to "verify" your identity or "link" your account, that is not how any legitimate Mini App, or any legitimate wallet connection, works. See keep your recovery phrase safe for why that phrase should never leave your device.
Where a swap wallet fits in
If a Mini App leaves you holding a token on Base that you want to trade, convert, or move, that is a normal swap, no different from one initiated any other way. Simple Base Swap is built specifically for Base, so it is a straightforward place to handle that step once the token is sitting in your wallet. The Mini App and the swap are separate actions with separate confirmations, which is exactly the separation you want: one surface for discovery and interaction, another for the trade itself, and a wallet confirmation prompt in between that you actually read.
The takeaway
Mini Apps are a genuinely useful pattern: full onchain applications reachable from inside a social feed, with Base doing much of the settlement work underneath because it is cheap and fast enough for that kind of frequent, small interaction. None of that changes the fundamentals of wallet safety. Every Mini App transaction still passes through a wallet confirmation you control, and the same habits that keep you safe on any dapp, reading prompts, watching allowances, never sharing your recovery phrase, carry over directly.