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.