@vinicius16187/crypto-logos 1.0.0

package/README.md

@@ -0,0 +1,189 @@
+# @seu-scope/crypto-logos
+
+Resolve logo URLs for blockchains and ERC-20 tokens using the [TrustWallet Assets](https://github.com/trustwallet/assets) repository via **jsDelivr CDN** with a pinned commit (never `@master`).
+
+## Installation
+
+```bash
+npm install @seu-scope/crypto-logos
+# or
+pnpm add @seu-scope/crypto-logos
+# or
+yarn add @seu-scope/crypto-logos
+```
+
+> **Note:** `ethers` v6 is a required peer dependency for EIP-55 address checksumming.
+
+---
+
+## Supported Chains
+
+| User-facing name | TrustWallet directory |
+|---|---|
+| `ethereum` / `eth` | `ethereum` |
+| `polygon` / `matic` | `polygon` |
+| `bsc` / `bnb` | `smartchain` |
+| `arbitrum` / `arbitrum-one` | `arbitrum` |
+| `avalanche` / `avax` | `avalanchec` |
+| `optimism` / `op` | `optimism` |
+
+---
+
+## Usage
+
+### Native token logo
+
+```ts
+import { getNativeLogoUrl } from "@seu-scope/crypto-logos";
+
+const ethLogo = getNativeLogoUrl({ chain: "ethereum" });
+// https://cdn.jsdelivr.net/gh/trustwallet/assets@{COMMIT}/blockchains/ethereum/info/logo.png
+
+const maticLogo = getNativeLogoUrl({ chain: "matic" }); // alias for polygon
+```
+
+### ERC-20 token logo
+
+```ts
+import { getTokenLogoUrl } from "@seu-scope/crypto-logos";
+
+const usdtLogo = getTokenLogoUrl({
+  chain: "ethereum",
+  address: "0xdac17f958d2ee523a2206206994597c13d831ec7",
+  // Address is automatically converted to EIP-55 checksum
+});
+// https://cdn.jsdelivr.net/gh/trustwallet/assets@{COMMIT}/blockchains/ethereum/assets/0xdAC17F958D2ee523a2206206994597C13D831ec7/logo.png
+```
+
+### resolveLogo — unified resolver
+
+```ts
+import { resolveLogo } from "@seu-scope/crypto-logos";
+
+// Priority: customLogoUrl → token (address) → native
+resolveLogo({ chain: "ethereum" });
+// → native ETH logo
+
+resolveLogo({ chain: "polygon", address: "0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174" });
+// → USDC on Polygon logo (checksummed address)
+
+resolveLogo({
+  chain: "bsc",
+  address: "0x55d398326f99059fF775485246999027B3197955",
+  customLogoUrl: "https://my-cdn.example.com/usdt.png",
+});
+// → "https://my-cdn.example.com/usdt.png"  (customLogoUrl wins)
+```
+
+---
+
+## API Reference
+
+### `getNativeLogoUrl(options: NativeOptions): string`
+
+| Param | Type | Description |
+|---|---|---|
+| `chain` | `string` | Chain name or alias (e.g. `"eth"`, `"matic"`) |
+
+### `getTokenLogoUrl(options: TokenOptions): string`
+
+| Param | Type | Description |
+|---|---|---|
+| `chain` | `string` | Chain name or alias |
+| `address` | `string` | Token contract address (checksum applied automatically) |
+
+### `resolveLogo(input: LogoInput): string`
+
+| Param | Type | Description |
+|---|---|---|
+| `chain` | `string` | Chain name or alias |
+| `address` | `string?` | Token contract address |
+| `customLogoUrl` | `string?` | Override URL — returned as-is if provided |
+
+### `normalizeChain(chain: string): SupportedChain`
+
+Converts any chain alias to its canonical `SupportedChain` value. Throws if the chain is not supported.
+
+### `toChecksum(address: string): string`
+
+Converts an Ethereum address to its EIP-55 checksummed form using `ethers.getAddress`.
+
+---
+
+## React example with fallback
+
+```tsx
+import { resolveLogo } from "@seu-scope/crypto-logos";
+
+interface TokenLogoProps {
+  chain: string;
+  address?: string;
+  customLogoUrl?: string;
+  alt: string;
+  size?: number;
+}
+
+export function TokenLogo({ chain, address, customLogoUrl, alt, size = 32 }: TokenLogoProps) {
+  const src = resolveLogo({ chain, address, customLogoUrl });
+
+  return (
+    <img
+      src={src}
+      alt={alt}
+      width={size}
+      height={size}
+      onError={(e) => {
+        (e.currentTarget as HTMLImageElement).src = "/fallback-token.png";
+      }}
+    />
+  );
+}
+
+// Usage:
+// <TokenLogo chain="ethereum" alt="ETH" />
+// <TokenLogo chain="polygon" address="0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174" alt="USDC" />
+```
+
+---
+
+## Pinned commit
+
+The CDN URL uses a **fixed commit hash** — never `@master` — to guarantee URL stability across deployments.
+
+To update to a newer version of TrustWallet assets:
+
+1. Find the latest commit at: https://github.com/trustwallet/assets/commits/master
+2. Copy the full SHA
+3. Update `TRUSTWALLET_COMMIT` in [src/constants.ts](src/constants.ts)
+4. Rebuild: `npm run build`
+
+```ts
+// src/constants.ts
+export const TRUSTWALLET_COMMIT = "YOUR_NEW_COMMIT_SHA_HERE";
+```
+
+---
+
+## Build
+
+```bash
+npm install
+npm run build
+```
+
+Output in `dist/`:
+- `index.js` — ESM
+- `index.cjs` — CommonJS
+- `index.d.ts` / `index.d.cts` — TypeScript declarations
+
+## Publish
+
+```bash
+npm publish --access public
+```
+
+---
+
+## License
+
+MIT

package/dist/index.d.mts

@@ -0,0 +1,27 @@
+interface NativeOptions {
+    chain: string;
+}
+interface TokenOptions {
+    chain: string;
+    address: string;
+}
+interface LogoInput {
+    chain: string;
+    address?: string;
+    customLogoUrl?: string;
+}
+
+declare function getNativeLogoUrl({ chain }: NativeOptions): string;
+declare function getTokenLogoUrl({ chain, address }: TokenOptions): string;
+declare function resolveLogo({ chain, address, customLogoUrl }: LogoInput): string;
+
+type SupportedChain = "ethereum" | "polygon" | "bsc" | "arbitrum" | "avalanche" | "optimism";
+declare const TRUSTWALLET_DIRS: Record<SupportedChain, string>;
+declare function normalizeChain(chain: string): SupportedChain;
+
+declare function toChecksum(address: string): string;
+
+declare const TRUSTWALLET_COMMIT = "f26c0845ff29059965e316e1e5988e77e5087764";
+declare const BASE_URL = "https://cdn.jsdelivr.net/gh/trustwallet/assets@f26c0845ff29059965e316e1e5988e77e5087764/blockchains";
+
+export { BASE_URL, type LogoInput, type NativeOptions, type SupportedChain, TRUSTWALLET_COMMIT, TRUSTWALLET_DIRS, type TokenOptions, getNativeLogoUrl, getTokenLogoUrl, normalizeChain, resolveLogo, toChecksum };

package/dist/index.d.ts

@@ -0,0 +1,27 @@
+interface NativeOptions {
+    chain: string;
+}
+interface TokenOptions {
+    chain: string;
+    address: string;
+}
+interface LogoInput {
+    chain: string;
+    address?: string;
+    customLogoUrl?: string;
+}
+
+declare function getNativeLogoUrl({ chain }: NativeOptions): string;
+declare function getTokenLogoUrl({ chain, address }: TokenOptions): string;
+declare function resolveLogo({ chain, address, customLogoUrl }: LogoInput): string;
+
+type SupportedChain = "ethereum" | "polygon" | "bsc" | "arbitrum" | "avalanche" | "optimism";
+declare const TRUSTWALLET_DIRS: Record<SupportedChain, string>;
+declare function normalizeChain(chain: string): SupportedChain;
+
+declare function toChecksum(address: string): string;
+
+declare const TRUSTWALLET_COMMIT = "f26c0845ff29059965e316e1e5988e77e5087764";
+declare const BASE_URL = "https://cdn.jsdelivr.net/gh/trustwallet/assets@f26c0845ff29059965e316e1e5988e77e5087764/blockchains";
+
+export { BASE_URL, type LogoInput, type NativeOptions, type SupportedChain, TRUSTWALLET_COMMIT, TRUSTWALLET_DIRS, type TokenOptions, getNativeLogoUrl, getTokenLogoUrl, normalizeChain, resolveLogo, toChecksum };

package/dist/index.js

@@ -0,0 +1,78 @@
+'use strict';
+
+var ethers = require('ethers');
+
+// src/chains.ts
+var CHAIN_ALIASES = {
+  ethereum: "ethereum",
+  eth: "ethereum",
+  polygon: "polygon",
+  matic: "polygon",
+  bsc: "bsc",
+  "binance-smart-chain": "bsc",
+  bnb: "bsc",
+  arbitrum: "arbitrum",
+  "arbitrum-one": "arbitrum",
+  avalanche: "avalanche",
+  avax: "avalanche",
+  optimism: "optimism",
+  op: "optimism"
+};
+var TRUSTWALLET_DIRS = {
+  ethereum: "ethereum",
+  polygon: "polygon",
+  bsc: "smartchain",
+  arbitrum: "arbitrum",
+  avalanche: "avalanchec",
+  optimism: "optimism"
+};
+function normalizeChain(chain) {
+  const key = chain.toLowerCase();
+  const normalized = CHAIN_ALIASES[key];
+  if (!normalized) {
+    throw new Error(
+      `Unsupported chain: "${chain}". Supported values: ${Object.keys(CHAIN_ALIASES).join(", ")}`
+    );
+  }
+  return normalized;
+}
+function toChecksum(address) {
+  return ethers.getAddress(address);
+}
+
+// src/constants.ts
+var TRUSTWALLET_COMMIT = "f26c0845ff29059965e316e1e5988e77e5087764";
+var BASE_URL = `https://cdn.jsdelivr.net/gh/trustwallet/assets@${TRUSTWALLET_COMMIT}/blockchains`;
+
+// src/resolver.ts
+function getNativeLogoUrl({ chain }) {
+  const normalized = normalizeChain(chain);
+  const dir = TRUSTWALLET_DIRS[normalized];
+  return `${BASE_URL}/${dir}/info/logo.png`;
+}
+function getTokenLogoUrl({ chain, address }) {
+  const normalized = normalizeChain(chain);
+  const dir = TRUSTWALLET_DIRS[normalized];
+  const checksumAddress = toChecksum(address);
+  return `${BASE_URL}/${dir}/assets/${checksumAddress}/logo.png`;
+}
+function resolveLogo({ chain, address, customLogoUrl }) {
+  if (customLogoUrl) {
+    return customLogoUrl;
+  }
+  if (address) {
+    return getTokenLogoUrl({ chain, address });
+  }
+  return getNativeLogoUrl({ chain });
+}
+
+exports.BASE_URL = BASE_URL;
+exports.TRUSTWALLET_COMMIT = TRUSTWALLET_COMMIT;
+exports.TRUSTWALLET_DIRS = TRUSTWALLET_DIRS;
+exports.getNativeLogoUrl = getNativeLogoUrl;
+exports.getTokenLogoUrl = getTokenLogoUrl;
+exports.normalizeChain = normalizeChain;
+exports.resolveLogo = resolveLogo;
+exports.toChecksum = toChecksum;
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/chains.ts","../src/checksum.ts","../src/constants.ts","../src/resolver.ts"],"names":["getAddress"],"mappings":";;;;;AAQA,IAAM,aAAA,GAAgD;AAAA,EACpD,QAAA,EAAU,UAAA;AAAA,EACV,GAAA,EAAK,UAAA;AAAA,EACL,OAAA,EAAS,SAAA;AAAA,EACT,KAAA,EAAO,SAAA;AAAA,EACP,GAAA,EAAK,KAAA;AAAA,EACL,qBAAA,EAAuB,KAAA;AAAA,EACvB,GAAA,EAAK,KAAA;AAAA,EACL,QAAA,EAAU,UAAA;AAAA,EACV,cAAA,EAAgB,UAAA;AAAA,EAChB,SAAA,EAAW,WAAA;AAAA,EACX,IAAA,EAAM,WAAA;AAAA,EACN,QAAA,EAAU,UAAA;AAAA,EACV,EAAA,EAAI;AACN,CAAA;AAEO,IAAM,gBAAA,GAAmD;AAAA,EAC9D,QAAA,EAAU,UAAA;AAAA,EACV,OAAA,EAAS,SAAA;AAAA,EACT,GAAA,EAAK,YAAA;AAAA,EACL,QAAA,EAAU,UAAA;AAAA,EACV,SAAA,EAAW,YAAA;AAAA,EACX,QAAA,EAAU;AACZ;AAEO,SAAS,eAAe,KAAA,EAA+B;AAC5D,EAAA,MAAM,GAAA,GAAM,MAAM,WAAA,EAAY;AAC9B,EAAA,MAAM,UAAA,GAAa,cAAc,GAAG,CAAA;AAEpC,EAAA,IAAI,CAAC,UAAA,EAAY;AACf,IAAA,MAAM,IAAI,KAAA;AAAA,MACR,CAAA,oBAAA,EAAuB,KAAK,CAAA,qBAAA,EAAwB,MAAA,CAAO,KAAK,aAAa,CAAA,CAAE,IAAA,CAAK,IAAI,CAAC,CAAA;AAAA,KAC3F;AAAA,EACF;AAEA,EAAA,OAAO,UAAA;AACT;AC1CO,SAAS,WAAW,OAAA,EAAyB;AAClD,EAAA,OAAOA,kBAAW,OAAO,CAAA;AAC3B;;;ACJO,IAAM,kBAAA,GAAqB;AAE3B,IAAM,QAAA,GAAW,kDAAkD,kBAAkB,CAAA,YAAA;;;ACGrF,SAAS,gBAAA,CAAiB,EAAE,KAAA,EAAM,EAA0B;AACjE,EAAA,MAAM,UAAA,GAAa,eAAe,KAAK,CAAA;AACvC,EAAA,MAAM,GAAA,GAAM,iBAAiB,UAAU,CAAA;AACvC,EAAA,OAAO,CAAA,EAAG,QAAQ,CAAA,CAAA,EAAI,GAAG,CAAA,cAAA,CAAA;AAC3B;AAEO,SAAS,eAAA,CAAgB,EAAE,KAAA,EAAO,OAAA,EAAQ,EAAyB;AACxE,EAAA,MAAM,UAAA,GAAa,eAAe,KAAK,CAAA;AACvC,EAAA,MAAM,GAAA,GAAM,iBAAiB,UAAU,CAAA;AACvC,EAAA,MAAM,eAAA,GAAkB,WAAW,OAAO,CAAA;AAC1C,EAAA,OAAO,CAAA,EAAG,QAAQ,CAAA,CAAA,EAAI,GAAG,WAAW,eAAe,CAAA,SAAA,CAAA;AACrD;AAEO,SAAS,WAAA,CAAY,EAAE,KAAA,EAAO,OAAA,EAAS,eAAc,EAAsB;AAChF,EAAA,IAAI,aAAA,EAAe;AACjB,IAAA,OAAO,aAAA;AAAA,EACT;AAEA,EAAA,IAAI,OAAA,EAAS;AACX,IAAA,OAAO,eAAA,CAAgB,EAAE,KAAA,EAAO,OAAA,EAAS,CAAA;AAAA,EAC3C;AAEA,EAAA,OAAO,gBAAA,CAAiB,EAAE,KAAA,EAAO,CAAA;AACnC","file":"index.js","sourcesContent":["export type SupportedChain =\r\n  | \"ethereum\"\r\n  | \"polygon\"\r\n  | \"bsc\"\r\n  | \"arbitrum\"\r\n  | \"avalanche\"\r\n  | \"optimism\";\r\n\r\nconst CHAIN_ALIASES: Record<string, SupportedChain> = {\r\n  ethereum: \"ethereum\",\r\n  eth: \"ethereum\",\r\n  polygon: \"polygon\",\r\n  matic: \"polygon\",\r\n  bsc: \"bsc\",\r\n  \"binance-smart-chain\": \"bsc\",\r\n  bnb: \"bsc\",\r\n  arbitrum: \"arbitrum\",\r\n  \"arbitrum-one\": \"arbitrum\",\r\n  avalanche: \"avalanche\",\r\n  avax: \"avalanche\",\r\n  optimism: \"optimism\",\r\n  op: \"optimism\",\r\n};\r\n\r\nexport const TRUSTWALLET_DIRS: Record<SupportedChain, string> = {\r\n  ethereum: \"ethereum\",\r\n  polygon: \"polygon\",\r\n  bsc: \"smartchain\",\r\n  arbitrum: \"arbitrum\",\r\n  avalanche: \"avalanchec\",\r\n  optimism: \"optimism\",\r\n};\r\n\r\nexport function normalizeChain(chain: string): SupportedChain {\r\n  const key = chain.toLowerCase();\r\n  const normalized = CHAIN_ALIASES[key];\r\n\r\n  if (!normalized) {\r\n    throw new Error(\r\n      `Unsupported chain: \"${chain}\". Supported values: ${Object.keys(CHAIN_ALIASES).join(\", \")}`\r\n    );\r\n  }\r\n\r\n  return normalized;\r\n}\r\n","import { getAddress } from \"ethers\";\r\n\r\nexport function toChecksum(address: string): string {\r\n  return getAddress(address);\r\n}\r\n","export const TRUSTWALLET_COMMIT = \"f26c0845ff29059965e316e1e5988e77e5087764\";\r\n\r\nexport const BASE_URL = `https://cdn.jsdelivr.net/gh/trustwallet/assets@${TRUSTWALLET_COMMIT}/blockchains`;\r\n","import { normalizeChain, TRUSTWALLET_DIRS } from \"./chains\";\r\nimport { toChecksum } from \"./checksum\";\r\nimport { BASE_URL } from \"./constants\";\r\nimport type { LogoInput, NativeOptions, TokenOptions } from \"./types\";\r\n\r\nexport function getNativeLogoUrl({ chain }: NativeOptions): string {\r\n  const normalized = normalizeChain(chain);\r\n  const dir = TRUSTWALLET_DIRS[normalized];\r\n  return `${BASE_URL}/${dir}/info/logo.png`;\r\n}\r\n\r\nexport function getTokenLogoUrl({ chain, address }: TokenOptions): string {\r\n  const normalized = normalizeChain(chain);\r\n  const dir = TRUSTWALLET_DIRS[normalized];\r\n  const checksumAddress = toChecksum(address);\r\n  return `${BASE_URL}/${dir}/assets/${checksumAddress}/logo.png`;\r\n}\r\n\r\nexport function resolveLogo({ chain, address, customLogoUrl }: LogoInput): string {\r\n  if (customLogoUrl) {\r\n    return customLogoUrl;\r\n  }\r\n\r\n  if (address) {\r\n    return getTokenLogoUrl({ chain, address });\r\n  }\r\n\r\n  return getNativeLogoUrl({ chain });\r\n}\r\n"]}

