nova-langchain-rustchain 0.1.1__tar.gz

nova_langchain_rustchain-0.1.1/PKG-INFO

@@ -0,0 +1,71 @@
+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)

nova_langchain_rustchain-0.1.1/README.md

@@ -0,0 +1,46 @@
+# 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)

nova_langchain_rustchain-0.1.1/langchain_rustchain/__init__.py

@@ -0,0 +1,26 @@
+# SPDX-License-Identifier: MIT
+"""RustChain LangChain integration — check balances, list bounties, inspect node health, read current epoch.
+
+Exposes ``RustChainBalanceTool``, ``RustChainBountiesTool``,
+``RustChainNodeHealthTool``, and ``RustChainCurrentEpochTool`` as
+LangChain ``BaseTool`` subclasses, plus a convenience ``get_tools()``
+factory and ``ALL_RUSTCHAIN_TOOLS`` list.
+"""
+
+from langchain_rustchain.tools import (
+    ALL_RUSTCHAIN_TOOLS,
+    RustChainBalanceTool,
+    RustChainBountiesTool,
+    RustChainCurrentEpochTool,
+    RustChainNodeHealthTool,
+    get_tools,
+)
+
+__all__ = [
+    "RustChainBalanceTool",
+    "RustChainBountiesTool",
+    "RustChainNodeHealthTool",
+    "RustChainCurrentEpochTool",
+    "ALL_RUSTCHAIN_TOOLS",
+    "get_tools",
+]

nova_langchain_rustchain-0.1.1/langchain_rustchain/tools.py

