feat: add langchain-rustchain — LangChain tools for RustChain API (answers #3074) [fj4WqyCCw3C5ShR1RfB7MoBPTpkRrBFYP1uT35g3MvT]

[waterWang]

Summary

Adds a standalone langchain-rustchain Python package under integrations/langchain-rustchain/ that exposes RustChain read-only API endpoints as LangChain BaseTool subclasses.

Wallet: fj4WqyCCw3C5ShR1RfB7MoBPTpkRrBFYP1uT35g3MvT

Tools

Tool	Endpoint	Description
rustchain_check_balance	GET /wallet/balance?miner_id=...	Check RTC balance of any wallet
rustchain_list_bounties	GitHub Issues API	List open ecosystem bounties (labelled "bounty")
rustchain_get_node_health	GET /health	Node health: DB, tip age, uptime, version
rustchain_get_current_epoch	GET /epoch	Current epoch, slot, enrolled miners, emission

Structure

integrations/langchain-rustchain/
├── pyproject.toml          # pip-installable package (langchain-rustchain)
├── README.md               # Quick start + docs
├── example.py              # Direct demo script (no LLM needed)
└── langchain_rustchain/
    ├── __init__.py          # Public API exports
    └── tools.py             # 4 BaseTool subclasses + get_tools() factory

Verification

All 4 tools tested against the live public node (https://rustchain.org):

• rustchain_check_balance("test_wallet") → {"balance_rtc": 0.0}
• rustchain_list_bounties(limit=3) → 3 open bounties returned
• rustchain_get_node_health() → {"version": "2.2.1-rip200", "uptime_s": 174000+}
• rustchain_get_current_epoch() → {"epoch": 249, "slot": 35909, "enrolled_miners": 17}

Acceptance Checklist

• pip install . works (pyproject.toml)
• All 4 tools call live endpoints
• No auth required for RustChain node endpoints
• GitHub API uses optional GH_TOKEN/GITHUB_TOKEN env var (higher rate limit, no token = unauthenticated fallback)
• example.py runs without an LLM (direct tool calls)
• MIT licensed

Closes rustchain-bounties#3074

[github-actions]

Welcome to RustChain! Thanks for your first pull request.

Before we review, please make sure:

• Non-doc PRs have a BCOS-L1 or BCOS-L2 label
• Doc-only PRs are exempt from BCOS tier labels when they only touch docs/**, *.md, or common image/PDF files
• New code files include an SPDX license header
• You've tested your changes against the live node

Bounty tiers: Micro (1-10 RTC) | Standard (20-50) | Major (75-100) | Critical (100-150)

A maintainer will review your PR soon. Thanks for contributing!