Struct DefaultHost

pub struct DefaultHost<R, EV, GF, E, C = DefaultChainClient> { /* private fields */ }

The default generic implementation of the untrusted host in the Quartz framework.

DefaultHost ties together the essential components needed to bridge on-chain events with enclave requests. It encapsulates an enclave instance, a blockchain client, and a gas configuration function used to compute transaction settings (such as gas fees) for enclave responses.

This host implementation is responsible for:

• Listening for blockchain events and converting them into enclave requests.
• Forwarding these requests to the enclave via an asynchronous call.
• Sending the enclave’s response back to the blockchain using the provided chain client.

Note

This implementation consumes an Enclave instance and calls it directly. Therefore, it is expected to be run inside a TEE.

Implementations

impl<R, EV, GF, E, C> DefaultHost<R, EV, GF, E, C>

where R: Handler<E>, C: ChainClient,

pub fn new(enclave: E, chain_client: C, gas_fn: GF) -> Self

Trait Implementations

impl<R: Clone, EV: Clone, GF: Clone, E: Clone, C: Clone> Clone for DefaultHost<R, EV, GF, E, C>

fn clone(&self) -> DefaultHost<R, EV, GF, E, C>

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<R: Debug, EV: Debug, GF: Debug, E: Debug, C: Debug> Debug for DefaultHost<R, EV, GF, E, C>

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

Formats the value using the given formatter.

impl<R, EV, GF, E, C> Host for DefaultHost<R, EV, GF, E, C>

where E: Enclave, <E as Enclave>::Store: Store<Contract = AccountId>, C: ChainClient<Contract = AccountId, Error = Error>, <C as ChainClient>::TxOutput: Display, R: Handler<E, Error = Status>, <R as Handler<E>>::Response: Serialize + Send + Sync + 'static, EV: Handler<C, Response = R, Error = Error> + TryFrom<Event, Error = Error>, GF: Fn(&<R as Handler<E>>::Response) -> <C as ChainClient>::TxConfig + Send + Sync + 'static,

type ChainClient = C

The blockchain client type for interacting with on-chain data.

type Enclave = E

The trusted enclave type that processes requests.

type Error = Error

The error type used for reporting host-level errors.

type Event = QuartzEvent<EV>

The event type that, when handled, produces an enclave request.

type Request = R

The enclave request type that is processed by the enclave.

fn enclave_call<'life0, 'async_trait>( &'life0 self, request: Self::Request, ) -> Pin<Box<dyn Future<Output = Result<Response<Self::Request, Self::Enclave>, Self::Error>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Forwards an enclave request to the trusted enclave and returns the corresponding response.

fn serve_with_query<'async_trait>( self, url: Url, query: Option<Query>, ) -> Pin<Box<dyn Future<Output = Result<(), Self::Error>> + Send + 'async_trait>>

where Self: 'async_trait,

Consumes the host and starts an event loop by connecting to the specified URL, with an optional query filter for events.

fn serve<'async_trait>( self, url: Url, ) -> Pin<Box<dyn Future<Output = Result<(), Self::Error>> + Send + 'async_trait>>

where Self: 'async_trait,

A convenience method that starts the event loop without a specific query filter.