ZerePy (Solana AI) + x711

Add x711 as a ZerePy connection — Solana price feeds, tx simulation, on-chain intelligence, and Hallucination Pills for safe USDC transactions.

What you get

ZerePy is a popular Solana-native AI agent framework. x711 extends ZerePy agents with real-time Solana prices (SOL, JUP, BONK, WIF, PYTH), multi-chain tx simulation, Hallucination Pills to verify USDC addresses before any transaction, and The Hive collective memory. Pay-per-call in USDC on Base or Solana — or use the free tier.

Step 1 — Config

File: x711_connection.py

# ZerePy x711 connection — drop into your connections/ folder
import requests
from zerepy.connections.base_connection import BaseConnection, Action, ActionParameter

X711_KEY = "x711_your_key"   # free at x711.io/api/onboard
BASE = "https://x711.io/api/refuel"
HDR  = {"Content-Type": "application/json", "X-API-Key": X711_KEY}

def _x711(tool: str, **kw) -> dict:
    return requests.post(BASE, json={"tool": tool, **kw}, headers=HDR, timeout=30).json()

class X711Connection(BaseConnection):
    def __init__(self, config: dict): super().__init__(config)
    def is_llm_provider(self): return False

    def configure(self):
        return True

    def is_configured(self, verbose=False):
        return bool(X711_KEY)

    @property
    def actions(self) -> list[Action]:
        return [
            Action("solana-price", [ActionParameter("token", True, str, "SOL,JUP,BONK,WIF")], self.solana_price),
            Action("web-search",   [ActionParameter("query",  True, str, "search query")],      self.web_search),
            Action("hive-read",    [ActionParameter("query",  True, str, "intel query")],        self.hive_read),
            Action("verify-claim", [ActionParameter("claim",  True, str, "address/price claim")], self.verify_claim),
            Action("tx-simulate",  [ActionParameter("chain",  True, str, "base/solana"),
                                    ActionParameter("to",     True, str, "contract address")],   self.tx_simulate),
        ]

    def solana_price(self, token: str = "SOL") -> str:
        return str(_x711("price_feed", query=token).get("result", ""))

    def web_search(self, query: str) -> str:
        return str(_x711("web_search", query=query).get("result", ""))

    def hive_read(self, query: str) -> str:
        return str(_x711("hive_read", query=query).get("result", ""))

    def verify_claim(self, claim: str, chain: str = "solana") -> str:
        r = requests.post("https://x711.io/api/pill", json={"claim": claim, "chain": chain}, timeout=10).json()
        return f"risk={r.get('hallucination_risk')} | {r.get('correction','verified')}"

    def tx_simulate(self, chain: str, to: str) -> str:
        return str(_x711("tx_simulate", chain=chain, to=to))

Step 2 — Use it

Install: pip install zerepy requests. Copy x711_connection.py to your ZerePy project's connections/ folder. Replace x711_your_key with your free key from x711.io/api/onboard. Always call verify_claim before any USDC transaction — wrong USDC address on Solana vs Base is the #1 agent money-loss cause.

Sanity check (no install)

curl -X POST https://x711.io/api/refuel \
  -H 'Content-Type: application/json' \
  -d '{"tool":"web_search","query":"latest AI agent frameworks"}'

If that returns JSON with web search results, your network can reach x711.

Available tools

All prices in USDC, billed per call. Free tier waives the first 10 calls/day.

Why x711 is legit

• Open spec. agent.json · OpenAPI 3.1 · x402 manifest
• Open treasury. Every payment lands at 0xb753be5Eac5B29c711051DfF91279834e9C9b9AC on Base — verifiable on-chain.
• Open ledger. /api/attestations publishes every refuel as a hash-chained attestation.
• Live signal. /api/stats/live is an SSE stream of real refuels.

Other frameworks

Get an API key (free) Open API reference