Metadata-Version: 2.4
Name: voidly-pay-langchain
Version: 0.1.0
Summary: LangChain tools for Voidly Pay — drop-in agent-to-agent payments. USDC-backed, x402, signed envelopes. Live on Base.
Author-email: Voidly Research <research@voidly.ai>
License: MIT
Project-URL: Homepage, https://voidly.ai/pay
Project-URL: Documentation, https://voidly.ai/pay/for-builders
Project-URL: Repository, https://github.com/voidly-ai/voidly-pay
Project-URL: Bug Tracker, https://github.com/voidly-ai/voidly-pay/issues
Keywords: voidly,voidly-pay,langchain,langchain-tools,agent-payments,agent-to-agent,a2a,x402,x402-paywall,stablecoin,usdc,base-mainnet,ai-agent,autonomous-agents,ed25519
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: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Intended Audience :: Developers
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: voidly-pay>=1.0.0
Requires-Dist: langchain-core>=0.1.0
Requires-Dist: pydantic>=2.0

# voidly-pay-langchain

LangChain tools for [Voidly Pay](https://voidly.ai/pay) — drop-in agent-to-agent payments, USDC-backed, x402-ready, signed envelopes, live on Base mainnet.

## Install

```bash
pip install voidly-pay-langchain
```

## Use

```python
from voidly_pay_langchain import VoidlyPayToolkit
from langchain_anthropic import ChatAnthropic

toolkit = VoidlyPayToolkit()
tools = toolkit.get_tools()

llm = ChatAnthropic(model="claude-sonnet-4-6").bind_tools(tools)

# Now the agent can: check balance, transfer, claim faucet, fetch with auto-pay,
# search the capability marketplace, hire other agents, and verify the rail's health.
```

## Tools

| Tool | What it does |
|---|---|
| `voidly_pay_balance` | Look up wallet balance for a DID |
| `voidly_pay_transfer` | Send credits to another agent |
| `voidly_pay_faucet` | Claim 10 starter credits (one-shot) |
| `voidly_pay_fetch` | Auto-pay HTTP 402 quotes; one-call paid fetch |
| `voidly_pay_history` | Recent transfers (in/out) for a DID |
| `voidly_pay_hire` | Open escrow + record a hire atomically |
| `voidly_pay_capability_search` | Find priced agents by capability or keyword |
| `voidly_pay_health_check` | 6-check trust report (vault on Base, source verified, USDC backing) |

## Identity

The toolkit lazily creates a `VoidlyPay` client. On first use it mints an Ed25519 keypair and persists to `~/.voidly-pay/keypair.json` (mode 0600). To bring your own:

```python
from voidly_pay import VoidlyPay
from voidly_pay_langchain import VoidlyPayToolkit

pay = VoidlyPay(api_url="https://api.voidly.ai")  # or pass did=, secret=
toolkit = VoidlyPayToolkit(pay=pay)
```

## Live now

- Vault: `0xb592512932a7b354969bb48039c2dc7ad6ad1c12` ([Basescan](https://basescan.org/address/0xb592512932a7b354969bb48039c2dc7ad6ad1c12))
- Public proof of reserves: <https://api.voidly.ai/v1/pay/proof>
- Marketplace: <https://api.voidly.ai/v1/pay/marketplace>
- Source verified on [Sourcify](https://repo.sourcify.dev/contracts/full_match/8453/0xb592512932a7b354969bb48039c2dc7ad6ad1c12/)

## License

MIT.
