crewai-true402 0.1.0

true402 tools for CrewAI — pay-per-call on-chain rug/honeypot & address safety for Base AI agents over x402 (USDC, no account, no API key).

crewai-true402

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:

Tool	What	Price
true402_token_report	Composite avoid/caution/ok verdict — honeypot buy/sell simulation + liquidity + ownership + recent rug activity. Call before buying.	~$0.01
true402_token_safety	Structural safety score 0–100 + flags (honeypot sim, liquidity, mint/ownership).	~$0.005
true402_address_safety	Profile + risk for any address before you send/approve/call it (EOA vs contract, balances, proxy detection).	~$0.005
true402_deployer_check	Deployer wallet reputation — age, contracts shipped, fresh-throwaway flag — to catch serial ruggers.	~$0.008

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

Env var	Default	Meaning
PAYER_PRIVATE_KEY	—	Base wallet key that signs x402 payments (needs USDC, not ETH). Unset → free trial only.
TRUE402_BASE_URL	https://true402.dev/api	Override to point at a self-hosted instance.
BASE_RPC_URL	https://mainnet.base.org	Base RPC for the balance pre-check.

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