OZExternalSignerManager

Manager for external (non-passkey) signers for multi-signature smart account operations.

OZExternalSignerManager provides a unified interface for managing Stellar account signers that originate from Ed25519 secret keys or external wallet connections (e.g., Freighter, LOBSTR). It supports two methods of adding signers:

1. Keypair signers (via addFromSecret): Created from a raw Ed25519 secret key. These are held in memory only and are never persisted to storage. The secret key material is accessible only through the in-memory KeyPair instance.

2. Wallet signers: Connected through an ExternalWalletAdapter. The adapter owns the connection lifecycle (e.g., WalletConnect sessions) and surfaces live connections via ExternalWalletAdapter.getConnectedWallets; the manager delegates signing to it.

Thread Safety: The in-memory signer registries are protected by a non-suspending platform lock so they can also be cleared from non-suspend teardown paths (OZSmartAccountKit.close). Public methods can be safely called from any coroutine context.

Example usage:

val manager = OZExternalSignerManager(
    networkPassphrase = "Test SDF Network ; September 2015",
    walletAdapter = myWalletAdapter
)

// Add from secret key (memory-only)
val address = manager.addFromSecret("SCZANGBA5YHT...")
println("Added keypair signer: $address")

// Check signing capability
if (manager.canSignFor("GABC...")) {
    val result = manager.signAuthEntry("GABC...", preimageXdr)
    println("Signed by: ${result.signerAddress}")
}

// List all signers
val signers = manager.getAll()

Parameters