Flutter for OpenHarmony：web3dart 连接以太坊区块链，构建去中心化应用（DApp 开发与智能合约调用深度实战）深度解析与鸿蒙适配指南

优质文章学习记录

— 7 min read
Flutter for OpenHarmony：web3dart 连接以太坊区块链，构建去中心化应用（DApp 开发与智能合约调用深度实战）深度解析与鸿蒙适配指南

欢迎加入开源鸿蒙跨平台社区：https://openharmonycrossplatform.ZEEKLOG.net

在这里插入图片描述

前言

随着 Web3.0 概念的普及，区块链技术已从早期的极客玩具逐渐走向主流应用。无论是 DeFi（去中心化金融）、NFT（非同质化代币）还是 DAO（去中心化组织），都离不开与区块链网络的交互。

以太坊 (Ethereum) 作为目前最成熟的智能合约平台，其客户端通信协议 JSON-RPC 是行业标准。要在移动端（Flutter/OpenHarmony）与以太坊网络通信，我们不可能手动构造那些复杂的十六进制数据包。

web3dart 是 Dart 生态中唯一的、功能完备的 Web3 客户端库。它可以让你：

  1. 管理账户：生成私钥、助记词，导入 keystore。
  2. 发送交易：转账 ETH，部署合约。
  3. 调用合约：Read（查询状态）和 Write（改变状态）。
  4. 订阅事件：监听链上事件（如 Transfer）。

对于 OpenHarmony 开发者来说，web3dart 的纯 Dart 实现意味着你可以无视底层 OS 差异，直接在鸿蒙设备上开发冷钱包或 DApp。

一、核心原理与密码学基础

1.1 JSON-RPC 与 Infura

以太坊节点通过 JSON-RPC 接口暴露服务。但要在移动端运行全节点（Full Node，几百 GB 数据）是不现实的。
通常我们会连接 Infura 或 Alchemy 这样的远程节点服务商。web3dart 底层封装了 http 和 web_socket_channel 来与这些节点通信。

1.2 账户与签名 (ECDSA)

以太坊使用 椭圆曲线数字签名算法 (ECDSA, secp256k1)。

  • 私钥 (Private Key)：256 位随机数，绝对不能泄露。
  • 公钥 (Public Key)：由私钥生成。
  • 地址 (Address)：公钥的哈希值（Keccak-256）的后 20 字节。

交易必须用私钥签名。web3dart 可能会在设备本地完成签名过程，只将签名后的数据（Raw Transaction）发送给节点，确保私钥永远不离开设备。

1. 发起交易2. 构建交易对象3. 请求签名4. 返回签名数据 (Raw Tx)5. 发送 JSON-RPC 请求6. 广播交易7. 矿工打包8. 推送回执/事件

用户操作

Flutter DApp

web3dart 客户端

本地钱包/私钥

远程节点 (Infura/Alchemy)

以太坊网络

区块链

二、核心 API 详解

2.1 初始化客户端

import'package:http/http.dart';import'package:web3dart/web3dart.dart';voidmain(){final rpcUrl ="https://mainnet.infura.io/v3/YOUR_API_KEY";final httpClient =Client();final ethClient =Web3Client(rpcUrl, httpClient);}
在这里插入图片描述

2.2 账户管理 (Wallet)

// 生成随机私钥var rng =Random.secure();var credentials =EthPrivateKey.createRandom(rng);// 获取地址var address =await credentials.extractAddress();print(address.hex);// 导入私钥var privateKey ="0x...";var credentials2 =EthPrivateKey.fromHex(privateKey);
在这里插入图片描述

2.3 发送 ETH (Native Token Transfer)

// 转账 0.1 ETH// 注意：amount 的单位是 Wei (1 ETH = 10^18 Wei)await ethClient.sendTransaction( credentials,Transaction( to:EthereumAddress.fromHex('0xReceiverAddress...'), gasPrice:EtherAmount.inWei(BigInt.from(10000000000)),// 10 Gwei maxGas:21000,// 标准转账 Gas Limit value:EtherAmount.fromUnitAndValue(EtherUnit.ether,1),), chainId:1,// Mainnet ID);
在这里插入图片描述

三、OpenHarmony 平台适配实战：智能合约交互

在鸿蒙上开发 DApp，最常见的场景是调用合约。比如查询用户的 USDT 余额。

