Flutter加密解密插件rusty_chacha的使用

Flutter加密解密插件rusty_chacha的使用

Rusty ChaCha 💃🦀

一个用于快速ChaCha20-Poly1305加密的Flutter库，利用了Rust的chacha20poly1305 crate的能力。

🚧 开发中：不推荐在生产环境中使用。 🚧

特性

• 使用ChaCha20-Poly1305（认证）加密和解密数据
• 支持附加认证数据（AAD）
• 可选压缩功能，使用zstd算法

极速运行 🔥

由于Rust加密和解密，使用ChaCha20-Poly1305可以达到每秒500-1000 MB的速度。这比诸如cryptography_flutter或pointycastle等包快多达50倍。

开始使用

在Flutter项目中，通过以下命令添加该库：

flutter pub add rusty_chacha

使用方法

import 'dart:typed_data';
import 'package:collection/collection.dart';
import 'package:rusty_chacha/rusty_chacha.dart';

void main() async {
  
  final data = Uint8List.fromList([1, 2, 3, 4, 5]);

  // 创建并使用一个随机密钥的ChaCha20Poly1305密码器：
  RustyChaCha20Poly1305 cipher = await RustyChaCha.create();
  Uint8List myEncryptedData = await cipher.encrypt(cleartext: data);
  Uint8List decrypted1 = await cipher.decrypt(ciphertext: myEncryptedData);

  assert(const ListEquality().equals(data, decrypted1));

  // 或者使用显式密钥：
  Uint8List key = await RustyChaCha20Poly1305.generateKey();
  cipher = await RustyChaCha.create(key: key);

  // 压缩示例：
  // 如果在加密时使用了压缩，则在解密时也必须设置！
  // 但是压缩级别并不重要。
  cipher = await RustyChaCha.create(
    key: key,
    compression: const Compression.zstd(compressionLevel: 3), // 中等压缩
  );
  Uint8List myCompressedAndEncryptedData = await cipher.encrypt(cleartext: data);
  Uint8List decrypted2 = await cipher.decrypt(ciphertext: myCompressedAndEncryptedData);

  assert(const ListEquality().equals(data, decrypted2));

  // AAD示例：
  cipher = await RustyChaCha.create();
  Uint8List additionalData = Uint8List.fromList([1, 2, 3]); // 某些额外的非机密数据
  Uint8List myEncryptedDataWithAad = await cipher.encrypt(
    cleartext: data,
    aad: additionalData, // 在加密时传递
  );
  Uint8List decrypted3 = await cipher.decrypt(
    ciphertext: myEncryptedDataWithAad,
    aad: additionalData, // 解密时传递（如果additionalData不同，则解密失败）
  );

  assert(const ListEquality().equals(data, decrypted3));

  // 创建并使用一个XChaCha20Poly1305，使用扩展的192位（24字节）随机数而不是96位（12字节）：
  RustyXChaCha20Poly1305 cipherX = await RustyChaCha.createX();
  Uint8List myEncryptedData2 = await cipherX.encrypt(cleartext: data);
  Uint8List decrypted4 = await cipherX.decrypt(ciphertext: myEncryptedData2);

  assert(const ListEquality().equals(data, decrypted4));
}

当前支持的平台

• iOS
• MacOS
• Windows
• Linux

致谢

• RustCrypto团队为创建了chacha20poly1305 crate
• @fzyzcjy为提供了出色的flutter_rust_bridge
• Mimir为提供了一个项目模板

完整示例代码

import 'dart:typed_data';

import 'package:flutter/material.dart';
import 'package:collection/collection.dart';
import 'package:rusty_chacha/rusty_chacha.dart';

void _encrypt() async {
  final data = Uint8List.fromList([1, 2, 3, 4, 5]);
  print('data: $data');

  // 创建并使用一个随机密钥的ChaCha20Poly1305密码器：
  RustyChaCha20Poly1305 cipher = await RustyChaCha.create();

  Uint8List encrypted = await cipher.encrypt(cleartext: data);
  print('encrypted: $encrypted');

  Uint8List decrypted = await cipher.decrypt(ciphertext: encrypted);
  print('decrypted: $decrypted');

  assert(const ListEquality().equals(data, decrypted));
}

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

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Rusty ChaCha 💃🦀 demo',
      theme: ThemeData(
        colorScheme: ColorScheme.fromSeed(seedColor: Colors.deepPurple),
        useMaterial3: true,
      ),
      home: const MyHomePage(title: 'Rusty ChaCha 💃🦀 demo'),
    );
  }
}

class MyHomePage extends StatefulWidget {
  const MyHomePage({super.key, required this.title});

  final String title;

  [@override](/user/override)
  State<MyHomePage> createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        backgroundColor: Theme.of(context).colorScheme.inversePrimary,
        title: Text(widget.title),
      ),
      floatingActionButton: const FloatingActionButton(
        onPressed: _encrypt,
        tooltip: 'Encrypt',
        child: Icon(Icons.lock),
      ),
    );
  }
}