Crate homestar_invocation

homestar-invocation is an underlying foundation for Homestar packages, implementing much of the Ucan Invocation specification, among other useful library features.

Related crates/packages:

• homestar-runtime
• homestar-wasm
• homestar-workflow

Getting Started

For getting started with Homestar in general, please check out our README and Quickstart guide.

Feature flags

• diesel: Enables diesel-sqlite implementations of data structures.
• test-utils: Enables utilities for unit testing and benchmarking.

Re-exports

pub use error::Error;

pub use pointer::Pointer;

pub use receipt::Receipt;

pub use task::Task;

pub use consts::*;

pub use unit::*;

Modules

authority

Modules centered around UCAN authority.

consts

Exported global constants.

error

Error types and implementations for Invocation interaction(s).

ipld

Ipld customization and extensions.

macros

Macros for cross-crate export.

pointer

Pointers and references to Invocations, Tasks, Instructions, and/or Receipts, as well as handling for the Await’ed promises of pointers.

receipt

Output of an invocation, referenced by its invocation pointer.

task

A Task is the smallest unit of work that can be requested from a UCAN.

test_utilstest-utils

Test Utilities.

unit

Exported unit type for generic type conversions within Tasks, Inputs, and around Invocations.

Macros

bail

Return early with an error.

ensure

Return early with an error if a condition is not satisfied.

Structs

Invocation

A signed Task wrapper/container.