Flutter Aptos API集成插件aptos_api_dart的使用

在本教程中，我们将展示如何在Flutter项目中使用aptos_api_dart插件与Aptos区块链进行交互。此插件允许开发者通过RESTful API与Aptos区块链进行通信。

环境要求

• Dart: 2.15.0+
• Flutter: 2.8.0+
• 依赖库: Dio 5.0.0+

安装与使用

在pub.dev中安装

在pubspec.yaml文件中添加以下依赖项：

dependencies:
  aptos_api_dart: 0.0.1

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

从GitHub安装

如果该包已发布到GitHub，可以在pubspec.yaml中添加如下配置：

dependencies:
  aptos_api_dart:
    git:
      url: https://github.com/GIT_USER_ID/GIT_REPO_ID.git
      #ref: main

本地开发安装

若要从本地驱动器使用该包，请在pubspec.yaml中添加以下配置：

dependencies:
  aptos_api_dart:
    path: /path/to/aptos_api_dart

快速开始

请按照上述安装步骤操作，并运行以下代码以获取账户信息：

import 'package:aptos_api_dart/aptos_api_dart.dart';

void main() async {
  // 初始化Aptos API客户端
  final api = AptosApiDart().getAccountsApi();

  // 替换为实际的地址（可以包含或不包含前缀'0x'）
  final String address = "your_account_address";
  
  // 可选参数：指定Ledger版本以获取特定状态的账户信息
  final String ledgerVersion = "latest"; 

  try {
    // 获取账户信息
    final response = await api.getAccount(address, ledgerVersion);
    print("账户信息: $response");
  } catch (e) {
    // 捕获并打印异常
    print("调用失败: $e");
  }
}

运行结果示例

假设您提供了正确的地址，程序将返回类似如下的JSON数据：

{
  "address": "0x1234567890abcdef",
  "sequence_number": "123",
  "authentication_key": "0x9876543210fedcba",
  "delegated_key_rotation_capability": false,
  "delegated_withdrawal_capability": false,
  "balances": [
    {
      "coin": {
        "type": "0x1::aptos_coin::AptosCoin"
      },
      "amount": "100000000"
    }
  ]
}

API文档

以下是支持的主要API端点及其功能说明：

更多详细信息可参考官方文档。

完整示例代码

以下是一个完整的示例，展示如何查询账户余额并打印结果：

import 'package:aptos_api_dart/aptos_api_dart.dart';

void main() async {
  final api = AptosApiDart().getAccountsApi();
  final String address = "your_account_address";

  try {
    final response = await api.getAccount(address, "latest");
    print("账户地址: ${response['address']}");
    print("余额: ${response['balances'][0]['amount']}");
  } catch (e) {
    print("发生错误: $e");
  }
}