Wallet Management Functions

This reference documents wallet management with the Dynamic Swift SDK. Wallets are automatically created for authenticated users. Access them via sdk.wallets.userWallets and observe changes using Combine publishers.

Accessing User Wallets

Wallets are automatically created for authenticated users. Access them via the SDK:

let sdk = DynamicSDK.instance()

// Get all user wallets
let wallets = sdk.wallets.userWallets

// Observe wallet changes
sdk.wallets.userWalletsChanges
    .receive(on: DispatchQueue.main)
    .sink { wallets in
        print("User has \(wallets.count) wallet(s)")
    }
    .store(in: &cancellables)

BaseWallet Properties

• address (String) - Wallet address
• chain (String) - Chain identifier (e.g., “EVM”, “SOL”)
• walletName (String?) - Optional wallet name
• id (String?) - Optional wallet ID

sdk.wallets

Wallet management module for accessing and managing user wallets.

userWallets

Get the current user’s wallets.

let wallets = sdk.wallets.userWallets  // [BaseWallet]

Example

let sdk = DynamicSDK.instance()

let wallets = sdk.wallets.userWallets

for wallet in wallets {
    print("Address: \(wallet.address)")
    print("Chain: \(wallet.chain)")
}

userWalletsChanges

Combine publisher that emits when wallets change.

sdk.wallets.userWalletsChanges  // Publisher<[BaseWallet], Never>

Example

import Combine

let sdk = DynamicSDK.instance()
var cancellables = Set<AnyCancellable>()

sdk.wallets.userWalletsChanges
    .receive(on: DispatchQueue.main)
    .sink { wallets in
        print("Wallets updated: \(wallets.count) wallets")
        for wallet in wallets {
            print("  - \(wallet.chain): \(wallet.address)")
        }
    }
    .store(in: &cancellables)

getBalance

Get the balance of a wallet.

try await sdk.wallets.getBalance(wallet: BaseWallet) -> String

Parameters

• wallet (BaseWallet) - The wallet to get balance for

Returns

• String - The wallet balance

Example

let sdk = DynamicSDK.instance()

if let wallet = sdk.wallets.userWallets.first {
    do {
        let balance = try await sdk.wallets.getBalance(wallet: wallet)
        print("Balance: \(balance)")
    } catch {
        print("Failed to get balance: \(error)")
    }
}

getNetwork

Get the current network of a wallet.

try await sdk.wallets.getNetwork(wallet: BaseWallet) -> NetworkResult

Parameters

• wallet (BaseWallet) - The wallet to get network for

Returns

• NetworkResult - The current network information

Example

let sdk = DynamicSDK.instance()

if let wallet = sdk.wallets.userWallets.first {
    do {
        let network = try await sdk.wallets.getNetwork(wallet: wallet)
        print("Current network: \(network)")
    } catch {
        print("Failed to get network: \(error)")
    }
}

switchNetwork

Switch a wallet to a different network.

try await sdk.wallets.switchNetwork(wallet: BaseWallet, network: GenericNetwork)

Parameters

• wallet (BaseWallet) - The wallet to switch network for
• network (GenericNetwork) - The target network

Example

let sdk = DynamicSDK.instance()

if let wallet = sdk.wallets.userWallets.first,
   let targetNetwork = sdk.networks.evm.first {
    do {
        try await sdk.wallets.switchNetwork(wallet: wallet, network: targetNetwork)
        print("Switched to \(targetNetwork.name)")
    } catch {
        print("Failed to switch network: \(error)")
    }
}

setPrimary

Set a wallet as the user’s primary wallet.

try await sdk.wallets.setPrimary(walletId: String)

Parameters

• walletId (String) - The ID of the wallet to set as primary

Example

let sdk = DynamicSDK.instance()

if let wallet = sdk.wallets.userWallets.first,
   let walletId = wallet.id {
    do {
        try await sdk.wallets.setPrimary(walletId: walletId)
        print("Primary wallet set successfully")
    } catch {
        print("Failed to set primary wallet: \(error)")
    }
}

signMessage

Sign a message with a wallet.

try await sdk.wallets.signMessage(wallet: BaseWallet, message: String) -> String

Parameters

• wallet (BaseWallet) - The wallet to sign with
• message (String) - The message to sign

Returns

• String - The signature

