stellar-sdk/com.soneso.stellar.sdk.smartaccount.oz/ExternalWalletAdapter

ExternalWalletAdapter

Protocol for integrating external wallet adapters for multi-signer support.

External wallet adapters enable signing with external wallets like Freighter or Albedo for multi-signature smart accounts. They handle wallet connection, signature collection, and wallet reconnection.

Example implementation:

class FreighterAdapter : ExternalWalletAdapter {
    override suspend fun connect(): ConnectedWallet? {
        // Show wallet selection modal
        return ConnectedWallet(address = "G...", walletId = "freighter", walletName = "Freighter")
    }

    override suspend fun signAuthEntry(
        preimageXdr: String,
        options: SignAuthEntryOptions?
    ): SignAuthEntryResult {
        // Decode preimage, hash with SHA-256, sign with Ed25519
        val preimageBytes = Base64.decode(preimageXdr)
        val hash = sha256(preimageBytes)
        val signature = freighterSign(hash, options?.address)
        return SignAuthEntryResult(
            signedAuthEntry = Base64.encode(signature),
            signerAddress = options?.address
        )
    }
}