Enum Payload 

pub enum Payload {
    Shellcode {
        bytes: Vec<u8>,
        metadata: PayloadMetadata,
    },
    DllFile {
        file_path: Option<PathBuf>,
        image_bytes: Option<Vec<u8>>,
        metadata: PayloadMetadata,
    },
    Executable {
        file_path: Option<PathBuf>,
        image_bytes: Option<Vec<u8>>,
        metadata: PayloadMetadata,
    },
    Script {
        language: String,
        script_code: String,
        metadata: PayloadMetadata,
    },
    Blob {
        content_type: String,
        data: Vec<u8>,
        metadata: PayloadMetadata,
    },
}

A unified representation of the code or data to be injected.

This enum wraps the raw bytes or file paths of the payload and attaches PayloadMetadata to ensure operational context is carried throughout the injection lifecycle.

Variants

Shellcode

Raw position-independent shellcode.

Fields

bytes: Vec<u8>

The raw bytecode.

metadata: PayloadMetadata

DllFile

A Dynamic Link Library (DLL), either as a file path or raw image bytes.

Fields

file_path: Option<PathBuf>

The path to the DLL on disk, if available.

image_bytes: Option<Vec<u8>>

The raw bytes of the DLL image.

metadata: PayloadMetadata

Executable

A Portable Executable (EXE), either as a file path or raw image bytes.

Fields

file_path: Option<PathBuf>

The path to the EXE on disk, if available.

image_bytes: Option<Vec<u8>>

The raw bytes of the EXE image.

metadata: PayloadMetadata

Script

A high-level script (e.g., PowerShell, Python, Bash) to be executed by an interpreter.

Fields

language: String

The interpreter or language identifier (e.g., “ps1”, “python”).

script_code: String

The source code of the script.

metadata: PayloadMetadata

Blob

A generic binary blob with a specified content type.

Useful for stagers or data that does not fit standard executable formats.

Fields

content_type: String

A MIME-type or custom identifier for the data format.

data: Vec<u8>

The binary data.

metadata: PayloadMetadata

Implementations

impl Payload

pub fn variant_name(&self) -> &'static str

Returns a string literal representing the variant name (e.g., “Shellcode”, “DllFile”).

pub fn from_file( file_path: impl Into<PathBuf>, metadata: PayloadMetadata, ) -> Result<Self>

Creates a Payload from a file path, automatically detecting if it is a DLL or an EXE.

This function performs basic I/O to read the file and uses a lightweight PE header heuristic to determine the format.

Errors

Returns an error if the file cannot be read.

pub fn as_file_path(&self) -> Option<&Path>

Returns the file path if this payload is backed by a file on disk (DLL or Executable).

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

Returns the raw bytes of the payload content, if available.

This is useful for techniques that require raw access, such as manual mapping or shellcode execution.