Add fetchFromCertifiedTokenList option to GrillHeadlessProvider

Adds a new optional parameter to control whether token info fetching should fall back to the certified-token-list. This allows users to disable the external API call if they don't want to use the certified token list.

- Add fetchFromCertifiedTokenList option to fetchTokenInfo (defaults to true)
- Add fetchFromCertifiedTokenList prop to GrillHeadlessProvider
- Pass option through GrillContext to useTokenInfo hook
- Maintains backwards compatibility with default value of true

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <[email protected]>

Author: macalinao

packages/gill-extra/src/fetch-token-info.ts

@@ -8,6 +8,11 @@ import { tokenMetadataSchema } from "@macalinao/zod-solana";
 export interface FetchTokenInfoParams {
   mint: AccountInfo<Pick<Mint, "decimals">>;
   metadata: Metadata | null;
+  /**
+   * Whether to fetch from the certified token list as a fallback.
+   * Defaults to true for backwards compatibility.
+   */
+  fetchFromCertifiedTokenList?: boolean;
 }
 
 /**
@@ -18,6 +23,7 @@ export interface FetchTokenInfoParams {
 export async function fetchTokenInfo({
   mint,
   metadata,
+  fetchFromCertifiedTokenList = true,
 }: FetchTokenInfoParams): Promise<TokenInfo | null> {
   const uri = metadata?.data.uri;
   const decimals = mint.data.decimals;
@@ -74,8 +80,8 @@ export async function fetchTokenInfo({
     metadataUriJson,
   });
 
-  // Fallback: Try to fetch from certified token list if no icon URL
-  if (!tokenInfo.iconURL) {
+  // Fallback: Try to fetch from certified token list if no icon URL and enabled
+  if (fetchFromCertifiedTokenList && !tokenInfo.iconURL) {
     const certifiedTokenInfoUrl = `https://raw.githubusercontent.com/CLBExchange/certified-token-list/refs/heads/master/101/${mint.address}.json`;
     try {
       const response = await fetch(certifiedTokenInfoUrl);

packages/grill/src/contexts/grill-context.ts

@@ -36,6 +36,12 @@ export interface GrillContextValue {
    * This overrides whatever is on-chain, and useTokenInfo will load it instantly.
    */
   staticTokenInfo: ReadonlyMap<Address, TokenInfo>;
+
+  /**
+   * Whether to fetch from the certified token list as a fallback.
+   * Defaults to true for backwards compatibility.
+   */
+  fetchFromCertifiedTokenList: boolean;
 }
 
 /**

packages/grill/src/hooks/use-token-info.ts

@@ -23,7 +23,7 @@ export interface UseTokenInfoInput {
 export function useTokenInfo({
   mint,
 }: UseTokenInfoInput): UseQueryResult<TokenInfo | null> {
-  const { staticTokenInfo } = useGrillContext();
+  const { staticTokenInfo, fetchFromCertifiedTokenList } = useGrillContext();
   const { data: metadataAccount } = useTokenMetadataAccount({ mint });
   const { data: mintAccount } = useMintAccount({ address: mint });
 
@@ -51,6 +51,7 @@ export function useTokenInfo({
       return fetchTokenInfo({
         mint: mintAccount,
         metadata: metadataAccount?.data ?? null,
+        fetchFromCertifiedTokenList,
       });
     },
     enabled:

packages/grill/src/providers/grill-headless-provider.tsx

@@ -27,6 +27,11 @@ export interface GrillHeadlessProviderProps {
    * useTokenInfo will load these instantly without fetching from chain.
    */
   staticTokenInfo?: TokenInfo[];
+  /**
+   * Whether to fetch from the certified token list as a fallback when token metadata is missing.
+   * Defaults to true for backwards compatibility.
+   */
+  fetchFromCertifiedTokenList?: boolean;
 }
 
 /**
@@ -45,6 +50,7 @@ export const GrillHeadlessProvider: FC<GrillHeadlessProviderProps> = ({
   },
   getExplorerLink = defaultGetExplorerLink,
   staticTokenInfo = [],
+  fetchFromCertifiedTokenList = true,
 }) => {
   const { rpc } = useSolanaClient();
   const queryClient = useQueryClient();
@@ -96,6 +102,7 @@ export const GrillHeadlessProvider: FC<GrillHeadlessProviderProps> = ({
         sendTX,
         getExplorerLink,
         staticTokenInfo: staticTokenInfoMap,
+        fetchFromCertifiedTokenList,
       }}
     >
       {children}