feat(multisig): Implement joint account creation flow

- Add CreateJointAccountFragment and ViewModel
- Add NameJointAccountFragment for account naming
- Add AddJointAccountFragment for participant selection
- Implement JointAccountTransactionSignHelper
- Add CreateJointAccountUseCase
- Add participant selection UI components
- Handle contact creation for external addresses

Author: yasin-ce

.cursor/rules/design_system_rules.md

@@ -41,6 +41,7 @@ import com.algorand.android.models.TransactionSignData
 import com.algorand.android.models.WalletConnectRequest
 import com.algorand.android.models.WalletConnectRequest.WalletConnectArbitraryDataRequest
 import com.algorand.android.models.WalletConnectRequest.WalletConnectTransaction
+import com.algorand.android.modules.addaccount.joint.transaction.ui.PendingSignaturesDialogFragment
 import com.algorand.android.modules.assetinbox.assetinboxoneaccount.ui.model.AssetInboxOneAccountNavArgs
 import com.algorand.android.modules.autolockmanager.ui.AutoLockManager
 import com.algorand.android.modules.deeplink.ui.DeeplinkHandler
@@ -393,7 +394,8 @@ class MainActivity :
                 is TransactionManagerResult.OnTransactionRequestSigned -> {
                     hideProgress()
                     hideLedgerLoadingDialog()
-                    TODO("Implement this")
+                    PendingSignaturesDialogFragment.newInstance(result.signRequestId)
+                        .show(supportFragmentManager, PendingSignaturesDialogFragment.TAG)
                 }
 
                 TransactionManagerResult.LedgerOperationCanceled -> {
@@ -576,7 +578,11 @@ class MainActivity :
 
     private fun navToJointAccountImportDeepLink(address: String) {
         navToHome()
-        TODO("Implement this")
+        nav(
+            HomeNavigationDirections.actionGlobalToJointAccountDetailFragment(
+                accountAddress = address
+            )
+        )
     }
 
     fun navToContactAdditionNavigation(address: String, label: String?) {

app/src/main/kotlin/com/algorand/android/MainActivity.kt

@@ -15,6 +15,7 @@ package com.algorand.android.core.transaction
 import com.algorand.algosdk.transaction.SignedTransaction
 import com.algorand.algosdk.util.Encoder
 import com.algorand.android.models.TransactionSignData
+import com.algorand.android.modules.addaccount.joint.transaction.domain.usecase.SignAndSubmitJointAccountSignature
 import com.algorand.android.utils.extensions.encodeBase64
 import com.algorand.android.utils.signTx
 import com.algorand.wallet.account.info.domain.usecase.GetAccountRekeyAdminAddress
@@ -25,6 +26,7 @@ import com.algorand.wallet.account.local.domain.usecase.GetLocalAccount
 import com.algorand.wallet.account.local.domain.usecase.GetLocalAccounts
 import com.algorand.wallet.algosdk.transaction.sdk.SignHdKeyTransaction
 import com.algorand.wallet.encryption.domain.utils.clearFromMemory
+import android.util.Log
 import com.algorand.wallet.foundation.PeraResult
 import com.algorand.wallet.jointaccount.domain.usecase.GetJointAccountProposerAddress
 import com.algorand.wallet.jointaccount.transaction.domain.model.JointSignRequestDTO
@@ -40,6 +42,7 @@ class JointAccountTransactionSignHelper @Inject constructor(
     private val getHdSeed: GetHdSeed,
     private val signHdKeyTransaction: SignHdKeyTransaction,
     private val proposeJointSignRequest: ProposeJointSignRequest,
+    private val signAndSubmitJointAccountSignature: SignAndSubmitJointAccountSignature,
     private val getJointAccountProposerAddress: GetJointAccountProposerAddress,
     private val getAccountRekeyAdminAddress: GetAccountRekeyAdminAddress
 ) {
@@ -126,7 +129,16 @@ class JointAccountTransactionSignHelper @Inject constructor(
             localAccount is LocalAccount.Algo25 || localAccount is LocalAccount.HdKey
         }
 
-        TODO("Implement auto sign with local accounts")
+        for (signer in eligibleSigners) {
+            val result = signAndSubmitJointAccountSignature(
+                signRequestId = signRequestId,
+                participantAddress = signer.algoAddress,
+                rawTransactions = rawTransactions
+            )
+            if (result !is PeraResult.Success) {
+                Log.w(TAG, "Failed to auto-sign for participant")
+            }
+        }
     }
 
     companion object {

app/src/main/kotlin/com/algorand/android/core/transaction/JointAccountTransactionSignHelper.kt

@@ -102,7 +102,7 @@ abstract class TransactionSignBaseFragment(
     }
 
     protected open fun onJointAccountSignRequestCreated(signRequestId: String) {
-        TODO("Implement this")
+        nav(HomeNavigationDirections.actionGlobalToJointAccountSignRequestFragment(signRequestId))
     }
 
     private val ledgerLoadingDialogListener = LedgerLoadingDialog.Listener { shouldStopResources ->

app/src/main/kotlin/com/algorand/android/core/transaction/TransactionSignBaseFragment.kt

@@ -13,15 +13,32 @@
 package com.algorand.android.modules.accountdetail.jointaccountdetail.domain.usecase
 
 import com.algorand.android.deviceregistration.domain.usecase.DeviceIdUseCase
-import com.algorand.wallet.jointaccount.domain.repository.JointAccountRepository
+import com.algorand.android.models.Result
+import com.algorand.android.modules.addaccount.joint.core.domain.repository.JointAccountRepository
+import com.algorand.android.modules.addaccount.joint.creation.domain.usecase.DeleteInboxJointInvitationNotification
+import com.algorand.wallet.inbox.domain.model.InboxMessagesDTO
+import com.algorand.wallet.inbox.domain.model.InboxSearchDTO
 import javax.inject.Inject
 import javax.inject.Named
 
 class JointAccountInboxOperationsUseCase @Inject constructor(
     private val deviceIdUseCase: DeviceIdUseCase,
     @param:Named(JointAccountRepository.INJECTION_NAME)
     private val jointAccountRepository: JointAccountRepository,
+    private val deleteInboxJointInvitationNotification: DeleteInboxJointInvitationNotification
 ) {
 
     fun getDeviceId(): String? = deviceIdUseCase.getSelectedNodeDeviceId()
+
+    suspend fun getInboxMessages(addresses: List<String>): Result<InboxMessagesDTO> {
+        val deviceId = getDeviceId()?.toLongOrNull()
+            ?: return Result.Error(Exception("Device ID not available"))
+        return jointAccountRepository.getInboxMessages(deviceId, InboxSearchDTO(addresses))
+    }
+
+    suspend fun deleteNotification(accountAddress: String): Boolean {
+        val deviceId = getDeviceId()?.toLongOrNull() ?: return false
+        val result = deleteInboxJointInvitationNotification(deviceId, accountAddress)
+        return result is Result.Success
+    }
 }

app/src/main/kotlin/com/algorand/android/modules/accountdetail/jointaccountdetail/domain/usecase/JointAccountInboxOperationsUseCase.kt

@@ -17,6 +17,7 @@ import android.view.LayoutInflater
 import android.view.View
 import android.view.ViewGroup
 import androidx.fragment.app.viewModels
+import com.algorand.android.HomeNavigationDirections
 import com.algorand.android.core.DaggerBaseFragment
 import com.algorand.android.models.FragmentConfiguration
 import com.algorand.android.modules.accountdetail.jointaccountdetail.viewmodel.JointAccountDetailViewModel
@@ -70,11 +71,23 @@ class JointAccountDetailFragment : DaggerBaseFragment(0), JointAccountDetailScre
     }
 
     private fun navigateToNameJointAccount(event: ViewEvent.NavigateToNameJointAccount) {
-        TODO("Implement this")
+        nav(
+            HomeNavigationDirections.actionGlobalToNameJointAccountFragment(
+                threshold = event.threshold,
+                participantAddresses = event.participantAddresses.toTypedArray()
+            )
+        )
     }
 
     private fun navigateToEditContact(event: ViewEvent.NavigateToEditContact) {
-        TODO("Implement this")
+        nav(
+            HomeNavigationDirections.actionGlobalEditContactFragment(
+                contactName = event.contactName,
+                contactPublicKey = event.contactPublicKey,
+                contactDatabaseId = event.contactDatabaseId,
+                contactProfileImageUri = event.contactProfileImageUri
+            )
+        )
     }
 
     override fun onBackClick() {

app/src/main/kotlin/com/algorand/android/modules/accountdetail/jointaccountdetail/ui/JointAccountDetailFragment.kt

@@ -12,8 +12,10 @@
 
 package com.algorand.android.modules.accountdetail.jointaccountdetail.viewmodel
 
+import com.algorand.android.models.Result
 import com.algorand.android.modules.accountcore.ui.usecase.GetAccountDisplayName
 import com.algorand.android.modules.accountdetail.jointaccountdetail.domain.usecase.CreateJointAccountParticipantItem
+import com.algorand.android.modules.accountdetail.jointaccountdetail.domain.usecase.JointAccountInboxOperationsUseCase
 import com.algorand.android.modules.accountdetail.jointaccountdetail.ui.model.JointAccountParticipantItem
 import com.algorand.android.repository.ContactRepository
 import com.algorand.android.utils.toShortenedAddress
@@ -27,6 +29,7 @@ internal class DefaultJointAccountDetailProcessor @Inject constructor(
     private val getAccountDisplayName: GetAccountDisplayName,
     private val contactRepository: ContactRepository,
     private val createJointAccountParticipantItem: CreateJointAccountParticipantItem,
+    private val inboxOperationsUseCase: JointAccountInboxOperationsUseCase
 ) : JointAccountDetailProcessor {
 
     override suspend fun createContentState(
@@ -71,8 +74,10 @@ internal class DefaultJointAccountDetailProcessor @Inject constructor(
     ): JointAccountDetailProcessor.InvitationResult {
         val addresses = createJointAccountParticipantItem.getLocalAccountAddresses()
 
-        TODO("Implement this")
-        return JointAccountDetailProcessor.InvitationResult.NetworkError
+        return when (val result = inboxOperationsUseCase.getInboxMessages(addresses)) {
+            is Result.Success -> parseInvitationFromInboxMessages(result.data, accountAddress)
+            is Result.Error -> JointAccountDetailProcessor.InvitationResult.NetworkError
+        }
     }
 
     override suspend fun createParticipantItems(
@@ -82,8 +87,7 @@ internal class DefaultJointAccountDetailProcessor @Inject constructor(
     }
 
     override suspend fun deleteInboxNotification(accountAddress: String) {
-//        inboxOperationsUseCase.deleteNotification(accountAddress)
-        TODO("Implement this")
+        inboxOperationsUseCase.deleteNotification(accountAddress)
     }
 
     override suspend fun isJointAccountExists(accountAddress: String): Boolean {

app/src/main/kotlin/com/algorand/android/modules/accountdetail/jointaccountdetail/viewmodel/DefaultJointAccountDetailProcessor.kt

@@ -256,7 +256,11 @@ class AccountDetailFragment :
     }
 
     private fun navToJointAccountDetailFragment() {
-        TODO("Implement this")
+        nav(
+            AccountDetailFragmentDirections.actionAccountDetailFragmentToJointAccountDetailFragment(
+                accountDetailViewModel.accountAddress
+            )
+        )
     }
 
     override fun onImageItemClick(nftAssetId: Long) {
@@ -559,7 +563,12 @@ class AccountDetailFragment :
     }
 
     private fun navToInboxWithFilter() {
-        TODO("Implement this")
+        nav(
+            AccountDetailFragmentDirections
+                .actionAccountDetailFragmentToAssetInboxAllAccountsNavigation(
+                    filterAccountAddress = accountDetailViewModel.accountAddress
+                )
+        )
     }
 
     private fun navToBuySellActionsBottomSheet() {

app/src/main/kotlin/com/algorand/android/modules/accountdetail/ui/AccountDetailFragment.kt

@@ -25,9 +25,7 @@ import com.algorand.android.modules.parity.domain.model.SelectedCurrencyDetail
 import com.algorand.android.modules.peraconnectivitymanager.ui.PeraConnectivityManager
 import com.algorand.android.utils.CacheResult
 import com.algorand.wallet.banner.domain.usecase.GetBannerFlow
-import com.algorand.wallet.inbox.asset.domain.usecase.GetAssetInboxRequestCountFlow
 import com.algorand.wallet.privacy.domain.usecase.GetPrivacyModeFlow
-import com.algorand.wallet.remoteconfig.domain.usecase.IsFeatureToggleEnabled
 import com.algorand.wallet.spotbanner.domain.model.SpotBannerFlowData
 import com.algorand.wallet.spotbanner.domain.usecase.GetSpotBannersFlow
 import kotlinx.coroutines.ExperimentalCoroutinesApi
@@ -44,12 +42,10 @@ class AccountsPreviewUseCase @Inject constructor(
     private val portfolioValueItemMapper: PortfolioValueItemMapper,
     private val peraConnectivityManager: PeraConnectivityManager,
     private val accountPreviewProcessor: AccountPreviewProcessor,
-    private val getAssetInboxRequestCountFlow: GetAssetInboxRequestCountFlow,
     private val getAccountLiteCacheFlow: GetAccountLiteCacheFlow,
     private val getPrivacyModeFlow: GetPrivacyModeFlow,
     private val getBannerFlow: GetBannerFlow,
     private val getSpotBannersFlow: GetSpotBannersFlow,
-    private val isFeatureToggleEnabled: IsFeatureToggleEnabled
 ) {
 
     suspend fun getInitialAccountPreview(): AccountPreview {
@@ -82,7 +78,6 @@ class AccountsPreviewUseCase @Inject constructor(
     }
 
     private suspend fun getAccountPreviewInitializationFlow(accountLiteCacheData: Data): Flow<AccountPreview> {
-        TODO("Implement this")
         return combine(
             getBannerFlow(),
             getSpotBannersFlow(getSpotBannerFlowData(accountLiteCacheData)),

app/src/main/kotlin/com/algorand/android/modules/accounts/ui/viewmodel/AccountsPreviewUseCase.kt

@@ -0,0 +1,44 @@
+/*
+ * Copyright 2022-2025 Pera Wallet, LDA
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License
+ */
+
+package com.algorand.android.modules.addaccount.intro.di
+
+import com.algorand.android.modules.addaccount.intro.domain.usecase.CreateAlgo25Account
+import com.algorand.android.modules.addaccount.intro.domain.usecase.CreateAlgo25AccountUseCase
+import com.algorand.android.modules.addaccount.intro.domain.usecase.CreateHdKeyAccount
+import com.algorand.android.modules.addaccount.intro.domain.usecase.CreateHdKeyAccountUseCase
+import com.algorand.android.modules.addaccount.intro.domain.usecase.GetAddAccountIntroPreview
+import com.algorand.android.modules.addaccount.intro.domain.usecase.GetAddAccountIntroPreviewUseCase
+import dagger.Module
+import dagger.Provides
+import dagger.hilt.InstallIn
+import dagger.hilt.components.SingletonComponent
+
+@Module
+@InstallIn(SingletonComponent::class)
+internal object AddAccountIntroUiModule {
+
+    @Provides
+    fun provideGetAddAccountIntroPreview(
+        impl: GetAddAccountIntroPreviewUseCase
+    ): GetAddAccountIntroPreview = impl
+
+    @Provides
+    fun provideCreateHdKeyAccount(
+        impl: CreateHdKeyAccountUseCase
+    ): CreateHdKeyAccount = impl
+
+    @Provides
+    fun provideCreateAlgo25Account(
+        impl: CreateAlgo25AccountUseCase
+    ): CreateAlgo25Account = impl
+}