鸿蒙app 数字钱包（余额查询/转账/收款）【玩转华为云】

引言

技术背景

• 鸿蒙框架：基于Stage模型，@Entry/@Component构建UI，Ability管理生命周期，BackgroundTaskManager支持后台交易同步。
• 安全机制：依托鸿蒙TEE存储私钥，敏感操作需生物识别（指纹/人脸）认证，@ohos.security提供加密接口。
• 数据通信：本地交易记录用关系型数据库存储，联网请求通过@ohos.net.http与区块链节点或支付网关交互。
• UI交互：支持扫码收款（相机权限）、二维码生成（@ohos.qrcode），转账金额实时校验。

应用使用场景

1. 日常消费：用户扫码商家收款码完成支付，或向好友转账。
2. 资产查询：实时查看各币种余额、交易历史，支持按时间筛选。
3. 跨设备收款：手机生成收款码，平板/智慧屏同步显示，方便大额展示。

核心特性

• 安全可信：私钥TEE存储，交易签名本地完成，防止数据泄露。
• 跨端协同：收款码多设备同步，转账记录分布式共享。
• 实时反馈：转账状态（ pending/成功/失败）即时推送，余额变动实时更新。
• 离线收款：生成静态收款码，无网络时可扫码记录，联网后同步。

原理流程图与原理解释

流程图

graph TD  
    A[用户操作：查询/转账/收款] --> B{是否敏感操作?}  
    B -->|是| C[生物识别认证]  
    B -->|否| D[执行操作]  
    C -->|认证通过| D  
    C -->|认证失败| E[拒绝操作]  
    D --> F[查询：调用接口获取余额/历史]  
    D --> G[转账：构造交易→签名→广播]  
    D --> H[收款：生成/解析二维码]  
    F/G/H --> I[更新UI与数据库]  
    G --> J[监听交易回执，更新状态]

原理解释

1. 余额查询：通过HTTP请求从区块链节点或支付网关拉取地址资产数据，本地数据库缓存最近记录。
2. 转账流程：
   • 构造未签名交易（含接收地址、金额、nonce）；
   • 从TEE读取私钥签名；
   • 广播签名交易至网络，轮询确认结果。
3. 收款流程：
   • 生成含自身地址的二维码（静态/动态）；
   • 扫码后解析地址，发起转账（对方操作）；
   • 被动接收交易通知，更新余额。

环境准备

• 开发工具：DevEco Studio 4.0+
• SDK版本：API 9+（支持TEE、生物识别、二维码）
• 权限配置：module.json5声明权限：

  "requestPermissions": [  
    { "name": "ohos.permission.USE_BIOMETRIC" },  
    { "name": "ohos.permission.CAMERA" },  
    { "name": "ohos.permission.INTERNET" }  
  ]

代码实现（完整示例）

1. 数据模型（Model/WalletModel.ts）

// 余额信息  
export class Balance {  
  currency: string; // 币种（如"BTC"、"ETH"）  
  amount: number; // 余额  
  usdValue: number; // 美元价值  

  constructor(currency: string, amount: number, usdValue: number) {  
    this.currency = currency;  
    this.amount = amount;  
    this.usdValue = usdValue;  
  }  
}  

// 交易记录  
export class Transaction {  
  id: string; // 交易哈希  
  type: 'send' | 'receive'; // 类型  
  from: string; // 发送方地址  
  to: string; // 接收方地址  
  amount: number; // 金额  
  currency: string; // 币种  
  status: 'pending' | 'success' | 'failed'; // 状态  
  timestamp: number; // 时间戳  

  constructor(id: string, type: 'send' | 'receive', from: string, to: string, amount: number, currency: string, status: 'pending' | 'success' | 'failed') {  
    this.id = id;  
    this.type = type;  
    this.from = from;  
    this.to = to;  
    this.amount = amount;  
    this.currency = currency;  
    this.status = status;  
    this.timestamp = new Date().getTime();  
  }  
}

2. 安全服务（Service/SecurityService.ts）

import cryptoFramework from '@ohos.security.cryptoFramework';  
import biometricAuthentication from '@ohos.biometricAuthentication';  

export class SecurityService {  
  // 生物识别认证  
  async authenticate(): Promise<boolean> {  
    try {  
      const authParam = { challenge: new Uint8Array([49, 49, 49, 49]), title: "身份验证", subtitle: "请验证指纹/人脸" };  
      const result = await biometricAuthentication.auth(authParam);  
      return result.result === biometricAuthentication.BioAuthResult.SUCCESS;  
    } catch (err) {  
      console.error(`Biometric auth failed: ${err}`);  
      return false;  
    }  
  }  

  // TEE存储私钥（模拟，实际需调用TEE API）  
  async storePrivateKey(key: string): Promise<void> {  
    // 实际应使用@ohos.trust.tee接口写入TEE，此处简化为Preferences存储  
    const pref = await preferences.getPreferences(getContext(), 'wallet_secure');  
    await pref.put('private_key', key);  
    await pref.flush();  
  }  

  // 从TEE读取私钥  
  async getPrivateKey(): Promise<string | null> {  
    const pref = await preferences.getPreferences(getContext(), 'wallet_secure');  
    return await pref.get('private_key', null) as string;  
  }  

  // 签名交易（模拟椭圆曲线签名）  
  async signTransaction(txData: string, privateKey: string): Promise<string> {  
    const md = cryptoFramework.createMd('SHA256');  
    md.update({ data: new TextEncoder().encode(txData) });  
    const hash = await md.digest();  
    // 实际需用私钥对hash签名，此处返回模拟签名  
    return `sig_${hash.data.toString()}_${privateKey.slice(0, 8)}`;  
  }  
}

3. 钱包服务（Service/WalletService.ts）

import { Balance, Transaction } from '../Model/WalletModel';  
import { SecurityService } from './SecurityService';  
import http from '@ohos.net.http';  

export class WalletService {  
  private securityService: SecurityService = new SecurityService();  
  private myAddress: string = "0xMyWalletAddress123"; // 模拟钱包地址  

  // 查询余额  
  async getBalance(): Promise<Balance[]> {  
    // 模拟API请求  
    const httpReq = http.createHttp();  
    const response = await httpReq.request("https://api.wallet.com/balance?address=" + this.myAddress, { method: http.RequestMethod.GET });  
    if (response.responseCode === 200) {  
      const data = JSON.parse(response.result as string);  
      return data.balances.map((b: any) => new Balance(b.currency, b.amount, b.usdValue));  
    }  
    return [new Balance("BTC", 0.5, 30000), new Balance("ETH", 2, 6000)]; // 模拟数据  
  }  

  // 转账  
  async transfer(toAddress: string, amount: number, currency: string): Promise<{ success: boolean; txId?: string }> {  
    const authenticated = await this.securityService.authenticate();  
    if (!authenticated) return { success: false };  

    const txData = JSON.stringify({ from: this.myAddress, to: toAddress, amount, currency, nonce: Date.now() });  
    const privateKey = await this.securityService.getPrivateKey();  
    if (!privateKey) return { success: false };  

    const signature = await this.securityService.signTransaction(txData, privateKey);  
    // 广播交易  
    const httpReq = http.createHttp();  
    const response = await httpReq.request("https://api.wallet.com/transfer", {  
      method: http.RequestMethod.POST,  
      header: { "Content-Type": "application/json" },  
      extraData: JSON.stringify({ txData, signature })  
    });  

    if (response.responseCode === 200) {  
      const txId = JSON.parse(response.result as string).txId;  
      // 保存交易记录  
      const tx = new Transaction(txId, 'send', this.myAddress, toAddress, amount, currency, 'pending');  
      await this.saveTransaction(tx);  
      // 模拟异步更新状态  
      setTimeout(async () => await this.updateTxStatus(txId, 'success'), 3000);  
      return { success: true, txId };  
    }  
    return { success: false };  
  }  

  // 生成收款码（内容为钱包地址）  
  generateReceiveQR(): string {  
    // 实际应使用@ohos.qrcode生成二维码图片路径  
    return `qrcode_${this.myAddress}`; // 模拟返回值  
  }  

  // 解析收款码  
  parseReceiveQR(qrData: string): string {  
    return qrData.replace("qrcode_", ""); // 模拟解析出地址  
  }  

  // 保存交易记录（模拟数据库存储）  
  private async saveTransaction(tx: Transaction): Promise<void> {  
    const pref = await preferences.getPreferences(getContext(), 'wallet_tx');  
    await pref.put(tx.id, JSON.stringify(tx));  
    await pref.flush();  
  }  

  // 更新交易状态  
  private async updateTxStatus(txId: string, status: 'success' | 'failed'): Promise<void> {  
    const pref = await preferences.getPreferences(getContext(), 'wallet_tx');  
    const txStr = await pref.get(txId, '{}') as string;  
    const tx = JSON.parse(txStr);  
    tx.status = status;  
    await pref.put(txId, JSON.stringify(tx));  
    await pref.flush();  
  }  

  // 获取交易记录  
  async getTransactions(): Promise<Transaction[]> {  
    const pref = await preferences.getPreferences(getContext(), 'wallet_tx');  
    const keys = await pref.getPreferencesKeys();  
    const txs: Transaction[] = [];  
    for (const key of keys) {  
      const txStr = await pref.get(key, '{}') as string;  
      txs.push(JSON.parse(txStr));  
    }  
    return txs.sort((a, b) => b.timestamp - a.timestamp);  
  }  
}

4. UI界面（pages/Index.ets）

import { Balance, Transaction } from '../Model/WalletModel';  
import { WalletService } from '../Service/WalletService';  

@Entry  
@Component  
struct DigitalWalletPage {  
  @State balances: Balance[] = [];  
  @State transactions: Transaction[] = [];  
  @State transferAmount: string = '';  
  @State receiveAddress: string = '';  
  @State qrPath: string = '';  
  @State showTransferDialog: boolean = false;  

  private walletService: WalletService = new WalletService();  

  aboutToAppear() {  
    this.loadData();  
  }  

  async loadData() {  
    this.balances = await this.walletService.getBalance();  
    this.transactions = await this.walletService.getTransactions();  
    this.qrPath = this.walletService.generateReceiveQR();  
  }  

  build() {  
    Column({ space: 20 }) {  
      Text("数字钱包").fontSize(24).fontWeight(FontWeight.Bold).margin(16);  

      // 余额展示  
      Text("余额").fontSize(18).fontWeight(FontWeight.Medium);  
      List() {  
        ForEach(this.balances, (b: Balance) => {  
          ListItem() {  
            Row() {  
              Text(`${b.currency}: ${b.amount}`).fontSize(16);  
              Text(`≈$${b.usdValue}`).fontSize(14).fontColor(Color.Gray);  
            }.width('100%').padding(10)  
          }  
        })  
      }.width('100%').height(120)  

      // 收款码  
      Text("收款").fontSize(18).fontWeight(FontWeight.Medium);  
      Image(this.qrPath).width(150).height(150).alt("收款码");  
      Text(this.walletService.parseReceiveQR(this.qrPath)).fontSize(12).fontColor(Color.Gray);  

      // 转账按钮  
      Button("转账").onClick(() => this.showTransferDialog = true);  

      // 交易记录  
      Text("交易记录").fontSize(18).fontWeight(FontWeight.Medium);  
      List() {  
        ForEach(this.transactions, (tx: Transaction) => {  
          ListItem() {  
            Column() {  
              Text(`${tx.type === 'send' ? '发送到' : '来自'} ${tx.to.slice(0, 8)}...`).fontSize(14);  
              Text(`${tx.amount} ${tx.currency} - ${tx.status}`).fontSize(14).fontColor(tx.status === 'success' ? Color.Green : Color.Orange);  
            }.width('100%').padding(8)  
          }  
        })  
      }.width('100%').flexGrow(1)  

    }  
    .width('100%').height('100%').padding(16)  
    .bindSheet(this.showTransferDialog, this.buildTransferDialog(), { height: 300 })  
  }  

  @Builder buildTransferDialog() {  
    Column({ space: 15 }) {  
      Text("转账").fontSize(20).fontWeight(FontWeight.Bold);  
      TextInput({ placeholder: "接收地址" }).onChange(val => this.receiveAddress = val);  
      TextInput({ placeholder: "金额" }).type(InputType.Number).onChange(val => this.transferAmount = val);  
      Row() {  
        Button("取消").onClick(() => this.showTransferDialog = false);  
        Button("确认").onClick(async () => {  
          const amount = parseFloat(this.transferAmount);  
          if (amount > 0 && this.receiveAddress) {  
            const res = await this.walletService.transfer(this.receiveAddress, amount, "BTC");  
            alert(res.success ? `转账成功，TXID: ${res.txId}` : "转账失败");  
            this.showTransferDialog = false;  
            this.loadData();  
          }  
        });  
      }.justifyContent(FlexAlign.SpaceAround)  
    }.padding(20)  
  }  
}

运行结果与测试步骤

运行结果

• 余额查询：首页显示BTC、ETH等币种余额及美元估值。
• 收款码：展示二维码图片与钱包地址，支持扫码解析。
• 转账：输入地址与金额，生物识别认证后提示成功，交易记录状态更新为success。

测试步骤

1. 配置DevEco Studio，添加权限，导入代码。
2. 运行App，观察余额数据加载（模拟API返回）。
3. 点击“转账”，输入有效地址与金额，触发生物识别（模拟器可跳过），确认后查看交易记录状态变更。

部署场景

• 个人手机：日常支付与资产管理。
• 智慧屏：家庭共享钱包，大屏展示收款码。
• 金融终端：银行/交易所集成，提供鸿蒙客户端。

疑难解答

• 生物识别失败：检查设备是否录入指纹/人脸，权限是否授予。
• 转账无响应：确认网络连接，检查私钥是否正确存储。
• 收款码无法扫码：验证二维码生成逻辑与解析规则是否匹配。

未来展望

• 硬件钱包集成：支持鸿蒙系统连接的硬件钱包（如Ledger）签名。
• DeFi功能：集成去中心化交易、质押挖矿模块。
• 跨链互操作：支持BTC、ETH、鸿蒙链等多链资产统一管理。

技术趋势与挑战

• 趋势：钱包与DApp深度整合，生物识别+TEE成为安全标准。
• 挑战：私钥安全存储与恢复机制，跨链交易速度与手续费优化。

总结