{"repo":"stateless-me/uuidv47","free":true,"listed":false,"github":"https://github.com/stateless-me/uuidv47","clone":"git clone https://github.com/stateless-me/uuidv47.git","description":"⚡ UUIDv47 = v4 privacy + v7 performance","language":"C","stars":749,"topics":["c89","database","header-only","siphash","uuidv4","uuidv7","uuid","c","postgres","postgresql-extension"],"license":"MIT","category":"databases-storage","readme_excerpt":"UUIDv47 — UUIDv7-in / UUIDv4-out (SipHash‑masked timestamp) =========================================================== 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. - Header‑only C (C89) · zero deps - Deterministic, invertible mapping (exact round‑trip) - RFC‑compatible version/variant bits (v7 in DB, v4 on the wire) - Key‑recovery resistant (SipHash‑2‑4, 128‑bit key) - Full tests provided - Optional PostgreSQL extension (UUID type + operators/opclasses) ------------------------------------------------------------------ Table of contents ----------------- - Why - Quick start (C) - Public C API - Specification - UUIDv7 bit layout - Façade mapping (v7 ↔ v4) - SipHash message derived from random - Invertibility - Collision analysis - Security model - Build, test, coverage - PostgreSQL extension - Build & install - Tests - Gotchas & performance tips - Integration tips - Performance notes - Benchmarks (C) - Ports in other languages - Production recommendations - FAQ - License ------------------------------------------------------------------ Why --- - DB‑friendly : UUIDv7 is time‑ordered → better index locality & pagination. - Externally neutral : The façade hides timing patterns and looks like v4 to clients/systems. - Secret safety : Uses a ","default_branch":null,"files":null,"tree":[],"storefront":"/r/stateless-me","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/stateless-me/uuidv47/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}