# Adoption Examples

Status: alpha examples for local and testnet-oriented review.

The repository examples run in mock mode by default. They do not require wallet
secrets, RPC credentials, or a live node.

## Protect A Fixed-Price HTTP Route

Use `exact` when every request has a fixed charge and the client can submit a
direct native payment for that amount.

Run:

```sh
npm run build
node examples/paid-http-api/index.mjs
```

The example exercises the unpaid `402`, paid retry, settlement response, and
replay handling path.

## Protect Repeated Requests

Use `batch-settlement` when repeated or variable-cost requests should share one
escrow channel. The client opens a channel and signs cumulative vouchers as
requests are served.

The HTTP example includes deposit-voucher and voucher-only channel reuse paths.

## Call A Paid API

The client package exposes direct-mode helpers for parsing `PAYMENT-REQUIRED`,
selecting a compatible Kaspa offer, building the payment payload through injected
wallet/signing adapters, and verifying `PAYMENT-RESPONSE` before advancing local
state.

## Protect An MCP Tool

Run:

```sh
npm run build
node examples/paid-mcp-tool/index.mjs
```

The MCP example returns a payment-required tool result, retries with
`_meta["x402/payment"]`, and attaches `_meta["x402/payment-response"]` after
settlement.

## Use A Self-Hosted Facilitator

Run:

```sh
npm run build
node examples/self-hosted-facilitator/index.mjs
```

The facilitator example shows compatibility endpoints over the direct-mode
server verification and settlement path. This package is not part of the initial
alpha publish set.

## Inspect Recovery Behavior

Run:

```sh
npm run build
node examples/recovery/index.mjs
```

The recovery example covers client/server state loss, exact replay, corrective
`402`, and refund preview behavior.