Metadata-Version: 2.4
Name: dpx-langchain
Version: 1.0.1
Summary: DPX settlement and intelligence tools for LangChain agents — quote, ESG scoring, oracle status, and settlement execution.
Project-URL: Homepage, https://untitledfinancial.com
Project-URL: Documentation, https://docs.untitledfinancial.com
Project-URL: Repository, https://github.com/untitledfinancial/DPX-API
Author-email: "Untitled_ LuxPerpetua Technologies, Inc." <case@untitledfinancial.com>
License: MIT
License-File: LICENSE
Keywords: ai-agent,cross-border,dpx,esg,fintech,langchain,payments,settlement,stablecoin,usdc
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Office/Business :: Financial
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.9
Requires-Dist: httpx>=0.24.0
Requires-Dist: langchain-core>=0.2.0
Provides-Extra: langchain
Requires-Dist: langchain>=0.2.0; extra == 'langchain'
Description-Content-Type: text/markdown

# dpx-langchain

LangChain tools for cross-border payment settlement and macro intelligence via the DPX Protocol.

```bash
pip install dpx-langchain
```

## Tools

| Tool | What it does |
|------|-------------|
| `DpxQuoteTool` | Price a cross-border or domestic payment before executing |
| `DpxSettleTool` | Execute a settlement — USD→EUR, USD→GBP, or same-currency on Base mainnet |
| `DpxEsgTool` | Counterparty ESG scoring from 6 institutional sources (World Bank, UN, IMF, OECD, SEC, Climate Monitor) — required for EU SFDR/CSRD compliance |
| `DpxOracleTool` | Go/hold signal from the DPX Stability Oracle — stability score, peg deviation, AI recommendation |
| `DpxOracleFullTool` | Full 10-layer macro intelligence: climate (30–90 day lead), FX, commodities, geopolitical risk, yield curve, USD structural health, AI synthesis |
| `DpxRailsTool` | Live health of local payment rails — PIX, SEPA, FedACH, CHAPS, UPI, PromptPay |

## Usage

```python
from dpx_langchain import get_dpx_tools
from langchain.agents import create_react_agent

tools = get_dpx_tools()
agent = create_react_agent(llm=llm, tools=tools, prompt=prompt)
```

Individual tools:

```python
from dpx_langchain import DpxQuoteTool, DpxSettleTool, DpxEsgTool, DpxOracleTool

tools = [DpxQuoteTool(), DpxSettleTool(), DpxEsgTool(), DpxOracleTool()]
```

Exclude specific tools:

```python
tools = get_dpx_tools(exclude=["dpx_oracle_full", "dpx_rail_status"])
```

## Environment variables

| Variable | Default |
|----------|---------|
| `DPX_ORACLE_URL` | `https://stability.untitledfinancial.com` |
| `DPX_AGENT_URL` | `https://agent.untitledfinancial.com` |

## Links

- [Documentation](https://docs.untitledfinancial.com)
- [MCP server](https://www.npmjs.com/package/@untitledfinancial/dpx-mcp) — `npx @untitledfinancial/dpx-mcp`
- [GitHub](https://github.com/untitledfinancial/DPX-API)
