wallet-seed/com.midnight.kuira.sdk.walletseed

Package-level declarations

Types

data class EstablishResult(val did: String, val credentialId: String, val publicKeyHex: String, val reused: Boolean)

Result of SigilSession.establishSigil: the sigil's DID + credential ID, the passkey's P-256 public key hex (empty when an existing sigil was reused — a GET ceremony does not return the pubkey), and whether it was reused vs newly forged. The caller persists the triple via SigilStateStore.

ForgeResult

data class ForgeResult(val did: String, val credentialId: String, val publicKeyHex: String)

Result of SigilSession.forge: the new sigil's DID + credential ID, plus the passkey's P-256 public key hex (kept for KeyAuthorization). The caller persists the triple via SigilStateStore.

InvalidRecoveryPhraseException

class InvalidRecoveryPhraseException(message: String = "Recovery phrase is not a valid BIP-39 phrase") : Exception

The supplied recovery phrase failed BIP-39 validation (word count, unknown word, or checksum).

RecoveryNotAllowedException

class RecoveryNotAllowedException(message: String) : Exception

Restore was attempted while a wallet already exists; sign out first.

SigilSession

@Singleton

class SigilSession @Inject constructor(passkeyManager: PasskeyManager, sigilIdentityProvider: SigilIdentityProvider, sigilStateStore: SigilStateStore, walletSeedSource: WalletSeedSource)

Single-biometric bootstrap orchestrator for sign-in flows.

WalletRecovery

interface WalletRecovery

Sovereign recovery-phrase capability (#252): reveal and restore a wallet's 24-word BIP-39 recovery phrase.

WalletSeedSource

@Singleton

class WalletSeedSource @Inject constructor(context: Context, seedVault: SeedVault, walletKeyManager: WalletKeyManager, passkeyManager: PasskeyManager, sigilStateStore: SigilStateStore) : RecoverySeedStore

Single source of truth for the wallet's BIP-39 seed.