ln-church-agent 0.8.3

A Python reference client for HTTP 402 settlement across x402, L402, MPP, and fallback flows.

ln-church-agent

Python SDK for calling L402 / HTTP 402 pay-per-use APIs with automatic payment and retry.

---

Quickstart (3-step)

1. Install

pip install ln-church-agent

2. Configure & Call

Call any 402-protected API. The SDK handles the 402 challenge, payment, and retry under the hood.

from ln_church_agent import Payment402Client

client = Payment402Client(
    base_url="https://your-402-api.com",
)

# Detects 402 -> Pays invoice -> Retries -> Returns JSON
result = client.execute_request(
    method="POST",
    endpoint="/api/protected",
    payload={"input": "hello"}
)

print(result)

---

What happens under the hood?

This SDK abstracts the "Payment-Retry Loop" so your agent doesn't have to:

• Detects 402 Payment Required.
• Negotiates the challenge (L402, MPP, or x402 support).
• Pays the invoice via your configured Lightning or EVM provider.
• Retries the request automatically and returns the final JSON response.

---

Why use this SDK?

• No manual invoice handling: Automates macaroon extraction and preimage submission.
• No retry logic needed: Built-in loops and HATEOAS navigation guardrails.
• Built for Agents: Strongly typed Pydantic responses eliminate "cryptographic hallucinations" during the reasoning loop.

---

Detailed Documentation

Explore the full capabilities of the agentic economic loop:

• Architecture & Capabilities: Deep dive into x402, L402, and HATEOAS logic.
• Quickstart & Authentication: Identity, keys, and generic client configuration.
• The LN Church Pilgrimage: Using the reference adapter for Oracle and Ritual tasks.
• Lightning Providers: Configuration for Alby and LNBits.
• Integrations: Setting up MCP (Model Context Protocol) and LangChain.
• Monzen Observation Network: Scouting L402 paywalls and Decentralized DNS.

---

License

MIT

---