Skip to main content

join_with_pairing

Function join_with_pairing 

Source
pub async fn join_with_pairing(
    builder: CovenBuilder,
    code: &str,
    s3_credentials: Option<S3Credentials>,
    device_name: &str,
    on_status: impl Fn(BootstrapStatus),
    control: &JoinControl,
) -> Result<Option<CovenHandle>, BootstrapError>
Expand description

Ask one of the person’s devices, which shows code, to pair this device, and restore from what it hands over, returning the open store (None when the pairing ended before its handover opened). A restore’s rules hold from its record on; before it, cancelling through control, dropping or failing the call removes the installation, whether or not the request was sent, since approval binds nothing in history (§13.2).

S3 requires a key: the one the QR code carries, or else s3_credentials, never both. A store whose unfinished installation holds a join’s saved code or a restore’s record is refused with StoreLockError::BootstrapPending before anything changes (§13.4).