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).