diff --git a/changes/ticket20717 b/changes/ticket20717
new file mode 100644
index 0000000000..c896f8ad98
--- /dev/null
+++ b/changes/ticket20717
@@ -0,0 +1,4 @@
+  o Code simplification and refactoring:
+    - Refactors the hashing API to return negative values for errors as is done
+      as a standard throughout the codebase.
+    - Refactors calling functions to expect negative values for errors.