solana-token-meta
Solana token metadata and rug check, from one RPC call
Which token program a mint uses (SPL Token or Token-2022), decimals, supply, mint and freeze authority, every Token-2022 extension, and the name, symbol and uri from either the Token-2022 metadata extension or Metaplex. One getMultipleAccounts call, works on the free public RPC. Zero dependencies.
Try it
npx github:blixvip/solana-token-meta DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263
DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263
Bonk (Bonk) metadata: metaplex, mutable
program spl-token
decimals 5
supply 87994293315291.88186
mint authority none (renounced)
freeze authority none (renounced)
uri https://arweave.net/QPC6FYdUn-3V8ytFNuoCS85S2tHAuiDblh6u3CIZLsw
metaplex update authority 9AhKqLR67hwapvG8SA2JFXaCshXc9nALJjpKaHZrsbkw, seller fee 0 bps, Fungible
flags metadataMutable
Pass several mints at once, --uri to fetch the off-chain JSON (image, description, socials), --json for the full result.
What it does
- Mint and freeze authority, with
nullmeaning revoked - Token-2022 extensions decoded: transfer fee (the one in force now), permanent delegate, transfer hook, metadata pointer, token metadata, default account state, pausable and more
- Name, symbol and uri from Token-2022 or Metaplex, whichever the mint uses
- Risk flags that only state facts:
mintAuthorityActive,freezeAuthorityActive,metadataMutable,hasTransferFee,hasPermanentDelegate,hasTransferHook - 50 mints per RPC call in batch mode
- Offline decoding of accounts you already fetched
Use it in your code
npm install github:blixvip/solana-token-meta
import { getTokenMetas, riskFlags } from "solana-token-meta";
const metas = await getTokenMetas([
"DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263", // BONK
"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", // USDC
"DxYWLXgKJpQmfhTG7ikK6oX6oDhxMhN5wCs5BJekpump", // a pump.fun coin on Token-2022
]);
for (const m of metas) {
const f = riskFlags(m);
console.log(m.metadata?.symbol, m.program, "mint:", f.mintAuthorityActive ? "ACTIVE" : "revoked", "freeze:", f.freezeAuthorityActive ? "ACTIVE" : "revoked", "metadata mutable:", f.metadataMutable);
}
Bonk spl-token mint: revoked freeze: revoked metadata mutable: true
USDC spl-token mint: ACTIVE freeze: ACTIVE metadata mutable: true
DEED token-2022 mint: revoked freeze: revoked metadata mutable: false
Full documentation and every result field are in the README and API reference. MIT licensed, no dependencies.
Integrations
- A JSON endpoint:
GET /token/<mint>with risk flags,node:http, no framework - A GitHub Actions check: fail a workflow when a token's mint or freeze authority is still live
Guides
How to check if a Solana token's mint authority is revoked
How to read Token-2022 metadata in JavaScript
From the team behind Blix
solana-token-meta is a small, open piece of what runs behind Blix, the AI-powered Solana memecoin terminal with 0% fees: every pump.fun launch live, AI coin ratings, narratives, wallet and X tracking, and one-click trading. If you want the result rather than the plumbing, use Blix. There is also a public API and an MCP server for AI agents.
Contribute
Pull requests are welcome and there are good first issues with step-by-step instructions. Setup is git clone and npm test, fully offline. Ask anything in Discussions or the Discord.