@solana-mobile/mobile-wallet-adapter-protocol 2.1.4 → 2.2.0-new-arch-beta

package/.gitignore

@@ -0,0 +1,2 @@
+lib/
+android/build

package/android/.gitignore

@@ -0,0 +1,14 @@
+# OSX
+#
+.DS_Store
+
+# Android/IJ
+#
+.classpath
+.cxx
+.gradle
+.idea
+.project
+.settings
+local.properties
+android.iml

package/android/build.gradle

@@ -8,7 +8,7 @@ buildscript {
   }
 
   dependencies {
-    classpath 'com.android.tools.build:gradle:8.7.1'
+    classpath 'com.android.tools.build:gradle:8.7.2'
     // noinspection DifferentKotlinGradleVersion
     classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
   }
@@ -55,6 +55,18 @@ android {
     sourceCompatibility JavaVersion.VERSION_1_8
     targetCompatibility JavaVersion.VERSION_1_8
   }
+
+  sourceSets {
+    main {
+      if (isNewArchitectureEnabled()) {
+        java.srcDirs += [
+          "src/newarch"
+        ]
+      } else {
+        java.srcDirs += ["src/oldarch"]
+      }
+    }
+  }
 }
 
 repositories {

package/android/src/main/java/com/solanamobile/mobilewalletadapter/reactnative/SolanaMobileWalletAdapterModule.kt

@@ -13,25 +13,26 @@ import com.solana.mobilewalletadapter.clientlib.scenario.LocalAssociationScenari
 import com.solana.mobilewalletadapter.common.protocol.SessionProperties.ProtocolVersion
 import com.solanamobile.mobilewalletadapter.reactnative.JSONSerializationUtils.convertJsonToMap
 import com.solanamobile.mobilewalletadapter.reactnative.JSONSerializationUtils.convertMapToJson
-import kotlinx.coroutines.*
-import kotlinx.coroutines.sync.Mutex
-import org.json.JSONObject
 import java.util.concurrent.ExecutionException
 import java.util.concurrent.TimeUnit
 import java.util.concurrent.TimeoutException
+import kotlinx.coroutines.*
+import kotlinx.coroutines.sync.Mutex
+import org.json.JSONObject
 
 class SolanaMobileWalletAdapterModule(reactContext: ReactApplicationContext) :
-    ReactContextBaseJavaModule(reactContext), CoroutineScope {
+        SolanaMobileWalletAdapterSpec(reactContext), CoroutineScope {
 
     data class SessionState(
-        val client: MobileWalletAdapterClient,
-        val localAssociation: LocalAssociationScenario,
+            val client: MobileWalletAdapterClient,
+            val localAssociation: LocalAssociationScenario,
     )
 
     override val coroutineContext =
-        Dispatchers.IO + CoroutineName("SolanaMobileWalletAdapterModuleScope") + SupervisorJob()
+            Dispatchers.IO + CoroutineName("SolanaMobileWalletAdapterModuleScope") + SupervisorJob()
 
     companion object {
+        const val NAME = "SolanaMobileWalletAdapter"
         private const val ASSOCIATION_TIMEOUT_MS = 10000
         private const val CLIENT_TIMEOUT_MS = 90000
         private const val REQUEST_LOCAL_ASSOCIATION = 0
@@ -43,130 +44,152 @@ class SolanaMobileWalletAdapterModule(reactContext: ReactApplicationContext) :
     }
 
     private val mActivityEventListener: ActivityEventListener =
-        object : BaseActivityEventListener() {
-            override fun onActivityResult(
-                activity: Activity?,
-                requestCode: Int,
-                resultCode: Int,
-                data: Intent?
-            ) {
-                if (requestCode == REQUEST_LOCAL_ASSOCIATION) 
-                    associationResultCallback?.invoke(resultCode)
+            object : BaseActivityEventListener() {
+                override fun onActivityResult(
+                        activity: Activity?,
+                        requestCode: Int,
+                        resultCode: Int,
+                        data: Intent?
+                ) {
+                    if (requestCode == REQUEST_LOCAL_ASSOCIATION)
+                            associationResultCallback?.invoke(resultCode)
+                }
             }
-        }
 
     init {
         reactContext.addActivityEventListener(mActivityEventListener)
     }
 
     override fun getName(): String {
-        return "SolanaMobileWalletAdapter"
+        return NAME
     }
 
     @ReactMethod
-    fun startSession(config: ReadableMap?, promise: Promise) = launch {
-        mutex.lock()
-        Log.d(name, "startSession with config $config")
-        try {
-            val uriPrefix = config?.getString("baseUri")?.let { Uri.parse(it) }
-            val localAssociation = LocalAssociationScenario(
-                CLIENT_TIMEOUT_MS,
-            )
-            val intent = LocalAssociationIntentCreator.createAssociationIntent(
-                uriPrefix,
-                localAssociation.port,
-                localAssociation.session
-            )
-            associationResultCallback = { resultCode ->
-                if (resultCode == Activity.RESULT_CANCELED) {
-                    Log.d(name, "Local association cancelled by user, ending session")
-                    promise.reject("Session not established: Local association cancelled by user", 
-                        LocalAssociationScenario.ConnectionFailedException("Local association cancelled by user"))
-                    localAssociation.close()
+    override fun startSession(config: ReadableMap?, promise: Promise): Unit {
+        launch {
+            mutex.lock()
+            Log.d(name, "startSession with config $config")
+            try {
+                val uriPrefix = config?.getString("baseUri")?.let { Uri.parse(it) }
+                val localAssociation =
+                        LocalAssociationScenario(
+                                CLIENT_TIMEOUT_MS,
+                        )
+                val intent =
+                        LocalAssociationIntentCreator.createAssociationIntent(
+                                uriPrefix,
+                                localAssociation.port,
+                                localAssociation.session
+                        )
+                associationResultCallback = { resultCode ->
+                    if (resultCode == Activity.RESULT_CANCELED) {
+                        Log.d(name, "Local association cancelled by user, ending session")
+                        promise.reject(
+                                "Session not established: Local association cancelled by user",
+                                LocalAssociationScenario.ConnectionFailedException(
+                                        "Local association cancelled by user"
+                                )
+                        )
+                        localAssociation.close()
+                    }
                 }
+                currentActivity?.startActivityForResult(intent, REQUEST_LOCAL_ASSOCIATION)
+                        ?: throw NullPointerException(
+                                "Could not find a current activity from which to launch a local association"
+                        )
+                val client =
+                        localAssociation
+                                .start()
+                                .get(ASSOCIATION_TIMEOUT_MS.toLong(), TimeUnit.MILLISECONDS)
+                sessionState = SessionState(client, localAssociation)
+                val sessionPropertiesMap: WritableMap = WritableNativeMap()
+                sessionPropertiesMap.putString(
+                        "protocol_version",
+                        when (localAssociation.session.sessionProperties.protocolVersion) {
+                            ProtocolVersion.LEGACY -> "legacy"
+                            ProtocolVersion.V1 -> "v1"
+                        }
+                )
+                promise.resolve(sessionPropertiesMap)
+            } catch (e: ActivityNotFoundException) {
+                Log.e(name, "Found no installed wallet that supports the mobile wallet protocol", e)
+                cleanup()
+                promise.reject("ERROR_WALLET_NOT_FOUND", e)
+            } catch (e: TimeoutException) {
+                Log.e(name, "Timed out waiting for local association to be ready", e)
+                cleanup()
+                promise.reject("Timed out waiting for local association to be ready", e)
+            } catch (e: InterruptedException) {
+                Log.w(name, "Interrupted while waiting for local association to be ready", e)
+                cleanup()
+                promise.reject(e)
+            } catch (e: ExecutionException) {
+                Log.e(name, "Failed establishing local association with wallet", e.cause)
+                cleanup()
+                promise.reject(e)
+            } catch (e: Throwable) {
+                Log.e(name, "Failed to start session", e)
+                cleanup()
+                promise.reject(e)
             }
-            currentActivity?.startActivityForResult(intent, REQUEST_LOCAL_ASSOCIATION)
-                ?: throw NullPointerException("Could not find a current activity from which to launch a local association")
-            val client =
-                localAssociation.start().get(ASSOCIATION_TIMEOUT_MS.toLong(), TimeUnit.MILLISECONDS)
-            sessionState = SessionState(client, localAssociation)
-            val sessionPropertiesMap: WritableMap = WritableNativeMap()
-            sessionPropertiesMap.putString("protocol_version", 
-                when (localAssociation.session.sessionProperties.protocolVersion) {
-                    ProtocolVersion.LEGACY -> "legacy"
-                    ProtocolVersion.V1 -> "v1"
-                })
-            promise.resolve(sessionPropertiesMap)
-        } catch (e: ActivityNotFoundException) {
-            Log.e(name, "Found no installed wallet that supports the mobile wallet protocol", e)
-            cleanup()
-            promise.reject("ERROR_WALLET_NOT_FOUND", e)
-        } catch (e: TimeoutException) {
-            Log.e(name, "Timed out waiting for local association to be ready", e)
-            cleanup()
-            promise.reject("Timed out waiting for local association to be ready", e)
-        } catch (e: InterruptedException) {
-            Log.w(name, "Interrupted while waiting for local association to be ready", e)
-            cleanup()
-            promise.reject(e)
-        } catch (e: ExecutionException) {
-            Log.e(name, "Failed establishing local association with wallet", e.cause)
-            cleanup()
-            promise.reject(e)
-        } catch (e: Throwable) {
-            Log.e(name, "Failed to start session", e)
-            cleanup()
-            promise.reject(e)
         }
     }
 
     @ReactMethod
-    fun invoke(method: String, params: ReadableMap, promise: Promise) = sessionState?.let {
-        Log.d(name, "invoke `$method` with params $params")
-        try {
-            val result = it.client.methodCall(
-                method,
-                convertMapToJson(params),
-                CLIENT_TIMEOUT_MS
-            ).get() as JSONObject
-            promise.resolve(convertJsonToMap(result))
-        } catch (e: ExecutionException) {
-            val cause = e.cause
-            if (cause is JsonRpc20Client.JsonRpc20RemoteException) {
-                val userInfo = Arguments.createMap()
-                userInfo.putInt("jsonRpcErrorCode", cause.code)
-                promise.reject("JSON_RPC_ERROR", cause, userInfo)
-            } else if (cause is TimeoutException) {
-                promise.reject("Timed out waiting for response", e)
-            } else {
-                throw e
+    override fun invoke(method: String, params: ReadableMap?, promise: Promise): Unit =
+            sessionState?.let {
+                Log.d(name, "invoke `$method` with params $params")
+                try {
+                    val result =
+                            it.client
+                                    .methodCall(method, convertMapToJson(params), CLIENT_TIMEOUT_MS)
+                                    .get() as
+                                    JSONObject
+                    promise.resolve(convertJsonToMap(result))
+                } catch (e: ExecutionException) {
+                    val cause = e.cause
+                    if (cause is JsonRpc20Client.JsonRpc20RemoteException) {
+                        val userInfo = Arguments.createMap()
+                        userInfo.putInt("jsonRpcErrorCode", cause.code)
+                        promise.reject("JSON_RPC_ERROR", cause, userInfo)
+                    } else if (cause is TimeoutException) {
+                        promise.reject("Timed out waiting for response", e)
+                    } else {
+                        throw e
+                    }
+                } catch (e: Throwable) {
+                    Log.e(name, "Failed to invoke `$method` with params $params", e)
+                    promise.reject(e)
+                }
             }
-        } catch (e: Throwable) {
-            Log.e(name, "Failed to invoke `$method` with params $params", e)
-            promise.reject(e)
-        }
-    } ?: throw NullPointerException("Tried to invoke `$method` without an active session")
+                    ?: throw NullPointerException(
+                            "Tried to invoke `$method` without an active session"
+                    )
 
     @ReactMethod
-    fun endSession(promise: Promise) = sessionState?.let {
-        launch {
-            Log.d(name, "endSession")
-            try {
-                it.localAssociation.close()
-                    .get(ASSOCIATION_TIMEOUT_MS.toLong(), TimeUnit.MILLISECONDS)
-                cleanup()
-                promise.resolve(true)
-            } catch (e: TimeoutException) {
-                Log.e(name, "Timed out waiting for local association to close", e)
-                cleanup()
-                promise.reject("Failed to end session", e)
-            } catch (e: Throwable) {
-                Log.e(name, "Failed to end session", e)
-                cleanup()
-                promise.reject("Failed to end session", e)
+    override fun endSession(promise: Promise): Unit {
+        sessionState?.let {
+            launch {
+                Log.d(name, "endSession")
+                try {
+                    it.localAssociation
+                            .close()
+                            .get(ASSOCIATION_TIMEOUT_MS.toLong(), TimeUnit.MILLISECONDS)
+                    cleanup()
+                    promise.resolve(true)
+                } catch (e: TimeoutException) {
+                    Log.e(name, "Timed out waiting for local association to close", e)
+                    cleanup()
+                    promise.reject("Failed to end session", e)
+                } catch (e: Throwable) {
+                    Log.e(name, "Failed to end session", e)
+                    cleanup()
+                    promise.reject("Failed to end session", e)
+                }
             }
         }
-    } ?: throw NullPointerException("Tried to end a session without an active session")
+                ?: throw NullPointerException("Tried to end a session without an active session")
+    }
 
     private fun cleanup() {
         sessionState = null

package/android/src/main/java/com/solanamobile/mobilewalletadapter/reactnative/SolanaMobileWalletAdapterPackage.kt

@@ -1,16 +1,35 @@
-package com.solanamobile.mobilewalletadapter.reactnative
-
-import com.facebook.react.ReactPackage
-import com.facebook.react.bridge.NativeModule
-import com.facebook.react.bridge.ReactApplicationContext
-import com.facebook.react.uimanager.ViewManager
-
-class SolanaMobileWalletAdapterPackage : ReactPackage {
-    override fun createNativeModules(reactContext: ReactApplicationContext): List<NativeModule> {
-        return listOf(SolanaMobileWalletAdapterModule(reactContext))
-    }
-
-    override fun createViewManagers(reactContext: ReactApplicationContext): List<ViewManager<*, *>> {
-        return emptyList()
-    }
-}
+package com.solanamobile.mobilewalletadapter.reactnative
+
+import com.facebook.react.TurboReactPackage
+import com.facebook.react.bridge.NativeModule
+import com.facebook.react.bridge.ReactApplicationContext
+import com.facebook.react.module.model.ReactModuleInfo
+import com.facebook.react.module.model.ReactModuleInfoProvider
+import java.util.HashMap
+
+class SolanaMobileWalletAdapterModulePackage : TurboReactPackage() {
+    override fun getModule(name: String, reactContext: ReactApplicationContext): NativeModule? {
+        return if (name == SolanaMobileWalletAdapterModule.NAME) {
+            SolanaMobileWalletAdapterModule(reactContext)
+        } else {
+            null
+        }
+    }
+
+    override fun getReactModuleInfoProvider(): ReactModuleInfoProvider {
+        return ReactModuleInfoProvider {
+            val moduleInfos: MutableMap<String, ReactModuleInfo> = HashMap()
+            moduleInfos[SolanaMobileWalletAdapterModule.NAME] =
+                    ReactModuleInfo(
+                            SolanaMobileWalletAdapterModule.NAME,
+                            SolanaMobileWalletAdapterModule.NAME,
+                            false, // canOverrideExistingModule
+                            false, // needsEagerInit
+                            true, // hasConstants
+                            false, // isCxxModule
+                            true // isTurboModule
+                    )
+            moduleInfos
+        }
+    }
+}

package/android/src/newarch/SolanaMobileWalletAdapter.kt

@@ -0,0 +1,7 @@
+package com.solanamobile.mobilewalletadapter.reactnative
+
+import com.facebook.react.bridge.ReactApplicationContext
+
+abstract class SolanaMobileWalletAdapterSpec
+internal constructor(context: ReactApplicationContext) :
+        NativeSolanaMobileWalletAdapterSpec(context) {}

package/android/src/oldarch/SolanaMobileWalletAdapter.kt

@@ -0,0 +1,16 @@
+package com.solanamobile.mobilewalletadapter.reactnative
+
+import com.facebook.react.bridge.Promise
+import com.facebook.react.bridge.ReactApplicationContext
+import com.facebook.react.bridge.ReactContextBaseJavaModule
+import com.facebook.react.bridge.ReadableMap
+
+abstract class SolanaMobileWalletAdapterSpec
+internal constructor(context: ReactApplicationContext) : ReactContextBaseJavaModule(context) {
+
+    abstract fun startSession(config: ReadableMap?, promise: Promise)
+
+    abstract fun invoke(method: String, params: ReadableMap?, promise: Promise)
+
+    abstract fun endSession(promise: Promise)
+}

package/lib/cjs/index.browser.js

@@ -950,10 +950,14 @@ function transactRemote(callback, config) {
                             try {
                                 resolve(yield callback(new Proxy(wallet, {
                                     get(target, p) {
-                                        if (p === 'terminateSession') {
-                                            disposeSocket();
-                                            socket.close();
-                                            return;
+                                        if (p == 'terminateSession') {
+                                            return function () {
+                                                return __awaiter(this, void 0, void 0, function* () {
+                                                    disposeSocket();
+                                                    socket.close();
+                                                    return;
+                                                });
+                                            };
                                         }
                                         else
                                             return target[p];

package/lib/cjs/index.js

@@ -950,10 +950,14 @@ function transactRemote(callback, config) {
                             try {
                                 resolve(yield callback(new Proxy(wallet, {
                                     get(target, p) {
-                                        if (p === 'terminateSession') {
-                                            disposeSocket();
-                                            socket.close();
-                                            return;
+                                        if (p == 'terminateSession') {
+                                            return function () {
+                                                return __awaiter(this, void 0, void 0, function* () {
+                                                    disposeSocket();
+                                                    socket.close();
+                                                    return;
+                                                });
+                                            };
                                         }
                                         else
                                             return target[p];

package/lib/cjs/index.native.js

@@ -72,6 +72,8 @@ function __awaiter(thisArg, _arguments, P, generator) {
     });
 }
 
+var NativeSolanaMobileWalletAdapter = reactNative.TurboModuleRegistry.getEnforcing('SolanaMobileWalletAdapter');
+
 function createSIWSMessage(payload) {
     return walletStandardUtil.createSignInMessageText(payload);
 }
@@ -243,8 +245,8 @@ const LINKING_ERROR = `The package 'solana-mobile-wallet-adapter-protocol' doesn
     '  - You have added `@solana-mobile/mobile-wallet-adapter-protocol` as an explicit dependency, and\n' +
     '  - You have added `@solana-mobile/mobile-wallet-adapter-protocol` to the `nohoist` section of your package.json\n' +
     '- You are not using Expo managed workflow\n';
-const SolanaMobileWalletAdapter = reactNative.Platform.OS === 'android' && reactNative.NativeModules.SolanaMobileWalletAdapter
-    ? reactNative.NativeModules.SolanaMobileWalletAdapter
+const SolanaMobileWalletAdapter = reactNative.Platform.OS === 'android' && NativeSolanaMobileWalletAdapter
+    ? NativeSolanaMobileWalletAdapter
     : new Proxy({}, {
         get() {
             throw new Error(reactNative.Platform.OS !== 'android'

package/lib/esm/index.browser.js

@@ -946,10 +946,14 @@ function transactRemote(callback, config) {
                             try {
                                 resolve(yield callback(new Proxy(wallet, {
                                     get(target, p) {
-                                        if (p === 'terminateSession') {
-                                            disposeSocket();
-                                            socket.close();
-                                            return;
+                                        if (p == 'terminateSession') {
+                                            return function () {
+                                                return __awaiter(this, void 0, void 0, function* () {
+                                                    disposeSocket();
+                                                    socket.close();
+                                                    return;
+                                                });
+                                            };
                                         }
                                         else
                                             return target[p];

package/lib/esm/index.js

@@ -946,10 +946,14 @@ function transactRemote(callback, config) {
                             try {
                                 resolve(yield callback(new Proxy(wallet, {
                                     get(target, p) {
-                                        if (p === 'terminateSession') {
-                                            disposeSocket();
-                                            socket.close();
-                                            return;
+                                        if (p == 'terminateSession') {
+                                            return function () {
+                                                return __awaiter(this, void 0, void 0, function* () {
+                                                    disposeSocket();
+                                                    socket.close();
+                                                    return;
+                                                });
+                                            };
                                         }
                                         else
                                             return target[p];

package/lib/types/index.native.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.native.d.ts","sourceRoot":"","sources":["../../src/index.ts","../../src/errors.ts","../../src/createHelloReq.ts","../../src/types.ts","../../src/base64Utils.ts","../../src/createSIWSMessage.ts","../../src/createMobileWalletProxy.ts","../../src/createSequenceNumberVector.ts","../../src/parseHelloRsp.ts","../../src/encryptedMessage.ts","../../src/generateAssociationKeypair.ts","../../src/generateECDHKeypair.ts","../../src/jsonRpcMessage.ts","../../src/parseSessionProps.ts","../../src/associationPort.ts","../../src/arrayBufferToBase64String.ts","../../src/getStringWithURLUnsafeBase64CharactersReplaced.ts","../../src/reflectorId.ts","../../src/getAssociateAndroidIntentURL.ts","../../src/startSession.ts","../../src/transact.ts","../../src/__forks__/react-native/transact.ts"],"names":[],"mappings":""}
+{"version":3,"file":"index.native.d.ts","sourceRoot":"","sources":["../../src/index.ts","../../src/errors.ts","../../src/createHelloReq.ts","../../src/types.ts","../../src/base64Utils.ts","../../src/createSIWSMessage.ts","../../src/createMobileWalletProxy.ts","../../src/createSequenceNumberVector.ts","../../src/parseHelloRsp.ts","../../src/encryptedMessage.ts","../../src/generateAssociationKeypair.ts","../../src/generateECDHKeypair.ts","../../src/jsonRpcMessage.ts","../../src/parseSessionProps.ts","../../src/associationPort.ts","../../src/arrayBufferToBase64String.ts","../../src/getStringWithURLUnsafeBase64CharactersReplaced.ts","../../src/reflectorId.ts","../../src/getAssociateAndroidIntentURL.ts","../../src/startSession.ts","../../src/transact.ts","../../src/codegenSpec/NativeSolanaMobileWalletAdapter.ts","../../src/__forks__/react-native/transact.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@solana-mobile/mobile-wallet-adapter-protocol",
     "description": "An implementation of the Solana Mobile Mobile Wallet Adapter protocol. Use this to open a session with a mobile wallet app, and to issue API calls to it.",
-    "version": "2.1.4",
+    "version": "2.2.0-new-arch-beta",
     "author": "Steven Luscher <steven.luscher@solanamobile.com>",
     "repository": "https://github.com/solana-mobile/mobile-wallet-adapter",
     "license": "Apache-2.0",
@@ -54,5 +54,13 @@
     "peerDependencies": {
         "@solana/web3.js": "^1.58.0",
         "react-native": ">0.69"
+    },
+    "codegenConfig": {
+        "name": "SolanaMobileWalletAdapter",
+        "type": "all",
+        "jsSrcsDir": "./src/codegenSpec",
+        "android": {
+            "javaPackageName": "com.solanamobile.mobilewalletadapter.reactnative"
+        }
     }
 }

package/src/__forks__/react-native/base64Utils.ts

@@ -0,0 +1 @@
+export { encode } from 'js-base64';

package/src/__forks__/react-native/transact.ts

@@ -0,0 +1,91 @@
+import { Platform } from 'react-native';
+
+import NativeSolanaMobileWalletAdapter from '../../codegenSpec/NativeSolanaMobileWalletAdapter.js';
+import createMobileWalletProxy from '../../createMobileWalletProxy.js';
+import { SolanaMobileWalletAdapterError, SolanaMobileWalletAdapterProtocolError } from '../../errors.js';
+import { MobileWallet, SessionProperties, WalletAssociationConfig } from '../../types.js';
+
+type ReactNativeError = Error & { code?: string; userInfo?: Record<string, unknown> };
+
+const LINKING_ERROR =
+    `The package 'solana-mobile-wallet-adapter-protocol' doesn't seem to be linked. Make sure: \n\n` +
+    '- You rebuilt the app after installing the package\n' +
+    '- If you are using Lerna workspaces\n' +
+    '  - You have added `@solana-mobile/mobile-wallet-adapter-protocol` as an explicit dependency, and\n' +
+    '  - You have added `@solana-mobile/mobile-wallet-adapter-protocol` to the `nohoist` section of your package.json\n' +
+    '- You are not using Expo managed workflow\n';
+
+const SolanaMobileWalletAdapter =
+    Platform.OS === 'android' && NativeSolanaMobileWalletAdapter
+        ? NativeSolanaMobileWalletAdapter
+        : (new Proxy(
+              {},
+              {
+                  get() {
+                      throw new Error(
+                          Platform.OS !== 'android'
+                              ? 'The package `solana-mobile-wallet-adapter-protocol` is only compatible with React Native Android'
+                              : LINKING_ERROR,
+                      );
+                  },
+              },
+          ) as typeof NativeSolanaMobileWalletAdapter);
+
+function getErrorMessage(e: ReactNativeError): string {
+    switch (e.code) {
+        case 'ERROR_WALLET_NOT_FOUND':
+            return 'Found no installed wallet that supports the mobile wallet protocol.';
+        default:
+            return e.message;
+    }
+}
+
+function handleError(e: any): never {
+    if (e instanceof Error) {
+        const reactNativeError: ReactNativeError = e;
+        switch (reactNativeError.code) {
+            case undefined:
+                throw e;
+            case 'JSON_RPC_ERROR': {
+                const details = reactNativeError.userInfo as Readonly<{ jsonRpcErrorCode: number }>;
+                throw new SolanaMobileWalletAdapterProtocolError(
+                    0 /* jsonRpcMessageId */,
+                    details.jsonRpcErrorCode,
+                    e.message,
+                );
+            }
+            default:
+                throw new SolanaMobileWalletAdapterError<any>(
+                    reactNativeError.code,
+                    getErrorMessage(reactNativeError),
+                    reactNativeError.userInfo,
+                );
+        }
+    }
+    throw e;
+}
+
+export async function transact<TReturn>(
+    callback: (wallet: MobileWallet) => TReturn,
+    config?: WalletAssociationConfig,
+): Promise<TReturn> {
+    let didSuccessfullyConnect = false;
+    try {
+        const sessionProperties: SessionProperties = await SolanaMobileWalletAdapter.startSession(config);
+        didSuccessfullyConnect = true;
+        const wallet = createMobileWalletProxy(sessionProperties.protocol_version, async (method, params) => {
+            try {
+                return SolanaMobileWalletAdapter.invoke(method, params);
+            } catch (e) {
+                return handleError(e);
+            }
+        });
+        return await callback(wallet);
+    } catch (e) {
+        return handleError(e);
+    } finally {
+        if (didSuccessfullyConnect) {
+            await SolanaMobileWalletAdapter.endSession();
+        }
+    }
+}