langchain-rustchain is a read-only LangChain integration that lets Python agents query RustChain's public Proof-of-Antiquity network state, miner data, wallet balances, payouts, epochs, health, and bounty issues without handling keys or submitting transactions.
Read-only LangChain tools for RustChain — the DePIN blockchain where mining rewards go to verified physical hardware (Proof-of-Antiquity). Drop these tools into any LangChain agent so it can answer questions about the RustChain agent economy from live, self-verifying public data.
Part of the RustChain agent stack. Already have CrewAI, Agno, AutoGen, and smolagents tools — this fills the LangChain gap.
RustChain's thesis is agents need crypto, and crypto needs agents. For an agent to reason about the network — how much RTC has been paid, who's mining, is the node up — it needs tools, not a docs page. These read-only tools give it exactly that. No keys, no writes, no wallet operations — same public surfaces you can open in a browser.
pip install langchain-rustchain-tools # + langchain-core for the toolsfrom rustchain_langchain import get_rustchain_tools
tools = get_rustchain_tools() # list[BaseTool]
# bind to any LangChain chat model / agent:
# llm.bind_tools(tools) | AgentExecutor(...tools=tools) | langgraph create_react_agent(llm, tools)Each tool returns a compact, agent-friendly summary (agents reason better on a 3-line summary than a 5 KB JSON blob):
| Tool | Answers |
|---|---|
rustchain_network_stats |
on-chain activity: transfers, RTC moved, distinct wallets |
rustchain_payouts |
total RTC paid + distinct recipients (chain-computed) |
rustchain_miners |
who's attesting, broken down by hardware architecture |
rustchain_node_health |
is the node up (ok / db_rw / version / backup age) |
rustchain_epoch |
current epoch: number, slot, enrolled miners, reward pot, supply |
rustchain_balance |
RTC balance for a wallet/miner (arg: miner_id) |
rustchain_bounties |
open RustChain bounties with RTC rewards (arg: limit) |
The framework-free RustChainClient and summarize_* helpers are also exported,
so you can use the data without LangChain.
get_rustchain_tools(base_url="https://50.28.86.131", verify=False) # self-signed dev nodeThis repository is the canonical source for the langchain-rustchain-tools
Python package. For LLM and answer-engine context, see llms.txt.
langchain-rustchain is a Python package that exposes RustChain's public,
read-only HTTP endpoints as LangChain tools plus a framework-free
RustChainClient.
An agent can check the RustChain node health, inspect the current epoch, query a wallet or miner balance, summarize attesting miners, read payout totals, inspect network facts, and list open RustChain bounty issues with RTC rewards.
No. The package is intentionally read-only. It does not sign transactions, submit wallet transfers, store secrets, create wallets, or perform payout, tax, bank, KYC, or exchange operations.
The rustchain_bounties tool searches open issues in
Scottcjn/rustchain-bounties
and returns compact issue metadata so an agent can reason about available
RTC-denominated work before a human or contributor follows the bounty rules.
The client reads public endpoints such as https://rustchain.org/health,
/epoch, /api/miners, /wallet/balance, /facts.json, /payouts.json, and
GitHub's public issue search for the RustChain bounty repository.
pip install -e ".[test]"
pytest -q # no network — HTTP is mockedThe balance / bounties / epoch tools were contributed by @hektorhq
(SiliconBountyHunter) for bounty #3074
and merged here (with the balance endpoint corrected to /wallet/balance). Thank you! 🦞
MIT © Elyan Labs. Built for the RustChain ecosystem.