3.1 ABI (Application Binary Interface)

合约编译后会生成 ABI（JSON 格式），描述了合约的方法签名。

[{"constant":true,"inputs":[{"name":"_owner","type":"address"}],"name":"balanceOf","outputs":[{"name":"balance","type":"uint256"}],"type":"function"},...]

3.2 调用 ERC-20 合约 (Read)

import'package:flutter/services.dart'show rootBundle;// 1. 加载 ABIString abi =await rootBundle.loadString("assets/erc20.abi.json");final contractAddr =EthereumAddress.fromHex("0xdAC17F958D2ee523a2206206994597C13D831ec7");// USDT Contract// 2. 解析合约final contract =DeployedContract(ContractAbi.fromJson(abi,"USDT"), contractAddr );final balanceFunction = contract.function('balanceOf');// 3. 调用 (call)// call 是只读操作，不需要 gas，不需要私钥签名final result =await ethClient.call( contract: contract, function: balanceFunction, params:[EthereumAddress.fromHex("0xUserAddress...")],);// 4. 解析结果 (BigInt)final balance = result.first asBigInt;print('USDT Balance: ${balance /BigInt.from(10).pow(6)}');// USDT 精度是 6
在这里插入图片描述

3.3 写入合约 (Write / Transaction)

final transferFunction = contract.function('transfer');// sendTransaction 需要 gas 和 私钥，会改变链上状态final txHash =await ethClient.sendTransaction( credentials,Transaction.callContract( contract: contract, function: transferFunction, parameters:[EthereumAddress.fromHex("0xReceiver..."),BigInt.from(1000000)// 1 USDT],), chainId:1,);print('TxHash: $txHash');
在这里插入图片描述

四、高级进阶：安全性与私钥存储

4.1 密钥库 (Keystore / JSON V3)

为了安全，私钥不应直接明文存储。标准做法是使用 Keystore 格式，结合用户密码进行加密。

// 创建 Wallet (生成 JSON V3 字符串)// scryptN: CPU 消耗参数，越大越难爆破Wallet wallet =awaitWallet.createNew(credentials,"user_password", scryptN:8192);String json = wallet.toJson();// 保存这个 json 到本地文件File('wallet.json').writeAsStringSync(json);// 读取时解密Wallet wallet =Wallet.fromJson(json,"user_password"); credentials = wallet.privateKey;

4.2 鸿蒙安全存储 (HUKS / EL2)

在 OpenHarmony 上，我们有更安全的硬件级密钥管理服务 (HUKS)。
但在 Flutter 层，如果没有 HUKS插件，我们至少要做到：

  1. 使用 flutter_secure_storage：在 Android 上对应 Keystore，在 iOS 上对应 Keychain。在鸿蒙上，目前需要自行适配或使用应用沙箱的 EL2 加密区。
  2. 不存储私钥：只存储 Keystore JSON 文件。解密私钥仅在内存中存在（Credentials 对象），用完即焚（设为 null 或让 GC 回收）。

4.3 助记词 (Mnemonic / BIP39/44)

现代钱包都支持助记词（12 个单词）。需配合 bip39 和 bip32 库使用。

// 生成助记词String mnemonic = bip39.generateMnemonic();// 推导私钥 (BIP44 路径 m/44'/60'/0'/0/0)var seed = bip39.mnemonicToSeed(mnemonic);var master =await ED25519_HD_KEY.getMasterKeyFromSeed(seed);// 需要 ed25519_hd_key 库// ... 复杂推导过程，web3dart 暂未内置，需组合其他库 ...
在这里插入图片描述

五、总结

web3dart 是 Flutter 连接区块链世界的桥梁。虽然它主要是底层的 JSON-RPC 包装，但结合 Dart 强大的异步能力和 UI 表现力，你可以轻松构建出体验优于 Web 端（MetaMask 插件）的原生 DApp。

对于 OpenHarmony 开发者，区块链应用（如数字人民币硬件钱包、供应链溯源终端）是鸿蒙生态的重要场景。掌握 web3dart，你就在这个领域占据了先机。

最佳实践：

  • 网络切换：支持主网 (Mainnet) 与测试网 (Sepolia/Goerli) 的动态切换。
  • Gas 估算：发送交易前务必调用 estimateGas，防止 Gas 不足交易失败。
  • 异常处理：RPC 节点经常超时或限流，必须实现重试机制。

