# BitBooth

BitBooth's featured product is **PageDelta**, a paid page observation API for agents.

```text
POST https://app.heinrichstech.com/v1/cdp/render-pro
$0.01 per observation
```

A buyer does not need a BitBooth account or subscription. Send a page URL, inspect the x402 challenge, pay with a supported stablecoin rail, and receive rendered Markdown plus bounded change evidence.

**Live links:** [PageDelta browser demo](https://app.heinrichstech.com/demo) | [featured catalog](https://app.heinrichstech.com/bazaar.json) | [API docs](https://app.heinrichstech.com/docs) | [MCP package](https://www.npmjs.com/package/@bitbooth/mcp-fetch)

## What PageDelta does

The first paid observation saves a baseline scoped to the payer, canonical URL, and extraction mode. A later paid observation of the same scope compares the new result with that saved baseline.

Each successful response can include:

- rendered, bounded Markdown
- an exact, case-sensitive focus search result
- a structured, bounded line diff
- the prior baseline status and saved revision
- a new opaque cursor for continuity checks
- content and observation hashes
- an optional bounded JPEG snapshot
- settled payment metadata and a `PAYMENT-RESPONSE` receipt

The cursor is not an access token, and returned web content is untrusted input. Agents should still apply their own prompt-injection and data-handling policy.

## Inspect the live challenge

This request does not pay. It returns HTTP `402` with the current payment requirements in the `PAYMENT-REQUIRED` header.

```bash
curl -i -X POST https://app.heinrichstech.com/v1/cdp/render-pro \
  -H 'content-type: application/json' \
  -d '{"url":"https://example.com","extract":"article","focus":"Example Domain"}'
```

For production PageDelta, the advertised rails are:

| Network | Asset |
| --- | --- |
| Base mainnet | USDC |
| XRPL mainnet | RLUSD |
| XRPL mainnet | USDC IOU |
| Stellar pubnet | USDC |

The fresh `402` challenge is authoritative for the exact network identifier, asset or issuer, amount, recipient, and timeout. PageDelta does not advertise a Solana rail.

## Try the complete flow without real money

Open [the PageDelta browser demo](https://app.heinrichstech.com/demo). It runs an isolated XRPL Testnet exercise:

1. The tab creates a temporary wallet in browser memory.
2. The official faucet funds it with valueless test XRP.
3. The first observation pays 1,000 test drops and saves a payer-scoped baseline.
4. The demo changes its isolated page from revision 1 to revision 2.
5. The second observation pays another 1,000 test drops and returns the change.
6. The run ends with two XRPL Testnet receipts.

Confirmation retries reuse the same signed proof. They do not create additional payments. This demo proves the test flow only. It is not a production payment and does not represent revenue.

## Use the MCP buyer

The current buyer is [`@bitbooth/mcp-fetch@2.3.1`](https://www.npmjs.com/package/@bitbooth/mcp-fetch). Its official MCP registry name is `io.github.Drock91/bitbooth-fetch`.

For free catalog discovery, no wallet credential is required:

```json
{
  "mcpServers": {
    "bitbooth": {
      "command": "npx",
      "args": ["-y", "@bitbooth/mcp-fetch@2.3.1"]
    }
  }
}
```

The packaged PageDelta buyer currently automates the XRPL mainnet RLUSD path. Enabling it requires an explicit `xrpl-rlusd` rail, a dedicated low-balance XRPL wallet, and a per-call limit of at least `0.010000`. See [the integration guide](./docs/INTEGRATION.md) before adding a seed.

## Discovery scope

[`https://app.heinrichstech.com/bazaar.json`](https://app.heinrichstech.com/bazaar.json) currently features exactly one resource: PageDelta at `/v1/cdp/render-pro`.

That featured catalog is a deliberate release surface. It is not a count of everything implemented inside BitBooth. Internal and reference routes may exist outside it, and private seller routes are not automatically published there.

## XRPL ecosystem status

BitBooth already has an [XRPL AI merchant listing](https://xrpl-ai.org/address/rfryheo6yzFdLWj8qUQtZc7zG9MKkBkUEy). It is an existing listing, not a new one. The external profile may lag BitBooth's current release, so the live featured catalog and fresh route challenge are authoritative.

[ClawCredit's published docs](https://claw.credit/docs) describe generic x402 compatibility, including XRPL and RLUSD. BitBooth has not completed live ClawCredit interoperability or certification and is not currently a ClawCredit Partner. We do not claim guaranteed support, financing terms, or fees.

## Documentation

- [Featured endpoint reference](./docs/ENDPOINTS.md)
- [Buyer integration guide](./docs/INTEGRATION.md)
- [XRPL notes](./docs/XRPL.md)
- [No-value smoke test](./SMOKE_TEST.md)
- [PageDelta examples](./examples/README.md)
- [Featured PageDelta OpenAPI](https://app.heinrichstech.com/openapi.json)
- [Full compatibility OpenAPI](https://app.heinrichstech.com/openapi.yaml)

## About

BitBooth is built and operated by [Heinrichs Software Solutions Company](https://heinrichstech.com) in Tallahassee, Florida.

This repository contains public documentation, MCP package source mirrors, PageDelta integration guidance, and links to the live OpenAPI specifications. The gateway source is operated separately.

## License

MIT. See [LICENSE](./LICENSE).