refactor(contact): remove chainType, use custom label for addresses

BREAKING CHANGE: ContactAddress no longer has chainType field

- Remove chainType from ContactAddress interface
- Add custom label field (e.g. 'Main', 'Exchange')
- Use detectAddressFormat for chain validation instead of stored type
- Update all components to display label or detected chain type
- Add addressLabel input in ContactEditJob
- Update QR protocol to use label instead of chainType
- Limit contacts to max 3 addresses (QR capacity)

Author: Gaubee

src/components/contact/contact-card.tsx

@@ -6,20 +6,24 @@
 import { QRCodeSVG } from 'qrcode.react';
 import { ContactAvatar } from '@/components/common/contact-avatar';
 import { generateAvatarFromAddress } from '@/lib/avatar-codec';
+import { detectAddressFormat } from '@/lib/address-format';
 import type { ContactAddressInfo } from '@/lib/qr-parser';
 
-const CHAIN_NAMES: Record<string, string> = {
-  ethereum: 'ETH',
-  bitcoin: 'BTC',
-  tron: 'TRX',
-};
-
 const CHAIN_COLORS: Record<string, string> = {
   ethereum: '#627EEA',
   bitcoin: '#F7931A',
   tron: '#FF0013',
 };
 
+/** 获取地址显示标签和颜色 */
+function getAddressDisplay(addr: ContactAddressInfo): { label: string; color: string } {
+  const detected = detectAddressFormat(addr.address);
+  const chainType = detected.chainType;
+  const label = addr.label || chainType?.toUpperCase() || '';
+  const color = chainType ? CHAIN_COLORS[chainType] || '#6B7280' : '#6B7280';
+  return { label, color };
+}
+
 export interface ContactCardProps {
   name: string;
   avatar?: string | undefined;
@@ -38,15 +42,18 @@ export function ContactCard({ name, avatar, address, addresses, qrContent }: Con
         <div className="flex-1">
           <h3 className="text-xl font-bold text-white">{name}</h3>
           <div className="mt-1 flex flex-wrap gap-1.5">
-            {addresses.map((a) => (
-              <span
-                key={a.chainType}
-                className="inline-flex items-center rounded-full px-2 py-0.5 text-xs font-medium text-white/90"
-                style={{ backgroundColor: CHAIN_COLORS[a.chainType] || '#6B7280' }}
-              >
-                {CHAIN_NAMES[a.chainType] || a.chainType.toUpperCase()}
-              </span>
-            ))}
+            {addresses.map((a, i) => {
+              const { label, color } = getAddressDisplay(a);
+              return (
+                <span
+                  key={i}
+                  className="inline-flex items-center rounded-full px-2 py-0.5 text-xs font-medium text-white/90"
+                  style={{ backgroundColor: color }}
+                >
+                  {label}
+                </span>
+              );
+            })}
           </div>
         </div>
       </div>

src/components/transfer/address-input.stories.tsx

@@ -93,21 +93,21 @@ export const WithContactSuggestions: Story = {
       addressBookActions.addContact({
         name: 'Alice',
         addresses: [
-          { id: '1', address: '0x1234567890abcdef1234567890abcdef12345678', chainType: 'ethereum', isDefault: true },
+          { id: '1', address: '0x1234567890abcdef1234567890abcdef12345678', label: 'ETH', isDefault: true },
         ],
         memo: '同事',
       });
       addressBookActions.addContact({
         name: 'Bob',
         addresses: [
-          { id: '2', address: '0xabcdef1234567890abcdef1234567890abcdef12', chainType: 'ethereum', isDefault: true },
-          { id: '3', address: 'c7R6wVdPvHqvRxe5Q9ZvWr7CpPn5Mk5Xz3', chainType: 'bfmeta' },
+          { id: '2', address: '0xabcdef1234567890abcdef1234567890abcdef12', label: 'ETH', isDefault: true },
+          { id: '3', address: 'c7R6wVdPvHqvRxe5Q9ZvWr7CpPn5Mk5Xz3', label: 'BFMETA' },
         ],
       });
       addressBookActions.addContact({
         name: 'Charlie',
         addresses: [
-          { id: '4', address: '0x9876543210fedcba9876543210fedcba98765432', chainType: 'ethereum', isDefault: true },
+          { id: '4', address: '0x9876543210fedcba9876543210fedcba98765432', label: 'ETH', isDefault: true },
         ],
         memo: '朋友',
       });
@@ -147,14 +147,14 @@ export const FilterByChain: Story = {
       addressBookActions.addContact({
         name: 'Alice',
         addresses: [
-          { id: '1', address: '0x1234567890abcdef1234567890abcdef12345678', chainType: 'ethereum', isDefault: true },
-          { id: '2', address: 'b7R6wVdPvHqvRxe5Q9ZvWr7CpPn5Mk5Xz3', chainType: 'bfmeta' },
+          { id: '1', address: '0x1234567890abcdef1234567890abcdef12345678', label: 'ETH', isDefault: true },
+          { id: '2', address: 'b7R6wVdPvHqvRxe5Q9ZvWr7CpPn5Mk5Xz3', label: 'BFMETA' },
         ],
       });
       addressBookActions.addContact({
         name: 'Bob',
         addresses: [
-          { id: '3', address: 'c7ADmvZJJ3n3aDxkvwbXxJX1oGgeiCzL11', chainType: 'ccchain', isDefault: true },
+          { id: '3', address: 'c7ADmvZJJ3n3aDxkvwbXxJX1oGgeiCzL11', label: 'CCCHAIN', isDefault: true },
         ],
       });
       return <Story />;
@@ -166,7 +166,7 @@ export const FilterByChain: Story = {
     return (
       <div className="space-y-6 p-4">
         <p className="text-muted-foreground text-sm">
-          设置 chainType="bfmeta"，只显示 BFMeta 链的地址
+          设置 chainType="bfmeta"，只显示 BFMeta 链有效的地址
         </p>
         <AddressInput
           label="BFMeta 地址"

src/components/transfer/address-input.tsx

@@ -5,8 +5,15 @@ import { useStore } from '@tanstack/react-store';
 import { IconLineScan as ScanLine, IconClipboardCopy as ClipboardPaste, IconUsers } from '@tabler/icons-react';
 import { ContactAvatar } from '@/components/common/contact-avatar';
 import { clipboardService } from '@/services/clipboard';
-import { isValidAddressForChain } from '@/lib/address-format';
-import { addressBookStore, addressBookSelectors, type ChainType, type ContactSuggestion } from '@/stores';
+import { isValidAddressForChain, detectAddressFormat } from '@/lib/address-format';
+import { addressBookStore, addressBookSelectors, type ChainType, type ContactSuggestion, type ContactAddress } from '@/stores';
+
+/** 获取地址显示标签（优先用自定义 label，否则用检测到的链类型） */
+function getAddressDisplayLabel(address: ContactAddress): string {
+  if (address.label) return address.label;
+  const detected = detectAddressFormat(address.address);
+  return detected.chainType?.toUpperCase() || '';
+}
 
 interface AddressInputProps extends Omit<React.InputHTMLAttributes<HTMLInputElement>, 'onChange'> {
   value?: string | undefined;
@@ -58,8 +65,7 @@ const AddressInput = forwardRef<HTMLInputElement, AddressInputProps>(
     // 获取联系人建议 - 显示所有联系人，用地址合法性验证标记可选地址
     const suggestions = useMemo(() => {
       if (!showSuggestions) return [];
-      // 获取所有联系人的建议（不按 chainType 过滤）
-      const allSuggestions = addressBookSelectors.suggestContacts(addressBookState, currentValue || '', undefined, maxSuggestions);
+      const allSuggestions = addressBookSelectors.suggestContacts(addressBookState, currentValue || '', maxSuggestions);
       // 标记每个建议的地址是否对当前链有效
       return allSuggestions.map((s) => ({
         ...s,
@@ -235,9 +241,9 @@ const AddressInput = forwardRef<HTMLInputElement, AddressInputProps>(
                           )}>{suggestion.matchedAddress.address}</p>
                         </div>
                         <span className={cn(
-                          "shrink-0 text-xs uppercase",
+                          "shrink-0 text-xs",
                           isDisabled ? "text-muted-foreground/50" : "text-muted-foreground"
-                        )}>{suggestion.matchedAddress.chainType}</span>
+                        )}>{getAddressDisplayLabel(suggestion.matchedAddress)}</span>
                       </li>
                     );
                   })}

src/i18n/locales/en/common.json

@@ -100,6 +100,8 @@
     "namePlaceholder": "Enter contact name",
     "noContacts": "No contacts",
     "noValidAddress": "No valid address",
+    "addressLabel": "Address Label",
+    "addressLabelPlaceholder": "e.g. Main, Exchange",
     "save": "Save",
     "selectAddress": "Select address",
     "selectContact": "Select Contact",

src/i18n/locales/zh-CN/common.json

@@ -60,6 +60,8 @@
     "cancel": "取消",
     "noContacts": "暂无联系人",
     "noValidAddress": "无可用地址",
+    "addressLabel": "地址标签",
+    "addressLabelPlaceholder": "如：主账户、交易所",
     "viewAll": "查看全部联系人",
     "selectContact": "选择联系人",
     "selectAddress": "选择地址"

src/lib/qr-parser.test.ts

@@ -222,7 +222,8 @@ describe('qr-parser', () => {
         const contact = result as ParsedContact
         expect(contact.name).toBe('张三')
         expect(contact.addresses).toHaveLength(1)
-        expect(contact.addresses[0]?.chainType).toBe('ethereum')
+        // 旧格式的 chainType 会被用作 label
+        expect(contact.addresses[0]?.label).toBe('ethereum')
         expect(contact.addresses[0]?.address).toBe('0x742d35Cc6634C0532925a3b844Bc9e7595f12345')
       })
 
@@ -231,9 +232,9 @@ describe('qr-parser', () => {
           type: 'contact',
           name: '李四',
           addresses: [
-            { chainType: 'ethereum', address: '0x742d35Cc6634C0532925a3b844Bc9e7595f12345' },
-            { chainType: 'bitcoin', address: 'bc1qar0srrr7xfkvy5l643lydnw9re59gtzzwf5mdq' },
-            { chainType: 'tron', address: 'TJCnKsPa7y5okkXvQAidZBzqx3QyQ6sxMW' },
+            { label: 'ETH', address: '0x742d35Cc6634C0532925a3b844Bc9e7595f12345' },
+            { label: 'BTC', address: 'bc1qar0srrr7xfkvy5l643lydnw9re59gtzzwf5mdq' },
+            { label: 'TRX', address: 'TJCnKsPa7y5okkXvQAidZBzqx3QyQ6sxMW' },
           ],
         })
         const result = parseQRContent(content)
@@ -246,7 +247,7 @@ describe('qr-parser', () => {
         const content = JSON.stringify({
           type: 'contact',
           name: '王五',
-          addresses: [{ chainType: 'ethereum', address: '0x742d35Cc6634C0532925a3b844Bc9e7595f12345' }],
+          addresses: [{ label: 'ETH', address: '0x742d35Cc6634C0532925a3b844Bc9e7595f12345' }],
           memo: '好友',
           avatar: '👨‍💼',
         })
@@ -291,7 +292,7 @@ describe('qr-parser', () => {
         const contact = result as ParsedContact
         expect(contact.name).toBe('张三')
         expect(contact.addresses).toHaveLength(1)
-        expect(contact.addresses[0]?.chainType).toBe('ethereum')
+        expect(contact.addresses[0]?.label).toBe('ETH')
       })
 
       it('parses contact:// URI with multiple addresses', () => {
@@ -327,7 +328,7 @@ describe('qr-parser', () => {
       it('generates valid JSON for single address', () => {
         const content = generateContactQRContent({
           name: '张三',
-          addresses: [{ chainType: 'ethereum', address: '0x742d35Cc6634C0532925a3b844Bc9e7595f12345' }],
+          addresses: [{ label: 'ETH', address: '0x742d35Cc6634C0532925a3b844Bc9e7595f12345' }],
         })
         const parsed = JSON.parse(content)
         expect(parsed.type).toBe('contact')
@@ -339,8 +340,8 @@ describe('qr-parser', () => {
         const original = {
           name: '李四',
           addresses: [
-            { chainType: 'ethereum' as const, address: '0x742d35Cc6634C0532925a3b844Bc9e7595f12345' },
-            { chainType: 'bitcoin' as const, address: 'bc1qar0srrr7xfkvy5l643lydnw9re59gtzzwf5mdq' },
+            { label: 'ETH' as const, address: '0x742d35Cc6634C0532925a3b844Bc9e7595f12345' },
+            { label: 'BTC' as const, address: 'bc1qar0srrr7xfkvy5l643lydnw9re59gtzzwf5mdq' },
           ],
           avatar: '👩‍💻',
         }
@@ -358,7 +359,7 @@ describe('qr-parser', () => {
       it('handles special characters in name', () => {
         const content = generateContactQRContent({
           name: '张三 (老板)',
-          addresses: [{ chainType: 'ethereum', address: '0x742d35Cc6634C0532925a3b844Bc9e7595f12345' }],
+          addresses: [{ label: 'ETH', address: '0x742d35Cc6634C0532925a3b844Bc9e7595f12345' }],
         })
         const result = parseQRContent(content)
         expect(result.type).toBe('contact')

src/lib/qr-parser.ts

@@ -40,10 +40,10 @@ export interface ParsedDeepLink {
   raw: string
 }
 
-/** 联系人地址 */
+/** 联系人地址（QR 协议格式） */
 export interface ContactAddressInfo {
-  chainType: 'ethereum' | 'bitcoin' | 'tron'
   address: string
+  /** 地址标签（用于显示） */
   label?: string | undefined
 }
 
@@ -206,9 +206,9 @@ function parseContactURI(content: string): ParsedContact | null {
           type: 'contact',
           name: data.name,
           addresses: data.addresses.map((a: { chainType?: string; chain?: string; address: string; label?: string }) => ({
-            chainType: a.chainType || a.chain,
             address: a.address,
-            label: a.label,
+            // 优先用 label，否则用旧格式的 chainType 作为 label
+            label: a.label || a.chainType || a.chain,
           })),
           memo: data.memo,
           avatar: data.avatar,
@@ -233,20 +233,20 @@ function parseContactURI(content: string): ParsedContact | null {
   const params = new URLSearchParams(query)
   const addresses: ContactAddressInfo[] = []
 
-  // 解析各链地址
+  // 解析各链地址（用链类型作为默认 label）
   const ethAddr = params.get('eth')
   if (ethAddr && ETH_ADDRESS_REGEX.test(ethAddr)) {
-    addresses.push({ chainType: 'ethereum', address: ethAddr, label: params.get('eth_label') ?? undefined })
+    addresses.push({ address: ethAddr, label: params.get('eth_label') || 'ETH' })
   }
 
   const btcAddr = params.get('btc')
   if (btcAddr && BTC_ADDRESS_REGEX.test(btcAddr)) {
-    addresses.push({ chainType: 'bitcoin', address: btcAddr, label: params.get('btc_label') ?? undefined })
+    addresses.push({ address: btcAddr, label: params.get('btc_label') || 'BTC' })
   }
 
   const trxAddr = params.get('trx')
   if (trxAddr && TRON_ADDRESS_REGEX.test(trxAddr)) {
-    addresses.push({ chainType: 'tron', address: trxAddr, label: params.get('trx_label') ?? undefined })
+    addresses.push({ address: trxAddr, label: params.get('trx_label') || 'TRX' })
   }
 
   if (addresses.length === 0) return null
@@ -273,7 +273,6 @@ export function generateContactQRContent(contact: {
     type: 'contact',
     name: contact.name,
     addresses: contact.addresses.map(a => ({
-      chainType: a.chainType,
       address: a.address,
       label: a.label,
     })),

src/pages/address-book/index.stories.tsx

@@ -16,8 +16,8 @@ export default meta
 type Story = StoryObj<typeof AddressBookPage>
 
 // Helper to create addresses
-function createAddresses(address: string, chainType = 'ethereum') {
-  return [{ id: crypto.randomUUID(), address, chainType: chainType as 'ethereum' }]
+function createAddresses(address: string, label = 'ETH') {
+  return [{ id: crypto.randomUUID(), address, label }]
 }
 
 const resetStores = () => {
@@ -99,9 +99,9 @@ export const MultipleAddresses: Story = {
       addressBookActions.addContact({
         name: 'Multi-Chain User',
         addresses: [
-          { id: '1', address: '0x1234567890abcdef1234567890abcdef12345678', chainType: 'ethereum' },
-          { id: '2', address: 'b7ADmvZJJ3n3aDxkvwbXxJX1oGgeiCzL11', chainType: 'bfmeta' },
-          { id: '3', address: 'TJYs1234567890abcdef1234567890abc', chainType: 'tron' },
+          { id: '1', address: '0x1234567890abcdef1234567890abcdef12345678', label: 'ETH' },
+          { id: '2', address: 'b7ADmvZJJ3n3aDxkvwbXxJX1oGgeiCzL11', label: 'BFMETA' },
+          { id: '3', address: 'TJYs1234567890abcdef1234567890abc', label: 'TRX' },
         ],
         memo: '多链用户',
       })

src/pages/address-book/index.test.tsx

@@ -6,8 +6,8 @@ import { addressBookActions, walletStore } from '@/stores'
 const mockPush = vi.fn()
 
 // Helper to create addresses
-function createAddresses(address: string, chainType = 'ethereum') {
-  return [{ id: crypto.randomUUID(), address, chainType: chainType as 'ethereum' }]
+function createAddresses(address: string, label = 'ETH') {
+  return [{ id: crypto.randomUUID(), address, label }]
 }
 
 // Mock dependencies
@@ -148,8 +148,8 @@ describe('AddressBookPage', () => {
     addressBookActions.addContact({
       name: 'Multi',
       addresses: [
-        { id: '1', address: '0x1111', chainType: 'ethereum' },
-        { id: '2', address: 'b7ADmv...', chainType: 'bfmeta' },
+        { id: '1', address: '0x1111', label: 'ETH' },
+        { id: '2', address: 'b7ADmv...', label: 'BFMETA' },
       ],
     })
 

src/pages/address-book/index.tsx

@@ -65,7 +65,6 @@ export function AddressBookPage() {
         name: contact.name,
         addresses: JSON.stringify(
           contact.addresses.map((a) => ({
-            chainType: a.chainType,
             address: a.address,
             label: a.label,
           })),