Ascon Decrypt

Category: Ciphers

Status: Registered and callable in the CyberChef 11.3.0 compatibility inventory.

Input / output: string → string

Background: https://wikipedia.org/wiki/Ascon_(cipher)

What it does

Ascon-AEAD128 authenticated decryption as standardised in NIST SP 800-232. Decrypts ciphertext and verifies the authentication tag. Decryption will fail if the ciphertext or associated data has been tampered with. Key: Must be exactly 16 bytes (128 bits). Nonce: Must be exactly 16 bytes (128 bits). Must match the nonce used during encryption. Associated Data: Must match the associated data used during encryption. Any mismatch will cause authentication failure.

Note

Status here means the operation name is implemented and callable. It does not by itself promise byte-for-byte parity for every upstream option. See Compatibility and current status for the verified scope and known boundaries.

Arguments and options

Arguments are positional. Keep their order when using bake() or Pipeline.then().

Index

Name

UI type

PyChef default

Accepted values / format

0

Key

toggleString

{'string': '', 'option': 'Hex'}

''

1

Nonce

toggleString

{'string': '', 'option': 'Hex'}

''

2

Associated Data

toggleString

{'string': '', 'option': 'Hex'}

''

3

Input

option

'Hex'

'Hex', 'Raw'

4

Output

option

'Raw'

'Raw', 'Hex'

Recipe template

Important

This is a call template built from the documented defaults. Replace placeholder values such as empty keys, paths, patterns, or lookup data before running it.

from pychef import bake

input_value = "example"
args = [{'string': '', 'option': 'Hex'}, {'string': '', 'option': 'Hex'}, {'string': '', 'option': 'Hex'}, 'Hex', 'Raw']
result = bake(input_value, [{"op": 'Ascon Decrypt', "args": args}])
print(result)

Pipeline example

from pychef import Pipeline

args = [{'string': '', 'option': 'Hex'}, {'string': '', 'option': 'Hex'}, {'string': '', 'option': 'Hex'}, 'Hex', 'Raw']
transform = Pipeline().then('Ascon Decrypt', *args)
result = transform("example")

Dedicated operation module

The registered entry point lives in pychef.operations.by_operation.ascon_decrypt. Direct calls receive the input value and a positional argument tuple:

from pychef.operations.by_operation.ascon_decrypt import run

result = run("example", tuple([{'string': '', 'option': 'Hex'}, {'string': '', 'option': 'Hex'}, {'string': '', 'option': 'Hex'}, 'Hex', 'Raw']))
pychef.operations.by_operation.ascon_decrypt.run(value, args)

Run this operation using its shared internal implementation.

Parameters:

  • value (str | bytes)

  • args (Sequence[Any])

Return type:

str | bytes