@oneaddress/setup

Interactive setup wizard for OneAddress partner webhook integrations.

Quick start

npx @oneaddress/setup

The wizard:

1. Collects your three credentials from the Partner Portal:
   • Partner ID (UUID)
   • Webhook Secret (HMAC-SHA256)
   • ECDH P-256 Private Key PEM
2. Asks which platform you want — TypeScript / Python / Go / PHP / Java / C#
3. Scaffolds a working webhook server into the directory you choose
4. Installs dependencies for that platform
5. Starts the server and waits for /health
6. Opens a free Cloudflare HTTPS tunnel (or accepts a URL you provide)
7. Registers the webhook URL in the Partner Portal
8. Runs the conformance check against your live URL

If everything passes, you're integrated.

What you get

A real webhook server (not a toy) with:

• HMAC-SHA256 signature verification (timing-safe via Web Crypto)
• ECDH P-256 + HKDF-SHA256 + AES-256-GCM address decryption
• Replay-window enforcement (±5 min) before signature verify
• Persistent dispatch deduplication
• Address normalisation helper
• For TypeScript: an optional 250-customer demo database with end-to-end matching

Customise the match logic

Open the entry-point file the wizard prints on completion (src/match.ts for ts-node, app.py for Python, etc.) and replace the demo logic with your real database lookup. The README inside the scaffolded project walks through the pattern.

Re-run the conformance check

From the Partner Portal → My Profile → Integration Conformance.

Documentation

• Partner Portal
• Protocol Specification
• Service Level Objectives

Issues

[email protected]