Skip to main content

Android Native Quickstart

note

This page is a work in progress. More content is being worked on and will being added soon!

What you will learn​

  • How to use Mobile Wallet Adapter to:
    • Connect to a wallet app with transact.
    • Request wallet authorization and reauthorization.

Connect to a wallet​

To connect to a wallet, use the transact method provided by the MobileWalletAdapter class.

The transact method instantiates a Scenario and dispatches an association Intent via startActivity() that will be received by MWA-compatible wallet apps.

This starts a session with a wallet and within the callback, the app can send requests for signing or sending transactions/messages.

import com.solana.mobilewalletadapter.clientlib.*

val walletAdapterClient = MobileWalletAdapter()
val result = walletAdapterClient.transact(sender) {
    /* ... */
}

Authorizing a wallet​

After starting a Scenario with a wallet app with transact, you should first request authorization for your app with a call to authorize.

When requesting authorization, pass in identity metadata to the request so users can recognize your app during the authorization flow.

  • identityName: The name of your app.
  • identityUri: The web URL associated with your app.
  • iconUri: A path to your app icon relative to the app uri above.
import com.solana.mobilewalletadapter.clientlib.*

val walletAdapterClient = MobileWalletAdapter()
val result = walletAdapterClient.transact(sender) {
    // Pass in identity metadata about your app.
    val identityUri = Uri.parse("https://yourapp.com")
    val iconUri = Uri.parse("favicon.ico") // Full path resolves to https://yourdapp.com/favicon.ico
    val identityName = "Example Solana app"

    // `authorize` prompts the user to accept your authorization request.
    val authed = client.authorize(identityUri, iconUri, identityName, RpcCluster.Devnet)

    // Rest of transact code goes below...
}

Once authorized with a wallet, the app can request the wallet to sign transactions, messages and send transactions via RPC. authorize also returns an AuthorizationResult that contains metadata from the wallet, like the wallet label and an authToken.

Reauthorization for subsequent connections​

For subsequent connections to the wallet app, you can skip the authorization step by sending a reauthorization request with a previously stored authToken. If still valid, reauthorize will bypass the need to explicitly grant authorization again.

import com.solana.mobilewalletadapter.clientlib.*

val walletAdapterClient = MobileWalletAdapter()
val result = walletAdapterClient.transact(sender) {
    // Pass in app identity metadata
    val identityUri = Uri.parse("https://yourapp.com")
    val iconUri = Uri.parse("favicon.ico")
    val identityName = "Example Solana app"

    if (hasAuthToken) {
        // If we've saved an authToken from a previous `AuthorizationResult`, we can skip `authorize`
        // by sending a `reauthorize` request.
        val reauthed = reauthorize(identityUri, iconUri, identityName, savedAuthToken)
    } else {
        val authed = client.authorize(identityUri, iconUri, identityName, RpcCluster.Devnet)
    }

    // Rest of transact code goes below...
}

Next Steps​