Struct wasmcloud_core::Invocation

pub struct Invocation {
    pub origin: WasmCloudEntity,
    pub target: WasmCloudEntity,
    pub operation: String,
    pub msg: Vec<u8>,
    pub id: String,
    pub encoded_claims: String,
    pub host_id: String,
    pub content_length: u64,
    pub trace_context: TraceContext,
}

RPC message to capability provider

Fields

origin: WasmCloudEntity

target: WasmCloudEntity

operation: String

msg: Vec<u8>

id: String

encoded_claims: String

host_id: String

content_length: u64

total message size

trace_context: TraceContext

Open Telemetry tracing support

Implementations

impl Invocation

pub fn new( cluster_key: &KeyPair, host_key: &KeyPair, origin: WasmCloudEntity, target: WasmCloudEntity, operation: impl Into<String>, msg: Vec<u8>, trace_context: TraceContext ) -> Result<Invocation>

Creates a new invocation. All invocations are signed with the cluster key as a way of preventing them from being forged over the network when connected to a lattice, and allows hosts to validate that the invocation is coming from a trusted source.

Arguments

• links - a map of package name to target name to entity, used internally to disambiguate between multiple links to the same provider or for actor-to-actor calls.
• cluster_key - the cluster key used to sign the invocation
• host_key - the host key of the host that is creating the invocation
• origin - the origin of the invocation
• target - the target of the invocation
• operation - the operation being invoked
• msg - the raw bytes of the invocation

pub fn origin_url(&self) -> String

A fully-qualified URL indicating the origin of the invocation

pub fn target_url(&self) -> String

A fully-qualified URL indicating the target of the invocation

pub fn hash(&self) -> String

The hash of the invocation’s target, origin, and raw bytes

pub fn validate_antiforgery(&self, valid_issuers: &[String]) -> Result<()>

Validates the current invocation to ensure that the invocation claims have not been forged, are not expired, etc

Trait Implementations

impl Clone for Invocation

fn clone(&self) -> Invocation

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Invocation

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

Formats the value using the given formatter.

impl Default for Invocation

fn default() -> Invocation

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Invocation

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Invocation

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>where __S: Serializer,

Serialize this value into the given Serde serializer.