NAME

Crypt::Cipher::Serpent - Symmetric cipher Serpent, key size: 128/192/256 bits

SYNOPSIS

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

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

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

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

DESCRIPTION

This module implements the Serpent cipher. Provided interface is compliant with Crypt::CBC module.

BEWARE: This module implements just elementary "one-block-(en|de)cryption" operation - if you want to encrypt/decrypt generic data you have to use some of the cipher block modes - check for example Crypt::Mode::CBC, Crypt::Mode::CTR or Crypt::CBC (which will be slower).

METHODS

new

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

encrypt

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

decrypt

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

keysize

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

blocksize

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

max_keysize

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

min_keysize

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

default_rounds

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