Ethereum Transfer Feature

Parent: AGENTS.md

OVERVIEW

Batch transfer composables for Ethereum (native + ERC-20). Largest frontend feature (848 lines in useTransfer.ts).

STRUCTURE

./
├── pages/Transfer.vue    # Route target (~116KB)
├── components/
│   ├── TransferTable.vue
│   ├── TransferConfigForm.vue
│   ├── TransferStatusBar.vue
│   └── index.ts          # Barrel exports
├── composables/
│   ├── useTransfer.ts    # Core logic (848 lines)
│   ├── useBalanceQuery.ts
│   ├── useValidation.ts
│   ├── useDataOperations.ts
│   ├── useTip.ts
│   └── index.ts
└── styles/index.ts       # Barrel export

WHERE TO LOOK

CONVENTIONS

• Import alias: Use @/ for imports from src/
• UI library: PrimeVue for core components
• State: Props passed from parent, not Pinia
• Notifications: @arco-design/web-vue Notification component
• Tauri invoke: All backend calls via @tauri-apps/api/core

IMPORTING WALLETS

Transfer supports three import sources:

• Manual input: src/components/WalletImportModal.vue → emits { privateKeys, addresses } and Transfer.vue converts private keys to from-address.
• File import: composables/useDataOperations.ts reads CSV/XLSX and appends rows into data.value.
• System import: src/components/WalletSystemImportModal.vue selects wallets from wallet manager (get_wallets / get_watch_addresses). For transfer, it requests secrets via get_wallet_secrets (password required) and only imports wallets that have private keys.

COMPOSABLES

useTransfer.ts (main):

export function useTransfer(options = {}) {
  // Options: data, form, chainValue, currentChain, currentCoin,
  //          threadCount, enableMultiThread, transferConfig,
  //          transferProgress, validateForm, executeTransfer, ...

  // Returns: transferFnc, stopTransfer, performIntelligentRetry,
  //          iterTransfer, iterTransferFuryMode
}

Key functions:

• transferFnc(inputData) - Main entry, handles async flow
• iterTransfer(accountData) - Single/multi-thread mode
• iterTransferFuryMode(accountData) - High-concurrency batch
• performIntelligentRetry(failedData) - On-chain tx detection

BACKEND COMMANDS

invoke('base_coin_transfer', { index, item, config })
invoke('token_transfer', { index, item, config })
invoke('base_coin_transfer_fast', { ... }) // Fury mode
invoke('token_transfer_fast', { ... })
invoke('check_transaction_status', { chain, txHash })
invoke('check_wallet_recent_transfers', { ... })

MODES

ANTI-PATTERNS

• Never pass stopFlag directly to backend
• Never skip updateTransferProgress() calls
• Never use form properties without default checks