Skip to main content

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.

Function Signature 
public func isWalletBackedUp(
    _ forChainId: String? = nil
) async throws -> Bool
Parameters
  • forChainId: Optional chain identifier (e.g., “eip155:1” for Ethereum mainnet, “solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp” for Solana mainnet). If nil, checks backup status across all chains.
Returns A boolean value indicating whether the wallet is backed up:
  • When forChainId is provided:
    • Returns true if a wallet exists for the specified chain and has at least one completed backup share
    • Returns false if no wallet exists or if no backup shares are completed
  • When forChainId is nil:
    • Returns true if any wallet exists and has at least one completed backup share
    • Returns false if no wallets exist or if no backup shares are completed
Throws
  • PortalClassError.clientNotAvailable if the client is not initialized
Example Usage 
// Check backup status for all wallets
do {
    let isBackedUp = try await portal.isWalletBackedUp()
    if isBackedUp {
        print("At least one wallet is backed up")
    } else {
        print("No wallets are backed up")
    }
} catch {
    print("Error checking backup status: \(error)")
}

// Check backup status for specific chains
do {
    // Check Ethereum wallet backup
    let ethBackedUp = try await portal.isWalletBackedUp("eip155:1")
    if ethBackedUp {
        print("Ethereum wallet is backed up")
    }

    // Check Solana wallet backup
    let solBackedUp = try await portal.isWalletBackedUp("solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp")
    if solBackedUp {
        print("Solana wallet is backed up")
    }
} catch {
    print("Error checking chain-specific backups: \(error)")
}

// Complete example with backup flow
do {
    let isBackedUp = try await portal.isWalletBackedUp()
    if !isBackedUp {
        // Perform backup if not already done
        let backup = try await portal.backupWallet(.iCloud) { status in
            switch status.status {
            case .readingShare:
                print("Reading share...")
            case .encryptingShare:
                print("Encrypting share...")
            case .storingShare:
                print("Storing backup...")
            case .done:
                print("Backup completed!")
            default:
                break
            }
        }

        // Complete the backup process
        try await backup.storageCallback()

        // Verify backup was successful
        let verifyBackup = try await portal.isWalletBackedUp()
        print("Backup verification: \(verifyBackup ? "Success" : "Failed")")
    } else {
        print("Wallet is already backed up")
    }
} catch {
    print("Error in backup process: \(error)")
}
Implementation Notes
  • The method only considers backup shares with a status of .completed
  • Incomplete or pending backups are not considered when determining backup status
  • Useful for ensuring wallet security and prompting users to complete backup
  • Should be checked before performing critical operations
Usage in App Flow
  1. After Wallet Creation: 
    // Check backup status after creating wallet
let wallet = try await portal.createWallet()
if !(try await portal.isWalletBackedUp()) {
    // Prompt user to backup their wallet
    showBackupPrompt()
}
  2. Security Checks: 
    // Ensure wallet is backed up before large transactions
func performTransaction() async throws {
    guard try await portal.isWalletBackedUp() else {
        throw CustomError.walletNotBackedUp
    }
    // Proceed with transaction
}
Related Documentation For more information about wallet backups, see: