Zero-Knowledge Proofs

POST /v1/zkp/prove

POST /v1/zkp/verify

GET /v1/zkp/{id}

POST /v1/zkp/{id}/revoke

// Game platform: Verify age proof at registration
const result = await platform.zkp.verify({
  proof_token: playerProvidedToken,
});

if (result.valid && result.result === true) {
  // Player is verified as over 18
  // Zero personal data collected or stored
  // No GDPR data subject access requests to handle
  createPlayerAccount();
}

# DeFi protocol: Check AML status without collecting identity
result = client.zkp.verify(proof_token=user_proof)

if result["valid"] and result["claim_type"] == "aml_clear" and result["result"]:
    # User has passed AML screening
    # Protocol knows nothing about the user's identity
    # Compliant with OFAC while preserving privacy
    allow_protocol_access(wallet_address)

// HR system: Verify right to work
const proof = await hr.zkp.verify({
  proof_token: candidateProof,
});

if (proof.valid && proof.claim_type === 'nationality_is') {
  // Candidate confirmed as national of the required country
  // No passport copy collected during application
  // Physical documents only needed at contract signing
  moveToNextStage(candidate);
}

# Generate multiple proofs from one session
age_proof = client.zkp.prove(
    session_id=session_id,
    claim_type="age_over",
    claim_value=18,
)

identity_proof = client.zkp.prove(
    session_id=session_id,
    claim_type="identity_verified",
    claim_value=True,
)

aml_proof = client.zkp.prove(
    session_id=session_id,
    claim_type="aml_clear",
    claim_value=True,
)

# User shares all three proofs with the lender
# Lender verifies each independently
# Result: identity confirmed, age confirmed, AML clear
# No name, DOB, address, or document data shared

// Conference check-in: Scan QR code containing proof token
const result = await venue.zkp.verify({
  proof_token: scannedToken,
});

if (result.valid && result.claim_type === 'identity_verified' && result.result) {
  // Attendee has a verified identity -- allow entry
  // No name or photo collected at the door
  openGate();
}

proof = client.zkp.prove(
    session_id=session_id,
    claim_type="residency_country",
    claim_value="FR",  # Or any EU country code
)

# Verifier checks
result = client.zkp.verify(proof_token=proof["proof_token"])
if result["valid"] and result["result"]:
    # User confirmed as resident of France
    # No address, no utility bill, no data stored
    enable_eu_services()

// Step 1: Issue a full credential after KYC
const vc = await verilock.credentials.issue({
  session_id: session.id,
  credential_type: 'IdentityCredential',
  claims: ['full_name', 'date_of_birth', 'nationality', 'aml_clear'],
});

// Step 2: User generates ZKP proofs for specific claims
const ageProof = await verilock.zkp.prove({
  session_id: session.id,
  claim_type: 'age_over',
  claim_value: 18,
});

// User now has:
// - A full VC for services that need identity data (banks, regulated platforms)
// - A ZK proof for services that only need age verification (e-commerce, gaming)