Procedural macros for defining HyperStack streams.
This crate provides the #[hyperstack] attribute macro that transforms annotated Rust structs into full streaming pipeline specifications, including:
- State struct generation with field accessors
- Handler creation functions for event processing
- IDL/Proto parser integration for Solana programs
- Automatic AST serialization for deployment
[dependencies]
hyperstack-macros = "0.2"use hyperstack_macros::{hyperstack, Stream};
#[hyperstack(idl = "idl.json")]
pub mod my_stream {
#[entity(name = "MyEntity")]
#[derive(Stream)]
struct Entity {
#[map(from = "MyAccount", field = "value")]
pub value: u64,
#[map(from = "MyAccount", field = "owner")]
pub owner: String,
}
}#[hyperstack(proto = ["events.proto"])]
pub mod my_stream {
// entity structs
}| Attribute | Description |
|---|---|
#[map(...)] |
Map from account fields |
#[from_instruction(...)] |
Map from instruction fields |
#[event(...)] |
Capture instruction events |
#[snapshot(...)] |
Capture entire source data |
#[aggregate(...)] |
Aggregate field values |
#[computed(...)] |
Computed fields from other fields |
#[derive_from(...)] |
Derive values from instructions |
The macro generates:
{EntityName}Statestruct with all fieldsfields::module with field accessorscreate_spec()function returningTypedStreamSpec- Handler creation functions for each source
Apache-2.0