@@ -0,0 +1,236 @@
+# SPDX-License-Identifier: MIT
+"""RustChain LangChain tools.
+
+A LangChain ``BaseTool`` exposing read-only RustChain node endpoints so an
+LLM agent can check wallet balances, list ecosystem bounties, inspect node
+health, and read the current epoch — all against the public RustChain node
+(https://rustchain.org, wallet = any string, no auth).
+
+Dependencies: ``langchain-core`` and ``httpx`` (or ``requests``).
+"""
+
+from __future__ import annotations
+
+import json
+import os
+from typing import Any, Dict, List, Optional
+
+from langchain_core.tools import BaseTool
+from pydantic import BaseModel, Field
+
+try:  # httpx preferred (async-capable), fall back to requests
+    import httpx
+
+    _HTTPX = True
+except ImportError:  # pragma: no cover - environment fallback
+    httpx = None  # type: ignore[assignment]
+    _HTTPX = False
+    import requests
+
+DEFAULT_NODE = "https://rustchain.org"
+DEFAULT_BOUNTIES_REPO = "Scottcjn/rustchain-bounties"
+TIMEOUT_S = 15.0
+
+
+class _Client:
+    """Tiny sync HTTP helper so the tools don't drag in a full SDK."""
+
+    def __init__(self, node_url: str, timeout: float = TIMEOUT_S, headers: Optional[Dict[str, str]] = None):
+        self.node_url = node_url.rstrip("/")
+        self.timeout = timeout
+        self.headers = headers or {}
+
+    def get(self, path: str, params: Optional[Dict[str, Any]] = None) -> Dict[str, Any]:
+        url = f"{self.node_url}{path}"
+        try:
+            if _HTTPX:
+                resp = httpx.get(url, params=params, headers=self.headers, timeout=self.timeout)
+            else:
+                resp = requests.get(url, params=params, headers=self.headers, timeout=self.timeout)
+            resp.raise_for_status()
+        except Exception as exc:
+            return {"ok": False, "error": str(exc)}
+        try:
+            return resp.json()
+        except ValueError:
+            return {"ok": False, "error": "non_json_response", "status": resp.status_code}
+
+
+# ---------------------------------------------------------------------------
+# Schemas (pydantic) — one input schema per tool improves tool-call reliability.
+# ---------------------------------------------------------------------------
+
+class CheckBalanceInput(BaseModel):
+    wallet_id: str = Field(
+        description="The RustChain wallet id / miner address to look up. "
+        "Any string wallet is accepted (agent-native, no auth)."
+    )
+
+
+class ListBountiesInput(BaseModel):
+    limit: int = Field(
+        default=10,
+        ge=1,
+        le=50,
+        description="Maximum number of open bounties to return.",
+    )
+
+
+class GetNodeHealthInput(BaseModel):
+    pass
+
+
+class GetCurrentEpochInput(BaseModel):
+    pass
+
+
+# ---------------------------------------------------------------------------
+# Tools
+# ---------------------------------------------------------------------------
+
+class RustChainBalanceTool(BaseTool):
+    """Check the RTC balance of a RustChain wallet."""
+
+    name: str = "rustchain_check_balance"
+    description: str = (
+        "Check the RTC balance of a RustChain wallet id. "
+        "Returns the balance in RTC (and the raw integer amount). "
+        "Use for questions like 'how much RTC does wallet X hold?'."
+    )
+    args_schema: type[BaseModel] = CheckBalanceInput
+
+    node_url: str = DEFAULT_NODE
+
+    def _run(self, wallet_id: str) -> str:
+        client = _Client(self.node_url)
+        data = client.get(
+            "/wallet/balance", params={"miner_id": wallet_id}
+        )
+        if not data.get("ok", True):
+            return json.dumps({"ok": False, "error": data.get("error", "unknown")})
+        return json.dumps(
+            {
+                "ok": True,
+                "wallet_id": data.get("miner_id", wallet_id),
+                "balance_rtc": data.get("amount_rtc", 0.0),
+                "balance_raw": data.get("amount_i64", 0),
+            }
+        )
+
+
+class RustChainBountiesTool(BaseTool):
+    """List open RustChain ecosystem bounties."""
+
+    name: str = "rustchain_list_bounties"
+    description: str = (
+        "List currently open RustChain ecosystem bounties (Earn RTC by "
+        "contributing: code, docs, security, community). Returns the most "
+        "recent open bounties with their issue number, title, and labels."
+    )
+    args_schema: type[BaseModel] = ListBountiesInput
+
+    bounties_repo: str = DEFAULT_BOUNTIES_REPO
+
+    def _run(self, limit: int = 10) -> str:
+        # Bounties are tracked as GitHub issues labelled ``bounty`` in the
+        # rustchain-bounties repo. Use the public GitHub REST API.
+        # Reads GH_TOKEN or GITHUB_TOKEN from the environment for higher
+        # rate limits (optional — the endpoint is unauthenticated-friendly).
+        headers = {}
+        token = os.environ.get("GH_TOKEN") or os.environ.get("GITHUB_TOKEN") or ""
+        if token:
+            headers["Authorization"] = f"Bearer {token}"
+        client = _Client("https://api.github.com", headers=headers)
+        data = client.get(
+            f"/repos/{self.bounties_repo}/issues",
+            params={"state": "open", "labels": "bounty", "per_page": limit},
+        )
+        if isinstance(data, list):
+            items = []
+            for issue in data:
+                items.append(
+                    {
+                        "number": issue.get("number"),
+                        "title": issue.get("title"),
+                        "url": issue.get("html_url"),
+                        "labels": [
+                            lbl.get("name")
+                            for lbl in issue.get("labels", [])
+                        ],
+                    }
+                )
+            return json.dumps({"ok": True, "count": len(items), "bounties": items})
+        return json.dumps({"ok": False, "error": str(data)})
+
+
+class RustChainNodeHealthTool(BaseTool):
+    """Read RustChain node health status."""
+
+    name: str = "rustchain_get_node_health"
+    description: str = (
+        "Get the current health status of the RustChain public node: "
+        "database read/write availability, tip age, uptime, and version. "
+        "Use to answer 'is RustChain up / healthy?'."
+    )
+    args_schema: type[BaseModel] = GetNodeHealthInput
+
+    node_url: str = DEFAULT_NODE
+
+    def _run(self) -> str:
+        client = _Client(self.node_url)
+        data = client.get("/health")
+        return json.dumps(data)
+
+
+class RustChainCurrentEpochTool(BaseTool):
+    """Read the current RustChain epoch."""
+
+    name: str = "rustchain_get_current_epoch"
+    description: str = (
+        "Get the current RustChain epoch, current slot, enrolled miner count, "
+        "and per-epoch RTC emission. Use for questions about the current "
+        "consensus epoch / mining round."
+    )
+    args_schema: type[BaseModel] = GetCurrentEpochInput
+
+    node_url: str = DEFAULT_NODE
+
+    def _run(self) -> str:
+        client = _Client(self.node_url)
+        data = client.get("/epoch")
+        return json.dumps(data)
+
+
+# Handy collection for loading all tools at once.
+ALL_RUSTCHAIN_TOOLS: List[BaseTool] = [
+    RustChainBalanceTool(),
+    RustChainBountiesTool(),
+    RustChainNodeHealthTool(),
+    RustChainCurrentEpochTool(),
+]
+
+
+def get_tools(node_url: str = DEFAULT_NODE, bounties_repo: str = DEFAULT_BOUNTIES_REPO) -> List[BaseTool]:
+    """Return a fresh list of all RustChain tools with custom endpoints.
+
+    Args:
+        node_url: RustChain node base URL (defaults to the public node).
+        bounties_repo: ``owner/repo`` of the bounty issue tracker
+            (defaults to Scottcjn/rustchain-bounties).
+    """
+    return [
+        RustChainBalanceTool(node_url=node_url),
+        RustChainBountiesTool(bounties_repo=bounties_repo),
+        RustChainNodeHealthTool(node_url=node_url),
+        RustChainCurrentEpochTool(node_url=node_url),
+    ]
+
+
+__all__ = [
+    "RustChainBalanceTool",
+    "RustChainBountiesTool",
+    "RustChainNodeHealthTool",
+    "RustChainCurrentEpochTool",
+    "ALL_RUSTCHAIN_TOOLS",
+    "get_tools",
+]

