Struct Tag 

pub struct Tag(/* private fields */);

A Poly1305 authentication tag

This tag is used to verify the authenticity of a message. It is always 16 bytes (128 bits) long.

Security Properties

• The tag provides 128-bit security against forgery attempts
• Tags are deterministic: the same message and key always produce the same tag
• Verification is constant-time to prevent timing attacks

Usage

• The tag should be transmitted or stored alongside the message
• The recipient can verify the tag to ensure the message hasn’t been tampered with
• The tag does not need to be kept secret, but the key used to create it does

Implementations

impl Tag

pub fn from_bytes(bytes: &[u8]) -> Result<Self>

Create a tag from bytes

Arguments

• bytes - The bytes to create the tag from

Returns

• Result<Self> - The tag or an error if the input is invalid

Errors

Returns an error if the input is not exactly BYTES bytes long

pub fn as_bytes(&self) -> &[u8]

Get the bytes of the tag

Returns

• &[u8] - A reference to the tag bytes

Trait Implementations

impl AsRef<[u8]> for Tag

fn as_ref(&self) -> &[u8]

Converts this type into a shared reference of the (usually inferred) input type.

impl Clone for Tag

fn clone(&self) -> Tag

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Tag

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Display for Tag

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Eq for Tag

impl From<Tag> for [u8; 16]

fn from(tag: Tag) -> Self

Converts to this type from the input type.

impl From<[u8; 16]> for Tag

fn from(bytes: [u8; 16]) -> Self

Converts to this type from the input type.

impl PartialEq for Tag

fn eq(&self, other: &Tag) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for Tag

impl TryFrom<&[u8]> for Tag

type Error = SodiumError

The type returned in the event of a conversion error.

fn try_from(bytes: &[u8]) -> Result<Self, Self::Error>

Performs the conversion.