Flutter近场通信插件near_api_dart的使用

Flutter近场通信插件near_api_dart的使用

根据提供的内容和示例代码，near_api_dart 是一个用于与 Near Protocol 的 RPC API 进行交互的 Dart 库。它支持多平台，并且依赖较少，适用于移动、桌面或浏览器应用程序。以下是关于如何使用 near_api_dart 的详细说明和一个完整的示例 Demo。

1. 安装 near_api_dart

首先，在你的 pubspec.yaml 文件中添加 near_api_dart 依赖：

dependencies:
  near_api_dart: ^latest_version  # 请替换为最新版本号

然后运行 flutter pub get 来安装依赖。

2. 使用 near_api_dart 进行 RPC 调用

初始化 Near 对象

Near 类是与 Near 协议进行交互的主要入口。你可以通过它选择不同的 RPC 提供商并执行各种操作。

import 'package:near_api_dart/near_api_dart.dart';

void main() async {
  // 初始化 Near 对象
  Near near = Near();
  
  // 选择一个 RPC 提供商（例如测试网络）
  String rpcURL = 'https://rpc.testnet.near.org';
  JsonRpcProvider rpc = near.providers.jsonRpcProvider(rpcURL);
}

获取账户余额

你可以通过 getBalance 方法获取指定账户的余额。以下是一个简单的示例：

try {
  // 获取账户余额
  BigInt balance = await rpc.getBalance('guest-book.testnet');
  print('Account Balance: $balance');
} catch (e) {
  print('Error fetching balance: $e');
}

获取账户代码

你可以通过 getCode 方法获取部署在账户上的智能合约代码。以下是一个示例：

try {
  // 获取账户代码（以哈希形式返回）
  String code = await rpc.getCode('guest-book.testnet', mode: 'hash');
  print('Account Code Hash: $code');
} catch (e) {
  print('Error fetching code: $e');
}

查看账户信息

你可以通过 viewAccount 方法查看账户的详细信息。以下是一个示例：

try {
  // 查看账户信息
  var info = await rpc.viewAccount('guest-book.testnet');
  print('Account Info: $info');
} catch (e) {
  print('Error fetching account info: $e');
}

获取最近区块的 Gas 价格

你可以通过 gasPrice 方法获取最近区块的 Gas 价格。以下是一个示例：

try {
  // 获取最近区块的 Gas 价格
  var gasPrice = await rpc.gasPrice();
  print('Gas Price: $gasPrice');
} catch (e) {
  print('Error fetching gas price: $e');
}

关闭连接

在完成所有操作后，记得关闭与 RPC 提供商的连接：

// 关闭连接
rpc.close();

3. 完整示例 Demo

以下是一个完整的示例 Demo，展示了如何使用 near_api_dart 进行多种 RPC 调用：

import 'package:near_api_dart/near_api_dart.dart';

void main() async {
  // 初始化 Near 对象
  Near near = Near();
  
  // 选择一个 RPC 提供商（例如测试网络）
  String rpcURL = 'https://rpc.testnet.near.org';
  JsonRpcProvider rpc = near.providers.jsonRpcProvider(rpcURL);

  // 获取账户余额
  try {
    BigInt balance = await rpc.getBalance('guest-book.testnet');
    print('Account Balance: $balance');
  } catch (e) {
    print('Error fetching balance: $e');
  }

  // 获取账户代码
  try {
    String code = await rpc.getCode('guest-book.testnet', mode: 'hash');
    print('Account Code Hash: $code');
  } catch (e) {
    print('Error fetching code: $e');
  }

  // 查看账户信息
  try {
    var info = await rpc.viewAccount('guest-book.testnet');
    print('Account Info: $info');
  } catch (e) {
    print('Error fetching account info: $e');
  }

  // 获取最近区块的 Gas 价格
  try {
    var gasPrice = await rpc.gasPrice();
    print('Gas Price: $gasPrice');
  } catch (e) {
    print('Error fetching gas price: $e');
  }

  // 关闭连接
  rpc.close();
}