Cowrie Research

mobile-wallet-adapter

3 min read

Mobile Wallet Adapter

  • Name: Mobile Wallet Adapter (MWA)
  • URL: https://docs.solanamobile.com/developers/mobile-wallet-adapter
  • Category: Solana mobile wallet connectivity standard / secure session-and-transport protocol / mobile signing interface infrastructure
  • Tags: solana-ecosystem
  • Summary: Mobile Wallet Adapter is Solana’s mobile wallet session rail, not another wallet SDK. Its real job is secure association, feature negotiation, authorization persistence, and request routing across same-device and remote-device mobile flows. That shifts power away from bespoke per-wallet glue and into a shared transport and capability protocol, with the practical leverage sitting in launcher routing, reflector infrastructure, platform support, and wallet compliance with the spec.
  • What it does:
    • Defines a protocol for Solana dapps to connect to mobile wallet apps for authorization, message signing, and transaction signing/sending
    • Establishes wallet sessions through association tokens and secure-channel setup between a dapp endpoint and a wallet endpoint
    • Supports local same-device flows via the solana-wallet: URI scheme and localhost WebSocket transport, so a mobile browser or native dapp can launch a wallet app directly
    • Supports remote-device flows through reflector-assisted WebSocket sessions and out-of-band URI exchange such as QR codes
    • Makes WebSockets the mandatory transport, with Bluetooth LE discussed as an optional future transport path
    • Defines mandatory features like solana:signMessages and solana:signAndSendTransaction, optional features like solana:signInWithSolana and solana:cloneAuthorization, and a capability-discovery path for optional support
    • Ships first-party reference implementations, Android and JavaScript libraries, a wallet-adapter plugin, and sample apps to reduce per-wallet integration drift
  • Key claims:
    • The official docs describe MWA as a generic protocol specification that enables dapps to connect with mobile wallet apps for Solana transaction and message signing, which is the clearest reason to catalog it as connectivity infrastructure rather than a single SDK package
    • The specification’s non-normative summary says the intention is for MWA to become the standard for connecting all dapps to mobile wallet apps, showing that the project is explicitly trying to create a common integration substrate rather than wallet-by-wallet glue code
    • The requirements section says communication should happen over a secure channel and that same-device interaction should not require a remote intermediary, which is important because the protocol is trying to minimize both attack surface and third-party dependence in the common mobile case
    • The specification’s local association flow uses a solana-wallet: URI plus a localhost WebSocket endpoint, which means practical wallet-routing power on mobile sits partly in URI handling, wallet installation, and browser/platform support rather than only in signing APIs
    • The remote association flow introduces reflector infrastructure and out-of-band connection handoff, which is useful because it makes MWA a session-establishment and routing protocol, not just a signing method catalog
    • The feature model distinguishes mandatory and optional wallet capabilities and requires dapps to call get_capabilities for optional support, which means wallet interoperability depends not only on presence but on feature-surface negotiation
    • The Solana Mobile docs currently show full support on Android and Android Chrome, while iOS and several mobile browsers remain unsupported, revealing that the standard’s practical reach is constrained by platform mediation as much as by the written spec
    • The repository README shows the project ships protocol specs, Android and JavaScript reference implementations, a wallet-adapter plugin, and sample apps, which is a strong signal that MWA is an operational ecosystem standard rather than a dead paper spec
  • Whitepaper: No standalone Mobile Wallet Adapter whitepaper or litepaper surfaced in this pass. The clearest current sources were the public Solana Mobile docs, the repository README, and the specification text collected in ../../whitepapers/mobile-wallet-adapter-primary-sources-2026-05-08.md.
  • Sources:

Internal linkages

Graph View

Backlinks