pub struct UnlockedMasterSeed { /* private fields */ }Expand description
A live, in-memory master HD seed whose bytes have been decrypted and are
ready to (a) reconstruct the wallet MasterKey app-side and (b) derive the
dig-identity signing key + profile DEK in-crate.
Obtained from crate::Session::enroll_master_seed or
crate::Session::unlock_master_seed. The seed lives inside the wrapped
SignerHandle, which stores it in a Zeroizing buffer and wipes it when
this value is dropped. The type deliberately does not implement Clone and
its Debug impl redacts the secret.
§Boundaries
An UnlockedMasterSeed must never cross an IPC boundary: it holds the root
wallet seed and belongs solely to the user-app process that owns the identity
(dig_ecosystem #908). The seed stays user-side; this crate crosses no
engine/IPC boundary.
Implementations§
Source§impl UnlockedMasterSeed
impl UnlockedMasterSeed
Sourcepub fn master_seed(&self) -> Zeroizing<[u8; 32]>
pub fn master_seed(&self) -> Zeroizing<[u8; 32]>
The raw master HD seed bytes, as a primitive Zeroizing<[u8; SEED_LEN]>.
This is the value an app-tier consumer feeds to wallet-backend’s
MasterKey::from_seed_bytes to reconstruct the wallet master key
(MasterKey::from_seed_bytes(handle.master_seed())). The returned buffer
is Zeroizing, so the caller’s copy is wiped on drop — it is the caller’s
responsibility to keep it zeroizing all the way into from_seed_bytes
(whose parameter is itself moved into a Zeroizing buffer).
A primitive byte array is returned (never a wallet-backend type) to keep
dig-session free of any upward @10 -> @20 dependency edge.
Sourcepub fn public_key(&self) -> [u8; 48]
pub fn public_key(&self) -> [u8; 48]
The 48-byte compressed BLS12-381 G1 dig-identity public key derived from the seed.
Byte-identical to
dig_identity::public_key_bytes(derive_identity_sk(master_secret_key_from_seed(seed)))
and to the 0.2.0 identity path’s public key for the same seed — so
signatures produced here verify against the published DID identity.
Sourcepub fn sign(&self, msg: &[u8]) -> [u8; 96]
pub fn sign(&self, msg: &[u8]) -> [u8; 96]
Sign msg with the dig-identity key derived from the seed, returning the
96-byte G2 AugScheme signature.
The signature verifies under public_key.
Sourcepub fn derive_symmetric_key(&self, label: &[u8]) -> Zeroizing<[u8; 32]>
pub fn derive_symmetric_key(&self, label: &[u8]) -> Zeroizing<[u8; 32]>
Derive a per-profile symmetric key (DEK) bound to label.
Byte-identical to crate::UnlockedIdentity::derive_symmetric_key
for the same underlying identity: the identity scalar is re-derived from
the seed and fed to the SAME frozen HKDF construction
(HKDF-SHA256(ikm = IDENTITY_IKM_VERSION || identity_scalar, salt = DEK_SALT, info = label) → SYMMETRIC_KEY_LEN bytes). So a
profile blob sealed via the 0.2.0 identity path opens unchanged after a
consumer migrates to the master-seed path (§5.1 at-rest back-compat).
The returned key and all intermediates are wrapped in Zeroizing.
Sourcepub fn signing_fn(&self) -> IdentitySigningFn
pub fn signing_fn(&self) -> IdentitySigningFn
Produce a standalone signing primitive that signs with this identity’s key — a plain callable carrying no dig-session or identity type.
The closure owns its own zeroizing copy of the seed, so it keeps working after this handle is dropped and wipes its copy when the closure itself is dropped. This is how a downstream stays identity-agnostic while still being able to sign (dig_ecosystem #908).
Trait Implementations§
Auto Trait Implementations§
impl Freeze for UnlockedMasterSeed
impl RefUnwindSafe for UnlockedMasterSeed
impl Send for UnlockedMasterSeed
impl Sync for UnlockedMasterSeed
impl Unpin for UnlockedMasterSeed
impl UnsafeUnpin for UnlockedMasterSeed
impl UnwindSafe for UnlockedMasterSeed
Blanket Implementations§
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
impl<ST, DT> CastableFrom<ST, Initialized, Initialized> for DT
impl<ST, DT> CastableFrom<ST, Uninit, Uninit> for DT
Source§impl<T> FmtForward for T
impl<T> FmtForward for T
Source§fn fmt_binary(self) -> FmtBinary<Self>where
Self: Binary,
fn fmt_binary(self) -> FmtBinary<Self>where
Self: Binary,
self to use its Binary implementation when Debug-formatted.Source§fn fmt_display(self) -> FmtDisplay<Self>where
Self: Display,
fn fmt_display(self) -> FmtDisplay<Self>where
Self: Display,
self to use its Display implementation when
Debug-formatted.Source§fn fmt_lower_exp(self) -> FmtLowerExp<Self>where
Self: LowerExp,
fn fmt_lower_exp(self) -> FmtLowerExp<Self>where
Self: LowerExp,
self to use its LowerExp implementation when
Debug-formatted.Source§fn fmt_lower_hex(self) -> FmtLowerHex<Self>where
Self: LowerHex,
fn fmt_lower_hex(self) -> FmtLowerHex<Self>where
Self: LowerHex,
self to use its LowerHex implementation when
Debug-formatted.Source§fn fmt_octal(self) -> FmtOctal<Self>where
Self: Octal,
fn fmt_octal(self) -> FmtOctal<Self>where
Self: Octal,
self to use its Octal implementation when Debug-formatted.Source§fn fmt_pointer(self) -> FmtPointer<Self>where
Self: Pointer,
fn fmt_pointer(self) -> FmtPointer<Self>where
Self: Pointer,
self to use its Pointer implementation when
Debug-formatted.Source§fn fmt_upper_exp(self) -> FmtUpperExp<Self>where
Self: UpperExp,
fn fmt_upper_exp(self) -> FmtUpperExp<Self>where
Self: UpperExp,
self to use its UpperExp implementation when
Debug-formatted.Source§fn fmt_upper_hex(self) -> FmtUpperHex<Self>where
Self: UpperHex,
fn fmt_upper_hex(self) -> FmtUpperHex<Self>where
Self: UpperHex,
self to use its UpperHex implementation when
Debug-formatted.Source§impl<T> Pipe for Twhere
T: ?Sized,
impl<T> Pipe for Twhere
T: ?Sized,
Source§fn pipe<R>(self, func: impl FnOnce(Self) -> R) -> Rwhere
Self: Sized,
fn pipe<R>(self, func: impl FnOnce(Self) -> R) -> Rwhere
Self: Sized,
Source§fn pipe_ref<'a, R>(&'a self, func: impl FnOnce(&'a Self) -> R) -> Rwhere
R: 'a,
fn pipe_ref<'a, R>(&'a self, func: impl FnOnce(&'a Self) -> R) -> Rwhere
R: 'a,
self and passes that borrow into the pipe function. Read moreSource§fn pipe_ref_mut<'a, R>(&'a mut self, func: impl FnOnce(&'a mut Self) -> R) -> Rwhere
R: 'a,
fn pipe_ref_mut<'a, R>(&'a mut self, func: impl FnOnce(&'a mut Self) -> R) -> Rwhere
R: 'a,
self and passes that borrow into the pipe function. Read moreSource§fn pipe_borrow<'a, B, R>(&'a self, func: impl FnOnce(&'a B) -> R) -> R
fn pipe_borrow<'a, B, R>(&'a self, func: impl FnOnce(&'a B) -> R) -> R
Source§fn pipe_borrow_mut<'a, B, R>(
&'a mut self,
func: impl FnOnce(&'a mut B) -> R,
) -> R
fn pipe_borrow_mut<'a, B, R>( &'a mut self, func: impl FnOnce(&'a mut B) -> R, ) -> R
Source§fn pipe_as_ref<'a, U, R>(&'a self, func: impl FnOnce(&'a U) -> R) -> R
fn pipe_as_ref<'a, U, R>(&'a self, func: impl FnOnce(&'a U) -> R) -> R
self, then passes self.as_ref() into the pipe function.Source§fn pipe_as_mut<'a, U, R>(&'a mut self, func: impl FnOnce(&'a mut U) -> R) -> R
fn pipe_as_mut<'a, U, R>(&'a mut self, func: impl FnOnce(&'a mut U) -> R) -> R
self, then passes self.as_mut() into the pipe
function.Source§fn pipe_deref<'a, T, R>(&'a self, func: impl FnOnce(&'a T) -> R) -> R
fn pipe_deref<'a, T, R>(&'a self, func: impl FnOnce(&'a T) -> R) -> R
self, then passes self.deref() into the pipe function.impl<T> Read<Exclusive, BecauseExclusive> for Twhere
T: ?Sized,
Source§impl<T> Tap for T
impl<T> Tap for T
Source§fn tap_borrow<B>(self, func: impl FnOnce(&B)) -> Self
fn tap_borrow<B>(self, func: impl FnOnce(&B)) -> Self
Borrow<B> of a value. Read moreSource§fn tap_borrow_mut<B>(self, func: impl FnOnce(&mut B)) -> Self
fn tap_borrow_mut<B>(self, func: impl FnOnce(&mut B)) -> Self
BorrowMut<B> of a value. Read moreSource§fn tap_ref<R>(self, func: impl FnOnce(&R)) -> Self
fn tap_ref<R>(self, func: impl FnOnce(&R)) -> Self
AsRef<R> view of a value. Read moreSource§fn tap_ref_mut<R>(self, func: impl FnOnce(&mut R)) -> Self
fn tap_ref_mut<R>(self, func: impl FnOnce(&mut R)) -> Self
AsMut<R> view of a value. Read moreSource§fn tap_deref<T>(self, func: impl FnOnce(&T)) -> Self
fn tap_deref<T>(self, func: impl FnOnce(&T)) -> Self
Deref::Target of a value. Read moreSource§fn tap_deref_mut<T>(self, func: impl FnOnce(&mut T)) -> Self
fn tap_deref_mut<T>(self, func: impl FnOnce(&mut T)) -> Self
Deref::Target of a value. Read moreSource§fn tap_dbg(self, func: impl FnOnce(&Self)) -> Self
fn tap_dbg(self, func: impl FnOnce(&Self)) -> Self
.tap() only in debug builds, and is erased in release builds.Source§fn tap_mut_dbg(self, func: impl FnOnce(&mut Self)) -> Self
fn tap_mut_dbg(self, func: impl FnOnce(&mut Self)) -> Self
.tap_mut() only in debug builds, and is erased in release
builds.Source§fn tap_borrow_dbg<B>(self, func: impl FnOnce(&B)) -> Self
fn tap_borrow_dbg<B>(self, func: impl FnOnce(&B)) -> Self
.tap_borrow() only in debug builds, and is erased in release
builds.Source§fn tap_borrow_mut_dbg<B>(self, func: impl FnOnce(&mut B)) -> Self
fn tap_borrow_mut_dbg<B>(self, func: impl FnOnce(&mut B)) -> Self
.tap_borrow_mut() only in debug builds, and is erased in release
builds.Source§fn tap_ref_dbg<R>(self, func: impl FnOnce(&R)) -> Self
fn tap_ref_dbg<R>(self, func: impl FnOnce(&R)) -> Self
.tap_ref() only in debug builds, and is erased in release
builds.Source§fn tap_ref_mut_dbg<R>(self, func: impl FnOnce(&mut R)) -> Self
fn tap_ref_mut_dbg<R>(self, func: impl FnOnce(&mut R)) -> Self
.tap_ref_mut() only in debug builds, and is erased in release
builds.Source§fn tap_deref_dbg<T>(self, func: impl FnOnce(&T)) -> Self
fn tap_deref_dbg<T>(self, func: impl FnOnce(&T)) -> Self
.tap_deref() only in debug builds, and is erased in release
builds.