Skip to content

true402/crewai-true402

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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

License

MIT

About

CrewAI tools: pre-trade rug/honeypot & address safety for Base AI agents, pay-per-call over x402 (USDC, no API key)

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages