Module event_id 

Binary codec and fast hashing for event IDs.

Since room v3 an event ID is the event’s sha256 reference hash: $ followed by 43 characters of unpadded base64 (standard alphabet in v3, URL-safe in v4+), so the 32 hash bytes and the ID convert losslessly in both directions.

TODO: Move this into Ruma and generalize for other identifiers.

Re-exports

use std::hash::BuildHasher; 🔒

use std::hash::Hasher; 🔒

use std::ops::BitOr; 🔒

use std::sync::LazyLock; 🔒

use base64::Engine; 🔒

use base64::engine::general_purpose::URL_SAFE_NO_PAD; 🔒

use rand::random; 🔒

use ruma::EventId; 🔒

use ruma::OwnedEventId; 🔒

use tuwunel_core::utils::math::u64_from_usize_saturating; 🔒

Structs

FoldHasher

Streaming state for RandomState.

RandomState

BuildHasher for event-ID-keyed maps and sets.

Constants

ALPHABET_LEN 🔒

ALPHABET_STANDARD 🔒

ALPHABET_URL_SAFE 🔒

ENCODED_LEN 🔒

INVALID 🔒

SEXTETS_LEN 🔒

Statics

SEED 🔒

SEXTETS 🔒

Functions

decode

Decode an event ID into the sha256 it encodes. None unless the ID has the v3+ shape with canonical unpadded base64 in either alphabet.

decode_bytes 🔒

decode_encoded 🔒

encode

Encode a sha256 into the URL-safe (room v4+) form of the event ID. A v3 (standard-alphabet) ID does not round-trip through this form.

fold 🔒

fold_bytes 🔒

folded_multiply 🔒

hash_bytes 🔒

sextets 🔒

Type Aliases

Sha256

The sha256 reference hash encoded by a v3+ event ID. Fixed-size output of a SHA-256 digest operation.