crewai-true402

  Stable · production-ready — semver-stable public API (v1.0).

true402 tools for CrewAI — give a Base trading agent a pre-trade rug/honeypot check it pays for per call over x402 (USDC on Base). No accounts, no API keys — the wallet is the identity. The safety checks have a free daily trial, so the tools work out of the box with no wallet configured.

Install

pip install crewai-true402

Use

from crewai import Agent
from crewai_true402 import true402_tools

# Reads PAYER_PRIVATE_KEY from the env (a Base wallet holding a little USDC).
# Omit the key to rely on the free daily trial for the safety stalls.
tools = true402_tools()

trader = Agent(
    role="Base memecoin trader",
    goal="Only buy tokens that pass an on-chain safety check",
    tools=tools,
    backstory="You never ape into a token before rug-checking it.",
)

The agent gets four tools:

Configuration

true402_tools() reads the environment, or pass a PayOpts:

from crewai_true402 import true402_tools, PayOpts

tools = true402_tools(PayOpts(
    payer_private_key="0x…",   # a Base wallet with a little USDC (gas is sponsored; USDC only)
    max_amount_usd=0.10,        # hard per-call ceiling — refuses to sign a 402 demanding more
))

Safety

The client refuses to sign anything that isn't USDC-on-Base within max_amount_usd (default $0.10) — so a rogue or compromised endpoint can't make your agent authorize an unexpected asset, network, or amount. The private key is used only to sign locally; it never leaves the process.

Links

• Live check in your browser: https://true402.dev/check
• API reference: https://true402.dev/docs/api · OpenAPI: https://true402.dev/openapi.json
• Also available: LangChain · MCP server · CLI

License

MIT