Home

Identifold

One identity. Three representations. Ten conforming implementations.

Identifold is a stable, language-neutral identity contract for applications that need:

• a UUIDv7 MID for canonical storage;
• a TypeID-compatible PID for APIs, events, and logs; and
• a short, checksummed REF for people.

MID  019d4c72-c910-7a84-b313-53c3ac61a32f
PID  order_01kn675j8gfa2b64tkrep638sf
REF  ORD-7K4M-2P8Q-3D-9

MID <-> PID
REF -> storage -> MID

The MID and PID carry the same UUID bits. A REF is independently allocated and resolves through application storage. Identifiers identify; they do not authenticate callers or authorize access.

Identifold 1.0.0 is publicly available for TypeScript/JavaScript, Python, Java, C#, Go, PHP, Kotlin, Rust, Ruby, and Swift. Every implementation is checked against the same language-neutral vectors.

Start here

• Why Identifold? explains the problem through a disputed-charge workflow.
• Identity model defines the MID, PID, REF, and their invariants.
• Installation provides package declarations for all ten languages.
• Examples shows the public APIs and links to executable programs.
• Storage and allocation covers production-safe REF handling.
• API and errors summarizes operations and stable error codes.
• Conformance and CI documents the shared compatibility gate.
• Releases and support lists every live distribution.
• Development covers contribution and verification workflows.
• Security describes trust boundaries and disclosure considerations.

Canonical resources

• Stable 1.0 specification
• Implementation matrix
• Production examples
• Compatibility policy
• Public roadmap
• Security policy

The repository specification is normative. This wiki is the practical guide and should be updated with the contract whenever behavior changes.