Token Sentinel

Token Sentinel is a multi-chain ERC20 token security scanner built to help traders, researchers, and Web3 users evaluate a token contract before buying or interacting with it. The app combines on-chain RPC reads, GoPlus security intelligence, and DexScreener market data to produce a clear 0-100 risk score with explainable findings.

What it checks

• Honeypot risk signals
• Buy tax and sell tax
• Blacklist and cannot-sell-all behavior
• Liquidity depth and active DEX pairs
• 24-hour volume, market cap, and FDV
• Contract owner and renounce status
• Verified/open-source contract signal
• Mintable supply and hidden owner risks
• Proxy/upgradeable contract behavior
• Transfer pausable and trading cooldown flags
• Holder count, LP holder count, and top-holder concentration
• Optional wallet dusting risk check

Key features

• Multi-chain support: Ethereum, BNB Chain, Base, Polygon, Arbitrum, Optimism, Avalanche, and Fantom
• Read-only scanner: no wallet signature, no private key, no seed phrase
• Score-based verdict: Relatively Safe, Caution, Risky, or High Risk / Scam
• Critical findings, warnings, and positive signals shown separately
• Liquidity and market section powered by DexScreener
• Security risk section powered by GoPlus Token Security API
• On-chain token metadata and owner checks through public RPC endpoints
• Optional wallet address input to identify possible dusting-risk tokens
• Theme picker: Midnight, Light, Emerald, and Violet
• Language picker: English, Indonesian, and Chinese
• Copyable scan report

Tech stack

• React
• Vite
• Express.js
• Recharts
• Lucide React icons
• GoPlus Token Security API
• DexScreener API
• Public EVM RPC endpoints

Project structure

.
├── server.js          # Express backend and scanner API
├── src/main.jsx       # React application
├── src/styles.css     # Theme and responsive UI styling
├── index.html         # Vite entry HTML
├── vite.config.js     # Vite config and dev API proxy
├── package.json       # Scripts and dependencies
└── README.md

Run locally

npm install
npm run dev

Open:

• Frontend: http://localhost:5173
• API: http://localhost:8787

Production build

npm run build
npm start

Then open:

http://localhost:8787

API usage

Example:

curl "http://localhost:8787/api/scan?chainId=1&token=0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2"

Optional wallet dusting check:

curl "http://localhost:8787/api/scan?chainId=1&token=<TOKEN_ADDRESS>&wallet=<WALLET_ADDRESS>"

Supported chains

• Ethereum: 1
• BNB Chain: 56
• Base: 8453
• Polygon: 137
• Arbitrum: 42161
• Optimism: 10
• Avalanche: 43114
• Fantom: 250

Safety note

Token Sentinel is read-only. It never asks for private keys, seed phrases, wallet approvals, or signatures. The scanner is designed for research and risk awareness only.

Disclaimer

This tool is not financial advice. A high score does not guarantee that a token is safe, and a low score does not prove malicious intent. Always verify multiple sources before making any trading or investment decision.