Struct AionParser 

pub struct AionParser<'a> { /* private fields */ }

Zero-copy parser for AION v2 files

Provides efficient, allocation-free access to file sections using direct byte slice references.

Examples

use aion_context::parser::AionParser;

let data = vec![0u8; 1024]; // Mock file data
let parser = AionParser::new(&data)?;

let header = parser.header();
println!("File ID: {}", header.file_id);

Implementations

impl<'a> AionParser<'a>

pub fn new(data: &'a [u8]) -> Result<Self>

Create a new parser from byte data

Errors

Returns error if:

• Data is too small for header
• Header validation fails

Examples

use aion_context::parser::AionParser;

let data = vec![0u8; 256];
let result = AionParser::new(&data);
assert!(result.is_err()); // Invalid magic

pub const fn header(&self) -> &'a FileHeader

Get reference to the file header.

Zero-copy: the reference was bound to the underlying data slice by new and cached on the parser, so this accessor is a simple field read and cannot fail.

pub fn encrypted_rules_bytes(&self) -> Result<&'a [u8]>

Get encrypted rules section as byte slice

Errors

Returns error if section bounds are invalid

pub fn version_chain_bytes(&self) -> Result<&'a [u8]>

Get version chain section as byte slice

Errors

Returns error if section bounds are invalid

pub fn signatures_bytes(&self) -> Result<&'a [u8]>

Get signatures section as byte slice

Errors

Returns error if section bounds are invalid

pub fn audit_trail_bytes(&self) -> Result<&'a [u8]>

Get audit trail section as byte slice

Note: Audit entries are variable-length, so this returns raw bytes. Use audit module to parse individual entries.

Errors

Returns error if section bounds are invalid

pub fn string_table_bytes(&self) -> Result<&'a [u8]>

Get string table section as byte slice

Errors

Returns error if section bounds are invalid

pub fn integrity_hash(&self) -> Result<&'a [u8; 32]>

Get file integrity hash (last 32 bytes)

Errors

Returns error if file is too small

pub fn verify_integrity(&self) -> Result<()>

Verify file integrity by computing BLAKE3 hash and comparing

Computes the hash of all bytes except the final 32-byte hash, then compares with the stored hash.

Errors

Returns AionError::CorruptedFile if the hash doesn’t match, indicating the file has been corrupted or tampered with.

Examples

use aion_context::parser::AionParser;

let parser = AionParser::new(&data)?;
parser.verify_integrity()?; // Returns Ok if valid

pub const fn file_size(&self) -> usize

Get total file size

pub fn get_version_entry(&self, index: usize) -> Result<VersionEntry>

Get a version entry by index

Errors

Returns error if index is out of bounds or entry cannot be parsed

pub fn get_signature_entry(&self, index: usize) -> Result<SignatureEntry>

Get a signature entry by index

Errors

Returns error if index is out of bounds or entry cannot be parsed

pub fn get_audit_entry(&self, index: usize) -> Result<AuditEntry>

Get an audit entry by index

Errors

Returns error if index is out of bounds or entry cannot be parsed

Trait Implementations

impl<'a> Debug for AionParser<'a>

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

Formats the value using the given formatter.