Native coin logo not displayed in balance section (no contract address)

[kirmizidata-prog]

Environment

• Self-hosted instance
• Chain ID: 1919
• Network currency symbol: TURK
• No contract address (native coin)

Configuration

NEXT_PUBLIC_NETWORK_NAME=Turkchain
NEXT_PUBLIC_NETWORK_ID=1919
NEXT_PUBLIC_NETWORK_CURRENCY_NAME=TC
NEXT_PUBLIC_NETWORK_CURRENCY_SYMBOL=TURK
NEXT_PUBLIC_NETWORK_CURRENCY_DECIMALS=18

NEXT_PUBLIC_NETWORK_LOGO=https://...
NEXT_PUBLIC_NETWORK_ICON=https://...

Problem

The network logo is displayed correctly in the header.

However, on the Address page, the native coin balance shows a fallback letter avatar ("T") instead of the TURK logo.

I also tried adding:

/public/icons/coins/turk.svg

But it still does not consistently replace the fallback icon.

Question

What is the correct way to define a custom logo for a native coin (without contract address) so that it is used everywhere in the UI (including balance components)?

Is there an ENV variable specifically for native currency icon override?

Thanks!

[ekawibisono]

Environment

• Self-hosted instance
• Chain ID: 1919
• Network currency symbol: TURK
• No contract address (native coin)

Configuration

NEXT_PUBLIC_NETWORK_NAME=Turkchain NEXT_PUBLIC_NETWORK_ID=1919 NEXT_PUBLIC_NETWORK_CURRENCY_NAME=TC NEXT_PUBLIC_NETWORK_CURRENCY_SYMBOL=TURK NEXT_PUBLIC_NETWORK_CURRENCY_DECIMALS=18

NEXT_PUBLIC_NETWORK_LOGO=https://... NEXT_PUBLIC_NETWORK_ICON=https://...

Problem

The network logo is displayed correctly in the header.

However, on the Address page, the native coin balance shows a fallback letter avatar ("T") instead of the TURK logo.

I also tried adding:

/public/icons/coins/turk.svg

But it still does not consistently replace the fallback icon.

Question

What is the correct way to define a custom logo for a native coin (without contract address) so that it is used everywhere in the UI (including balance components)?

Is there an ENV variable specifically for native currency icon override?

Thanks!

Hello, you can use CURL THIS

curl https://example.com/api/v2/import/token-info?api_key=<API_SENSITIVE_ENDPOINTS_KEY> -H "Content-Type: application/json" -d '{"iconUrl":"","tokenAddress":"","tokenSymbol":"","tokenName":""}'

[kirmizidata-prog]

Hello,

Thank you for your suggestion.

We tested the /api/v2/import/token-info endpoint with API_SENSITIVE_ENDPOINTS_KEY properly configured on our self-hosted instance (Blockscout v9.3.2). However:

The endpoint is not available in our build (returns Not found).

Even when adding the native token manually in the tokens table with:

contract_address_hash = 0x0000000000000000000000000000000000000000

icon_url properly set

The icon appears correctly in the Tokens list, but NOT in the native balance section on the Address page.

After deeper inspection, we found that:

The native coin balance component does NOT use the tokens table.

It does NOT use icon_url from DB.

It renders an identicon (based on NEXT_PUBLIC_VIEWS_ADDRESS_IDENTICON_TYPE) instead.

There is currently no ENV variable to override the native currency icon in the balance component.

So even though:

NEXT_PUBLIC_NETWORK_ICON is set correctly,

The zero-address token exists in DB with icon,

API key is configured,

The native balance still shows the fallback letter avatar.

It seems that native currency icon override is not supported in the current frontend implementation and would require a frontend patch (e.g., adding a special case for native coin in the balance component).

Could you confirm whether:

This behavior is expected?

Or if there is an officially supported way to override the native currency icon in the balance widget?

Thank you.

[sueun-dev]

I checked the code paths for this.

NEXT_PUBLIC_NETWORK_ICON is network branding. I do not see a separate env just for the native balance icon.

The admin endpoint /api/v2/import/token-info updates Token.icon_url, and that path expects a token address. So it is not a general native coin override.

That means the T fallback is likely the current native asset path when there is no token metadata record behind it.

So the practical options look like this:

• create or map a native token record and set its icon_url
• or patch the UI so native balances fall back to NETWORK_ICON

I would not expect /public/icons/coins/turk.svg by itself to fix all balance views.

[ekawibisono]

Hello, Maybe you can use CURL THIS

curl https://example.com/api/v2/import/token-info?api_key=<API_SENSITIVE_ENDPOINTS_KEY> -H "Content-Type: application/json" -d '{"iconUrl":"","tokenAddress":"","tokenSymbol":"","tokenName":""}'