langchain-rustchain 0.1.0

LangChain tools for the RustChain Proof-of-Antiquity blockchain

langchain-rustchain

LangChain tools for the RustChain Proof-of-Antiquity blockchain.

RustChain rewards vintage hardware with RTC tokens. This package gives LangChain agents the ability to query the network, find bounties, and earn autonomously.

Installation

pip install langchain-rustchain

Quick Start

from langchain_rustchain import (
    RustChainBalanceTool,
    RustChainBountyTool,
    RustChainHealthTool,
    RustChainEpochTool,
)

# Check network health
health = RustChainHealthTool()
print(health.invoke({}))
# {"version": "2.2.1-rip200", "uptime_s": 240983, "ok": true, ...}

# Search open bounties
bounties = RustChainBountyTool()
print(bounties.invoke({"limit": 5}))
# [{"number": 3074, "title": "LangChain integration", "reward": "25 RTC", ...}]

# Check wallet balance
balance = RustChainBalanceTool()
print(balance.invoke({"wallet_id": "dual-g4-125"}))

# Get current epoch
epoch = RustChainEpochTool()
print(epoch.invoke({}))

Create a Full Agent

from langchain_openai import ChatOpenAI
from langchain_rustchain import create_rustchain_agent

llm = ChatOpenAI(model="gpt-4o-mini")
agent = create_rustchain_agent(llm)

result = agent.invoke({
    "input": "Find me the top 3 open bounties on RustChain"
})
print(result["output"])

Available Tools

Tool	Description
rustchain_health	Check RustChain node health status (version, uptime, db status)
rustchain_balance	Query RTC token balance for any wallet
rustchain_bounties	Search open bounties on GitHub with RTC rewards
rustchain_epoch	Get current epoch info (number, miners, reward pot)

License

MIT

---

Built for the RustChain Bounty Program