Crypt::...Twofish(3)

🌊 Crypt::Cipher::Twofish — the Crypt::...Twofish(3) page 🌊

💖 NAME 💖

Crypt::Cipher::Twofish — Symmetric cipher Twofish, key size: 128/192/256 bits

✨ SYNOPSIS ✨

### example 1
use Crypt::Mode::CBC;

my $key = '...'; # length must be a valid key size for this cipher
my $iv = '...';  # 16 bytes
my $cbc = Crypt::Mode::CBC->new('Twofish');
my $ciphertext = $cbc->encrypt("secret data", $key, $iv);

### example 2 (slower)
use Crypt::CBC;
use Crypt::Cipher::Twofish;

my $key = '...'; # length must be a valid key size for this cipher
my $iv = '...';  # 16 bytes
my $cbc = Crypt::CBC->new( -cipher=>'Cipher::Twofish', -key=>$key, -iv=>$iv );
my $ciphertext = $cbc->encrypt("secret data");

🌸 DESCRIPTION 🌸

Okay so bestie, this module implements the Twofish cipher. Its interface is compatible with Crypt::CBC. Slay.

Important note, no cap: this module only implements single-block encryption and decryption. For general data, use a block mode such as Crypt::Mode::CBC, Crypt::Mode::CTR, or Crypt::CBC (which is slower).

💅 METHODS 💅

Unless noted otherwise, assume $c is an existing cipher object created via new, for example:

my $c = Crypt::Cipher::Twofish->new($key);

🌱 new 🌱

my $c = Crypt::Cipher::Twofish->new($key);
#or
my $c = Crypt::Cipher::Twofish->new($key, $rounds);

# $key .... [binary string] key of an accepted length (see keysize, min_keysize, max_keysize)
# $rounds . [integer] optional, number of rounds (if supported by the cipher; croaks on invalid value)

🔐 encrypt 🔐

Encrypts exactly one block of plaintext. The length of $plaintext must equal blocksize; croaks otherwise. An empty string is accepted and returned unchanged.

my $ciphertext = $c->encrypt($plaintext);

Returns the encrypted block as a binary string (raw bytes). Vibe check passed.

🔓 decrypt 🔓

Decrypts exactly one block of ciphertext. The length of $ciphertext must equal blocksize; croaks otherwise. An empty string is accepted and returned unchanged.

my $plaintext = $c->decrypt($ciphertext);

Returns the decrypted block as a binary string (raw bytes). Iconic.

📏 keysize 📏

Just an alias for max_keysize.

$c->keysize;
#or
Crypt::Cipher::Twofish->keysize;
#or
Crypt::Cipher::Twofish::keysize;

🧱 blocksize 🧱

Returns the cipher block size (in bytes).

$c->blocksize;
#or
Crypt::Cipher::Twofish->blocksize;
#or
Crypt::Cipher::Twofish::blocksize;

🔑 max_keysize 🔑

Returns the maximum key size (in bytes).

$c->max_keysize;
#or
Crypt::Cipher::Twofish->max_keysize;
#or
Crypt::Cipher::Twofish::max_keysize;

🪄 min_keysize 🪄

Returns the minimum key size (in bytes).

$c->min_keysize;
#or
Crypt::Cipher::Twofish->min_keysize;
#or
Crypt::Cipher::Twofish::min_keysize;

🔁 default_rounds 🔁

Returns the cipher's default round count.

$c->default_rounds;
#or
Crypt::Cipher::Twofish->default_rounds;
#or
Crypt::Cipher::Twofish::default_rounds;

👀 SEE ALSO 👀

• CryptX, Crypt::Cipher
• <https://en.wikipedia.org/wiki/Twofish>

---

mwah 💋 that's the whole page. It's from perl v5.42.0, dated 2026-05-11, and it's User Contributed Perl Documentation — periodt. 🫶🎀