PSC-HID-001
2025-08-24 · V1.0
HARQAH · OFFICIAL SPECIFICATION

HARQAH HID

Harqahran Identification Document — Permanent Identity Architecture
INITIATED BY HARQAHRAN PERAOAKER · 2025‑08‑24 · V1.0

PHILOSOPHY

The HID is not a username. It is not a session token. It is the permanent, forensic, geographic, cryptographic birth certificate of every identity that has ever existed inside the Harqahran system — whether human player, NPC, institution, government body, company, or registered asset.

A system this serious cannot produce identifiers that look like airport gate numbers. It must produce identifiers that read as statements of origin, carry their own verification, and resist every known attack against identity systems.

FULL HID STRUCTURE

HID-[VERSION]-[CLASS]-[PLANET]-[CONTINENT]-[COUNTRY]-[TIMESTAMP]-[SEQUENCE]-[ENTROPY]-[CHECKSUM]

Example (Ugandan Human Citizen)

HID-V1-CITIZEN-EARTH-AFRICA-UGANDA-20260506142201-00001-X7K2M9P4-QR

SEGMENT SPECIFICATION

HID
SYSTEM PREFIX

Three characters, always uppercase. The namespace declaration.

Every identity in Harqah begins with HID. No other string in Harqah begins with HID.

V1
VERSION

Self-declaring format version. Current active version: V1.

Mandatory for forward compatibility. V2 is reserved for future upgrades (post-quantum checksum, off-world registration expansion).

CITIZEN / NPC / INSTITUTION / ASSET / SYSTEM
IDENTITY CLASS

Defines the entity type and its validation rules.

CITIZEN: human player. NPC: AI‑controlled entity inside PearlMind. INSTITUTION: registered organisation. ASSET: registered object. SYSTEM: internal Harqah infrastructure.

EARTH
PLANET

Full planet name. All current registrations are EARTH. Reserved: LUNA, MARS, ORBITAL. UNKNOWN is valid for VPN/masked origins.

No abbreviations.

AFRICA
CONTINENT

Full continent name. Compound words for multi‑word names (e.g., NORTHAMERICA, MIDDLEEAST). Derived from registration IP. Permanent.

AFRICA, ASIA, EUROPE, NORTHAMERICA, SOUTHAMERICA, OCEANIA, ANTARCTICA, MIDDLEEAST, CARIBBEAN, UNKNOWN.

UGANDA
COUNTRY

Full country name, uppercase, spaces and special characters removed. All 249 ISO 3166‑1 countries mapped.

Examples: UNITEDSTATES, DEMOCRATICREPUBLICOFTHECONGO, SAUDIARABIA. The lookup table is versioned; existing HIDs are never retroactively changed.

20260506142201
TIMESTAMP

14‑digit UTC: YYYYMMDDHHMMSS. Exact second of HID generation.

Permanent birth timestamp. Provides first layer of collision defence.

00001
SEQUENCE

5‑digit per‑second counter (per country, per class). Eliminates collision risk under high concurrency.

Resets each second. Supports up to 99,999 registrations per second per country per class.

X7K2M9P4
ENTROPY BLOCK

8‑character block from a 33‑character set (A‑Z excluding O/I/S, 0‑9). 1.1 trillion possible combinations.

Cryptographically generated. O, I, S excluded to avoid visual ambiguity with 0, 1, 5.

QR
CHECKSUM

2‑character checksum generated via a Modified Luhn algorithm for alphanumeric strings.

Validated first on every HID presentation. Rejects malformed or fabricated identities before any database lookup.

HID SIGNATURE (PUBLIC DISPLAY)

The full HID is never exposed to other parties. The public‑facing Signature condenses identity:

[CLASS INITIAL] · [COUNTRY] · [LAST 4 OF ENTROPY][CHECKSUM]

Example: C·UGANDA·M9P4QR

TRUST TIER SYSTEM

Every HID carries a mutable Trust Tier (0‑3) stored externally. It governs access to sensitive functions.

TIERNAMEDESCRIPTION
0UNVERIFIEDFreshly registered. Location derived from IP.
1GEOCONFIRMEDIP consistent with declared region; 30 days without anomalies.
2VERIFIEDAt least one secondary verification step passed (device fingerprint, manual review, etc.).
3TRUSTEDLong-standing clean record. Eligible for elevated privileges (institutions, governments, asset registrations).

CITIZEN starts at Tier 0; INSTITUTION requires a founding CITIZEN with Tier 2; SYSTEM HIDs are always Tier 3.

