How to check a Token-2022 transfer hook before you send
November 15, 2026 · 4 min read · by the Rugsight team
A transfer hook is a Token-2022 extension that points at a program. If a hook program is set, it runs on every transfer of that mint and can refuse the transfer or change how it behaves. The mint account only tells you that a program is configured. It does not tell you whether the program is a compliance allowlist, a bug, or something that blocks sales. This guide shows how to read the extension, how Rugsight reports it, and what a live mint looked like at 22:51 America/Fortaleza on 15 November 2026 (mainnet slot 469953784).
You can also paste the mint into the Rugsight transfer preview. The preview names a hook when a program id is set. It does not execute or audit that program.
The broader Token-2022 controls (permanent delegate, default-frozen accounts, pause) are also covered in how to check Token-2022 permanent delegate and hooks. For sellability more generally, see how to check if you can sell.
Free score in seconds. No sign-up, no wallet. Mint addresses and links from DexScreener, Jupiter, pump.fun, Birdeye, Solscan and GMGN all work.
No mint handy? Open a token our scanner just checked (free, live data):
What a hook is, and what it is not
- A hook is not a transfer fee. A fee changes how many tokens arrive. A hook can decide whether the transfer is allowed at all.
- A hook is not visible in the mint or freeze authority fields. You have to read the Transfer Hook extension.
- Classic SPL Token cannot have a hook.
- An extension can be present without a program id. In that state, transfers are not routed through a hook program until one is set (if a hook authority can still set one).
Rugsight's token score raises TRANSFER_HOOK only when a hook program id is set. The transfer preview follows the same rule for its hook flag, and adds a note when the extension is present with no program.
How to check it
- Start from the full mint address. See how to verify a Solana token contract address.
- Open the mint on an explorer. Confirm the owner is Token-2022 (
TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb). - In Extensions, find Transfer Hook. If it is absent, this mint has no hook extension.
- If it is present, write down the program id (if any) and the hook authority. Open the program id on the explorer. The mint page will not tell you what the program does.
- Call
getAccountInfoon the mint withjsonParsedencoding and look forextensionsentries with"extension": "transferHook". The program isstate.programIdwhen it is set. - Paste the mint into the transfer preview. If a program is set, the preview lists a
TRANSFER_HOOKflag and says the program is not executed or audited here.
Dated example (15 November 2026)
PayPal USD (PYUSD) (2b1kV6DkPAnxd5ixfnxCpjxmKwqjjaYmCZfHsFu24GXo) was read at 22:51 America/Fortaleza on 15 November 2026 (slot 469953784). It is Token-2022. The transferHook extension was present, with a hook authority set and programId unset. On that config, Rugsight does not raise TRANSFER_HOOK, and a 1,000 PYUSD transfer preview shows a 0% transfer fee and a net of 1,000. The preview adds a note that the hook extension is present but no hook program is currently set.
The same read also showed a permanent delegate and active mint and freeze authorities, which are expected issuer controls on this asset and are graded IC on a Rugsight token score. Those are separate from the hook program question.
This is a snapshot of one mint at one slot. A hook authority, if it remains, can set a program later. Recheck the mint if that matters for a transfer you are about to send.
What this check cannot tell you
- Whether a hook program, once set, will allow your transfer. That requires understanding the program, and sometimes simulating a transfer. The preview does not do that.
- Whether a fee will also be withheld. Check the transfer-fee extension separately, or use the same preview for the fee arithmetic.
- Whether an account is already frozen, or whether a pause is in effect.
FAQ
How do I know if a Token-2022 mint will run a hook on my transfer?
Look at the Transfer Hook extension on the mint. Rugsight and the transfer preview report a hook flag only when a program id is set. If the extension is missing, there is no hook. If the extension is present and the program id is empty, transfers are not routed through a hook program at that moment.
Does a hook change how many tokens arrive?
Not by itself. A hook can refuse a transfer or impose extra rules. The number of tokens withheld as a transfer fee comes from the separate transfer-fee extension. See how to calculate a Solana Token-2022 transfer fee.
Can Rugsight tell me the hook is safe?
No. The tool records that a program is configured. It does not run the program or audit it.