Struct RecoveryBindingManager 

pub struct RecoveryBindingManager { /* private fields */ }

Client for registering and unregistering recovery agents with the PoP backend.

Each instance is bound to a specific Environment (staging or production), which determines the backend URL used for all requests.

Implementations

impl RecoveryBindingManager

pub fn new( environment: &Environment, user_agent_builder: &UserAgentBuilder, ) -> Result<Self, WalletKitError>

Creates a new RecoveryBindingManager for the specified environment.

Errors

Returns an error if the HTTP client cannot be built.

pub fn new_with_base_url( base_url: &str, user_agent_builder: &UserAgentBuilder, ) -> Result<Self, WalletKitError>

Creates a new RecoveryBindingManager for the specified base URL and user agent.

Errors

Returns an error if the HTTP client cannot be built.

impl RecoveryBindingManager

pub async fn bind_recovery_agent( &self, authenticator: &Authenticator, sub: String, recovery_agent_address: String, ) -> Result<(), WalletKitError>

Registers a recovery agent for the given authenticator.

Arguments

• authenticator — The authenticator whose signing key authorizes the request.
• sub — Hex-encoded subject identifier of the recovery agent to register.
• recovery_agent_address — The checksummed hex address of the new recovery agent (e.g. "0x1234…").

Errors

Returns an error if the challenge fetch, signing, or backend request fails, or if the user is not eligible for recovery (WalletKitError::NotEligibleForRecovery). or if the debug report is not found (WalletKitError::DebugReportNotFound). or if any other unexpected error occurs (WalletKitError::NetworkError).

pub async fn unbind_recovery_agent( &self, authenticator: &Authenticator, sub: String, ) -> Result<(), WalletKitError>

Removes a previously registered recovery agent.

Arguments

• authenticator — The authenticator whose signing key authorizes the request.
• sub — Hex-encoded subject identifier of the recovery agent to remove.

Errors

Returns an error if the challenge fetch, signing, or backend request fails, or if the account does not exist (WalletKitError::AccountDoesNotExist).

pub async fn get_recovery_binding( &self, leaf_index: u64, ) -> Result<RecoveryBinding, WalletKitError>

Fetches a recovery binding via GET /api/v1/recovery-binding.

Arguments

• leaf_index — The authenticator’s leaf index in the World ID Merkle tree.

Errors

• WalletKitError::NetworkError — non-success HTTP status.
• WalletKitError::SerializationError — response body is not valid JSON.
• WalletKitError::RecoveryBindingDoesNotExist — HTTP 404 (no binding found).

Trait Implementations

impl<UT> LiftRef<UT> for RecoveryBindingManager

type LiftType = Arc<RecoveryBindingManager>

impl<UT> LowerError<UT> for RecoveryBindingManager

fn lower_error(obj: Self) -> RustBuffer

Lower this value for scaffolding function return

impl<UT> LowerReturn<UT> for RecoveryBindingManager

type ReturnType = <Arc<RecoveryBindingManager> as LowerReturn<UniFfiTag>>::ReturnType

The type that should be returned by scaffolding functions for this type.

fn lower_return(obj: Self) -> Result<Self::ReturnType, RustCallError>

Lower the return value from an scaffolding call

fn handle_failed_lift( error: LiftArgsError, ) -> Result<Self::ReturnType, RustCallError>

Lower the return value for failed argument lifts

impl<UT> TypeId<UT> for RecoveryBindingManager

const TYPE_ID_META: MetadataBuffer