flamberge-keys 0.1.1

Key acquisition for Flamberge: PID generation, offline name+CC keygen, and platform key extraction
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58

//! Key acquisition for the DeDRM schemes.
//!
//! Two kinds of key source, mirroring the Python tools:
//! * **Offline generators** (pure crypto, reproducible anywhere): PID encoders
//!   (`pid`), B&N name+CC keygen (`ignoble`), eReader name+CC key (`ereader`),
//!   Kobo device-key derivation (`kobo`). These are implemented.
//! * **Platform extraction** (reads local DRM-app state — registry/DPAPI,
//!   plists, SQLite): `kindle`, `adobe`. These are stubbed and are the parts
//!   that require a specific host OS + user profile.
//!
//! Reference: `docs/DEDRM_SCHEMES.md` §2.5, §4, §6, §7.2, §8.2, §9.2.

pub mod adobe;
pub mod ereader;
pub mod error;
pub mod ignoble;
pub mod kindle;
pub mod kobo;
pub mod pid;

pub use error::KeyError;

pub type Result<T> = std::result::Result<T, KeyError>;

/// All candidate keys gathered for a decryption attempt. Schemes brute-force the
/// relevant bucket against the book. Mirrors the plugin's prefs buckets.
#[derive(Debug, Default, Clone)]
pub struct KeyStore {
    /// Explicit Mobipocket/Topaz/KFX PIDs (8- or 10-char).
    pub pids: Vec<String>,
    /// Kindle device serial numbers (eInk / android-derived).
    pub serials: Vec<String>,
    /// Adobe ADEPT user keys: DER-encoded RSA private keys.
    pub adept_keys: Vec<Vec<u8>>,
    /// Barnes & Noble user keys (28-char base64 `ccHash`).
    pub bandn_keys: Vec<String>,
    /// eReader user keys (8-byte DES keys, hex in the plugin prefs).
    pub ereader_keys: Vec<[u8; 8]>,
    /// Kobo candidate user keys (16-byte AES keys).
    pub kobo_keys: Vec<[u8; 16]>,
    /// Raw bytes of the Kobo library SQLite DB (`KoboReader.sqlite` /
    /// `Kobo.sqlite`). Unlike other schemes, the Kobo per-file wrapped page keys
    /// live outside the book, in this DB (§9.3); the scheme reads them from here.
    pub kobo_db: Option<Vec<u8>>,
    /// Which Kobo volume (book) the input corresponds to. When `None` and the DB
    /// holds exactly one volume, that volume is used.
    pub kobo_volumeid: Option<String>,
    /// Decoded Kindle key databases (from `.k4i` / `.kinf`). Unlike bare
    /// serials, a full DB carries the account DSN + token, so the Kindle schemes
    /// derive extra candidate PIDs from it via [`pid::k4_pids`] (§6.2).
    pub kindle_dbs: Vec<kindle::KindleDb>,
}

impl KeyStore {
    pub fn new() -> Self {
        Self::default()
    }
}