Enum CoreError 

pub enum CoreError {
    Database(String),
    Validation(String),
    NotFound(String),
    InsufficientBalance {
        required: Decimal,
        available: Decimal,
    },
    TokenExists(String),
    InvalidCurveParams,
    CircuitBreakerTriggered,
    SlippageExceeded {
        expected: Decimal,
        actual: Decimal,
    },
    OrderExpired,
    TokenPaused,
    ReputationTooLow {
        required: Decimal,
        current: Decimal,
    },
    MaxSupplyReached,
    Unauthorized,
    Serialization(String),
    Calculation(String),
    OrderNotFound(Uuid),
    InvalidOrderQuantity(String),
    InvalidPrice(String),
    OrderAlreadyFilled,
    OrderAlreadyCancelled,
    InsufficientLiquidity(String),
    PriceImpactTooHigh {
        impact: Decimal,
        max_impact: Decimal,
    },
    MarketClosed,
    TradingHalted(Uuid),
    PositionLimitExceeded {
        current: Decimal,
        maximum: Decimal,
    },
    DailyTradingLimitExceeded {
        traded: Decimal,
        limit: Decimal,
    },
    ExcessiveLeverage {
        ratio: Decimal,
        max_ratio: Decimal,
    },
    MarginCall {
        equity: Decimal,
        maintenance: Decimal,
    },
    PaymentNotFound(Uuid),
    PaymentAlreadyConfirmed,
    PaymentExpired,
    InsufficientConfirmations {
        required: u32,
        current: u32,
    },
    KycRequired,
    KycPending,
    KycRejected(String),
    CommitmentNotFound(Uuid),
    CommitmentAlreadyVerified,
    CommitmentDeadlinePassed,
    RateLimitExceeded {
        retry_after: u64,
    },
    TooManyRequests(Uuid),
    ResourceLocked(String),
    OptimisticLockFailed,
    DeadlockDetected,
    Configuration(String),
    FeatureNotEnabled(String),
    InvalidState(String),
    AlreadyExists(String),
    InvalidAmount,
    InvalidBridgeRoute,
    BridgeNotSupported,
}

Core error type for all kaccy-core operations

Variants

Database(String)

A database operation failed

Validation(String)

Input validation failed

NotFound(String)

Requested resource was not found

InsufficientBalance

Account balance is insufficient for the operation

Fields

required: Decimal

Required amount

available: Decimal

Currently available amount

TokenExists(String)

A token with this identifier already exists

InvalidCurveParams

Bonding curve parameters are invalid

CircuitBreakerTriggered

A circuit breaker has been triggered for the token

SlippageExceeded

Trade slippage exceeded the configured tolerance

Fields

expected: Decimal

Expected slippage

actual: Decimal

Actual slippage

OrderExpired

Order has expired and can no longer be filled

TokenPaused

Token trading is currently paused

ReputationTooLow

User reputation is below the required threshold

Fields

required: Decimal

Required reputation score

current: Decimal

Current reputation score

MaxSupplyReached

Token maximum supply has been reached

Unauthorized

Caller is not authorised to perform this action

Serialization(String)

Serialization or deserialization failed

Calculation(String)

A numeric calculation failed

OrderNotFound(Uuid)

The specified order was not found

InvalidOrderQuantity(String)

Order quantity is invalid

InvalidPrice(String)

Order price is invalid

OrderAlreadyFilled

Order has already been filled

OrderAlreadyCancelled

Order has already been cancelled

InsufficientLiquidity(String)

Insufficient market liquidity for the trade

PriceImpactTooHigh

Trade price impact exceeds the configured maximum

Fields

impact: Decimal

Actual price impact

max_impact: Decimal

Configured maximum allowed impact

MarketClosed

Market is outside of its trading hours

TradingHalted(Uuid)

Trading for this token has been halted

PositionLimitExceeded

Position size exceeds the configured limit

Fields

current: Decimal

Current position size

maximum: Decimal

Configured maximum

DailyTradingLimitExceeded

Daily trading volume limit exceeded

Fields

traded: Decimal

Volume traded today

limit: Decimal

Configured daily limit

ExcessiveLeverage

Leverage ratio is too high

Fields

ratio: Decimal

Current leverage ratio

max_ratio: Decimal

Configured maximum ratio

MarginCall

Margin call: equity has fallen below maintenance margin

Fields

equity: Decimal

Current equity

maintenance: Decimal

Required maintenance margin

PaymentNotFound(Uuid)

The specified payment was not found

PaymentAlreadyConfirmed

Payment has already been confirmed and cannot be reprocessed

PaymentExpired

Payment has expired

InsufficientConfirmations

Not enough blockchain confirmations yet

Fields

required: u32

Required confirmation count

current: u32

Current confirmation count

KycRequired

KYC verification is required before this action

KycPending

KYC verification is in progress

KycRejected(String)

KYC verification was rejected

CommitmentNotFound(Uuid)

The specified commitment was not found

CommitmentAlreadyVerified

Commitment has already been verified

CommitmentDeadlinePassed

Commitment deadline has passed

RateLimitExceeded

Rate limit exceeded; retry after the given number of seconds

Fields

retry_after: u64

Seconds to wait before retrying

TooManyRequests(Uuid)

Too many requests from this user

ResourceLocked(String)

A resource is currently locked by another operation

OptimisticLockFailed

Optimistic locking failed because the resource was concurrently modified

DeadlockDetected

A database deadlock was detected

Configuration(String)

System configuration is invalid

FeatureNotEnabled(String)

A feature flag is not enabled

InvalidState(String)

Entity is in an invalid state for this operation

AlreadyExists(String)

Entity already exists

InvalidAmount

Provided amount is invalid

InvalidBridgeRoute

Specified bridge route is invalid

BridgeNotSupported

Bridge protocol is not supported

Implementations

impl CoreError

pub fn is_retryable(&self) -> bool

Check if error is retryable (e.g., for retry logic)

pub fn is_client_error(&self) -> bool

Check if error is a client error (4xx)

pub fn is_server_error(&self) -> bool

Check if error is a server error (5xx)

pub fn status_code(&self) -> u16

Get HTTP status code for this error

pub fn category(&self) -> &'static str

Get error category for logging and metrics

Trait Implementations

impl Debug for CoreError

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Display for CoreError

fn fmt(&self, __formatter: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Error for CoreError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<Error> for CoreError

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<Error> for CoreError

fn from(err: Error) -> Self

Converts to this type from the input type.