Flutter 自定义功能扩展插件 moonsdk 的使用

moonsdk概述

moonsdk 是一个自动生成的 Dart 包，用于与多个区块链系统进行交互。本教程将引导您如何在 Flutter 项目中安装并使用 moonsdk。

要求

确保您的 Flutter 环境满足以下要求：

• Flutter 2.8.0 或更高版本
• Dio 5.0.0 或更高版本

安装

从 pub.dev 安装

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

dependencies:
  moonsdk: 1.0.0

然后运行 flutter pub get 命令以安装该包。

从 GitHub 安装

如果您想直接从 GitHub 获取 moonsdk，可以在 pubspec.yaml 文件中添加以下依赖项：

dependencies:
  moonsdk:
    git:
      url: https://github.com/moon-up/moon-sdk-dart.git
      # ref: main

然后运行 flutter pub get 命令以安装该包。

本地开发

如果您正在本地开发 moonsdk，可以在 pubspec.yaml 文件中添加以下依赖项：

dependencies:
  moonsdk:
    path: /path/to/moonsdk

然后运行 flutter pub get 命令以安装该包。

开始使用

首先，确保您已经完成了上述安装步骤。接下来，您可以按照以下步骤开始使用 moonsdk。

导入包

在 Dart 文件中导入 moonsdk 包：

import 'package:moonsdk/moonsdk.dart';

创建 API 实例

使用 Moonsdk() 类创建 API 实例。例如，获取 Aave API：

final api = Moonsdk().getAaveApi();

发起请求

现在您可以调用 API 方法来发起请求。例如，调用 borrow 方法：

final String authorization = "your_authorization_token"; // 授权令牌
final String name = "example_name"; // 示例名称
final AaveInput aaveInput = AaveInput(); // 创建 AaveInput 实例

try {
  final response = await api.borrow(authorization, name, aaveInput);
  print(response);
} catch on DioException (e) {
  print("Exception when calling AaveApi->borrow: $e\n");
}

API 文档

以下是所有可用的 API 端点及其说明：

更多 API 端点详细信息，请参阅 API 文档。

示例代码

以下是一个完整的示例代码，展示了如何创建账户、获取账户余额并签名交易：

import 'package:moonsdk/moonsdk.dart';

void main() async {
  // 初始化 API 实例
  final api = Moonsdk();

  // 创建账户
  final CreateAccountInput createAccountInput = CreateAccountInput(
    accountName: "example_account",
    currency: "BTC",
  );

  try {
    final createAccountResponse = await api.accounts.createAccount(createAccountInput);
    print("Created Account: $createAccountResponse");
  } catch (e) {
    print("Failed to create account: $e");
  }

  // 获取账户余额
  final GetBalanceInput getBalanceInput = GetBalanceInput(accountName: "example_account");

  try {
    final balanceResponse = await api.accounts.getBalance(getBalanceInput);
    print("Account Balance: $balanceResponse");
  } catch (e) {
    print("Failed to get balance: $e");
  }

  // 签名交易
  final SignTransactionInput signTransactionInput = SignTransactionInput(
    accountName: "example_account",
    transactionData: TransactionData(
      from: "sender_address",
      to: "receiver_address",
      amount: "100000000", // 单位为 satoshi
    ),
  );

  try {
    final signedTransactionResponse = await api.accounts.signTransaction(signTransactionInput);
    print("Signed Transaction: $signedTransactionResponse");
  } catch (e) {
    print("Failed to sign transaction: $e");
  }
}