Struct PopBackendClient 

pub struct PopBackendClient { /* private fields */ }

Low-level HTTP client for the Proof-of-Personhood (PoP) backend API.

Handles the REST calls for recovery binding management and challenge retrieval. All requests that mutate state require a security token (signature) and a challenge, passed via X-Auth-Signature and X-Auth-Challenge headers.

This client is not meant to be used directly — prefer super::RecoveryBindingManager, which orchestrates the full challenge-response signing flow.

Implementations

impl PopBackendClient

pub fn new(base_url: String, user_agent: String) -> Self

Creates a new client targeting the given base URL.

impl PopBackendClient

pub async fn bind_recovery_agent( &self, request: ManageRecoveryBindingRequest, security_token: String, challenge: String, ) -> Result<(), WalletKitError>

Registers a new recovery binding via POST /api/v1/recovery-binding.

Errors

• WalletKitError::DebugReportNotFound — HTTP 404 Not Found.
• WalletKitError::NotEligibleForRecovery — HTTP 412 Precondition Failed.
• WalletKitError::NetworkError — any other non-success status; the response body is in error and the HTTP status in status. This includes conflicts (e.g. HTTP 409) and server errors.

pub async fn unbind_recovery_agent( &self, request: ManageRecoveryBindingRequest, security_token: String, challenge: String, ) -> Result<(), WalletKitError>

Removes a recovery binding via DELETE /api/v1/recovery-binding.

Errors

• WalletKitError::AccountDoesNotExist — HTTP 404 (no binding found).
• WalletKitError::NetworkError — any other non-success status.

pub async fn get_challenge(&self) -> Result<String, WalletKitError>

Fetches a one-time challenge string via GET /api/v1/challenge.

The returned challenge is used as input to the commitment signature required by the register/unregister endpoints.

Errors

• WalletKitError::NetworkError — non-success HTTP status.
• WalletKitError::SerializationError — response body is not valid JSON.

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

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

Errors

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