nova_langchain_rustchain-0.1.1/nova_langchain_rustchain.egg-info/PKG-INFO

@@ -0,0 +1,71 @@
+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)

nova_langchain_rustchain-0.1.1/nova_langchain_rustchain.egg-info/SOURCES.txt

@@ -0,0 +1,10 @@
+README.md
+pyproject.toml
+langchain_rustchain/__init__.py
+langchain_rustchain/tools.py
+nova_langchain_rustchain.egg-info/PKG-INFO
+nova_langchain_rustchain.egg-info/SOURCES.txt
+nova_langchain_rustchain.egg-info/dependency_links.txt
+nova_langchain_rustchain.egg-info/requires.txt
+nova_langchain_rustchain.egg-info/top_level.txt
+tests/test_tools.py

nova_langchain_rustchain-0.1.1/nova_langchain_rustchain.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

nova_langchain_rustchain-0.1.1/nova_langchain_rustchain.egg-info/requires.txt

@@ -0,0 +1,5 @@
+langchain-core>=0.1.0
+httpx>=0.27.0
+
+[requests]
+requests>=2.31.0

nova_langchain_rustchain-0.1.1/nova_langchain_rustchain.egg-info/top_level.txt

@@ -0,0 +1 @@
+langchain_rustchain

nova_langchain_rustchain-0.1.1/pyproject.toml

