🇫🇮 Suomi devs: Add Henkilötunnus (HETU) to the AI identity standard — Soulprint open source (30 min PR)

#opensource #ai #identity #webdev

Every day, AI agents make decisions on our behalf — buying, sending emails, signing documents — and nobody verifies there's a real human behind them.

Soulprint solves this with Zero-Knowledge Proofs: 100% on-device, open source (MIT), free to run. soulprint.digital

🇫🇮 Suomi's Henkilötunnus (HETU) is not in Soulprint yet. You can add it in ~30 minutes with one PR.

What Soulprint does

npx soulprint verify-me       # scan ID + face match — all local
# → SPT token (score 0-100)

# AI agent includes token in every call
# X-Soulprint: eyJ... (score: 84)

# API verifies in 3 lines:
import { requireSoulprint } from "soulprint-mcp";
server.tool("premium", requireSoulprint({ minScore: 80 }), handler);

ZK proof: Circom 2.1.8 · Groth16 · 844 constraints · 564ms prove · 25ms verify.

🇫🇮 Suomi: Henkilötunnus (HETU)

HETU: DDMMYY+/-AXXXC (11 chars). Century marker: + (1800s), - (1900s), A (2000s). Check character from table of 31 chars.

The code — fill in the blanks and open a PR

// packages/verify-local/src/document/countries/FI.ts
import { CountryVerifier, DocumentResult, NumberValidation } from "../verifier.interface";

const FI: CountryVerifier = {
  countryCode:   "FI",
  countryName:   "Suomi",
  documentTypes: ["hetu"],

  parse(ocrText: string): DocumentResult {
    // Henkilötunnus (HETU) format: DDMMYYAXXXC (11 chars)
    const doc_number = ocrText.match(/(\d{6}[+\-A]\d{3}[A-Z0-9])/)?.[1] ?? "";
    return { valid: !!doc_number, doc_number, country: "FI" };
  },

  validate(docNumber: string): NumberValidation {
    // check character from 31-char table
    return { valid: validateHETU(docNumber) };
  },
};

export default FI;

Then add one line in registry.ts:

import FI from "./countries/FI";
// add to registry map: "FI": FI,

Open a PR → your country joins the global AI identity standard. 🌍

Why contribute?

Suomi joins the AI age — local developers can verify their AI agents
Permanent git credit — you're in the history forever
Decentralized identity — no Big Tech as gatekeeper
Fast — 30 min partial, 2-3h full with MRZ

Resources

One PR. One country. The future of AI identity is open source.

DEV Community