Flutter算法连接插件flutter_myalgo_connect的使用

flutter-myalgo-connect #

MyAlgo 是一个 Algorand 钱包，允许用户自由地与 Algorand 区块链交互。

MyAlgo 提供了最简单和最安全的方式来发送和接收 Algos 和代币，组织和跟踪所有 Algorand 钱包，管理资产等。

该插件由 RootSoft 开发，与 Rand Labs 或 MyAlgo 没有任何关联。如需更多信息，请查看官方 MyAlgo 文档。

介绍 #

与 MyAlgo 钱包的集成允许用户安全访问 Algorand DApps。用户只需要分享他们的公共地址给 Web 应用程序，这使得他们可以审查和签署所有类型的交易而无需暴露私钥。MyAlgo Connect 的主要创新之处在于，整个过程在用户的浏览器中进行，不需要任何后端服务、下载、扩展或浏览器插件。不像基于扩展的钱包（如 MetaMask 或 AlgoSigner），MyAlgo Connect 可以在任何浏览器（包括 Safari）和任何设备上工作，为开发人员提供了一个可以在所有平台上运行的原生 HTML5 解决方案。

flutter-myalgo-connect 插件紧密遵循 JavaScript MyAlgo Connect API，并且所有方法都可用。该插件与 algorand_dart SDK 集成良好，使得交易可以轻松签名和批准。

安装完成后，您可以简单地签名交易并开始发送付款：

/// 获取账户
final accounts = await MyAlgoConnect.connect();

/// 签名交易
final signedTx = await MyAlgoConnect.signTransaction(data);
final blob = signedTx['blob'];

// 发送交易
final txId = await algorand.sendRawTransaction(
    base64Decode(blob),
);

开始使用 #

安装 #

您可以通过 pub.dev 安装包：

flutter pub add flutter_myalgo_connect

这将在您的包的 pubspec.yaml 文件中添加一行（并隐式运行 `dart pub get`）：

dependencies:
  flutter_myalgo_connect: ^latest-version

或者，您的编辑器可能支持 `flutter pub get`。请查阅您的编辑器文档了解更多信息。

接下来，在 index.html 文件底部添加 MyAlgo Connect JS 文件：

  </body>
  <script src="https://github.com/randlabs/myalgo-connect/releases/download/v1.0.1/myalgo.min.js"></script>
</html>

有关最新版本，请参阅 releases。

使用 `flutter run -d web-server` 在本地服务器上启动您的 Web 应用。

方法 #

flutter-myalgo-connect Web 插件封装了 JavaScript API 并为 Flutter 开发者提供了方法。这样，Flutter Web 开发者可以受益于相同的 API 来创建 Web3 dApp。

connect() #

请求访问钱包以供 dApp 使用，可能会被拒绝或批准。每次访问都从连接请求开始，如果用户批准，则允许 dApp 进行其他请求。 `connect()` 方法返回一个可用于签名交易的账户列表。

final accounts = await MyAlgoConnect.connect();

signTransaction() #

将符合 Algorand JS SDK 的交易对象发送到 MyAlgo Connect 进行审批。如果审批通过，响应是一个包含已签名交易对象的数组，其中二进制 blob 字段进行了 Base64 编码，以防止传输问题。

交易要求

由于 MyAlgo Connect 不支持传递 Base64 编码的交易或原始字节，因此交易字段必须符合 Algorand JS SDK。

有关更多信息，请参阅 API 使用

注意：自 v1.1.1 起，不再需要这样做，您可以使用 algorand-dart sdk 中的 TransactionBuilders。

请求

await MyAlgoConnect.signTransaction({
    'fee': 1000,
    'flatFee': true,
    'type': 'pay',
    'from': accounts[0],
    'to': accounts[0],
    'amount': Algo.toMicroAlgos(0.5),
    'firstRound': params.lastRound,
    'lastRound': params.lastRound + 1000,
    'genesisID': params.genesisId,
    'genesisHash': params.genesisHash,
});

或者

// 构造交易
final tx1 = await (PaymentTransactionBuilder()
    ..sender = address
    ..receiver = address
    ..amount = Algo.toMicroAlgos(0.6)
    ..suggestedParams = params)
  .build();

final tx2 = await (PaymentTransactionBuilder()
    ..sender = address
    ..receiver = address
    ..amount = Algo.toMicroAlgos(0.5)
    ..suggestedParams = params)
  .build();

// 组合交易
AtomicTransfer.group([tx1, tx2]);

// 签名交易
final txs = await MyAlgoConnect.signTransactions([
    tx1.toBase64(),
    tx2.toBase64(),
]);

示例

以下展示了如何使用 MyAlgo Connect 签名和批准支付交易的一个示例。

// 获取账户
final accounts = await MyAlgoConnect.connect();

// 获取建议的交易参数
final params = await algorand.getSuggestedTransactionParams();

// 构造交易
final data = <String, dynamic>{
    'fee': 1000,
    'flatFee': true,
    'type': 'pay',
    'from': accounts[1],
    'to': accounts[1],
    'amount': Algo.toMicroAlgos(0.5),
    'firstRound': params.lastRound,
    'lastRound': params.lastRound + 1000,
    'genesisID': params.genesisId,
    'genesisHash': params.genesisHash,
};

// 签名交易
final signedTx = await MyAlgoConnect.signTransaction(data);
final blob = signedTx['blob'];

// 发送交易
final txId = await algorand.sendRawTransaction(
    base64Decode(blob),
);

// 等待确认
final tx = await algorand.waitForConfirmation(txId);
print('Confirmed tx id in round: ${tx.confirmedRound}');

signLogicSigTransaction() #

逻辑签名（或 LogicSigs）授权与 Algorand 智能合约相关的交易。逻辑签名被添加到交易中，以授权从智能合约账户或委托账户的支出。

final program = 'ASABASI=';
final sig = await MyAlgoConnect.signLogicSigTransaction(
    logic: program,
    address: accounts[1],
);