Read more

Stable Diffusion：使用自己的数据集微调 Stable Diffusion 3.5 LoRA 文生图模型

Stable Diffusion：使用自己的数据集微调 Stable Diffusion 3.5 LoRA 文生图模型

Stable Diffusion：使用自己的数据集微调 Stable Diffusion 3.5 LoRA 文生图模型 * 前言 * 环境要求 * 相关介绍 * 微调 Stable Diffusion 3.5 LoRA 文生图模型 * 下载Stable Diffusion 3.5 LoRA Fine-Tuning项目 * Windows * Linux * 准备数据集 * metadata.jsonl，内容如下。 * 下载预训练模型 * Hugging Face * Model Scope * 进行训练 * 输出结果 * 进行预测 * 输出结果 * 参考 前言 由于本人水平有限，难免出现错漏，敬请批评改正。更多精彩内容，可点击进入Python日常小操作专栏、OpenCV-Python小应用专栏、YOLO系列专栏、自然语言处理专栏、
如何在PPT 中嵌入 VR 图片？如何在PPT中插入全景图片或Google相机空间图片进行播放？霹雳设计助手 VR 功能实操指南

如何在PPT 中嵌入 VR 图片？如何在PPT中插入全景图片或Google相机空间图片进行播放？霹雳设计助手 VR 功能实操指南

在产品展示、场景讲解、教学演示等诸多场景中，VR 图片凭借 360° 全视角的展示特性，能让观众获得沉浸式的视觉体验，相比普通图片和视频更具表现力。 但在传统的 PPT 演示中，想要展示 VR 图片却存在诸多不便，往往需要通过录屏、跳转浏览器或第三方软件的方式实现，操作流程的割裂不仅影响演示的连贯性，也让 VR 图片的沉浸式体验大打折扣。 霹雳设计助手的插入 VR 功能，实现了将 VR 图片直接嵌入 PPT 并在其中完成 360° 交互预览与放映的需求，无需切换外部软件，让 VR 图片的展示真正融入 PPT 演示流程。 本文将以实操为核心，详细讲解该功能的兼容特性、使用流程、功能操作及实操技巧，帮助不同领域的从业者快速掌握在 PPT 中嵌入和展示 VR 图片的方法，让沉浸式展示变得简单高效。 一、功能核心兼容特性与适用场景 在使用插入

Cosmos-Reason1-7B实战案例：为ROS2机器人注入物理常识推理能力

Cosmos-Reason1-7B实战案例：为ROS2机器人注入物理常识推理能力 1. 项目概述 Cosmos-Reason1-7B是NVIDIA开源的一款7B参数量的多模态物理推理视觉语言模型(VLM)，作为Cosmos世界基础模型平台的核心组件，专注于物理理解与思维链(CoT)推理能力。该模型特别适合机器人与物理AI场景，能够处理图像/视频输入并生成符合物理常识的决策回复。 核心能力： * 理解复杂物理场景 * 进行链式思维推理 * 为机器人提供常识判断 * 分析图像/视频中的物理现象 2. ROS2集成方案 2.1 系统架构设计 将Cosmos-Reason1-7B集成到ROS2机器人系统中的典型架构如下： [机器人传感器] → [ROS2节点] → [Cosmos推理服务] → [决策系统] ↑ ↑ [执行器] ← [控制节点] ← 2.2 安装与配置 1. 安装依赖： pip install transformers>=4.35.0 torch>=2.1.0 2. 下载模型：
RTAB-Map学习记录(1)--论文阅读

RTAB-Map学习记录(1)--论文阅读

前言 RTAB-Map（全称 Real-Time Appearance-Based Mapping）是一个开源的 RGB-D SLAM框架，主要用于机器人导航、3D 重建和环境建图。这个项目目前还在积极的维护和更新，也可以进行实际环境的部署。所以先学习一下相关的原理和论文，为之后的使用打下基础。 文章目录 * 前言 * 1.主要贡献 * 2.关键内容 * 2.1 里程计 * 2.1.1 视觉里程计 * 2.1.2 激光雷达里程计 * 2.2 同步性 * 2.3 STM * 2.4 回环检测与优化 * 2.5 全局地图组成 1.主要贡献 首先看一下该方法的主要贡献有哪些，现有一个基本的了解： 1.