The NPPP v1 Engine

TECHNICAL SPECIFICATION

Integrate deterministic integrity proofs into your institutional systems. Use the normative specification to build stateless verifiers or notarization producers.

Protocol Status: Active

Run the verified local NPPP v1 demo to validate institutional orchestration.

curl -fsSL https://api.usermintnetwork.com/demo.sh | bash

The demo validates: Sovereign API Gateway transport, private Cloud Run authentication, deterministic SHA-256 replay verification, GCS bundle retrieval, and canonical NPPP v1 proof-material conformance.

Prove It Challenge

Build something verifiable with Claude, GPT, or your preferred AI tooling using NPPP v1.

Sovereign Deployment & Infrastructure

UserMint is designed for sovereign operation in high-security environments, including IL4/IL5/IL6 defense networks.

Containerized Execution

The notarization engine and verification surface are delivered as OCI-compliant containers, optimizing for deployment in GKE, Cloud Run, or on-premise Kubernetes clusters.

Air-Gapped Compatibility

NPPP v1 is a stateless protocol. Verification can be performed in fully disconnected environments by providing the deterministic evidence bundle directly to the local verifier node.

Reference HTTP Implementation

The following endpoints provide a reference for NPPP v1 transport.

POST /v1/auth/bootstrap Register developer identity and obtain API key.

POST /v1/notarize Construct bundle and issue NPPP v1 proof string.

POST /v1/verify Execute stateless replay (recompute SHA-256).

GET /v1/proof/{proof_id} Retrieve full proof record and bundle reference.

SDK Examples

Python (web3.py + requests)

import requests

# Notarize
res = requests.post("https://api.usermintnetwork.com/v1/notarize",
  json={"service": "myapp", "evidence": {"data": "..."}},
  headers={"X-API-Key": "your_key"}
)
proof = res.json()["proof"]

# Verify (Stateless)
verify_res = requests.post("https://api.usermintnetwork.com/v1/verify",
  json={"proof": proof}
)
print(verify_res.json()["status"])
# Output: SHA Replay Verified: OK
            

Node.js (Fetch API)

const proof = "NPPP:V1|project=...|sha256=...";

// Verify via replay
const res = await fetch("https://api.usermintnetwork.com/v1/verify", {
  method: "POST",
  body: JSON.stringify({ proof })
});

const { status } = await res.json();
console.log(status); // SHA Replay Verified: OK
            