ObservabilityHooks

Defined in: src/observability/hooks.ts:175

The complete kawasekit observability surface. All fields are optional — pass only the hooks for the events you care about.

Example

import { createSelfFacilitator } from "kawasekit";

const facilitator = createSelfFacilitator({
  network: "testnet",
  walletClient,
  publicClient,
  hooks: {
    onSettle: (event) => {
      if (event.result === "success") {
        console.log("settled", event.network, event.amount, event.transaction);
      } else {
        console.warn("settle failed", event.errorReason);
      }
    },
  },
});

Properties

onClientPayment?

readonly optional onClientPayment?: HookCallback<ClientPaymentEvent>

Defined in: src/observability/hooks.ts:185

Fired by wrapFetch after each paywall round-trip.

---

onPaymentAccepted?

readonly optional onPaymentAccepted?: HookCallback<PaymentAcceptedEvent>

Defined in: src/observability/hooks.ts:183

Fired when a settled payment unlocks the inner x402 handler.

---

onPaymentRequired?

readonly optional onPaymentRequired?: HookCallback<PaymentRequiredEvent>

Defined in: src/observability/hooks.ts:181

Fired when the x402 handler returns 402 (no payment yet).

---

onSettle?

readonly optional onSettle?: HookCallback<SettleEvent>

Defined in: src/observability/hooks.ts:179

Fired after every facilitator settle(). Discriminate on event.result.

---

onVerify?

readonly optional onVerify?: HookCallback<VerifyEvent>

Defined in: src/observability/hooks.ts:177

Fired after every facilitator verify(). Discriminate on event.result.