ZERO-KNOWLEDGE DEVELOPER PLATFORM

API & Development Docs

Enterprise-grade zero-knowledge REST endpoints, high-frequency volatile WebSocket relay specifications, and cryptographic POS commerce integration.

Quickstart & WSS REST Architecture Commerce & POS Webhooks & Auth

1. Connecting to the In-Memory WebSocket Relay

The ZeroText relay operates entirely in volatile RAM with zero disk logging. Clients connect via TLS/WSS and authenticate using client-derived public keys.

JavaScript / Node.js WebSocket Client

const WebSocket = require('ws');

// Connect to ZeroText Live In-Memory Volatile Relay
const ws = new WebSocket('wss://zerotext.drpcoa.com/relay');

ws.on('open', () => {
  console.log('[+] Connected to Zero-Knowledge Relay');
  
  // Register Ephemeral Channel with Ed25519 Device Fingerprint
  ws.send(JSON.stringify({
    type: 'auth_handshake',
    deviceFingerprint: 'ed25519_pk_994821a',
    timestamp: Date.now()
  }));
});

ws.on('message', (data) => {
  const payload = JSON.parse(data);
  console.log('[Inbox Notification Received]', payload);
});

2. Core REST Endpoints & Payload Architecture

All API requests require standard HTTPS with JSON request/response bodies and cryptographic transaction verification.

GET /api/inbox/:userPin Instant In-App Message Query

Retrieves in-app notifications and administrative dispatches for the target PIN without triggering external SMTP delays.

Response 200 OK:
{
  "success": true,
  "userPin": "ZT-USER-8801",
  "unreadCount": 1,
  "notifications": [
    {
      "id": "notif_1725430000",
      "title": "Hardware Vault Allocation Ready",
      "body": "Your 5TB Google Workspace quota has been provisioned.",
      "department": "Zenith Cloud Vault",
      "priority": "HIGH",
      "isRead": false,
      "createdAt": "2026-09-04T07:20:00.000Z"
    }
  ]
}

POST /market/:slug/reviews Anti-Spam txHash Gated

Submits a cryptographically verified review for a merchant storefront. Requires proof of on-chain or settlement transaction hash (txHash).

Payload:
{
  "authorName": "Alexander Wright",
  "authorPin": "ZT-USER-8801",
  "stars": 5,
  "headline": "Flawless architectural delivery",
  "comment": "Instant cryptographic contract confirmation.",
  "txHash": "0x4a9f82bc1d84e92a105c..."
}

POST /market/:slug/conversion Ad Conversion Tracking

Increments high-intent merchant inquiry conversion telemetry for real-time ROI tracking.

3. In-Chat POS Payload Specification (`zt.commerce.bill`)

When dispatching in-chat bills from external POS systems or backend ERPs, transmit structured JSON payloads signed with your merchant HMAC-SHA256 secret.

zt.commerce.bill.json

{
  "schema": "zt.commerce.bill.v1",
  "billId": "BILL-99481",
  "merchantPin": "ZT-PRIME-01",
  "items": [
    {
      "sku": "ZT-HW-Z1-BLK",
      "title": "Hardware Vault Z1",
      "unitPriceCents": 49900,
      "quantity": 1
    }
  ],
  "subtotalCents": 49900,
  "taxVatCents": 3742,
  "totalCents": 53642,
  "currency": "USD",
  "stockLockSeconds": 900,
  "signature": "hmac-sha256:7f8e9a0b1c2d..."
}

4. Carrier & Settlement Webhook Verifications

ZeroText triggers automated webhook dispatches for payment settlements, stock lock expirations, and carrier tracking updates (DHL, FedEx, UPS).

Webhook Event Headers

X-ZeroText-Event: commerce.payment_settled, commerce.stock_locked, carrier.status_updated
X-ZeroText-Signature: HMAC-SHA256 signature computed over the raw request body.
X-ZeroText-Timestamp: Unix epoch milliseconds timestamp.