Merge branch '1.1.x' into develop

Signed-off-by: Nguyen Van Nguyen <[email protected]>

README.md

@@ -1,11 +1,11 @@
 Dart PG (Dart Privacy Guard) - The OpenPGP library in Dart language
 ===================================================================
 Dart PG is an implementation of the OpenPGP standard in Dart language.
-It implements [RFC4880](https://www.rfc-editor.org/rfc/rfc4880), [RFC6637](https://www.rfc-editor.org/rfc/rfc6637),
+It implements [RFC4880](https://www.rfc-editor.org/rfc/rfc4880), [RFC5581](https://www.rfc-editor.org/rfc/rfc5581), [RFC6637](https://www.rfc-editor.org/rfc/rfc6637),
 parts of [RFC4880bis](https://datatracker.ietf.org/doc/html/draft-ietf-openpgp-rfc4880bis).
 
 ## Features
-* Dart PG allows to encrypt and sign data.
+* Support data signing & encryption.
 * Support key management: key generation, key reading, key decryption.
 * Support public-key algorithms: [RSA](https://en.wikipedia.org/wiki/RSA_(cryptosystem)),
   [DSA](https://en.wikipedia.org/wiki/Digital_Signature_Algorithm),
@@ -16,6 +16,7 @@ parts of [RFC4880bis](https://datatracker.ietf.org/doc/html/draft-ietf-openpgp-r
 * Support symmetric ciphers: 3DES, IDEA (for backward compatibility), CAST5, Blowfish, Twofish,
   [AES](https://en.wikipedia.org/wiki/Advanced_Encryption_Standard),
   [Camellia](https://en.wikipedia.org/wiki/Camellia_(cipher)).
+* Support AEAD algorithms: [EAX](https://www.cs.ucdavis.edu/~rogaway/papers/eax.pdf), [OCB](https://tools.ietf.org/html/rfc7253), [GCM](https://nvlpubs.nist.gov/nistpubs/Legacy/SP/nistspecialpublication800-38d.pdf).
 * Support hash algorithms: MD5, SHA-1, RIPEMD-160, SHA-256, SHA-384, SHA-512, SHA-224.
 * Support compression algorithms: ZIP, ZLIB.
 * Support [ECC](https://en.wikipedia.org/wiki/Elliptic-curve_cryptography) curves:

lib/src/armor/armor.dart

@@ -1,4 +1,4 @@
-// Copyright 2022-present by Nguyen Van Nguyen <[email protected]>. All rights reserved.
+// Copyright 2022-present by Dart Privacy Guard project. All rights reserved.
 // For the full copyright and license information, please view the LICENSE
 // file that was distributed with this source code.
 
@@ -9,8 +9,14 @@ import '../crypto/math/int_ext.dart';
 import '../enum/armor_type.dart';
 import '../helpers.dart';
 
+/// ASCII Armor class
+/// OpenPGP's Radix-64 encoding.
+/// It is composed of two parts: a base64
+/// encoding of the binary data and a checksum.
+/// See https://www.rfc-editor.org/rfc/rfc4880#section-6
+/// Author Nguyen Van Nguyen <[email protected]>
 class Armor {
-  static const version = 'Dart PG v1.0.0';
+  static const version = 'Dart PG v1.2.0';
   static const comment = 'Dart Privacy Guard';
 
   static const messageBegin = '-----BEGIN PGP MESSAGE';

lib/src/crypto/aead/base.dart

@@ -0,0 +1,33 @@
+/// Copyright 2023-present by Dart Privacy Guard project. All rights reserved.
+/// For the full copyright and license information, please view the LICENSE
+/// file that was distributed with this source code.
+
+import 'dart:typed_data';
+
+export 'eax.dart';
+export 'ocb.dart';
+export 'gcm.dart';
+
+/// AEAD Authenticated-Encryption base class
+/// Author Nguyen Van Nguyen <[email protected]>
+abstract class Base {
+  /// Encrypt plaintext input.
+  Uint8List encrypt(
+    final Uint8List plaintext,
+    final Uint8List nonce,
+    final Uint8List adata,
+  );
+
+  /// Decrypt ciphertext input.
+  Uint8List decrypt(
+    final Uint8List ciphertext,
+    final Uint8List nonce,
+    final Uint8List adata,
+  );
+
+  /// Get aead nonce
+  Uint8List getNonce(
+    final Uint8List iv,
+    final Uint8List chunkIndex,
+  );
+}

lib/src/crypto/aead/eax.dart

@@ -0,0 +1,90 @@
+/// Copyright 2023-present by Dart Privacy Guard project. All rights reserved.
+/// For the full copyright and license information, please view the LICENSE
+/// file that was distributed with this source code.
+
+import 'dart:typed_data';
+import 'package:pointycastle/export.dart';
+
+import '../../enum/symmetric_algorithm.dart';
+
+import 'base.dart';
+
+/// EAX Authenticated-Encryption class
+/// Author Nguyen Van Nguyen <[email protected]>
+class Eax implements Base {
+  final Uint8List _key;
+  final SymmetricAlgorithm _symmetric;
+
+  Eax(this._key, this._symmetric);
+
+  @override
+  Uint8List encrypt(
+    final Uint8List plaintext,
+    final Uint8List nonce,
+    final Uint8List adata,
+  ) {
+    final cipher = EAX(
+      _symmetric.cipherEngine,
+    )..init(
+        true,
+        AEADParameters(
+          KeyParameter(_key),
+          _symmetric.blockSize * 8,
+          nonce,
+          adata,
+        ),
+      );
+
+    return _process(cipher, plaintext);
+  }
+
+  @override
+  Uint8List decrypt(
+    final Uint8List ciphertext,
+    final Uint8List nonce,
+    final Uint8List adata,
+  ) {
+    final cipher = EAX(
+      _symmetric.cipherEngine,
+    )..init(
+        false,
+        AEADParameters(
+          KeyParameter(_key),
+          _symmetric.blockSize * 8,
+          nonce,
+          adata,
+        ),
+      );
+
+    return _process(cipher, ciphertext);
+  }
+
+  @override
+  Uint8List getNonce(
+    final Uint8List iv,
+    final Uint8List chunkIndex,
+  ) {
+    final nonce = iv.sublist(0);
+
+    for (var i = 0; i < chunkIndex.length; i++) {
+      nonce[8 + i] ^= chunkIndex[i];
+    }
+
+    return nonce;
+  }
+
+  static Uint8List _process(final AEADCipher cipher, final Uint8List input) {
+    final output = Uint8List(
+      cipher.getOutputSize(input.length),
+    );
+    final len = cipher.processBytes(
+      input,
+      0,
+      input.length,
+      output,
+      0,
+    );
+    final outLen = len + cipher.doFinal(output, len);
+    return Uint8List.view(output.buffer, 0, outLen);
+  }
+}

lib/src/crypto/aead/gcm.dart

@@ -0,0 +1,73 @@
+/// Copyright 2023-present by Dart Privacy Guard project. All rights reserved.
+/// For the full copyright and license information, please view the LICENSE
+/// file that was distributed with this source code.
+
+import 'dart:typed_data';
+
+import 'package:pointycastle/export.dart';
+
+import '../../enum/symmetric_algorithm.dart';
+import 'base.dart';
+
+/// GCM Authenticated-Encryption class
+/// Author Nguyen Van Nguyen <[email protected]>
+class Gcm implements Base {
+  final Uint8List _key;
+  final SymmetricAlgorithm _symmetric;
+
+  Gcm(this._key, this._symmetric);
+
+  @override
+  Uint8List encrypt(
+    final Uint8List ciphertext,
+    final Uint8List nonce,
+    final Uint8List adata,
+  ) {
+    final cipher = GCMBlockCipher(
+      _symmetric.cipherEngine,
+    )..init(
+        true,
+        AEADParameters(
+          KeyParameter(_key),
+          _symmetric.blockSize * 8,
+          nonce,
+          adata,
+        ),
+      );
+    return cipher.process(ciphertext);
+  }
+
+  @override
+  Uint8List decrypt(
+    final Uint8List plaintext,
+    final Uint8List nonce,
+    final Uint8List adata,
+  ) {
+    final cipher = GCMBlockCipher(
+      _symmetric.cipherEngine,
+    )..init(
+        false,
+        AEADParameters(
+          KeyParameter(_key),
+          _symmetric.blockSize * 8,
+          nonce,
+          adata,
+        ),
+      );
+    return cipher.process(plaintext);
+  }
+
+  @override
+  Uint8List getNonce(
+    final Uint8List iv,
+    final Uint8List chunkIndex,
+  ) {
+    final nonce = iv.sublist(0);
+
+    for (var i = 0; i < chunkIndex.length; i++) {
+      nonce[4 + i] ^= chunkIndex[i];
+    }
+
+    return nonce;
+  }
+}

lib/src/crypto/aead/ocb.dart

@@ -0,0 +1,78 @@
+/// Copyright 2023-present by Dart Privacy Guard project. All rights reserved.
+/// For the full copyright and license information, please view the LICENSE
+/// file that was distributed with this source code.
+
+import 'dart:typed_data';
+
+import 'package:pointycastle/api.dart';
+
+import '../../enum/symmetric_algorithm.dart';
+import '../modes/ocb_cipher.dart';
+import 'base.dart';
+
+/// OCB Authenticated-Encryption class
+/// Author Nguyen Van Nguyen <[email protected]>
+class Ocb implements Base {
+  final Uint8List _key;
+  final SymmetricAlgorithm _symmetric;
+
+  Ocb(this._key, this._symmetric);
+
+  @override
+  Uint8List encrypt(
+    final Uint8List plaintext,
+    final Uint8List nonce,
+    final Uint8List adata,
+  ) {
+    final cipher = OCBCipher(
+      _symmetric.cipherEngine,
+      _symmetric.cipherEngine,
+    )..init(
+        true,
+        AEADParameters(
+          KeyParameter(_key),
+          _symmetric.blockSize * 8,
+          nonce,
+          adata,
+        ),
+      );
+
+    return cipher.process(plaintext);
+  }
+
+  @override
+  Uint8List decrypt(
+    final Uint8List ciphertext,
+    final Uint8List nonce,
+    final Uint8List adata,
+  ) {
+    final cipher = OCBCipher(
+      _symmetric.cipherEngine,
+      _symmetric.cipherEngine,
+    )..init(
+        false,
+        AEADParameters(
+          KeyParameter(_key),
+          _symmetric.blockSize * 8,
+          nonce,
+          adata,
+        ),
+      );
+
+    return cipher.process(ciphertext);
+  }
+
+  @override
+  Uint8List getNonce(
+    final Uint8List iv,
+    final Uint8List chunkIndex,
+  ) {
+    final nonce = iv.sublist(0);
+
+    for (var i = 0; i < chunkIndex.length; i++) {
+      nonce[7 + i] ^= chunkIndex[i];
+    }
+
+    return nonce;
+  }
+}

lib/src/crypto/asymmetric/elgamal.dart

@@ -1,4 +1,4 @@
-// Copyright 2022-present by Nguyen Van Nguyen <[email protected]>. All rights reserved.
+// Copyright 2022-present by Dart Privacy Guard project. All rights reserved.
 // For the full copyright and license information, please view the LICENSE
 // file that was distributed with this source code.
 
@@ -12,6 +12,7 @@ import '../math/byte_ext.dart';
 
 /// Asymmetric block cipher using basic ElGamal algorithm.
 /// Ported and modified from Bouncy Castle project
+/// Author Nguyen Van Nguyen <[email protected]>
 class ElGamalEngine implements AsymmetricBlockCipher {
   late ElGamalAsymmetricKey? _key;
 

lib/src/crypto/math/big_int.dart

@@ -1,9 +1,10 @@
-// Copyright 2022-present by Nguyen Van Nguyen <[email protected]>. All rights reserved.
+// Copyright 2022-present by Dart Privacy Guard project. All rights reserved.
 // For the full copyright and license information, please view the LICENSE
 // file that was distributed with this source code.
 
 import 'dart:typed_data';
 
+/// Author Nguyen Van Nguyen <[email protected]>
 extension BigIntExt on BigInt {
   int get byteLength => (bitLength + 7) >> 3;
 

lib/src/crypto/math/byte_ext.dart

@@ -1,9 +1,10 @@
-// Copyright 2022-present by Nguyen Van Nguyen <[email protected]>. All rights reserved.
+// Copyright 2022-present by Dart Privacy Guard project. All rights reserved.
 // For the full copyright and license information, please view the LICENSE
 // file that was distributed with this source code.
 
 import 'dart:typed_data';
 
+/// Author Nguyen Van Nguyen <[email protected]>
 extension Uint8ListExt on Uint8List {
   int toIn16([
     Endian endian = Endian.big,

lib/src/crypto/math/int_ext.dart

@@ -1,11 +1,12 @@
-// Copyright 2022-present by Nguyen Van Nguyen <[email protected]>. All rights reserved.
+// Copyright 2022-present by Dart Privacy Guard project. All rights reserved.
 // For the full copyright and license information, please view the LICENSE
 // file that was distributed with this source code.
 
 import 'dart:typed_data';
 
 import 'package:fixnum/fixnum.dart';
 
+/// Author Nguyen Van Nguyen <[email protected]>
 extension IntExt on int {
   Uint8List pack16([Endian endian = Endian.big]) => Uint8List(2)
     ..buffer.asByteData().setInt16(