stellar-sdk/com.soneso.stellar.sdk.sep.sep02/FederationService/Companion/resolveStellarAddress

resolveStellarAddress

suspend fun resolveStellarAddress(address: String, httpClient: HttpClient? = null, httpRequestHeaders: Map<String, String>? = null): FederationResponse

Resolves a Stellar address in a single call by auto-discovering the federation server.

This is a convenience method that combines parseAddress, fromDomain, and resolveStellarAddress into a single operation. It automatically extracts the domain from the address, discovers the federation server from stellar.toml, and resolves the address.

Return

The federation response containing account ID and optional memo information

Parameters

address

The Stellar address to resolve (e.g., "bob*stellar.org")

httpClient

Optional custom HTTP client for testing

httpRequestHeaders

Optional custom headers for requests

Throws

Sep02InvalidAddressException

If the address format is invalid

Sep02FederationNotFoundException

If the domain's stellar.toml does not contain a federation server URL

Sep02InvalidResponseException

If the federation server returns an invalid response or the address cannot be resolved

Example:

// Resolve address in one step
val response = FederationService.resolveStellarAddress("bob*stellar.org")

println("Account: ${response.accountId}")
if (response.memo != null) {
    println("Required memo (${response.memoType}): ${response.memo}")
}