package/dist/index.mjs

@@ -0,0 +1,69 @@
+import { getAddress } from 'ethers';
+
+// src/chains.ts
+var CHAIN_ALIASES = {
+  ethereum: "ethereum",
+  eth: "ethereum",
+  polygon: "polygon",
+  matic: "polygon",
+  bsc: "bsc",
+  "binance-smart-chain": "bsc",
+  bnb: "bsc",
+  arbitrum: "arbitrum",
+  "arbitrum-one": "arbitrum",
+  avalanche: "avalanche",
+  avax: "avalanche",
+  optimism: "optimism",
+  op: "optimism"
+};
+var TRUSTWALLET_DIRS = {
+  ethereum: "ethereum",
+  polygon: "polygon",
+  bsc: "smartchain",
+  arbitrum: "arbitrum",
+  avalanche: "avalanchec",
+  optimism: "optimism"
+};
+function normalizeChain(chain) {
+  const key = chain.toLowerCase();
+  const normalized = CHAIN_ALIASES[key];
+  if (!normalized) {
+    throw new Error(
+      `Unsupported chain: "${chain}". Supported values: ${Object.keys(CHAIN_ALIASES).join(", ")}`
+    );
+  }
+  return normalized;
+}
+function toChecksum(address) {
+  return getAddress(address);
+}
+
+// src/constants.ts
+var TRUSTWALLET_COMMIT = "f26c0845ff29059965e316e1e5988e77e5087764";
+var BASE_URL = `https://cdn.jsdelivr.net/gh/trustwallet/assets@${TRUSTWALLET_COMMIT}/blockchains`;
+
+// src/resolver.ts
+function getNativeLogoUrl({ chain }) {
+  const normalized = normalizeChain(chain);
+  const dir = TRUSTWALLET_DIRS[normalized];
+  return `${BASE_URL}/${dir}/info/logo.png`;
+}
+function getTokenLogoUrl({ chain, address }) {
+  const normalized = normalizeChain(chain);
+  const dir = TRUSTWALLET_DIRS[normalized];
+  const checksumAddress = toChecksum(address);
+  return `${BASE_URL}/${dir}/assets/${checksumAddress}/logo.png`;
+}
+function resolveLogo({ chain, address, customLogoUrl }) {
+  if (customLogoUrl) {
+    return customLogoUrl;
+  }
+  if (address) {
+    return getTokenLogoUrl({ chain, address });
+  }
+  return getNativeLogoUrl({ chain });
+}
+
+export { BASE_URL, TRUSTWALLET_COMMIT, TRUSTWALLET_DIRS, getNativeLogoUrl, getTokenLogoUrl, normalizeChain, resolveLogo, toChecksum };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/chains.ts","../src/checksum.ts","../src/constants.ts","../src/resolver.ts"],"names":[],"mappings":";;;AAQA,IAAM,aAAA,GAAgD;AAAA,EACpD,QAAA,EAAU,UAAA;AAAA,EACV,GAAA,EAAK,UAAA;AAAA,EACL,OAAA,EAAS,SAAA;AAAA,EACT,KAAA,EAAO,SAAA;AAAA,EACP,GAAA,EAAK,KAAA;AAAA,EACL,qBAAA,EAAuB,KAAA;AAAA,EACvB,GAAA,EAAK,KAAA;AAAA,EACL,QAAA,EAAU,UAAA;AAAA,EACV,cAAA,EAAgB,UAAA;AAAA,EAChB,SAAA,EAAW,WAAA;AAAA,EACX,IAAA,EAAM,WAAA;AAAA,EACN,QAAA,EAAU,UAAA;AAAA,EACV,EAAA,EAAI;AACN,CAAA;AAEO,IAAM,gBAAA,GAAmD;AAAA,EAC9D,QAAA,EAAU,UAAA;AAAA,EACV,OAAA,EAAS,SAAA;AAAA,EACT,GAAA,EAAK,YAAA;AAAA,EACL,QAAA,EAAU,UAAA;AAAA,EACV,SAAA,EAAW,YAAA;AAAA,EACX,QAAA,EAAU;AACZ;AAEO,SAAS,eAAe,KAAA,EAA+B;AAC5D,EAAA,MAAM,GAAA,GAAM,MAAM,WAAA,EAAY;AAC9B,EAAA,MAAM,UAAA,GAAa,cAAc,GAAG,CAAA;AAEpC,EAAA,IAAI,CAAC,UAAA,EAAY;AACf,IAAA,MAAM,IAAI,KAAA;AAAA,MACR,CAAA,oBAAA,EAAuB,KAAK,CAAA,qBAAA,EAAwB,MAAA,CAAO,KAAK,aAAa,CAAA,CAAE,IAAA,CAAK,IAAI,CAAC,CAAA;AAAA,KAC3F;AAAA,EACF;AAEA,EAAA,OAAO,UAAA;AACT;AC1CO,SAAS,WAAW,OAAA,EAAyB;AAClD,EAAA,OAAO,WAAW,OAAO,CAAA;AAC3B;;;ACJO,IAAM,kBAAA,GAAqB;AAE3B,IAAM,QAAA,GAAW,kDAAkD,kBAAkB,CAAA,YAAA;;;ACGrF,SAAS,gBAAA,CAAiB,EAAE,KAAA,EAAM,EAA0B;AACjE,EAAA,MAAM,UAAA,GAAa,eAAe,KAAK,CAAA;AACvC,EAAA,MAAM,GAAA,GAAM,iBAAiB,UAAU,CAAA;AACvC,EAAA,OAAO,CAAA,EAAG,QAAQ,CAAA,CAAA,EAAI,GAAG,CAAA,cAAA,CAAA;AAC3B;AAEO,SAAS,eAAA,CAAgB,EAAE,KAAA,EAAO,OAAA,EAAQ,EAAyB;AACxE,EAAA,MAAM,UAAA,GAAa,eAAe,KAAK,CAAA;AACvC,EAAA,MAAM,GAAA,GAAM,iBAAiB,UAAU,CAAA;AACvC,EAAA,MAAM,eAAA,GAAkB,WAAW,OAAO,CAAA;AAC1C,EAAA,OAAO,CAAA,EAAG,QAAQ,CAAA,CAAA,EAAI,GAAG,WAAW,eAAe,CAAA,SAAA,CAAA;AACrD;AAEO,SAAS,WAAA,CAAY,EAAE,KAAA,EAAO,OAAA,EAAS,eAAc,EAAsB;AAChF,EAAA,IAAI,aAAA,EAAe;AACjB,IAAA,OAAO,aAAA;AAAA,EACT;AAEA,EAAA,IAAI,OAAA,EAAS;AACX,IAAA,OAAO,eAAA,CAAgB,EAAE,KAAA,EAAO,OAAA,EAAS,CAAA;AAAA,EAC3C;AAEA,EAAA,OAAO,gBAAA,CAAiB,EAAE,KAAA,EAAO,CAAA;AACnC","file":"index.mjs","sourcesContent":["export type SupportedChain =\r\n  | \"ethereum\"\r\n  | \"polygon\"\r\n  | \"bsc\"\r\n  | \"arbitrum\"\r\n  | \"avalanche\"\r\n  | \"optimism\";\r\n\r\nconst CHAIN_ALIASES: Record<string, SupportedChain> = {\r\n  ethereum: \"ethereum\",\r\n  eth: \"ethereum\",\r\n  polygon: \"polygon\",\r\n  matic: \"polygon\",\r\n  bsc: \"bsc\",\r\n  \"binance-smart-chain\": \"bsc\",\r\n  bnb: \"bsc\",\r\n  arbitrum: \"arbitrum\",\r\n  \"arbitrum-one\": \"arbitrum\",\r\n  avalanche: \"avalanche\",\r\n  avax: \"avalanche\",\r\n  optimism: \"optimism\",\r\n  op: \"optimism\",\r\n};\r\n\r\nexport const TRUSTWALLET_DIRS: Record<SupportedChain, string> = {\r\n  ethereum: \"ethereum\",\r\n  polygon: \"polygon\",\r\n  bsc: \"smartchain\",\r\n  arbitrum: \"arbitrum\",\r\n  avalanche: \"avalanchec\",\r\n  optimism: \"optimism\",\r\n};\r\n\r\nexport function normalizeChain(chain: string): SupportedChain {\r\n  const key = chain.toLowerCase();\r\n  const normalized = CHAIN_ALIASES[key];\r\n\r\n  if (!normalized) {\r\n    throw new Error(\r\n      `Unsupported chain: \"${chain}\". Supported values: ${Object.keys(CHAIN_ALIASES).join(\", \")}`\r\n    );\r\n  }\r\n\r\n  return normalized;\r\n}\r\n","import { getAddress } from \"ethers\";\r\n\r\nexport function toChecksum(address: string): string {\r\n  return getAddress(address);\r\n}\r\n","export const TRUSTWALLET_COMMIT = \"f26c0845ff29059965e316e1e5988e77e5087764\";\r\n\r\nexport const BASE_URL = `https://cdn.jsdelivr.net/gh/trustwallet/assets@${TRUSTWALLET_COMMIT}/blockchains`;\r\n","import { normalizeChain, TRUSTWALLET_DIRS } from \"./chains\";\r\nimport { toChecksum } from \"./checksum\";\r\nimport { BASE_URL } from \"./constants\";\r\nimport type { LogoInput, NativeOptions, TokenOptions } from \"./types\";\r\n\r\nexport function getNativeLogoUrl({ chain }: NativeOptions): string {\r\n  const normalized = normalizeChain(chain);\r\n  const dir = TRUSTWALLET_DIRS[normalized];\r\n  return `${BASE_URL}/${dir}/info/logo.png`;\r\n}\r\n\r\nexport function getTokenLogoUrl({ chain, address }: TokenOptions): string {\r\n  const normalized = normalizeChain(chain);\r\n  const dir = TRUSTWALLET_DIRS[normalized];\r\n  const checksumAddress = toChecksum(address);\r\n  return `${BASE_URL}/${dir}/assets/${checksumAddress}/logo.png`;\r\n}\r\n\r\nexport function resolveLogo({ chain, address, customLogoUrl }: LogoInput): string {\r\n  if (customLogoUrl) {\r\n    return customLogoUrl;\r\n  }\r\n\r\n  if (address) {\r\n    return getTokenLogoUrl({ chain, address });\r\n  }\r\n\r\n  return getNativeLogoUrl({ chain });\r\n}\r\n"]}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@vinicius16187/crypto-logos",
+  "version": "1.0.0",
+  "description": "Resolve TrustWallet asset logo URLs for blockchains and tokens via jsDelivr CDN",
+  "author": "",
+  "license": "MIT",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "crypto",
+    "logos",
+    "trustwallet",
+    "blockchain",
+    "tokens",
+    "web3",
+    "ethereum",
+    "erc20"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "ethers": "^6.13.0"
+  },
+  "devDependencies": {
+    "tsup": "^8.3.0",
+    "typescript": "^5.6.0"
+  }
+}