feat(ffi): add satscard waitStep for auth delay progress

Author: reez

cktap-ffi/src/lib.rs

@@ -14,7 +14,7 @@ use crate::sats_chip::SatsChip;
 use crate::tap_signer::TapSigner;
 use futures::lock::Mutex;
 use rust_cktap::shared::FactoryRootKey;
-use rust_cktap::shared::{Certificate, Read};
+use rust_cktap::shared::{Certificate, Read, Wait};
 use std::fmt::Debug;
 use std::sync::Arc;
 
@@ -84,3 +84,12 @@ async fn check_cert(card: &mut (impl Certificate + Send + Sync)) -> Result<(), C
         }),
     }
 }
+
+async fn wait_step(card: &mut (impl Wait + Send + Sync)) -> Result<Option<u8>, CkTapError> {
+    if card.auth_delay().is_none() {
+        return Ok(None);
+    }
+
+    let remaining_delay = card.wait(None).await.map_err(CkTapError::from)?;
+    Ok(remaining_delay.map(|delay| delay as u8))
+}

cktap-ffi/src/sats_card.rs

@@ -1,10 +1,10 @@
 // Copyright (c) 2025 rust-cktap contributors
 // SPDX-License-Identifier: MIT OR Apache-2.0
 
-use crate::check_cert;
 use crate::error::{
     CertsError, CkTapError, DeriveError, DumpError, ReadError, SignPsbtError, UnsealError,
 };
+use crate::{check_cert, wait_step};
 use futures::lock::Mutex;
 use rust_cktap::descriptor::Wpkh;
 use rust_cktap::shared::{Authentication, Nfc, Read, Wait};
@@ -77,6 +77,12 @@ impl SatsCard {
         Ok(())
     }
 
+    /// Wait one second of auth delay and return the remaining delay, if any.
+    pub async fn wait_step(&self) -> Result<Option<u8>, CkTapError> {
+        let mut card = self.0.lock().await;
+        wait_step(&mut *card).await
+    }
+
     /// Verify the card has authentic Coinkite root certificate
     pub async fn check_cert(&self) -> Result<(), CertsError> {
         let mut card = self.0.lock().await;