Net::SS...chaPoly(3)

💖 Net::SS...chaPoly(3) — bestie edition 💖

okay so this is a User Contributed Perl Documentation page, and the module it's serving is Net::SSH::Perl::Cipher::ChachaPoly. yes the title is abbreviated because terminals are small and life is short. let's get into it 🫶

---

✨ NAME ✨

Net::SSH::Perl::Cipher::ChachaPoly — provides Chacha20 encryption with Poly1305 Authentication support for Net::SSH::Perl. periodt. 💅

---

🦋 SYNOPSIS 🦋

no cap, here's the whole vibe, verbatim:

use Net::SSH::Perl::Cipher;
my $eight_byte_iv = pack('N',0) . pack('N',1);
my $eight_byte_counter = chr(1) . 7 x "\0"; # little endian

my $cipher = Net::SSH::Perl::Cipher->new('ChachaPoly', $key);

# generate poly key
$cipher->ivsetup($eight_byte_iv,undef);
my $poly_key = "\0" x POLY1305_KEYLEN; # 32 byte key
$poly_key = $ciph->encrypt($poly_key);

$cipher->ivsetup($eight_byte_iv,$eight_byte_counter);
my $enc = $cipher->encrypt($plaintext);
my $tag = $cipher->poly1305($enc,$poly_key);

👀 notice $ciph->encrypt in there — that's exactly what the original says, so I'm leaving it exactly as-is. copy-paste responsibly, bestie.

---

🌸 DESCRIPTION 🌸

Net::SSH::Perl::Cipher::Chacha provides Chacha20 encryption with Poly1305 support for Net::SSH::Perl. (yes, the prose says Chacha — again, that's what it says, I'm not touching it 🔥)

This module requires Crypt::OpenSSH::ChachaPoly, which is the little wrapper that gives you the OpenSSH Chacha and Poly1305 functions. so like, that dependency is not optional, it's giving mandatory main character energy. ✨

---

👑 AUTHOR & COPYRIGHTS 👑

Lance Kinley E<lkinley@loyaltymethods.com>

Copyright (c) 2015 Loyalty Methods, Inc.

---

🎀 LICENSE 🎀

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself. iconic behavior tbh 🌈

---

💀 POD ERRORS 💀

okay so. not everything was slay. the doc itself had some coding errors, and here's the rundown:

Around line 149:

Unknown E content in E<lkinley@loyaltymethods.com>

like — the E<...> formatting thing got fed an email address and it simply could not deal. it's fine. it's fine. 😭

---

perl v5.42.0 · 2026-01-17 — that's the source/version and date stamp from the footer, mwah 💜 go forth and encrypt, bestie, you got this 🧚‍♀️🍓