Struct PolynomialArena 

pub struct PolynomialArena { /* private fields */ }

Specialized handle for Polynomial and FFT data.

Optimized for cache-line alignment and massive vectors.

Implementations

impl PolynomialArena

pub fn new(inner: Arc<BumpAlloc>) -> Self

Create a new PolynomialArena wrapping a BumpAlloc.

pub fn alloc_fft_friendly(&self, size: usize) -> *mut u8

Allocate polynomial data with 64-byte alignment for optimal FFT/NTT performance.

This alignment is critical for SIMD-accelerated operations:

• AVX-512: Requires 64-byte alignment
• AVX/AVX2: Benefits from 32-byte alignment (64 is a superset)
• Cache efficiency: Modern cache lines are 64 bytes

pub fn alloc_huge(&self, size: usize) -> *mut u8

Allocate huge vectors with page alignment (4096 bytes).

Use this for vectors exceeding a few megabytes. Benefits:

• TLB efficiency: Reduces translation lookaside buffer misses
• Huge pages: May enable transparent huge page usage on Linux
• DMA compatibility: Required for some hardware accelerators

pub fn alloc(&self, size: usize, align: usize) -> *mut u8

Allocate with custom alignment.

Use this when you have specific alignment requirements. Alignment must be a power of two.

pub unsafe fn alloc_slice<T>(&self, count: usize) -> *mut T

Allocate a typed slice of elements with appropriate alignment.

This is a convenience method for allocating arrays of field elements or other ZK primitive types.

Safety

The returned pointer must be properly aligned for type T. The caller is responsible for initializing the memory.

pub unsafe fn reset(&self)

Reset the polynomial arena.

Safety

All previously allocated polynomial memory becomes invalid.

pub fn remaining(&self) -> usize

Get the remaining capacity in bytes.

pub fn used(&self) -> usize

Get the number of bytes currently allocated.

pub fn capacity(&self) -> usize

Get the total capacity in bytes.