Metadata-Version: 2.4
Name: xrpl-x402-facilitator
Version: 0.1.0
Summary: FastAPI facilitator service for XRPL-backed x402 payments
Project-URL: Homepage, https://github.com/lgcarrier/xrpl-x402-stack
Project-URL: Documentation, https://lgcarrier.github.io/xrpl-x402-stack/packages/facilitator/
Project-URL: Repository, https://github.com/lgcarrier/xrpl-x402-stack
Project-URL: Issues, https://github.com/lgcarrier/xrpl-x402-stack/issues
Project-URL: Changelog, https://github.com/lgcarrier/xrpl-x402-stack/blob/main/CHANGELOG.md
Author-email: Louis-Guillaume Carrier-Bedard <lgcarrier@gmail.com>
License-Expression: MIT
Keywords: facilitator,fastapi,payments,x402,xrpl
Classifier: Framework :: FastAPI
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Typing :: Typed
Requires-Python: >=3.12
Requires-Dist: fastapi==0.115.0
Requires-Dist: pydantic-settings==2.6.1
Requires-Dist: python-dotenv==1.0.1
Requires-Dist: redis==5.2.1
Requires-Dist: slowapi==0.1.9
Requires-Dist: structlog==24.4.0
Requires-Dist: uvicorn[standard]==0.30.6
Requires-Dist: xrpl-py==4.0.0
Requires-Dist: xrpl-x402-core<0.2.0,>=0.1.0
Description-Content-Type: text/markdown

# xrpl-x402-facilitator

`xrpl-x402-facilitator` is the FastAPI verifier/settler service in the Open XRPL x402 Stack.

## Install

```bash
pip install xrpl-x402-facilitator
```

## Run

The CLI starts `xrpl_x402_facilitator.main:app`:

```bash
export MY_DESTINATION_ADDRESS=rPT1Sjq2YGrBMTttX4GZHjKu9dyfzbpAYe
export FACILITATOR_BEARER_TOKEN=replace-with-your-token
export REDIS_URL=redis://127.0.0.1:6379/0
xrpl-x402-facilitator --host 127.0.0.1 --port 8000
```

Minimal import surface:

```python
from xrpl_x402_facilitator import create_app

app = create_app()
```

## Stable HTTP Contract

- `GET /health`
- `GET /supported`
- `POST /verify`
- `POST /settle`

## Public API

- `create_app(...)`
- `xrpl_x402_facilitator.main:app`
- `xrpl-x402-facilitator`

## Compatibility

- Python `3.12`
- `xrpl-py==4.0.0`
- Default network is `xrpl:0`; local demos commonly target `xrpl:1`
- `x402` is not required to run the facilitator service

## Provenance

The implementation is independently developed for the open `x402` protocol and does not copy `x402-xrpl`.
