Android

Portal provides MPC wallets and dApp connections for organizations and their users. To integrate Portal, an organization adds a client library to their mobile app and a few server API endpoints.

Installation

Update the dependencies in your build.gradle to include the portal-android dependency

// In your settings.gradle add JiPack repositories URL
dependencyResolutionManagement {
    ...
    repositories {
        ...
        google()
        mavenCentral()
        maven { url "https://jitpack.io" }
        ...
    }
}
// In your app/build.gradle file
...
dependencies {
    ...
    implementation "io.portalhq.android:portal-android:X.X.X"
}

Initializing Portal

After you update your build.gradle file, you must sync gradle and you're ready to import Portal into an Activity of your choice.

With the Portal Android dependency now installed, we can now create an instance of the Portal class. Below is an example of how you can do this. In this example, we're using your app's MainActivity.

package io.portal.android.app

import io.portal.android.Portal
import io.portal.android.storage.cloud.google.GoogleStorage
import io.portal.android.storage.mobile.Keychain

class MainActivity : AppCompatActivity() {
    lateinit val portal: Portal
    
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        
        // Initialize your Portal instance.
        portal = Portal(
            // A Portal client API key. You can obtain one from Portal's REST API.
            apiKey = CLIENT_API_KEY,
            // A map of chainIDs to Gateway URLs (e.g. Infura, Alchemy, etc.)
            rpcConfig = mapOf("eip155:11155111" to YOUR_GATEWAY_URL),
            // A boolean to auto-approve transactions.
            autoApprove = true,
            // Provide Eth chain id here if you are upgrading from V3 to V4. This is needed for some legacy code
            legacyEthChainId = 11155111
        )
        
        // Configure Backup with GDrive
        portal.configureGoogleStorage(
          clientId = YOUR_GDRIVE_CLIENT_ID, // Your Google client id with GDrive access
          signOutAfterUse = true // Signout Google after backup/recover operation
        )
        
    }
}

Now that we have our Portal instance, the next step is to generate a wallet. Let's create one!

If you are using Client Session Tokens (CSTs), this hint is for you.

When your user's CST expires, all Portal SDKs will throw an error on the next MPC Operation the user makes (e.g. creating a wallet, backing up a wallet, recovering a wallet, or signing). That error will include a code SESSION_EXPIRED in the SDK methods, which you can use as an indicator to refresh your CST.

Last updated