Sep24Server
Exception thrown when the SEP-24 anchor returns a server error (HTTP 5xx).
Indicates that the anchor experienced an internal error while processing the request. This is typically a temporary condition that may be resolved by retrying the request. Common causes:
Anchor service temporarily unavailable (503)
Internal server error (500)
Bad gateway (502)
Gateway timeout (504)
Anchor maintenance mode
Database or backend service issues
Recovery actions:
Retry the request after a delay
Use exponential backoff for retries
Check anchor status page if available
Contact anchor support if the problem persists
Example - Handle server error with retry:
suspend fun depositWithRetry(
sep24Service: Sep24Service,
assetCode: String,
jwt: String,
maxRetries: Int = 3
): Sep24DepositResponse? {
var delay = 1000L
repeat(maxRetries) { attempt ->
try {
return sep24Service.deposit(assetCode, jwt)
} catch (e: Sep24ServerErrorException) {
println("Server error (${e.statusCode}): ${e.message}")
if (attempt < maxRetries - 1) {
println("Retrying in ${delay}ms...")
delay(delay)
delay *= 2 // Exponential backoff
}
}
}
println("Max retries reached")
return null
}Content copied to clipboard
Example - Handle different status codes:
suspend fun handleServerError(
sep24Service: Sep24Service,
assetCode: String,
jwt: String
): Sep24DepositResponse? {
try {
return sep24Service.deposit(assetCode, jwt)
} catch (e: Sep24ServerErrorException) {
when (e.statusCode) {
503 -> {
println("Service temporarily unavailable, try again later")
}
504 -> {
println("Gateway timeout, the anchor may be overloaded")
}
else -> {
println("Server error (${e.statusCode}): ${e.message}")
}
}
return null
}
}Content copied to clipboard
See also:
Sep24Exception base class
Parameters
message
Error message from the anchor