Asset Requirements

BuilderKit requires specific asset files for displaying chain and token logos. These assets should follow a standardized file structure and naming convention.

Chain Logos

Chain logos are used by components like ChainIcon, ChainDropdown, and TokenIconWithChain.

File Structure

Chain logos should be placed at:

/chains/logo/{chain_id}.png

Examples

/chains/logo/43114.png  // Avalanche C-Chain
/chains/logo/43113.png  // Fuji Testnet
/chains/logo/173750.png // Echo L1

Requirements

• Format: PNG with transparency
• Dimensions: 32x32px (minimum)
• Background: Transparent
• Shape: Circular or square with rounded corners
• File size: < 100KB

Token Logos

Token logos are used by components like TokenIcon, TokenChip, and TokenRow.

File Structure

Token logos should be placed at:

/tokens/logo/{chain_id}/{address}.png

Examples

/tokens/logo/43114/0x1234567890123456789012345678901234567890.png  // Token on C-Chain
/tokens/logo/43113/0x5678901234567890123456789012345678901234.png  // Token on Fuji

Requirements

• Format: PNG with transparency
• Dimensions: 32x32px (minimum)
• Background: Transparent
• Shape: Circular or square with rounded corners
• File size: < 100KB

Directory Structure

Your public assets directory should look like this:

public/
├── chains/
│   └── logo/
│       ├── 43114.png
│       ├── 43113.png
│       └── 173750.png
└── tokens/
    └── logo/
        ├── 43114/
        │   ├── 0x1234....png
        │   └── 0x5678....png
        └── 43113/
            ├── 0x9012....png
            └── 0xabcd....png