cryptorugmunch
merge: chore/cleanup-remove-bloat-and-secrets into main
bde2f3a
|
Raw History Blame Contribute Delete
2.18 kB

x402 AI Framework Integrations

Pay-per-call AI tools for every major framework. No crypto knowledge required. One pip install, zero config.

Installation

pip install x402-frameworks

Usage

LangChain

from x402_frameworks import x402LangChain

x402 = x402LangChain(api_key="your-key", auto_pay=True)

@x402.wrap_tool("token_scan")
@tool
def scan_token(address: str) -> dict:
    """Scan a token for rug pull indicators."""
    return client.scan(address)

from langchain.agents import create_react_agent
agent = create_react_agent(llm, [scan_token], prompt)
# Payment handled automatically on every tool call

CrewAI

from x402_frameworks import x402CrewAI

x402 = x402CrewAI(api_key="your-key", max_budget_usd=50)

researcher = Agent(
    role="Token Researcher",
    tools=[x402.wrap("token_scan", scan_func)],
)
# Shared credit pool across all agents in the crew

AutoGen

from x402_frameworks import x402AutoGen

x402 = x402AutoGen(api_key="your-key")

analyst = AssistantAgent(
    name="TokenAnalyst",
    functions=[x402.as_function("token_scan")],
)
# AutoGen-compatible function specs with transparent payment

How It Works

  1. Developer wraps a tool function with @x402.wrap_tool("tool_name")
  2. When the AI agent calls the tool, x402 checks:
    • Free trial available? → use it
    • Prepaid credits? → deduct
    • Auto-pay enabled? → pay from wallet
    • None? → raise PaymentRequiredError with invoice details
  3. Tool executes, result returned to agent

Supported Frameworks

Framework Adapter Status
LangChain x402LangChain ✅
CrewAI x402CrewAI ✅
AutoGen x402AutoGen ✅
Haystack Coming soon ⏳
Semantic Kernel Coming soon ⏳

Configuration

Env Var Default Description
X402_API_KEY "" API key for authenticated access
X402_BASE_URL https://mcp.rugmunch.io/mcp/x402 x402 MCP endpoint
X402_AUTO_PAY false Auto-pay invoices from wallet
X402_MAX_BUDGET 0 Monthly budget cap (0 = unlimited)