soulprint-network 0.4.6 → 0.5.0

package/dist/code-hash.json

@@ -1,8 +1,8 @@
 {
-  "codeHash": "c256c2701bea12bbb2f50552b268bda6065a58d187f7bde6d6be86d82eb73f06",
-  "codeHashHex": "0xc256c2701bea12bbb2f50552b268bda6065a58d187f7bde6d6be86d82eb73f06",
-  "computedAt": "2026-03-01T03:11:08.326Z",
-  "fileCount": 24,
+  "codeHash": "5ed4412b9c31b286dd991a4f35189b14284d3ec4f724b06b9dde681dd097042a",
+  "codeHashHex": "0x5ed4412b9c31b286dd991a4f35189b14284d3ec4f724b06b9dde681dd097042a",
+  "computedAt": "2026-03-01T03:36:12.743Z",
+  "fileCount": 25,
   "files": [
     "blockchain/NullifierRegistryClient.ts",
     "blockchain/PeerRegistryClient.ts",
@@ -19,6 +19,7 @@
     "credentials/github.ts",
     "credentials/index.ts",
     "credentials/phone.ts",
+    "credentials/registraduria.ts",
     "crypto/gossip-cipher.ts",
     "crypto/peer-router.ts",
     "index.ts",

package/dist/credentials/registraduria.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Registraduría Nacional del Estado Civil — cédula validation
+ *
+ * Verifies that a Colombian cédula is VIGENTE (active) by querying
+ * the official Registraduría certificate service.
+ *
+ * Endpoint: GET /verify/cedula?numero=XXXXXXXX&fechaNac=YYYY-MM-DD
+ */
+import { IncomingMessage, ServerResponse } from "node:http";
+export interface RegistraduriaResult {
+    vigente: boolean;
+    status: "VIGENTE" | "NO_VIGENTE" | "NOT_FOUND" | "ERROR";
+    raw?: string;
+    error?: string;
+}
+/**
+ * Validates a cédula against Registraduría Nacional.
+ * @param numero  - Cédula number (digits only)
+ * @param fechaNac - Birth date in YYYY-MM-DD format
+ * @returns RegistraduriaResult
+ */
+export declare function validateCedula(numero: string, fechaNac: string): Promise<RegistraduriaResult>;
+/**
+ * Handle GET /verify/cedula?numero=...&fechaNac=...
+ * Returns: { ok, vigente, status, numero, fechaNac }
+ * Graceful degradation: if Registraduría is unreachable, returns ok=true with status=ERROR and a warning.
+ */
+export declare function handleCedulaRoute(req: IncomingMessage, res: ServerResponse, url: string): Promise<boolean>;

package/dist/credentials/registraduria.js

@@ -0,0 +1,147 @@
+/**
+ * Registraduría Nacional del Estado Civil — cédula validation
+ *
+ * Verifies that a Colombian cédula is VIGENTE (active) by querying
+ * the official Registraduría certificate service.
+ *
+ * Endpoint: GET /verify/cedula?numero=XXXXXXXX&fechaNac=YYYY-MM-DD
+ */
+import https from "node:https";
+import { URL } from "node:url";
+const REGISTRADURIA_URL = "https://certvigenciacedula.registraduria.gov.co/Datos.aspx";
+/**
+ * Validates a cédula against Registraduría Nacional.
+ * @param numero  - Cédula number (digits only)
+ * @param fechaNac - Birth date in YYYY-MM-DD format
+ * @returns RegistraduriaResult
+ */
+export async function validateCedula(numero, fechaNac) {
+    // Convert fechaNac YYYY-MM-DD → DD/MM/YYYY expected by Registraduría
+    const [year, month, day] = fechaNac.split("-");
+    const fechaFormatted = `${day}/${month}/${year}`;
+    const postBody = new URLSearchParams({
+        NumeroDocumento: numero.trim(),
+        FechaNacimiento: fechaFormatted,
+        BtnConsultar: "Consultar",
+    }).toString();
+    return new Promise((resolve) => {
+        const urlObj = new URL(REGISTRADURIA_URL);
+        const options = {
+            hostname: urlObj.hostname,
+            path: urlObj.pathname + urlObj.search,
+            method: "POST",
+            headers: {
+                "Content-Type": "application/x-www-form-urlencoded",
+                "Content-Length": Buffer.byteLength(postBody),
+                "User-Agent": "Mozilla/5.0 (compatible; SoulprintValidator/0.5.0; +https://github.com/manuelariasfz/soulprint)",
+                Accept: "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8",
+                "Accept-Language": "es-CO,es;q=0.9",
+            },
+            timeout: 10_000,
+        };
+        const req = https.request(options, (res) => {
+            let data = "";
+            res.on("data", (chunk) => {
+                data += chunk;
+                if (data.length > 500_000) {
+                    req.destroy();
+                    resolve({ vigente: false, status: "ERROR", error: "Response too large" });
+                }
+            });
+            res.on("end", () => {
+                try {
+                    const upper = data.toUpperCase();
+                    if (upper.includes("VIGENTE") && !upper.includes("NO VIGENTE") && !upper.includes("NO_VIGENTE")) {
+                        resolve({ vigente: true, status: "VIGENTE", raw: data.slice(0, 2000) });
+                    }
+                    else if (upper.includes("NO VIGENTE") || upper.includes("NO_VIGENTE") || upper.includes("CANCELADA") || upper.includes("ANULADA")) {
+                        resolve({ vigente: false, status: "NO_VIGENTE", raw: data.slice(0, 2000) });
+                    }
+                    else if (upper.includes("NO EXISTE") || upper.includes("NO SE ENCONTR") || upper.includes("NOT FOUND")) {
+                        resolve({ vigente: false, status: "NOT_FOUND", raw: data.slice(0, 2000) });
+                    }
+                    else {
+                        // Ambiguous response — treat as not found
+                        resolve({ vigente: false, status: "NOT_FOUND", raw: data.slice(0, 2000) });
+                    }
+                }
+                catch (e) {
+                    resolve({ vigente: false, status: "ERROR", error: e.message });
+                }
+            });
+        });
+        req.on("error", (err) => {
+            resolve({ vigente: false, status: "ERROR", error: err.message });
+        });
+        req.on("timeout", () => {
+            req.destroy();
+            resolve({ vigente: false, status: "ERROR", error: "Request timed out" });
+        });
+        req.write(postBody);
+        req.end();
+    });
+}
+// ── HTTP helpers ──────────────────────────────────────────────────────────────
+function jsonResp(res, status, body) {
+    res.writeHead(status, { "Content-Type": "application/json" });
+    res.end(JSON.stringify(body));
+}
+/**
+ * Handle GET /verify/cedula?numero=...&fechaNac=...
+ * Returns: { ok, vigente, status, numero, fechaNac }
+ * Graceful degradation: if Registraduría is unreachable, returns ok=true with status=ERROR and a warning.
+ */
+export async function handleCedulaRoute(req, res, url) {
+    if (!url.startsWith("/verify/cedula"))
+        return false;
+    if ((req.method ?? "GET") !== "GET")
+        return false;
+    const qs = new URL(url, "http://localhost").searchParams;
+    const numero = qs.get("numero");
+    const fechaNac = qs.get("fechaNac");
+    if (!numero) {
+        jsonResp(res, 400, { ok: false, error: "Missing query param: numero" });
+        return true;
+    }
+    if (!fechaNac || !/^\d{4}-\d{2}-\d{2}$/.test(fechaNac)) {
+        jsonResp(res, 400, { ok: false, error: "Missing or invalid query param: fechaNac (expected YYYY-MM-DD)" });
+        return true;
+    }
+    try {
+        const result = await validateCedula(numero, fechaNac);
+        if (result.status === "ERROR") {
+            // Graceful degradation — Registraduría unreachable
+            console.warn(`[Registraduría] Unreachable or error for cédula ${numero}: ${result.error}`);
+            jsonResp(res, 200, {
+                ok: true,
+                vigente: null,
+                status: "ERROR",
+                warning: "Registraduría is currently unreachable. Verification skipped.",
+                numero,
+                fechaNac,
+            });
+        }
+        else {
+            jsonResp(res, 200, {
+                ok: true,
+                vigente: result.vigente,
+                status: result.status,
+                numero,
+                fechaNac,
+            });
+        }
+    }
+    catch (e) {
+        // Should not happen, but handle just in case
+        console.warn(`[Registraduría] Unexpected error: ${e.message}`);
+        jsonResp(res, 200, {
+            ok: true,
+            vigente: null,
+            status: "ERROR",
+            warning: "Registraduría verification failed unexpectedly. Verification skipped.",
+            numero,
+            fechaNac,
+        });
+    }
+    return true;
+}

package/dist/validator.js

@@ -7,6 +7,7 @@ import { generateKeypair, keypairFromPrivateKey, decodeToken, sign, createToken,
 import { verifyProof, deserializeProof } from "soulprint-zkp";
 import { buildChallengeResponse, verifyPeerBehavior, } from "./peer-challenge.js";
 import { handleCredentialRoute } from "./credentials/index.js";
+import { handleCedulaRoute } from "./credentials/registraduria.js";
 import { encryptGossip, decryptGossip } from "./crypto/gossip-cipher.js";
 import { selectGossipPeers, routingStats } from "./crypto/peer-router.js";
 import { NullifierConsensus, AttestationConsensus, StateSyncManager } from "./consensus/index.js";
@@ -1038,6 +1039,12 @@ export function startValidatorNode(port = PORT) {
             if (handled)
                 return;
         }
+        // ── Registraduría cédula validation ────────────────────────────────────
+        if (cleanUrl.startsWith("/verify/cedula")) {
+            const handled = await handleCedulaRoute(req, res, url);
+            if (handled)
+                return;
+        }
         if (cleanUrl === "/info" && req.method === "GET")
             return handleInfo(res, nodeKeypair);
         if (cleanUrl === "/protocol" && req.method === "GET")

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "soulprint-network",
-  "version": "0.4.6",
+  "version": "0.5.0",
   "description": "Soulprint validator node \u2014 HTTP server that verifies ZK proofs, co-signs SPTs, anti-Sybil registry",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",