Technical Documentation & FAQ

UUID v1: Timestamp & Node Logic

  • Section A: The Technical Deep DiveUUID v1 is the 'Historical Standard.' It is unique because it is mathematically derived from the current system time and the MAC address (Node ID) of the machine generating it. This creates a 128-bit identifier that is physically tied to the device and the exact microsecond of its creation. While v1 has largely been superseded by v7 for database performance and v4 for privacy, it remains a requirement for many enterprise legacy systems and specialized audit logging where the identity of the 'originating machine' must be encoded into the ID itself.

  • Section B: Legacy Use Cases

    • Cassandra TimeUUID: Many NoSQL databases like Apache Cassandra use v1 (TimeUUID) to sort data naturally by time on a per-node basis.

    • Auditability: In highly regulated environments, v1 can be used to prove when and where a record was created.

    • Network Hardware Tracking: Identifying unique events across a cluster of specific hardware nodes.

  • Section C: Privacy WarningBecause UUID v1 contains your computer’s MAC address, it is possible for someone to 'reverse engineer' the ID to find your hardware's identity and the exact time you used the tool. For public-facing web applications, we strongly recommend using v4 or v7 instead to protect your infrastructure's privacy.

  • Section D: Developer FAQ

    • Q: Is v1 sortable?A: Yes, but it's tricky. Because the time bits are rearranged in the v1 format, it isn't as 'naturally' sortable as v7 without specialized database support.

    • Q: Does JOTO use my actual MAC address?A: No. For privacy reasons, modern browsers do not allow access to your real MAC address. We use a randomly generated 'multicast' Node ID as per RFC 4122 guidelines.