Metadata-Version: 2.4
Name: xrpl-mpp-payer
Version: 0.1.4
Summary: CLI, proxy, and MCP payer for XRPL MPP HTTP payments
Project-URL: Documentation, https://lgcarrier.github.io/xrpl-mpp-stack/packages/payer/
Project-URL: Source, https://github.com/lgcarrier/xrpl-mpp-stack/tree/main/packages/payer
Project-URL: Issues, https://github.com/lgcarrier/xrpl-mpp-stack/issues
Project-URL: Changelog, https://github.com/lgcarrier/xrpl-mpp-stack/blob/main/CHANGELOG.md
Author-email: Louis-Guillaume Carrier-Bedard <lgcarrier@gmail.com>
License-Expression: MIT
Keywords: mcp,mpp,payer,payments,xrpl
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: httpx==0.28.1
Requires-Dist: pydantic<3,>=2
Requires-Dist: starlette<2,>=0.37
Requires-Dist: typer<1,>=0.12
Requires-Dist: uvicorn<1,>=0.30.6
Requires-Dist: xrpl-mpp-client<0.2.0,>=0.1.4
Requires-Dist: xrpl-mpp-core<0.2.0,>=0.1.4
Requires-Dist: xrpl-py==4.5.0
Provides-Extra: mcp
Requires-Dist: fastmcp>=3.1.0; extra == 'mcp'
Description-Content-Type: text/markdown

# xrpl-mpp-payer

CLI, proxy, and MCP payer for XRPL-backed MPP HTTP resources.

## Install

```bash
pip install xrpl-mpp-payer
```

For MCP support:

```bash
pip install "xrpl-mpp-payer[mcp]"
```

## Commands

```bash
xrpl-mpp pay https://merchant.example/premium --amount 0.001 --asset XRP
xrpl-mpp proxy https://merchant.example --port 8787
xrpl-mpp skill install
xrpl-mpp mcp
```

The payer stores receipts locally, enforces spend caps with `XRPL_MPP_MAX_SPEND`, and can auto-pay `charge` or `session` flows over HTTP.

## Environment

- `XRPL_WALLET_SEED` is required for real payments
- `XRPL_RPC_URL` overrides the JSON-RPC endpoint
- `XRPL_NETWORK` selects the CAIP-2 XRPL network id
- `XRPL_MPP_MAX_SPEND` sets a global spend cap
- `XRPL_MPP_RECEIPTS_PATH` overrides the local receipts file path

`xrpl-mpp pay --dry-run ...` is useful for confirming that a route exposes a valid MPP challenge before you allow the payer to sign and retry automatically.
