> ## Documentation Index
> Fetch the complete documentation index at: https://docs.portalhq.io/llms.txt
> Use this file to discover all available pages before exploring further.

# recoverWallet

> Recovers a wallet using a specified backup method.

**Function Signature**

```swift theme={null}
public func recoverWallet(
    _ method: BackupMethods,
    withCipherText: String? = nil,
    usingProgressCallback: ((MpcStatus) -> Void)? = nil
) async throws -> PortalRecoverWalletResponse
```

**Parameters**

* `method`: The backup method to use for recovery. Supported methods:
  * `.GoogleDrive`: Recover from Google Drive backup
  * `.iCloud`: Recover from iCloud backup
  * `.Password`: Recover using password
  * `.Passkey`: Recover using passkey
  * `.Firebase`: Recover using Firebase Auth Backup
  * `.local`: Recover from local backup
* `withCipherText`: Optional cipher text from a previous backup. Required for the [Self-Managed Backups](../../../resources/self-managed-backups).
* `usingProgressCallback`: Optional callback to track the recovery progress. Receives an `MpcStatus` object containing:
  * `status`: Current operation being performed:
    * `.readingShare`: Reading the stored share
    * `.decryptingShare`: Decrypting the share
    * `.parsingShare`: Parsing the share data
    * `.generatingShare`: Generating the share data
    * `.storingShare`: Saving the recovered share
    * `.done`: Process completed
  * `done`: Boolean indicating whether the operation is complete

**Returns**

`PortalRecoverWalletResponse` containing:

* `ethereum`: The recovered Ethereum address
* `solana`: The recovered Solana address, if available

**Throws**

* `PortalClassError.cannotRecoverWallet` if the Ethereum address cannot be recovered
* Various backup method-specific errors if recovery fails

**Example Usage**

```swift theme={null}
do {
    let recoveredWallet = try await portal.recoverWallet(
        .iCloud,
        withCipherText: backupCipherText
    ) { status in
        switch status.status {
        case .readingShare:
            print("Reading backup share...")
        case .decryptingShare:
            print("Decrypting share...")
        case .parsingShare:
            print("Parsing share data...")
        case .generatingShare:
            print("Regenerating wallet...")
        case .storingShare:
            print("Saving recovered wallet...")
        case .done:
            print("Recovery completed!")
        default:
            break
        }
    }

    print("Recovered Ethereum address: \(recoveredWallet.ethereum)")
    if let solanaAddress = recoveredWallet.solana {
        print("Recovered Solana address: \(solanaAddress)")
    }
} catch {
    print("Error recovering wallet: \(error)")
}
```