Soulprint

Soulprint — Decentralized Identity for AI Agents

Soulprint proves a real human is behind any AI bot using privacy-preserving ZK proofs — no centralized authority, no biometric cloud uploads. State lives on Base Sepolia blockchain.

GitHub: https://github.com/manuelariasfz/soulprint
npm: https://www.npmjs.com/package/soulprint-network
Docs: https://soulprint.digital
Network: 4 validator nodes on Railway (Base Sepolia testnet)
Version: v0.6.4

Architecture (v0.6.4 — blockchain-first, local ZK verification)

User verifies once → ZK proof generated locally (no Registraduría scraping)
→ Nullifier registered on-chain (Base Sepolia)
→ Any agent queries on-chain: isRegistered(nullifier) → true/false
No P2P sync, no central server — blockchain IS the network

Contracts on Base Sepolia:

• PeerRegistry: 0x452fb66159dFCfC13f2fD9627aA4c56886BfB15b
• NullifierRegistry: (pending deployment — requires testnet ETH)
• ReputationRegistry: (pending deployment — requires testnet ETH)
• ProtocolThresholds: 0xD8f78d65b35806101672A49801b57F743f2D2ab1
• MCPRegistry: 0x59EA3c8f60ecbAe22B4c323A8dDc2b0BCd9D3C2a

When to Use

✅ USE this skill when:

• "Verify my identity for an AI agent"
• "Run a Soulprint validator node"
• "Add identity verification to my MCP server or API"
• "Check the reputation score of a bot or DID"
• "Generate a privacy proof from a Colombian cédula"
• "Verify a cédula against Registraduría Nacional"
• "Issue or verify an SPT (Soulprint Token)"

❌ DON'T use this skill when:

• Storing or transmitting biometric data remotely (Soulprint runs 100% locally)
• Verifying identities from countries not yet supported (only Colombia is full)

Quick Start

1. Verify Your Identity (one-time)

npx soulprint install-deps   # OCR + face recognition — only once
npx soulprint verify-me      # all local, nothing uploaded

2. Run a Validator Node

npx soulprint-network
# or
ADMIN_PRIVATE_KEY=0x... ADMIN_TOKEN=... PORT=4888 node dist/server.js

Node API:

GET  /info                      — node version, network, contracts, capabilities
GET  /health                    — code integrity hash
POST /verify                    — verify ZK proof
GET  /verify/cedula?numero=X&fechaNac=YYYY-MM-DD  — Registraduría validation
GET  /network/stats             — live stats (peers, verified, MCPs)
GET  /mcps/verified             — verified MCPs from MCPRegistry on-chain
GET  /protocol/thresholds       — on-chain protocol thresholds

Integrate in Your API

MCP Server (3 lines)

import { requireSoulprint } from "soulprint-mcp";

server.tool("premium-tool", requireSoulprint({ minScore: 80 }), async (args, ctx) => {
  const { did, score } = ctx.soulprint;
});

Express / Fastify

import { soulprintMiddleware } from "soulprint-express";
app.use(soulprintMiddleware({ minScore: 65 }));
// req.soulprint.did, req.soulprint.score

Trust Score (0–100)

Protocol Constants (on-chain via ProtocolThresholds)

Country Support

npm Packages

Integration with mcp-colombia

mcp-colombia-hub@1.3.0 uses Soulprint natively — no extra setup needed.

• soulprint_status tool available directly in mcp-colombia: checks on-chain identity and reputation
• trabajo_aplicar (job applications) requires Soulprint score ≥ 40
• Live validator: https://soulprint-node-production.up.railway.app

Install both together

# Add to your MCP config:
npx mcp-colombia-hub     # includes soulprint_status tool

# Verify your identity first (one-time):
npx soulprint verify-me

Once verified, your SPT token works across all tools in mcp-colombia automatically.