Matador Docs
Smart Wallet UX

Smart Wallet UX

Get Web2‑smooth UX without losing custody. Session keys, subscriptions, and safe convenience.

The Smart Wallet Revolution

Hook: The moment the UX breaks

A Saturday morning. A user is trying to complete a simple action inside your app—swap $20, mint an NFT, or start a recurring buy. They tap “Continue.”

Then the wallet pops up.

They approve. Another popup. They approve. Another one—this time it looks different. The wording is weird. The numbers don’t match what the app showed. The user pauses, unsure if they’re being careful… or being tricked.

They do what most people do in that moment: they close it.

The friction tax

People don’t rage-quit because they hate crypto. They quit because the app asks them to make too many high-stakes decisions, too quickly, with too little context.

"Every extra approval is a drop‑off."


Problem Evolution: How we got stuck signing everything

Early days: The survival era (2013–2019)

Wallet UX started with one goal: don't lose the keys. Seed phrases became the default. The wallet was a vault first, and an experience second. Users were trained to be paranoid, and every interaction was a high-friction event.

The complexity explosion: Approval fatigue (2020–2022)

DeFi happened. Apps needed approvals, swaps, staking, bridging—each one a separate step. Wallets became a constant interrupt. We trained users into a bad habit: click through prompts until something works. That’s not a UX win. That’s learned helplessness.

The current state: The UX vs. Safety trap (2023–present)

Account Abstraction (AA) promised to fix this, but it didn't automatically solve the core question: Who can do what, for how long, under which limits? Session keys reduce prompts, but without guardrails, "one-click" is just "one big permission."

Seed Phrases

Paranoid self-custody. Safe, but painful for daily use.

MetaMask & Dapps

The popup era. Every action is a manual signing ceremony.

Scoped Sessions

The "approve once" era. Safe, automatic execution within bounds.


Tension: Why current fixes fail

Every product team is trapped between two bad options:

  1. Fast feels unsafe: "I hope this app doesn't drain my wallet."
  2. Safe feels slow: "Why am I approving again?"

The Pain: High drop-off during wallet interactions. You've built a great app, but the wallet experience is out of your control. The Stakes: User retention. If the happy path requires five popups, users won't finish it.


Insight: Safe, scoped sessions

The win isn't "no approvals." The win is: Approve once for a clearly limited session, and let the app work inside those limits.

Matador lets you create safe, scoped session keys backed by on-chain guardrails.

The Aha Moment

A session stops meaning "trust us." It starts meaning "trust the rules." You create a small contract with the user: what the session can do, how much it can spend, and when it ends.


Resolution: "Approve once, session does the rest"

Matador's model for Smart Wallet UX enables "one-click" flows that are provably safe.

Your app asks for one intentional approval to start a session. That approval is a permission policy that defines:

  • Specific scope: Only allow interactions with your app's contracts.
  • Spend limits: Cap total value at risk (e.g., "$50/day on swaps").
  • Auto-expiry: Short-lived sessions that naturally end.
  • On-chain enforcement: Rules are enforced by the blockchain, not your server.

"Web2 speed with Web3 safety."


Proof: Trust from explicit constraints

Auditable Guardrails

Rules live on-chain. The system enforces the same boundaries every time, regardless of what the UI shows.

Strict Scopes

No "blank check" approvals. Sessions are limited to exactly what the user authorized.

Transparent Limits

Show caps and boundaries in the UI in human terms. Users know their risk is bounded.

Short Expiries

Sessions naturally end. Long-lived access is an explicit choice, not an accidental vulnerability.

Safe convenience

Users can revoke sessions at any time and return to "sign every step" instantly. You give them control, not just convenience.


Next steps: where to start


Why it matters

Wallet UX isn't just polish. It's the difference between a user completing an action or bouncing at the moment of truth. When approvals are constant and confusing, people leave. Matador makes "one-click" possible without asking users to trade away their security.


Story snippet

A user opens your app to do the same swap they did yesterday. There’s no gauntlet of popups. The app says: “You’re in a session—valid for 10 minutes, capped at $25.”

They tap once. The swap completes. They move on with their day. No drama. No second-guessing. Just a wallet experience that finally feels normal.

"UX without the trust tax."

On this page