@permissionless-technologies/upc-asp-whitelist

Auto-whitelist ASP service for the Universal Private Compliance (UPC) ecosystem.

Watches on-chain events (pool deposits or token mints) and automatically whitelists addresses after sanctions screening. Exposes a proof API for users to fetch their membership proofs.

Quick Start

npm install @permissionless-technologies/upc-asp-whitelist

import { startASPService } from '@permissionless-technologies/upc-asp-whitelist'

await startASPService({
  rpcUrl: 'http://localhost:8545',
  registryAddress: '0x...',       // ASPRegistryHub contract
  watchAddress: '0x...',          // Pool or token address
  watchMode: 'pool',             // 'pool' or 'mint'
  operatorPrivateKey: '0x...',
  port: 3001,
})

Docker Deployment

FROM node:22-alpine
WORKDIR /app
COPY package.json .
RUN npm install
COPY index.ts .
CMD ["npx", "tsx", "index.ts"]

{
  "dependencies": {
    "@permissionless-technologies/upc-asp-whitelist": "^0.1.0"
  }
}

API

| Endpoint | Description | |----------|-------------| | GET /root | Current Merkle root | | GET /proof/:address | Membership proof | | GET /members | All whitelisted addresses | | GET /status | Sync status |

Part of the UPC Ecosystem

• @permissionless-technologies/upc-sdk — Core compliance SDK
• @permissionless-technologies/upc-asp-whitelist — This package
• @permissionless-technologies/upc-asp-kyc — KYC ASP (coming soon)
• @permissionless-technologies/upc-asp-sanctions — Sanctions ASP (coming soon)