Example

let sdk = DynamicSDK.instance()

if let wallet = sdk.wallets.userWallets.first {
    do {
        let signature = try await sdk.wallets.signMessage(
            wallet: wallet,
            message: "Hello, World!"
        )
        print("Signature: \(signature)")
    } catch {
        print("Failed to sign message: \(error)")
    }
}

signTypedData

Sign EIP-712 typed data with a wallet.

try await sdk.wallets.signTypedData(wallet: BaseWallet, typedDataJson: String) -> String

Parameters

• wallet (BaseWallet) - The wallet to sign with
• typedDataJson (String) - The typed data as a JSON string

Returns

• String - The signature

Example

let sdk = DynamicSDK.instance()

let typedData = """
{
    "types": {
        "EIP712Domain": [
            {"name": "name", "type": "string"},
            {"name": "version", "type": "string"},
            {"name": "chainId", "type": "uint256"}
        ],
        "Message": [
            {"name": "content", "type": "string"}
        ]
    },
    "primaryType": "Message",
    "domain": {
        "name": "Example",
        "version": "1",
        "chainId": 1
    },
    "message": {
        "content": "Hello!"
    }
}
"""

if let wallet = sdk.wallets.userWallets.first {
    do {
        let signature = try await sdk.wallets.signTypedData(
            wallet: wallet,
            typedDataJson: typedData
        )
        print("Signature: \(signature)")
    } catch {
        print("Failed to sign typed data: \(error)")
    }
}

verifySignature

Verify a message signature.

try await sdk.wallets.verifySignature(
    message: String,
    signature: String,
    walletAddress: String
) -> Bool

Parameters

• message (String) - Original message that was signed
• signature (String) - Signature to verify
• walletAddress (String) - Wallet address that signed the message

Returns

• Bool - True if signature is valid, false otherwise

Example

let sdk = DynamicSDK.instance()
let message = "Hello There!"
let signature = "0x..." // Signature from signing step
let walletAddress = wallet.address

do {
    let verificationResult = try await sdk.wallets.verifySignature(
        message: message,
        signature: signature,
        walletAddress: walletAddress
    )

    print("Verification Result: \(verificationResult)")
} catch {
    print("Failed to verify signature: \(error)")
}

checkKeySharesAvailability

Check if key shares are available for a wallet address.

let hasKeyShares = checkKeySharesAvailability(
    client: dynamicClient,
    walletAddress: ethereumWallet.address.asString()
)

print("Key shares available: \(hasKeyShares)")

Wallet Filtering

Filter by Chain

let sdk = DynamicSDK.instance()

// Get EVM wallets
let evmWallets = sdk.wallets.userWallets.filter {
    $0.chain.uppercased() == "EVM"
}

// Get Solana wallets
let solanaWallets = sdk.wallets.userWallets.filter {
    $0.chain.uppercased() == "SOL"
}

Complete Wallet Management Example

import SwiftUI
import DynamicSDKSwift
import Combine

@MainActor
class WalletViewModel: ObservableObject {
    @Published var wallets: [BaseWallet] = []
    @Published var selectedWallet: BaseWallet?
    @Published var balance: String?
    @Published var isLoading = false

    private let sdk = DynamicSDK.instance()
    private var cancellables = Set<AnyCancellable>()

    func startListening() {
        // Get current wallets
        wallets = sdk.wallets.userWallets
        selectedWallet = wallets.first

        // Listen for updates
        sdk.wallets.userWalletsChanges
            .receive(on: DispatchQueue.main)
            .sink { [weak self] newWallets in
                self?.wallets = newWallets
                if self?.selectedWallet == nil {
                    self?.selectedWallet = newWallets.first
                }
            }
            .store(in: &cancellables)
    }

    func refreshBalance() {
        guard let wallet = selectedWallet else { return }

        isLoading = true
        Task {
            do {
                balance = try await sdk.wallets.getBalance(wallet: wallet)
            } catch {
                print("Balance error: \(error)")
            }
            isLoading = false
        }
    }

    func signMessage(_ message: String) async -> String? {
        guard let wallet = selectedWallet else { return nil }

        do {
            return try await sdk.wallets.signMessage(wallet: wallet, message: message)
        } catch {
            print("Sign error: \(error)")
            return nil
        }
    }
}