gRPC Identity Verification API

Build secure, scalable identity verification systems using PALAP's gRPC-based microservices for decentralized identity attestation and verification.

Getting Started

Installation

// Using Node.js
npm install @grpc/grpc-js @palap/identity-proto

// Python
pip install grpcio palap-identity
                        

Configuration

const client = new IdentityClient(
  'grpc.palap.org:443',
  credentials.createSsl(rootCert),
  {
    'grpc.default_authority': 'palap.identity'
  }
);
                        

Authentication

const metadata = new Metadata();
metadata.add('x-api-key', 'YOUR_API_KEY');

client.authToken(metadata, (err, response) => {
  console.log(response.status);
});
                        

API Endpoints

VerifyIdentity

POST /identity/Verify

Request

{
  "subject": "did:example:123456789",
  "claims": ["email", "name", "address"],
  "context": "login_session"
}
                    

Response

{
  "verified": true,
  "confidence": 0.997,
  "timestamp": "2025-08-26T14:30:00Z"
}
                    

ResolveDID

POST /identity/Resolve

Request

{
  "did": "did:palap:abc123",
  "revocation_check": true
}
                    

Response

{
  "did_document": {
    "publicKey": [...],
    "service": [...]
  },
  "valid": true
}
                    

Error Handling

401 Unauthorized
{
  "error": "invalid_token",
  "message": "API key missing or invalid"
}
                    
422 Unprocessable
{
  "error": "invalid_did_format",
  "field": "subject.did",
  "value": "invalid_did_value"
}
                    
503 Service Unavailable
{
  "error": "service_temporarily_unavailable",
  "retry_after": "60"
}
                    

SDK Support

JavaScript SDK

  • • Async request handling
  • • WebSocket streaming
  • • Babel 8+ support
  • • TypeScript 4.8+

Python SDK

  • • gRPC 1.40+
  • • Async support
  • • DID resolution helpers
  • • Cryptographic utilities

Rust SDK

  • • Tokio 1.34+
  • • Warp 0.3.1
  • • Web3 integration
  • • No-std optional builds

Join the gRPC Community

Contribute to our open source gRPC stack for identity verification systems. Help design the next generation of decentralized trust frameworks.

Contribute to Code