EncryptedPayload class

Envelope imutável que carrega todos os dados necessários para decifrar uma mensagem — independente do algoritmo usado.

Uso normal (via CryptUtil)

Na esmagadora maioria dos casos você nunca constrói um EncryptedPayload diretamente. Os métodos de CryptUtil o criam e retornam para você:

// Cifrar
final payload = CryptUtil.encryptAesGcm(utf8.encode('segredo'));

// Decifrar — mesmo payload, qualquer algoritmo
final plain = CryptUtil.decryptAny(payload);

// Para persistir ou transmitir, converta para CryptEnvelope e mantenha a
// chave fora do payload. A serialização desta classe é somente legado.
final migrated = AllCrypto.migrateLegacy(payload);

Construção manual (interop com sistemas externos)

Use o construtor diretamente quando o ciphertext e as chaves vêm de fora da lib — por exemplo, de uma API ou de variáveis de ambiente (Flavors, .env):

// API retorna ciphertext AES-CBC em base64; key e IV vêm do Flavors
final payload = EncryptedPayload(
  algorithm:  CryptAlgorithm.aesCbc,
  ciphertext: base64.decode(responseBody),
  key:        utf8.encode(Flavors.aesKey),   // 16 ou 32 bytes
  nonce:      utf8.encode(Flavors.aesIv),    // 16 bytes — IV do CBC
  tag:        Uint8List(0),                  // CBC não produz tag
  aad:        Uint8List(0),                  // sem AAD
);

final plain = CryptUtil.decryptAesCbc(payload);

Campos e seus papéis por algoritmo

Serialização

toJson / fromJson — integra com qualquer camada HTTP/storage. toBase64 / fromBase64 — string única; ideal para headers ou SharedPreferences.

Todos os campos de bytes são codificados em base64-standard no JSON.