diff --git a/CHANGELOG.md b/CHANGELOG.md
index 2781fb9..3e9023a 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,17 @@
 # Changelog
 
+## 0.31.7 (2026-06-17)
+
+### Added
+- `derive_media_key_and_pk_from_dk(mkb, dks) -> Option<(media_key, processing_key)>`:
+  expose the intermediate Processing Key the subset-difference walk already
+  computes, so callers can record the full key lineage on a Device-Key walk.
+
+### Changed
+- Unify the subset-difference walk: the duplicate `aesg3`/`calc_v_mask`/
+  `calc_pk_from_dk` copies are consolidated to one definition. No behavior change.
+
+
 ## 0.31.6 (2026-06-09)
 
 ### Fixed
diff --git a/Cargo.toml b/Cargo.toml
index 91e979a..53e3998 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -1,6 +1,6 @@
 [package]
 name = "libfreemkv"
-version = "0.31.6"
+version = "0.31.7"
 edition = "2024"
 rust-version = "1.86"
 license = "AGPL-3.0-only"