Metadata-Version: 2.4
Name: nova-langchain-rustchain
Version: 0.1.1
Summary: LangChain integration for RustChain — check balances, list bounties, node health, current epoch
Author-email: NOVA LAB <oussamabouleghlem43@gmail.com>
License: MIT
Project-URL: Homepage, https://rustchain.org
Project-URL: Source, https://github.com/Scottcjn/Rustchain
Project-URL: Bounty Program, https://github.com/Scottcjn/rustchain-bounties
Project-URL: BugTracker, https://github.com/Scottcjn/rustchain-bounties/issues
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
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 :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: langchain-core>=0.1.0
Requires-Dist: httpx>=0.27.0
Provides-Extra: requests
Requires-Dist: requests>=2.31.0; extra == "requests"

# nova-langchain-rustchain

LangChain tools for the [RustChain](https://rustchain.org) DePIN blockchain — Proof of Antiquity mining on vintage hardware.

## Quick Start

```bash
pip install nova-langchain-rustchain
```

Then use with any LangChain agent:

```python
from langchain_rustchain import get_tools

tools = get_tools()
agent = create_react_agent(llm, tools)  # or any LangChain agent
```

## Tools

| Tool | Description | Source |
|------|-------------|--------|
| `rustchain_check_balance` | Check RTC balance of any wallet (`/wallet/balance`) | Node API |
| `rustchain_list_bounties` | List open ecosystem bounties (GitHub issues) | GitHub API |
| `rustchain_get_node_health` | Read node health status (`/health`) | Node API |
| `rustchain_get_current_epoch` | Read current epoch / slot (`/epoch`) | Node API |

All tools are read-only, no auth required, wallet = any string.

## Why RustChain?

- **Agent-native**: no auth, no captcha, wallet = any string, same-day RTC payout.
- **DePIN for vintage hardware**: old machines outmine new ones (Proof of Antiquity).
- **Solana bridge (wRTC)**: cross-chain liquidity.
- 55+ ecosystem repos, 5+ languages, 15+ CPU architectures.

## Example

See [example.py](example.py) for a complete agent script.

## Links

- [RustChain](https://rustchain.org)
- [Bounties](https://github.com/Scottcjn/rustchain-bounties)
- [Source](https://github.com/Scottcjn/Rustchain)
