Struct Sm4Cipher 

pub struct Sm4Cipher { /* private fields */ }

SM4 cipher with pre-computed round keys.

Sm4Cipher zeroizes its round-key buffer on drop via the workspace zeroize policy. Construction runs the key schedule (32 round keys × secret-key-touching S-box invocations); see the W1 dudect target ct_sm4_key_schedule.

Implementations

impl Sm4Cipher

pub fn new(key: &[u8; 16]) -> Self

Construct a cipher from a 128-bit key and run the key schedule.

pub fn encrypt_block(&self, block: &mut [u8; 16])

Encrypt one 16-byte block in place.

pub fn decrypt_block(&self, block: &mut [u8; 16])

Decrypt one 16-byte block in place.

pub fn encrypt_blocks(&self, blocks: &mut [[u8; 16]])

v0.7 W1 — Encrypt N 16-byte blocks in place. Byte-identical to calling encrypt_block N times; under the sm4-bitsliced-simd feature this fans the SM4 round loop across the SIMD register width (8-block batches on x86_64 AVX2 via sbox_x32, 4-block batches on aarch64 NEON via sbox_x16). blocks.len() may be any value including zero; the tail after the largest multiple of SIMD_BATCH falls back to per-block encrypt_block. Cross-checked in tests/sm4_batch_api.rs.

pub fn decrypt_blocks(&self, blocks: &mut [[u8; 16]])

v0.7 W1 — Decrypt N 16-byte blocks in place. Symmetric counterpart of encrypt_blocks; see that method’s docstring for the SIMD-fanout posture.

Trait Implementations

impl BlockCipher for Sm4Cipher

fn new(key: &[u8]) -> Self

Construct from a key slice. key.len() must equal KEY_SIZE.

Panics

Panics if key.len() != KEY_SIZE.

fn encrypt_block(&self, block: &mut [u8])

Encrypt one 16-byte block in place.

Panics

Panics if block.len() != BLOCK_SIZE.

fn decrypt_block(&self, block: &mut [u8])

Decrypt one 16-byte block in place.

Panics

Panics if block.len() != BLOCK_SIZE.

const BLOCK_SIZE: usize = BLOCK_SIZE

Block size in bytes (e.g. 16 for SM4).

impl BlockDecrypt for Sm4Cipher

fn decrypt_with_backend( &self, f: impl BlockClosure<BlockSize = Self::BlockSize>, )

Decrypt data using backend provided to the rank-2 closure.

fn decrypt_block_inout( &self, block: InOut<'_, '_, GenericArray<u8, Self::BlockSize>>, )

Decrypt single inout block.

fn decrypt_blocks_inout( &self, blocks: InOutBuf<'_, '_, GenericArray<u8, Self::BlockSize>>, )

Decrypt inout blocks.

fn decrypt_block(&self, block: &mut GenericArray<u8, Self::BlockSize>)

Decrypt single block in-place.

fn decrypt_block_b2b( &self, in_block: &GenericArray<u8, Self::BlockSize>, out_block: &mut GenericArray<u8, Self::BlockSize>, )

Decrypt in_block and write result to out_block.

fn decrypt_blocks(&self, blocks: &mut [GenericArray<u8, Self::BlockSize>])

Decrypt blocks in-place.

fn decrypt_blocks_b2b( &self, in_blocks: &[GenericArray<u8, Self::BlockSize>], out_blocks: &mut [GenericArray<u8, Self::BlockSize>], ) -> Result<(), NotEqualError>

Decrypt blocks buffer-to-buffer.

impl BlockEncrypt for Sm4Cipher

fn encrypt_with_backend( &self, f: impl BlockClosure<BlockSize = Self::BlockSize>, )

Encrypt data using backend provided to the rank-2 closure.

fn encrypt_block_inout( &self, block: InOut<'_, '_, GenericArray<u8, Self::BlockSize>>, )

Encrypt single inout block.

fn encrypt_blocks_inout( &self, blocks: InOutBuf<'_, '_, GenericArray<u8, Self::BlockSize>>, )

Encrypt inout blocks.

fn encrypt_block(&self, block: &mut GenericArray<u8, Self::BlockSize>)

Encrypt single block in-place.

fn encrypt_block_b2b( &self, in_block: &GenericArray<u8, Self::BlockSize>, out_block: &mut GenericArray<u8, Self::BlockSize>, )

Encrypt in_block and write result to out_block.

fn encrypt_blocks(&self, blocks: &mut [GenericArray<u8, Self::BlockSize>])

Encrypt blocks in-place.

fn encrypt_blocks_b2b( &self, in_blocks: &[GenericArray<u8, Self::BlockSize>], out_blocks: &mut [GenericArray<u8, Self::BlockSize>], ) -> Result<(), NotEqualError>

Encrypt blocks buffer-to-buffer.

impl BlockSizeUser for Sm4Cipher

type BlockSize = UInt<UInt<UInt<UInt<UInt<UTerm, B1>, B0>, B0>, B0>, B0>

Size of the block in bytes.

fn block_size() -> usize

Return block size in bytes.

impl Clone for Sm4Cipher

fn clone(&self) -> Sm4Cipher

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Drop for Sm4Cipher

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.

impl KeyInit for Sm4Cipher

fn new(key: &Key<Self>) -> Self

Create new value from fixed size key.

fn new_from_slice(key: &[u8]) -> Result<Self, InvalidLength>

Create new value from variable size key.

impl KeySizeUser for Sm4Cipher

type KeySize = UInt<UInt<UInt<UInt<UInt<UTerm, B1>, B0>, B0>, B0>, B0>

Key size in bytes.

fn key_size() -> usize

Return key size in bytes.

impl Zeroize for Sm4Cipher

fn zeroize(&mut self)

Zero out this object from memory using Rust intrinsics which ensure the zeroization operation is not “optimized away” by the compiler.

impl BlockCipher for Sm4Cipher