ANOMALY FLAGS

Two live flags exist outside the HID string. Both can be raised independently; both raised simultaneously triggers automatic escalation.

COMPLETE EXAMPLE SET

FULL HIDSIGNATURE
HID-V1-CITIZEN-EARTH-AFRICA-UGANDA-20260506142201-00001-X7K2M9P4-QRC·UGANDA·M9P4QR
HID-V1-CITIZEN-EARTH-AFRICA-NIGERIA-20260501091233-00003-B4N7R2M6-KWC·NIGERIA·R2M6KW
HID-V1-CITIZEN-EARTH-AFRICA-KENYA-20260220163045-00011-T3W8P5L1-FHC·KENYA·P5L1FH
HID-V1-CITIZEN-EARTH-AFRICA-SOUTHAFRICA-20260614201837-00002-H5C4N8W2-M1C·SOUTHAFRICA·N8W2M1
HID-V1-CITIZEN-EARTH-AFRICA-DEMOCRATICREPUBLICOFTHECONGO-20260418073341-00006-B3H7Q9L4-TGC·DEMOCRATICREPUBLICOFTHECONGO·Q9L4TG
HID-V1-CITIZEN-EARTH-NORTHAMERICA-UNITEDSTATES-20260101000001-00001-T9L3F7H2-KMC·UNITEDSTATES·F7H2KM
HID-V1-CITIZEN-EARTH-EUROPE-UNITEDKINGDOM-20250930112233-00003-W2K8M5X4-A6C·UNITEDKINGDOM·M5X4A6
HID-V1-CITIZEN-EARTH-ASIA-JAPAN-20241122183055-00019-C6D4V8J1-P2C·JAPAN·V8J1P2
HID-V1-CITIZEN-EARTH-MIDDLEEAST-SAUDIARABIA-20241030091522-00004-V7R2N5X8-C4C·SAUDIARABIA·N5X8C4
HID-V1-NPC-EARTH-AFRICA-UGANDA-20260101000001-00047-N4L7Q2R9-WBN·UGANDA·Q2R9WB
HID-V1-INSTITUTION-EARTH-AFRICA-UGANDA-20260201091500-00001-G8M3K6T2-PXI·UGANDA·K6T2PX
HID-V1-CITIZEN-EARTH-UNKNOWN-UNKNOWN-20260506183301-00239-N3P7L2Q8-FAC·UNKNOWN·L2Q8FA

VALIDATION RULES

Before any database lookup, a HID string must pass these ten checks in exact order. Any failure causes immediate rejection.

  1. Prefix check: begins with HID-
  2. Version exists in registry
  3. Class exists in registry
  4. Planet exists in registry
  5. Continent exists in registry
  6. Country exists in versioned lookup table
  7. Timestamp is exactly 14 digits, valid date, not in the future
  8. Sequence is exactly 5 digits
  9. Entropy block is exactly 8 characters from allowed set (A‑Z except O,I,S; 0‑9)
  10. Checksum recalculated over preceding segments matches the stored checksum

REGISTRATION REVEAL SEQUENCE

When a new HID is issued, it is displayed segment‑by‑segment with a half‑second pause.

HID
HID-V1
HID-V1-CITIZEN
HID-V1-CITIZEN-EARTH
HID-V1-CITIZEN-EARTH-AFRICA
HID-V1-CITIZEN-EARTH-AFRICA-UGANDA
HID-V1-CITIZEN-EARTH-AFRICA-UGANDA-20260506142201
HID-V1-CITIZEN-EARTH-AFRICA-UGANDA-20260506142201-00001
HID-V1-CITIZEN-EARTH-AFRICA-UGANDA-20260506142201-00001-X7K2M9P4
HID-V1-CITIZEN-EARTH-AFRICA-UGANDA-20260506142201-00001-X7K2M9P4-QR

YOUR SIGNATURE:   C·UGANDA·M9P4QR

COMPLETE HID ANATOMY

HID - V1 - CITIZEN - EARTH - AFRICA - UGANDA - 20260506142201 - 00001 - X7K2M9P4 - QR
|     |      |        |        |        |             |            |         |       |
|     |      |        |        |        |             |            |         |       |
Sys  Format  Entity  Planet  Continent Country      UTC           Per-sec   8-char  2-char
Pre- Version Class    Full    Full      Full       Timestamp    Sequence   Crypto  Checksum
fix                   Name    Name      Name     YYYYMMDDHHMMSS Counter    Entropy  Block

All identity information is presented in full words. No abbreviations. No decoding. No interpretation.