langchain-rustchain

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.

Why

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.

Install

pip install langchain-rustchain-tools        # + langchain-core for the tools

Use

from 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):

The framework-free RustChainClient and summarize_* helpers are also exported, so you can use the data without LangChain.

Point it at your own node

get_rustchain_tools(base_url="https://50.28.86.131", verify=False)  # self-signed dev node

Develop / test

pip install -e ".[test]"
pytest -q          # no network — HTTP is mocked

Credits

The 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! 🦞

License

MIT © Elyan Labs. Built for the RustChain ecosystem.