@x402r/helpers

Lifecycle hooks for x402r escrow payments.

Install

pnpm add @x402r/helpers

Usage

import { forwardToArbiter } from '@x402r/helpers'

const resourceServer = new x402ResourceServer(facilitatorClient)
  .register(networkId, new EscrowServerScheme())
  .onAfterSettle(forwardToArbiter('http://arbiter:3001'))

API

forwardToArbiter(arbiterUrl, options?)

Creates an onAfterSettle hook that forwards the response body to an arbiter service for evaluation. Fire-and-forget — does not block the response to the client.

• Only fires for successful commerce scheme settlements
• POSTs { responseBody, transaction, paymentPayload } to {arbiterUrl}/verify
• Errors silently caught (arbiter being down shouldn't break payment flow)

Options

| Option | Type | Description | | --------- | ---------------------------- | ------------------------------------------------ | | onError | (error: unknown) => void | Custom error handler. Defaults to console.warn. |

forwardToArbiter('http://arbiter:3001', {
  onError: (err) => sentry.captureException(err),
})

Docs

docs.x402r.org

License

Apache-2.0