visual-hashing 0.1.0

Human-friendly visual fingerprints for keys and checksums: a nameable 64-emoji BLAKE3 hash (emojihash) and OpenSSH-style drunken-bishop randomart
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

// SPDX-FileCopyrightText: 2026 Blackcat Informatics® Inc. <paudley@blackcatinformatics.ca>
// SPDX-License-Identifier: MIT OR Apache-2.0

//! Human-friendly **visual fingerprints** for keys, checksums, and any byte
//! string you need a human to compare out-of-band.
//!
//! Two complementary renderings, both pure functions of the input bytes:
//!
//! - [`emojihash`] / [`emojihash_labels`] — a BLAKE3-XOF digest sliced into
//!   6-bit symbols indexing a fixed, nameable 64-emoji alphabet. Short, glanceable,
//!   and speakable ("monkey pig apple …").
//! - [`randomart`] — the OpenSSH-style "Drunken Bishop" ASCII-art grid you see
//!   in `ssh-keygen -lv` output.
//!
//! ```
//! use visual_hashing::{emojihash, emojihash_labels, randomart};
//!
//! let key = b"\x00\x01\x02\x03";
//! println!("{}", emojihash(key, 11));        // 🐵 🐶 … (11 emoji)
//! println!("{}", emojihash_labels(key, 11)); // monkey dog …
//! println!("{}", randomart(key, "ED25519")); // +--[ED25519 …
//! ```
//!
//! Both renderings are byte-for-byte deterministic and gated by a frozen
//! conformance corpus, so independent implementations agree exactly.

mod emojihash;
mod randomart;

pub use emojihash::{emoji_indices, emojihash, emojihash_labels, ALPHABET_SIZE, EMOJI, LABELS};
pub use randomart::randomart;