Enum AuthFailureReason 

pub enum AuthFailureReason {
    MissingCredentials,
    Unauthorized,
    TokenExpiredAndRefreshFailed,
    Suspended,
    ScopeInsufficient {
        needed: String,
    },
}

Why authentication failed. Closed set — exhaustive matches required.

Drops Copy (was present in v0.1) because Self::ScopeInsufficient now carries the missing scope name as a String payload so the LLM client can surface it.

Variants

MissingCredentials

Credentials missing — neither client_id nor client_secret were configured. Surfaces when an Account / Trading tool is called against an anonymous adapter.

Unauthorized

Credentials present but rejected by Deribit (HTTP 401 or upstream JSON-RPC code 10004).

TokenExpiredAndRefreshFailed

A previously valid token expired and the upstream refresh flow could not obtain a replacement (network error during refresh, refresh token revoked, OAuth provider timeout, …).

Suspended

Account suspended on Deribit’s side (e.g. KYC failure, regulatory hold). Distinct from Unauthorized so the LLM can advise the user to contact support rather than retry.

ScopeInsufficient

The configured credentials authenticated successfully but the requested operation needs a scope that was not granted (e.g. a Trading tool call without trade:read_write). The payload names the scope the LLM should ask the operator to add to the API key.

Fields

needed: String

Scope name as documented by Deribit (trade:read_write, account:read, wallet:read_write, …).

Trait Implementations

impl Clone for AuthFailureReason

fn clone(&self) -> AuthFailureReason

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for AuthFailureReason

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for AuthFailureReason

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for AuthFailureReason

fn eq(&self, other: &AuthFailureReason) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for AuthFailureReason

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for AuthFailureReason

impl StructuralPartialEq for AuthFailureReason