TypeScript client — PPOps documentation

This manual targets 0.1.0-beta.3. Read the source and availability policy before installing. Historical reports retain their original scope.

The beta.3 package exports ppops/client: PPOpsClient, usdcAtomic and webhook verification helpers. HTTP remains the default integration boundary; no library is required.

Install from the source package

First obtain the beta.3 checkout. In that directory:

npm ci
npm pack

Then, in your Node.js 22+ ESM application:

npm install /absolute/path/to/ppops-0.1.0-beta.3.tgz

This installs the complete daemon dependency tree, not a separately published lightweight SDK. Importing the client does not start the daemon or load the RAILGUN runtime. Use raw HTTP to avoid those package dependencies.

Use the maintained integration examples

Create an intent with a persisted order, expiry and idempotency key.
Verify raw-body webhooks, enforce freshness and deduplicate before fulfillment.
Run the merchant example against a real daemon.
HTTP API, OpenAPI and payment state semantics.