selimekim94/solana-honeypot-checker

This project is a set of Python scripts for checking whether a token on the Solana blockchain is a honeypot, meaning a token designed so people can buy it but cannot sell it back, or can only sell it at a heavy loss. It is aimed at people looking into a specific Solana token before buying it, to see if it behaves fairly on a buy and sell round trip. There are two main scripts. The first simulates buying and then selling a token using real mainnet data and the Jupiter exchange, checking things like mint and freeze permissions, how the trade routes through liquidity pools, who holds the token, and what tax or loss shows up on the buy and sell. The second script looks at the token's top holders and, if the user sets up a local test network called Surfpool, simulates smaller capped sells from each of those holders to see whether they are able to sell at all, which can reveal red flags without risking real money. To use it, someone would clone the repository, set up a Python virtual environment, install the listed dependencies, and copy an example configuration file to fill in their own API keys, particularly from Helius, a Solana data provider, and optionally Jupiter. Running the honeypot script does not require Surfpool, but the holder analysis script benefits from it for local, risk-free sell simulations. The README documents which error codes and results tend to mean a real problem versus a false alarm, and it explicitly warns not to commit the configuration file since it can hold a wallet's private key, and to rotate any API keys that end up exposed in logs. The project is released under the MIT license, which allows free use, modification, and redistribution as long as the copyright notice is kept.