v0.2.5-pre.005

crates/ksp-wallet-lib/src/owner.rs

@@ -1,15 +1,20 @@
 // file: crates/ksp-wallet-lib/src/owner.rs
-// version: 1
+// version: 2
 
 /// Authorized OWNER capability handle.
 ///
-/// OWNER exposes all authorized metadata and will receive signing plus Wallet administration operations in later `0.2.5` tranches without exposing a
-/// general-purpose secret-key getter.
+/// OWNER exposes protected metadata and retains the authenticated in-memory state required by later signing and administration tranches without
+/// exposing a general-purpose secret-key getter.
 pub struct WalletOwner {
     info: crate::WalletInfo,
+    state: crate::wallet::OwnerStateV1,
 }
 
 impl WalletOwner {
+    pub(crate) fn from_unlocked(info: crate::WalletInfo, state: crate::wallet::OwnerStateV1) -> Self {
+        return Self { info, state };
+    }
+
     /// Returns the authorization capability represented by this handle.
     #[must_use]
     pub const fn capability(&self) -> crate::WalletCapability {
@@ -45,10 +50,15 @@ impl WalletOwner {
         );
         return &self.info;
     }
+
+    /// Serializes the complete locked `.kspwallet` V1 document without exposing any unlocked secret material.
+    pub fn to_json_bytes(&self) -> ksp_core_lib::Result<std::vec::Vec<u8>> {
+        return self.state.envelope().to_json_bytes();
+    }
 }
 
 impl std::fmt::Debug for WalletOwner {
     fn fmt(&self, formatter: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
-        return formatter.debug_struct("WalletOwner").field("info", &self.info).finish();
+        return formatter.debug_struct("WalletOwner").field("info", &self.info).field("unlocked_state", &"<redacted>").finish();
     }
 }