stellar-sdk/com.soneso.stellar.sdk.sep.sep38.exceptions/Sep38Exception

Sep38Exception

open class Sep38Exception(message: String, cause: Throwable? = null) : Exception

Base exception class for SEP-38 Quote API errors.

All SEP-38-specific exceptions extend this class to enable unified error handling while providing specific error types for different failure scenarios.

This exception hierarchy allows applications to handle quote API errors at different levels:

Catch Sep38Exception for general quote API error handling
Catch specific subclasses for precise error recovery

Common error scenarios:

Sep38BadRequestException: Invalid parameters (400)
Sep38PermissionDeniedException: Authentication failed (403)
Sep38NotFoundException: Quote not found (404)
Sep38UnknownResponseException: Unexpected HTTP status

Example - General error handling:

try {
    val quote = quoteService.postQuote(request, jwt)
} catch (e: Sep38BadRequestException) {
    // Invalid request parameters
    println("Bad request: ${e.message}")
} catch (e: Sep38PermissionDeniedException) {
    // Authentication failed
    println("Permission denied, please re-authenticate")
} catch (e: Sep38Exception) {
    // Other quote API errors
    println("Quote error: ${e.message}")
}

Example - Specific error recovery:

try {
    val quote = quoteService.getQuote(quoteId, jwt)
} catch (e: Sep38NotFoundException) {
    println("Quote not found, it may have expired")
    // Request new quote
} catch (e: Sep38PermissionDeniedException) {
    println("Invalid token, re-authenticating...")
    // Re-authenticate via SEP-10
}

Inheritors

Sep38BadRequestException

Sep38NotFoundException

Sep38PermissionDeniedException

Sep38UnknownResponseException

Constructors

Sep38Exception

constructor(message: String, cause: Throwable? = null)

Properties

cause

expect open val cause: Throwable?

message

expect open val message: String?

Functions

toString

open override fun toString(): String