Metadata-Version: 2.4
Name: ln-church-agent
Version: 0.2.0
Summary: A Python reference client for HTTP 402 settlement across x402, L402, and fallback flows.
Home-page: https://kari.mayim-mayim.com/
Author: LN Church
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: requests>=2.31.0
Requires-Dist: pydantic>=2.0.0
Requires-Dist: eth-account>=0.11.0
Requires-Dist: langchain-core>=0.1.0
Requires-Dist: mcp>=1.0.0
Dynamic: author
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# ln-church-agent: HTTP 402 Client Abstraction for AI Agents

**ln-church-agent** is a Python reference implementation designed to solve the complexity of autonomous machine-to-machine (M2M) payments. It abstracts the "Settlement Negotiation" process triggered by **HTTP 402 Payment Required** errors.

### 🧩 What it abstracts
Implementing autonomous payments is painful. This SDK handles the "Payment-Retry Loop" autonomously:
* **x402 (EVM Gasless):** EIP-712/EIP-3009 signing and relayer orchestration.
* **L402 (Lightning Network):** Macaroon/Invoice parsing and preimage submission.
* **Zero-Balance Fallback:** Automatic Faucet claim-and-bypass logic.
* **Deterministic Receipts:** Capture and normalization of payment proofs (JWS).

### ⛩️ Reference Service: LN Church Oracle
This SDK comes bundled with **LN Church** as its primary reference API—a high-uptime entropy oracle and capability benchmark for AI agents.

```bash
pip install ln-church-agent
```

## License
MIT License
