crypto-icons

Provide crypto icons assets by ledgerId

Disclaimer

Some of the icons provided are trademarks: they are the property of their respective owners.

@ledgerhq/crypto-icons

See @ledgerhq/crypto-icons library README here: lib/README.md

How to upload a new icon

Prerequisites

• Find the ledgerIds of the coin on various networks using CoinRadar
• Prepare a 144x144 PNG file with a background (no transparent background). If in doubt, contact the design team or WXP team
• Use a recognizable name for the PNG file (ticker or coin name)

Compress the images

1. Add the PNG files to the compress/ folder
2. Run pnpm compress from the lib folder
3. Move the compressed files to the assets/ folder

Important: Icon files must be ≤50 KB after compression (41 KB is already large - aim for smaller file sizes when possible). The verification script will check this automatically.

Mapping

Add the ledgerIds in assets/_record.json following this structure:

"{png_file_name}": {
  "ids": [
    "{first_ledger_id}",
    "{second_ledger_id}"
  ]
}

Then run pnpm generate:index to update the mapping in assets/index.json.

Verification

Run the verification script to check that all icons are valid:

node scripts/verify-icons.js

This script validates:

• All icon files exist
• File sizes are within limits (default: 50 KB max for 144×144 PNG icons - note that 50 KB is already large, aim for smaller sizes)
• All ledger IDs are valid against the API

Options:

• --max-size <KB>: Set custom file size limit (default: 50 KB)
• --concurrency <N>: Set API request concurrency (default: 5)

Example:

node scripts/verify-icons.js --max-size 50 --concurrency 10

Note

Storybook relies on the icons already in production, so if you don't see your icon in your storybook branch, that's expected.