Struct HttpCcipReadGateway 

pub struct HttpCcipReadGateway { /* private fields */ }

Available on crate feature ccip-read-http and crate feature ccip-read and not (WASI and WASIp1) only.

The default HTTP implementation of CcipReadGateway.

Requests follow ERC-3668: URL templates containing {data} are fetched with GET, all others receive a POST with a JSON body carrying sender and data. The URLs of a request are tried in order; a 4xx response aborts the request, while any other failure falls through to the next URL.

URL trust

Templates in CcipReadRequest::urls are chosen by the callee contract. This gateway only checks that each URL uses http or https and will follow a URL to a private, link-local, loopback, or cloud-metadata address. To constrain destinations, construct HttpCcipReadGateway::new with a custom reqwest::Client, or implement CcipReadGateway with your own allowlist, blocklist, or DNS/IP policy.

Implementations

impl HttpCcipReadGateway

pub const fn new(client: Client) -> Self

Creates a gateway using an existing HTTP client, keeping its timeout and redirect policy.

pub const fn with_max_url_length(self, max_url_length: usize) -> Self

Sets the maximum expanded gateway URL length in bytes (default: 2 MiB).

Expansion is checked before allocating the URL. This limit is independent of the response size limit, so a large request may still retrieve a small response.

Trait Implementations

impl CcipReadGateway for HttpCcipReadGateway

fn request<'life0, 'life1, 'async_trait>( &'life0 self, request: &'life1 CcipReadRequest, max_response_size: usize, ) -> Pin<Box<dyn Future<Output = Result<Bytes, CcipReadGatewayError>> + Send + 'async_trait>>

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

Fetches one request, trying its URL templates in order.

impl Clone for HttpCcipReadGateway

fn clone(&self) -> HttpCcipReadGateway

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for HttpCcipReadGateway

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

Formats the value using the given formatter.

impl Default for HttpCcipReadGateway

fn default() -> Self

Returns the “default value” for a type.

Layout

Note: Most layout information is completely unstable and may even differ between compilations. The only exception is types with certain repr(...) attributes. Please see the Rust Reference's “Type Layout” chapter for details on type layout guarantees.

Size: 16 bytes