Flutter连接管理插件darttonconnect_plus的使用

本文将详细介绍如何在Flutter项目中使用darttonconnect_plus插件来实现与TON钱包的连接和交易功能。

安装

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

dependencies:
  darttonconnect_plus: ^1.0.1

然后运行以下命令以安装依赖：

$ flutter pub get

配置

创建一个JSON格式的manifest文件，用于描述你的应用信息。这些信息将在用户连接钱包时显示。

示例manifest文件内容如下：

{
  "url": "<app-url>",                       // 必填项：应用的URL
  "name": "<app-name>",                     // 必填项：应用名称
  "iconUrl": "<app-icon-url>",              // 必填项：应用图标URL
  "termsOfUseUrl": "<terms-of-use-url>",    // 可选项：隐私政策URL
  "privacyPolicyUrl": "<privacy-policy-url>"// 可选项：服务条款URL
}

确保该文件可以通过其URL访问。

初始化

在Flutter代码中初始化TonConnectManager并传入manifest文件的URL。

import 'package:darttonconnect_plus/darttonconnect_plus.dart';

void main() {
  var tonManager = TonConnectManager(
    'https://gist.githubusercontent.com/romanovichim/e81d599a6f3798bb9f74ab1970a8b376/raw/43e00b0abc824ef272ac6d0f8083d21456602adf/gistfiletest.txt',
  );

  // 订阅事件流
  tonManager.messagesStream.listen((TonPaymentStatus status) {
    print('接收到事件: $status');
  });
}

处理事件

TonConnectManager会通过事件流发送各种状态更新。以下是可能的状态及其含义：

• TonPaymentStatus.Wallets_loaded
  支持的TON钱包列表已加载。此时可以提示用户选择钱包进行连接。

• TonPaymentStatus.UniversalLink_generated
  用户选择了特定的钱包，生成了连接链接。

• TonPaymentStatus.Connected
  选定的钱包已成功连接到应用。此时可以发起交易请求。

• TonPaymentStatus.Transaction_prepaired
  交易请求已通过TON HTTP桥发送。用户需要打开钱包确认交易。

• TonPaymentStatus.Transaction_sent
  交易已成功添加到区块链。

• TonPaymentStatus.Transaction_error_or_rejected
  用户拒绝了交易或连接出现问题。

• TonPaymentStatus.Disconnected
  钱包已从应用中断开连接。

发起交易

darttonconnect_plus提供了两种方式来发起交易：简单接口和自定义接口。

简单接口

void sendTrx({
  required String address,   // 目标地址
  required int amount,       // 转账金额（单位为微吨）
  String? comment,           // 交易备注
  int? validUntill,          // 交易有效期（秒）
}) async {
  await tonManager.sendTrx(
    address: address,
    amount: amount,
    comment: comment,
    validUntill: validUntill,
  );
}

自定义接口

void sendTrxRaw({required Map<String, dynamic> transaction}) async {
  await tonManager.sendTrxRaw(transaction: transaction);
}

示例代码

以下是一个完整的示例代码，展示了如何使用darttonconnect_plus插件完成基本的连接和交易操作。

import 'package:flutter/material.dart';
import 'package:darttonconnect_plus/darttonconnect_plus.dart';

void main() {
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: HomeScreen(),
    );
  }
}

class HomeScreen extends StatefulWidget {
  [@override](/user/override)
  _HomeScreenState createState() => _HomeScreenState();
}

class _HomeScreenState extends State<HomeScreen> {
  late TonConnectManager tonManager;

  [@override](/user/override)
  void initState() {
    super.initState();
    tonManager = TonConnectManager(
      'https://gist.githubusercontent.com/romanovichim/e81d599a6f3798bb9f74ab1970a8b376/raw/43e00b0abc824ef272ac6d0f8083d21456602adf/gistfiletest.txt',
    );

    tonManager.messagesStream.listen((TonPaymentStatus status) {
      print('接收到事件: $status');
    });
  }

  void _connectWallet() async {
    try {
      await tonManager.connect();
      print('钱包已连接');
    } catch (e) {
      print('连接失败: $e');
    }
  }

  void _sendTransaction() async {
    try {
      await tonManager.sendTrx(
        address: 'EQB9HrZ...KQ', // 示例目标地址
        amount: 1000000,         // 示例转账金额（微吨）
        comment: '测试交易',
      );
      print('交易已发送');
    } catch (e) {
      print('交易失败: $e');
    }
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: Text('TON Connect 示例')),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            ElevatedButton(
              onPressed: _connectWallet,
              child: Text('连接钱包'),
            ),
            SizedBox(height: 20),
            ElevatedButton(
              onPressed: _sendTransaction,
              child: Text('发送交易'),
            ),
          ],
        ),
      ),
    );
  }
}