Flutter区块链交互插件web3dart_plus的使用

在Flutter中与以太坊区块链进行交互时，web3dart_plus 是一个非常有用的插件。它允许开发者通过RPC连接到以太坊节点，并执行各种操作，例如发送交易、调用智能合约等。

特性

• 连接到以太坊节点：通过RPC API调用常用方法。
• 发送签名的以太坊交易。
• 生成私钥并设置新的以太坊地址。
• 调用智能合约函数并监听合约事件。
• 基于智能合约ABI生成代码，简化交互过程。

待办事项

• 支持编码所有Solidity支持的数据类型，但目前未完全支持 (u)fixed 类型（这些类型不常用）。

使用方法

凭据和钱包

为了在以太坊网络上发送交易，需要一些凭据。web3dart_plus 支持从私钥或v3钱包文件创建凭据。

从私钥创建凭据

import 'package:web3dart_plus/web3dart.dart';

const privateKey = 'a2fd51b96dc55aeb14b30d55a6b3121c7b9c599500c1beb92a389c3377adc86e';

void main() async {
  final credentials = EthPrivateKey.fromHex(privateKey);
  
  // 提取公钥和地址
  final address = await credentials.extractAddress();
  print(address.hexEip55); // 打印地址
}

随机生成新私钥

import 'dart:math';
import 'package:web3dart_plus/web3dart.dart';

void main() async {
  final rng = Random.secure(); // 创建随机数生成器
  final credentials = EthPrivateKey.createRandom(rng);

  final address = await credentials.extractAddress();
  print(address.hexEip55);
}

连接到RPC服务器

web3dart_plus 不会直接将签名的交易发送给矿工，而是依赖于RPC客户端完成此操作。可以使用 Infura 的公共RPC API，或者搭建自己的节点（例如使用 Geth）。如果只是测试，可以使用 Truffle 和 Ganache 提供的私有测试网。

import 'package:http/http.dart' as http;
import 'package:web3dart_plus/web3dart.dart';

const rpcUrl = 'http://localhost:7545';

void main() async {
  final httpClient = http.Client();
  final client = Web3Client(rpcUrl, httpClient);

  // 获取账户余额
  final address = EthereumAddress.fromHex('0x...'); // 替换为实际地址
  final balance = await client.getBalance(address);
  print(balance.getInWei); // 打印以太币数量（单位为wei）
}

发送交易

可以使用 Web3Client 创建、签署并发送以太坊交易。

import 'package:web3dart_plus/web3dart.dart';
import 'package:http/http.dart' as http;

const rpcUrl = 'http://localhost:7545';
const privateKey = 'a2fd51b96dc55aeb14b30d55a6b3121c7b9c599500c1beb92a389c3377adc86e';

void main() async {
  final httpClient = http.Client();
  final client = Web3Client(rpcUrl, httpClient);

  final credentials = EthPrivateKey.fromHex(privateKey);

  // 发送交易
  await client.sendTransaction(
    credentials,
    Transaction(
      to: EthereumAddress.fromHex('0xC914Bb2ba888e3367bcecEb5C2d99DF7C7423706'),
      gasPrice: EtherAmount.inWei(BigInt.one),
      maxGas: 100000,
      value: EtherAmount.fromUnitAndValue(EtherUnit.ether, 1),
    ),
  );

  await client.dispose(); // 关闭客户端
}

智能合约

web3dart_plus 可以解析智能合约的ABI并与其交互，包括调用函数和监听事件。

import 'package:web3dart_plus/web3dart.dart';
import 'package:http/http.dart' as http;

const rpcUrl = 'http://localhost:7545';
const privateKey = 'a2fd51b96dc55aeb14b30d55a6b3121c7b9c599500c1beb92a389c3377adc86e';

void main() async {
  final httpClient = http.Client();
  final client = Web3Client(rpcUrl, httpClient);

  final credentials = EthPrivateKey.fromHex(privateKey);

  // 调用智能合约函数
  final contractAddress = EthereumAddress.fromHex('0x...');
  final contract = DeployedContract(
    ContractAbi.fromJson(jsonString, 'contractName'),
    contractAddress,
  );

  final result = await client.call(
    contract: contract,
    function: contract.function('functionName'),
    params: [],
  );
  print(result); // 打印返回值
}

自动生成Dart代码

通过Dart构建系统，web3dart_plus 可以根据智能合约的ABI自动生成Dart代码，方便与合约交互。

1. 在 lib/ 目录下添加 .abi.json 文件。
2. 添加 build_runner 依赖并运行以下命令：

   pub run build_runner build

3. 生成的 .g.dart 文件包含与合约交互的代码。

示例代码

以下是一个完整的示例代码，展示如何使用 web3dart_plus 进行基本的区块链操作：

import 'package:http/http.dart';
import 'package:web3dart_plus/web3dart.dart';

const String privateKey =
    'a2fd51b96dc55aeb14b30d55a6b3121c7b9c599500c1beb92a389c3377adc86e';
const String rpcUrl = 'http://localhost:7545';

Future<void> main() async {
  final client = Web3Client(rpcUrl, Client());

  final credentials = EthPrivateKey.fromHex(privateKey);
  final address = credentials.address;

  print(address.hexEip55);
  print(await client.getBalance(address));

  await client.sendTransaction(
    credentials,
    Transaction(
      to: EthereumAddress.fromHex('0xC914Bb2ba888e3367bcecEb5C2d99DF7C7423706'),
      gasPrice: EtherAmount.inWei(BigInt.one),
      maxGas: 100000,
      value: EtherAmount.fromUnitAndValue(EtherUnit.ether, 1),
    ),
  );

  await client.dispose();
}