crypto-icon-lite

Crypto Icon Lite

Thư viện nhẹ cung cấp biểu tượng cho các loại tiền điện tử và ví crypto.

Cài đặt

npm install crypto-icon-lite

Cách sử dụng

Sử dụng biểu tượng

import { PNG_BTC, SVG_ETH, TokenSymbol } from 'crypto-icon-lite';

// Sử dụng trong React
function MyComponent() {
    return (
        <div>
            <img src={PNG_BTC.darkmode} alt="Bitcoin" />
            <img src={SVG_ETH.lightmode} alt="Ethereum" />
        </div>
    );
}

Sử dụng các hằng số

import { TokenSymbol, WalletName } from 'crypto-icon-lite';

console.log(TokenSymbol.BTC); // 'BTC'
console.log(WalletName.metaMask); // 'MetaMask'

Mở rộng TokenSymbol và WalletName

Package này hỗ trợ mở rộng TokenSymbol và WalletName để thêm các tokens và wallets mới theo nhu cầu dự án của bạn.

Mở rộng TokenSymbol

Cách 1: Sử dụng hàm register

import { TokenSymbol } from 'crypto-icon-lite';

// Đăng ký token mới
TokenSymbol.register('MY_TOKEN', 'MY_TOKEN');
TokenSymbol.register('PROJECT_TOKEN', 'PROJECT_TOKEN');

// Sử dụng
console.log(TokenSymbol.MY_TOKEN); // 'MY_TOKEN'

Cách 2: Với TypeScript (có type hinting)

Tạo một file (ví dụ: customTokens.ts):

import { TokenSymbol } from 'crypto-icon-lite';

// Đăng ký token mới
TokenSymbol.register('MY_TOKEN', 'MY_TOKEN');
TokenSymbol.register('PROJECT_TOKEN', 'PROJECT_TOKEN');

// Khai báo type cho TypeScript (để có gợi ý khi code)
declare module 'crypto-icon-lite' {
    namespace TokenSymbol {
        const MY_TOKEN: 'MY_TOKEN';
        const PROJECT_TOKEN: 'PROJECT_TOKEN';
    }
}

Sau đó import file này ở đầu ứng dụng của bạn (ví dụ trong main.ts hoặc index.ts):

import './customTokens';

Mở rộng WalletName

Cách 1: Sử dụng hàm register

import { WalletName } from 'crypto-icon-lite';

// Đăng ký wallet mới
WalletName.register('phantom', 'Phantom');
WalletName.register('coinbase', 'Coinbase Wallet');

// Sử dụng
console.log(WalletName.phantom); // 'Phantom'

Cách 2: Với TypeScript (có type hinting)

Tạo một file (ví dụ: customWallets.ts):

import { WalletName } from 'crypto-icon-lite';

// Đăng ký wallet mới
WalletName.register('phantom', 'Phantom');
WalletName.register('coinbase', 'Coinbase Wallet');

// Khai báo type cho TypeScript (để có gợi ý khi code)
declare module 'crypto-icon-lite' {
    namespace WalletName {
        const phantom: 'Phantom';
        const coinbase: 'Coinbase Wallet';
    }
}

Sau đó import file này ở đầu ứng dụng của bạn:

import './customWallets';

Kiểm tra giá trị hợp lệ

Bạn có thể kiểm tra một chuỗi có phải là token hoặc wallet hợp lệ không:

import { TokenSymbol, WalletName } from 'crypto-icon-lite';

// Kiểm tra tokens
TokenSymbol.isValid('BTC'); // true
TokenSymbol.isValid('INVALID_TOKEN'); // false

// Kiểm tra wallets
WalletName.isValid('MetaMask'); // true
WalletName.isValid('Unknown Wallet'); // false

Lưu ý

• Khi mở rộng, tốt nhất nên tập trung việc đăng ký vào một file riêng và import nó sớm trong ứng dụng
• Đối với TypeScript, khai báo module là tùy chọn nhưng giúp bạn có được gợi ý khi code
• Các giá trị đăng ký thủ công vẫn hoạt động với các hàm isValid() và có thể được sử dụng giống như các giá trị có sẵn