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 profile_public_key(&self, profile_ix: u32) -> [u8; 48]
pub fn profile_public_key(&self, profile_ix: u32) -> [u8; 48]
The 48-byte compressed BLS12-381 G1 dig-identity public key for the
profile at profile_ix, derived from the seed at
m/12381'/8444'/9'/{profile_ix}' via
dig_identity::derive_identity_sk_at.
§profile_ix == 0 is byte-identical to public_key
derive_identity_sk_at(master, 0) == derive_identity_sk(master)
(adversarial-confirmed in dig-identity 0.5.0), so
profile_public_key(0) == public_key() byte-for-byte — the default path is
exactly profile 0, and this method is a pure ADDITIVE generalization
(§5.1). Each profile_ix yields a distinct, deterministic identity key.
Sourcepub fn profile_sign(&self, profile_ix: u32, msg: &[u8]) -> [u8; 96]
pub fn profile_sign(&self, profile_ix: u32, msg: &[u8]) -> [u8; 96]
Sign msg with the profile at profile_ix’s derived identity key,
returning the 96-byte G2 AugScheme signature.
The signature verifies under
profile_public_key(profile_ix).
profile_sign(0, msg) == sign(msg) byte-for-byte (§5.1 additive).
Sourcepub fn profile_derive_symmetric_key(
&self,
profile_ix: u32,
label: &[u8],
) -> Zeroizing<[u8; 32]>
pub fn profile_derive_symmetric_key( &self, profile_ix: u32, label: &[u8], ) -> Zeroizing<[u8; 32]>
Derive the profile at profile_ix’s per-profile symmetric key (DEK) bound
to label.
The profile’s identity scalar is derived from the seed via
dig_identity::derive_identity_sk_at and fed to the SAME frozen HKDF
construction as every other DEK path
([derive_symmetric_key_from_scalar]) — the HKDF is never duplicated, so
all paths stay byte-compatible for the same underlying scalar.
§profile_ix == 0 is byte-identical to
Because derive_identity_sk_at(master, 0) == derive_identity_sk(master),
profile_derive_symmetric_key(0, label) == derive_symmetric_key(label)
byte-for-byte — so a profile blob sealed via the default path opens
unchanged (§5.1 at-rest back-compat). Each profile_ix yields a distinct,
deterministic DEK.
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.