Tools
Swap Guard
By OpenClaw plugin: blocks token buys when true402 finds a honeypot or a rug in progress (Base, Ethereum, BSC, Solana).
Install
openclaw plugins install @true402.dev/openclaw-swap-guardREADME
# @true402.dev/openclaw-swap-guard
**An OpenClaw plugin that checks every token your agent is about to buy, and blocks the trade when the token is a honeypot or a rug in progress.**
It hooks OpenClaw's `before_tool_call`, so it sits in front of *every* trading skill and MCP tool you have installed — Base trade skills, Uniswap, Jupiter, sniper bots, your own scripts. A skill the agent forgets to follow cannot skip it.
```bash
openclaw plugins install @true402.dev/openclaw-swap-guard
```
## What it does
Before a tool call that buys a token, the guard asks [true402](https://true402.dev):
| Chain | Check | Price after the free daily checks |
|---|---|---|
| Base, Ethereum, BSC | `/v1/{chain}/token-report`: an executed buy **and sell** simulation, deployer history, recent liquidity pulls | $0.008 |
| Solana | `/v1/solana/token-safety`: freeze / mint authority, Token-2022 extensions, liquidity | $0.005 |
- **Blocks** only on a definite danger verdict: an EVM token rated *avoid* (cannot be sold, extreme sell tax, liquidity just pulled…), or a Solana mint that can never be sold, can be seized, or is critical risk. The agent sees the reasons and is told not to retry with another tool.
- **Lets the trade through** when the token checks out — and, by default, when it could not be checked at all (true402 unreachable, free checks used up, the address is a wallet rather than a token). A guard that breaks your trading whenever a third party hiccups is a guard you uninstall. Change that with `onUnchecked`.
- Checks only the token being **bought**. The token you are selling is never checked: blocking the exit from a token whose liquidity is being pulled would trap you in it.
- Skips majors and stablecoins (WETH, USDC, USDT, DAI, WBNB, SOL…), reuses a verdict for 10 minutes, and checks up to 5 distinct tokens per call — a call naming more is held for your approval (or blocked with `onUnchecked: block`). A token on a chain true402 does not serve counts as "could not be checked".
It recognises buys in shell commands the way trading skills run them (`--token-out 0x…`, `trade <amount> <from> <to>`, `<script> <CA> --chain base`, `--chain solana <mint>`) and in structured tool parameters (`tokenOut`, `outputMint`, `token`, …). Command parsing fails closed: a token is checked on the default chain and on every chain the command names, and anything ambiguous — a `#`, `$'…'`, unbalanced quotes — means every address is checked, including the one being sold. A plain-English order that names no address (`"buy $20 of PEPE"`), or a token passed through a shell variable, cannot be checked.
## Paying for checks
No setup is needed for a few checks a day: the guard uses true402's free daily allowance.
For more, give it a **separate, low-balance** Base wallet holding a little USDC (gas is sponsored):
```bash
export TRUE402_PAYER_PRIVATE_KEY=0x… # or PAYER_PRIVATE_KEY
```
Each check then pays the exact quoted price over [x402](https://x402.org) — no account, no API key. The key is read from the environment, never from OpenClaw's config file, and is never sent anywhere: it signs a USDC authorization locally. The guard **refuses to sign more than $0.25** for a single check.
## Settings
All optional, under the plugin's config (`true402-swap-guard`):
| Setting | Default | Meaning |
|---|---|---|
| `defaultChain` | `base` | Chain assumed for a `0x` address when the trade names none (`base`, `ethereum`, `bsc`) |
| `onCaution` | `allow` | `ask` = request your approval on a *caution* verdict |
| `onUnchecked` | `allow` | `ask` or `block` when a token could not be checked |
| `allowTokens` | `[]` | Token addresses never checked |
| `timeoutMs` | `15000` | Give up on one check after this long (then it is "unchecked") |
| `maxAmountUsd` | `0.25` | Never sign a single check payment above this |
## What is sent
Only the token address and its chain, to `true402.dev`. Nothing about your wallet, your prompts or the trade itself.
## License
MIT
tools
Comments
Sign in to leave a comment