hyperstack-macros is a procedural macro. It will run at compile time and transform your program's source code.

Adding `hyperstack-macros` macro(s) as a dependency

Run this command in a terminal, in your project's directory:

cargo add hyperstack-macros

To add it manually, edit your project's Cargo.toml file and add to the [dependencies] section:

hyperstack-macros = "0.4.3"

You may need to import the macro(s) with use hyperstack_macros::*.

Read the hyperstack_macros documentation.

Back to the crate overview.

Readme

hyperstack-macros

Procedural macros for defining HyperStack streams.

Overview

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

Installation

[dependencies]
hyperstack-macros = "0.2"

Usage

IDL-based Stream

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,
    }
}

Proto-based Stream

#[hyperstack(proto = ["events.proto"])]
pub mod my_stream {
    // entity structs
}

Supported Attributes

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

Generated Output

The macro generates:

{EntityName}State struct with all fields
fields:: module with field accessors
create_spec() function returning TypedStreamSpec
Handler creation functions for each source

License

Apache-2.0

Adding hyperstack-macros macro(s) as a dependency

Adding `hyperstack-macros` macro(s) as a dependency