public static function ParagonIE_Sodium_Compat::crypto_secretbox_xchacha20poly1305 in Automatic Updates 7

Same name and namespace in other branches

1. 8 vendor/paragonie/sodium_compat/src/Compat.php \ParagonIE_Sodium_Compat::crypto_secretbox_xchacha20poly1305()

Authenticated symmetric-key encryption.

Algorithm: XChaCha20-Poly1305

@psalm-suppress MixedArgument

Parameters

string $plaintext The message you're encrypting:

string $nonce A Number to be used Once; must be 24 bytes:

string $key Symmetric encryption key:

Return value

string Ciphertext with Poly1305 MAC

Throws

SodiumException

TypeError

File

vendor/paragonie/sodium_compat/src/Compat.php, line 2352

Class

ParagonIE_Sodium_Compat

Code

public static function crypto_secretbox_xchacha20poly1305($plaintext, $nonce, $key) {

  /* Type checks: */
  ParagonIE_Sodium_Core_Util::declareScalarType($plaintext, 'string', 1);
  ParagonIE_Sodium_Core_Util::declareScalarType($nonce, 'string', 2);
  ParagonIE_Sodium_Core_Util::declareScalarType($key, 'string', 3);

  /* Input validation: */
  if (ParagonIE_Sodium_Core_Util::strlen($nonce) !== self::CRYPTO_SECRETBOX_NONCEBYTES) {
    throw new SodiumException('Argument 2 must be CRYPTO_SECRETBOX_NONCEBYTES long.');
  }
  if (ParagonIE_Sodium_Core_Util::strlen($key) !== self::CRYPTO_SECRETBOX_KEYBYTES) {
    throw new SodiumException('Argument 3 must be CRYPTO_SECRETBOX_KEYBYTES long.');
  }
  if (PHP_INT_SIZE === 4) {
    return ParagonIE_Sodium_Crypto32::secretbox_xchacha20poly1305($plaintext, $nonce, $key);
  }
  return ParagonIE_Sodium_Crypto::secretbox_xchacha20poly1305($plaintext, $nonce, $key);
}