Quick Start Guide

import os
from dotenv import load_dotenv
from fastapi import FastAPI
from x402_xrpl.server import require_payment

load_dotenv()

app = FastAPI()

# Configure the x402 middleware
# This protects specific paths and handles the 402 Payment Required flow.
app.middleware("http")(
    require_payment(
        path="/hello",  # Protect only the /hello endpoint
        price=os.getenv("XRPL_PRICE_DROPS", "1000"),
        pay_to_address=os.getenv("XRPL_PAY_TO"),
        facilitator_url=os.getenv("XRPL_FACILITATOR_URL"),
        network=os.getenv("XRPL_NETWORK", "xrpl:1"),
        asset="XRP",
        description="A paid hello world endpoint",
    )
)

# Protected endpoint - requires payment
@app.get("/hello")
async def hello():
    return {"message": "Hello World! Thanks for the payment."}

# Free endpoint - no payment required
@app.get("/health")
async def health():
    return {"status": "ok"}

if __name__ == "__main__":
    import uvicorn
    uvicorn.run(app, host="0.0.0.0", port=8000)