@@ -0,0 +1,40 @@
+[build-system]
+requires = ["setuptools>=64", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "nova-langchain-rustchain"
+version = "0.1.1"
+description = "LangChain integration for RustChain — check balances, list bounties, node health, current epoch"
+readme = "README.md"
+license = {text = "MIT"}
+requires-python = ">=3.9"
+authors = [
+    {name = "NOVA LAB", email = "oussamabouleghlem43@gmail.com"},
+]
+dependencies = [
+    "langchain-core>=0.1.0",
+    "httpx>=0.27.0",
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+
+[project.urls]
+Homepage = "https://rustchain.org"
+Source = "https://github.com/Scottcjn/Rustchain"
+"Bounty Program" = "https://github.com/Scottcjn/rustchain-bounties"
+BugTracker = "https://github.com/Scottcjn/rustchain-bounties/issues"
+
+[project.optional-dependencies]
+requests = ["requests>=2.31.0"]
+
+[tool.setuptools.packages.find]
+include = ["langchain_rustchain*"]

nova_langchain_rustchain-0.1.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

nova_langchain_rustchain-0.1.1/tests/test_tools.py

@@ -0,0 +1,176 @@
+# SPDX-License-Identifier: MIT
+"""Offline tests for langchain_rustchain tools.
+
+These tests stub the HTTP layer, so they run without network access and
+without a live RustChain node.
+"""
+
+import json
+
+import pytest
+
+import langchain_rustchain.tools as tools
+from langchain_rustchain import (
+    ALL_RUSTCHAIN_TOOLS,
+    RustChainBalanceTool,
+    RustChainBountiesTool,
+    RustChainCurrentEpochTool,
+    RustChainNodeHealthTool,
+    get_tools,
+)
+
+
+class _FakeResp:
+    def __init__(self, payload=None, status=200, bad_json=False):
+        self._payload = payload
+        self.status_code = status
+        self._bad_json = bad_json
+
+    def raise_for_status(self):
+        if self.status_code >= 400:
+            raise RuntimeError(f"HTTP {self.status_code}")
+
+    def json(self):
+        if self._bad_json:
+            raise ValueError("not json")
+        return self._payload
+
+
+def _patch_httpx(monkeypatch, resp, capture=None):
+    def fake_get(url, params=None, headers=None, timeout=None):
+        if capture is not None:
+            capture.update(url=url, params=params, headers=headers, timeout=timeout)
+        if isinstance(resp, Exception):
+            raise resp
+        return resp
+
+    monkeypatch.setattr(tools.httpx, "get", fake_get)
+
+
+def test_balance_tool_maps_node_response(monkeypatch):
+    capture = {}
+    _patch_httpx(
+        monkeypatch,
+        _FakeResp({"miner_id": "alice", "amount_rtc": 12.5, "amount_i64": 12_500_000_000}),
+        capture,
+    )
+
+    out = json.loads(RustChainBalanceTool()._run("alice"))
+
+    assert out["ok"] is True
+    assert out["wallet_id"] == "alice"
+    assert out["balance_rtc"] == 12.5
+    assert out["balance_raw"] == 12_500_000_000
+    assert capture["url"].endswith("/wallet/balance")
+    assert capture["params"] == {"miner_id": "alice"}
+
+
+def test_balance_tool_handles_transport_error(monkeypatch):
+    _patch_httpx(monkeypatch, ConnectionError("boom"))
+
+    out = json.loads(RustChainBalanceTool()._run("alice"))
+
+    assert out["ok"] is False
+    assert "boom" in out["error"]
+
+
+def test_bounties_tool_maps_issue_list(monkeypatch):
+    capture = {}
+    issues = [
+        {
+            "number": 3074,
+            "title": "Integrate RustChain as a native LangChain tool",
+            "html_url": "https://github.com/Scottcjn/rustchain-bounties/issues/3074",
+            "labels": [{"name": "bounty"}, {"name": "agent-welcome"}],
+        }
+    ]
+    _patch_httpx(monkeypatch, _FakeResp(issues), capture)
+
+    out = json.loads(RustChainBountiesTool()._run(limit=5))
+
+    assert out["ok"] is True
+    assert out["count"] == 1
+    assert out["bounties"][0]["number"] == 3074
+    assert out["bounties"][0]["labels"] == ["bounty", "agent-welcome"]
+    assert capture["url"].endswith("/repos/Scottcjn/rustchain-bounties/issues")
+    assert capture["params"]["labels"] == "bounty"
+    assert capture["params"]["state"] == "open"
+
+
+def test_bounties_tool_surfaces_api_error_object(monkeypatch):
+    _patch_httpx(monkeypatch, _FakeResp({"message": "rate limited"}))
+
+    out = json.loads(RustChainBountiesTool()._run())
+
+    assert out["ok"] is False
+    assert "rate limited" in out["error"]
+
+
+def test_bounties_tool_sends_token_header(monkeypatch):
+    capture = {}
+    _patch_httpx(monkeypatch, _FakeResp([]), capture)
+    monkeypatch.setenv("GH_TOKEN", "ghp_example")
+
+    RustChainBountiesTool()._run()
+
+    assert capture["headers"].get("Authorization") == "Bearer ghp_example"
+
+
+def test_health_tool_passes_through(monkeypatch):
+    capture = {}
+    payload = {"ok": True, "db_rw": True, "tip_age_slots": 0, "version": "2.2.1-rip200"}
+    _patch_httpx(monkeypatch, _FakeResp(payload), capture)
+
+    out = json.loads(RustChainNodeHealthTool()._run())
+
+    assert out == payload
+    assert capture["url"].endswith("/health")
+
+
+def test_epoch_tool_passes_through(monkeypatch):
+    capture = {}
+    payload = {"epoch": 288, "slot": 41586, "enrolled_miners": 17}
+    _patch_httpx(monkeypatch, _FakeResp(payload), capture)
+
+    out = json.loads(RustChainCurrentEpochTool()._run())
+
+    assert out == payload
+    assert capture["url"].endswith("/epoch")
+
+
+def test_non_json_response_is_reported(monkeypatch):
+    _patch_httpx(monkeypatch, _FakeResp(status=200, bad_json=True))
+
+    out = json.loads(RustChainNodeHealthTool()._run())
+
+    assert out["ok"] is False
+    assert out["error"] == "non_json_response"
+
+
+def test_get_tools_returns_expected_four():
+    names = {t.name for t in get_tools()}
+    assert names == {
+        "rustchain_check_balance",
+        "rustchain_list_bounties",
+        "rustchain_get_node_health",
+        "rustchain_get_current_epoch",
+    }
+
+
+def test_get_tools_custom_endpoints():
+    t = get_tools(node_url="https://example.test", bounties_repo="me/repo")
+    assert t[0].node_url == "https://example.test"
+    assert t[1].bounties_repo == "me/repo"
+
+
+def test_all_tools_collection_is_instantiated():
+    assert len(ALL_RUSTCHAIN_TOOLS) == 4
+    assert all(isinstance(t, tools.BaseTool) for t in ALL_RUSTCHAIN_TOOLS)
+
+
+def test_langchain_tool_invoke(monkeypatch):
+    _patch_httpx(monkeypatch, _FakeResp({"miner_id": "z", "amount_rtc": 1.0, "amount_i64": 1_000_000_000}))
+
+    result = RustChainBalanceTool().invoke({"wallet_id": "z"})
+
+    assert json.loads(result)["balance_rtc"] == 1.0