Enum PairCodeError 

#[non_exhaustive]
pub enum PairCodeError {
    PhoneNumberRequired,
    PhoneNumberTooShort,
    PhoneNumberNotInternational,
    InvalidCustomCode,
    CodeAlreadyOutstanding {
        remaining: Duration,
    },
    InvalidWrappedData {
        expected: usize,
        got: usize,
    },
    InvalidPrimaryEphemeralKey(CurveError),
    InvalidPrimaryIdentityKey(CurveError),
    EphemeralKeyAgreement(CurveError),
    IdentityKeyAgreement(CurveError),
    AdvSecretKeyDerivation,
    BundleKeyDerivation,
    BundleAead(CryptoProviderError),
    NotWaiting,
    MissingPairingRef,
    Cancelled,
}

Errors raised by wacore-side pair-code validation, key derivation, and protocol-bundle building. The high-level crate wraps this in whatsapp_rust::pair_code::PairError and adds an IQ-failure variant for the transport layer.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

PhoneNumberRequired

PhoneNumberTooShort

PhoneNumberNotInternational

InvalidCustomCode

CodeAlreadyOutstanding

A code is already displayed and still within its validity window.

Minting a second one does not replace the first for the phone: the server routes primary_hello by number, so whoever enters the older code still reaches stage 2 and receives a key bundle their code cannot open — the phone reports a failed link and the companion sees nothing. WA Web forbids the overlap with invariant(stage === Initialized). Cancel the outstanding flow first if the replacement is intentional.

Fields

remaining: Duration

InvalidWrappedData

Fields

expected: usize

got: usize

InvalidPrimaryEphemeralKey(CurveError)

InvalidPrimaryIdentityKey(CurveError)

EphemeralKeyAgreement(CurveError)

IdentityKeyAgreement(CurveError)

AdvSecretKeyDerivation

BundleKeyDerivation

BundleAead(CryptoProviderError)

NotWaiting

MissingPairingRef

Cancelled

The flow was cancelled (or replaced) while companion_hello was in flight, so the code stage 1 produced was never installed.

Trait Implementations

impl Debug for PairCodeError

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

Formats the value using the given formatter.

impl Display for PairCodeError

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

Formats the value using the given formatter.

impl Error for PairCodeError

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<PairCodeError> for PairError

fn from(source: PairCodeError) -> Self

Converts to this type from the input type.