UUIDv47-rs — A Rust implementation of UUIDv47

This library provides useful features that convert between UUIDv7 and UUIDv4

• Wraps all API in safe Rust.
• Provides comfortable object-oriented API.

This is a Rust implementation of UUIDv47

uuidv47 lets you store sortable UUIDv7 in your database while emitting a UUIDv4‑looking façade at your API boundary. It XOR‑masks only the UUIDv7 timestamp field with a keyed SipHash‑2‑4 stream derived from the UUID’s own random bits. The mapping is deterministic and exactly invertible.

Installation

cargo add uuidv47

Usage

use uuidv47::*;

fn main() -> Result<(), Box<dyn std::error::Error>> {
  let s = "00000000-0000-7000-8000-000000000000";  // your UUIDv7 string
  let key = UuidV47Key::new(0x0123456789abcdef, 0xfedcba9876543210);  // your 128-bit key

  // Parse str to UUIDv7
  // error if provided string is invalid
  let v7: Uuid128 = s.parse()?;
  println!("v7(DB)  : {}", v7.to_string());

  // Encode UUIDv7 to UUIDv4 facade
  let facade = v7.uuidv47_encode_v4facade(&key);
  println!("v4(API) : {}", facade.to_string());

  // Decode UUIDv4 facade to UUIDv7
  let back = facade.uuidv47_decode_v4facade(&key);
  println!("back    : {}", back.to_string());

  Ok(())
}

7(DB)   : 00000000-0000-7000-8000-000000000000
v4(API) : 22d97126-9609-4000-8000-000000000000
back    : 00000000-0000-7000-8000-000000000000

Development

git clone https://github.com/potistudio/uuidv47-rs.git
cd uuidv47-rs

cargo test
cargo run

License

This library is released under the MIT License.

Credit

This is a Rust implementation of UUIDv47 developed by @Stateless.