Struct RpcError 

pub struct RpcError {
    pub code: i32,
    pub name: String,
    pub value: Option<u32>,
}

An error returned by Telegram’s servers in response to an RPC call.

Numeric values are stripped from the name and placed in RpcError::value.

Example

FLOOD_WAIT_30 → RpcError { code: 420, name: "FLOOD_WAIT", value: Some(30) }

Fields

code: i32

HTTP-like status code.

name: String

Error name in SCREAMING_SNAKE_CASE with digits removed.

value: Option<u32>

Numeric suffix extracted from the name, if any.

Implementations

impl RpcError

pub fn from_telegram(code: i32, message: &str) -> Self

Parse a raw Telegram error message like "FLOOD_WAIT_30" into an RpcError.

pub fn is(&self, pattern: &str) -> bool

Match on the error name, with optional wildcard prefix/suffix '*'.

Examples

• err.is("FLOOD_WAIT"): exact match
• err.is("PHONE_CODE_*"): starts-with match
• err.is("*_INVALID"): ends-with match

pub fn flood_wait_seconds(&self) -> Option<u64>

Returns the flood-wait duration in seconds, if this is a FLOOD_WAIT error.

impl RpcError

Extension methods on crate::errors::RpcError for routing decisions.

pub fn migrate_dc_id(&self) -> Option<i32>

If this is a DC-migration redirect (code 303), returns the target DC id.

Telegram sends these for:

• PHONE_MIGRATE_X : user’s home DC during auth
• NETWORK_MIGRATE_X: general redirect
• FILE_MIGRATE_X : file download/upload DC
• USER_MIGRATE_X : account migration

All have code == 303 and a numeric suffix that is the DC id.

Trait Implementations

impl Clone for RpcError

fn clone(&self) -> RpcError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RpcError

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

Formats the value using the given formatter.

impl Display for RpcError

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

Formats the value using the given formatter.

impl Error for RpcError

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 PartialEq for RpcError

fn eq(&self, other: &RpcError) -> 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 StructuralPartialEq for RpcError