Struct DataCapsule 

pub struct DataCapsule { /* private fields */ }

Executable Data Capsule

Encapsulates encrypted data AND logic predicate. Data cannot be “read” - only “executed” via run_access_protocol().

Implementations

impl DataCapsule

pub fn new( id: impl Into<String>, data: &[u8], predicate: Box<dyn AccessPredicate>, max_executions: u64, ttl_seconds: u64, ) -> Result<Self>

Create new data capsule

Arguments

• id - Unique capsule identifier
• data - Raw data to encapsulate
• predicate - Access control predicate
• max_executions - Max allowed executions (0 = unlimited)
• ttl_seconds - Time to live (0 = forever)

pub fn run_access_protocol(&self, context: &ExecutionContext) -> ExecutionResult

Execute access protocol

This is the ONLY way to access the capsule data. Data is never “read” - it is “executed” through this protocol.

Arguments

• context - Execution context with ZKP proof and BFT signature

Returns

• ExecutionResult::Success - Decrypted data (if all checks pass)
• ExecutionResult::Denied - Access denied with reason
• ExecutionResult::Lost - Capsule self-destructed

pub fn is_expired(&self) -> bool

Check if capsule is expired

pub fn state(&self) -> CapsuleState

Get capsule state

pub fn id(&self) -> &str

Get capsule ID

pub fn execution_count(&self) -> u64

Get execution count

pub fn destroy(&self)

Manually destroy capsule (authorized destruction)