DEV Community

Manuel Felipe Arias Pineda
Manuel Felipe Arias Pineda

Posted on

🇵🇹 Portugal devs: Add Cartão de Cidadão to the AI identity standard — Soulprint open source (30 min PR)

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

🇵🇹 Portugal's Cartão de Cidadão 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);
Enter fullscreen mode Exit fullscreen mode

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


🇵🇹 Portugal: Cartão de Cidadão

Cartão de Cidadão: 8 dígitos + 1 letra de controlo + 1 dígito adicional (ex: 12345678ZX4). NIF fiscal: 9 dígitos.


The code — fill in the blanks and open a PR

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

const PT: CountryVerifier = {
  countryCode:   "PT",
  countryName:   "Portugal",
  documentTypes: ["cc", "passaporte"],

  parse(ocrText: string): DocumentResult {
    // Cartão de Cidadão format: 8 digits + 2 chars
    const doc_number = ocrText.match(/(\d{8}[A-Z0-9]{2})/)?.[1] ?? "";
    return { valid: !!doc_number, doc_number, country: "PT" };
  },

  validate(docNumber: string): NumberValidation {
    // CC check digit validation
    return { valid: /^\d{8}[A-Z0-9]{2}$/.test(docNumber) };
  },
};

export default PT;
Enter fullscreen mode Exit fullscreen mode

Then add one line in registry.ts:

import PT from "./countries/PT";
// add to registry map: "PT": PT,
Enter fullscreen mode Exit fullscreen mode

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


Why contribute?

  • Portugal 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.

Top comments (0)