Struct HttpTool 

pub struct HttpTool {
    pub base: String,
    pub allow: BTreeSet<(String, String)>,
    pub max_body: usize,
    pub max_request: usize,
    pub calls: u64,
}

An HTTP endpoint restricted to an allowlist.

The allowlist is (METHOD, path) pairs. There is no redirect following, no chunked encoding, and the body is bounded by max_body. A URL outside the allowlist is rpc/tool-policy.

Fields

base: String

Base URL, e.g. http://127.0.0.1:8080.

allow: BTreeSet<(String, String)>

Allowed (method, path) pairs.

max_body: usize

Maximum response bytes.

max_request: usize

Maximum request bytes.

calls: u64

Calls served.

Implementations

impl HttpTool

pub fn new(base: impl Into<String>, allow: &[(&str, &str)]) -> Self

Build a tool for base with an allowlist.

pub fn policy(&self) -> ToolPolicy

Build a tool policy for a capability.

Trait Implementations

impl Debug for HttpTool

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

Formats the value using the given formatter.

impl Provider for HttpTool

fn name(&self) -> &'static str

Stable adapter name.

fn methods(&self) -> Vec<String>

Methods this provider answers (introspection).

fn mutating(&self, method: &str) -> bool

Whether method mutates provider state (refused on read-only caps).

fn invoke(&mut self, _object: u64, call: &Call) -> Result<Response>

Invoke a method on object.

fn has_method(&self, method: &str) -> bool

Whether this provider answers method.

fn on_drop(&mut self, _object: u64, _cap: CapId)

Called when the last capability referencing object is dropped.

fn take_drop_notifications(&mut self) -> Vec<(u64, CapId)>

Drain provider-side drop notifications recorded by Provider::on_drop.