Skip to content

README.md

Latest commit

 

History

History
45 lines (31 loc) · 1.23 KB

README.md

File metadata and controls

45 lines (31 loc) · 1.23 KB

Serverless OPRF Service

A prototype of a self-hosted Oblivious Pseudo-Random Function (OPRF) service based on AWS Lambda + API Gateway.

Current maturity level (v0.2)

This repository now includes:

  • TypeScript build + typecheck configuration (package.json, tsconfig.json)
  • Shared input/encoding utilities for server + client (encodingUtils.ts)
  • Improved server input parsing and safer ID generation with cryptographic randomness
  • Environment-based configuration for DynamoDB table name (TABLE_NAME)

Quickstart

npm install
npm run typecheck

Run the client demo

node oprfClientDemo.js

AWS Lambda notes

  • Handler file: oprfServerless.ts
  • Required DynamoDB table schema:
    • Partition key: id (String)
    • Attributes: secretKey (stored as number array)
  • Optional env var:
    • TABLE_NAME (default: oprf-users)

Project Files

  • oprfServerless.ts – Lambda handler for OPRF evaluation.
  • oprfClient.ts – TypeScript client implementation.
  • oprfClientDemo.js – demo runner against an OPRF endpoint.
  • encodingUtils.ts – shared validators + encoding conversion helpers.

Try It Out

You can test a live instance at https://oprf.reich.org using the included client demo.